diff options
| -rw-r--r-- | libstore/kids.c | 16 | ||||
| -rw-r--r-- | libstore/store.h | 16 |
2 files changed, 16 insertions, 16 deletions
diff --git a/libstore/kids.c b/libstore/kids.c index e8fc6f4c..ee00ace4 100644 --- a/libstore/kids.c +++ b/libstore/kids.c @@ -151,15 +151,13 @@ store_clear_child_flags (struct store *store, int flags) } /* Parse multiple store names in NAME, and open each individually, returning - all in the vector STORES, and the number in NUM_STORES. The syntax is - simply a single character, followed by each individual store name (which - are in the store_typed_open syntax -- the type name, a ':', and the store - name) separated by that same character, with the whole list optionally - terminated by the same. If the first character of NAME is an - alpha-numeric, then NAME is taken to be in `factored-type' notation, - meaning that a common type-name for each child actually precedes the - entire list of children, instead of being specified in each child, - followed by a `:' and the child list as above. */ + all in the vector STORES, and the number in NUM_STORES. The syntax of + NAME is a single non-alpha-numeric separator character, followed by each + child store name separated by the same separator; each child name is + TYPE:NAME notation as parsed by store_typed_open. If every child uses the + same TYPE: prefix, then it may be factored out and put before the child + list instead (the two types of notation are differentiated by whether the + first character of name is alpha-numeric or not). */ error_t store_open_children (const char *name, int flags, const struct store_class *const *classes, diff --git a/libstore/store.h b/libstore/store.h index 5cdbc4ff..32844a11 100644 --- a/libstore/store.h +++ b/libstore/store.h @@ -368,11 +368,13 @@ error_t _store_task_create (task_t task, int flags, size_t block_size, error_t store_task_open (const char *name, int flags, struct store **store); /* Parse multiple store names in NAME, and open each individually, returning - all in the vector STORES, and the number in NUM_STORES. The syntax is - simply a single character, followed by each individual store name (which - are in the store_typed_open syntax -- the type name, a ':', and the store - name) separated by that same character, with the whole list optionally - terminated by the same. */ + all in the vector STORES, and the number in NUM_STORES. The syntax of + NAME is a single non-alpha-numeric separator character, followed by each + child store name separated by the same separator; each child name is + TYPE:NAME notation as parsed by store_typed_open. If every child uses the + same TYPE: prefix, then it may be factored out and put before the child + list instead (the two types of notation are differentiated by whether the + first character of name is alpha-numeric or not). */ error_t store_open_children (const char *name, int flags, const struct store_class *const *classes, struct store ***stores, size_t *num_stores); @@ -603,9 +605,9 @@ void store_parsed_free (struct store_parsed *parsed); error_t store_parsed_open (const struct store_parsed *parsed, int flags, struct store **store); -/* Add the arguments PARSED, and return the corresponding store in STORE. */ +/* Add the arguments used to create PARSED to ARGZ & ARGZ_LEN. */ error_t store_parsed_append_args (const struct store_parsed *parsed, - char **args, size_t *args_len); + char **argz, size_t *argz_len); /* Make a string describing PARSED, and return it in malloced storage in NAME. */ |