Text edits and formatting changes for Docbook-to-Sphinx conversion

10 files changed, 475 insertions, 436 deletions

diff --git a/doc/sphinx/man/kea-admin.8.rst b/doc/sphinx/man/kea-admin.8.rst
index 31e4fb6e67..ff866565b3 100644
--- a/doc/sphinx/man/kea-admin.8.rst
+++ b/doc/sphinx/man/kea-admin.8.rst
@@ -1,99 +1,127 @@
-:orphan:
-
-kea-admin
-8
-Kea
-kea-admin
-Shell script for managing Kea databases
-2014-2018
-Internet Systems Consortium, Inc. ("ISC")
-kea-admin
-command
-backend
--u
-database username
--p
-database password
--n
-database name
--d
-scripts directory
--4 \| -6
--o
-output file
--v
-DESCRIPTION
-===========
-
-kea-admin is a shell script which offers database maintenance. In
+..
+   Copyright (C) Internet Systems Consortium, Inc. ("ISC")
+
+   This Source Code Form is subject to the terms of the Mozilla Public
+   License, v. 2.0. If a copy of the MPL was not distributed with this
+   file, You can obtain one at http://mozilla.org/MPL/2.0/.
+
+   See the COPYRIGHT file distributed with this work for additional
+   information regarding copyright ownership.
+
+.. highlight: console
+
+.. kea-admin:
+
+kea-admin - Shell script for managing Kea databases
+---------------------------------------------------
+
+Synopsis
+~~~~~~~~
+
+:program:`kea-admin` [command] [backend] [**-u** database username] [**-p** database password] [**-n** database name] [**-d** scripts directory] [**-4** | **-6**] [**-o** output file] [**-v**]
+
+Description
+~~~~~~~~~~~
+
+``kea-admin`` is a shell script which offers database maintenance. In
 particular, it features database initialization, database version
-checking and database schema upgrade.
+checking, and database schema upgrade.
 
-OPTIONS
-=======
+Arguments
+~~~~~~~~~
 
 ``command``
-   Command to be issued to the servers. It can be one of the following:
+   Specifies the command to be issued to the servers. It can be one of the following:
 
-   lease-init
-      Initializes a new lease database. Useful during first Kea
+   **lease-init**
+      Initializes a new lease database, which is useful during the first Kea
       installation. The database is initialized to the latest version
       supported by the version of the software.
 
-   lease-version
-      Reports lease database version. This is not necessarily equal to
-      Kea version as each backend has its own versioning scheme.
+   **lease-version**
+      Reports the lease database version. This is not necessarily the same as the
+      Kea version, as each backend has its own versioning scheme.
 
-   lease-upgrade
-      Conducts lease database upgrade. This is useful when migrating
+   **lease-upgrade**
+      Conducts a lease database upgrade. This is useful when migrating
       between old and new Kea versions.
 
-   lease-dump
+   **lease-dump**
       Dumps the contents of the lease database (MySQL and PostgreSQL
-      backends) to text file. The content of the file consists of
-      comma-separated-values (CSV) where each line in the file contains
-      all of the values for a single lease. The first line of file is a
+      backends) to a text file. The content of the file consists of
+      comma-separated values (CSV) where each line in the file contains
+      all of the values for a single lease. The first line of the file is a
       header line containing the column names.
 
 ``backend``
-   Specifies backend type. Currently allowed backends are: memfile,
-   mysql and pgsql.
+   Specifies the backend type. Currently allowed backends are: memfile,
+   mysql, and pgsql.
 
 ``-u|--user username``
-   Specify the username when connecting to a database. If not specified,
-   the default value of keatest is used.
+   Specifies the username when connecting to a database. If not specified,
+   the default value of **keatest** is used.
 
 ``-p|--password password``
    Specifies the password when connecting to a database. If not
-   specified, the default value of keatest is used.
+   specified, the default value of **keatest** is used.
 
 ``-n|--name database-name``
-   Specifies the database name to connect to. If not specified, the
-   default value of keatest is used.
+   Specifies the name of the database to connect to. If not specified, the
+   default value of **keatest** is used.
 
 ``-d|--directory script-directory``
-   Used for override scripts directory. That script is used during
-   upgrades, database initialization and possibly other operations. If
-   not specified, the default value of (prefix)/share/kea/scripts/ is
+   Specifies the override scripts directory. That script is used during
+   upgrades, database initialization, and possibly other operations. If
+   not specified, the default value of ``(prefix)/share/kea/scripts/`` is
    used.
 
 ``-o|--output output_file``
-   Required for lease-dump, Specifies the file to which the lease data
-   will be dumped.
+   Specifies the file to which the lease data will be dumped. Required for lease-dump.
 
 ``-v|--version``
-   Prints kea-admin version and quits.
+   Prints the ``kea-admin`` version and quits.
 
 ``-4``
-   Directs kea-admin to lease-dump the DHCPv4 leases. Incompatible with
+   Directs ``kea-admin`` to lease-dump the DHCPv4 leases. Incompatible with
    the -6 option.
 
 ``-6``
-   Directs kea-admin to lease-dump the DHCPv6 leases. Incompatible with
+   Directs ``kea-admin`` to lease-dump the DHCPv6 leases. Incompatible with
    the -4 option.
 
-SEE ALSO
-========
+Documentation
+~~~~~~~~~~~~~
+
+Kea comes with an extensive Kea Administrator Reference Manual that covers
+all aspects of running the Kea software - compilation, installation,
+configuration, configuration examples, and much more. Kea also features a
+Kea Messages Manual, which lists all possible messages Kea can print
+with a brief description for each of them. Both documents are
+available in various formats (.txt, .html, .pdf) with the Kea
+distribution. The Kea documentation is available at
+https://kb.isc.org/docs/kea-administrator-reference-manual .
+
+Kea source code is documented in the Kea Developer's Guide. Its online
+version is available at https://jenkins.isc.org/job/Kea_doc/doxygen/.
+
+The Kea project website is available at https://kea.isc.org.
+
+Mailing Lists and Support
+~~~~~~~~~~~~~~~~~~~~~~~~~
+
+There are two public mailing lists available for the Kea project. **kea-users**
+(kea-users at lists.isc.org) is intended for Kea users, while **kea-dev**
+(kea-dev at lists.isc.org) is intended for Kea developers, prospective
+contributors, and other advanced users. Both lists are available at
+https://lists.isc.org. The community provides best-effort support
+on both of those lists.
+
+ISC provides professional support for Kea services. See
+https://www.isc.org/kea/ for details.
+
+See Also
+~~~~~~~~
 
