doc/makefile

   1 # -*- make -*-
   2 BASE=..
   3 SUBDIR=doc
   4 SUBDIRS= $(dir $(wildcard */makefile))
   5
   6 # Bring in the default rules
   7 include ../buildlib/defaults.mak
   8
   9 # Debian Doc SGML Documents
  10 SOURCE = $(wildcard *.sgml)
  11 DEBIANDOC_HTML_OPTIONS=-l en.UTF-8
  12 include $(DEBIANDOC_H)
  13
  14 MANPAGEPO = $(patsubst %.po,%,$(notdir $(wildcard po/*.po)))
  15 MANPAGEPOLIST = $(patsubst %,manpages-translation-%,$(MANPAGEPO))
  16
  17 doc: manpages
  18
  19 # Do not use XMLTO, build the manpages directly with XSLTPROC
  20 ifdef XSLTPROC
  21 # generate a list of accepted man page translations
  22 SOURCE = $(patsubst %.xml,%,$(wildcard *.?.xml))
  23 INCLUDES = apt.ent apt-verbatim.ent
  24 STYLESHEET=manpage-style.xsl
  25
  26 LOCAL := manpage-$(firstword $(SOURCE))
  27 $(LOCAL)-LIST := $(SOURCE)
  28
  29 # Install generation hooks
  30 manpages: $(MANPAGEPOLIST) $($(LOCAL)-LIST)
  31
  32 $($(LOCAL)-LIST) :: % : %.xml $(STYLESHEET) $(INCLUDES)
  33         echo Creating man page $@
  34         $(XSLTPROC) -o $@ $(STYLESHEET) $<
  35
  36 $(MANPAGEPOLIST) :: manpages-translation-% : %/makefile po4a
  37         $(MAKE) -C $(dir $<) doc
  38
  39 .PHONY: manpages dirs-manpage-subdirs $(MANPAGEPOLIST)
  40 dirs: dirs-manpage-subdirs
  41 dirs-manpage-subdirs:
  42         for i in $(MANPAGEPO); do \
  43                 test -d $$i || mkdir $$i; \
  44                 test -f $$i/makefile || sed "s#@@LANG@@#$$i#" lang.makefile > $$i/makefile; \
  45         done
  46
  47 # Clean rule
  48 .PHONY: veryclean/$(LOCAL)
  49 veryclean: veryclean/$(LOCAL)
  50 veryclean/$(LOCAL):
  51         -rm -rf $($(@F)-LIST)
  52
  53 endif
  54
  55 # Chain to the manpage rule
  56 SOURCE = apt.8
  57 include $(MANPAGE_H)
  58
  59 examples/sources.list: examples/sources.list.in apt-verbatim.ent
  60         sed -e 's#&stable-codename;#$(shell grep --max-count=1 '^<!ENTITY stable-codename "' apt-verbatim.ent | cut -d'"' -f 2)#g' examples/sources.list.in > examples/sources.list
  61
  62 # Examples
  63 SOURCE = examples/apt.conf examples/sources.list examples/configure-index examples/apt-https-method-example.conf
  64 TO = $(DOC)
  65 TARGET = binary
  66 include $(COPY_H)
  67
  68 .PHONY: clean clean-subdirs veryclean veryclean-subdirs all binary doc
  69
  70 clean: clean-subdirs
  71 veryclean: veryclean-subdirs
  72
  73 clean-subdirs:
  74         for dir in $(SUBDIRS); do\
  75                 $(MAKE) -C $$dir clean; \
  76         done
  77
  78 veryclean-subdirs:
  79         for dir in $(SUBDIRS); do\
  80                 rm -rf $$dir; \
  81         done
  82
  83 .PHONY: update-po po4a stats
  84
  85 ifdef PO4A
  86 doc: po4a
  87
  88 update-po:
  89         po4a --previous --no-backups --force --no-translations \
  90                 --package-name='$(PACKAGE)-doc' --package-version='$(PACKAGE_VERSION)' \
  91                 --msgid-bugs-address='$(PACKAGE_MAIL)' po4a.conf
  92
  93 po4a:
  94         po4a --previous --no-backups \
  95                 --package-name='$(PACKAGE)-doc' --package-version='$(PACKAGE_VERSION)' \
  96                 --msgid-bugs-address='$(PACKAGE_MAIL)' po4a.conf
  97 endif
  98
  99 stats:
 100         for i in po/*.po; do echo -n "$$i: "; msgfmt --output-file=/dev/null --statistics $$i; done
 101
 102 ifdef DOXYGEN
 103 DOXYGEN_SOURCES = $(shell find $(BASE)/apt-pkg -not -name .\\\#* -and \( -name \*.cc -or -name \*.h \) )
 104
 105 clean: doxygen-clean
 106
 107 doxygen-clean:
 108         rm -fr $(BUILD)/doc/doxygen
 109         rm -f $(BUILD)/doc/doxygen-stamp
 110
 111 $(BUILD)/doc/doxygen-stamp: $(DOXYGEN_SOURCES) $(BUILD)/doc/Doxyfile
 112         rm -fr $(BUILD)/doc/doxygen
 113         mkdir $(BUILD)/doc/doxygen  # some versions seem to not create this directory #628799
 114         $(DOXYGEN) $(BUILD)/doc/Doxyfile
 115         touch $(BUILD)/doc/doxygen-stamp
 116
 117 doc: $(BUILD)/doc/doxygen-stamp
 118 endif