X-Git-Url: https://git.donarmstrong.com/?a=blobdiff_plain;f=Documentation%2FGNUmakefile;h=d265a1ee96fc1bc1a3f3c3f576e24c7a1cc5218d;hb=5106a982939f98fb3494fd7ce8f278a0ba3d4636;hp=21358e930248cc0aeb29bde81ea42de6f5d264ca;hpb=70c86a3442dc5d6a1158a3e5bdfc4e683c4be3bf;p=lilypond.git diff --git a/Documentation/GNUmakefile b/Documentation/GNUmakefile index 21358e9302..d265a1ee96 100644 --- a/Documentation/GNUmakefile +++ b/Documentation/GNUmakefile @@ -6,14 +6,17 @@ SUBDIRS=user bibliography pictures topdocs misc po $(LANGS) STEPMAKE_TEMPLATES=documentation texinfo tex LOCALSTEPMAKE_TEMPLATES=lilypond ly LILYPOND_BOOK_FLAGS=--extra-options '-e "(ly:set-option (quote internal-type-checking) \#t)"' -README_TOP_FILES= DEDICATION THANKS +README_TOP_FILES= DEDICATION THANKS EXTRA_DIST_FILES= texinfo.css TRANSLATION include $(depth)/make/stepmake.make +HTML_PAGE_NAMES= index devel translations +OUT_HTML_FILES= $(HTML_PAGE_NAMES:%=$(outdir)/%.html) + default: local-doc -local-WWW: txt-to-html $(outdir)/index.html $(outdir)/devel.html +local-WWW: txt-to-html $(OUT_HTML_FILES) local-WWW-clean: deep-WWW-clean @@ -47,7 +50,7 @@ new-lang: mv $(outdir)/*.*tely $(ISOLANG)/user msgmerge -U po/lilypond-doc.pot $(outdir)/doc.pot cp po/lilypond-doc.pot po/$(ISOLANG).po - @echo "*** Please add a language definition for $(ISOLANG) in buildscripts/langdefs.py ***" + @echo "*** Please add a language definition for $(ISOLANG) in python/langdefs.py ***" CHECKED_FILES = $(ISOLANG)/index.html.in $(shell find $(ISOLANG)/user/ -maxdepth 1 -name '*.*te??') @@ -59,7 +62,28 @@ skeleton-update: snippet-update: $(PYTHON) $(buildscript-dir)/update-snippets.py user $(ISOLANG)/user '*.itely' -endif +DOCUMENTS_INCLUDES:=-I $(ISOLANG)/user \ +-I $(top-build-dir)/Documentation/$(ISOLANG)/user/out-www \ +-I $(top-src-dir)/input/lsr \ +-I $(top-build-dir)/input/lsr/out-www \ +-I user -I $(top-build-dir)/Documentation/user/out-www + +else # ISOLANG is empty + +DOCUMENTS_INCLUDES:=-I user \ +-I $(top-build-dir)/Documentation/user/out-www \ +-I $(top-src-dir)/input/lsr \ +-I $(top-build-dir)/input/lsr/out-www + +endif # ISOLANG + +check-xrefs: + $(PYTHON) $(buildscript-dir)/check_texi_refs.py --batch \ + $(DOCUMENTS_INCLUDES) $(buildscript-dir)/manuals_definitions.py + +fix-xrefs: + $(PYTHON) $(buildscript-dir)/check_texi_refs.py --auto-fix \ + $(DOCUMENTS_INCLUDES) $(buildscript-dir)/manuals_definitions.py check-translation: $(PYTHON) $(buildscript-dir)/check_translation.py $(buildscript-dir) $(CHECKED_FILES) @@ -70,3 +94,24 @@ update-translation: translation-status: make -C po out=www messages $(PYTHON) $(buildscript-dir)/translations-status.py $(buildscript-dir) + +local-help: extra-local-help + +extra-local-help: + @echo -e "\ + check-xrefs [ISOLANG=LL] validate Texinfo cross-references\n\ + fix-xrefs [ISOLANG=LL] interactively fix Texinfo cross-references (use with caution)\n\ +\n\ +Translations specific targets (see TRANSLATION for details):\n\ + new-lang ISOLANG=LL create and initialize subdirectory \'LL' for language \'LL\n\ + po-update update and replace PO files for documentation with msgmerged versions\n\ + check-translation ISOLANG=LL show changes in English docs since last translation update\n\ + update-translation ISOLANG=LL call $$$$EDITOR to help updating the translation\n\ + skeleton-update ISOLANG=LL update Texinfo skeleton files\n\ + snippet-update ISOLANG=LL update ly snippets in Texinfo translation according to\n\ + docs in English (use with caution)\n\ +\n\ +LL refers to the desired locale (most often only the ISO 639 language code).\n" + +info: + $(MAKE) -C user info