summary refs log tree commit diff
path: root/doc
diff options
context:
space:
mode:
authorGraham Christensen <graham@grahamc.com>2018-03-25 20:01:31 -0400
committerGraham Christensen <graham@grahamc.com>2018-03-25 20:01:31 -0400
commit67f9d2425dedbea2c2611100a6fb5935de9a6123 (patch)
tree59f8c359877a4ab2aa7fee206400058d98664b09 /doc
parentfce1fb7e7573cacfd3edaa282cb4ebdcb58d6681 (diff)
downloadnixpkgs-67f9d2425dedbea2c2611100a6fb5935de9a6123.tar
nixpkgs-67f9d2425dedbea2c2611100a6fb5935de9a6123.tar.gz
nixpkgs-67f9d2425dedbea2c2611100a6fb5935de9a6123.tar.bz2
nixpkgs-67f9d2425dedbea2c2611100a6fb5935de9a6123.tar.lz
nixpkgs-67f9d2425dedbea2c2611100a6fb5935de9a6123.tar.xz
nixpkgs-67f9d2425dedbea2c2611100a6fb5935de9a6123.tar.zst
nixpkgs-67f9d2425dedbea2c2611100a6fb5935de9a6123.zip
Add 'make debug' to call xmloscopy
Diffstat (limited to 'doc')
-rw-r--r--doc/Makefile3
-rw-r--r--doc/contributing.xml5
2 files changed, 5 insertions, 3 deletions
diff --git a/doc/Makefile b/doc/Makefile
index f3a4d6b5aaf..52d1f4630a8 100644
--- a/doc/Makefile
+++ b/doc/Makefile
@@ -3,6 +3,9 @@ MD_TARGETS=$(addsuffix .xml, $(basename $(wildcard ./*.md ./**/*.md)))
 .PHONY: all
 all: validate out/html/index.html out/epub/manual.epub
 
+.PHONY: debug
+debug:
+	nix-shell --run "xmloscopy --docbook5 ./manual.xml ./manual-full.xml"
 .PHONY: clean
 clean:
 	rm -f ${MD_TARGETS} .version manual-full.xml
diff --git a/doc/contributing.xml b/doc/contributing.xml
index 8eed9c5416e..7aa0df271ff 100644
--- a/doc/contributing.xml
+++ b/doc/contributing.xml
@@ -16,9 +16,8 @@ subdirectory of the Nixpkgs repository.</para>
   [nix-shell]$ make
 </screen>
 
-<para>If you experience problems, run <command>xmloscopy --docbook5
-./manual.xml ./manual-full.xml</command> inside the nix-shell to help
-understand the docbook errors.</para>
+<para>If you experience problems, run <command>make debug</command>
+to help understand the docbook errors.</para>
 
 <para>After making modifications to the manual, it's important to
 build it before committing. You can do that as follows: