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