* The default config (DEFAULT_CONFIG config option) or NULL if already loaded.
* You can set it to something else manually.
*/
-extern char *cf_def_file; /* DEFAULT_CONFIG; NULL if already loaded */
-extern char *cf_env_file; /** ENV_VAR_CONFIG **/
+extern char *cf_def_file;
+/**
+ * Name of environment variable that can override what configuration
+ * is loaded.
+ **/
+extern char *cf_env_file;
int cf_reload(const char *file); /** Reload configuration from @file, replace the old one. **/
int cf_load(const char *file); /** Load configuration from @file. **/
/**
/**
* List of operations used on items.
* This macro is used to generate internal source code,
- * but you may be interested in the actions it creates.
+ * but you may be interested in the list of operations it creates.
+ *
+ * Each operation corresponds to the same-named operation
+ * described in <<config:operations,configuration syntax>>.
**/
#define CF_OPERATIONS T(CLOSE) T(SET) T(CLEAR) T(ALL) \
T(APPEND) T(PREPEND) T(REMOVE) T(EDIT) T(AFTER) T(BEFORE) T(COPY)
* Sections can be used with SET.
* Lists can be used with everything. */
#define T(x) OP_##x,
-enum cf_operation { CF_OPERATIONS }; /** Allowed operations on items. See <<def_CF_OPERATIONS,`CF_OPERATIONS`>>. **/
+enum cf_operation { CF_OPERATIONS }; /** Allowed operations on items. See <<def_CF_OPERATIONS,`CF_OPERATIONS`>> for list (they have an `OP_` prefix -- it means you use `OP_SET` instead of just `SET`). **/
#undef T
struct cf_item;