./ 751 0 0 0 5776736760 4100 ./troff2htmlpost.sed 640 0 0 143 5776736774 7642 s/ < / < /g s/ <= / <= /g s/ > / > /g s/ >= / >= /g s/.//g s/.//g /^$/d s/\\\(bu/*/g ðE [Fÿ¿ ðE uFÿ¿¨A fFÿ¿xFÿ¿ ¨A zFÿ¿ŒFÿ¿ ¼“ XFÿ¿ tro5776736760 @ ÄFÿ¿xFÿ¿ 4100 @ ØFÿ¿ŒFÿ¿ ¦ œ üÿÿ o ” ág ÈFÿ¿‹T ‰$ ./Install 640 0 0 363 5737515146 5466 #!/bin/rc {{test -d /sys/lib/troff2html || mkdir /sys/lib/troff2html} && cp troff2html*.sed html.m* /sys/lib/troff2html && cp troff2html.r /rc/bin/troff2html && chmod +x /rc/bin/troff2html} || exit failed cp troff2html.1 /sys/man/1/troff2html ðE [Fÿ¿ ðE uFÿ¿¨A fFÿ¿xFÿ¿ ¨A zFÿ¿ŒFÿ¿ ¼“ XFÿ¿ tro5776736760 @ ÄFÿ¿xFÿ¿ 4100 @ ØFÿ¿ŒFÿ¿ ¦ œ üÿÿ o ” ág ÈFÿ¿‹T ‰$ ./README 640 0 0 3243 5737515147 5036 troff2html was written by Jim Briggs at York for Unix, and was trivially adapted for plan 9 by forsyth@plan9.cs.york.ac.uk who might be responsible for bugs in this version ... ask him first on Plan 9: 1. if you haven't got the command `soelim' cd soelim mk installall (if you've got an awk script that efficiently does this work, let me know) troff2html looks for it in /bin/aux/soelim and /bin/ape/soelim 2. rc Install -- it makes /sys/lib/troff2html and installs various components there. 3. test it by troff2html -mh doc.mh >Y && cmp Y doc.html there should be no differences bugs/comments to forsyth@plan9.cs.york.ac.uk the README for the Unix version -- the installation instructions don't apply to Plan 9 troff2html - translate troff(1) source to HyperText Markup Language (HTML) ----------------------------------------------------------------------- version 1.2 Jim Briggs (jim@minster.york.ac.uk) Department of Computer Science University of York England troff2html is a translator for converting troff documents into HTML, for display on the World Wide Web. See the enclosed manual page, troff2html.1, and the Users' Manual, doc.n, for details. To install, edit the initial section of the Bourne shell (sh(1)) script `INSTALL' marked `Installer-customisable definitions' to define your UNIX environment and filestore. You must have write permission for the approp- riate directories. Then give the shell command `./INSTALL' (or `sh -x INSTALL' to see what the script is doing). It should print `Installed' when it is finished. Please report problems and suggestions for enhancements etc. to Dr. Jim Briggs at the address above, preferably by E-mail. s. To install, edit the initial section of the Bourne shell (sh(1)) script `INSTALL' marked `Installer-customisable definitions' to define your UNIX environment and filestore. You must have write permission for the approp- riate directories. Then give the shell command `./INSTALL' (or `sh -x INSTALL' to see what the script is doing). It should pr./VERSION 640 0 0 37 5737515147 5164 troff2html - VERSION 1.2 Plan9 shed. Please report problems and suggestions for enhancements etc. to Dr. Jim Briggs at the address above, preferably by E-mail. s. To install, edit the initial section of the Bourne shell (sh(1)) script `INSTALL' marked `Installer-customisable definitions' to define your UNIX environment and filestore. You must have write permission for the approp- riate directories. Then give the shell command `./INSTALL' (or `sh -x INSTALL' to see what the script is doing). It should pr./doc.html 640 0 0 12572 5737617526 5642
by Jim Briggs
at Department of Computer Science, University of York
Troff2html is a translator for converting troff documents written using the ms macros (or extensions thereof) into HTML, for display on the World Wide Web.
It works by using nroff to produce a textual form of the normally typeset output of troff that includes HTML elements necessary to the format. Since it uses nroff, it is possible for the user to extend the set of macros that are implemented and to use pre-processors such as tbl and refer.
The following macros are implemented by troff2html:
.TL .AU .AI .AB .AE
.TL denotes the title of the HTML document. The text following it is also used as a <H1> heading at the start of the document.
.LP .PP .IE .IP .QP
.IP and .QP are implemented by the HTML <DL> construct. The others map on to the HTML <P> construct.
.B .I .BI .R
.B and .I should produce the desired effect, using HTML's <B> and <I> elements. .BI maps on to <STRONG> and therefore (depending on the browser) may appear the same as .B. The implementation of .R attempts to restore the normal font but may fail in cases of complicated nesting of these calls.
.UL .SM .LG
.UL maps onto <U>. .SM and .LG have no discernible effect in HTML - their argument will appear in normal style.
.SH .NH
.SH maps on to HTML's <H3> heading. .NH n maps on to <Hn+1> since <H1> is used for titles. Section numbering for .NH is done by the troff2html macros.
.RS .RE
Nesting is achieved by means of the <DL> construct which appears nested on most browsers.
.QS .QE
This feature is implemented using HTML's <BLOCKQUOTE>.
.TS .TE .EQ .EN .PS .PE .DS .DE
These are all implemented using the HTML <PRE> construct, therefore the nroff output is displayed without any further formatting. The argument to .DS that indicates the desired indentation is ignored by troff2html but will be interpreted by nroff. Remember to use neqn rather than eqn as your equation pre-processor.
.B1 .B2 .BX
A horizontal rule (<HR>) precedes and follows the text enclosed by .B1 and .B2, but the box has no sides. The argument to .BX is enclosed between [ and ].
.FS .FE
The text of footnotes is included inline between [ and ] brackets.
.UX .US
These macros produce the traditional words in the current text style.
.[ .]
These map on to their text equivalent.
.PM .PZ .BM
These are implemented by linking to the named file. Whether this is effective or not depends on whether the browser can interpret the contents of that file.
.RT
This must be called in the same way that it is used in -ms by any paragraph macro that the user defines, and also by the end macro .EM.
troff2html supports three additional macros for defining locations and linking to other documents and images:
.UD target_location_name
Defines a name for the current target location. If using it to define a name for a section of a document, put .UL before the section heading macro.
.UR URL text
The .UR macro is used to specify links from your document to other documents (or target locations within the current document). The first argument is the URL; the second argument is the text that will appear highlighted in your document.
.UI URL [alignment]
The .UI macro is used to specify image files for inclusion in a document. The first argument is the URL of the file; the second (optional) argument specifies the alignment of the image.
troff2html does not support the following features of the -ms macros:
troff2html takes a document in troff input format (either on the standard input or in files named as arguments) and produces HTML format text on the standard output.
construct.
.NH 2
Emphasis macros
.LP
\&.B \&.I \&.BI \&.R
.LP
\&.B and \&.I should produce the desired effect, using HTML's and
elements.
\&.BI maps on to and therefore (depending on the browser) may
appear the same as \&.B.
The implementation of \&.R attempts to restore the normal font but may
fail in cases of complicated nesting of these calls.
.NH 2
Other style macros
.LP
\&.UL \&.SM \&.LG
.LP
\&.UL maps onto .
\&.SM and \&.LG have no discernible effect in HTML \(en their argument
will appear in normal style.
.NH 2
Heading macros
.LP
\&.SH \&.NH
.LP
\&.SH maps on to HTML's heading.
\&.NH n maps on to
is used for titles.
Section numbering for \&.NH is done by the troff2html macros.
.NH 2
Indented sections
.LP
\&.RS \&.RE
.LP
Nesting is achieved by means of the
construct which appears nested
on most browsers.
.NH 2
Block quotations
.LP
\&.QS \&.QE
.LP
This feature is implemented using HTML's
.nr id 0
.if \\n(iu
.nr iu 0
.if \\n(ip .
.NH 2
Tables, pictures, equations and display blocks
.LP
\&.TS \&.TE \&.EQ \&.EN \&.PS \&.PE \&.DS \&.DE
.LP
These are all implemented using the HTML
construct, therefore the
.I nroff
output is displayed without any further formatting.
The argument to \&.DS that indicates the desired indentation is ignored
by
.I troff2html
but will be interpreted by
.I nroff .
Remember to use
.I neqn
rather than
.I eqn
as your equation pre-processor.
.NH 2
Boxes
.LP
\&.B1 \&.B2 \&.BX
.LP
A horizontal rule (
) precedes and follows the text enclosed by
\&.B1 and \&.B2, but the box has no sides.
The argument to \&.BX is enclosed between [ and ].
.NH 2
Footnotes
.LP
\&.FS \&.FE
.LP
The text of footnotes is included inline between [ and ] brackets.
.NH 2
Text macros
.LP
\&.UX \&.US
.LP
These macros produce the traditional words in the current text style.
.NH 2
References
.LP
\&.[ \&.]
.LP
These map on to their text equivalent.
.NH 2
Picture inclusion macros
.LP
\&.PM \&.PZ \&.BM
.LP
These are implemented by linking to the named file.
Whether this is effective or not depends on whether the browser can
interpret the contents of that file.
.NH 2
Miscellaneous macros
.LP
\&.RT
.LP
This must be called in the same way that it is used in -ms by any
paragraph macro that the user defines, and also by the end macro
\&.EM.
.NH 1
Other features
.LP
.I troff2html
supports three additional macros for defining locations and linking to
other documents and images:
.LP
\&.UD target_location_name
.LP
Defines a name for the current target location.
If using it to define a name for a section of a document, put \&.UL
.I before
the section heading macro.
.LP
\&.UR URL text
.LP
The \&.UR macro is used to specify links from your document to other
documents (or target locations within the current document).
The first argument is the URL; the second argument is the text that
will appear highlighted in your document.
.LP
\&.UI URL [alignment]
.LP
The \&.UI macro is used to specify image files for inclusion in a
document.
The first argument is the URL of the file; the second (optional)
argument specifies the alignment of the image.
.NH 1
Unimplemented features
.LP
.I troff2html
does not support the following features of the -ms macros:
.BP
Macro side-effects in general such as setting particular registers or
strings (if you have particular side-effects that your own macros rely
on,
.UR "mailto:jim@minster.york.ac.uk" "let the author know"
and I will see what can be done).
.BP
Document layout macros (e.g. \&.S1 \&.S2).
.BP
Bell Labs specific macros (e.g. \&.WH).
.NH 1
Use of troff2html
.LP
.I troff2html
takes a document in
.I troff
input format (either on the standard input or in files named as
arguments) and produces HTML format text on the standard output.
.RT
.SP 2
.B1
.LP
.UR "mailto:jim@minster.york.ac.uk" "Mail the author"
.LP
.UR "ftp:troff2html.tar" "FTP troff2html (tar format)"
.B2
ilto:jim@minster.york.ac.uk" "let the author know"
and I will see what can be done).
.BP
Document layout macros (e.g. \&.S1 \&.S2).
.BP
Bell Labs specific macros (e.g. \&.WH).
.NH 1
Use of troff./html.mh 640 0 0 1074 5776736773 5465 .\" Jim Briggs's extensions to -ms
.so /sys/lib/troff2html/html.ms
.de bR
.if \\n(it=0 \{\
.br
.\}
.br
..
.de BR
.bR
..
.de sP
.if \\n(it=0 \{\
.br
.if "\\$1""
.if !"\\$1"" .if \\$1>0.5v
.\}
.br
..
.de SP
.sP \\$1
..
.de BP
.if \\n(iu=1 \{
.nr iu 0
.RT
.nr iu 1\}
.if \\n(iu=0 .RT
.if \\n(iu=0
.nr iu 1
.br
Admissions information from the Department of Computer Science
..
tml.ms
.de bR
.if \\n(it=0 \{\
.br
.\}
.br
..
.de BR
.bR
..
.de sP
.if \\n(it=0 \{\
.br
.if "\\$1""
.if !"\\$1"" .if \\$1>0.5v
.\}
.br
..
.de SP
.sP \\$1
..
.de BP
.if \\n(iu=1 \{
.nr iu 0
.RT
.nr iu 1\}
.if \\n(iu=0 .RT
.if \\n(iu=0
.nr iu 1
.br
Admissions i./html.ms 640 0 0 6705 5776736774 5507 .\"-ms macros for ms2html
.\"Author: Jim Briggs
.\"Version: 1.2
.nr WW 3
.\".ll 72n
.na
.nf
.br .nr ip 1 .. .de PP .RT
.br .nr ip 1 .. .de IP .ie '\\$1'\(bu' \{\ .Ul \} .el \{ .if \\n(id=1 \{ .nr id 0 .RT .nr id 1\} .if \\n(id=0 \{ .RT
\\$1
\\$2
..
.de RE
.RT
.br .. .de QE .RT.br .. .de EM .RT .. .de TS .br
.br .. .de TE .br.br .. .de EQ .br
.br .. .de EN .br.br .. .de PS .br
.br .. .de PE .br.br .. .de WT Untitled document \\*(f. .. .de TL .if \\n(iz .RT .br .nr it 1 .di WT .. .de AU .LP .I by .. .de AI .LP at .. .de AB .SH Abstract .LP .. .de AE .RT .. .de SH .RT .nr h3 1
.br .nf .na .. .de DE .br.br .fi .. .\"York extensions to -ms .de P1 .RT
.br
.nf
.na
..
.de P2
.br
.br
.fi
..
.ds ET TEX
.ds LA LATEX
.ds MT METAFONT
.ds XV BIBTEX
.ds LS SLITEX
.ds ZC CADIZ
.de PM
..
.de PZ
..
.de BM
..
.de UD
..
.de UR
\\$2\\$3
..
.de UI
..
.de OL
.if \\n(io=1 \{
.nr io 0
.RT