man: add version info

This tries to add information about when each option was added. It goes
back to version 183.

The version info is included from a separate file to allow generating it,
which would allow more control on the formatting of the final output.

1 files changed, 30 insertions, 10 deletions

diff --git a/man/os-release.xml b/man/os-release.xml
index 74bdea996c..1736b5017f 100644
--- a/man/os-release.xml
+++ b/man/os-release.xml
@@ -297,7 +297,9 @@
           the local system.</para>
 
           <para>Examples: <literal>IMAGE_ID=vendorx-cashier-system</literal>,
-          <literal>IMAGE_ID=netbook-image</literal>.</para></listitem>
+          <literal>IMAGE_ID=netbook-image</literal>.</para>
+
+          <xi:include href="version-info.xml" xpointer="v249"/></listitem>
         </varlistentry>
 
         <varlistentry>
@@ -309,7 +311,9 @@
           </para>
 
           <para>Examples: <literal>IMAGE_VERSION=33</literal>, <literal>IMAGE_VERSION=47.1rc1</literal>.
-          </para></listitem>
+          </para>
+
+          <xi:include href="version-info.xml" xpointer="v249"/></listitem>
         </varlistentry>
       </variablelist>
 
@@ -365,7 +369,9 @@
           not</emphasis> provided.</para>
 
           <para>For example, <literal>SUPPORT_END=2001-01-01</literal> means that the system was supported
-          until the end of the last day of the previous millennium.</para></listitem>
+          until the end of the last day of the previous millennium.</para>
+
+          <xi:include href="version-info.xml" xpointer="v252"/></listitem>
         </varlistentry>
 
         <varlistentry>
@@ -403,7 +409,9 @@
           needed to distinguish the OS vendor from the OS itself. It is intended to be human readable.</para>
 
           <para>Examples: <literal>VENDOR_NAME="Fedora Project"</literal> for Fedora Linux,
-          <literal>VENDOR_NAME="Canonical"</literal> for Ubuntu.</para></listitem>
+          <literal>VENDOR_NAME="Canonical"</literal> for Ubuntu.</para>
+
+          <xi:include href="version-info.xml" xpointer="v254"/></listitem>
         </varlistentry>
 
         <varlistentry>
@@ -419,7 +427,9 @@
           setting.</para>
 
           <para>Examples: <literal>VENDOR_URL="https://fedoraproject.org/"</literal>,
-          <literal>VENDOR_URL="https://canonical.com/"</literal>.</para></listitem>
+          <literal>VENDOR_URL="https://canonical.com/"</literal>.</para>
+
+          <xi:include href="version-info.xml" xpointer="v254"/></listitem>
         </varlistentry>
       </variablelist>
     </refsect2>
@@ -454,7 +464,9 @@
           It may provide redundant information when used in a GPT partition with a GUID type that already
           encodes the architecture. If this is not the case, the architecture should be specified in
           e.g., an extension image, to prevent an incompatible host from loading it.
-          </para></listitem>
+          </para>
+
+          <xi:include href="version-info.xml" xpointer="v252"/></listitem>
         </varlistentry>
 
         <varlistentry>
@@ -479,7 +491,9 @@
           for more information.</para>
 
           <para>Examples: <literal>CONFEXT_LEVEL=2</literal>, <literal>CONFEXT_LEVEL=15.14</literal>.
-          </para></listitem>
+          </para>
+
+          <xi:include href="version-info.xml" xpointer="v254"/></listitem>
         </varlistentry>
 
         <varlistentry>
@@ -490,13 +504,17 @@
           the system extension is applicable to: i.e. to regular systems, to initrds, or to portable service
           images. If unspecified, <literal>SYSEXT_SCOPE=system portable</literal> is implied, i.e. any system
           extension without this field is applicable to regular systems and to portable service environments,
-          but not to initrd environments.</para></listitem>
+          but not to initrd environments.</para>
+
+          <xi:include href="version-info.xml" xpointer="v250"/></listitem>
         </varlistentry>
 
         <varlistentry>
           <term><varname>CONFEXT_SCOPE=</varname></term>
 
-          <listitem><para>Semantically the same as <varname>SYSEXT_SCOPE=</varname> but for confext images.</para></listitem>
+          <listitem><para>Semantically the same as <varname>SYSEXT_SCOPE=</varname> but for confext images.</para>
+
+          <xi:include href="version-info.xml" xpointer="v254"/></listitem>
         </varlistentry>
 
         <varlistentry>
@@ -507,7 +525,9 @@
           (and thus allowing them to be distinguished from other OS images, such as bootable system images).
           It is also used when a portable service image is attached: the specified or implied portable
           service prefix is checked against the list specified here, to enforce restrictions how images may
-          be attached to a system.</para></listitem>
+          be attached to a system.</para>
+
+          <xi:include href="version-info.xml" xpointer="v250"/></listitem>
         </varlistentry>
       </variablelist>
     </refsect2>