X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?p=elogind.git;a=blobdiff_plain;f=man%2Fos-release.xml;h=f85119d26a8024651d4afb662a173bf6926ff5b7;hp=1e4c067c1bddde7eaa10037dd6a4b67e7eb51a05;hb=8112e84f657839a056afb411249a627956518b24;hpb=7640a5de1b3ffe6547200ad204d14e4f067caf4f

diff --git a/man/os-release.xml b/man/os-release.xml
index 1e4c067c1..f85119d26 100644
--- a/man/os-release.xml
+++ b/man/os-release.xml
@@ -116,10 +116,12 @@
                                 <term><varname>ID=</varname></term>
 
                                 <listitem><para>A lower-case string
-                                identifying the operating system,
-                                excluding any version information and
-                                suitable for processing by scripts. If
-                                not set defaults to
+                                (no spaces) identifying the operating
+                                system, excluding any version
+                                information and suitable for
+                                processing by scripts or usage in
+                                generated file names. If not set
+                                defaults to
                                 <literal>linux</literal>. Example:
                                 <literal>ID=fedora</literal>.</para></listitem>
                         </varlistentry>
@@ -128,10 +130,10 @@
                                 <term><varname>VERSION_ID=</varname></term>
 
                                 <listitem><para>A lower-case string
-                                (mostly numeric) identifying the
+                                (mostly numeric, no spaces) identifying the
                                 operating system version, excluding
                                 any name information and suitable for
-                                processing by scripts. Example:
+                                processing by scripts or usage in generated file names. Example:
                                 <literal>VERSION_ID=15</literal>.</para></listitem>
                         </varlistentry>
 
@@ -165,11 +167,11 @@
                         </varlistentry>
                 </variablelist>
 
-                <para>If you interpreting this file from code or a
-                shell script, use the ID and VERSION_ID fields. When
-                looking for an OS identification string for
-                presentation to the user use the PRETTY_STRING
-                field.</para>
+                <para>If you are reading this file from code or a
+                shell script to determine the OS or a specific version
+                of it, use the ID and VERSION_ID fields. When looking
+                for an OS identification string for presentation to
+                the user use the PRETTY_NAME field.</para>
 
                 <para>Note that operating system vendors may choose
                 not to provide version information, for example to