git: 9front

ref: 6ac1c151c27bfe7b2e9f679ac2d7980b02ca1a77
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.