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 and Korean 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. 

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).

Currently output devices supported by standard output filters,
 which supported only Japanese, are Canon LBP−8 II AJ−2 and
 SONY NWP-533/537/543/550 .
To examine the layout on CRT use X window Previewer, xprev(1).

FILES

/tmp/trtmp∗temporary file

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

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

/usr/sony/lib/lpf_lbpnfoutput filter for  NWP-533/537/543/550

/usr/sony/lib/lpf_lbp8nfoutput filter for  LBP−8 II AJ-2

SEE ALSO

eqn(1), nroff(1), pic(1), a3pic(1), tbl(1), tc(1), lpr(1), xprev(1), printcap(5), intro(7)
NROFF/TROFF User Manual with “Addendum on the device-independent TROFF” and “A TROFF Tutorial” . 

J.F.Ossanna  Nroff/Troff user’s manual

B.W.Kernighan,  A Troff Tutorial

" NEWS-OS Release 4.0 USER’S GUIDE / ditroff "

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 Japanese Kanji characters are printed with LBP−8 II AJ−2, they are changed into white squares, since LBP−8 II AJ−2 has no level-II Japanese Kanji characters. 

NEWS-OSRelease 4.1C