-keactrl 8, kea-dhcp4 8, kea-dhcp6 8, kea-dhcp-ddns 8, kea-ctrl-agent 8,
-kea-netconf 8, keactrl 8, perfdhcp 8, Kea Administrator Guide.
+:manpage:`kea-dhcp4(8)`, :manpage:`kea-dhcp6(8)`,
+:manpage:`kea-dhcp-ddns(8)`, :manpage:`kea-ctrl-agent(8)`, :manpage:`keactrl(8)`,
+:manpage:`perfdhcp(8)`, :manpage:`kea-netconf(8)`, Kea Administrator Reference Manual.
diff --git a/doc/sphinx/man/kea-ctrl-agent.8.rst b/doc/sphinx/man/kea-ctrl-agent.8.rst
index 49745761ad..54528abe65 100644
--- a/doc/sphinx/man/kea-ctrl-agent.8.rst
+++ b/doc/sphinx/man/kea-ctrl-agent.8.rst
@@ -1,23 +1,27 @@
-:orphan:
-
-kea-ctrl-agent
-8
-Kea
-kea-ctrl-agent
-Control Agent process in Kea
-2016-2018
-Internet Systems Consortium, Inc. ("ISC")
-kea-ctrl-agent
--v
--V
--W
--d
--c
-config-file
--t
-config-file
-DESCRIPTION
-===========
+..
+   Copyright (C) Internet Systems Consortium, Inc. ("ISC")
+
+   This Source Code Form is subject to the terms of the Mozilla Public
+   License, v. 2.0. If a copy of the MPL was not distributed with this
+   file, You can obtain one at http://mozilla.org/MPL/2.0/.
+
+   See the COPYRIGHT file distributed with this work for additional
+   information regarding copyright ownership.
+
+.. highlight: console
+
+.. kea-ctrl-agent:
+
+kea-ctrl-agent - Control Agent process in Kea
+---------------------------------------------
+
+Synopsis
+~~~~~~~~
+
+:program:`kea-ctrl-agent` [**-v**] [**-V**] [**-W**] [**-d**] [**-c** config-file] [**-t** config-file]
+
+Description
+~~~~~~~~~~~
 
 The ``kea-ctrl-agent`` provides a REST service for controlling Kea
 services. The received HTTP requests are decapsulated and forwarded to
@@ -26,74 +30,74 @@ encapsulated within HTTP responses and returned to the controlling
 entity. Some commands may be handled by the Control Agent directly, and
 not forwarded to any Kea service.
 
-ARGUMENTS
-=========
+Arguments
+~~~~~~~~~
 
 The arguments are as follows:
 
 ``-v``
-   Display the version.
+   Displays the version.
 
 ``-V``
-   Display the extended version.
+   Displays the extended version.
 
 ``-W``
-   Display the configuration report.
+   Displays the configuration report.
 
 ``-d``
-   Verbose mode sets the logging level to debug. This is primarily for
+   Sets the logging level to debug with extra verbosity. This is primarily for
    development purposes in stand-alone mode.
 
-``-c``
-   Configuration file including the configuration for the Control Agent
+``-c config-file``
+   Specifies the file with the configuration for the Control Agent
    server. It may also contain configuration entries for other Kea
    services.
 
-``-t``
-   Check the syntax of the configuration file and report the first error
-   if any. Note that not all parameters are completely checked, in
+``-t config-file``
+   Checks the syntax of the configuration file and reports the first error,
+   if any. Note that not all parameters are completely checked; in
    particular, service and client sockets are not opened, and hook
    libraries are not loaded.
 
-DOCUMENTATION
-=============
+Documentation
+~~~~~~~~~~~~~
 
-Kea comes with an extensive Kea User's Guide documentation that covers
+Kea comes with an extensive Kea Administrator Reference Manual that covers
 all aspects of running the Kea software - compilation, installation,
-configuration, configuration examples and many more. Kea also features a
+configuration, configuration examples, and much more. Kea also features a
 Kea Messages Manual, which lists all possible messages Kea can print
-with a brief description for each of them. Both documents are typically
-available in various formats (txt, html, pdf) with your Kea
+with a brief description for each of them. Both documents are
+available in various formats (.txt, .html, .pdf) with the Kea
 distribution. The Kea documentation is available at
 https://kb.isc.org/docs/kea-administrator-reference-manual .
 
-Kea source code is documented in the Kea Developer's Guide. Its on-line
+Kea source code is documented in the Kea Developer's Guide. Its online
 version is available at https://jenkins.isc.org/job/Kea_doc/doxygen/.
 
-Kea project website is available at:
-https://gitlab.isc.org/isc-projects/kea.
+The Kea project website is available at https://kea.isc.org.
 
-MAILING LISTS AND SUPPORT
-=========================
+Mailing Lists and Support
+~~~~~~~~~~~~~~~~~~~~~~~~~
 
-There are two mailing lists available for Kea project. kea-users
-(kea-users at lists.isc.org) is intended for Kea users, while kea-dev
+There are two public mailing lists available for the Kea project. **kea-users**
+(kea-users at lists.isc.org) is intended for Kea users, while **kea-dev**
 (kea-dev at lists.isc.org) is intended for Kea developers, prospective
-contributors and other advanced users. Both lists are available at
-http://lists.isc.org. The community provides best effort type of support
+contributors, and other advanced users. Both lists are available at
+https://lists.isc.org. The community provides best-effort support
 on both of those lists.
 
 ISC provides professional support for Kea services. See
 https://www.isc.org/kea/ for details.
 
-HISTORY
-=======
+History
+~~~~~~~
 
 The ``kea-ctrl-agent`` was first coded in December 2016 by Marcin
 Siodelski.
 
