]> git.ipfire.org Git - thirdparty/systemd.git/commitdiff
man: document \u and \U, say that utf-8 is allowed 18831/head
authorZbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>
Mon, 1 Mar 2021 19:53:22 +0000 (20:53 +0100)
committerZbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>
Mon, 1 Mar 2021 19:57:36 +0000 (20:57 +0100)
man/systemd.syntax.xml

index 5f207912b952be977fcaab71fc51414530cfecf6..e900747ae7c523a2b1c7931e38f278762084b63e 100644 (file)
@@ -136,14 +136,14 @@ KeyThree=value 3\
     single quotes ('…') may be used to wrap a whole item (the opening quote may appear only at the beginning
     or after whitespace that is not quoted, and the closing quote must be followed by whitespace or the end
     of line), in which case everything until the next matching quote becomes part of the same item. Quotes
-    themselves are removed. C-style escapes are also supported. The table below contains the list of known
-    escape patterns. Only escape patterns which match the syntax in the table are allowed; other patterns may
-    be added in the future and unknown patterns will result in a warning. In particular, any backslashes
-    should be doubled. Finally, a trailing backslash (<literal>\</literal>) may be used to merge lines, as
-    described above.</para>
+    themselves are removed. C-style escapes are supported. The table below contains the list of known escape
+    patterns. Only escape patterns which match the syntax in the table are allowed; other patterns may be
+    added in the future and unknown patterns will result in a warning. In particular, any backslashes should
+    be doubled. Finally, a trailing backslash (<literal>\</literal>) may be used to merge lines, as described
+    above. UTF-8 is accepted, and hence typical unicode characters do not need to be escaped.</para>
 
     <table>
-      <title>Supported escapes</title>
+      <title>Supported escapes</title>
       <tgroup cols='2'>
         <colspec colname='escape' />
         <colspec colname='meaning' />
@@ -206,6 +206,14 @@ KeyThree=value 3\
             <entry><literal>\<replaceable>nnn</replaceable></literal></entry>
             <entry>character number <replaceable>nnn</replaceable> in octal encoding</entry>
           </row>
+          <row>
+            <entry><literal>\u<replaceable>nnnn</replaceable></literal></entry>
+            <entry>unicode code point <replaceable>nnnn</replaceable> in hexadecimal encoding</entry>
+          </row>
+          <row>
+            <entry><literal>\U<replaceable>nnnnnnnn</replaceable></literal></entry>
+            <entry>unicode code point <replaceable>nnnnnnnn</replaceable> in hexadecimal encoding</entry>
+          </row>
         </tbody>
       </tgroup>
     </table>