]> git.ipfire.org Git - thirdparty/systemd.git/commitdiff
doc: use expanded forms for written style 1799/head
authorJan Engelhardt <jengelh@inai.de>
Mon, 26 Oct 2015 14:45:12 +0000 (15:45 +0100)
committerJan Engelhardt <jengelh@inai.de>
Fri, 6 Nov 2015 12:46:26 +0000 (13:46 +0100)
20 files changed:
man/machinectl.xml
man/nss-myhostname.xml
man/nss-mymachines.xml
man/nss-resolve.xml
man/sd_bus_message_append_array.xml
man/sd_bus_new.xml
man/sd_get_seats.xml
man/sd_journal_get_fd.xml
man/sd_login_monitor_new.xml
man/sd_machine_get_class.xml
man/sd_pid_get_session.xml
man/sd_seat_get_active.xml
man/sd_session_is_active.xml
man/sd_uid_get_state.xml
man/systemd-fsck@.service.xml
man/systemd-path.xml
man/systemd.generator.xml
man/systemd.service.xml
man/systemd.socket.xml
man/systemd.unit.xml

index 859789850cdf08717f90874a1d9ec7187b201f99..d1da7f60a63c457f65b61d10bb5bcf96c5d13cf7 100644 (file)
     refers to the image of the running host system. It hence
     conceptually maps to the special <literal>.host</literal> machine
     name described above. Note that <command>machinectl
-    list-images</command> won't show this special image either, unless
+    list-images</command> will not show this special image either, unless
     <option>--all</option> is specified.</para>
   </refsect1>
 
index 277612231b4ca6d4de6227d97a2116fa29cf76a6..859bec29e3ec5dc0fe7dc895da7558cc0debab81 100644 (file)
   <refsect1>
     <title>Example</title>
 
-    <para>Here's an example <filename>/etc/nsswitch.conf</filename>
+    <para>Here is an example <filename>/etc/nsswitch.conf</filename>
     file that enables <command>myhostname</command> correctly:</para>
 
 <programlisting>passwd:         compat mymachines
index 5fce1b1db4ed02155a2da936990e946ff3f50614..d2bec763bb600e50237c0c0390a48f27f42099a1 100644 (file)
@@ -84,7 +84,7 @@
   <refsect1>
     <title>Example</title>
 
-    <para>Here's an example <filename>/etc/nsswitch.conf</filename>
+    <para>Here is an example <filename>/etc/nsswitch.conf</filename>
     file that enables <command>mymachines</command> correctly:</para>
 
     <programlisting>passwd:         compat <command>mymachines</command>
index c3670a02a1ccdee5c9490981bafde4f30468c8af..8b0928145f0efa30d856c678fe2eaf1edeb9c489 100644 (file)
@@ -79,7 +79,7 @@
   <refsect1>
     <title>Example</title>
 
-    <para>Here's an example <filename>/etc/nsswitch.conf</filename>
+    <para>Here is an example <filename>/etc/nsswitch.conf</filename>
     file that enables <command>resolve</command> correctly:</para>
 
 <programlisting>passwd:         compat mymachines
index 5a1abcec933ab4430c38d890b1bbe4c4de2cdc2b..27db2a96c3bb7e0fe97fbc74b6d283f950b75826 100644 (file)
     <parameter>type</parameter>. However, as a special exception, if
     the offset is specified as zero and the size specified as
     UINT64_MAX the full memory file descriptor contents is used. The
-    memory file descriptor is sealed by this call if it hasn't been
+    memory file descriptor is sealed by this call if it has not been
     sealed yet, and cannot be modified after this call. See
     <citerefentry
     project='man-pages'><refentrytitle>memfd_create</refentrytitle><manvolnum>2</manvolnum></citerefentry>
index 130eb5e06e8c4cc0565a48f92deee33b905ee922..e1cab6e567b1cfd782619ad35a3a9bd7177bbd76 100644 (file)
@@ -84,7 +84,7 @@
     or a related call, and then start the connection with
     <citerefentry><refentrytitle>sd_bus_start</refentrytitle><manvolnum>3</manvolnum></citerefentry>.</para>
 
