doc/doxygen-include.am

doc/doxygen-include.am
/* */
# ---------------------------------------------------------------------------
# Licensed to the Apache Software Foundation (ASF) under one or more
# contributor license agreements.  See the NOTICE file distributed with
# this work for additional information regarding copyright ownership.
# The ASF licenses this file to You under the Apache License, Version 2.0
# (the "License"); you may not use this file except in compliance with
# the License.  You may obtain a copy of the License at
# 
# http://www.apache.org/licenses/LICENSE-2.0
# 
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
# ---------------------------------------------------------------------------
 
# Copyright (C) 2004 Oren Ben-Kiki
# This file is distributed under the same terms as the Automake macro files.
 
# Generate automatic documentation using Doxygen. Goals and variables values
# are controlled by the various DX_COND_??? conditionals set by autoconf.
#
# The provided goals are:
# doxygen-doc: Generate all doxygen documentation.
# doxygen-run: Run doxygen, which will generate some of the documentation
#              (HTML, CHM, CHI, MAN, RTF, XML) but will not do the post
#              processing required for the rest of it (PS, PDF, and some MAN).
# doxygen-man: Rename some doxygen generated man pages.
# doxygen-ps: Generate doxygen PostScript documentation.
# doxygen-pdf: Generate doxygen PDF documentation.
#
# Note that by default these are not integrated into the automake goals. If
# doxygen is used to generate man pages, you can achieve this integration by
# setting man3_MANS to the list of man pages generated and then adding the
# dependency:
#
#   $(man3_MANS): doxygen-doc
#
# This will cause make to run doxygen and generate all the documentation.
#
# The following variable is intended for use in Makefile.am:
#
# DX_CLEANFILES = everything to clean.
#
# This is usually added to MOSTLYCLEANFILES.
 
## --------------------------------- ##
## Format-independent Doxygen rules. ##
## --------------------------------- ##
 
if DX_COND_doc
 
## ------------------------------- ##
## Rules specific for HTML output. ##
## ------------------------------- ##
 
if DX_COND_html
 
DX_CLEAN_HTML = @DX_DOCDIR@/html
 
endif DX_COND_html
 
## ------------------------------ ##
## Rules specific for CHM output. ##
## ------------------------------ ##
 
if DX_COND_chm
 
DX_CLEAN_CHM = @DX_DOCDIR@/chm
 
if DX_COND_chi
 
DX_CLEAN_CHI = @DX_DOCDIR@/@PACKAGE@.chi
 
endif DX_COND_chi
 
endif DX_COND_chm
 
## ------------------------------ ##
## Rules specific for MAN output. ##
## ------------------------------ ##
 
if DX_COND_man
 
DX_CLEAN_MAN = @DX_DOCDIR@/man
 
endif DX_COND_man
 
## ------------------------------ ##
## Rules specific for RTF output. ##
## ------------------------------ ##
 
if DX_COND_rtf
 
DX_CLEAN_RTF = @DX_DOCDIR@/rtf
 
endif DX_COND_rtf
 
## ------------------------------ ##
## Rules specific for XML output. ##
## ------------------------------ ##
 
if DX_COND_xml
 
DX_CLEAN_XML = @DX_DOCDIR@/xml
 
endif DX_COND_xml
 
## ----------------------------- ##
## Rules specific for PS output. ##
## ----------------------------- ##
 
if DX_COND_ps
 
DX_CLEAN_PS = @DX_DOCDIR@/@PACKAGE@.ps
 
DX_PS_GOAL = doxygen-ps
 
doxygen-ps: @DX_DOCDIR@/@PACKAGE@.ps
 
@DX_DOCDIR@/@PACKAGE@.ps: @DX_DOCDIR@/@PACKAGE@.tag
        cd @DX_DOCDIR@/latex; \
        rm -f *.aux *.toc *.idx *.ind *.ilg *.log *.out; \
        $(DX_LATEX) refman.tex; \
        $(MAKEINDEX_PATH) refman.idx; \
        $(DX_LATEX) refman.tex; \
        countdown=5; \
        while $(DX_EGREP) 'Rerun (LaTeX|to get cross-references right)' \
                          refman.log > /dev/null 2>&1 \
           && test $$countdown -gt 0; do \
            $(DX_LATEX) refman.tex; \
            countdown=`expr $$countdown - 1`; \
        done; \
        $(DX_DVIPS) -o ../@PACKAGE@.ps refman.dvi
 
endif DX_COND_ps
 
## ------------------------------ ##
## Rules specific for PDF output. ##
## ------------------------------ ##
 
if DX_COND_pdf
 
DX_CLEAN_PDF = @DX_DOCDIR@/@PACKAGE@.pdf
 
DX_PDF_GOAL = doxygen-pdf
 
doxygen-pdf: @DX_DOCDIR@/@PACKAGE@.pdf
 
@DX_DOCDIR@/@PACKAGE@.pdf: @DX_DOCDIR@/@PACKAGE@.tag
        cd @DX_DOCDIR@/latex; \
        rm -f *.aux *.toc *.idx *.ind *.ilg *.log *.out; \
        $(DX_PDFLATEX) refman.tex; \
        $(DX_MAKEINDEX) refman.idx; \
        $(DX_PDFLATEX) refman.tex; \
        countdown=5; \
        while $(DX_EGREP) 'Rerun (LaTeX|to get cross-references right)' \
                          refman.log > /dev/null 2>&1 \
           && test $$countdown -gt 0; do \
            $(DX_PDFLATEX) refman.tex; \
            countdown=`expr $$countdown - 1`; \
        done; \
        mv refman.pdf ../@PACKAGE@.pdf
 
endif DX_COND_pdf
 
## ------------------------------------------------- ##
## Rules specific for LaTeX (shared for PS and PDF). ##
## ------------------------------------------------- ##
 
if DX_COND_latex
 
DX_CLEAN_LATEX = @DX_DOCDIR@/latex
 
endif DX_COND_latex
 
.PHONY: doxygen-run doxygen-doc $(DX_PS_GOAL) $(DX_PDF_GOAL)
 
.INTERMEDIATE: doxygen-run $(DX_PS_GOAL) $(DX_PDF_GOAL)
 
doxygen-run: @DX_DOCDIR@/@PACKAGE@.tag
 
doxygen-doc: doxygen-run $(DX_PS_GOAL) $(DX_PDF_GOAL)
 
@DX_DOCDIR@/@PACKAGE@.tag: $(DX_CONFIG) $(pkginclude_HEADERS)
        rm -rf @DX_DOCDIR@
        $(DX_ENV) $(DX_DOXYGEN) $(srcdir)/$(DX_CONFIG)
 
DX_CLEANFILES = \
    @DX_DOCDIR@/@PACKAGE@.tag \
    -r \
    $(DX_CLEAN_HTML) \
    $(DX_CLEAN_CHM) \
    $(DX_CLEAN_CHI) \
    $(DX_CLEAN_MAN) \
    $(DX_CLEAN_RTF) \
    $(DX_CLEAN_XML) \
    $(DX_CLEAN_PS) \
    $(DX_CLEAN_PDF) \
    $(DX_CLEAN_LATEX)
 
endif DX_COND_doc
/* */
root/doc/doxygen-include.am
