X-Git-Url: https://git.saurik.com/apt.git/blobdiff_plain/944b2fffc4a54fbf9329faa579592cc758915a99..612300483371c0e53ed0000a838bbfbbc4b919e0:/doc/makefile diff --git a/doc/makefile b/doc/makefile index 26ca52a9e..be8357d80 100644 --- a/doc/makefile +++ b/doc/makefile @@ -8,16 +8,41 @@ include ../buildlib/defaults.mak # Debian Doc SGML Documents SOURCE = $(wildcard *.sgml) -DEBIANDOC_HTML_OPTIONS=-l en +DEBIANDOC_HTML_OPTIONS=-l en.UTF-8 include $(DEBIANDOC_H) -# XML man pages -SOURCE = apt-cache.8 apt-get.8 apt-cdrom.8 apt.conf.5 sources.list.5 \ - apt-config.8 apt_preferences.5 \ - apt-sortpkgs.1 apt-ftparchive.1 apt-extracttemplates.1 \ - apt-key.8 apt-secure.8 apt-mark.8 -INCLUDES = apt.ent -include $(XML_MANPAGE_H) +doc: manpages debiandoc + +# Do not use XMLTO, build the manpages directly with XSLTPROC +ifdef XSLTPROC +# generate a list of accepted man page translations +SOURCE = $(patsubst %.xml,%,$(wildcard *.?.xml)) +INCLUDES = apt.ent apt-verbatim.ent +STYLESHEET=manpage-style.xsl + +LOCAL := manpage-$(firstword $(SOURCE)) +$(LOCAL)-LIST := $(SOURCE) + +# Install generation hooks +manpages: $($(LOCAL)-LIST) + +$($(LOCAL)-LIST) :: % : %.xml $(STYLESHEET) $(INCLUDES) + echo Creating man page $@ + $(XSLTPROC) -o $@ $(STYLESHEET) $< + +# Clean rule +.PHONY: veryclean/$(LOCAL) +veryclean: veryclean/$(LOCAL) +veryclean/$(LOCAL): + -rm -rf $($(@F)-LIST) +endif + +# Chain to the manpage rule +SOURCE = apt.8 +include $(MANPAGE_H) + +examples/sources.list: examples/sources.list.in apt-verbatim.ent + sed -e 's#&stable-codename;#$(shell grep --max-count=1 '^ examples/sources.list # Examples SOURCE = examples/apt.conf examples/sources.list examples/configure-index examples/apt-https-method-example.conf @@ -25,11 +50,7 @@ TO = $(DOC) TARGET = binary include $(COPY_H) -#.PHONY: headers library clean veryclean all binary program doc doc.pt_BR doc.fr -doc: - for dir in $(SUBDIRS); do\ - $(MAKE) -C $$dir $@; \ - done +.PHONY: clean clean-subdirs veryclean veryclean-subdirs all binary doc stats clean: clean-subdirs veryclean: veryclean-subdirs @@ -41,31 +62,57 @@ clean-subdirs: veryclean-subdirs: for dir in $(SUBDIRS); do\ - $(MAKE) -C $$dir veryclean; \ - done - # FIXME remove created sgml files, but preserve all - # which are "left over" from older systems. - # After completing the transition this should be handled - # in the po4a-manpage makefile for all translations - for dir in $(subst /addendum/,, $(dir $(wildcard */addendum/debiandoc*))); do\ - rm -f $$dir/offline.$$dir.sgml; \ - rm -f $$dir/guide.$$dir.sgml; \ + rm -rf $$dir; \ done +stats: + for i in po/*.po; do echo -n "$$i: "; msgfmt --output-file=/dev/null --statistics $$i; done + ifdef PO4A -doc: po4a +DOCUMENTATIONPO = $(patsubst %.po,%,$(notdir $(wildcard po/*.po))) +MANPAGEPOLIST = $(addprefix manpages-translation-,$(DOCUMENTATIONPO)) +DEBIANDOCPOLIST = $(addprefix debiandoc-translation-,$(DOCUMENTATIONPO)) -clean: po4a-clean +MANPAGEDIRLIST = $(addsuffix /makefile,$(DOCUMENTATIONPO)) -.PHONY: update-po po4a -update-po: - po4a --previous --no-backups --force --no-translations po4a.conf +.PHONY: update-po po4a $(MANPAGEPOLIST) $(MANPAGEDIRLIST) -po4a-clean: - po4a --previous --rm-backups --rm-translations po4a.conf +manpages: $(MANPAGEPOLIST) +debiandoc: $(DEBIANDOCPOLIST) +po4a: $(MANPAGEPOLIST) $(DEBIANDOCPOLIST) -po4a: - po4a --previous --no-backups po4a.conf +update-po: + po4a --previous --no-backups --force --no-translations \ + --package-name='$(PACKAGE)-doc' --package-version='$(PACKAGE_VERSION)' \ + --msgid-bugs-address='$(PACKAGE_MAIL)' po4a.conf + +$(MANPAGEPOLIST) :: manpages-translation-% : %/makefile po4a.conf + # first line is for apt.8 (see Bug#696923) + po4a --previous --no-backups --translate-only $(dir $<)apt.ent \ + $(patsubst %,--translate-only $(dir $<)%,$(patsubst %.8,%.$(subst /,,$(dir $<)).8,$(wildcard *.8))) \ + $(patsubst %,--translate-only $(dir $<)%,$(patsubst %.1.xml,%.$(subst /,,$(dir $<)).1.xml,$(wildcard *.1.xml))) \ + $(patsubst %,--translate-only $(dir $<)%,$(patsubst %.2.xml,%.$(subst /,,$(dir $<)).2.xml,$(wildcard *.2.xml))) \ + $(patsubst %,--translate-only $(dir $<)%,$(patsubst %.3.xml,%.$(subst /,,$(dir $<)).3.xml,$(wildcard *.3.xml))) \ + $(patsubst %,--translate-only $(dir $<)%,$(patsubst %.4.xml,%.$(subst /,,$(dir $<)).4.xml,$(wildcard *.4.xml))) \ + $(patsubst %,--translate-only $(dir $<)%,$(patsubst %.5.xml,%.$(subst /,,$(dir $<)).5.xml,$(wildcard *.5.xml))) \ + $(patsubst %,--translate-only $(dir $<)%,$(patsubst %.6.xml,%.$(subst /,,$(dir $<)).6.xml,$(wildcard *.6.xml))) \ + $(patsubst %,--translate-only $(dir $<)%,$(patsubst %.7.xml,%.$(subst /,,$(dir $<)).7.xml,$(wildcard *.7.xml))) \ + $(patsubst %,--translate-only $(dir $<)%,$(patsubst %.8.xml,%.$(subst /,,$(dir $<)).8.xml,$(wildcard *.8.xml))) \ + --package-name='$(PACKAGE)-doc' --package-version='$(PACKAGE_VERSION)' \ + --msgid-bugs-address='$(PACKAGE_MAIL)' po4a.conf + $(MAKE) -C $(dir $<) manpages + +$(DEBIANDOCPOLIST) :: debiandoc-translation-% : %/makefile po4a.conf + po4a --previous --no-backups --translate-only $(dir $<)apt.ent \ + $(patsubst %,--translate-only $(dir $<)%,$(patsubst %.sgml,%.$(subst /,,$(dir $<)).sgml,$(wildcard *.sgml))) \ + --package-name='$(PACKAGE)-doc' --package-version='$(PACKAGE_VERSION)' \ + --msgid-bugs-address='$(PACKAGE_MAIL)' po4a.conf + $(MAKE) -C $(dir $<) debiandoc + +dirs: $(MANPAGEDIRLIST) +$(MANPAGEDIRLIST) :: %/makefile : lang.makefile + test -d $(dir $@) || mkdir $(dir $@) + sed "s#@@LANG@@#$(subst /,,$(dir $@))#" $< > $@ endif ifdef DOXYGEN @@ -77,14 +124,11 @@ doxygen-clean: rm -fr $(BUILD)/doc/doxygen rm -f $(BUILD)/doc/doxygen-stamp -$(BUILD)/doc/Doxyfile: Doxyfile.in - (cd $(BUILD) && ./config.status doc/Doxyfile) - $(BUILD)/doc/doxygen-stamp: $(DOXYGEN_SOURCES) $(BUILD)/doc/Doxyfile rm -fr $(BUILD)/doc/doxygen + mkdir $(BUILD)/doc/doxygen # some versions seem to not create this directory #628799 $(DOXYGEN) $(BUILD)/doc/Doxyfile touch $(BUILD)/doc/doxygen-stamp -doc: $(BUILD)/doc/doxygen-stamp - +debiandoc: $(BUILD)/doc/doxygen-stamp endif