mirror of
https://gitlab.freedesktop.org/NetworkManager/NetworkManager
synced 2024-07-21 18:24:49 +00:00
man: make the templated manuals a bit more consistent with the rest
Use the docbook tags wherever appropriate.
This commit is contained in:
parent
60582bf443
commit
20300fd7db
|
@ -19,6 +19,10 @@
|
|||
<xsl:template match="nm-ifcfg-rh-docs">
|
||||
<xsl:variable name="unsupported" select="'adsl, bluetooth, ppp, pppoe, serial, generic, gsm, cdma, 802-11-olpc-mesh, wimax, vpn'"/>
|
||||
<refentry id="nm-settings-ifcfg-rh">
|
||||
<refentryinfo>
|
||||
<title>nm-settings-ifcfg-rh</title>
|
||||
<author>NetworkManager developers</author>
|
||||
</refentryinfo>
|
||||
<refmeta>
|
||||
<refentrytitle>nm-settings-ifcfg-rh</refentrytitle>
|
||||
<manvolnum>5</manvolnum>
|
||||
|
@ -30,8 +34,7 @@
|
|||
<refname>nm-settings-ifcfg-rh</refname>
|
||||
<refpurpose>Description of <emphasis>ifcfg-rh</emphasis> settings plugin</refpurpose>
|
||||
</refnamediv>
|
||||
<refsect1>
|
||||
<title>DESCRIPTION</title>
|
||||
<refsect1 id='description'><title>Description</title>
|
||||
<para>
|
||||
NetworkManager is based on the concept of connection profiles that contain
|
||||
network configuration (see <citerefentry><refentrytitle>nm-settings</refentrytitle>
|
||||
|
@ -56,8 +59,7 @@
|
|||
(initscripts).
|
||||
</para>
|
||||
</refsect1>
|
||||
<refsect1>
|
||||
<title>File Format</title>
|
||||
<refsect1 id='file_format'><title>File Format</title>
|
||||
<para>
|
||||
The <emphasis>ifcfg-rh</emphasis> config format is a simple text file containing
|
||||
VARIABLE="value" lines. The format is described in <filename>sysconfig.txt</filename>
|
||||
|
@ -203,8 +205,7 @@ DEVICETYPE=TeamPort
|
|||
</formalpara>
|
||||
</refsect1>
|
||||
|
||||
<refsect1>
|
||||
<title>Differences against initscripts</title>
|
||||
<refsect1 id='differences_against_initscripts'><title>Differences against initscripts</title>
|
||||
<para>
|
||||
The main differences of NetworkManager ifcfg-rh plugin and traditional
|
||||
initscripts are:
|
||||
|
@ -268,8 +269,7 @@ DEVICETYPE=TeamPort
|
|||
</para>
|
||||
</refsect1>
|
||||
|
||||
<refsect1>
|
||||
<title>DETAILS</title>
|
||||
<refsect1 id='details'><title>Details</title>
|
||||
<para>
|
||||
<emphasis>ifcfg-rh</emphasis> plugin variables marked with <emphasis>(+)</emphasis>
|
||||
are NetworkManager specific extensions not understood by traditional initscripts.
|
||||
|
@ -303,26 +303,20 @@ DEVICETYPE=TeamPort
|
|||
</refsect2>
|
||||
</refsect1>
|
||||
|
||||
<refsect1>
|
||||
<title>AUTHOR</title>
|
||||
<para>
|
||||
<author>
|
||||
<firstname>NetworkManager developers</firstname>
|
||||
</author>
|
||||
</para>
|
||||
</refsect1>
|
||||
<refsect1>
|
||||
<title>FILES</title>
|
||||
<refsect1 id='files'><title>Files</title>
|
||||
<para><filename>/etc/sysconfig/network-scripts/ifcfg-*</filename></para>
|
||||
<para><filename>/etc/sysconfig/network-scripts/keys-*</filename></para>
|
||||
<para><filename>/etc/sysconfig/network-scripts/route-*</filename></para>
|
||||
<para><filename>/etc/sysconfig/network-scripts/route6-*</filename></para>
|
||||
<para><filename>/usr/share/doc/initscripts/sysconfig.txt</filename></para>
|
||||
</refsect1>
|
||||
<refsect1>
|
||||
<title>SEE ALSO</title>
|
||||
<para>https://developer.gnome.org/NetworkManager/unstable/ref-settings.html</para>
|
||||
<para>nm-settings(5), nm-settings-keyfile(5), NetworkManager(8), NetworkManager.conf(5), nmcli(1), nmcli-examples(5)</para>
|
||||
<refsect1 id='see_also'><title>See Also</title>
|
||||
<para><citerefentry><refentrytitle>nm-settings</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
|
||||
<citerefentry><refentrytitle>nm-settings-keyfile</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
|
||||
<citerefentry><refentrytitle>NetworkManager</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
|
||||
<citerefentry><refentrytitle>NetworkManager.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
|
||||
<citerefentry><refentrytitle>nmcli</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
|
||||
<citerefentry><refentrytitle>nmcli-examples</refentrytitle><manvolnum>5</manvolnum></citerefentry></para>
|
||||
</refsect1>
|
||||
</refentry>
|
||||
</xsl:template>
|
||||
|
|
|
@ -14,6 +14,10 @@
|
|||
|
||||
<xsl:template match="nm-keyfile-docs">
|
||||
<refentry id="nm-settings-keyfile">
|
||||
<refentryinfo>
|
||||
<title>nm-settings-keyfile</title>
|
||||
<author>NetworkManager developers</author>
|
||||
</refentryinfo>
|
||||
<refmeta>
|
||||
<refentrytitle>nm-settings-keyfile</refentrytitle>
|
||||
<manvolnum>5</manvolnum>
|
||||
|
@ -25,8 +29,7 @@
|
|||
<refname>nm-settings-keyfile</refname>
|
||||
<refpurpose>Description of <emphasis>keyfile</emphasis> settings plugin</refpurpose>
|
||||
</refnamediv>
|
||||
<refsect1>
|
||||
<title>DESCRIPTION</title>
|
||||
<refsect1 id='description'><title>Description</title>
|
||||
<para>
|
||||
NetworkManager is based on the concept of connection profiles that contain
|
||||
network configuration (see <citerefentry><refentrytitle>nm-settings</refentrytitle>
|
||||
|
@ -46,8 +49,7 @@
|
|||
in plaintext inside the file.
|
||||
</para>
|
||||
</refsect1>
|
||||
<refsect1>
|
||||
<title>File Format</title>
|
||||
<refsect1 id='file_format'><title>File Format</title>
|
||||
<para>
|
||||
The <emphasis>keyfile</emphasis> config format is a simple .ini-style
|
||||
format. It consists of sections (groups) of key-value pairs. Each section
|
||||
|
@ -185,8 +187,7 @@ id=4
|
|||
</formalpara>
|
||||
</refsect1>
|
||||
|
||||
<refsect1>
|
||||
<title>DETAILS</title>
|
||||
<refsect1 id='details'><title>Details</title>
|
||||
<para>
|
||||
<emphasis>keyfile</emphasis> plugin variables for the majority of NetworkManager
|
||||
properties have one-to-one mapping. It means a NetworkManager property is stored
|
||||
|
@ -240,22 +241,17 @@ id=4
|
|||
</refsect2>
|
||||
</refsect1>
|
||||
|
||||
<refsect1>
|
||||
<title>AUTHOR</title>
|
||||
<para>
|
||||
<author>
|
||||
<firstname>NetworkManager developers</firstname>
|
||||
</author>
|
||||
</para>
|
||||
</refsect1>
|
||||
<refsect1>
|
||||
<title>FILES</title>
|
||||
<refsect1 id='files'><title>Files</title>
|
||||
<para><filename>/etc/NetworkManager/system-connections/*</filename></para>
|
||||
</refsect1>
|
||||
<refsect1>
|
||||
<title>SEE ALSO</title>
|
||||
<para>https://developer.gnome.org/NetworkManager/unstable/ref-settings.html</para>
|
||||
<para>nm-settings(5), nm-settings-ifcfg-rh(5), NetworkManager(8), NetworkManager.conf(5), nmcli(1), nmcli-examples(5)</para>
|
||||
|
||||
<refsect1 id='see_also'><title>See Also</title>
|
||||
<para><citerefentry><refentrytitle>nm-settings</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
|
||||
<citerefentry><refentrytitle>nm-settings-ifcfg-rh</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
|
||||
<citerefentry><refentrytitle>NetworkManager</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
|
||||
<citerefentry><refentrytitle>NetworkManager.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
|
||||
<citerefentry><refentrytitle>nmcli</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
|
||||
<citerefentry><refentrytitle>nmcli-examples</refentrytitle><manvolnum>5</manvolnum></citerefentry></para>
|
||||
</refsect1>
|
||||
</refentry>
|
||||
</xsl:template>
|
||||
|
|
|
@ -14,6 +14,10 @@
|
|||
|
||||
<xsl:template match="nm-setting-docs">
|
||||
<refentry id="nm-settings">
|
||||
<refentryinfo>
|
||||
<title>nm-settings</title>
|
||||
<author>NetworkManager developers</author>
|
||||
</refentryinfo>
|
||||
<refmeta>
|
||||
<refentrytitle>nm-settings</refentrytitle>
|
||||
<manvolnum>5</manvolnum>
|
||||
|
@ -25,8 +29,8 @@
|
|||
<refname>nm-settings</refname>
|
||||
<refpurpose>Description of settings and properties of NetworkManager connection profiles</refpurpose>
|
||||
</refnamediv>
|
||||
<refsect1>
|
||||
<title>DESCRIPTION</title>
|
||||
|
||||
<refsect1 id='description'><title>Description</title>
|
||||
<para>
|
||||
NetworkManager is based on a concept of connection profiles, sometimes referred to as
|
||||
connections only. These connection profiles contain a network configuration. When
|
||||
|
@ -107,23 +111,16 @@
|
|||
</itemizedlist>
|
||||
</refsect2>
|
||||
</refsect1>
|
||||
<refsect1>
|
||||
<title>AUTHOR</title>
|
||||
<para>
|
||||
<author>
|
||||
<firstname>NetworkManager developers</firstname>
|
||||
</author>
|
||||
</para>
|
||||
|
||||
<refsect1 id='files'><title>Files</title>
|
||||
<para><filename>/etc/NetworkManager/system-connections</filename> or distro plugin-specific location</para>
|
||||
</refsect1>
|
||||
<refsect1>
|
||||
<title>FILES</title>
|
||||
<para>/etc/NetworkManager/system-connections</para>
|
||||
<para>or distro plugin-specific location</para>
|
||||
</refsect1>
|
||||
<refsect1>
|
||||
<title>SEE ALSO</title>
|
||||
<para>https://wiki.gnome.org/Projects/NetworkManager/ConfigurationSpecification</para>
|
||||
<para>NetworkManager(8), nmcli(1), nmcli-examples(5), NetworkManager.conf(5)</para>
|
||||
|
||||
<refsect1 id='see_also'><title>See Also</title>
|
||||
<para><citerefentry><refentrytitle>NetworkManager</refentrytitle><manvolnum>8</manvolnum></citerefentry>,
|
||||
<citerefentry><refentrytitle>nmcli</refentrytitle><manvolnum>1</manvolnum></citerefentry>,
|
||||
<citerefentry><refentrytitle>nmcli-examples</refentrytitle><manvolnum>5</manvolnum></citerefentry>,
|
||||
<citerefentry><refentrytitle>NetworkManager.conf</refentrytitle><manvolnum>5</manvolnum></citerefentry></para>
|
||||
</refsect1>
|
||||
</refentry>
|
||||
</xsl:template>
|
||||
|
|
Loading…
Reference in a new issue