add directory ftp-archives
This commit is contained in:
@@ -0,0 +1,403 @@
|
||||
-----------------------------------------------------------------------
|
||||
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 <tt/dvips/) with
|
||||
the command:
|
||||
<tscreen><verb>
|
||||
! $ format -Tlatex foo | qtex > foo.ps
|
||||
</verb></tscreen>
|
||||
Or, you can produce a DVI file using the <tt>-d</tt> switch with
|
||||
<tt>qtex</tt>, as so:
|
||||
<tscreen><verb>
|
||||
! $ format -Tlatex foo | qtex -d > foo.dvi
|
||||
</verb></tscreen>
|
||||
|
||||
If you want to produce plain ASCII, through <tt/groff/, use the command:
|
||||
<tscreen><verb>
|
||||
! $ format -Tnroff foo | qroff > foo.txt
|
||||
</verb></tscreen>
|
||||
Note that I have tailored the <tt/groff/ conversion for plain ASCII output.
|
||||
(That is, I've removed page headers, page numbers, changed the margins,
|
||||
--- 280,296 ----
|
||||
it to LaTeX, and produce PostScript output (via <tt/dvips/) with
|
||||
the command:
|
||||
<tscreen><verb>
|
||||
! $ format -T latex foo | qtex > foo.ps
|
||||
</verb></tscreen>
|
||||
Or, you can produce a DVI file using the <tt>-d</tt> switch with
|
||||
<tt>qtex</tt>, as so:
|
||||
<tscreen><verb>
|
||||
! $ format -T latex foo | qtex -d > foo.dvi
|
||||
</verb></tscreen>
|
||||
|
||||
If you want to produce plain ASCII, through <tt/groff/, use the command:
|
||||
<tscreen><verb>
|
||||
! $ format -T nroff foo | qroff > foo.txt
|
||||
</verb></tscreen>
|
||||
Note that I have tailored the <tt/groff/ conversion for plain ASCII output.
|
||||
(That is, I've removed page headers, page numbers, changed the margins,
|
||||
***************
|
||||
*** 301,308 ****
|
||||
If you want to produce HTML, the procedure is a bit more complicated,
|
||||
because of cross-references. Here's an example:
|
||||
<tscreen><verb>
|
||||
! $ 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
|
||||
</verb></tscreen>
|
||||
--- 301,308 ----
|
||||
If you want to produce HTML, the procedure is a bit more complicated,
|
||||
because of cross-references. Here's an example:
|
||||
<tscreen><verb>
|
||||
! $ 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
|
||||
</verb></tscreen>
|
||||
***************
|
||||
*** 318,324 ****
|
||||
If you just want to capture your errors from the SGML conversion,
|
||||
use something like
|
||||
<tscreen><verb>
|
||||
! $ format -Tnroff foo > /dev/null
|
||||
</verb></tscreen>
|
||||
|
||||
<sect1>Development note
|
||||
--- 318,324 ----
|
||||
If you just want to capture your errors from the SGML conversion,
|
||||
use something like
|
||||
<tscreen><verb>
|
||||
! $ format -T nroff foo > /dev/null
|
||||
</verb></tscreen>
|
||||
|
||||
<sect1>Development note
|
||||
***************
|
||||
*** 576,589 ****
|
||||
embodies the entire document).
|
||||
|
||||
</sect2>
|
||||
! <sect1><heading><label id="cross-ref">Cross-references</>
|
||||
|
||||
<p>Now we're going to move onto other features of the system.
|
||||
Cross-references are easy. For example, if you want to make a
|
||||
cross-reference to a certain section, you need to label that section
|
||||
as so:
|
||||
<tscreen><verb>
|
||||
! <sect1><heading><label id="sec-intro">Introduction&etago;>
|
||||
</verb></tscreen>
|
||||
You can then refer to that section somewhere in the text using the
|
||||
expression:
|
||||
--- 576,589 ----
|
||||
embodies the entire document).
|
||||
|
||||
</sect2>
|
||||
! <sect1>Cross-references<label id="cross-ref">
|
||||
|
||||
<p>Now we're going to move onto other features of the system.
|
||||
Cross-references are easy. For example, if you want to make a
|
||||
cross-reference to a certain section, you need to label that section
|
||||
as so:
|
||||
<tscreen><verb>
|
||||
! <sect1>Introduction<label id="sec-intro">
|
||||
</verb></tscreen>
|
||||
You can then refer to that section somewhere in the text using the
|
||||
expression:
|
||||
diff -cr linuxdoc-sgml-1.1-original/doc/guide.txt linuxdoc-sgml-1.1/doc/guide.txt
|
||||
*** linuxdoc-sgml-1.1-original/doc/guide.txt Wed Jun 8 05:24:45 1994
|
||||
--- linuxdoc-sgml-1.1/doc/guide.txt Mon Nov 14 00:16:37 1994
|
||||
***************
|
||||
*** 289,295 ****
|
||||
LaTeX, and produce PostScript output (via dvips) with the command:
|
||||
|
||||
|
||||
! $ format -Tlatex foo | qtex > foo.ps
|
||||
|
||||
|
||||
|
||||
--- 289,295 ----
|
||||
LaTeX, and produce PostScript output (via dvips) with the command:
|
||||
|
||||
|
||||
! $ format -T latex foo | qtex > foo.ps
|
||||
|
||||
|
||||
|
||||
***************
|
||||
*** 297,303 ****
|
||||
Or, you can produce a DVI file using the -d switch with qtex, as so:
|
||||
|
||||
|
||||
! $ format -Tlatex foo | qtex -d > foo.dvi
|
||||
|
||||
|
||||
|
||||
--- 297,303 ----
|
||||
Or, you can produce a DVI file using the -d switch with qtex, as so:
|
||||
|
||||
|
||||
! $ format -T latex foo | qtex -d > foo.dvi
|
||||
|
||||
|
||||
|
||||
***************
|
||||
*** 305,311 ****
|
||||
If you want to produce plain ASCII, through groff, use the command:
|
||||
|
||||
|
||||
! $ format -Tnroff foo | qroff > foo.txt
|
||||
|
||||
|
||||
|
||||
--- 305,311 ----
|
||||
If you want to produce plain ASCII, through groff, use the command:
|
||||
|
||||
|
||||
! $ format -T nroff foo | qroff > foo.txt
|
||||
|
||||
|
||||
|
||||
***************
|
||||
*** 320,327 ****
|
||||
because of cross-references. Here's an example:
|
||||
|
||||
|
||||
! $ 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
|
||||
|
||||
--- 320,327 ----
|
||||
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
|
||||
|
||||
***************
|
||||
*** 340,346 ****
|
||||
something like
|
||||
|
||||
|
||||
! $ format -Tnroff foo > /dev/null
|
||||
|
||||
|
||||
|
||||
--- 340,346 ----
|
||||
something like
|
||||
|
||||
|
||||
! $ format -T nroff foo > /dev/null
|
||||
|
||||
|
||||
|
||||
***************
|
||||
*** 669,675 ****
|
||||
reference to a certain section, you need to label that section as so:
|
||||
|
||||
|
||||
! <sect1><heading><label id="sec-intro">Introduction</>
|
||||
|
||||
|
||||
|
||||
--- 669,675 ----
|
||||
reference to a certain section, you need to label that section as so:
|
||||
|
||||
|
||||
! <sect1>Introduction<label id="sec-intro">
|
||||
|
||||
|
||||
|
||||
diff -cr linuxdoc-sgml-1.1-original/html-fix/Makefile linuxdoc-sgml-1.1/html-fix/Makefile
|
||||
*** linuxdoc-sgml-1.1-original/html-fix/Makefile Wed Jun 8 05:13:33 1994
|
||||
--- linuxdoc-sgml-1.1/html-fix/Makefile Sat Jul 30 18:09:52 1994
|
||||
***************
|
||||
*** 5,14 ****
|
||||
all: fixref html2html
|
||||
|
||||
fixref: fixref.c
|
||||
! gcc -o fixref fixref.c -ll
|
||||
|
||||
html2html: html2html.c
|
||||
! gcc -o html2html html2html.c -ll
|
||||
|
||||
install:
|
||||
cp html2html fixref ../bin
|
||||
--- 5,14 ----
|
||||
all: fixref html2html
|
||||
|
||||
fixref: fixref.c
|
||||
! gcc -s -o fixref fixref.c -lfl
|
||||
|
||||
html2html: html2html.c
|
||||
! gcc -s -o html2html html2html.c -lfl
|
||||
|
||||
install:
|
||||
cp html2html fixref ../bin
|
||||
diff -cr linuxdoc-sgml-1.1-original/rep/html/general linuxdoc-sgml-1.1/rep/html/general
|
||||
*** linuxdoc-sgml-1.1-original/rep/html/general Wed Jun 8 05:13:45 1994
|
||||
--- linuxdoc-sgml-1.1/rep/html/general Sun Nov 13 14:03:00 1994
|
||||
***************
|
||||
*** 71,77 ****
|
||||
<!entity lcub sdata "{" >
|
||||
<!entity verbar sdata "|" >
|
||||
<!entity rcub sdata "}" >
|
||||
! <!entity tilde sdata "˜" >
|
||||
<!entity bsol sdata "\" >
|
||||
<!entity dollar sdata "$" >
|
||||
<!entity nbsp sdata "~" >
|
||||
--- 71,77 ----
|
||||
<!entity lcub sdata "{" >
|
||||
<!entity verbar sdata "|" >
|
||||
<!entity rcub sdata "}" >
|
||||
! <!entity tilde sdata "~" >
|
||||
<!entity bsol sdata "\" >
|
||||
<!entity dollar sdata "$" >
|
||||
<!entity nbsp sdata "~" >
|
||||
diff -cr linuxdoc-sgml-1.1-original/rep/latex/general linuxdoc-sgml-1.1/rep/latex/general
|
||||
*** linuxdoc-sgml-1.1-original/rep/latex/general Wed Jun 8 05:13:43 1994
|
||||
--- linuxdoc-sgml-1.1/rep/latex/general Sun Nov 13 14:23:49 1994
|
||||
***************
|
||||
*** 71,77 ****
|
||||
<!entity lcub sdata "\{" >
|
||||
<!entity verbar sdata "{\verbar}" >
|
||||
<!entity rcub sdata "\}" >
|
||||
! <!entity tilde sdata "\verb+~+" >
|
||||
<!entity bsol sdata "\verb+\+" >
|
||||
<!entity dollar sdata "\$" >
|
||||
<!entity nbsp sdata "~" >
|
||||
--- 71,77 ----
|
||||
<!entity lcub sdata "\{" >
|
||||
<!entity verbar sdata "{\verbar}" >
|
||||
<!entity rcub sdata "\}" >
|
||||
! <!entity tilde sdata "\~{}" >
|
||||
<!entity bsol sdata "\verb+\+" >
|
||||
<!entity dollar sdata "\$" >
|
||||
<!entity nbsp sdata "~" >
|
||||
Reference in New Issue
Block a user