Revert "docs: streamline manpages"

This reverts commit ca88e67b8f.
This commit is contained in:
NotAShelf 2023-02-06 19:20:24 +03:00
parent ca88e67b8f
commit 7cee5948e4
No known key found for this signature in database
GPG key ID: 5B5C8895F28445F1
3 changed files with 59 additions and 29 deletions

View file

@ -2,19 +2,41 @@
xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xlink="http://www.w3.org/1999/xlink"
xmlns:xi="http://www.w3.org/2001/XInclude"> xmlns:xi="http://www.w3.org/2001/XInclude">
<refmeta> <refmeta>
<refentrytitle><filename>neovim-flake</filename></refentrytitle> <refentrytitle>neovim-flake configuration</refentrytitle>
<manvolnum>5</manvolnum> <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> </refmeta>
<refnamediv> <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> </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> <refsection>
<title>Options</title> <title>Options</title>
<para> <para>
You can use the following options in the `programs.neovim-flake` module: You can use the following options in your neovim configuration.
</para> </para>
<xi:include href="./nmd-result/neovim-flake-options.xml" /> <xi:include href="./nmd-result/neovim-flake-options.xml"/>
</refsection> </refsection>
</refentry> </refentry>

View file

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

View file

@ -3,13 +3,23 @@
xmlns:xi="http://www.w3.org/2001/XInclude" xmlns:xi="http://www.w3.org/2001/XInclude"
version="5.0" version="5.0"
xml:id="book-neovim-flake-manual"> xml:id="book-neovim-flake-manual">
<info> <info>
<title>Neovim Flake by Gabriel Volpe</title> <title>neovim-flake Manual</title>
</info> </info>
<xi:include href="try-it-out.xml" /> <preface>
<xi:include href="hm-module.xml" /> <title>Preface</title>
<appendix xml:id="ch-options"> <para>
<title>Configuration options</title> If your problem is caused by a bug in neovim-flake then it should be reported on the
<xi:include href="./nmd-result/neovim-flake-options.xml" /> <link xlink:href="https://github.com/notashelf/neovim-flake/issues">neovim-flake issue tracker</link>.
</appendix> </para>
</book> </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>