[systemd-commits] man/systemd.unit.xml

[Zbigniew Jędrzejewski-Szmek]

 man/systemd.unit.xml |   17 +++++++++++------
 1 file changed, 11 insertions(+), 6 deletions(-)

New commits:
commit 995084c7b4683190404ec90f8924b3433b5a1a18
Author: Chris Atkinson <cwa at pipeline.com>
Date:   Thu Jan 1 16:35:34 2015 -0500

    man: clarify path escaping and reference systemd-escape
    
    This patch adds more detail to the description of how path escaping
    operates and provides a pointer to the systemd-escape program. Either
    would serve to answer the question raised in the bug report, so
    hopefully this will allow it to be closed.
    
    https://bugs.freedesktop.org/show_bug.cgi?id=87688

diff --git a/man/systemd.unit.xml b/man/systemd.unit.xml
index 1afa600..ae243d6 100644
--- a/man/systemd.unit.xml
+++ b/man/systemd.unit.xml
@@ -229,12 +229,17 @@
                 the file system namespace. If this applies, a special
                 way to escape the path name is used, so that the
                 result is usable as part of a filename. Basically,
-                given a path, "/" is replaced by "-", and all
-                unprintable characters and the "-" are replaced by
-                C-style "\x2d" escapes. The root directory "/" is
-                encoded as single dash, while otherwise the initial
-                and ending "/" is removed from all paths during
-                transformation. This escaping is reversible.</para>
+                given a path, "/" is replaced by "-" and all other
+                characters which are not ASCII alphanumerics are
+                replaced by C-style "\x2d" escapes (except that "_"
+                is never replaced and "." is only replaced when it
+                would be the first character in the escaped path).
+                The root directory "/" is encoded as single dash,
+                while otherwise the initial and ending "/" are removed
+                from all paths during transformation. This escaping
+                is reversible. Properly escaped paths can be generated
+                using the <citerefentry><refentrytitle>systemd-escape</refentrytitle><manvolnum>1</manvolnum></citerefentry>
+                command.</para>
 
                 <para>Optionally, units may be instantiated from a
                 template file at runtime. This allows creation of