public
/
nixpkgs
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Add 'make debug' to call xmloscopy

This commit is contained in:
Graham Christensen 2018-03-25 20:01:31 -04:00
parent fce1fb7e75
commit 67f9d2425d
No known key found for this signature in database
GPG Key ID: ACA1C1D120C83D5C
2 changed files with 5 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

3
doc/Makefile
View File

@ -3,6 +3,9 @@ MD_TARGETS=$(addsuffix .xml, $(basename $(wildcard ./*.md ./**/*.md)))
.PHONY: all .PHONY: all
all: validate out/html/index.html out/epub/manual.epub 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 .PHONY: clean
clean: clean:
rm -f ${MD_TARGETS} .version manual-full.xml rm -f ${MD_TARGETS} .version manual-full.xml

5
doc/contributing.xml
View File

@ -16,9 +16,8 @@ subdirectory of the Nixpkgs repository.</para>
[nix-shell]$ make [nix-shell]$ make
</screen> </screen>
<para>If you experience problems, run <command>xmloscopy --docbook5 <para>If you experience problems, run <command>make debug</command>
./manual.xml ./manual-full.xml</command> inside the nix-shell to help to help understand the docbook errors.</para>
understand the docbook errors.</para>
<para>After making modifications to the manual, it's important to <para>After making modifications to the manual, it's important to
build it before committing. You can do that as follows: build it before committing. You can do that as follows: