nixpkgs/nixos/doc/manual/Makefile

.PHONY: all
all: manual-combined.xml format

.PHONY: debug
debug: generated manual-combined.xml

manual-combined.xml: generated *.xml **/*.xml
	rm -f ./manual-combined.xml
	nix-shell --packages xmloscopy \
		--run "xmloscopy --docbook5 ./manual.xml ./manual-combined.xml"

.PHONY: format
format:
	find ../../ -iname '*.xml' -type f -print0 | xargs -0 -I{} -n1 \
		xmlformat --config-file "../xmlformat.conf" -i {}

.PHONY: fix-misc-xml
fix-misc-xml:
	find . -iname '*.xml' -type f \
		-exec ../varlistentry-fixer.rb {} ';'

.PHONY: clean
clean:
	rm -f manual-combined.xml generated

generated: ./options-to-docbook.xsl
	nix-build ../../release.nix \
		--attr manualGeneratedSources.x86_64-linux \
		--out-link ./generated
nixos docs: makefile for formatting 2018-05-01 18:03:25 -04:00			`.PHONY: all`
			`all: manual-combined.xml format`

			`.PHONY: debug`
			`debug: generated manual-combined.xml`

nixos/doc: Adds sub-folder to input files. 2018-10-03 22:33:03 -04:00			`manual-combined.xml: generated .xml /.xml`
nixos docs: fixup 2018-05-01 19:43:52 -04:00			`rm -f ./manual-combined.xml`
nixos docs: Add a makefile for hacking on the nixos docs 2018-04-28 04:00:55 -04:00			`nix-shell --packages xmloscopy \`
nixos docs: makefile for formatting 2018-05-01 18:03:25 -04:00			`--run "xmloscopy --docbook5 ./manual.xml ./manual-combined.xml"`

			`.PHONY: format`
			`format:`
makefile: auto-format xml docs outside of the doc subdir 2018-09-01 16:18:18 -04:00			`find ../../ -iname '*.xml' -type f -print0 \| xargs -0 -I{} -n1 \`
nixos docs: makefile for formatting 2018-05-01 18:03:25 -04:00			`xmlformat --config-file "../xmlformat.conf" -i {}`

doc: Adds xml fixing script. (see previous and next commits) This script is used to automatically fix issues within xml documentation files. The script is for now intended to be used ad-hoc, and the commits to be examined. A future discussion will define whether: * This commit and scripts are kept. * The script is extended for common use. The biggest issue right now with the script is that it could in theory destroy a valid space-less varlistentry. The script could, in practical use, be changed and extended to normalize some parts of the XML files, mainly: * A common quoting style for attributes * Fix-up some weird formatting automatically that xmlformat doesn't catch 2018-05-31 20:26:27 -04:00			`.PHONY: fix-misc-xml`
			`fix-misc-xml:`
			`find . -iname '*.xml' -type f \`
			`-exec ../varlistentry-fixer.rb {} ';'`

nixos docs: makefile for formatting 2018-05-01 18:03:25 -04:00			`.PHONY: clean`
			`clean:`
			`rm -f manual-combined.xml generated`
nixos docs: Add a makefile for hacking on the nixos docs 2018-04-28 04:00:55 -04:00
			`generated: ./options-to-docbook.xsl`
			`nix-build ../../release.nix \`
			`--attr manualGeneratedSources.x86_64-linux \`
			`--out-link ./generated`