From: Lennart Poettering <lennart@poettering.net>
Date: Tue, 30 Oct 2012 23:06:08 +0000 (+0100)
Subject: man: document that Documentation= follows an order
X-Git-Tag: v196~159
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=f8a2ebbc503c23210300ade56c1fb71c85c40a59;p=thirdparty%2Fsystemd.git

man: document that Documentation= follows an order
---

diff --git a/man/systemd.unit.xml b/man/systemd.unit.xml
index f23aad9fa04..c20efe55275 100644
--- a/man/systemd.unit.xml
+++ b/man/systemd.unit.xml
@@ -338,7 +338,15 @@
                                 <literal>man:</literal>. For more
                                 information about the syntax of these
                                 URIs see
-                                <citerefentry><refentrytitle>uri</refentrytitle><manvolnum>7</manvolnum></citerefentry>.</para></listitem>
+                                <citerefentry><refentrytitle>uri</refentrytitle><manvolnum>7</manvolnum></citerefentry>. The
+                                URIs should be listed in order of
+                                relevance, starting with the most
+                                relevant. It is a good idea to first
+                                reference documentation that explains
+                                what the unit's purpose is, followed
+                                by how it is configured, followed by
+                                any other related
+                                documentation.</para></listitem>
                         </varlistentry>
 
                         <varlistentry>