repositories/<various>: Consolidate repository info.

* Move contents of `{nonfree,multilib,nonfree}.md` into `index.md`.
* Remove `{nonfree,multilib,nonfree}.md`.
* Improve prose.

Author: flexibeast

src/SUMMARY.md

@@ -64,9 +64,6 @@
    - [Downgrading](./xbps/downgrading.md)
    - [Finding Files and Packages](./xbps/files-and-packages.md)
    - [Repositories](./xbps/repositories/index.md)
-      - [debug](./xbps/repositories/debug.md)
-      - [multilib](./xbps/repositories/multilib.md)
-      - [nonfree](./xbps/repositories/nonfree.md)
       - [Mirrors](./xbps/repositories/mirrors/index.md)
          - [Changing Mirrors](./xbps/repositories/mirrors/changing.md)
          - [Using Tor Mirrors](./xbps/repositories/mirrors/tor.md)

src/config/graphical-session/graphics-drivers/nvidia.md

@@ -19,8 +19,8 @@ For using Wayland, users should install the `mesa-dri` provided driver.
 
 ## nvidia (Proprietary Driver)
 
-The proprietary drivers are available in the [non-free
-repository](../../../xbps/repositories/nonfree.md).
+The proprietary drivers are available in the [nonfree
+repository](../../../xbps/repositories/index.md#nonfree).
 
 Check if your graphics card belongs to the [legacy
 branch](https://www.nvidia.com/en-us/drivers/unix/legacy-gpu/). If it does not,

src/config/graphical-session/xorg.md

@@ -50,8 +50,8 @@ For advanced configuration, see
 ### Proprietary Drivers
 
 Void also provides [proprietary NVIDIA drivers](./graphics-drivers/nvidia.md),
-which are available in the [non-free
-repository](../../xbps/repositories/nonfree.md).
+which are available in the [nonfree
+repository](../../xbps/repositories/index.md#nonfree).
 
 ## Input Drivers
 

src/config/microcode.md

@@ -10,8 +10,8 @@ without the need to replace the hardware.
 ### Intel
 
 Install the Intel microcode package, `intel-ucode`. This package is in the
-nonfree repo, which has to be [enabled](../xbps/repositories/nonfree.md). After
-installing this package, it is necessary to regenerate your
+nonfree repo, which has to be [enabled](../xbps/repositories/index.md#nonfree).
+After installing this package, it is necessary to regenerate your
 [initramfs](./kernel.md#kernel-hooks). For subsequent updates, the microcode
 will be added to the initramfs automatically.
 

src/xbps/repositories/debug.md

@@ -14,13 +14,60 @@ In addition to the main repository, which is enabled upon installation, Void
 provides other official repositories maintained by the Void project, but not
 enabled by default:
 
-- [debug](./debug.md): contains debugging symbols for packages
-- [multilib](./multilib.md): contains 32-bit libraries for 64-bit systems (glibc
-   only)
-- [multilib/nonfree](./multilib.md): contains non-free multilib packages
-- [nonfree](./nonfree.md): contains software packages with non-free licenses
+- nonfree: contains software packages with non-free licenses
+- multilib: contains 32-bit libraries for 64-bit systems (glibc only)
+- multilib/nonfree: contains non-free multilib packages
+- debug: contains debugging symbols for packages
 
 These repositories can be enabled via the installation of the relevant package.
-For example, to enable the `nonfree` repository, install the `void-repo-nonfree`
-package. These packages only install a repository configuration file in
+These packages only install a repository configuration file in
 `/usr/share/xbps.d`.
+
+### nonfree
+
+Void has a `nonfree` repository for packages that don't have free licenses. It
+can enabled by installing the `void-repo-nonfree` package.
+
+Packages can end up in the `nonfree` repository for a number of reasons:
+
+- Non-free licensed software with released source-code.
+- Software released only as redistributable binary packages.
+- Patented technology, which may or may not have an (otherwise) open
+   implementation.
+
+### multilib
+
+The `multilib` repository provides 32-bit packages as a compatibility layer
+inside a 64-bit system. It can be enabled by installing the `void-repo-multilib`
+package.
+
+These repositories are only available for `x86_64` systems running the `glibc` C
+library.
+
+### multilib/nonfree
+
+The `multilib/nonfree` repository provides additional 32-bit packages which have
+non-free licenses. It can be enabled by installing the
+`void-repo-multilib-nonfree` package.
+
+### debug
+
+Void Linux packages come without debugging symbols. If you want to debug
+software or look at a core dump you will need the debugging symbols. These
+packages are contained in the debug repository. It can be enabled by installing
+the `void-repo-debug` package.
+
+Once enabled, symbols may be obtained for `<package>` by installing
+`<package>-dbg`.
+
+#### Finding debug dependencies
+
+The `xtools` package contains the `xdbg` utility to retrieve a list of debug
+packages, including dependencies, for a package:
+
+```
+$ xdbg bash
+bash-dbg
+glibc-dbg
+# xbps-install -S $(xdbg bash)
+```