chiark / gitweb /
man: we don't support systems without /etc/os-release anymore
[elogind.git] / man / os-release.xml
index d8a45b303fbac13bb76a2b958cd4a6ae94e7f0bc..f503b231249d66f310afefe3bd9fc9d11490f8b2 100644 (file)
                 <para><filename>/etc/os-release</filename> contains
                 data that is defined by the operating system vendor
                 and should not be changed by the administrator.</para>
-
-                <para>Depending on the operating system other
-                configuration files might be checked for OS
-                identification as well, however only as
-                fallback.</para>
         </refsect1>
 
         <refsect1>
                                 <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>
                                 <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>
 
                                 not contain an OS version of some
                                 kind, as suitable. If not set defaults
                                 to <literal>Linux</literal>. Example:
-                                <literal>PRETTY_NAME=Fedora 15
-                                (Rawhide)</literal>.</para></listitem>
+                                <literal>PRETTY_NAME="Fedora 15
+                                (Rawhide)"</literal>.</para></listitem>
                         </varlistentry>
 
                         <varlistentry>
                                 for inclusion in the ESC [ m
                                 ANSI/ECMA-48 escape code for setting
                                 graphical rendition. Example:
-                                <literal>ANSI_COLOR=0;31</literal> for
+                                <literal>ANSI_COLOR="0;31"</literal> for
                                 red, or
-                                <literal>ANSI_COLOR=1;34</literal> for
+                                <literal>ANSI_COLOR="1;34"</literal> for
                                 light blue.</para></listitem>
                         </varlistentry>
                 </variablelist>
@@ -186,7 +183,7 @@ VERSION="15 (Rawhide)"
 ID=fedora
 VERSION_ID=15
 PRETTY_NAME="Fedora 15 (Rawhide)"
-ANSI_COLOR=0;34</programlisting>
+ANSI_COLOR="0;34"</programlisting>
         </refsect1>
 
         <refsect1>