-SEE ALSO
-========
+See Also
+~~~~~~~~
 
-kea-dhcp4 8, kea-dhcp6 8, kea-dhcp-ddns 8, kea-admin 8, keactrl 8,
-perfdhcp 8, kea-lfc 8, Kea Administrator's Guide.
+:manpage:`kea-dhcp4(8)`, :manpage:`kea-dhcp6(8)`,
+:manpage:`kea-dhcp-ddns(8)`, :manpage:`kea-admin(8)`, :manpage:`keactrl(8)`,
+:manpage:`perfdhcp(8)`, :manpage:`kea-lfc(8)`, Kea Administrator Reference Manual.
diff --git a/doc/sphinx/man/kea-dhcp-ddns.8.rst b/doc/sphinx/man/kea-dhcp-ddns.8.rst
index 7daf8d99ff..1328f57541 100644
--- a/doc/sphinx/man/kea-dhcp-ddns.8.rst
+++ b/doc/sphinx/man/kea-dhcp-ddns.8.rst
@@ -1,97 +1,103 @@
-:orphan:
-
-kea-dhcp-ddns
-8
-Kea
-kea-dhcp-ddns
-DHCP-DDNS process in Kea
-2013-2018
-Internet Systems Consortium, Inc. ("ISC")
-kea-dhcp-ddns
--v
--V
--W
--d
--c
-config-file
--t
-config-file
-DESCRIPTION
+..
+   Copyright (C) Internet Systems Consortium, Inc. ("ISC")
+
+   This Source Code Form is subject to the terms of the Mozilla Public
+   License, v. 2.0. If a copy of the MPL was not distributed with this
+   file, You can obtain one at http://mozilla.org/MPL/2.0/.
+
+   See the COPYRIGHT file distributed with this work for additional
+   information regarding copyright ownership.
+
+.. highlight: console
+
+.. kea-dhcp-ddns:
+
+kea-dhcp-ddns - DHCP-DDNS process in Kea
+----------------------------------------
+
+Synopsis
+~~~~~~~~
+
+:program:`kea-dhcp-ddns` [**-v**] [**-V**] [**-W**] [**-d**] [**-c** config-file] [**-t** config-file]
+
+Description
 ===========
 
-The ``kea-dhcp-ddns`` service process requests to update DNS mapping
+The ``kea-dhcp-ddns`` service process requests an update of DNS mapping
 based on DHCP lease change events. It runs as a separate process that
 expects to receive Name Change Requests from Kea DHCP servers.
 
-ARGUMENTS
-=========
+Arguments
+~~~~~~~~~
 
 The arguments are as follows:
 
 ``-v``
-   Display the version.
+   Displays the version.
 
 ``-V``
-   Display the extended version.
+   Displays the extended version.
 
 ``-W``
-   Display the configuration report.
+   Displays the configuration report.
 
 ``-d``
-   Verbose mode sets the logging level to debug. This is primarily for
+   Sets the logging level to debug with extra verbosity. This is primarily for
    development purposes in stand-alone mode.
 
-``-c``
-   Configuration file including the configuration for DHCP-DDNS server.
-   It may also contain configuration entries for other Kea services.
+``-c config-file``
+   Specifies the configuration file with the configuration for the DHCP-DDNS server. It
+   may also contain configuration entries for other Kea services.
 
-``-t``
-   Check the syntax of the configuration file and report the first error
+``-t config-file``
+   Checks the syntax of the configuration file and reports the first error
    if any. Note that not all parameters are completely checked, in
    particular, service socket is not opened.
 
-DOCUMENTATION
-=============
+Documentation
+~~~~~~~~~~~~~
 
-Kea comes with an extensive Kea User's Guide documentation that covers
+Kea comes with an extensive Kea Administrator Reference Manual that covers
 all aspects of running the Kea software - compilation, installation,
-configuration, configuration examples and many more. Kea also features a
+configuration, configuration examples, and much more. Kea also features a
 Kea Messages Manual, which lists all possible messages Kea can print
-with a brief description for each of them. Both documents are typically
-available in various formats (txt, html, pdf) with your Kea
+with a brief description for each of them. Both documents are
+available in various formats (.txt, .html, .pdf) with the Kea
 distribution. The Kea documentation is available at
 https://kb.isc.org/docs/kea-administrator-reference-manual .
 
-Kea source code is documented in the Kea Developer's Guide. Its on-line
+Kea source code is documented in the Kea Developer's Guide. Its online
 version is available at https://jenkins.isc.org/job/Kea_doc/doxygen/.
 
-Kea project website is available at: https://kea.isc.org.
+The Kea project website is available at https://kea.isc.org.
 
-MAILING LISTS AND SUPPORT
-=========================
+Mailing Lists and Support
+~~~~~~~~~~~~~~~~~~~~~~~~~
 
-There are two mailing lists available for Kea project. kea-users
-(kea-users at lists.isc.org) is intended for Kea users, while kea-dev
+There are two public mailing lists available for the Kea project. **kea-users**
+(kea-users at lists.isc.org) is intended for Kea users, while **kea-dev**
 (kea-dev at lists.isc.org) is intended for Kea developers, prospective
-contributors and other advanced users. Both lists are available at
-http://lists.isc.org. The community provides best effort type of support
+contributors, and other advanced users. Both lists are available at
+https://lists.isc.org. The community provides best-effort support
 on both of those lists.
 
 ISC provides professional support for Kea services. See
 https://www.isc.org/kea/ for details.
 
-HISTORY
-=======
+History
+~~~~~~~
 
 The ``b10-dhcp-ddns`` process was first coded in May 2013 by Thomas
 Markwalder.
 
-Kea became a standalone server and the BIND10 framework was removed. The
+Kea became a standalone server and the BIND 10 framework was removed. The
 DHCP-DDNS server binary was renamed to kea-dhcp-ddns in July 2014. Kea
 1.0.0 was released in December 2015.
 
-SEE ALSO
-========
+See Also
+~~~~~~~~
 
