package-documentation: add section, embrace manpages

Author: Chocimier

book.toml

@@ -9,6 +9,7 @@ theme = "src/theme"
 
 [output.html.redirect]
 "/about-this-handbook.html" = "/about/about-this-handbook.html"
+"/config/man.html" = "/config/package-documentation/man.html"
 
 [output.latex]
 optional = true

src/SUMMARY.md

@@ -16,7 +16,8 @@
          - [Supported Platforms](./installation/guides/arm-devices/platforms.md)
    - [musl](./installation/musl.md)
 - [Configuration](./config/index.md)
-   - [Manual Pages](./config/man.md)
+   - [Package Documentation](./config/package-documentation/index.md)
+      - [Manual Pages](./config/package-documentation/man.md)
    - [Firmware](./config/firmware.md)
    - [Locales and Translations](./config/locales.md)
    - [Users and Groups](./config/users-and-groups.md)

src/config/package-documentation/index.md

@@ -0,0 +1,16 @@
+# Package documentation
+
+The most common media for documentation in Void Linux are [manual
+pages](./man.md).
+
+Many packages contain documentation in other formats, like HTML. This
+documentation can usually be found in a `/usr/share/doc/<package>` directory.
+
+More extensive documentation may be split into separate `*-doc` packages, such
+as `julia-doc`. This is often the case for programming languages, databases and
+big software libraries.
+
+In addition to documentation provided by upstream projects, packages may also
+contain description of initial setup or usage specific to Void, provided by
+distribution contributors. It will be located in
+`/usr/share/doc/<package>/README.voidlinux`.

src/config/man.md src/config/package-documentation/man.mdsrc/config/man.md renamed to src/config/package-documentation/man.md

@@ -50,7 +50,7 @@ chroot(2) - change root directory
 
 The `mdocml` package provides a cron job to update the database daily,
 `/etc/cron.daily/makewhatis`. You will need to install a [cron
-daemon](./cron.md) for this functionality to be activated.
+daemon](../cron.md) for this functionality to be activated.
 
 Development and POSIX manuals are not installed by default, but are available
 via the `man-pages-devel` and `man-pages-posix` packages.