Blame - man/man1/deroff.1 - plan9

blob: 18d62280d85a93e244f137595bf65c32b56b3095 [file] [log] [blame]

rsc	cfa37a7	2004-04-10 18:53:55 +0000	[diff] [blame]	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
rsc	058b011	2005-01-03 06:40:20 +0000	[diff] [blame]	70	.IR ms (7)
rsc	cfa37a7	2004-04-10 18:53:55 +0000	[diff] [blame]	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
rsc	b5fdffe	2004-04-19 19:22:56 +0000	[diff] [blame]	94	.B /usr/local/plan9/src/cmd/deroff.c
rsc	cfa37a7	2004-04-10 18:53:55 +0000	[diff] [blame]	95	.br
rsc	058b011	2005-01-03 06:40:20 +0000	[diff] [blame]	96	.B /usr/local/plan9/src/cmd/delatex.lx
rsc	cfa37a7	2004-04-10 18:53:55 +0000	[diff] [blame]	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	.br
				116	Text inside macros is emitted at place of
				117	definition, not place of call.