home *** CD-ROM | disk | FTP | other *** search
/ Internet File Formats / InternetFileFormatsCD.bin / text / troff / dos / readme.dos < prev    next >
Encoding:
Text File  |  1992-04-24  |  2.8 KB  |  67 lines
  1. DOS implementation of the GROFF Troff program (based on version 1.05).
  2.  
  3. This ZIP file contains compiled programs and files for DOS version of
  4. GNU TROFF program GROFF. GROFF is developed by James Clark
  5. (jjc@jclark.com). I distribute this version, since so many has asked
  6. me to.
  7.  
  8. The programs are compiled using DJGPP compilers (GNU C for DOS by D.J.
  9. Delorie, dj@ctron.com). Programs compiled with these programs need 386
  10. machine. I have the 387 emulator with the package, so if you don't
  11. have either 387 coprosessor or 486 prosessor, set GO32 environment
  12. variable as
  13.  
  14.   SET GO32=emu c:\dirs\emu387
  15.  
  16. where c:\dirs is place where you have the programs.
  17.  
  18. The package does not have any documentation on the usage of the groff
  19. programs. Take the groff package and use its documents.
  20.  
  21. Following is the contents of the archive file. Files with name
  22. djgpp.mak and djgpp.fix are for recompilation of the groff package.
  23. These files are meant to be on same directories as the groff sources.
  24. The files djgpp.mak are makefiles for DMAKE make-program. The files
  25. djgpp.fix describes the fixes I had to make on some programs.
  26. Actually, the was not very many changes needed. Since djgpp does not
  27. have pipe-functions, popen() and pclose() calles had to be removed.
  28. In groff makefiles, some header files are generated on the fly. Those
  29. I generated by had.
  30.  
  31. The programs are compiled so that they search from directory
  32. /usr/local/lib/groff. These means that you have to expand this archive
  33. (with pkunzip -d) on your harddisk's root or at least move the usr/...
  34. files to the root. Compiled are the troff, eqn, pic, refer, tbl and
  35. drivers for PostScript and TTY. On the /usr/local/lib/groff are files
  36. for PostScript and TTY printing. I have tested only PostScript printing, 
  37. so if you need tty output, you should read 
  38. the groff package for futher instructions. Groff supports also DVI
  39. printing, but I did not compile it, since MS-DOS does not have binary
  40. standard output.
  41.  
  42. I have not make any groff driver programs. To use the groff, you can
  43. use either temporary files or pipes (that is, DOS pipes which are
  44. implemented by temporary files). For example, if you have a file made
  45. by TBL and it uses MS macros, use either
  46.  
  47.    tbl doc.ms > doc.t1
  48.    troff -ms < doc.t2 > doc.t3
  49.    grops < doc.t3 > doc.ps
  50.    del doc.t?
  51.    (do what you do to print PostScript file)
  52.  
  53. or
  54.  
  55.    tbl doc.ms | troff -ms | grops > doc.ps
  56.  
  57. If you need more information, take the groff package and read its
  58. manuals. I found groff from ftp.funet.fi (/pub/gnu/groff-1.05.tar.Z),
  59. but I am sure you can find it from other places also.
  60.  
  61. I compiled the package using djgpp GNU-C version 1.06. You can ftp it
  62. from grape.ecs.clarksonn.edu, directory /pub/msdos/djgpp.
  63.  
  64. Arto V. Viitanen
  65. Lempäälä, Finland
  66. email: av@cs.uta.fi
  67.