


      DEROFF(1)			    (DWB)		      DEROFF(1)



      NAME
	   deroff - remove nroff/troff,	tbl, and eqn constructs

      SYNTAX
	   deroff [-mx]	[-w] [ files ]

      DESCRIPTION
	   Deroff reads	each of	the files in sequence and removes all
	   troff(1) requests, macro calls, backslash constructs, eqn(1)
	   constructs (between .EQ and .EN lines, and between
	   delimiters),	and tbl(1) descriptions, perhaps replacing them
	   with	white space (blanks and	blank lines), and writes the
	   remainder of	the file on the	standard output.  Deroff
	   follows chains of included files (.so and .nx troff
	   commands); if a file	has already been included, a .so naming
	   that	file is	ignored	and a .nx naming that file terminates
	   execution.  If no input file	is given, deroff reads the
	   standard input.

	   -mx	where x	is m, s, or l; causes the macros to be
		interpreted so that only running text is output	(i.e.,
		no text	from macro lines.)

	   -ml	forces the -mm option and also causes deletion of lists
		associated with	the mm macros.

	   -w	the output is a	word list, one ``word''	per line, with
		all other characters deleted.  Otherwise, the output
		follows	the original, with the deletions mentioned
		above.	In text, a ``word'' is any string that contains
		at least two letters and is composed of	letters,
		digits,	ampersands (&),	and apostrophes	('); in	a macro
		call, however, a ``word'' is a string that begins with
		at least two letters and contains a total of at	least
		three letters.	Delimiters are any characters other
		than letters, digits, apostrophes, and ampersands.
		Trailing apostrophes and ampersands are	removed	from
		``words.''

      SEE ALSO
	   eqn(1), nroff(1), tbl(1), troff(1).

      BUGS
	   Deroff is not a complete troff interpreter, so it can be
	   confused by subtle constructs.  Most	such errors result in
	   too much rather than	too little output.
	   The -ml option does not handle nested lists correctly.








      Page 1					      (73 A2 02MT REV1)



