plan9port

fork of plan9port with libvec, libstr and libsdb
Log | Files | Refs | README | LICENSE

deroff.1 (1820B)


      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 .MR troff (1)
     20 requests and non-text arguments, backslash constructions,
     21 and constructs of preprocessors such as
     22 .MR eqn (1) ,
     23 .MR pic (1) ,
     24 and
     25 .MR 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 .MR ms (7)
     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 .MR tex (1) )
     88 files what
     89 .B deroff -wi
     90 does for
     91 .I troff
     92 files.
     93 .SH SOURCE
     94 .B \*9/src/cmd/deroff.c
     95 .br
     96 .B \*9/src/cmd/delatex.lx
     97 .SH "SEE ALSO"
     98 .IR troff (1), 
     99 .MR tex (1) ,
    100 .MR 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.