From ca88e67b8f2bfe2efb48c4fa1ad46de7ab5e3c16 Mon Sep 17 00:00:00 2001
From: NotAShelf <itsashelf@gmail.com>
Date: Mon, 6 Feb 2023 19:16:25 +0300
Subject: [PATCH] docs: streamline manpages

---
 docs/man-configuration.xml | 36 +++++++-----------------------------
 docs/man-pages.xml         | 22 ++++++++++++----------
 docs/manual.xml            | 30 ++++++++++--------------------
 3 files changed, 29 insertions(+), 59 deletions(-)

diff --git a/docs/man-configuration.xml b/docs/man-configuration.xml
index c39a729..72b6144 100644
--- a/docs/man-configuration.xml
+++ b/docs/man-configuration.xml
@@ -2,41 +2,19 @@
           xmlns:xlink="http://www.w3.org/1999/xlink"
           xmlns:xi="http://www.w3.org/2001/XInclude">
  <refmeta>
-  <refentrytitle>neovim-flake configuration</refentrytitle>
+  <refentrytitle><filename>neovim-flake</filename></refentrytitle>
   <manvolnum>5</manvolnum>
-  <refmiscinfo class="source">neovim-flake</refmiscinfo>
-<!-- <refmiscinfo class="version"><xi:include href="version.txt" parse="text"/></refmiscinfo> -->
+  <refmiscinfo class="source">Neovim Flake</refmiscinfo>
  </refmeta>
  <refnamediv>
-  <refname>neovim configuration</refname>
-  <refpurpose>neovim-flake configuration specification</refpurpose>
+  <refname><filename>neovim-flake</filename></refname>
+  <refpurpose>Neovim Flake f - 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 your neovim configuration.
+   You can use the following options in the `programs.neovim-flake` module:
   </para>
-  <xi:include href="./nmd-result/neovim-flake-options.xml"/>
+  <xi:include href="./nmd-result/neovim-flake-options.xml" />
  </refsection>
-</refentry>
\ No newline at end of file
+</refentry>
diff --git a/docs/man-pages.xml b/docs/man-pages.xml
index a89a8e8..001d517 100644
--- a/docs/man-pages.xml
+++ b/docs/man-pages.xml
@@ -1,13 +1,15 @@
 <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>
- <info>
-  <author><personname>neovim-flake contributors</personname></author>
-  <copyright>
-      <year>2021–2023</year>
-      <holder>neovim-flake contributors</holder>
-  </copyright>
- </info>
- <xi:include href="man-configuration.xml" />
-</reference>
\ No newline at end of file
+  <title>Neovim Flake - Reference Pages</title>
+  <info>
+    <author>
+      <personname>Gabriel Volpe</personname>
+    </author>
+    <copyright>
+      <year>2023</year>
+      <holder>NotAShelf</holder>
+    </copyright>
+   </info>
+   <xi:include href="man-configuration.xml" />
+</reference>
diff --git a/docs/manual.xml b/docs/manual.xml
index 57ec8ac..235c953 100644
--- a/docs/manual.xml
+++ b/docs/manual.xml
@@ -3,23 +3,13 @@
       xmlns:xi="http://www.w3.org/2001/XInclude"
       version="5.0"
       xml:id="book-neovim-flake-manual">
- <info>
-  <title>neovim-flake Manual</title>
- </info>
- <preface>
-  <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>
-  <xi:include href="./nmd-result/neovim-flake-options.xml" />
- </appendix>
- <xi:include href="./release-notes/release-notes.xml" />
-</book>
\ No newline at end of file
+  <info>
+    <title>Neovim Flake by Gabriel Volpe</title>
+  </info>
+  <xi:include href="try-it-out.xml" />
+  <xi:include href="hm-module.xml" />
+  <appendix xml:id="ch-options">
+    <title>Configuration options</title>
+    <xi:include href="./nmd-result/neovim-flake-options.xml" />
+  </appendix>
+</book>