diff options
Diffstat (limited to 'doc/manual.cli')
| -rw-r--r-- | doc/manual.cli | 16 |
1 files changed, 15 insertions, 1 deletions
diff --git a/doc/manual.cli b/doc/manual.cli index e760cd9..d6bdf29 100644 --- a/doc/manual.cli +++ b/doc/manual.cli @@ -249,7 +249,7 @@ of a repository, respectively. \h#manifest-format|Manifest Format| -The manifest file is a UTF-8 encoded text file containing a list of name-value +The manifest format is a UTF-8 encoded text containing a list of name-value pairs in the form: \ @@ -487,6 +487,20 @@ license: <licenses> [; <comment>] In the above example \c{name} is required, \c{license} has an optional component (comment), and \c{description} is optional. +In certain situations (for example, shell scripts) it can be easier to parse +the binary manifest representation. The binary representation does not include +comments and consists of a sequence of name-value pairs in the following form: + +\ +<name>:<value>\0 +\ + +That is, the name and the value are separated by a colon and each pair +(including the last) is terminated with the \c{NUL} character. Note that there +can be no leading or trailing whitespace characters around the name and any +whitespaces after the colon and before the \c{NUL} terminator are part of the +value. + \h#manifest-package|Package Manifest| |