X-Git-Url: http://info.iut-bm.univ-fcomte.fr/pub/gitweb/simgrid.git/blobdiff_plain/a39a45af5e19dfb8b8ed2cb084b3a6b518d179e4..dc27f1fad419d56167e1755e9af4b183468a5139:/docs/Build.sh diff --git a/docs/Build.sh b/docs/Build.sh index 74bcbfd3a0..acdcd0a2e5 100755 --- a/docs/Build.sh +++ b/docs/Build.sh @@ -2,9 +2,47 @@ # # Simplistic script to rebuild our documentation with sphinx-build -rm -rf build/doxy/ source/api/ +set -e + +if [ "x$1" != 'xdoxy' -a -e build/xml ] ; then + echo "Doxygen not rerun: 'doxy' was not provided as an argument" +else + rm -rf build/xml source/api/ + cd source; doxygen; cd .. +fi + +if [ "x$1" != 'xjava' -a -e source/java ] ; then + echo "javasphinx not rerun: 'java' was not provided as an argument" +else + rm -rf source/java + javasphinx-apidoc --force -o source/java/ ../src/bindings/java/org/simgrid/msg + rm source/java/packages.rst # source/java/org/simgrid/msg/package-index.rst +# sed -i 's/^.. java:type:: public class /.. java:type:: public class org.simgrid.msg/' source/java/org/simgrid/msg/* + echo "javasphinx relaunched" +fi + sphinx-build -M html source build ${SPHINXOPTS} cat source/img/graphical-toc.svg \ | perl -pe 's/(xlink:href="http)/target="_top" $1/' \ | perl -pe 's/(xlink:href=".*?.html)/target="_top" $1/' \ > build/html/graphical-toc.svg + + +echo "List of missing references:" +for f in `(grep '' build/xml/msg_8h.xml; \ + grep '' build/xml/namespacesimgrid_1_1s4u.xml; \ + grep ']*>//g'|sort` +do + + if grep $f source/*rst | grep -q '.. doxygen[^::]*:: '"$f"'$' || + grep $f source/*rst | grep -q '.. doxygen[^::]*:: simgrid::[^:]*::[^:]*::'"$f"'$' ; then : +# echo "$f documented" + else + if grep -q $f ignored_symbols ; then : +# echo "$f ignored" # not documented + else + echo "$f" + fi + fi +done \ No newline at end of file