-kea-dhcp4 8, kea-dhcp6 8, kea-ctrl-agent 8, kea-admin 8, keactrl 8,
-kea-netconf 8, perfdhcp 8, kea-lfc 8, Kea Administrator's Guide.
+:manpage:`kea-dhcp4(8)`, :manpage:`kea-dhcp6(8)`,
+:manpage:`kea-ctrl-agent(8)`, :manpage:`kea-admin(8)`, :manpage:`keactrl(8)`,
+:manpage:`perfdhcp(8)`, :manpage:`kea-netconf(8)`, :manpage:`kea-lfc(8)`,
+Kea Administrator Reference Manual.
diff --git a/doc/sphinx/man/kea-dhcp4.8.rst b/doc/sphinx/man/kea-dhcp4.8.rst
index 4e6ceebb27..d24fc0ac17 100644
--- a/doc/sphinx/man/kea-dhcp4.8.rst
+++ b/doc/sphinx/man/kea-dhcp4.8.rst
@@ -1,107 +1,109 @@
-:orphan:
-
-kea-dhcp4
-8
-Kea
-kea-dhcp4
-DHCPv4 server in Kea
-2011-2018
-Internet Systems Consortium, Inc. ("ISC")
-kea-dhcp4
--v
--V
--W
--d
--c
-config-file
--t
-config-file
--p
-server-port-number
--P
-client-port-number
-DESCRIPTION
-===========
+..
+   Copyright (C) Internet Systems Consortium, Inc. ("ISC")
+
+   This Source Code Form is subject to the terms of the Mozilla Public
+   License, v. 2.0. If a copy of the MPL was not distributed with this
+   file, You can obtain one at http://mozilla.org/MPL/2.0/.
+
+   See the COPYRIGHT file distributed with this work for additional
+   information regarding copyright ownership.
+
+.. highlight: console
+
+.. kea-dhcp4:
+
+kea-dhcp4 - DHCPv4 server in Kea
+--------------------------------
+
+Synopsis
+~~~~~~~~
+
+:program:`kea-dhcp4` [**-v**] [**-V**] [**-W**] [**-d**] [**-c** config-file] [**-t** config-file] [**-p** server-port-number] [**-P** client-port-number]
+
+Description
+~~~~~~~~~~~
 
 The ``kea-dhcp4`` daemon provides the DHCPv4 server implementation.
 
-ARGUMENTS
-=========
+Arguments
+~~~~~~~~~
 
 The arguments are as follows:
 
 ``-v``
-   Display the version.
+   Displays the version.
 
 ``-V``
-   Display the extended version.
+   Displays the extended version.
 
 ``-W``
-   Display the configuration report.
+   Displays the configuration report.
 
 ``-d``
-   Enable the debug mode with extra verbosity.
+   Enables the debug mode with extra verbosity.
 
-``-c``
-   Configuration file including the configuration for DHCPv4 server. It
+``-c config-file``
+   Specifies the configuration file with the configuration for the DHCPv4 server. It
    may also contain configuration entries for other Kea services.
 
-``-t``
-   Check the configuration file and report the first error if any. Note
-   that not all parameters are completely checked, in particular,
+``-t config-file``
+   Checks the configuration file and reports the first error, if any. Note
+   that not all parameters are completely checked; in particular,
    service and control channel sockets are not opened, and hook
    libraries are not loaded.
 
-``-p``
-   Server port number (1-65535) on which the server listens. This is
+``-p server-port-number``
+   Specifies the server port number (1-65535) on which the server listens. This is
    useful for testing purposes only.
 
-``-P``
-   Client port number (1-65535) to which the server responds. This is
+``-P client-port-number``
+   Specifies the client port number (1-65535) to which the server responds. This is
    useful for testing purposes only.
 
-DOCUMENTATION
-=============
+Documentation
+~~~~~~~~~~~~~
 
-Kea comes with an extensive Kea User's Guide documentation that covers
+Kea comes with an extensive Kea Administrator Reference Manual that covers
 all aspects of running the Kea software - compilation, installation,
-configuration, configuration examples and many more. Kea also features a
+configuration, configuration examples, and much more. Kea also features a
 Kea Messages Manual, which lists all possible messages Kea can print
-with a brief description for each of them. Both documents are typically
-available in various formats (txt, html, pdf) with your Kea
+with a brief description for each of them. Both documents are
+available in various formats (.txt, .html, .pdf) with the Kea
 distribution. The Kea documentation is available at
 https://kb.isc.org/docs/kea-administrator-reference-manual .
 
-Kea source code is documented in the Kea Developer's Guide. Its on-line
+Kea source code is documented in the Kea Developer's Guide. Its online
 version is available at https://jenkins.isc.org/job/Kea_doc/doxygen/.
 
-Kea project website is available at: https://kea.isc.org.
+The Kea project website is available at https://kea.isc.org.
 
-MAILING LISTS AND SUPPORT
-=========================
+Mailing Lists and Support
+~~~~~~~~~~~~~~~~~~~~~~~~~
 
-There are two mailing lists available for Kea project. kea-users
-(kea-users at lists.isc.org) is intended for Kea users, while kea-dev
+There are two public mailing lists available for the Kea project. **kea-users**
+(kea-users at lists.isc.org) is intended for Kea users, while **kea-dev**
 (kea-dev at lists.isc.org) is intended for Kea developers, prospective
-contributors and other advanced users. Both lists are available at
-http://lists.isc.org. The community provides best effort type of support
+contributors, and other advanced users. Both lists are available at
+https://lists.isc.org. The community provides best-effort support
 on both of those lists.
 
 ISC provides professional support for Kea services. See
 https://www.isc.org/kea/ for details.
 
-HISTORY
-=======
+History
+~~~~~~~
 
 The ``b10-dhcp4`` daemon was first coded in November 2011 by Tomek
 Mrugalski.
 
-In the mid 2014 Kea was decoupled from the BIND10 framework and became a
+In mid-2014, Kea was decoupled from the BIND 10 framework and became a
 standalone DHCP server. The DHCPv4 server binary was renamed to
 kea-dhcp4. Kea 1.0.0 was released in December 2015.
 
-SEE ALSO
-========
+See Also
+~~~~~~~~
 
