chiark / gitweb /
man: use <literal> not <filename> for suffixes
authorZbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>
Fri, 12 Jul 2013 03:39:27 +0000 (23:39 -0400)
committerZbigniew Jędrzejewski-Szmek <zbyszek@in.waw.pl>
Fri, 12 Jul 2013 05:09:25 +0000 (01:09 -0400)
Especially sentences like "filename ends in .suffix" are easier to
parse if the suffix is surrounded by quotes. In sentences like
"requires a .service unit", where the suffix is used as a class
designation, there is no need to use quotes.

man/systemd.automount.xml
man/systemd.device.xml
man/systemd.mount.xml
man/systemd.path.xml
man/systemd.snapshot.xml
man/systemd.socket.xml
man/systemd.swap.xml
man/systemd.target.xml
man/systemd.timer.xml
man/systemd.unit.xml

index 2a310d3ecf733a133c95168aa5af91142babf73d..adba75a71ad9074156cd419e09c090c46b491f12 100644 (file)
@@ -55,7 +55,7 @@
                 <title>Description</title>
 
                 <para>A unit configuration file whose name ends in
-                <filename>.automount</filename> encodes information
+                <literal>.automount</literal> encodes information
                 about a file system automount point controlled and
                 supervised by systemd.</para>
 
index 1c29aa4e79fa0c0374233f635fa11e7cb51d5027..e3cf071bcb9d690a10a93e8f5df2bc70a820b020 100644 (file)
@@ -55,7 +55,7 @@
                 <title>Description</title>
 
                 <para>A unit configuration file whose name ends in
-                <filename>.device</filename> encodes information about
+                <literal>.device</literal> encodes information about
                 a device unit as exposed in the
                 sysfs/<citerefentry><refentrytitle>udev</refentrytitle><manvolnum>7</manvolnum></citerefentry>
                 device tree.</para>
index 07f21025b8a1721b374a4378cdc076c5d897ffc7..c57f613290dc3d95590152700837d078dd57981e 100644 (file)
@@ -55,7 +55,7 @@
                 <title>Description</title>
 
                 <para>A unit configuration file whose name ends in
-                <filename>.mount</filename> encodes information about
+                <literal>.mount</literal> encodes information about
                 a file system mount point controlled and supervised by
                 systemd.</para>
 
index 1975142d2c0648211f8c00e0258fb9f188021d30..8c782b85311b9f685b54d0521e2bf828cac9d454 100644 (file)
@@ -55,7 +55,7 @@
                 <title>Description</title>
 
                 <para>A unit configuration file whose name ends in
-                <filename>.path</filename> encodes information about
+                <literal>.path</literal> encodes information about
                 a path monitored by systemd, for
                 path-based activation.</para>
 
                                 when any of the configured paths
                                 changes. The argument is a unit name,
                                 whose suffix is not
-                                <filename>.path</filename>. If not
+                                <literal>.path</literal>. If not
                                 specified, this value defaults to a
                                 service that has the same name as the
                                 path unit, except for the suffix. (See
index 08d14c4e012b93739a044b7fc173cfe4c989c57a..4e8d5a901ff06d85737e50ad52960ff19f364203 100644 (file)
@@ -57,7 +57,7 @@
                 <para>Snapshot units are not configured via unit
                 configuration files. Nonetheless they are named
                 similar to filenames. A unit name whose name ends in
-                <filename>.snapshot</filename> refers to a dynamic
+                <literal>.snapshot</literal> refers to a dynamic
                 snapshot of the systemd runtime state.</para>
 
                 <para>Snapshots are not configured on disk but created
index 2e1fb7cea1654131ede13f6a1159a91fcfeffbff..1b899c46a1204db9488f5cf9551dd86f1380ab76 100644 (file)
@@ -55,7 +55,7 @@
                 <title>Description</title>
 
                 <para>A unit configuration file whose name ends in
-                <filename>.socket</filename> encodes information about
+                <literal>.socket</literal> encodes information about
                 an IPC or network socket or a file system FIFO
                 controlled and supervised by systemd, for socket-based
                 activation.</para>
index 9a3905a927cce62acc4aee916f7b2bc10efee4fd..d931c46e8032358762430be9dfc689e06f939d2f 100644 (file)
@@ -55,7 +55,7 @@
                 <title>Description</title>
 
                 <para>A unit configuration file whose name ends in
-                <filename>.swap</filename> encodes information about a
+                <literal>.swap</literal> encodes information about a
                 swap device or file for memory paging controlled and
                 supervised by systemd.</para>
 
index fd51cfde3a21c267b5346a50c1ecac6084de82fb..15662a548d8f60525349dd9205c7e5d376d64aa8 100644 (file)
@@ -55,7 +55,7 @@
                 <title>Description</title>
 
                 <para>A unit configuration file whose name ends in
-                <filename>.target</filename> encodes information about
+                <literal>.target</literal> encodes information about
                 a target unit of systemd, which is used for grouping
                 units and as well-known synchronization points during
                 start-up.</para>
index 1f0aac2eed00afabda8b85261454822606742c69..fa67d59a22acac7eec7982019bb5ee5ce6c79440 100644 (file)
@@ -55,7 +55,7 @@
                 <title>Description</title>
 
                 <para>A unit configuration file whose name ends in
-                <filename>.timer</filename> encodes information about
+                <literal>.timer</literal> encodes information about
                 a timer controlled and supervised by systemd, for
                 timer-based activation.</para>
 
                                 <listitem><para>The unit to activate
                                 when this timer elapses. The argument is a
                                 unit name, whose suffix is not
-                                <filename>.timer</filename>. If not
+                                <literal>.timer</literal>. If not
                                 specified, this value defaults to a
                                 service that has the same name as the
                                 timer unit, except for the
index 4f0bd64b121728c488e8ba1747f39348d55b5206..a870f6b17ab325ab79c6c3254356a18e90d8296b 100644 (file)
                 <para>Along with a unit file
                 <filename>foo.service</filename> a directory
                 <filename>foo.service.d/</filename> may exist. All
-                files with the suffix <filename>.conf</filename> from
+                files with the suffix <literal>.conf</literal> from
                 this directory will be parsed after the file itself is
                 parsed. This is useful to alter or add configuration
                 settings to a unit, without having to modify their