commit fad98b14df5c3532cb4bdb7b888047fdf25e07d0 parent 5db857af9453a4c2359add10c58df31822853eb7 Author: Alexandre Bique <bique.alexandre@gmail.com> Date: Fri, 6 Jan 2023 15:31:25 +0100 Doc. Diffstat:
M | include/clap/factory/draft/preset-discovery.h | | | 10 | ++++++++++ |
1 file changed, 10 insertions(+), 0 deletions(-)
diff --git a/include/clap/factory/draft/preset-discovery.h b/include/clap/factory/draft/preset-discovery.h @@ -254,6 +254,16 @@ typedef struct clap_preset_discovery_indexer { // Sets the path to a watch file. // Whenever the given file is "touched" (its modification time is updated), // then the indexer shall invalidate all the data. + // + // This file shouldn't be touched when a new preset is added, the host shall detect the new + // preset using the OS features (file system monitoring). + // + // The invalidation file is useful if: + // - the set of filetypes changes + // - the set of locations changes + // - the set of collections changes + // - the metadata extraction code changes is located outside of the DSO containing this + // preset provider void(CLAP_ABI *set_invalidation_watch_file)(const struct clap_preset_discovery_indexer *indexer, const char *path);