git: 9front

ref: abf8a2b5e3deff0a2b1b29b0bfb86f22d874f9b5
dir: /sys/man/1/ms2html/

View raw version
.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.