[systemd-commits] man/os-release.xml

[David Herrmann]

 man/os-release.xml |   35 +++++++++++++++++++++++++++++++++++
 1 file changed, 35 insertions(+)

New commits:
commit be7d0048ddda1e994f651e2825f96266d537d10d
Author: Stephen Gallagher <sgallagh at redhat.com>
Date:   Wed Apr 29 08:19:05 2015 -0400

    Add VARIANT as a standard value for /etc/os-release
    
    Some distributions (such as Fedora) are using the VARIANT field to
    indicate to select packages which of several default configurations
    they should be using. For example, VARIANT=Server provides a
    different default firewall configuration (blocking basically
    everything but SSH and the management console) whereas
    VARIANT=Workstation opens many other ports for application
    compatibility.
    
    By adding this patch to the manual pages, we can standardize on a
    cross-distribution mechanism for accomplishing this.
    
    Fedora implementation details are available at
    https://fedoraproject.org/wiki/Packaging:Per-Product_Configuration
    
    (David: drop double paranthesis)

diff --git a/man/os-release.xml b/man/os-release.xml
index 4f57323..4ca2e59 100644
--- a/man/os-release.xml
+++ b/man/os-release.xml
@@ -273,6 +273,41 @@
         </para></listitem>
       </varlistentry>
 
+      <varlistentry>
+        <term><varname>VARIANT=</varname></term>
+
+        <listitem><para>
+        A string identifying a specific variant or edition of the
+        operating system suitable for presentation to the user. This
+        field may be used to inform the user that the configuration of
+        this system is subject to a specific divergent set of rules or
+        default configuration settings. This field is optional and may
+        not be implemented on all systems.
+        Examples:
+        <literal>VARIANT="Server Edition"</literal>,
+        <literal>VARIANT="Smart Refrigerator Edition"</literal>
+        Note: this field is for display purposes only. The
+        <varname>VARIANT_ID</varname> field should be used for making
+        programmatic decisions.
+        </para></listitem>
+      </varlistentry>
+
+      <varlistentry>
+        <term><varname>VARIANT_ID=</varname></term>
+
+        <listitem><para>
+        A lower-case string (no spaces or other characters outside of
+        0-9, a-z, ".", "_" and "-"), identifying a specific variant or
+        edition of the operating system. This may be interpreted by
+        other packages in order to determine a divergent default
+        configuration. This field is optional and may not be
+        implemented on all systems.
+        Examples:
+        <literal>VARIANT_ID=server</literal>,
+        <literal>VARIANT_ID=embedded</literal>
+        </para></listitem>
+      </varlistentry>
+
     </variablelist>
 
     <para>If you are reading this file from C code or a shell script