From: Lennart Poettering <lennart@poettering.net>
Date: Tue, 6 Mar 2012 17:14:06 +0000 (+0100)
Subject: man: document how os-release(5) may be extended by OS vendors
X-Git-Tag: v44~52
X-Git-Url: https://err.no/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=edcf3b8900b8cf46ec18233508452b5bb745dc74;p=systemd

man: document how os-release(5) may be extended by OS vendors
---

diff --git a/man/os-release.xml b/man/os-release.xml
index 019e48e0..36046833 100644
--- a/man/os-release.xml
+++ b/man/os-release.xml
@@ -313,6 +313,12 @@
                 accommodate for rolling releases. In this case VERSION
                 and VERSION_ID may be unset. Applications should not
                 rely on these fields to be set.</para>
+
+                <para>Operating system vendors may extend the file
+                format and introduce new fields. It is highly
+                recommended to prefix new fields with an OS specific
+                name in order to avoid name clashes. Example:
+                <literal>DEBIAN_BTS="debbugs://bugs.debian.org/"</literal></para>
         </refsect1>
 
         <refsect1>