dab2659
From 388a91b06473b13a59ba217d23b26ca3dc0f2555 Mon Sep 17 00:00:00 2001
dab2659
From: =?UTF-8?q?Zbigniew=20J=C4=99drzejewski-Szmek?= <zbyszek@in.waw.pl>
dab2659
Date: Fri, 7 Aug 2015 00:06:15 -0400
dab2659
Subject: [PATCH] man: clarify that unknown escapes must be escaped
dab2659
dab2659
https://bugzilla.redhat.com/show_bug.cgi?id=1251334
dab2659
is about a unit file which has
dab2659
Environment=TERM=linux PS1=system-upgrade:\w\$\x20
dab2659
We used to allow that, but after recent tightening of parsing
dab2659
rules, we barf. Make it clear that this is intentional.
dab2659
---
dab2659
 man/systemd.service.xml | 7 +++++--
dab2659
 1 file changed, 5 insertions(+), 2 deletions(-)
dab2659
dab2659
diff --git a/man/systemd.service.xml b/man/systemd.service.xml
dab2659
index 4368ca8..7e96989 100644
dab2659
--- a/man/systemd.service.xml
dab2659
+++ b/man/systemd.service.xml
dab2659
@@ -922,7 +922,10 @@
dab2659
     the arguments. Double quotes ("...") and single quotes ('...') may
dab2659
     be used, in which case everything until the next matching quote
dab2659
     becomes part of the same argument. C-style escapes are also
dab2659
-    supported, see table below. Quotes themselves are removed after
dab2659
+    supported. The table below contains the list of allowed escape
dab2659
+    patterns. Only patterns which match the syntax in the table are
dab2659
+    allowed; others will result in an error, and must be escaped by
dab2659
+    doubling the backslash. Quotes themselves are removed after
dab2659
     parsing and escape sequences substituted. In addition, a trailing
dab2659
     backslash (<literal>\</literal>) may be used to merge lines.
dab2659
     </para>
dab2659
@@ -939,7 +942,7 @@
dab2659
     <literal>&</literal>, and <emphasis>other elements of shell
dab2659
     syntax are not supported</emphasis>.</para>
dab2659
 
dab2659
-    <para>The command to execute must an absolute path name. It may
dab2659
+    <para>The command to execute must be an absolute path name. It may
dab2659
     contain spaces, but control characters are not allowed.</para>
dab2659
 
dab2659
     <para>The command line accepts <literal>%</literal> specifiers as
dab2659
-- 
dab2659
2.4.3
dab2659