unroff(1) [linux man page]

UNROFF(1)						      General Commands Manual							 UNROFF(1)

NAME

       unroff - convert troff documents to plain text

SYNTAX

       unroff [ -E ] [ -J ] [ -8 ] [ -mxx ] [ file ...	]

DESCRIPTION

       unroff  processes  documents  written  to be formatted with troff (or nroff, or any of the other *roff variants) and converts them to plain
       text.  This is similar to what deroff does, but the result is sometimes better than deroff output.

       Optional flags may be given to modify the operation of unroff, as follows:

       -E     Echo input tokens as they are read.  Useful mainly for debugging.

       -J     Join output lines that would be part of a single paragraph so they form a single output line.  This is useful if you  plan  to  move
	      the  resulting output into a document formatter that treats paragraphs as a single line.	The default is to do line wrapping accord-
	      ing to the line length specified in the input document.

       -8     Write 8-bit ISO Latin-1 (ISO 8859-1) characters.	This option may be useful for producing output intended to be  viewed  on  devices
	      capable  of  8-bit  character  display.	Without  this  option,	8-bit  Latin-1	characters  will  generall appear in the output as
	      ``[[name]]'' where ``name'' is the troffcvt internal name for the character, e.g., ``[[Aacute]]''.  For some of these characters, an
	      ASCII approximation will be used if something reasonably close is available.

       -mxx   Specify macro package, usually -man, -me, -mm, or -ms.

DIAGNOSTICS

       line  length clipped to nnn chars.  A very long line length was requested, so long that it would likely result in output line assembly buf-
       fer overflow.  The length is clipped to prevent this.

       output buffer capacity exceeded.  This means some line is so long that it couldn't be collected in the output line assembly  buffer.   Most
       likely this signals a bug in tc2text, since the length is supposed to be kept within reasonable bounds (see previous paragraph).

SEE ALSO

       troffcvt(1), tc2text(1)

WHO-TO-BLAME
       Paul DuBois, dubois@primate.wisc.edu.

BUGS

       unroff doesn't do so well with tables, particularly tables with multiple-line cells.  Table centering isn't handled.

																	 UNROFF(1)

Check Out this Related Man Page

DEROFF(1)						    BSD General Commands Manual 						 DEROFF(1)

NAME

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

SYNOPSIS

     deroff [-ikpw] [-m a | e | l | m | s] [file ...]

DESCRIPTION

     deroff reads each file in sequence and removes all nroff(1) and troff(1) command lines, backslash constructions, macro definitions, eqn(1)
     constructs (between ``.EQ'' and ``.EN'' lines or between delimiters), pic(1) pictures, and table descriptions and writes the remainder to the
     standard output.  deroff follows chains of included files (``.so'' and ``.nx'' commands); if a file has already been included, a ``.so'' is
     ignored and a ``.nx'' terminates execution.  If no input file is given, deroff reads from the standard input.

     The options are as follows:

     -i      Ignore ``.so'' and ``.nx'' commands.

     -k      Keep blocks of text intact.  This is the default behavior unless the -m option is given.

     -m      Enable support for common macro packages.	The -m option takes the following arguments:
		   a	   recognize man(7) macros.
		   e	   recognize me(7) macros.
		   l	   remove list constructs.
		   m	   recognize mm(7) macros.
		   s	   recognize ms(7) macros.

     -p      Preserve paragraph macros.  This option only has an effect if the -m option is also specified.

     -w      Output a word list, one 'word' (string of letters, digits, and apostrophes, beginning with a letter; apostrophes are removed) per
	     line, and all other characters ignored.  Normally, the output follows the original, with the deletions mentioned above.

SEE ALSO

     eqn(1), nroff(1), pic(1), tbl(1), troff(1)

HISTORY

     deroff appeared in Version 7 AT&T UNIX.

BUGS

     deroff is not a complete troff(1) interpreter, so it can be confused by subtle constructs.  Most errors result in too much rather than too
     little output.

     The -ml option does not correctly handle nested lists.

BSD
								   June 6, 1993 							       BSD

Linux and UNIX Man Pages

unroff(1) [linux man page]

Check Out this Related Man Page