-kea-dhcp6 8, kea-dhcp-ddns 8, kea-ctrl-agent 8, kea-admin 8, keactrl 8,
-kea-netconf 8, perfdhcp 8, kea-lfc 8, Kea Administrator's Guide.
+:manpage:`kea-dhcp6(8)`, :manpage:`kea-dhcp-ddns(8)`,
+:manpage:`kea-ctrl-agent(8)`, :manpage:`kea-admin(8)`, :manpage:`keactrl(8)`,
+:manpage:`perfdhcp(8)`, :manpage:`kea-netconf(8)`, :manpage:`kea-lfc(8)`,
+Kea Administrator Reference Manual.
diff --git a/doc/sphinx/man/kea-dhcp6.8.rst b/doc/sphinx/man/kea-dhcp6.8.rst
index 88e2022785..ade0e14492 100644
--- a/doc/sphinx/man/kea-dhcp6.8.rst
+++ b/doc/sphinx/man/kea-dhcp6.8.rst
@@ -1,100 +1,104 @@
-:orphan:
-
-kea-dhcp6
-8
-Kea
-kea-dhcp6
-DHCPv6 server in Kea
-2011-2018
-Internet Systems Consortium, Inc. ("ISC")
-kea-dhcp6
--v
--V
--W
--d
--c
-config-file
--t
-config-file
--p
-server-port-number
-DESCRIPTION
-===========
+..
+   Copyright (C) Internet Systems Consortium, Inc. ("ISC")
+
+   This Source Code Form is subject to the terms of the Mozilla Public
+   License, v. 2.0. If a copy of the MPL was not distributed with this
+   file, You can obtain one at http://mozilla.org/MPL/2.0/.
+
+   See the COPYRIGHT file distributed with this work for additional
+   information regarding copyright ownership.
+
+.. highlight: console
+
+.. kea-dhcp6:
+
+kea-dhcp6 - DHCPv6 server in Kea
+--------------------------------
+
+Synopsis
+~~~~~~~~
+
+:program:`kea-dhcp6` [**-v**] [**-V**] [**-W**] [**-d**] [**-c** config-file] [**-t** config-file] [**-p** server-port-number]
+
+Description
+~~~~~~~~~~~
 
 The ``kea-dhcp6`` daemon provides the DHCPv6 server implementation.
 
-ARGUMENTS
-=========
+Arguments
+~~~~~~~~~
 
 The arguments are as follows:
 
 ``-v``
-   Display the version.
+   Displays the version.
 
 ``-V``
-   Display the extended version.
+   Displays the extended version.
 
 ``-W``
-   Display the configuration report.
+   Displays the configuration report.
 
 ``-d``
-   Enable the debug mode with extra verbosity.
+   Enables the debug mode with extra verbosity.
 
-``-c``
-   Configuration file including the configuration for DHCPv6 server. It
+``-c config-file``
+   Specifies the configuration file with the configuration for the DHCPv6 server. It
    may also contain configuration entries for other Kea services.
 
-``-t``
-   Check the configuration file and report the first error if any. Note
-   that not all parameters are completely checked, in particular,
+``-t config-file``
+   Checks the configuration file and reports the first error, if any. Note
+   that not all parameters are completely checked; in particular,
    service and control channel sockets are not opened, and hook
    libraries are not loaded.
 
-``-p``
-   Server port number (1-65535) on which the server listens. This is
+``-p server-port-number``
+   Specifies the server port number (1-65535) on which the server listens. This is
    useful for testing purposes only.
 
-DOCUMENTATION
-=============
+Documentation
+~~~~~~~~~~~~~
 
-Kea comes with an extensive Kea User's Guide documentation that covers
+Kea comes with an extensive Kea Administrator Reference Manual that covers
 all aspects of running the Kea software - compilation, installation,
-configuration, configuration examples and many more. Kea also features a
+configuration, configuration examples, and much more. Kea also features a
 Kea Messages Manual, which lists all possible messages Kea can print
-with a brief description for each of them. Both documents are typically
-available in various formats (txt, html, pdf) with your Kea
-distribution. Kea user documentation is availalable on-line at
+with a brief description for each of them. Both documents are
+available in various formats (.txt, .html, .pdf) with the Kea
+distribution. The Kea documentation is available at
 https://kb.isc.org/docs/kea-administrator-reference-manual .
 
-Kea source code is documented in the Kea Developer's Guide. Its on-line
+Kea source code is documented in the Kea Developer's Guide. Its online
 version is available at https://jenkins.isc.org/job/Kea_doc/doxygen/.
 
-Kea project website is available at: https://kea.isc.org.
+The Kea project website is available at https://kea.isc.org.
 
-MAILING LISTS AND SUPPORT
-=========================
+Mailing Lists and Support
+~~~~~~~~~~~~~~~~~~~~~~~~~
 
-There are two mailing lists available for Kea project. kea-users
-(kea-users at lists.isc.org) is intended for Kea users, while kea-dev
+There are two public mailing lists available for the Kea project. **kea-users**
+(kea-users at lists.isc.org) is intended for Kea users, while **kea-dev**
 (kea-dev at lists.isc.org) is intended for Kea developers, prospective
-contributors and other advanced users. Both lists are available at
-http://lists.isc.org. The community provides best effort type of support
+contributors, and other advanced users. Both lists are available at
+https://lists.isc.org. The community provides best-effort support
 on both of those lists.
 
 ISC provides professional support for Kea services. See
 https://www.isc.org/kea/ for details.
 
-HISTORY
-=======
+History
+~~~~~~~
 
 The ``b10-dhcp6`` daemon was first coded in June 2011 by Tomek
 Mrugalski.
 
-Kea became a standalone server and the BIND10 framework was removed. The
+Kea became a standalone server and the BIND 10 framework was removed. The
 DHCPv6 server binary was renamed to kea-dhcp6 in July 2014.
 
-SEE ALSO
-========
+See Also
+~~~~~~~~
 
