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