ref: e50a9f5b2a9dbc1152f503319bb7c2a862f12c7d
dir: /sys/man/1/htmlroff/
.TH HTMLROFF 1 .SH NAME htmlroff \- HTML formatting and typesetting .SH SYNOPSIS .B htmlroff [ .B -iuv ] [ .B -m .I name ] [ .B -r .I aN ] [ .I file \&... ] .SH DESCRIPTION .I Htmlroff accepts .IR troff (1) input in the named .I files and formats it as HTML for viewing in a web browser. .PP If no .I file argument is given, .I htmlroff reads the standard input. An argument consisting of a single minus .RB ( - ) is taken to be a file name corresponding to the standard input. The options are: .TP .B -i Read standard input after the input files are exhausted. .TP .BI -m name Process the macro file .BI /sys/lib/tmac/tmac. name before the input .IR files . .TP .BI -r aN Set register .I a (one character name) to .IR N . .TP .B -u Generate UTF output. By default, .I htmlroff converts Unicode runes into the corresponding HTML entity sequences .RB ( α , .BR , and so on). .I Htmlroff invokes .IR tcs (1) for the conversion. .TP .B -v Generate debugging output and warnings about suspicious input. .PD .PP Most .I troff input files, especially those using the .IR ms (6) macros, can be used unaltered. In general, the macro file .B tmac.html should be processed after processing other standard macro files, as in .B htmlroff .B -ms .BR -mhtml . .PP .IR Htmlroff (6) describes the changes to the input language. .PP .IR Mhtml (6) describes the new macros. .SH EXAMPLES Format the Plan 9 web page: .IP .EX cd /usr/web/plan9 htmlroff -mhtml index.tr >index.html .EE .PP Format a paper: .IP .EX cd /sys/doc pic auth.ms | tbl | eqn | htmlroff -ms -mhtml >auth.html .EE .SH FILES .TP .B /sys/lib/troff/font/devutf/utfmap Mapping from .I troff two-character names like .B \e(*a to Unicode characters like α. .SH SOURCE .B /sys/src/cmd/htmlroff .SH "SEE ALSO .IR tcs (1), .IR troff (1), .IR htmlroff (6), .IR mhtml (6)