sys/man/1/deroff

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