shithub: riscv

ref: 06ad4e5fff870dc6e7da253c1b15aa715ff2dfb3
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.