X-Git-Url: https://www.chiark.greenend.org.uk/ucgi/~ianmdlvl/git?a=blobdiff_plain;ds=sidebyside;f=man%2Fos-release.xml;h=f85119d26a8024651d4afb662a173bf6926ff5b7;hb=8112e84f657839a056afb411249a627956518b24;hp=c6eb28f395f3d2112192ad845e87182248426f14;hpb=e17fb72914e328f962e5df1bf88f301c0e7fa6e1;p=elogind.git
diff --git a/man/os-release.xml b/man/os-release.xml
index c6eb28f39..f85119d26 100644
--- a/man/os-release.xml
+++ b/man/os-release.xml
@@ -116,10 +116,12 @@
ID=
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
linux. Example:
ID=fedora.
@@ -128,10 +130,10 @@
VERSION_ID=
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:
VERSION_ID=15.
@@ -165,21 +167,27 @@
- If you interpreting this file from code or a
- shell script, use the ID and VERSION_ID fields. When
- looking for an OS indetification string for
- presentation to the user use the PRETTY_STRING
- field.
+ 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.
+
+ Note that operating system vendors may choose
+ not to provide version information, for example to
+ accommodate for rolling releases. In this case VERSION
+ and VERSION_ID may be unset. Applications should not
+ rely on these fields to be set.
Example
NAME=Fedora
-VERSION=15 (Rawhide)
+VERSION="15 (Rawhide)"
ID=fedora
VERSION_ID=15
-PRETTY_NAME=Fedora 15 (Rawhide)
+PRETTY_NAME="Fedora 15 (Rawhide)"
ANSI_COLOR=0;34
@@ -187,7 +195,10 @@ ANSI_COLOR=0;34
See Also
systemd1,
- lsb_release1
+ lsb_release1,
+ hostname5,
+ machine-id5,
+ machine-info5