3 # Simplistic script to rebuild our documentation with sphinx-build
7 if [ "x$1" != 'xdoxy' -a -e build/xml ] ; then
8 echo "Doxygen not rerun: 'doxy' was not provided as an argument"
10 rm -rf build/xml source/api/
11 cd source; doxygen; cd ..
14 if [ "x$1" != 'xjava' -a -e source/java ] ; then
15 echo "javasphinx not rerun: 'java' was not provided as an argument"
18 javasphinx-apidoc --force -o source/java/ ../src/bindings/java/org/simgrid/msg
19 rm source/java/packages.rst # source/java/org/simgrid/msg/package-index.rst
20 # sed -i 's/^.. java:type:: public class /.. java:type:: public class org.simgrid.msg/' source/java/org/simgrid/msg/*
21 echo "javasphinx relaunched"
24 sphinx-build -M html source build ${SPHINXOPTS}
25 cat source/img/graphical-toc.svg \
26 | perl -pe 's/(xlink:href="http)/target="_top" $1/' \
27 | perl -pe 's/(xlink:href=".*?.html)/target="_top" $1/' \
28 > build/html/graphical-toc.svg
31 echo "List of missing references:"
32 for f in `(grep '<name>' build/xml/msg_8h.xml; \
33 grep '<name>' build/xml/namespacesimgrid_1_1s4u.xml; \
34 grep '<innerclass refid=' build/xml/namespacesimgrid_1_1s4u.xml ; \
35 ) |sed 's/<[^>]*>//g'|sort`
38 if grep $f source/*rst | grep -q '.. doxygen[^::]*:: '"$f"'$' ||
39 grep $f source/*rst | grep -q '.. doxygen[^::]*:: simgrid::[^:]*::[^:]*::'"$f"'$' ; then :
40 # echo "$f documented"
42 if grep -q $f ignored_symbols ; then :
43 # echo "$f ignored" # not documented