blob: 5cc3d42912b139961e000f60fea404e9cf36ae61 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
|
#!/bin/bash
#
# Doxygen Doc generation
#
# binaries that we need
which doxygen > /dev/null 2>&1 || {
echo "You need doxygen for doc generation"
exit 1
}
which dot > /dev/null 2>&1 || {
echo "You need the graphviz tools to create the nice inheritance graphs"
exit 1
}
# otherwise, aliases are not expanded below
shopt -s expand_aliases
# Title of the documentation
DOXYGEN_PROJECT_PREFIX="LibreOffice"
# suck setup
BINDIR=`dirname $0`
. $BINDIR/setup
. ./*.Set.sh
# get list of modules in build order - bah, blows RAM & disk, static list below
INPUT_PROJECTS="o3tl basegfx basebmp comphelper svl vcl canvas cppcanvas oox svtools goodies drawinglayer xmloff slideshow sfx2 editeng svx writerfilter cui chart2 dbaccess sd starmath sc sw"
# output directory for generated documentation
BASE_OUTPUT="$1"
mkdir -p "$BASE_OUTPUT" || {
echo "Cannot create $BASE_OUTPUT"
exit 1
}
# paths for binary and configuration file
BASE_PATH=`pwd`
DOXYGEN_CFG="$2"
if test ! -f "$DOXYGEN_CFG"; then
echo "doxygen.cfg not found"
exit 1
fi
# strip -I. and bin -I prefix; exlude system headers
DOXYGEN_INCLUDE_PATH=`echo $SOLARINC | sed -e ' s/-I\.//'g | sed -e ' s/ -I/ /'g | sed -e ' s|/usr/[^ ]*| |g'`
# setup version string
DOXYGEN_VERSION="$GITTAG"
###################################################
#
# Generate docs
#
###################################################
# cleanup
rm -rf $BASE_OUTPUT/*
# make the stuff world-readable
umask 022
# generate docs
DOXYGEN_REF_TAGFILES=""
for PROJECT in `echo $INPUT_PROJECTS|tr ' ' '\n'|sort|tr '\n' ' '`;
do
# avoid processing of full project subdirs, only add source and inc
DOXYGEN_INPUT=`printf "%s" "$PROJECT/source $PROJECT/inc "`
DOXYGEN_OUTPUT="$BASE_OUTPUT/$PROJECT"
DOXYGEN_OUR_TAGFILE="$DOXYGEN_OUTPUT/$PROJECT.tags"
DOXYGEN_PROJECTNAME="$DOXYGEN_PROJECT_PREFIX Module $PROJECT"
# export variables referenced in doxygen config file
export DOXYGEN_INPUT
export DOXYGEN_OUTPUT
export DOXYGEN_INCLUDE_PATH
export DOXYGEN_VERSION
export DOXYGEN_OUR_TAGFILE
export DOXYGEN_REF_TAGFILES
export DOXYGEN_PROJECTNAME
# debug
echo "Calling $DOXYGEN_PATH/doxygen $DOXYGEN_CFG with"
echo "Input: $DOXYGEN_INPUT"
echo "Output: $DOXYGEN_OUTPUT"
echo "Include: $DOXYGEN_INCLUDE_PATH"
echo "Version: $DOXYGEN_VERSION"
echo "Tagfile: $DOXYGEN_OUR_TAGFILE"
echo "Ref-Tags: $DOXYGEN_REF_TAGFILES"
echo "Title: $DOXYGEN_PROJECTNAME"
nice -15 doxygen "$DOXYGEN_CFG"
# setup referenced tagfiles for next round
DOXYGEN_REF_TAGFILES="$DOXYGEN_REF_TAGFILES $DOXYGEN_OUR_TAGFILE=$BASE_URL/$PROJECT/html"
done
# generate entry page
cat - > $BASE_OUTPUT/index.html <<EOF
<!DOCTYPE HTML PUBLIC "-//IETF//DTD HTML//EN">
<html>
<head>
<title>LibreOffice Source Code Documentation (fragmentary)</title>
</head>
<body>
<h1>LibreOffice Source Code Documentation (fragmentary)</h1>
<ul>
EOF
for PROJECT in $INPUT_PROJECTS;
do
echo "<li><a href=\"$PROJECT/html/classes.html\">$PROJECT</a></li>" >> $BASE_OUTPUT/index.html
done
cat - >> $BASE_OUTPUT/index.html <<EOF
</ul>
<p>Last updated:
EOF
LANG= date >> $BASE_OUTPUT/index.html
cat - >> $BASE_OUTPUT/index.html <<EOF
</p>
</body>
</html>
EOF
## done
|
