1
0
Fork 1
mirror of https://github.com/NixOS/nixpkgs.git synced 2024-12-22 14:47:06 +00:00
nixpkgs/nixos/doc/manual
Profpatsch f09f49d483 nixos/doc/manual: print context on failing xmllint validation
Previously only the line numbers of a giant, internally generated XML file were
printed, without any kind of debuggability.
Now at least the mentioned lines are printed with a little bit of surrounding
context (to have something to grep for).

```
manual-combined.xml:4863: element para: Relax-NG validity error : Did not expect element para there
  4859	<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude" version="5.0" xml:id="sec-writing-modules">
  4860
  4861	<title>Writing NixOS Modules</title>
  4862
  4863	<para>NixOS has a modular system for declarative configuration.  This
  4864	system combines multiple <emphasis>modules</emphasis> to produce the
  4865	full system configuration.  One of the modules that constitute the
```
2017-11-22 21:27:05 +01:00
..
administration postgresql92: remove last references 2017-09-05 18:20:56 +02:00
configuration NixOS Manual: document assertions and warnings (#29206) 2017-09-11 17:12:50 +01:00
development lib/types: add ints.positive. 2017-11-05 15:56:32 +01:00
installation install documentation: document boot.loader.grub.useOSProber 2017-10-29 14:27:21 +01:00
release-notes nixos/ssh: Update 18.03 release notes 2017-11-18 15:35:56 -08:00
default.nix nixos/doc/manual: print context on failing xmllint validation 2017-11-22 21:27:05 +01:00
man-configuration.xml
man-nixos-build-vms.xml
man-nixos-generate-config.xml
man-nixos-install.xml
man-nixos-option.xml Improved nixos-option manpage 2017-08-04 03:30:35 +02:00
man-nixos-rebuild.xml
man-nixos-version.xml
man-pages.xml
manual.xml Point to the new mailing list by replacing the old link 2017-07-18 13:44:10 +02:00
options-to-docbook.xsl
README
style.css

To build the manual, you need Nix installed on your system (no need
for NixOS). To install Nix, follow the instructions at

    https://nixos.org/nix/download.html

When you have Nix on your system, in the root directory of the project
(i.e., `nixpkgs`), run:

    nix-build nixos/release.nix -A manual.x86_64-linux

When this command successfully finishes, it will tell you where the
manual got generated.