You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
33 lines
1.4 KiB
33 lines
1.4 KiB
From b4087419bac3cd656a3f8ba82653750fd60c19b9 Mon Sep 17 00:00:00 2001 |
|
From: =?UTF-8?q?Zbigniew=20J=C4=99drzejewski-Szmek?= <zbyszek@in.waw.pl> |
|
Date: Tue, 8 Mar 2022 10:10:12 +0100 |
|
Subject: [PATCH] man/os-release: add a note about repeating entries |
|
|
|
We didn't actually say that keys should not be repeated. At least the |
|
examples in docs (both python and shell) would do that, and any simple |
|
parser that builds a dictionary would most likely behave the same way. |
|
But let's document this expectation, but also say how to deal with malformed |
|
files. |
|
|
|
(cherry picked from commit 3a84a3c9dfde5182398a6d0863a2b2fe90a936b1) |
|
|
|
Related: #2082131 |
|
--- |
|
man/os-release.xml | 4 ++++ |
|
1 file changed, 4 insertions(+) |
|
|
|
diff --git a/man/os-release.xml b/man/os-release.xml |
|
index 1826a60d1a..baff088bc0 100644 |
|
--- a/man/os-release.xml |
|
+++ b/man/os-release.xml |
|
@@ -75,6 +75,10 @@ |
|
from earliest boot on, and hence must be located on the root file |
|
system.</para> |
|
|
|
+ <para><filename>os-release</filename> must not contain repeating keys. Nevertheless, readers should pick |
|
+ the entries later in the file in case of repeats, similarly to how a shell sourcing the file would. A |
|
+ reader may warn about repeating entries.</para> |
|
+ |
|
<para>For a longer rationale for <filename>os-release</filename> |
|
please refer to the <ulink |
|
url="http://0pointer.de/blog/projects/os-release">Announcement of <filename>/etc/os-release</filename></ulink>.</para>
|
|
|