Fastbuf: fbmulti: *'s and whitespace

[libucw.git] / ucw / conf.h

diff --git a/ucw/conf.h b/ucw/conf.h
index 9e93eb0f22ee95e22a3a52d9ab74523c51071b34..0ff991309f146bfb1505c77ed7fa9a2d23219239 100644 (file)
--- a/ucw/conf.h
+++ b/ucw/conf.h
@@ -41,7 +41,7 @@ struct cf_context *cf_new_context(void);
  * of the context is freed, which includes memory obtained by calls to
  * cf_malloc().
  **/
-void cf_free_context(struct cf_context *cc);
+void cf_delete_context(struct cf_context *cc);
 
 /**
  * Make the given configuration context current and return the previously
@@ -488,8 +488,17 @@ void cf_journal_rollback_transaction(uns new_pool, struct cf_journal_item *oldj)
  * If @allow_unknown is set to 0 and a variable not described in @sec
  * is found in the configuration file, it produces an error.
  * If you set it to 1, all such variables are ignored.
+ *
+ * Please note that a single section definition cannot be used in multiple
+ * configuration contexts simultaneously.
  **/
 void cf_declare_section(const char *name, struct cf_section *sec, uns allow_unknown);
+/**
+ * Like @cf_declare_section(), but instead of item pointers, the section
+ * contains offsets relative to @ptr. In other words, it does the same
+ * as `CF_SECTION`, but for top-level sections.
+ **/
+void cf_declare_rel_section(const char *name, struct cf_section *sec, void *ptr, uns allow_unknown);
 /**
  * If you have a section in a structure and you want to initialize it
  * (eg. if you want a copy of default values outside the configuration),