Revert "docs: streamline manpages"

This reverts commit ca88e67b8f.

docs/man-configuration.xml

@@ -2,18 +2,40 @@
           xmlns:xlink="http://www.w3.org/1999/xlink"
           xmlns:xi="http://www.w3.org/2001/XInclude">
  <refmeta>
-  <refentrytitle><filename>neovim-flake</filename></refentrytitle>
+  <refentrytitle>neovim-flake configuration</refentrytitle>
   <manvolnum>5</manvolnum>
-  <refmiscinfo class="source">Neovim Flake</refmiscinfo>
+  <refmiscinfo class="source">neovim-flake</refmiscinfo>
+<!-- <refmiscinfo class="version"><xi:include href="version.txt" parse="text"/></refmiscinfo> -->
  </refmeta>
  <refnamediv>
-  <refname><filename>neovim-flake</filename></refname>
+  <refname>neovim configuration</refname>
-  <refpurpose>Neovim Flake f - Configuration specification</refpurpose>
+  <refpurpose>neovim-flake configuration specification</refpurpose>
  </refnamediv>
+ <refsection>
+  <title>Description</title>
+  <para>
+    Custom configuration is done with the neovim-flake.lib.neovimConfiguration function. It takes in the configuration as a module.
+    <programlisting>
+      neovim-flake.lib.neovimConfiguration {
+        inherit pkgs;
+        modules = [{config = xxx;}];
+      };
+    </programlisting>
+    The output of the configuration function is an attrset.
+  </para>
+  <programlisting>
+    {
+      options = "The options that were available to configure";
+      config = "The outputted configuration";
+      pkgs = "The package set used to evaluate the module";
+      neovim = "The built neovim package";
+    }
+  </programlisting>
+ </refsection>
  <refsection>
   <title>Options</title>
   <para>
-   You can use the following options in the `programs.neovim-flake` module:
+   You can use the following options in your neovim configuration.
   </para>
   <xi:include href="./nmd-result/neovim-flake-options.xml"/>
  </refsection>

docs/man-pages.xml

@@ -1,14 +1,12 @@
 <reference xmlns="http://docbook.org/ns/docbook"
            xmlns:xlink="http://www.w3.org/1999/xlink"
            xmlns:xi="http://www.w3.org/2001/XInclude">
-  <title>Neovim Flake - Reference Pages</title>
+ <title>neovim-flake Reference Pages</title>
  <info>
-    <author>
+  <author><personname>neovim-flake contributors</personname></author>
-      <personname>Gabriel Volpe</personname>
-    </author>
   <copyright>
-      <year>2023</year>
+      <year>2021–2023</year>
-      <holder>NotAShelf</holder>
+      <holder>neovim-flake contributors</holder>
   </copyright>
  </info>
  <xi:include href="man-configuration.xml" />

docs/manual.xml

@@ -4,12 +4,22 @@
       version="5.0"
       xml:id="book-neovim-flake-manual">
  <info>
-    <title>Neovim Flake by Gabriel Volpe</title>
+  <title>neovim-flake Manual</title>
  </info>
-  <xi:include href="try-it-out.xml" />
+ <preface>
-  <xi:include href="hm-module.xml" />
+  <title>Preface</title>
+  <para>
+   If your problem is caused by a bug in neovim-flake then it should be reported on the
+   <link xlink:href="https://github.com/notashelf/neovim-flake/issues">neovim-flake issue tracker</link>.
+  </para>
+ </preface>
+ <xi:include href="default-configs.xml"/>
+ <xi:include href="custom-configs.xml"/>
+ <xi:include href="languages.xml"/>
+ <xi:include href="plugins.xml"/>
  <appendix xml:id="ch-options">
-    <title>Configuration options</title>
+  <title>Configuration Options</title>
   <xi:include href="./nmd-result/neovim-flake-options.xml" />
  </appendix>
+ <xi:include href="./release-notes/release-notes.xml" />
 </book>