doc: choose different words to improve clarity

I suggest the following changes to improve the way the text reads
("flows").

diff --git a/man/crypttab.xml b/man/crypttab.xml
index 2d4150013bedc90b80b571e6f59956fbf4574108..668e51dc0628ee25da1bcf5362111a7873e96ff2 100644 (file)
--- a/man/crypttab.xml
+++ b/man/crypttab.xml
@@ -171,7 +171,7 @@
                                 If the key slot does not match the given
                                 passphrase or key, but another would, the
                                 setup of the device will fail regardless.
                                 If the key slot does not match the given
                                 passphrase or key, but another would, the
                                 setup of the device will fail regardless.

-                                This implies <varname>luks</varname>. See
+                                This option implies <varname>luks</varname>. See

                                 <citerefentry><refentrytitle>cryptsetup</refentrytitle><manvolnum>8</manvolnum></citerefentry>
                                 for possible values. The default is to try
                                 all key slots in sequential order.</para></listitem>
                                 <citerefentry><refentrytitle>cryptsetup</refentrytitle><manvolnum>8</manvolnum></citerefentry>
                                 for possible values. The default is to try
                                 all key slots in sequential order.</para></listitem>


@@ -275,7 +275,7 @@
                                 <term><varname>tcrypt-hidden</varname></term>
 
                                 <listitem><para>Use the hidden TrueCrypt volume.
                                 <term><varname>tcrypt-hidden</varname></term>
 
                                 <listitem><para>Use the hidden TrueCrypt volume.

-                                This implies <varname>tcrypt</varname>.</para>
+                                This option implies <varname>tcrypt</varname>.</para>

 
                                 <para>This will map the hidden volume that is
                                 inside of the volume provided in the second
 
                                 <para>This will map the hidden volume that is
                                 inside of the volume provided in the second


@@ -304,7 +304,7 @@
                                 <term><varname>tcrypt-system</varname></term>
 
                                 <listitem><para>Use TrueCrypt in system
                                 <term><varname>tcrypt-system</varname></term>
 
                                 <listitem><para>Use TrueCrypt in system

-                                encryption mode. This implies
+                                encryption mode. This option implies

                                 <varname>tcrypt</varname>.</para></listitem>
                         </varlistentry>
 
                                 <varname>tcrypt</varname>.</para></listitem>
                         </varlistentry>
 

diff --git a/man/sd_bus_creds_get_pid.xml b/man/sd_bus_creds_get_pid.xml
index 25978a28957491f542cfde655820c031ae0bd2fb..a35efef0ca84ecc28eca6c39ffd6554409325141 100644 (file)
--- a/man/sd_bus_creds_get_pid.xml
+++ b/man/sd_bus_creds_get_pid.xml
@@ -252,7 +252,7 @@ along with systemd; If not, see <http://www.gnu.org/licenses/>.
     numeric GID (group identifier).</para>
 
     <para><function>sd_bus_creds_get_comm</function> will retrieve the
     numeric GID (group identifier).</para>
 
     <para><function>sd_bus_creds_get_comm</function> will retrieve the

-    comm field (name of the executable, as stored in
+    comm field (truncated name of the executable, as stored in

     <filename>/proc/<replaceable>pid</replaceable>/comm</filename>).
     </para>
 
     <filename>/proc/<replaceable>pid</replaceable>/comm</filename>).
     </para>
 

diff --git a/man/sd_bus_message_get_monotonic_usec.xml b/man/sd_bus_message_get_monotonic_usec.xml
index 57b115c63a028ac053f18514587b2e9918358fae..b9437ff62ebc924d99bb9c90e0095603ecd328f7 100644 (file)
--- a/man/sd_bus_message_get_monotonic_usec.xml
+++ b/man/sd_bus_message_get_monotonic_usec.xml
@@ -104,7 +104,7 @@
 
                 <para>These timestamps and the sequence number are
                 attached to each message by the kernel and cannot be
 
                 <para>These timestamps and the sequence number are
                 attached to each message by the kernel and cannot be

-                manipulated by the sending userspace.</para>
+                manipulated by the sender.</para>

 
                 <para>Note that these timestamps are only available on
                 some bus transports, and only after support for them
 
                 <para>Note that these timestamps are only available on
                 some bus transports, and only after support for them