Variant of AMK's patch to produce text versions of HOWTO documents.

This ensures that the text version uses latex2html's -split 1 option, without
affecting HTML produced in the same run, and also minimizes the number of
l2h runs needed if --split 1 was used for an HTML run.

diff --git a/Doc/tools/mkhowto.sh b/Doc/tools/mkhowto.sh
index ec480c517db6ced45eee657aeccc7e8ae7ef7fbf..a33f6b468dd3e4c6621737f8b53d33610b7237b8 100755 (executable)
--- a/Doc/tools/mkhowto.sh
+++ b/Doc/tools/mkhowto.sh
@@ -64,12 +64,13 @@ MAX_SPLIT_DEPTH=8
 
 build_html() {
     TEXFILE=`kpsewhich $1.tex`
+    BUILDDIR=${2:-$1}
     latex2html \
      -init_file $L2H_INIT_FILE \
      -init_file $L2H_AUX_INIT_FILE \
-     -dir $1 $TEXFILE || exit $?
+     -dir $BUILDDIR $TEXFILE || exit $?
     if [ "$MAX_SPLIT_DEPTH" -ne 1 ] ; then
-       (cd $1; $MYDIR/node2label.pl *.html) || exit $?
+       (cd $BUILDDIR; $MYDIR/node2label.pl *.html) || exit $?
     fi
 }
 
@@ -127,6 +128,10 @@ build_ps() {
     dvips -N0 -o $1.ps $1 || exit $?
 }
 
+build_text() {
+    lynx -nolist -dump $2/index.html >$1.txt
+}
+
 l2hoption() {
     if [ "$2" ] ; then
        echo "\$$1 = \"$2\";" >>$L2H_AUX_INIT_FILE
@@ -139,6 +144,7 @@ cleanup() {
     if [ ! "$BUILD_DVI" ] ; then
        rm -f $1.dvi
     fi
+    rm -rf $1.temp-html
     rm -f $1/IMG* $1/*.pl $1/WARNINGS $1/index.dat $1/modindex.dat
 }
 
@@ -165,6 +171,11 @@ while [ "$1" ] ; do
            USE_DEFAULT_FORMAT=false
            shift 1
            ;;
+       --text|--tex|--te|--t)
+           BUILD_TEXT=true
+           USE_DEFAULT_FORMAT=false
+           shift 1
+           ;;
        -H|--help|--hel|--he)
            usage 0
            ;;
@@ -220,21 +231,27 @@ while [ "$1" ] ; do
 done
 
 if [ $# = 0 ] ; then
-    usage 2
+    # check for a single .tex file in .
+    COUNT=`ls -1 *.tex | wc -l | sed 's/[      ]//g'`
+    if [ "$COUNT" -eq 1 ] ; then
+       set -- `ls -1 *.tex`
+    else
+       usage 2
+    fi
 fi
 
 if [ $USE_DEFAULT_FORMAT = true ] ; then
     eval "BUILD_$DEFAULT_FORMAT=true"
 fi
 
-if [ "$DEBUGGING" ] ; then
-    set -x
-fi
-
 if [ "$QUIET" ] ; then
     exec >/dev/null
 fi
 
+if [ "$DEBUGGING" ] ; then
+    set -x
+fi
+
 echo '# auxillary init file for latex2html' >$L2H_AUX_INIT_FILE
 echo '# generated by mkhowto.sh -- do no edit' >>$L2H_AUX_INIT_FILE
 l2hoption ICONSERVER "$ICONSERVER"
@@ -255,20 +272,42 @@ for FILE in $@ ; do
     #
     if [ "$BUILD_DVI" -o "$BUILD_PS" ] ; then
        build_dvi $FILE 2>&1 | tee -a $LOGFILE
+       HAVE_TEMPS=true
     fi
     if [ "$BUILD_PDF" ] ; then
        build_pdf $FILE 2>&1 | tee -a $LOGFILE
+       HAVE_TEMPS=true
     fi
     if [ "$BUILD_PS" ] ; then
        build_ps $FILE 2>&1 | tee -a $LOGFILE
     fi
     if [ "$BUILD_HTML" ] ; then
-       if [ ! "$BUILD_DVI" -o ! "$BUILD_PDF" ] ; then
+       if [ ! "$HAVE_TEMPS" ] ; then
+           # need to get aux file
+           build_dvi $FILE 2>&1 | tee -a $LOGFILE
+           HAVE_TEMPS=true
+       fi
+       build_html $FILE $FILE 2>&1 | tee -a $LOGFILE
+    fi
+    if [ "$BUILD_TEXT" ] ; then
+       if [ ! "$HAVE_TEMPS" ] ; then
            # need to get aux file
            build_dvi $FILE 2>&1 | tee -a $LOGFILE
+           HAVE_TEMPS=true
        fi
-       build_html $FILE 2>&1 | tee -a $LOGFILE
+       # this is why building text really has to be last:
+       if [ "$MAX_SPLIT_DEPTH" -ne 1 ] ; then
+           echo '# re-hack this file for --text:' >>$L2H_AUX_INIT_FILE
+           l2hoption MAX_SPLIT_DEPTH 1
+           echo '1;' >>$L2H_AUX_INIT_FILE
+           TEMPDIR=$FILE.temp-html
+           build_html $FILE $TEMPDIR 2>&1 | tee -a $LOGFILE
+       else
+           TEMPDIR=$FILE
+       fi
+       build_text $FILE $TEMPDIR 2>&1 | tee -a $LOGFILE
     fi
+
     if [ "$DISCARD_TEMPS" ] ; then
        cleanup $FILE 2>&1 | tee -a $LOGFILE
     fi