mirror of
https://github.com/NixOS/nixpkgs.git
synced 2024-11-16 14:54:29 +01:00
bc0421c4cf
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
29 lines
708 B
Makefile
29 lines
708 B
Makefile
.PHONY: all
|
|
all: manual-combined.xml format
|
|
|
|
.PHONY: debug
|
|
debug: generated manual-combined.xml
|
|
|
|
manual-combined.xml: generated *.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
|