----------------------------------------------------------------------- Note to FTP site maintainer: This file is to be placed in the /pub/Linux/utils/text/ directory, along with the rest of the linuxdoc HOWTO formatting software. Thanks, Paul. ----------------------------------------------------------------------- This patch fixes a number of minor bugs in the Howto formatting package. These are bugs that I have come across while using the package to format the Ethernet-Howto. It also fixes up the built in documentation in a few places. Fixes: 1) LaTeX has to run 3 times to get the offset caused by the number of "toc" pages. Fixed in "qtex". 2) Documented manner for making cross-references is cumbersome, and worse, it is broken. Show much simpler way. 3) Make binaries stripped to cut down on wasted space. 4) Tilde character in LaTeX mapping breaks when in an URL (as in http://myhost.edu/~joe.blow/index.html) ala csh expansion. Can't use a normal ~ either as that is a hard space in TeX. Fixed by using "\~{}" 5) The "&tilde" in the html mapping is printed literally as "&tilde" instead of "~". Fixed in html general. 6) Some (all?) versions of "getopt" don't seem to like things like "-Tlatex". Changed the docs to reflect that "-T latex" is a better choice. Hopefully this won't break anything else. I will also upload this patch to sunsite, as these mailing lists sometimes do *nasty* things to patches. Regards, Paul. -- diff -cr linuxdoc-sgml-1.1-original/bin/qtex linuxdoc-sgml-1.1/bin/qtex *** linuxdoc-sgml-1.1-original/bin/qtex Wed Jun 8 05:13:25 1994 --- linuxdoc-sgml-1.1/bin/qtex Mon Nov 14 00:12:33 1994 *************** *** 27,33 **** ###################################################################### DVI="no" ! TWO_PASSES="yes" SAVE="no" BIBTEX="no" CHAPTER="no" --- 27,33 ---- ###################################################################### DVI="no" ! MULTIPLE_PASSES="yes" SAVE="no" BIBTEX="no" CHAPTER="no" *************** *** 137,143 **** case $i in -c) CHAPTER="yes"; shift;; -d) DVI="yes"; shift;; ! -x) TWO_PASSES="yes"; shift;; -b) BIBTEX="yes"; shift;; -s) SAVE="yes"; shift;; -v) VERBOSE="yes"; shift;; --- 137,143 ---- case $i in -c) CHAPTER="yes"; shift;; -d) DVI="yes"; shift;; ! -x) MULTIPLE_PASSES="yes"; shift;; -b) BIBTEX="yes"; shift;; -s) SAVE="yes"; shift;; -v) VERBOSE="yes"; shift;; *************** *** 171,177 **** if [ $BIBTEX = "yes" ] then ! TWO_PASSES="yes" announce "BiBTeXing $FILE ... " bibtex $FILE > /dev/null --- 171,177 ---- if [ $BIBTEX = "yes" ] then ! MULTIPLE_PASSES="yes" announce "BiBTeXing $FILE ... " bibtex $FILE > /dev/null *************** *** 179,187 **** LaTeX $FILE fi ! if [ $TWO_PASSES = "yes" ] then announce "LaTeXing again ... " LaTeX $FILE fi --- 179,189 ---- LaTeX $FILE fi ! if [ $MULTIPLE_PASSES = "yes" ] then announce "LaTeXing again ... " + LaTeX $FILE + announce "And again ... " LaTeX $FILE fi diff -cr linuxdoc-sgml-1.1-original/doc/guide.sgml linuxdoc-sgml-1.1/doc/guide.sgml *** linuxdoc-sgml-1.1-original/doc/guide.sgml Wed Jun 8 05:23:35 1994 --- linuxdoc-sgml-1.1/doc/guide.sgml Mon Nov 14 00:15:55 1994 *************** *** 280,296 **** it to LaTeX, and produce PostScript output (via ! $ format -Tlatex foo | qtex > foo.ps Or, you can produce a DVI file using the -d switch with qtex, as so: ! $ format -Tlatex foo | qtex -d > foo.dvi If you want to produce plain ASCII, through ! $ format -Tnroff foo | qroff > foo.txt Note that I have tailored the ! $ format -T latex foo | qtex > foo.ps Or, you can produce a DVI file using the -d switch with qtex, as so: ! $ format -T latex foo | qtex -d > foo.dvi If you want to produce plain ASCII, through ! $ format -T nroff foo | qroff > foo.txt Note that I have tailored the ! $ format -Thtml foo.sgml | prehtml | fixref > tmp.html ! $ format -Thtml foo.sgml | prehtml >> tmp.html $ cat tmp.html | html2html foo > foo.html $ rm tmp.html --- 301,308 ---- If you want to produce HTML, the procedure is a bit more complicated, because of cross-references. Here's an example: ! $ format -T html foo.sgml | prehtml | fixref > tmp.html ! $ format -T html foo.sgml | prehtml >> tmp.html $ cat tmp.html | html2html foo > foo.html $ rm tmp.html *************** *** 318,324 **** If you just want to capture your errors from the SGML conversion, use something like ! $ format -Tnroff foo > /dev/null Development note --- 318,324 ---- If you just want to capture your errors from the SGML conversion, use something like ! $ format -T nroff foo > /dev/null Development note *************** *** 576,589 **** embodies the entire document). !