NAME

ditroff − device independent text formatting and typesetting

SYNOPSIS

ditroff [ option ] ...  [ file ] ... 

DESCRIPTION

Ditroff formats text in the named files for printing on a phototypesetter.  It is the new "device-independent" version of the old otroff (see nroff(1)). Its capabilities are described in the NROFF/TROFF User Manual plus the Addendum. 

If no file argument is present, the standard input is read.  An argument consisting of a single minus (−) is taken to be a file name corresponding to the standard input. 

This version can process Japanese Kanji characters. 

The options, which may appear in any order so long as they appear before the files, are:

−olist Print only pages whose page numbers appear in the comma-separated list of numbers and ranges.  A range N−M means pages N through M; an initial −N means from the beginning to page N; and a final N− means from N to the end.  (See BUGS below.) 

−nN Number first generated page N.

−sN Generate output to encourage typesetter to stop every N pages. 

−mname Prepend the macro file /usr/lib/tmac/tmac.name to the input files.

−raN Set register a (one character name) to N.

−i Read standard input after the input files are exhausted. 

−q Invoke the simultaneous input-output mode of the .rd request. 

−z Print only messages generated by .tm requests. 

−a Send a printable ASCII approximation of the results to the standard output. 

−Tdest Prepare output for the output device which is specified with dest. Currently supported output device is Canon LBP-8/AJ-2 (lbp8), SONY NWP-533/537 (nwp533). (default is nwp533) If other device name is specified, ditroff will abort. 

To obtain paper print image, user must pipe the output of ditroff to output filter which understands the intermediate file:

ditroff [options] [files...] | lpr −n −Pprinter_name

For details, see printcap(5).

To examine the layout on CRT use X window Previewer, xprev(S).

FILES

/tmp/trtmp∗temporary file

/usr/lib/tmac/tmac.∗standard macro files

/usr/sony/lib/font/devnwp533/∗.outfont width tables

SEE ALSO

eqn(1), mmt(1), nroff(1), pic(1), tbl(1), tc(1), lpr(1), xp(1). 
NROFF/TROFF User Manual with “Addendum on the device-independent TROFF” and “A TROFF Tutorial” . 

BUGS

The .tl request may not be used before the first break-producing request in the input to ditroff.

Troff believes in Eastern Standard Time; as a result, depending on the time of the year and on your local time zone, the date that ditroff generates may be off by one day from your idea of what the date is. 

When ditroff is used with the −olist option inside a pipeline (e.g., with one or more of pic(1), eqn(1), and tbl(1)), it may cause a harmless “broken pipe” diagnostic if the last page of the document is not specified in list.

When level-II Kanji characters are printed with LBP8/AJ-II, they are changed into white squares, since LBP8/AJ-II has no level-II Kanji characters. 

NEWS-OSRelease 3.3