1
0

deroff 1.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117
  1. .TH DEROFF 1
  2. .SH NAME
  3. deroff, delatex \- remove formatting requests
  4. .SH SYNOPSIS
  5. .B deroff
  6. [
  7. .I option ...
  8. ]
  9. .I file ...
  10. .PP
  11. .B delatex
  12. .I file
  13. .SH DESCRIPTION
  14. .I Deroff
  15. reads each file in sequence
  16. and removes all
  17. .I nroff
  18. and
  19. .IR troff (1)
  20. requests and non-text arguments, backslash constructions,
  21. and constructs of preprocessors such as
  22. .IR eqn (1),
  23. .IR pic (1),
  24. and
  25. .IR tbl (1).
  26. Remaining text is written on the standard output.
  27. .I Deroff
  28. follows files included by
  29. .L .so
  30. and
  31. .L .nx
  32. commands;
  33. if a file has already been included, a
  34. .L .so
  35. for that file is ignored and a
  36. .L .nx
  37. terminates execution.
  38. If no input file is given,
  39. .I deroff
  40. reads from standard input.
  41. .PP
  42. The options are
  43. .TP
  44. .B -w
  45. Output a word list, one `word' (string of letters, digits, and
  46. properly embedded ampersands and apostrophes,
  47. beginning with a letter) per line.
  48. Other characters are skipped.
  49. Otherwise, the output follows the original, with the deletions mentioned above.
  50. .TP
  51. .B -_
  52. Like
  53. .BR -w ,
  54. but consider underscores to be alphanumeric rather than punctuation.
  55. .TP
  56. .B -i
  57. Ignore
  58. .L .so
  59. and
  60. .L .nx
  61. requests.
  62. .TP
  63. .BR -ms
  64. .PD0
  65. .TP
  66. .B -mm
  67. Remove titles, attachments, etc., as well as ordinary
  68. .IR troff
  69. constructs, from
  70. .IR ms (6)
  71. or
  72. .I mm
  73. documents.
  74. .PD
  75. .TP
  76. .B -ml
  77. Same as
  78. .BR -mm ,
  79. but remove lists as well.
  80. .PP
  81. .I Delatex
  82. does for
  83. .I tex
  84. and
  85. .I latex
  86. (see
  87. .IR tex (1))
  88. files what
  89. .B deroff -wi
  90. does for
  91. .I troff
  92. files.
  93. .SH SOURCE
  94. .B /sys/src/cmd/deroff.c
  95. .br
  96. .B /sys/src/cmd/tex/local/delatex.c
  97. .SH "SEE ALSO"
  98. .IR troff (1),
  99. .IR tex (1),
  100. .IR spell (1)
  101. .SH BUGS
  102. These filters are not complete interpreters of
  103. .I troff
  104. or
  105. .IR tex .
  106. For example, macro definitions containing
  107. .L \e$
  108. cause chaos in
  109. .IR deroff
  110. when the popular
  111. .L $$
  112. delimiters for
  113. .I eqn
  114. are in effect.
  115. .PP
  116. Text inside macros is emitted at place of
  117. definition, not place of call.