| #!/bin/sh |
| |
| # Generate HTML documentation from GCC Texinfo docs. |
| # This version is for GCC 3.1 and later versions. |
| |
| set -e |
| |
| # Run this from /tmp. |
| SVNROOT=${SVNROOT:-"file:///svn/gcc"} |
| export SVNROOT |
| |
| PATH=/usr/local/bin:$PATH |
| |
| MANUALS="cpp |
| cppinternals |
| fastjar |
| gcc |
| gccgo |
| gccint |
| gcj |
| gfortran |
| gfc-internals |
| gnat_ug_unx |
| gnat_ug_vms |
| gnat_ug_vxw |
| gnat_ug_wnt |
| gnat_ugn_unw |
| gnat-style |
| gnat_rm |
| libgomp |
| libquadmath |
| libiberty |
| porting" |
| |
| WWWBASE=/www/gcc/htdocs |
| WWWBASE_PREFORMATTED=/www/gcc/htdocs-preformatted |
| WWWPREPROCESS='/www/gcc/bin/preprocess -r' |
| |
| # Process options -rrelease and -ddirectory |
| RELEASE="" |
| SUBDIR="" |
| |
| while [ $# -gt 0 ]; do |
| case $1 in |
| -r*) |
| if [ -n "$RELEASE" ]; then |
| echo "Multiple releases specified" >&2 |
| exit 1 |
| fi |
| RELEASE="${1#-r}" |
| if [ -z "$RELEASE" ]; then |
| shift |
| RELEASE="$1" |
| if [ -z "$RELEASE" ]; then |
| echo "No release specified with -r" >&2 |
| exit 1 |
| fi |
| fi |
| ;; |
| -d*) |
| if [ -n "$SUBDIR" ]; then |
| echo "Multiple subdirectories specified" >&2 |
| exit 1 |
| fi |
| SUBDIR="${1#-d}" |
| if [ -z "$SUBDIR" ]; then |
| shift |
| SUBDIR="$1" |
| if [ -z "$SUBDIR" ]; then |
| echo "No subdirectory specified with -d" >&2 |
| exit 1 |
| fi |
| fi |
| ;; |
| *) |
| echo "Unknown argument \"$1\"" >&2 |
| exit 1 |
| ;; |
| esac |
| shift |
| done |
| |
| if [ -n "$RELEASE" ] && [ -z "$SUBDIR" ]; then |
| echo "Release specified without subdirectory" >&2 |
| exit 1 |
| fi |
| |
| if [ -z "$SUBDIR" ]; then |
| DOCSDIR=$WWWBASE/onlinedocs |
| else |
| DOCSDIR=$WWWBASE/onlinedocs/$SUBDIR |
| fi |
| |
| if [ ! -d $DOCSDIR ]; then |
| mkdir $DOCSDIR |
| chmod g+w $DOCSDIR |
| fi |
| |
| if [ -z "$RELEASE" ]; then |
| RELEASE=trunk |
| fi |
| |
| WORKDIR=/tmp/gcc-doc-update.$$ |
| |
| rm -rf $WORKDIR |
| mkdir $WORKDIR |
| cd $WORKDIR |
| if [ "$RELEASE" = "trunk" ]; then |
| svn -q export $SVNROOT/$RELEASE gcc |
| else |
| svn -q export $SVNROOT/tags/$RELEASE gcc |
| fi |
| |
| # Remove all unwanted files. This is needed (a) to build the Ada |
| # generator programs with the installed library, not the new one and |
| # (b) to avoid packaging all the sources instead of only documentation |
| # sources. |
| find gcc -type f \( -name '*.texi' \ |
| -o -path gcc/gcc/doc/install.texi2html \ |
| -o -path gcc/gcc/doc/include/texinfo.tex \ |
| -o -path gcc/gcc/ada/xgnatugn.adb \ |
| -o -path gcc/gcc/ada/ug_words \ |
| -o -path gcc/gcc/BASE-VER \ |
| -o -path gcc/gcc/DEV-PHASE \ |
| -o -print0 \) | xargs -0 rm -f |
| |
| # Build a tarball of the sources. |
| tar cf docs-sources.tar gcc |
| |
| # The directory to pass to -I; this is the one with texinfo.tex |
| # and fdl.texi. |
| includedir=gcc/gcc/doc/include |
| |
| # Generate gnat_ugn_unw |
| |
| if [ -f gcc/gcc/ada/xgnatugn.adb ]; then |
| gnatmake -q gcc/gcc/ada/xgnatugn |
| ./xgnatugn unw gcc/gcc/ada/gnat_ugn.texi \ |
| gcc/gcc/ada/ug_words gnat_ugn_unw.texi |
| fi |
| |
| # Generate gcc-vers.texi. |
| ( |
| echo "@set version-GCC $(cat gcc/gcc/BASE-VER)" |
| if [ "$(cat gcc/gcc/DEV-PHASE)" = "experimental" ]; then |
| echo "@set DEVELOPMENT" |
| else |
| echo "@clear DEVELOPMENT" |
| fi |
| echo "@set srcdir $WORKDIR/gcc/gcc" |
| echo "@set VERSION_PACKAGE (GCC)" |
| echo "@set BUGURL @uref{http://gcc.gnu.org/bugs/}" |
| ) > $includedir/gcc-vers.texi |
| |
| # Generate libquadmath-vers.texi. |
| echo "@set BUGURL @uref{http://gcc.gnu.org/bugs/}" \ |
| > $includedir/libquadmath-vers.texi |
| |
| # Now convert the relevant files from texi to HTML, PDF and PostScript. |
| for file in $MANUALS; do |
| filename=`find . -name ${file}.texi` |
| if [ "${filename}" ]; then |
| includes="-I ${includedir} -I `dirname ${filename}`" |
| if [ "$file" = "gnat_ugn_unw" ]; then |
| includes="$includes -I gcc/gcc/ada" |
| fi |
| makeinfo --html $includes -o ${file} ${filename} |
| tar cf ${file}-html.tar ${file}/*.html |
| texi2dvi $includes -o ${file}.dvi ${filename} </dev/null >/dev/null && dvips -o ${file}.ps ${file}.dvi |
| texi2pdf $includes -o ${file}.pdf ${filename} </dev/null |
| mkdir -p $DOCSDIR/$file |
| fi |
| done |
| |
| # Work around makeinfo generated file names and references with |
| # "_002d" instead of "-". |
| find . -name '*.html' | while read f; do |
| # Do this for the contents of each file. |
| sed -i -e 's/_002d/-/g' "$f" |
| # And rename files if necessary. |
| ff=`echo $f | sed -e 's/_002d/-/g'`; |
| if [ "$f" != "$ff" ]; then |
| printf "Renaming %s to %s\n" "$f" "$ff" |
| mv "$f" "$ff" |
| fi |
| done |
| |
| # Then build a gzipped copy of each of the resulting .html, .ps and .tar files |
| for file in */*.html *.ps *.pdf *.tar; do |
| cat $file | gzip --best > $file.gz |
| done |
| |
| # On the 15th of the month, wipe all the old files from the |
| # web server. |
| today=`date +%d` |
| if test $today = 15; then |
| find $DOCSDIR -type f -maxdepth 1 -print | grep -v index.html | xargs rm |
| for m in $MANUALS; do |
| rm -f $DOCSDIR/$m/*.html $DOCSDIR/$m/*.html.gz |
| done |
| fi |
| |
| # And copy the resulting files to the web server |
| for file in */*.html *.ps *.pdf *.tar; do |
| if [ -f $DOCSDIR/$file ]; then |
| cat $DOCSDIR/$file | |
| sed -e '/^<meta name=generator/d' \ |
| -e '/^%DVIPSSource:/d' > file1 |
| fi |
| cat $file | |
| sed -e '/^<meta name=generator/d' \ |
| -e '/^%DVIPSSource:/d' > file2 |
| if cmp -s file1 file2; then |
| : |
| else |
| cp $file $DOCSDIR/$file |
| cp $file.gz $DOCSDIR/$file.gz |
| fi |
| done |
| |
| cd $DOCSDIR |
| |
| # Finally, generate the installation documentation |
| if [ "$RELEASE" = "trunk" ]; then |
| SOURCEDIR=$WORKDIR/gcc/gcc/doc |
| DESTDIR=$WWWBASE_PREFORMATTED/install |
| export SOURCEDIR |
| export DESTDIR |
| $WORKDIR/gcc/gcc/doc/install.texi2html |
| |
| # Preprocess the entire web site, not just the install docs! |
| echo "Invoking $WWWPREPROCESS" |
| $WWWPREPROCESS |grep -v '^ Warning: Keeping' |
| fi |
| |
| # Clean up behind us. |
| |
| rm -rf $WORKDIR |