troff 3.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198
  1. .TH TROFF 1
  2. .SH NAME
  3. troff, nroff \- text formatting and typesetting
  4. .SH SYNOPSIS
  5. .B troff
  6. [
  7. .I option ...
  8. ]
  9. [
  10. .I file ...
  11. ]
  12. .PP
  13. .B nroff
  14. [
  15. .I option ...
  16. ]
  17. [
  18. .I file ...
  19. ]
  20. .SH DESCRIPTION
  21. .I Troff
  22. formats text in the named
  23. .I files
  24. for
  25. printing on a typesetter.
  26. .I Nroff
  27. does the same, but produces output suitable
  28. for typewriter-like devices.
  29. .PP
  30. If no
  31. .I file
  32. argument is present, the standard input is read.
  33. An argument consisting of a single minus
  34. .RB ( - )
  35. is taken to be
  36. a file name corresponding to the standard input.
  37. The options are:
  38. .nr xx \w'\fL-m\f2name\ \ '
  39. .TP \n(xxu
  40. .BI -o list
  41. Print pages in the comma-separated
  42. .I list
  43. of numbers and ranges.
  44. A range
  45. .IB N - M
  46. means
  47. .I N
  48. through
  49. .IR M ;
  50. initial
  51. .BI - M
  52. means up to
  53. .IR M ;
  54. final
  55. .IB N -
  56. means from
  57. .I N
  58. to the end.
  59. .TP
  60. .BI -n N
  61. Number first generated page
  62. .IR N .
  63. .TP
  64. .BI -m name
  65. Process the macro file
  66. .BI /sys/lib/tmac/tmac. name
  67. before the input
  68. .IR files .
  69. .TP
  70. .BI -r aN
  71. Set register
  72. .I a
  73. (one character name) to
  74. .IR N .
  75. .TP
  76. .B -i
  77. Read standard input after the input files are exhausted.
  78. .TP
  79. .B -q
  80. Invoke the simultaneous input-output mode of the
  81. .B rd
  82. request.
  83. .TP
  84. .B -N
  85. Produce output suitable for typewriter-like devices.
  86. .SS Typesetter devices (not \fL-N\fP) only
  87. .TP \n(xxu
  88. .B -a
  89. Send a printable
  90. textual
  91. approximation
  92. of the results to the standard output.
  93. .TP
  94. .BI -T dest
  95. Prepare output for typesetter
  96. .IR dest :
  97. .br
  98. .ns
  99. .RS
  100. .TP \w'\fL-TLatin1\ 'u
  101. .B -Tutf
  102. (The default.) PostScript printers with
  103. preprocessing to handle Unicode
  104. characters encoded in
  105. .SM UTF
  106. .PD0
  107. .TP
  108. .B -Tpost
  109. Regular PostScript printers
  110. .PD0
  111. .TP
  112. .B -T202
  113. Mergenthaler Linotron 202
  114. .RE
  115. .PD
  116. .TP "\w'\fL-m\f2name 'u"
  117. .BI -F dir
  118. Take font information from directory
  119. .IR dir .
  120. .SS Typewriter (\fL-N\fP) output only
  121. .TP \n(xxu
  122. .BI -s N
  123. Halt prior to every
  124. .I N
  125. pages (default
  126. .IR N =1)
  127. to allow paper loading or changing.
  128. .TP
  129. .BI -T name
  130. Prepare output for specified terminal.
  131. Known
  132. .I names
  133. include
  134. .B utf
  135. for the normal Plan 9
  136. .SM UTF
  137. encoding of the Unicode Standard character set (default),
  138. .B 37
  139. for the
  140. Teletype model 37,
  141. .B lp
  142. (`line-printer')
  143. for any terminal without half-line capability,
  144. .B 450
  145. for the \s-1DASI\s+1-450
  146. (Diablo Hyterm),
  147. and
  148. .B think
  149. (HP ThinkJet).
  150. .TP
  151. .B -e
  152. Produce equally-spaced words in adjusted
  153. lines, using full terminal resolution.
  154. .TP
  155. .B -h
  156. Use output tabs during horizontal spacing
  157. to speed output and reduce output character count.
  158. Tab settings are assumed to be every
  159. 8 nominal character widths.
  160. .SH FILES
  161. .TF /sys/lib/troff/term/*
  162. .TP
  163. .B /tmp/trtmp*
  164. temporary file
  165. .TP
  166. .B /sys/lib/tmac/tmac.*
  167. standard macro files
  168. .TP
  169. .B /sys/lib/troff/term/*
  170. terminal driving tables for
  171. .I nroff
  172. .TP
  173. .B /sys/lib/troff/font/*
  174. font width tables for
  175. .I troff
  176. .SH SOURCE
  177. .B /sys/src/cmd/troff
  178. .SH "SEE ALSO"
  179. .IR lp (1),
  180. .IR proof (1),
  181. .IR eqn (1),
  182. .IR tbl (1),
  183. .IR pic (1),
  184. .IR grap (1),
  185. .IR doctype (1),
  186. .IR ms (6),
  187. .IR image (6),
  188. .IR tex (1),
  189. .IR deroff (1)
  190. .br
  191. J. F. Ossanna and B. W. Kernighan,
  192. ``Troff User's Manual''
  193. .br
  194. B. W. Kernighan,
  195. ``A TROFF Tutorial'',
  196. .I
  197. Unix Research System Programmer's Manual,
  198. Tenth Edition, Volume 2.