Blob
1 .TH HTMLROFF 12 .SH NAME3 htmlroff \- HTML formatting and typesetting4 .SH SYNOPSIS5 .B htmlroff6 [7 .B -iuv8 ]9 [10 .B -m11 .I name12 ]13 [14 .B -r15 .I aN16 ]17 [18 .I file19 \&...20 ]21 .SH DESCRIPTION22 .I Htmlroff23 accepts24 .IR troff (1)25 input in the named26 .I files27 and formats it as HTML for viewing in a web browser.28 .PP29 If no30 .I file31 argument is given,32 .I htmlroff33 reads the standard input.34 An argument consisting of a single minus35 .RB ( - )36 is taken to be37 a file name corresponding to the standard input.38 The options are:39 .TP40 .B -i41 Read standard input after the input files are exhausted.42 .TP43 .BI -m name44 Process the macro file45 .BI \*9/tmac/tmac. name46 before the input47 .IR files .48 .TP49 .BI -r aN50 Set register51 .I a52 (one character name) to53 .IR N .54 .TP55 .B -u56 Generate UTF output.57 By default,58 .I htmlroff59 converts Unicode runes into the corresponding60 HTML entity sequences61 .RB ( α ,62 .BR ,63 and so on).64 .I Htmlroff65 invokes66 .IR tcs (1)67 for the conversion.68 .TP69 .B -v70 Generate debugging output and warnings about suspicious input.71 .PD72 .PP73 Most74 .I troff75 input files, especially those using the76 .IR ms (7)77 macros, can be used unaltered.78 In general, the macro file79 .B tmac.html80 should be processed after processing other standard macro files,81 as in82 .B htmlroff83 .B -ms84 .BR -mhtml .85 .PP86 .IR Htmlroff (7)87 describes the changes to the input language.88 .PP89 .IR Mhtml (7)90 describes the new macros.91 .SH EXAMPLES92 Format the Plan 9 web page:93 .IP94 .EX95 cd /usr/web/plan996 htmlroff -mhtml index.tr >index.html97 .EE98 .PP99 Format a paper:100 .IP101 .EX102 cd /sys/doc103 pic auth.ms | tbl | eqn | htmlroff -ms -mhtml >auth.html104 .EE105 .SH FILES106 .TP107 .B \*9/troff/font/devutf/utfmap108 Mapping from109 .I troff110 two-character names like111 .B \e(*a112 to Unicode characters like α.113 .SH SOURCE114 .B \*9/src/cmd/htmlroff115 .SH "SEE ALSO116 .IR tcs (1),117 .IR troff (1),118 .IR htmlroff (7),119 .IR mhtml (7)