Return to deroff.1 CVS log

Up to [Research Unix] / researchv10dc / man / man1

Annotation of researchv10dc/man/man1/deroff.1, revision 1.1.1.1

1.1       root        1: .TH DEROFF 1 
                      2: .CT 1 writing_aids
                      3: .SH NAME
                      4: deroff, demonk, detex, delatex \- remove formatting requests
                      5: .SH SYNOPSIS
                      6: .B deroff
                      7: [
                      8: .I option ...
                      9: ]
                     10: .I file ...
                     11: .PP
                     12: .B demonk
                     13: [
                     14: .I option ...
                     15: ]
                     16: .I file ...
                     17: .PP
                     18: .B detex
                     19: .I file
                     20: .PP
                     21: .B delatex
                     22: .I file
                     23: .SH DESCRIPTION
                     24: .I Deroff
                     25: reads each file in sequence
                     26: and removes all
                     27: .I nroff
                     28: and
                     29: .IR troff (1)
                     30: requests and non-text arguments, backslash constructions,
                     31: and constructs of preprocessors such as
                     32: .I eqn, pic,
                     33: and
                     34: .IR tbl (1).
                     35: Remaining text is written on the standard output.
                     36: .I Deroff
                     37: follows files included by
                     38: .L .so
                     39: and
                     40: .L .nx
                     41: commands;
                     42: if a file has already been included, a
                     43: .L .so
                     44: for that file is ignored and a
                     45: .L .nx
                     46: terminates execution.
                     47: If no input file is given,
                     48: .I deroff
                     49: reads from standard input.
                     50: .PP
                     51: The options are
                     52: .TP
                     53: .B -w
                     54: Output a word list, one `word' (string of letters, digits, and
                     55: properly embedded ampersands and apostrophes,
                     56: beginning with a letter) per line.
                     57: Other characters are skipped.
                     58: Otherwise, the output follows the original, with the deletions mentioned above.
                     59: .TP
                     60: .B -i
                     61: Ignore
                     62: .L .so
                     63: and
                     64: .L .nx
                     65: requests.
                     66: .TP
                     67: .BR -ms
                     68: .PD0
                     69: .TP
                     70: .B -mm
                     71: Remove titles, attachments, etc., as well as ordinary 
                     72: .IR troff
                     73: constructs, from
                     74: .IR ms (6)
                     75: or
                     76: .I mm
                     77: documents.
                     78: .PD
                     79: .TP
                     80: .B -ml
                     81: Same as
                     82: .BR -mm ,
                     83: but remove lists as well.
                     84: .PP
                     85: .I Demonk
                     86: removes all
                     87: .IR monk (1)
                     88: commands and then invokes
                     89: .I deroff
                     90: to handle both
                     91: .I troff
                     92: commands and preprocessor constructs.
                     93: .I Demonk
                     94: follows files included by
                     95: .L |\^insert
                     96: and
                     97: .L |\^source
                     98: commands as well as
                     99: .I troff
                    100: .L .so
                    101: and
                    102: .L .nx
                    103: requests.
                    104: If no input file is given,
                    105: .I demonk
                    106: reads from standard input.
                    107: .PP
                    108: .I Demonk
                    109: recognizes the following options and passes all options except
                    110: .B -b
                    111: and
                    112: .B -d
                    113: to
                    114: .I deroff .
                    115: .TP
                    116: .B -i
                    117: Ignore
                    118: .I monk
                    119: .L |\^insert
                    120: and
                    121: .L |\^source
                    122: commands as well as
                    123: .I troff
                    124: .L .so
                    125: and
                    126: .L .nx
                    127: requests.
                    128: .TP
                    129: .B -b
                    130: Do not output blank lines resulting from the removal of
                    131: .I monk
                    132: commands.
                    133: .TP
                    134: .BI -d dir
                    135: Use non-standard 
                    136: .I monk
                    137: database directory
                    138: .I
                    139: dir.
                    140: .PP
                    141: .I Detex
                    142: and
                    143: .I delatex
                    144: do for
                    145: .IR tex (1)
                    146: and
                    147: .IR latex (6)
                    148: files what
                    149: .B deroff -w
                    150: does for
                    151: .I troff
                    152: files.
                    153: .I Delatex
                    154: largely subsumes
                    155: .I detex.
                    156: .SH "SEE ALSO"
                    157: .IR troff (1), 
                    158: .IR monk (1), 
                    159: .IR tex (1),
                    160: .IR spell (1),
                    161: .IR wwb (1)
                    162: .SH BUGS
                    163: These filters are not complete interpreters of
                    164: .I troff
                    165: or
                    166: .I tex.
                    167: For example, macro definitions containing
                    168: .L \e$
                    169: cause chaos in
                    170: .IR deroff
                    171: when the popular
                    172: .L $$
                    173: delimiters for
                    174: .I eqn
                    175: are in effect. 
                    176: .br
                    177: Text inside macros is emitted at place of
                    178: definition, not place of call.

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.