man: Convert network-settings(8) to asciidoc
authorMichael Tremer <michael.tremer@ipfire.org>
Sun, 31 Mar 2019 13:47:14 +0000 (15:47 +0200)
committerMichael Tremer <michael.tremer@ipfire.org>
Sun, 31 Mar 2019 13:47:14 +0000 (15:47 +0200)
Signed-off-by: Michael Tremer <michael.tremer@ipfire.org>
man/network-settings.txt [new file with mode: 0644]
man/network-settings.xml [deleted file]

diff --git a/man/network-settings.txt b/man/network-settings.txt
new file mode 100644 (file)
index 0000000..e77f038
--- /dev/null
@@ -0,0 +1,44 @@
+= network-settings(8)
+Michael Tremer <michael.tremer@ipfire.org>
+
+== NAME
+network-settings - Change global network settings
+
+== SYNOPSIS
+'network settings'
+'network settings' KEY=VALUE
+
+== DESCRIPTION
+The 'network settings' command may be used to set global settings.
+
+Please have a look at the individual man pages for more options.
+
+== COMMANDS
+If no additional argument is given, running the command will dump a list of
+all settings variables and their current values.
+
+You may set a new value by adding the variable name and the new
+value to the command line.
+
+== VARIABLES
+
+'DEBUG=[true|_false_]'::
+       The DEBUG will control whether debug logging is enabled or not.
+       Additionally to writing debug log messages to the log files, the messages
+       will be displayed on the console as well.
+
+'WIRELESS_REGULATORY_DOMAIN=_00_'::
+       The wireless regulatory domain is set globally for the entire system with
+       the WIRELESS_REGULATORY_DOMAIN setting.
+       +
+       The default is '00' which is the _world_ setting.
+       +
+       Valid values are country codes for countries which have their own
+       regulatory domain.
+
+== AUTHORS
+Michael Tremer
+
+== SEE ALSO
+link:network[8],
+link:network-dns-server[8]
diff --git a/man/network-settings.xml b/man/network-settings.xml
deleted file mode 100644 (file)
index 7d1c70d..0000000
+++ /dev/null
@@ -1,118 +0,0 @@
-<?xml version="1.0"?>
-<!DOCTYPE refentry PUBLIC "-//OASIS/DTD DocBook XML V4.2//EN"
-       "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd">
-
-<refentry id="network-settings">
-       <refentryinfo>
-               <title>network-settings</title>
-               <productname>network</productname>
-
-               <authorgroup>
-                       <author>
-                               <contrib>Developer</contrib>
-                               <firstname>Michael</firstname>
-                               <surname>Tremer</surname>
-                               <email>michael.tremer@ipfire.org</email>
-                       </author>
-               </authorgroup>
-       </refentryinfo>
-
-       <refmeta>
-               <refentrytitle>network-settings</refentrytitle>
-               <manvolnum>8</manvolnum>
-       </refmeta>
-
-       <refnamediv>
-               <refname>network-settings</refname>
-               <refpurpose>Network Configuration Control Program</refpurpose>
-       </refnamediv>
-
-       <refsynopsisdiv>
-               <cmdsynopsis>
-                       <command>network settings</command>
-               </cmdsynopsis>
-
-               <cmdsynopsis>
-                       <command>network settings <replaceable>KEY=VALUE</replaceable></command>
-               </cmdsynopsis>
-       </refsynopsisdiv>
-
-       <refsect1>
-               <title>Description</title>
-
-               <para>
-                       The <command>network settings</command> command may be used to set
-                       global settingsuration options.
-               </para>
-               <para>
-                       Please have a look at the individual man pages for more options.
-               </para>
-       </refsect1>
-
-       <refsect1>
-               <title>Commands</title>
-
-               <para>
-                       If no additional argument is given, running the command will
-                       dump a list of all settingsuration variables and their current values.
-               </para>
-
-               <para>
-                       You may set a new value by adding the variable name and the new
-                       value to the command line.
-               </para>
-       </refsect1>
-
-       <refsect1>
-               <title>Variables</title>
-
-               <variablelist>
-                       <varlistentry>
-                               <term>
-                                       <varname>DEBUG</varname>=[<emphasis>0</emphasis>|1]
-                               </term>
-
-                               <listitem>
-                                       <para>
-                                               The <varname>DEBUG</varname> will control whether debug
-                                               logging is enabled or not. Additionally to writing debug
-                                               log messages to the log files, the messages will be displayed
-                                               on the console as well.
-                                       </para>
-                               </listitem>
-                       </varlistentry>
-
-                       <varlistentry>
-                               <term>
-                                       <varname>WIRELESS_REGULATORY_DOMAIN</varname>=<emphasis>00</emphasis>
-                               </term>
-
-                               <listitem>
-                                       <para>
-                                               The wireless regulatory domain is set globally for the
-                                               entire system with the <varname>WIRELESS_REGULATORY_DOMAIN</varname>
-                                               setting. The default is <emphasis>00</emphasis> which
-                                               is the <emphasis>world</emphasis> setting.
-                                               Valid values are country codes for countries which have their
-                                               own regulatory domain.
-                                       </para>
-                               </listitem>
-                       </varlistentry>
-               </variablelist>
-       </refsect1>
-
-       <refsect1>
-               <title>See Also</title>
-
-               <para>
-                       <citerefentry>
-                               <refentrytitle>network</refentrytitle>
-                               <manvolnum>8</manvolnum>
-                       </citerefentry>,
-                       <citerefentry>
-                               <refentrytitle>network-dns-server</refentrytitle>
-                               <manvolnum>8</manvolnum>
-                       </citerefentry>
-               </para>
-       </refsect1>
-</refentry>