From: Mantas Mikulėnas Date: Wed, 24 Dec 2014 12:46:20 +0000 (+0200) Subject: doc: os-release: mention all shell characters that must be escaped X-Git-Tag: v219~833 X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=commitdiff_plain;h=321a3f5133a415ad9c95e15e95e46556c08973aa;p=elogind.git doc: os-release: mention all shell characters that must be escaped Since the manpage already talks about shell-compatibility, it should be more accurate about what needs to be escaped and how. --- diff --git a/man/os-release.xml b/man/os-release.xml index b29830494..b4cbeba39 100644 --- a/man/os-release.xml +++ b/man/os-release.xml @@ -68,17 +68,16 @@ (this means variable expansion is explicitly not supported), allowing applications to read the file without implementing a shell compatible execution - engine. Variable assignment values should be enclosed - in double or single quotes if they include spaces, + engine. Variable assignment values must be enclosed in + double or single quotes if they include spaces, semicolons or other special characters outside of A-Z, - a-z, 0-9. All strings should be in UTF-8 format, and - non-printable characters should not be used. If double - or single quotes or backslashes are to be used within - variable assignments, they should be escaped with - backslashes, following shell style. It is not - supported to concatenate multiple individually quoted - strings. Lines beginning with "#" shall be ignored as - comments. + a-z, 0-9. Shell special characters ("$", quotes, + backslash, backtick) must be escaped with backslashes, + following shell style. All strings should be in UTF-8 + format, and non-printable characters should not be used. + It is not supported to concatenate multiple individually + quoted strings. Lines beginning with "#" shall be + ignored as comments. The file /etc/os-release takes precedence over