diff options
| author | Karen Arutyunov <karen@codesynthesis.com> | 2020-01-29 15:46:10 +0300 |
|---|---|---|
| committer | Karen Arutyunov <karen@codesynthesis.com> | 2020-01-29 16:24:54 +0300 |
| commit | d561b9fed787b4b20025210f00db981f25f1ae50 (patch) | |
| tree | 392259715c30b9bc07226a1d5e46e722a42ec2e9 | |
| parent | b6772764ff5e15b63df10c5a59e8926a3a404ab3 (diff) | |
Restrict manifest text with only Unicode graphic characters, '\t', '\r', and '\n'
| -rw-r--r-- | doc/manual.cli | 9 |
1 files changed, 7 insertions, 2 deletions
diff --git a/doc/manual.cli b/doc/manual.cli index 65e96c4..49afefd 100644 --- a/doc/manual.cli +++ b/doc/manual.cli @@ -311,8 +311,9 @@ of a repository, respectively. \h#manifest-format|Manifest Format| -The manifest format is a UTF-8 encoded text containing a list of name-value -pairs in the form: +A manifest is a UTF-8 encoded text restricted to the Unicode graphic +characters, tabs (\c{\\t}), carriage returns (\c{\\r}), and line feeds +(\c{\\n}). It contains a list of name-value pairs in the form: \ <name>: <value> @@ -325,6 +326,10 @@ name: libfoo version: 1.2.3 \ +\N|If a value needs to be able to contain other Unicode codepoints, they +should be escaped in a value-specific manner. For example, the backslash +(\c{\\}) escaping described below can be extended for this purpose.| + The name can contain any characters except \c{:} and whitespaces. Newline terminates the pair unless escaped with \c{\\} (see below). Leading and trailing whitespaces before and after name and value are ignored except in the |