plan9fox/sys/man/1/ms2html
2017-12-11 19:58:06 -05:00

81 lines
1.3 KiB
Plaintext

.TH MS2HTML 1
.SH NAME
ms2html, html2ms \- convert between troff's ms macros and html
.SH SYNOPSIS
.B ms2html
[
.B -q
] [
.B -b
.I basename
] [
.B -d
.I delims
] [
.B -t
.I title
]
.br
.B html2ms
.SH DESCRIPTION
.I Ms2html
converts the
.IR ms (6)
source on standard input into HTML and prints it to
standard output.
If the source contains
.IR tbl (1)
or
.IR eqn
input, you must first pipe the text through those
preprocessors.
Postscript images, equations, and tables will be
converted to gif files.
If the document has a
.B .TL
entry, its contents will be used as the title; otherwise
.I ms2html
will look for a
.B ._T
macro, unknown to
.IR ms (6),
and take its value.
Options are:
.TF q
.IP q
suppresses warnings about malformed input;
.IP b
sets the HTML base name to
.IR basename ;
.IP d
sets the
.IR eqn (1)
delimiters to
.IR delim ;
.IP t
sets the HTML title to
.IR title .
.PD
.PP
.I Html2ms
reads HTML from standard input and converts it
to
.IR ms (6)
source on standard output. The document
is expected to be UTF encoded so a preprocessor like
.IR uhtml (1)
should be used to normalize the HTML.
.SH SOURCE
.B /sys/src/cmd/ms2html.c
.br
.B /sys/src/cmd/html2ms.c
.SH SEE ALSO
.IR htmlroff (1),
.IR ms (6),
.IR uhtml (1)
.SH BUGS
.PP
Ms2html doesn't understand a number of troff
commands. It does handle macros and defined
strings.