-kea-dhcp4 8, kea-dhcp-ddns 8, kea-ctrl-agent 8, kea-admin 8, keactrl 8,
-kea-netconf 8, perfdhcp 8, kea-lfc 8, Kea Administrator's Guide.
+:manpage:`kea-dhcp4(8)`, :manpage:`kea-dhcp-ddns(8)`,
+:manpage:`kea-ctrl-agent(8)`, :manpage:`kea-admin(8)`, :manpage:`keactrl(8)`,
+:manpage:`perfdhcp(8)`, :manpage:`kea-netconf(8)`, :manpage:`kea-lfc(8)`,
+Kea Administrator Reference Manual.
diff --git a/doc/sphinx/man/kea-lfc.8.rst b/doc/sphinx/man/kea-lfc.8.rst
index 2c09f4b9de..d6bf96b524 100644
--- a/doc/sphinx/man/kea-lfc.8.rst
+++ b/doc/sphinx/man/kea-lfc.8.rst
@@ -1,140 +1,135 @@
-:orphan:
-
-kea-lfc
-8
-Kea
-kea-lfc
-Lease File Cleanup process in Kea
-2015-2018
-Internet Systems Consortium, Inc. ("ISC")
-kea-lfc
--4|-6
--c
-config-file
--p
-pid-file
--x
-previous-file
--i
-copy-file
--o
-output-file
--f
-finish-file
--v
--V
--W
--d
--h
-DESCRIPTION
-===========
+..
+   Copyright (C) Internet Systems Consortium, Inc. ("ISC")
 
-The ``kea-lfc`` service process removes redundant information from the
-files used to provide persistent storage for the memfile data base
-backend. The service is written to run as a stand alone process. While
-it can be started externally, there is usually no need to do this. It
-will be run on a periodic basis by the Kea DHCP servers.
+   This Source Code Form is subject to the terms of the Mozilla Public
+   License, v. 2.0. If a copy of the MPL was not distributed with this
+   file, You can obtain one at http://mozilla.org/MPL/2.0/.
 
-ARGUMENTS
-=========
+   See the COPYRIGHT file distributed with this work for additional
+   information regarding copyright ownership.
 
-The arguments are as follows:
+.. highlight: console
 
-``-d``
-   Verbose mode sets the logging level to debug. This is primarily for
-   development purposes in stand-alone mode.
+.. kea-lfc:
 
-``-v``
-   version causes the version stamp to be printed.
+kea-lfc - Lease File Cleanup process in Kea
+-------------------------------------------
 
-``-V``
-   Version causes a longer form of the version stamp to be printed.
+Synopsis
+~~~~~~~~
 
-``-W``
-   Display the configuration report.
+:program:`kea-lfc` [**-4**|**-6**] [**-c** config-file] [**-p** pid-file] [**-x** previous-file] [**-i** copy-file] [**-o** output-file] [**-f** finish-file] [**-v**] [**-V**] [**-W**] [**-d**] [**-h**]
 
-``-h``
-   Help causes the usage string to be printed.
+Description
+~~~~~~~~~~~
+
+The ``kea-lfc`` service process removes redundant information from the
+files used to provide persistent storage for the memfile database
+backend. The service is written to run as a stand-alone process. While
+it can be started externally, there is usually no need to do this. It
+is run periodically by the Kea DHCP servers.
+
+Arguments
+~~~~~~~~~
+
+The arguments are as follows:
 
 ``-4 | -6``
-   The protocol version of the lease files, must be one of 4 or 6.
+   Indicates the protocol version of the lease files; must be either 4 or 6.
 
-``-c``
-   Configuration file including the configuration for ``kea-lfc``
+``-c config-file``
+   Specifies the file with the configuration for the ``kea-lfc``
    process. It may also contain configuration entries for other Kea
    services. Currently ``kea-lfc`` gets all of its arguments from the
-   command line, in the future it will be extended to get some arguments
-   from the config file.
+   command line; in the future it will be extended to obtain some arguments
+   from the configuration file.
 
-``-p``
-   PID file - When the ``kea-lfc`` process starts it attempts to
+``-p pid-file``
+   Specifies the PID file. When the ``kea-lfc`` process starts, it attempts to
    determine if another instance of the process is already running by
-   examining the pid file. If one is already running the new process is
-   terminated. If one isn't running it writes its pid into the pid file.
+   examining the PID file. If one is already running, the new process is
+   terminated. If one is not running, Kea writes its PID into the PID file.
 
-``-x``
-   Previous or ex lease file - When ``kea-lfc`` starts this is the
-   result of any previous run of ``kea-lfc``. When ``kea-lfc`` finishes
+``-x previous-file``
+   Specifies the previous or ex-lease file. When ``kea-lfc`` starts, this is the
+   result of any previous run of ``kea-lfc``; when ``kea-lfc`` finishes,
    it is the result of this run. If ``kea-lfc`` is interrupted before
    completing, this file may not exist.
 
-``-i``
-   Input or copy of lease file - Before the DHCP server invokes
-   ``kea-lfc`` it will move the current lease file here and then call
+``-i copy-file``
+   Specifies the input or copy of lease file. Before the DHCP server invokes
+   ``kea-lfc``, it will move the current lease file here and then call
    ``kea-lfc`` with this file.
 
-``-o``
-   Output lease file - The temporary file ``kea-lfc`` should use to
-   write the leases. Upon completion of writing this this file it will
-   be moved to the finish file (see below).
+``-o output-file``
+   Specifies the output lease file, which is the temporary file ``kea-lfc`` should use to
+   write the leases. Once this file is finished writing, it is
+   moved to the finish file (see below).
 
-``-f``
-   Finish or completion file - Another temporary file ``kea-lfc`` uses
-   for bookkeeping. When ``kea-lfc`` completes writing the output file
+``-f finish-file``
+   Specifies the finish or completion file, another temporary file ``kea-lfc`` uses
+   for bookkeeping. When ``kea-lfc`` finishes writing the output file,
    it moves it to this file name. After ``kea-lfc`` finishes deleting
-   the other files (previous and input) it moves this file to previous
-   lease file. By moving the files in this fashion the ``kea-lfc`` and
+   the other files (previous and input), it moves this file to the previous
+   lease file. By moving the files in this fashion, the ``kea-lfc`` and
    the DHCP server processes can determine the correct file to use even
    if one of the processes was interrupted before completing its task.
 
