]> git.lizzy.rs Git - plan9front.git/blob - sys/man/1/ms2html
merge
[plan9front.git] / sys / man / 1 / ms2html
1 .TH MS2HTML 1
2 .SH NAME
3 ms2html, html2ms \- convert between troff's ms macros and html
4 .SH SYNOPSIS
5 .B ms2html
6 [
7 .B -q
8 ] [
9 .B -b
10 .I basename
11 ] [
12 .B -d
13 .I delims
14 ] [
15 .B -t
16 .I title
17 ]
18 .br
19 .B html2ms
20 .SH DESCRIPTION
21 .I Ms2html
22 converts the
23 .IR ms (6)
24 source on standard input into HTML and prints it to
25 standard output.
26 If the source contains
27 .IR tbl (1)
28 or
29 .IR eqn
30 input, you must first pipe the text through those
31 preprocessors.
32 Postscript images, equations, and tables will be
33 converted to gif files.
34 If the document has a
35 .B .TL
36 entry, its contents will be used as the title; otherwise
37 .I ms2html
38 will look for a
39 .B ._T
40 macro, unknown to
41 .IR ms (6),
42 and take its value.
43 Options are:
44 .TF q
45 .IP q
46 suppresses warnings about malformed input;
47 .IP b
48 sets the HTML base name to
49 .IR basename ;
50 .IP d
51 sets the
52 .IR eqn (1)
53 delimiters to
54 .IR delim ;
55 .IP t
56 sets the HTML title to
57 .IR title .
58 .PD
59 .PP
60 .I Html2ms
61 reads HTML from standard input and converts it
62 to
63 .IR ms (6)
64 source on standard output. The document
65 is expected to be UTF encoded so a preprocessor like
66 .IR uhtml (1)
67 should be used to normalize the HTML.
68 .SH SOURCE
69 .B /sys/src/cmd/ms2html.c
70 .br
71 .B /sys/src/cmd/html2ms.c
72 .SH SEE ALSO
73 .IR htmlroff (1),
74 .IR ms (6),
75 .IR uhtml (1)
76 .SH BUGS
77 .PP
78 Ms2html doesn't understand a number of troff
79 commands.  It does handle macros and defined
80 strings.