Skip to content
Snippets Groups Projects
Commit ba0f0db9 authored by Oliver Sander's avatar Oliver Sander Committed by sander@FU-BERLIN.DE
Browse files

update build system to build the doxygen documentation the proper dune 2.0...

update build system to build the doxygen documentation the proper dune 2.0 way.  This fixes a bug that prevented building this module against an installed dune-common

[[Imported from SVN: r272]]
parent 6dea2450
Branches
No related tags found
No related merge requests found
INPUT += ../../subgrid ../../KnownIssues ../../MainPage
EXCLUDE +=
EXAMPLE_PATH +=
EXAMPLE_PATTERNS +=
IMAGE_PATH +=
PREDEFINED +=
# $Id: Makefile.am 808 2007-08-17 06:12:57Z christi $
if BUILD_DOCS
DOXYGENTAG = doxygen-tag
DOXYGEN_HTML = html
DOXYGEN_DIST = html-dist
endif
DISTCLEANFILES = doxygen.log doxygen-tag
all: $(DOXYGEN_HTML)
# setting like in dune-web
BASEDIR=../..
CURDIR=doc/doxygen
EXTRAINSTALL = doxygen.log
# EXTRAINSTALL in the html subdirectory
DOXYGENINSTALL = *.html *.css *.png *.gif
if WML
# themeing doxygen
DOXYGENHEADER = doxy-header.html
DOXYGENHEADERBUILD = $(DOXYGENHEADER).build
DOXYGENFOOTER = doxy-footer.html
DOXYGENSTYLESHEET = dune-doxy.css
DOYXFILE_OVERWRITE = echo "HTML_HEADER = $(DOXYGENHEADER)"; \
echo "HTML_FOOTER = $(DOXYGENFOOTER)"; \
echo "HTML_STYLESHEET = $(DOXYGENSTYLESHEET)";
DOXYFILESHORT_OVERWRITE = $(DOYXFILE_OVERWRITE) \
echo "SHORT_NAMES = YES";
endif
#we need this in the distribution
EXTRA_DIST = $(WHAT) $(DOXYGEN_DIST) $(DOXYGENHEADER) doxy-footer.html $(PAGES)
doxygendir = $(datadir)/doc/dune-subgrid/doxygen
doxygen_DATA = $(WHAT)
install-data-local: html-dist
$(mkinstalldirs) $(DESTDIR)/$(doxygendir); \
list="$(srcdir)/html-dist/*.html $(srcdir)/html-dist/*.css $(srcdir)/html-dist/*.png $(srcdir)/html-dist/*.gif"; \
for p in $$list; do \
$(install_sh_DATA) $$p $(DESTDIR)/$(doxygendir); \
done
uninstall-local:
rm -f $(DESTDIR)/$(doxygendir)/*.html
rm -f $(DESTDIR)/$(doxygendir)/*.css
rm -f $(DESTDIR)/$(doxygendir)/*.png
rm -f $(DESTDIR)/$(doxygendir)/*.gif
# what files does the doxygen-generated stuff depend on (find-syntax)
DEPENDON = -name \*.cc -o -name \*.hh -o -name \*.png
# as all doxygen files fill be installed in the html subdirectory
# the BASEDIR has to be adjusted
%.build: FORCE
$(MAKE) $* BASEDIR=../../..
# check dependency ourself to be robust
doxygen-tag: FORCE $(DOXYGENHEADERBUILD)
set -e; \
if test -e Doxyfile; then \
if test ! -e doxygen-tag || test x"`find $(top_srcdir) \( $(DEPENDON) \) -a -cnewer doxygen-tag -print`" != x ; then \
echo Running doxygen. This may take a while... ; \
( cat Doxyfile; $(DOYXFILE_OVERWRITE) ) > Doxyfile.tmp; \
$(DOXYGEN) Doxyfile.tmp > doxygen.log 2>&1 <&- ; \
rm -f Doxyfile.tmp; \
touch doxygen-tag ; \
fi; \
fi
html: doxygen-tag
html-dist: $(DOXYGENHEADERBUILD)
rm -rf html
set -e; \
if test -e Doxyfile; then \
( cat Doxyfile; $(DOXYFILESHORT_OVERWRITE) ) > Doxyfile.tmp; \
echo Running doxygen. This may take a while... ; \
$(DOXYGEN) Doxyfile.tmp > doxygen.log 2>&1 <&- ; \
rm -f Doxyfile.tmp; \
fi
if test -d html; then rm -rf html-dist; mv html html-dist; fi
# how to install the doxygen documentation
doxygen-install:
if test -d $(DUNEWEBDIR) && test -r $(DUNEWEBDIR)/Make.global ; then \
pushd html; \
$(MAKE) -f $(DUNEWEBDIR)/Make.global \
EXTRAINSTALL="$(DOXYGENINSTALL)" CURDIR="$(CURDIR)/dune-subgrid-html" install ; \
popd; \
fi
web-install: doxygen-install
# nice trick from the GNU make infopage to force a rule to run
FORCE:
include $(top_srcdir)/am/webstuff
# file to clean only in svn and not in tarball tree
SVNCLEANFILES = html html-dist $(WHAT) $(DOXYGENHEADER)
clean-local:
if test -e $(top_srcdir)/doc/doxygen/Doxydep; then rm -rf $(SVNCLEANFILES);fi
rm -rf latex *~
CLEANFILES = $(DOXYGENTAG)
include $(top_srcdir)/am/doxygen
include $(top_srcdir)/am/global-rules
</div> <!-- end doxygen -->
</div> <!-- end main -->
<div class="foot">
<p class="foot">
Generated on $date with <a
href="http://www.doxygen.org/">Doxygen</a> (ver $doxygenversion)
</p>
</div>
</body>
</html>
\ No newline at end of file
# -*- html -*-
# $Id: doxy-header.wml 368 2005-10-14 13:08:07Z christi $
## praktische Tags
#use wml::std::tags
#use wml::layout::header title="$projectname - $title"
#use wml::layout::navigation
<enter STYLESHEETS>
<link rel="stylesheet" type="text/css" href="./dune-doxy.css">
<link rel="stylesheet" type="text/css" href="./tabs.css">
<leave>
<div class="main">
<div class="doxygen">
/* $Id: dune-doxy.css 361 2005-10-13 14:57:34Z christi $ */
div.nav {
padding: 5px;
margin: 0pt;
display: block;
background-color: #c8d5ff;
text-decoration: none;
border-top: 1px solid #5974b5;
border-left: 1px solid #5974b5;
border-right: 1px solid #5974b5;
border-bottom: 1px solid #5974b5;
font-family: sans-serif;
font-weight: bold;
text-align: center;
color: black;
}
div.doxygen h1 {
font-family: sans-serif;
font-weight: bold;
text-align: left;
text-align: center;
font-size: 160%;
border: none;
color: black;
background-color: white;
}
div.doxygen h2 {
font-family: sans-serif;
font-weight: bold;
text-align: left;
font-size: 130%;
border: none;
color: black;
background-color: white;
}
div.doxygen h3 {
font-family: sans-serif;
font-weight: bold;
text-align: left;
font-size: 110%;
border: none;
color: black;
background-color: white;
}
div.doxygen h4 {
font-family: sans-serif;
font-weight: bold;
text-align: left;
font-size: 110%;
border: none;
color: black;
background-color: white;
}
caption { font-weight: bold }
a.anchor,
a.anchor:visited,
a.anchor:hover,
a.anchor:active
{
background-color: white;
color: black;
}
hr {
border: 0px;
background-color: #5974b5;
height: 1px;
}
em {
font-style: inherited;
color: #A00000;
}
/*
-- Inner Documentation Links --
*/
a.el { text-decoration: none; font-weight: bold }
a.elRef { font-weight: bold }
a.code:link { text-decoration: none; font-weight: normal; color: #5974b5}
a.code:visited { text-decoration: none; font-weight: normal; color: #5974b5}
a.codeRef:link { font-weight: normal; color: #5974b5}
a.codeRef:visited { font-weight: normal; color: #5974b5}
/*
-- Quick Index --
*/
div.qindex {
/* font-family: Geneva, Arial, Helvetica, sans-serif; */
font-size: small;
font-family: sans-serif;
font-weight: bold;
width: 100%;
/* background-color: #c8d5ff; */
border-bottom: 1px solid black;
text-align: center;
margin: 0px;
padding: 0px;
line-height: 160%;
}
a.qindex {
text-decoration: none;
font-weight: bold;
border: 1px solid #ffffff;
color: #5974b5;
padding: 0px;
}
a.qindex:visited {
text-decoration: none;
font-weight: bold;
color: #5974b5;
}
a.qindex:hover {
text-decoration: none;
background-color: #c8d5ff;
border: 1px solid #000000;
}
a.qindexHL {
text-decoration: none;
font-weight: bold;
background-color: #c8d5ff;
border: 1px solid #c8d5ff;
}
/*
Copy Paste from doxygen.css
-- list layout --
*/
.mdescLeft {
padding: 0px 8px 4px 8px;
/* font-size: 80%; */
font-style: italic;
background-color: #FAFAFA;
border-top: 1px none #E0E0E0;
border-right: 1px none #E0E0E0;
border-bottom: 1px none #E0E0E0;
border-left: 1px none #E0E0E0;
margin: 0px;
}
.mdescRight {
padding: 0px 8px 4px 8px;
/* font-size: 80%; */
font-style: italic;
background-color: #FAFAFA;
border-top: 1px none #E0E0E0;
border-right: 1px none #E0E0E0;
border-bottom: 1px none #E0E0E0;
border-left: 1px none #E0E0E0;
margin: 0px;
}
.memItemLeft {
padding: 1px 0px 0px 8px;
margin: 4px;
border-top-width: 1px;
border-right-width: 1px;
border-bottom-width: 1px;
border-left-width: 1px;
border-top-color: #E0E0E0;
border-right-color: #E0E0E0;
border-bottom-color: #E0E0E0;
border-left-color: #E0E0E0;
border-top-style: solid;
border-right-style: none;
border-bottom-style: none;
border-left-style: none;
background-color: #FAFAFA;
/* font-size: 80%; */
}
.memItemRight {
padding: 1px 8px 0px 8px;
margin: 4px;
border-top-width: 1px;
border-right-width: 1px;
border-bottom-width: 1px;
border-left-width: 1px;
border-top-color: #E0E0E0;
border-right-color: #E0E0E0;
border-bottom-color: #E0E0E0;
border-left-color: #E0E0E0;
border-top-style: solid;
border-right-style: none;
border-bottom-style: none;
border-left-style: none;
background-color: #FAFAFA;
/* font-size: 80%; */
}
.memTemplItemLeft {
padding: 1px 0px 0px 8px;
margin: 4px;
border-top-width: 1px;
border-right-width: 1px;
border-bottom-width: 1px;
border-left-width: 1px;
border-top-color: #E0E0E0;
border-right-color: #E0E0E0;
border-bottom-color: #E0E0E0;
border-left-color: #E0E0E0;
border-top-style: none;
border-right-style: none;
border-bottom-style: none;
border-left-style: none;
background-color: #FAFAFA;
/* font-size: 80%; */
}
.memTemplItemRight {
padding: 1px 8px 0px 8px;
margin: 4px;
border-top-width: 1px;
border-right-width: 1px;
border-bottom-width: 1px;
border-left-width: 1px;
border-top-color: #E0E0E0;
border-right-color: #E0E0E0;
border-bottom-color: #E0E0E0;
border-left-color: #E0E0E0;
border-top-style: none;
border-right-style: none;
border-bottom-style: none;
border-left-style: none;
background-color: #FAFAFA;
/* font-size: 80%; */
}
.memTemplParams {
padding: 1px 0px 0px 8px;
margin: 4px;
border-top-width: 1px;
border-right-width: 1px;
border-bottom-width: 1px;
border-left-width: 1px;
border-top-color: #E0E0E0;
border-right-color: #E0E0E0;
border-bottom-color: #E0E0E0;
border-left-color: #E0E0E0;
border-top-style: solid;
border-right-style: none;
border-bottom-style: none;
border-left-style: none;
color: #606060;
background-color: #FAFAFA;
/* font-size: 80%; */
}
/*
Copy Paste from doxygen.css
-- Member description layout --
*/
.md {
background-color: #F4F4FB;
font-weight: bold;
}
.mdPrefix {
background-color: #F4F4FB;
color: #606060;
/* font-size: 80%; */
}
.mdname1 {
background-color: #F4F4FB;
font-weight: bold;
color: #602020;
}
.mdname {
background-color: #F4F4FB;
font-weight: bold;
color: #602020;
width: 600px;
}
.mdTable {
border: 1px solid #868686;
background-color: #F4F4FB;
}
.mdRow {
padding: 8px 10px;
}
/*
-- Member list layout --
*/
tr.memlist {
background-color: #f0f0f0;
}
/*
-- Directory listing layout --
*/
.dirtab { padding: 4px;
border-collapse: collapse;
border: 1px solid #b0b0b0;
}
th.dirtab { background: #e0e0e0;
font-weight: bold;
}
/*
-- Index Layout --
*/
div.ah {
background-color: #c8d5ff;
text-decoration: none;
border: 1px solid #5974b5;
font-weight: bold;
margin-bottom: 3px; margin-top: 3px
}
.indexkey {
background-color: #e0e0e0;
}
.indexvalue {
background-color: #e0e0e0;
}
/*
-- Formular layout --
*/
p.formulaDsp { text-align: center; }
img.formulaDsp { }
img.formulaInl { vertical-align: middle; }
/*
-- Code colorize --
*/
.fragment {
font-family: Fixed, monospace;
font-size: 95%;
}
pre.fragment {
border: 1px solid #CCCCCC;
background-color: #f5f5f5;
margin-top: 4px;
margin-bottom: 4px;
margin-left: 2px;
margin-right: 8px;
padding-left: 6px;
padding-right: 6px;
padding-top: 4px;
padding-bottom: 4px;
}
span.keyword { color: #008000 }
span.keywordtype { color: #604020 }
span.keywordflow { color: #e08000 }
span.comment { color: #800000 }
span.preprocessor { color: #806020 }
span.stringliteral { color: #002080 }
span.charliteral { color: #008080 }
code {
font-size: 120%;
}
/* tables and lists */
ul { font-size: small; }
table { font-size: small; }
table.imagelist {
margin: 0px auto 0px auto;
border: none;
}
table.imagelist td {
border: none;
padding-left: 5px;
padding-right: 5px;
}
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Please register or to comment