summaryrefslogtreecommitdiffstats
path: root/tags/i/invalid-systemd-documentation.tag
diff options
context:
space:
mode:
Diffstat (limited to 'tags/i/invalid-systemd-documentation.tag')
-rw-r--r--tags/i/invalid-systemd-documentation.tag25
1 files changed, 25 insertions, 0 deletions
diff --git a/tags/i/invalid-systemd-documentation.tag b/tags/i/invalid-systemd-documentation.tag
new file mode 100644
index 0000000..a4d126c
--- /dev/null
+++ b/tags/i/invalid-systemd-documentation.tag
@@ -0,0 +1,25 @@
+Tag: invalid-systemd-documentation
+Severity: info
+Check: systemd
+Explanation: The named systemd service file contains a <code>Documentation</code>
+ field that is not a URI.
+ .
+ The field should contain a space-separated list of URIs referencing documentation
+ for the unit or its configuration. Accepted are only URIs of the types
+ <code>http://</code>, <code>https://</code>, <code>file:</code>, <code>info:</code>,
+ <code>man:</code>.
+ .
+ For more information about the syntax of these URIs, see <code>uri(7)</code>. 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.
+ .
+ The <code>Documentation</code> key may be specified more than once, in which case the
+ specified list of URIs is merged. If the empty string is assigned to this option, the
+ list is reset and prior assignments have no effect.
+ .
+ Documentation for systemd service files can be automatically viewed using
+ <code>systemctl help servicename</code> if this field is present.
+See-Also:
+ systemd.unit(5),
+ uri(7)