-DOCUMENTATION
-=============
+``-v``
+   Causes the version stamp to be printed.
+
+``-V``
+   Causes a longer form of the version stamp to be printed.
+
+``-W``
+   Displays the configuration report.
+
+``-d``
+   Sets the logging level to debug with extra verbosity. This is primarily for
+   development purposes in stand-alone mode.
+
+``-h``
+   Causes the usage string to be printed.
+
+Documentation
+~~~~~~~~~~~~~
 
-Kea comes with an extensive Kea User's Guide documentation that covers
+Kea comes with an extensive Kea Administrator Reference Manual that covers
 all aspects of running the Kea software - compilation, installation,
-configuration, configuration examples and many more. Kea also features a
+configuration, configuration examples, and much more. Kea also features a
 Kea Messages Manual, which lists all possible messages Kea can print
-with a brief description for each of them. Both documents are typically
-available in various formats (txt, html, pdf) with your Kea
+with a brief description for each of them. Both documents are
+available in various formats (.txt, .html, .pdf) with the Kea
 distribution. The Kea documentation is available at
 https://kb.isc.org/docs/kea-administrator-reference-manual .
 
-Kea source code is documented in the Kea Developer's Guide. Its on-line
+Kea source code is documented in the Kea Developer's Guide. Its online
 version is available at https://jenkins.isc.org/job/Kea_doc/doxygen/.
 
-Kea project website is available at: https://kea.isc.org.
+The Kea project website is available at https://kea.isc.org.
 
-MAILING LISTS AND SUPPORT
-=========================
+Mailing Lists and Support
+~~~~~~~~~~~~~~~~~~~~~~~~~
 
-There are two mailing lists available for Kea project. kea-users
-(kea-users at lists.isc.org) is intended for Kea users, while kea-dev
+There are two public mailing lists available for the Kea project. **kea-users**
+(kea-users at lists.isc.org) is intended for Kea users, while **kea-dev**
 (kea-dev at lists.isc.org) is intended for Kea developers, prospective
-contributors and other advanced users. Both lists are available at
-http://lists.isc.org. The community provides best effort type of support
+contributors, and other advanced users. Both lists are available at
+https://lists.isc.org. The community provides best-effort support
 on both of those lists.
 
 ISC provides professional support for Kea services. See
 https://www.isc.org/kea/ for details.
 
-HISTORY
-=======
+History
+~~~~~~~
 
 The ``kea-lfc`` process was first coded in January 2015 by the ISC
 Kea/DHCP team.
 
-SEE ALSO
-========
+See Also
+~~~~~~~~
 
-kea-dhcp4 8, kea-dhcp6 8, kea-dhcp-ddns 8, kea-ctrl-agent 8, kea-admin
-8, kea-netconf 8, keactrl 8, perfdhcp 8, Kea Administrator's Guide.
+:manpage:`kea-dhcp4(8)`, :manpage:`kea-dhcp6(8)`, :manpage:`kea-dhcp-ddns(8)`,
+:manpage:`kea-ctrl-agent(8)`, :manpage:`kea-admin(8)`, :manpage:`keactrl(8)`,
+:manpage:`perfdhcp(8)`, :manpage:`kea-netconf(8)`, Kea Administrator Reference Manual.
diff --git a/doc/sphinx/man/kea-netconf.8.rst b/doc/sphinx/man/kea-netconf.8.rst
index 928f7cb7e5..671f8756f8 100644
--- a/doc/sphinx/man/kea-netconf.8.rst
+++ b/doc/sphinx/man/kea-netconf.8.rst
@@ -1,94 +1,98 @@
-:orphan:
-
-kea-netconf
-8
-Kea
-kea-netconf
-NETCONF agent for Kea environment
-2018
-Internet Systems Consortium, Inc. ("ISC")
-kea-netconf
--v
--V
--W
--d
--c
-config-file
--t
-config-file
-DESCRIPTION
-===========
+..
+   Copyright (C) Internet Systems Consortium, Inc. ("ISC")
+
+   This Source Code Form is subject to the terms of the Mozilla Public
+   License, v. 2.0. If a copy of the MPL was not distributed with this
+   file, You can obtain one at http://mozilla.org/MPL/2.0/.
+
+   See the COPYRIGHT file distributed with this work for additional
+   information regarding copyright ownership.
+
+.. highlight: console
+
+.. kea-netconf:
+
+kea-netconf - NETCONF agent for Kea environment
+-----------------------------------------------
+
+Synopsis
+~~~~~~~~
+
+:program:`kea-netconf` [**-v**] [**-V**] [**-W**] [**-d**] [**-c** config-file] [**-t** config-file]
+
+Description
+~~~~~~~~~~~
 
 The ``kea-netconf`` agent provides a YANG/NETCONF interface for the Kea
 environment.
 
-ARGUMENTS
-=========
+Arguments
+~~~~~~~~~
 
 The arguments are as follows:
 
 ``-v``
-   Display the version.
+   Displays the version.
 
 ``-V``
-   Display the extended version.
+   Displays the extended version.
 
 ``-W``
-   Display the configuration report.
+   Displays the configuration report.
 
 ``-d``
-   Enable the debug mode with extra verbosity.
+   Enables the debug mode with extra verbosity.
 
-``-c``
-   Configuration file including the configuration for NETCONF agent.
+``-c config-file``
+   Specifies the file with the configuration for the NETCONF agent.
 
-``-t``
-   Check the syntax of the configuration file and report the first error
-   if any. Note that not all parameters are completely checked, in
+``-t config-file``
+   Checks the syntax of the configuration file and reports the first error,
+   if any. Note that not all parameters are completely checked; in
    particular, service and client sockets are not opened, and hook
    libraries are not loaded.
 
-DOCUMENTATION
-=============
+Documentation
+~~~~~~~~~~~~~
 
-Kea comes with an extensive Kea User's Guide documentation that covers
+Kea comes with an extensive Kea Administrator Reference Manual that covers
 all aspects of running the Kea software - compilation, installation,
-configuration, configuration examples and many more. Kea also features a
+configuration, configuration examples, and much more. Kea also features a
 Kea Messages Manual, which lists all possible messages Kea can print
