man: update journald rate limit defaults

[elogind.git] / man / nss-myhostname.xml

diff --git a/man/nss-myhostname.xml b/man/nss-myhostname.xml
index bd3f635692246903ed6b293dc4bf2ff47a5c550c..cca3a99aaa53dd6247c136ea6c1dec78dcadc132 100644 (file)
--- a/man/nss-myhostname.xml
+++ b/man/nss-myhostname.xml
@@ -22,7 +22,7 @@
   along with systemd; If not, see <http://www.gnu.org/licenses/>.
 -->
 
-<refentry id="nss-myhostname">
+<refentry id="nss-myhostname" conditional='HAVE_MYHOSTNAME'>
 
         <refentryinfo>
                 <title>nss-myhostname</title>
@@ -45,14 +45,12 @@
 
         <refnamediv>
                 <refname>nss-myhostname</refname>
-                <refpurpose>Provide host name resolution for the locally
+                <refpurpose>Provide hostname resolution for the locally
                 configured system hostname.</refpurpose>
         </refnamediv>
 
         <refsynopsisdiv>
-                <cmdsynopsis>
-                        <command>nss-myhostname.la</command>
-                </cmdsynopsis>
+                <para><filename>nss-myhostname.la</filename></para>
         </refsynopsisdiv>
 
         <refsect1>
@@ -60,17 +58,17 @@
 
                 <para><command>nss-myhostname</command> is a plugin for the GNU Name Service Switch
                 (NSS) functionality of the GNU C Library (<command>glibc</command>)
-                providing host name resolution for the locally configured system
+                providing hostname resolution for the locally configured system
                 hostname as returned by
                 <citerefentry><refentrytitle>gethostname</refentrytitle><manvolnum>2</manvolnum></citerefentry>.
-                Various software relies on an always resolvable local host name. When
-                using dynamic hostnames this is usually achieved by patching
+                Various software relies on an always-resolvable local hostname. When
+                using dynamic hostnames, this is usually achieved by patching
                 <filename>/etc/hosts</filename> at the same time as changing the host
                 name. This however is not ideal since it requires a writable
                 <filename>/etc</filename> file system and is fragile because the file
                 might be edited by the administrator at the same time. <command>nss-myhostname</command>
-                simply returns all locally configure public IP addresses, or -- if none
-                are configured -- the IPv4 address 127.0.0.2 (wich is on the local
+                simply returns all locally configured public IP addresses, or, if none
+                are configured, the IPv4 address 127.0.0.2 (which is on the local
                 loopback) and the IPv6 address ::1 (which is the local host) for
                 whatever system hostname is configured locally. Patching
                 <filename>/etc/hosts</filename> is thus no longer necessary.</para>
@@ -88,8 +86,7 @@
         <refsect1>
                 <title>Example</title>
 
-                <programlisting>
-# /etc/nsswitch.conf
+<programlisting># /etc/nsswitch.conf
 
 passwd:         compat
 group:          compat
@@ -103,22 +100,19 @@ services:       db files
 ethers:         db files
 rpc:            db files
 
-netgroup:       nis
-                </programlisting>
+netgroup:       nis</programlisting>
 
                 <para>To test, use <command>glibc</command>'s <command>getent</command> tool:</para>
 
-                <programlisting>
-$ getent ahosts `hostname`
+                <programlisting>$ getent ahosts `hostname`
 ::1             STREAM omega
 ::1             DGRAM
 ::1             RAW
 127.0.0.2       STREAM
 127.0.0.2       DGRAM
-127.0.0.2       RAW
-                </programlisting>
+127.0.0.2       RAW</programlisting>
 
-                <para>In this case the local host name is <varname>omega</varname>.</para>
+                <para>In this case the local hostname is <varname>omega</varname>.</para>
 
         </refsect1>