home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 22 gnu / 22-gnu.zip / gnugroff.zip / README.OS2 < prev   
Internet Message Format  |  1996-05-05  |  5KB
  1. Date: Feb 24th 1994
  2. Version of groff: 1.10
  3. Version of emx: 0.9b, fix 3
  4.  
  5. ----------------------------------------------------------------------
  6.  
  7. This is the OS/2 version of the GNU groff document formatting system.
  8. See src/README, src/VERSION and src/COPYING for more information about
  9. GNU groff.
  10.  
  11. This OS/2 version requires at least OS/2 2.0 (it is a 32-bit
  12. application). It was ported using the emx/gcc/g++ development
  13. environment.
  14.  
  15. The troff document formatting system looks a bit ancient nowadays and
  16. I would certainly not suggest computer and OS/2 newcomers to use it to
  17. produce documents (there are more convenient programs, such as TeX or
  18. WYSIWYG word processors for the Presentation Manager). However, for
  19. those with Unix and troff experience it is a useful program if they
  20. want to continue using already existing documents under OS/2.
  21.  
  22. The OS/2 version supports all relevant output devices for which support
  23. is included with the original groff source code (i.e. not X11):
  24.  
  25. - ASCII
  26. - ISO Latin-1   (although this may be not very useful on an OS/2 PC)
  27. - TeX dvi       (works well with emTeX)
  28. - PostScript    (any PostScript printer or GhostScript)
  29. - HP PCL5       (HP LaserJet 4 and compatible printers)
  30.  
  31. In addition, the following two new sub-devices of tty are available:
  32.  
  33. - Codepage 850
  34. - Codepage 437
  35.  
  36. They are intended for output to OS/2 character displays or line
  37. printers. Codepage 850 is normally used for OS/2 character mode
  38. sessions, sometimes also 437. The less pager can be used to view this
  39. output conveniently. Codepage 437 is normally supported by PC line
  40. printers (such as dot matrix printers). Laser printers should normally
  41. be used with the TeX dvi, HP PCL5 or PostScript devices.
  42.  
  43. Please see the man/ subdirectory for the manual pages for the groff
  44. system. These files are in groff input file format, so they have to be
  45. formatted with groff first.
  46.  
  47. Changes:
  48.  
  49. - new cp437 and cp850 devices as described above
  50. - dev prefix removed from device subdirectories
  51.   (because of 8.3 naming restrictions)
  52. - tmac. prefix removed from macro files in tmac/ for the same reason
  53. - doc- prefix removed from files in tmac/mdoc/, same reason
  54.  
  55. - New printlp and printdvi programs: Printlp captures all stdin input
  56.   and spools it to "lpt1" (default) or the output device set in the
  57.   environment variable LP_DEVICE. Printdvi captures all stdin input
  58.   into a temporary file and calls the command "v" with the name as
  59.   argument (v is the viewer in emTeX) or the command in the
  60.   environment variable DVI_PRINT_COMMAND. If the command contains a
  61.   %s, this will be replaced by the temporary file name.
  62.  
  63. - Printlp and printdvi are used as the spool programs for the ps/lj4
  64.   and dvi devices when groff is invoked with the -l option.
  65.  
  66. - If groff is invoked for the tty device (ascii, latin1, cp437, cp850)
  67.   with the -l (spool) option, then the less pager is used as the
  68.   "spooling" program.
  69.  
  70. - Groff looks for subprograms to invoke not only via PATH but also in
  71.   the directory where it was invoked from itself.
  72.  
  73. - The subprograms gtroff, geqn, gpic, gtbl, gsoelim and grefer have
  74.   been renamed to troff, eqn, pic, tbl, soelim and refer because no
  75.   such programs already exist for OS/2 (unlike Unix).
  76.  
  77. To install groff for OS/2, simply unpack the groff executables archive
  78. with the unzip or zoo program from the root of you harddisk (all
  79. files go into subdirectories bin, man and lib) and then include
  80. c:\bin in your PATH environment variable (substitute c: with the
  81. drive where you installed groff). Make sure you have the emx runtime
  82. (groff requires emx.dll and emxlibc.dll) installed
  83.  
  84. If you don't install groff into the default directory structure, you
  85. need to set a few environment variables to allow groff to find its
  86. files:
  87.  
  88.         GROFF_FONT_PATH         defaults to /lib/groff/font
  89.         GROFF_TMAC_PATH         defaults to /lib/groff/tmac
  90.         REFER                   defaults to /lib/groff/dict/papers/ind
  91.  
  92. You also need to set these environment variables, if you call groff
  93. from another drive than the one where it is installed.
  94.  
  95. The default output device is "ascii". To change this, set the
  96. environment variable GROFF_TYPESETTER to latin1, cp437, cp850, dvi,
  97. lj4 or ps, whatever you want.
  98.  
  99. The executables archive does also contain all other required files,
  100. such as font descriptions for all devices, macro files and manual
  101. pages for groff. The sources archive is only required if you need to
  102. make changes to groff and recompile it.
  103.  
  104.  
  105. Kai Uwe Rommel
  106.  
  107. --
  108. /* Kai Uwe Rommel      ARS Computer & Consulting GmbH, Muenchen, Germany *
  109.  * rommel@ars.de             CompuServe 100265,2651, Fax +49 89 324 4524 *
  110.  * rommel@leo.org (ftp.leo.org:/pub/comp/os/os2 maintenance)             */
  111.  
  112. DOS ... is still a real mode only non-reentrant interrupt
  113. handler, and always will be.                -Russell Williams
  114.