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: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>
<refpurpose>Neovim Flake f - Configuration specification</refpurpose>
<refname>neovim configuration</refname>
<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" />
<xi:include href="./nmd-result/neovim-flake-options.xml"/>
</refsection>
</refentry>

View file

@ -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>
<personname>Gabriel Volpe</personname>
</author>
<author><personname>neovim-flake contributors</personname></author>
<copyright>
<year>2023</year>
<holder>NotAShelf</holder>
<year>20212023</year>
<holder>neovim-flake contributors</holder>
</copyright>
</info>
<xi:include href="man-configuration.xml" />

View file

@ -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" />
<xi:include href="hm-module.xml" />
<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>
<title>Configuration Options</title>
<xi:include href="./nmd-result/neovim-flake-options.xml" />
</appendix>
<xi:include href="./release-notes/release-notes.xml" />
</book>