Add autosectionlabel_prefix_document

NLnetLabs · Dec 21, 2021 · f73822a · f73822a
1 parent b4ae21d
commit f73822a
Show file tree

Hide file tree

Showing 5 changed files with 15 additions and 9 deletions.
diff --git a/source/conf.py b/source/conf.py
@@ -44,6 +44,8 @@
     'sphinx.ext.autosectionlabel',
 ]
 
+autosectionlabel_prefix_document = True
+
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ['../templates']
 
@@ -165,7 +167,7 @@
     "Unbound developers are mentioned in the CREDITS file in the distribution.", 3)
 ]
 
-manpages_url = '/manpages/{page}.html'
+manpages_url = '{page}.html'
 
 # -- Options for Texinfo output ----------------------------------------------
 

diff --git a/source/developer/libunbound-tutorial/index.rst b/source/developer/libunbound-tutorial/index.rst
@@ -1,11 +1,11 @@
 Unbound Library Tutorial
 ========================
 
-This is the tutorial for the unbound library. Unbound can run as a server, as a
-daemon in the background, answering DNS queries from the network.
-Alternatively, it can link to an application as a library ``-lunbound``, and
-answer DNS queries for the application. This tutorial explains how to use the
-library API.
+This is the tutorial for the :doc:`unbound library</manpages/libunbound>`.
+Unbound can run as a server, as a daemon in the background, answering DNS
+queries from the network. Alternatively, it can link to an application as a
+library ``-lunbound``, and answer DNS queries for the application. This tutorial
+explains how to use the library API.
 
 .. toctree::
    :maxdepth: 2

diff --git a/source/getting-started/configuration.rst b/source/getting-started/configuration.rst
@@ -63,8 +63,8 @@ username is assumed. If this user  needs access to files (such as the 'trust
 anchor' mentioned below) these can be created by executing with ``sudo -u
 unbound`` in front of it.
 
-.. Important:: Unbound comes with the :manpage:`unbound-checkconf(8)` tool. This
-               tool allows you to check the config file for errors before
+.. Important:: Unbound comes with the :doc:`/manpages/unbound-checkconf` tool. 
+               This tool allows you to check the config file for errors before
                starting Unbound. It is very convenient because if any errors are
                found it tells you where they are, which is particularly useful
                when Unbound is already running to avoid failure to restart due

diff --git a/source/getting-started/installation.rst b/source/getting-started/installation.rst
@@ -214,7 +214,8 @@ of openssl is ``1.1.1k`` and of libexapt is ``2.3.0``).
 
 .. code-block:: bash
 
-    ./configure --with-ssl=/opt/homebrew/Cellar/openssl@1.1/1.1.1k/ --with-libexpat=/opt/homebrew/Cellar/expat/2.3.0
+    ./configure --with-ssl=/opt/homebrew/Cellar/openssl@1.1/1.1.1k/ \
+                --with-libexpat=/opt/homebrew/Cellar/expat/2.3.0
 
 When :command:`configure` gives no errors, we can continue to actually compiling
 Unbound. For this Unbound uses :command:`make`. Be warned that compiling might

diff --git a/source/topics/filtering/rpz.rst b/source/topics/filtering/rpz.rst
@@ -14,6 +14,9 @@ Response Policy Zones (RPZ) is a mechanism that makes it possible to define your
 local policies in a standardised way and load your policies from external
 sources.
 
+.. Seealso:: :ref:`manpages/unbound.conf:Response Policy Zone Options` in 
+             the :doc:`/manpages/unbound.conf` manpage.
+
 Introduction
 ------------