doc: add manual page for knot1to2

doc/Makefile.am

@@ -13,6 +13,7 @@ EXTRA_DIST = \
 	utilities.rst		\
 	\
 	man_kdig.rst		\
+	man_knot1to2.rst	\
 	man_knotc.rst		\
 	man_knotd.rst		\
 	man_knsec3hash.rst	\

doc/conf.py

@@ -224,6 +224,7 @@ latex_domain_indices = False
 man_pages = [
     ('reference', 'knot.conf', 'Knot DNS configuration file', author, 5),
     ('man_kdig', 'kdig', 'Advanced DNS lookup utility', author, 1),
+    ('man_knot1to2', 'knot1to2', 'Knot DNS configuration conversion utility', author, 1),
     ('man_knotc', 'knotc', 'Knot DNS control utility', author, 8),
     ('man_knotd', 'knotd', 'Knot DNS server daemon', author, 8),
     ('man_knsec3hash', 'knsec3hash', "Simple utility to compute NSEC3 hash", author, 1),

doc/man_knot1to2.rst

+knot1to2 -- Knot DNS configuration conversion utility
+=====================================================
+
+Synopsis
+--------
+
+:program:`knot1to2` [*options*] -i *file* -o *file*
+
+Description
+-----------
+
+This utility generates Knot DNS configuration file version 2.x from configuration
+file version 1.x.
+
+Parameters
+..........
+
+**-i**, **--in** *file*
+  Input configuration file (Knot version 1.x).
+
+**-o**, **--out** *file*
+  Output configuration file (Knot version 2.x).
+
+Options
+.......
+
+**-r**, **--raw**
+  Raw output, do not reformat via :program:`knotc`.
+
+**-p**, **--path** *directory*
+  Path to :program:`knotc` utility.
+
+**-V**, **--version**
+  Print package version.
+
+**-h**, **--help**
+  Print help and usage.
+
+See Also
+--------
+
+:manpage:`knotc(8)`, :manpage:`knotd(8)`, :manpage:`knot.conf(5)`.

doc/utilities.rst

@@ -10,6 +10,7 @@ the server. This section collects manual pages for these utilities.
    :titlesonly:
 
    man_kdig
+   man_knot1to2
    man_knotc
    man_knotd
    man_knsec3hash