Return to deroff CVS log

Up to [Plan 9 NeXT] / lucent / sys / man / 1

Annotation of lucent/sys/man/1/deroff, revision 1.1.1.1

1.1       root        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 -i
                     52: Ignore
                     53: .L .so
                     54: and
                     55: .L .nx
                     56: requests.
                     57: .TP
                     58: .BR -ms
                     59: .PD0
                     60: .TP
                     61: .B -mm
                     62: Remove titles, attachments, etc., as well as ordinary 
                     63: .IR troff
                     64: constructs, from
                     65: .IR ms (6)
                     66: or
                     67: .I mm
                     68: documents.
                     69: .PD
                     70: .TP
                     71: .B -ml
                     72: Same as
                     73: .BR -mm ,
                     74: but remove lists as well.
                     75: .PP
                     76: .I Delatex
                     77: does for
                     78: .I tex
                     79: and
                     80: .I latex
                     81: (see
                     82: .IR tex (1))
                     83: files what
                     84: .B deroff -wi
                     85: does for
                     86: .I troff
                     87: files.
                     88: .SH SOURCE
                     89: .B /sys/src/cmd/deroff.c
                     90: .SH "SEE ALSO"
                     91: .IR troff (1), 
                     92: .IR tex (1),
                     93: .IR spell (1)
                     94: .SH BUGS
                     95: These filters are not complete interpreters of
                     96: .I troff
                     97: or
                     98: .IR tex .
                     99: For example, macro definitions containing
                    100: .L \e$
                    101: cause chaos in
                    102: .IR deroff
                    103: when the popular
                    104: .L $$
                    105: delimiters for
                    106: .I eqn
                    107: are in effect. 
                    108: .br
                    109: Text inside macros is emitted at place of
                    110: definition, not place of call.

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