-with a brief description for each of them. Both documents are typically
-available in various formats (txt, html, pdf) with your Kea
+with a brief description for each of them. Both documents are
+available in various formats (.txt, .html, .pdf) with the Kea
 distribution. The Kea documentation is available at
 https://kb.isc.org/docs/kea-administrator-reference-manual .
 
-Kea source code is documented in the Kea Developer's Guide. Its on-line
+Kea source code is documented in the Kea Developer's Guide. Its online
 version is available at https://jenkins.isc.org/job/Kea_doc/doxygen/.
 
-Kea project website is available at:
-https://gitlab.isc.org/isc-projects/kea.
+The Kea project website is available at https://kea.isc.org.
 
-MAILING LISTS AND SUPPORT
-=========================
+Mailing Lists and Support
+~~~~~~~~~~~~~~~~~~~~~~~~~
 
-There are two mailing lists available for Kea project. kea-users
-(kea-users at lists.isc.org) is intended for Kea users, while kea-dev
+There are two public mailing lists available for the Kea project. **kea-users**
+(kea-users at lists.isc.org) is intended for Kea users, while **kea-dev**
 (kea-dev at lists.isc.org) is intended for Kea developers, prospective
-contributors and other advanced users. Both lists are available at
-http://lists.isc.org. The community provides best effort type of support
+contributors, and other advanced users. Both lists are available at
+https://lists.isc.org. The community provides best-effort support
 on both of those lists.
 
 ISC provides professional support for Kea services. See
 https://www.isc.org/kea/ for details.
 
-HISTORY
-=======
+History
+~~~~~~~
 
-Early prototypes of kea-netconf implementation were written during IETF
-Hackathons in Berlin, London and Montreal. An actual production ready
+Early prototypes of ``kea-netconf`` implementation were written during IETF
+Hackathons in Berlin, London, and Montreal. An actual production-ready
 implementation was started in August 2018 by Tomek Mrugalski and Francis
 Dupont.
 
-SEE ALSO
-========
+See Also
+~~~~~~~~
 
-kea-dhcp4 8, kea-dhcp6 8, kea-dhcp-ddns 8, kea-ctrl-agent 8, kea-admin
-8, keactrl 8, perfdhcp 8, kea-lfc 8, Kea Administrator's Guide.
+:manpage:`kea-dhcp4(8)`, :manpage:`kea-dhcp6(8)`, :manpage:`kea-dhcp-ddns(8)`,
+:manpage:`kea-ctrl-agent(8)`, :manpage:`kea-admin(8)`, :manpage:`keactrl(8)`,
+:manpage:`perfdhcp(8)`, :manpage:`kea-lfc(8)`, Kea Administrator Reference Manual.
diff --git a/doc/sphinx/man/kea-shell.8.rst b/doc/sphinx/man/kea-shell.8.rst
index deb51a2fd0..be6f54a1d1 100644
--- a/doc/sphinx/man/kea-shell.8.rst
+++ b/doc/sphinx/man/kea-shell.8.rst
@@ -18,7 +18,7 @@ kea-shell - Text client for Control Agent process
 Synopsis
 ~~~~~~~~
 
-:program:`kea-shell` [**-h**] [**-v**] [**--host**] [**--port**] [**--path**] [**--timeout**] [**--service**] [**command**]
+:program:`kea-shell` [**-h**] [**-v**] [**--host**] [**--port**] [**--path**] [**--timeout**] [**--service**] [command]
 
 Description
 ~~~~~~~~~~~
diff --git a/doc/sphinx/man/keactrl.8.rst b/doc/sphinx/man/keactrl.8.rst
index 1c449f9729..f6205ffc39 100644
--- a/doc/sphinx/man/keactrl.8.rst
+++ b/doc/sphinx/man/keactrl.8.rst
@@ -1,5 +1,3 @@
-:orphan:
-
 ..
    Copyright (C) Internet Systems Consortium, Inc. ("ISC")
 
diff --git a/doc/sphinx/man/perfdhcp.8.rst b/doc/sphinx/man/perfdhcp.8.rst
index af37728543..047cf9c923 100644
--- a/doc/sphinx/man/perfdhcp.8.rst
+++ b/doc/sphinx/man/perfdhcp.8.rst
@@ -1,5 +1,3 @@
-:orphan:
-
 ..
    Copyright (C) Internet Systems Consortium, Inc. ("ISC")
 
@@ -20,7 +18,7 @@ perfdhcp - DHCP benchmarking tool
 Synopsis
 ~~~~~~~~
 
-:program:`perfdhcp` [**-1**] [**-4**|**-6**] [**-A** encapsulation-level] [**-b** base] [**-B**] [**-c**] [**-d** drop-time] [**-D** max-drop] [-e lease-type] [**-E** time-offset] [**-f** renew-rate] [**-F** release-rate] [**-g** thread-mode] [**-h**] [**-i**] [**-I** ip-offset] [**-l** local-address|interface] [**-L** local-port] [**-M** mac-list-file] [-n num-request] [-N remote-port] [-O random-offset] [-o code,hexstring] [-p test-period] [-P preload] [-r rate] [-R num-clients] [-s seed] [-S srvid-offset] [-t report] [-T template-file] [-v] [-W exit-wait-time] [-w wrapped] [-x diagnostic-selector] [-X xid-offset] [server]
+:program:`perfdhcp` [**-1**] [**-4**|**-6**] [**-A** encapsulation-level] [**-b** base] [**-B**] [**-c**] [**-d** drop-time] [**-D** max-drop] [-e lease-type] [**-E** time-offset] [**-f** renew-rate] [**-F** release-rate] [**-g** thread-mode] [**-h**] [**-i**] [**-I** ip-offset] [**-l** local-address|interface] [**-L** local-port] [**-M** mac-list-file] [-n num-request] [-N remote-port] [-O random-offset] [-o code,hexstring] [-p test-period] [-P preload] [-r rate] [-R num-clients] [-s seed] [-S srvid-offset] [-t report] [-T template-file] [-v] [-W exit-wait-time] [-w script_name] [-x diagnostic-selector] [-X xid-offset] [server]
 
 Description
 ~~~~~~~~~~~