Date: Feb 24th 1994
Version of groff: 1.10
Version of emx: 0.9b, fix 3

----------------------------------------------------------------------

This is the OS/2 version of the GNU groff document formatting system.
See src/README, src/VERSION and src/COPYING for more information about
GNU groff.

This OS/2 version requires at least OS/2 2.0 (it is a 32-bit
application). It was ported using the emx/gcc/g++ development
environment.

The troff document formatting system looks a bit ancient nowadays and
I would certainly not suggest computer and OS/2 newcomers to use it to
produce documents (there are more convenient programs, such as TeX or
WYSIWYG word processors for the Presentation Manager). However, for
those with Unix and troff experience it is a useful program if they
want to continue using already existing documents under OS/2.

The OS/2 version supports all relevant output devices for which support
is included with the original groff source code (i.e. not X11):

- ASCII
- ISO Latin-1   (although this may be not very useful on an OS/2 PC)
- TeX dvi       (works well with emTeX)
- PostScript    (any PostScript printer or GhostScript)
- HP PCL5       (HP LaserJet 4 and compatible printers)

In addition, the following two new sub-devices of tty are available:

- Codepage 850
- Codepage 437

They are intended for output to OS/2 character displays or line
printers. Codepage 850 is normally used for OS/2 character mode
sessions, sometimes also 437. The less pager can be used to view this
output conveniently. Codepage 437 is normally supported by PC line
printers (such as dot matrix printers). Laser printers should normally
be used with the TeX dvi, HP PCL5 or PostScript devices.

Please see the man/ subdirectory for the manual pages for the groff
system. These files are in groff input file format, so they have to be
formatted with groff first.

Changes:

- new cp437 and cp850 devices as described above
- dev prefix removed from device subdirectories
  (because of 8.3 naming restrictions)
- tmac. prefix removed from macro files in tmac/ for the same reason
- doc- prefix removed from files in tmac/mdoc/, same reason

- New printlp and printdvi programs: Printlp captures all stdin input
  and spools it to "lpt1" (default) or the output device set in the
  environment variable LP_DEVICE. Printdvi captures all stdin input
  into a temporary file and calls the command "v" with the name as
  argument (v is the viewer in emTeX) or the command in the
  environment variable DVI_PRINT_COMMAND. If the command contains a
  %s, this will be replaced by the temporary file name.

- Printlp and printdvi are used as the spool programs for the ps/lj4
  and dvi devices when groff is invoked with the -l option.

- If groff is invoked for the tty device (ascii, latin1, cp437, cp850)
  with the -l (spool) option, then the less pager is used as the
  "spooling" program.

- Groff looks for subprograms to invoke not only via PATH but also in
  the directory where it was invoked from itself.

- The subprograms gtroff, geqn, gpic, gtbl, gsoelim and grefer have
  been renamed to troff, eqn, pic, tbl, soelim and refer because no
  such programs already exist for OS/2 (unlike Unix).

To install groff for OS/2, simply unpack the groff executables archive
with the unzip or zoo program from the root of you harddisk (all
files go into subdirectories bin, man and lib) and then include
c:\bin in your PATH environment variable (substitute c: with the
drive where you installed groff). Make sure you have the emx runtime
(groff requires emx.dll and emxlibc.dll) installed

If you don't install groff into the default directory structure, you
need to set a few environment variables to allow groff to find its
files:

        GROFF_FONT_PATH         defaults to /lib/groff/font
        GROFF_TMAC_PATH         defaults to /lib/groff/tmac
        REFER                   defaults to /lib/groff/dict/papers/ind

You also need to set these environment variables, if you call groff
from another drive than the one where it is installed.

The default output device is "ascii". To change this, set the
environment variable GROFF_TYPESETTER to latin1, cp437, cp850, dvi,
lj4 or ps, whatever you want.

The executables archive does also contain all other required files,
such as font descriptions for all devices, macro files and manual
pages for groff. The sources archive is only required if you need to
make changes to groff and recompile it.


Kai Uwe Rommel

--
/* Kai Uwe Rommel      ARS Computer & Consulting GmbH, Muenchen, Germany *
 * rommel@ars.de             CompuServe 100265,2651, Fax +49 89 324 4524 *
 * rommel@leo.org (ftp.leo.org:/pub/comp/os/os2 maintenance)             */

DOS ... is still a real mode only non-reentrant interrupt
handler, and always will be.                -Russell Williams
