nixos doc: module meta attribute section cleanup

This commit is contained in:
Robin Gloster 2016-08-29 09:34:24 +00:00
parent aca4801f53
commit 6808de76e6
No known key found for this signature in database
GPG Key ID: 5E4C836C632C2882

View File

@ -4,10 +4,10 @@
version="5.0"
xml:id="sec-meta-attributes">
<title>Meta-attributes</title>
<title>Meta Attributes</title>
<para>Like Nix packages, NixOS modules can declare meta-attributes to provide
extra information. Module meta-attributes are defined in the
extra information. Module meta attributes are defined in the
<filename
xlink:href="https://github.com/NixOS/nixpkgs/blob/master/nixos/modules/misc/meta.nix">meta.nix</filename>
special module.</para>
@ -48,11 +48,11 @@
<callout arearefs='modules-meta-2'>
<para>
<varname>doc</varname> point to a valid docbook file containing the module
documentation, its contents are automatically added to the <xref
<varname>doc</varname> points to a valid DocBook file containing the module
documentation. Its contents is automatically added to <xref
linkend="ch-configuration"/>.
Changes to a module documentation must be checked to be non-breaking by
building the NixOS manual.
Changes to a module documentation have to be checked to not break
building the NixOS manual:
</para>
<programlisting>$ nix-build nixos/release.nix -A manual</programlisting>
</callout>