X-Git-Url: https://git.saurik.com/apt.git/blobdiff_plain/fb2894d268d4821e0dd4f2b803ff2043b1ec3162..dabb215cb8c4b074d286737da523d8ef14381468:/doc/makefile?ds=sidebyside diff --git a/doc/makefile b/doc/makefile index 5f774b825..220a6160d 100644 --- a/doc/makefile +++ b/doc/makefile @@ -1,47 +1,103 @@ # -*- make -*- BASE=.. SUBDIR=doc -SUBDIRS= fr ja pl pt_BR es +SUBDIRS= $(dir $(wildcard */makefile)) # Bring in the default rules include ../buildlib/defaults.mak # Debian Doc SGML Documents -SOURCE = dpkg-tech.sgml design.sgml files.sgml guide.sgml guide.it.sgml \ - cache.sgml method.sgml offline.sgml +SOURCE = $(wildcard *.sgml) +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 -INCLUDES = apt.ent -include $(XML_MANPAGE_H) +MANPAGEPO = $(patsubst %.po,%,$(notdir $(wildcard po/*.po))) +MANPAGEPOLIST = $(patsubst %,manpages-translation-%,$(MANPAGEPO)) + +doc: manpages + +# 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: $(MANPAGEPOLIST) $($(LOCAL)-LIST) + +$($(LOCAL)-LIST) :: % : %.xml $(STYLESHEET) $(INCLUDES) + echo Creating man page $@ + $(XSLTPROC) -o $@ $(STYLESHEET) $< + +$(MANPAGEPOLIST) :: manpages-translation-% : %/makefile po4a + $(MAKE) -C $(dir $<) doc + +.PHONY: manpages dirs-manpage-subdirs $(MANPAGEPOLIST) +dirs: dirs-manpage-subdirs +dirs-manpage-subdirs: + for i in $(MANPAGEPO); do \ + test -d $$i || mkdir $$i; \ + test -f $$i/makefile || sed "s#@@LANG@@#$$i#" lang.makefile > $$i/makefile; \ + done + +# 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 +SOURCE = examples/apt.conf examples/sources.list examples/configure-index examples/apt-https-method-example.conf TO = $(DOC) TARGET = binary include $(COPY_H) -#.PHONY: headers library clean veryclean all binary program doc doc.pt_BR doc.fr -doc: doc.fr doc.ja doc.pl doc.pt_BR doc.es +.PHONY: clean clean-subdirs veryclean veryclean-subdirs all binary doc -doc.fr: %.fr: - $(MAKE) -C fr $* +clean: clean-subdirs +veryclean: veryclean-subdirs -doc.pt_BR: %.pt_BR: - $(MAKE) -C pt_BR $* +clean-subdirs: + for dir in $(SUBDIRS); do\ + $(MAKE) -C $$dir clean; \ + done -doc.es: %.es: - $(MAKE) -C es $* +veryclean-subdirs: + for dir in $(SUBDIRS); do\ + rm -rf $$dir; \ + done -doc.ja: %.ja: - $(MAKE) -C ja $* +.PHONY: update-po po4a stats -doc.pl: %.pl: - $(MAKE) -C pl $* +ifdef PO4A +doc: po4a + +update-po: + po4a --previous --no-backups --force --no-translations \ + --package-name='$(PACKAGE)-doc' --package-version='$(PACKAGE_VERSION)' \ + --msgid-bugs-address='$(PACKAGE_MAIL)' po4a.conf + +po4a: + po4a --previous --no-backups \ + --package-name='$(PACKAGE)-doc' --package-version='$(PACKAGE_VERSION)' \ + --msgid-bugs-address='$(PACKAGE_MAIL)' po4a.conf +endif + +stats: + for i in po/*.po; do echo -n "$$i: "; msgfmt --output-file=/dev/null --statistics $$i; done ifdef DOXYGEN DOXYGEN_SOURCES = $(shell find $(BASE)/apt-pkg -not -name .\\\#* -and \( -name \*.cc -or -name \*.h \) ) @@ -52,14 +108,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 - endif