shithub: riscv

ref: feda4b1ed25f37676b23d3ee35aa44e14257a6b0
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.