gmyth-upnp/aminclude.am
branchtrunk
changeset 272 8cab5caf8d09
     1.1 --- /dev/null	Thu Jan 01 00:00:00 1970 +0000
     1.2 +++ b/gmyth-upnp/aminclude.am	Wed Jan 17 20:08:44 2007 +0000
     1.3 @@ -0,0 +1,186 @@
     1.4 +# Copyright (C) 2004 Oren Ben-Kiki
     1.5 +# This file is distributed under the same terms as the Automake macro files.
     1.6 +
     1.7 +# Generate automatic documentation using Doxygen. Goals and variables values
     1.8 +# are controlled by the various DX_COND_??? conditionals set by autoconf.
     1.9 +#
    1.10 +# The provided goals are:
    1.11 +# doxygen-doc: Generate all doxygen documentation.
    1.12 +# doxygen-run: Run doxygen, which will generate some of the documentation
    1.13 +#              (HTML, CHM, CHI, MAN, RTF, XML) but will not do the post
    1.14 +#              processing required for the rest of it (PS, PDF, and some MAN).
    1.15 +# doxygen-man: Rename some doxygen generated man pages.
    1.16 +# doxygen-ps: Generate doxygen PostScript documentation.
    1.17 +# doxygen-pdf: Generate doxygen PDF documentation.
    1.18 +#
    1.19 +# Note that by default these are not integrated into the automake goals. If
    1.20 +# doxygen is used to generate man pages, you can achieve this integration by
    1.21 +# setting man3_MANS to the list of man pages generated and then adding the
    1.22 +# dependency:
    1.23 +#
    1.24 +#   $(man3_MANS): doxygen-doc
    1.25 +#
    1.26 +# This will cause make to run doxygen and generate all the documentation.
    1.27 +#
    1.28 +# The following variable is intended for use in Makefile.am:
    1.29 +#
    1.30 +# DX_CLEANFILES = everything to clean.
    1.31 +#
    1.32 +# This is usually added to MOSTLYCLEANFILES.
    1.33 +
    1.34 +## --------------------------------- ##
    1.35 +## Format-independent Doxygen rules. ##
    1.36 +## --------------------------------- ##
    1.37 +
    1.38 +if DX_COND_doc
    1.39 +
    1.40 +## ------------------------------- ##
    1.41 +## Rules specific for HTML output. ##
    1.42 +## ------------------------------- ##
    1.43 +
    1.44 +if DX_COND_html
    1.45 +
    1.46 +DX_CLEAN_HTML = @DX_DOCDIR@/html
    1.47 +
    1.48 +endif DX_COND_html
    1.49 +
    1.50 +## ------------------------------ ##
    1.51 +## Rules specific for CHM output. ##
    1.52 +## ------------------------------ ##
    1.53 +
    1.54 +if DX_COND_chm
    1.55 +
    1.56 +DX_CLEAN_CHM = @DX_DOCDIR@/chm
    1.57 +
    1.58 +if DX_COND_chi
    1.59 +
    1.60 +DX_CLEAN_CHI = @DX_DOCDIR@/@PACKAGE@.chi
    1.61 +
    1.62 +endif DX_COND_chi
    1.63 +
    1.64 +endif DX_COND_chm
    1.65 +
    1.66 +## ------------------------------ ##
    1.67 +## Rules specific for MAN output. ##
    1.68 +## ------------------------------ ##
    1.69 +
    1.70 +if DX_COND_man
    1.71 +
    1.72 +DX_CLEAN_MAN = @DX_DOCDIR@/man
    1.73 +
    1.74 +endif DX_COND_man
    1.75 +
    1.76 +## ------------------------------ ##
    1.77 +## Rules specific for RTF output. ##
    1.78 +## ------------------------------ ##
    1.79 +
    1.80 +if DX_COND_rtf
    1.81 +
    1.82 +DX_CLEAN_RTF = @DX_DOCDIR@/rtf
    1.83 +
    1.84 +endif DX_COND_rtf
    1.85 +
    1.86 +## ------------------------------ ##
    1.87 +## Rules specific for XML output. ##
    1.88 +## ------------------------------ ##
    1.89 +
    1.90 +if DX_COND_xml
    1.91 +
    1.92 +DX_CLEAN_XML = @DX_DOCDIR@/xml
    1.93 +
    1.94 +endif DX_COND_xml
    1.95 +
    1.96 +## ----------------------------- ##
    1.97 +## Rules specific for PS output. ##
    1.98 +## ----------------------------- ##
    1.99 +
   1.100 +if DX_COND_ps
   1.101 +
   1.102 +DX_CLEAN_PS = @DX_DOCDIR@/@PACKAGE@.ps
   1.103 +
   1.104 +DX_PS_GOAL = doxygen-ps
   1.105 +
   1.106 +doxygen-ps: @DX_DOCDIR@/@PACKAGE@.ps
   1.107 +
   1.108 +@DX_DOCDIR@/@PACKAGE@.ps: @DX_DOCDIR@/@PACKAGE@.tag
   1.109 +	cd @DX_DOCDIR@/latex; \
   1.110 +	rm -f *.aux *.toc *.idx *.ind *.ilg *.log *.out; \
   1.111 +	$(DX_LATEX) refman.tex; \
   1.112 +	$(MAKEINDEX_PATH) refman.idx; \
   1.113 +	$(DX_LATEX) refman.tex; \
   1.114 +	countdown=5; \
   1.115 +	while $(DX_EGREP) 'Rerun (LaTeX|to get cross-references right)' \
   1.116 +	                  refman.log > /dev/null 2>&1 \
   1.117 +	   && test $$countdown -gt 0; do \
   1.118 +	    $(DX_LATEX) refman.tex; \
   1.119 +	    countdown=`expr $$countdown - 1`; \
   1.120 +	done; \
   1.121 +	$(DX_DVIPS) -o ../@PACKAGE@.ps refman.dvi
   1.122 +
   1.123 +endif DX_COND_ps
   1.124 +
   1.125 +## ------------------------------ ##
   1.126 +## Rules specific for PDF output. ##
   1.127 +## ------------------------------ ##
   1.128 +
   1.129 +if DX_COND_pdf
   1.130 +
   1.131 +DX_CLEAN_PDF = @DX_DOCDIR@/@PACKAGE@.pdf
   1.132 +
   1.133 +DX_PDF_GOAL = doxygen-pdf
   1.134 +
   1.135 +doxygen-pdf: @DX_DOCDIR@/@PACKAGE@.pdf
   1.136 +
   1.137 +@DX_DOCDIR@/@PACKAGE@.pdf: @DX_DOCDIR@/@PACKAGE@.tag
   1.138 +	cd @DX_DOCDIR@/latex; \
   1.139 +	rm -f *.aux *.toc *.idx *.ind *.ilg *.log *.out; \
   1.140 +	$(DX_PDFLATEX) refman.tex; \
   1.141 +	$(DX_MAKEINDEX) refman.idx; \
   1.142 +	$(DX_PDFLATEX) refman.tex; \
   1.143 +	countdown=5; \
   1.144 +	while $(DX_EGREP) 'Rerun (LaTeX|to get cross-references right)' \
   1.145 +	                  refman.log > /dev/null 2>&1 \
   1.146 +	   && test $$countdown -gt 0; do \
   1.147 +	    $(DX_PDFLATEX) refman.tex; \
   1.148 +	    countdown=`expr $$countdown - 1`; \
   1.149 +	done; \
   1.150 +	mv refman.pdf ../@PACKAGE@.pdf
   1.151 +
   1.152 +endif DX_COND_pdf
   1.153 +
   1.154 +## ------------------------------------------------- ##
   1.155 +## Rules specific for LaTeX (shared for PS and PDF). ##
   1.156 +## ------------------------------------------------- ##
   1.157 +
   1.158 +if DX_COND_latex
   1.159 +
   1.160 +DX_CLEAN_LATEX = @DX_DOCDIR@/latex
   1.161 +
   1.162 +endif DX_COND_latex
   1.163 +
   1.164 +.PHONY: doxygen-run doxygen-doc $(DX_PS_GOAL) $(DX_PDF_GOAL)
   1.165 +
   1.166 +.INTERMEDIATE: doxygen-run $(DX_PS_GOAL) $(DX_PDF_GOAL)
   1.167 +
   1.168 +doxygen-run: @DX_DOCDIR@/@PACKAGE@.tag
   1.169 +
   1.170 +doxygen-doc: doxygen-run $(DX_PS_GOAL) $(DX_PDF_GOAL)
   1.171 +
   1.172 +@DX_DOCDIR@/@PACKAGE@.tag: $(DX_CONFIG) $(pkginclude_HEADERS)
   1.173 +	rm -rf @DX_DOCDIR@
   1.174 +	$(DX_ENV) $(DX_DOXYGEN) $(srcdir)/$(DX_CONFIG)
   1.175 +
   1.176 +DX_CLEANFILES = \
   1.177 +    @DX_DOCDIR@/@PACKAGE@.tag \
   1.178 +    -r \
   1.179 +    $(DX_CLEAN_HTML) \
   1.180 +    $(DX_CLEAN_CHM) \
   1.181 +    $(DX_CLEAN_CHI) \
   1.182 +    $(DX_CLEAN_MAN) \
   1.183 +    $(DX_CLEAN_RTF) \
   1.184 +    $(DX_CLEAN_XML) \
   1.185 +    $(DX_CLEAN_PS) \
   1.186 +    $(DX_CLEAN_PDF) \
   1.187 +    $(DX_CLEAN_LATEX)
   1.188 +
   1.189 +endif DX_COND_doc