-    <para>In most cases, it's a better idea to invoke
+    <para>In most cases, it is a better idea to invoke
     <citerefentry><refentrytitle>sd_bus_default_user</refentrytitle><manvolnum>3</manvolnum></citerefentry>,
     <citerefentry><refentrytitle>sd_bus_default_system</refentrytitle><manvolnum>3</manvolnum></citerefentry>
     or related calls instead of the more low-level
index f1981f7ea21ad9026b1bca9d015fccb4a53a9051..37eb3fc8945047de89f780bacacd7021ded1b1f3 100644 (file)
         <term><constant>-EINVAL</constant></term>
 
         <listitem><para>An input parameter was invalid (out of range,
-        or NULL, where that's not accepted).</para></listitem>
+        or NULL, where that is not accepted).</para></listitem>
       </varlistentry>
 
       <varlistentry>
index 3a38f733ab781b62874b00f19cdc20be96824f9e..61293f7f99d3527193b72bdca5f288b23b006938 100644 (file)
@@ -187,7 +187,7 @@ else {
     certain latency. This call will return a positive value if the
     journal changes are detected immediately and zero when they need
     to be polled for and hence might be noticed only with a certain
-    latency. Note that there's usually no need to invoke this function
+    latency. Note that there is usually no need to invoke this function
     directly as <function>sd_journal_get_timeout()</function> on these
     file systems will ask for timeouts explicitly anyway.</para>
   </refsect1>
index a8854dd5902f0df65f13ac7ae020d5ac5e57ef97..db21d702529bd215348379a58ee6bf9f3757f813 100644 (file)
@@ -214,7 +214,7 @@ else {
         <term><constant>-EINVAL</constant></term>
 
         <listitem><para>An input parameter was invalid (out of range,
-        or NULL, where that's not accepted). The specified category to
+        or NULL, where that is not accepted). The specified category to
         watch is not known.</para></listitem>
       </varlistentry>
 
index 9ad7f3fc668a60103f15e73a3149061213d5b396..ef604139da65955961deb7e3b613a8d1fe8917b6 100644 (file)
         <term><constant>-EINVAL</constant></term>
 
         <listitem><para>An input parameter was invalid (out of range,
-        or NULL, where that's not accepted).</para></listitem>
+        or NULL, where that is not accepted).</para></listitem>
       </varlistentry>
 
       <varlistentry>
index 88584594018b7bdf2e25dc20c949a2588019c8e5..806cff34e443bf6f1180970ed5f3b315d1b7b8a0 100644 (file)
         <term><constant>-EINVAL</constant></term>
 
         <listitem><para>An input parameter was invalid (out of range,
-        or NULL, where that's not accepted).</para></listitem>
+        or NULL, where that is not accepted).</para></listitem>
       </varlistentry>
 
       <varlistentry>
index ee41f64ec32e3ec6956d68f5dbd31736ca13cb90..6e1d505dce9e5e49398080c0409250290b69fe80 100644 (file)
         <term><constant>-EINVAL</constant></term>
 
         <listitem><para>An input parameter was invalid (out of range,
-        or NULL, where that's not accepted).</para></listitem>
+        or NULL, where that is not accepted).</para></listitem>
       </varlistentry>
 
       <varlistentry>
index 3bf5dc8120ae001006245f6c3faf525a01a4a442..a6076b177abac6815d29733c494a8367bc4b3913 100644 (file)
         <term><constant>-EINVAL</constant></term>
 
         <listitem><para>An input parameter was invalid (out of range,
-        or NULL, where that's not accepted).</para></listitem>
+        or NULL, where that is not accepted).</para></listitem>
       </varlistentry>
 
       <varlistentry>
index 39123a59bb71c202d9aaeabb9a911a865ec63a72..4cc7405dd655910bffd19ffa8ebfb1c76d64201c 100644 (file)
         <term><constant>-EINVAL</constant></term>
 
         <listitem><para>An input parameter was invalid (out of range,
-        or NULL, where that's not accepted). This is also returned if
+        or NULL, where that is not accepted). This is also returned if
         the passed user ID is 0xFFFF or 0xFFFFFFFF, which are
         undefined on Linux.</para></listitem>
       </varlistentry>
index 399d7e19cbd525e7cf6e6199b3a4d99f5869ec5d..933c3247ad5062f414ca876aff0ad17fce4f4d4c 100644 (file)
@@ -62,7 +62,7 @@
     device that is configured for file system checking.
     <filename>systemd-fsck-root.service</filename> is responsible for
     file system checks on the root file system, but only if the
-    root filesystem wasn't checked in the initramfs.
+    root filesystem was not checked in the initramfs.
     <filename>systemd-fsck@.service</filename> is used for all other
     file systems and for the root file system in the initramfs.</para>
 
index c96fcad0b471d2bdcae585434f258fcfbd416102..da6026e3b38928a06d2eb02d6ea64d0568622740 100644 (file)
@@ -66,7 +66,7 @@
     their current values is shown. When at least one argument is
     passed, the path with this name is queried and its value shown.
     The variables whose name begins with <literal>search-</literal>
-    don't refer to individual paths, but instead to a list of
+    do not refer to individual paths, but instead to a list of
     colon-separated search paths, in their order of precedence.</para>
   </refsect1>
 
index 72a2cece2b48bddc36c378a21e79325c38b8052a..b36aab32598ad2e1edbbaef299f1cc34bc6ad94e 100644 (file)
           <para>
             Instead of heading off now and writing all kind of
             generators for legacy configuration file formats, please
-            think twice! It's often a better idea to just deprecate
+            think twice! It is often a better idea to just deprecate
             old stuff instead of keeping it artificially alive.
           </para>
         </listitem>
index 4ed087eccb136611376c0a2055092a6395b48851..4e5098f0e1921a2f1f43a76ee19ef9ede570b358 100644 (file)
@@ -1324,7 +1324,7 @@ ExecStart=/usr/sbin/simple-dbus-service
 [Install]
 WantedBy=multi-user.target</programlisting>
 
-      <para>For <emphasis>bus-activatable</emphasis> services, don't
+      <para>For <emphasis>bus-activatable</emphasis> services, do not
       include a <literal>[Install]</literal> section in the systemd
       service file, but use the <varname>SystemdService=</varname>
       option in the corresponding DBus service file, for example
@@ -1366,7 +1366,7 @@ ExecStart=/usr/sbin/simple-notifying-service
 WantedBy=multi-user.target</programlisting>
 
       <para>Note that the daemon has to support systemd's notification
-      protocol, else systemd will think the service hasn't started yet
+      protocol, else systemd will think the service has not started yet
       and kill it after a timeout. For an example of how to update
       daemons to support this protocol transparently, take a look at
       <citerefentry><refentrytitle>sd_notify</refentrytitle><manvolnum>3</manvolnum></citerefentry>.
index e8972a2902df5d13f52008ca34c832fbfb5b5dfe..410886f8417e643fc37515787f822c9062909091 100644 (file)
 
       <varlistentry>
         <term><varname>KeepAliveProbes=</varname></term>
-        <listitem><para>Takes an integer as argument. It's the number of
+        <listitem><para>Takes an integer as argument. It is the number of
         unacknowledged probes to send before considering the
         connection dead and notifying the application layer. This
         controls the TCP_KEEPCNT socket option (see
index a9d49ef2015a74e7e9547d2e0765aeb48a97758b..afa156f7f91e2781eddef1fc271fd7cc99332085 100644 (file)
         <term><varname>ConditionFileNotEmpty=</varname></term>
         <term><varname>ConditionFileIsExecutable=</varname></term>
 
-        <!-- We don't document ConditionNull=
+        <!-- We do not document ConditionNull=
              here, as it is not particularly
              useful and probably just
              confusing. -->