home *** CD-ROM | disk | FTP | other *** search
/ Aminet 10 / aminetcdnumber101996.iso / Aminet / util / gnu / groff_bin.lha / groff-1.10bin / README_amiga < prev   
Text File  |  1995-12-10  |  3KB  |  70 lines
  1. This archive contains everything required to install version 1.10 of the GNU
  2. roff text formating package and its documentation.
  3.  
  4. To install:
  5. If you have a GNU: directory hierarchy, simply copy the contents of the GNU
  6. directory there. If not, copy the GNU directory somewhere on your hard disk
  7. and assign GNU: to it. You will also need version 41.4 or higher of
  8. ixemul.library (available on aminet).
  9.  
  10. On my Amiga I also have the following assigns:
  11. assign USR: GNU:
  12. assign BIN: GNU:bin
  13. They should not be necessary, but I have not tested this.
  14.  
  15. If you are upgrading from version 1.09, delete the contents of directory
  16. GNU:lib/groff (or USR:lib/groff). Make sure you copy any files you may have
  17. added there yourself (like fonts or macro packages) to GNU:share/groff before
  18. deleting them.
  19.  
  20. All binaries have been compiled with -m68000 -msoft-float, so they should run
  21. on any Amiga, provided you have enough memory. If you are tight on memory, you
  22. can use groff's -V option to see which programs must be invoked, and invoke
  23. each one by hand, instead of having groff load them all simultaneously.
  24. E.g., "groff -V -ms t.ms" displays "gtroff -Tps t.ms | grops", which means
  25. that you should do something like:
  26.     gtroff -Tps t.ms >a.tmp
  27.     grops <a.tmp
  28.  
  29. Groff usually runs comfortably with a 20K stack, though it occasionally might
  30. need a bit more.
  31.  
  32. Programs gneqn and gnroff are UNIX shell scripts, and programs afmtodit and
  33. grog are UNIX perl scripts. To run them, you will need to invoke them from a
  34. unix-compatible shell like pdksh or sksh. (In the sksh case, you must change
  35. the first line in each script to AmigaOS notation, i.e., change #!/gnu/bin/sh
  36. to #!gnu:bin/sh, and invoke scripts using their full path name, i.e.,
  37. gnu:bin/gnroff instead of gnroff).
  38.  
  39. The documentation for the package is in UNIX man format. You can use groff to
  40. format the various man pages as follows:
  41.     gnroff -man groff.1 >groff.man
  42. or, if you can't invoke UNIX shell scripts,
  43.     groff -Tascii -man groff.1 >groff.man
  44. The formated man pages can be viewed with a paging program like "more",
  45. "muchmore", or "less". If you use "less", the man pages will be displayed in a
  46. more fancy way.
  47.  
  48. Alternatively, you can print the man pages on a laser printer:
  49.     groff -man groff.1 >groff.ps
  50. (if you have a PostScript printer) or
  51.     groff -Tlj4 -man groff.1 >groff.lj
  52. (if you have a PCL5 compatible printer, like a HP laserjet)
  53.  
  54. I have included two additional macro packages, tmac.a4 and tmac.la4, which I
  55. have been using at work for some time, to print on A4 paper--something like
  56. this was supposed to have been added to this version of groff, but for some
  57. reason didn't make it.
  58.  
  59. Thus, to print on A4 paper in portrait mode, use something like:
  60.     groff -man -ma4 groff.1 >groff_a4.ps
  61. and to print on A4 paper in landscape mode, use something like:
  62.     groff -man -mla4 -P-l groff.1 >groff_a4_l.ps
  63.     (this should also work with -Tlj4, but I have not tested it)
  64.  
  65. Happy formatting,
  66. -- 
  67.     Kriton    (UUCP:     pythia!theseas!kriton!kyrimis)
  68.               (INTERNET: kyrimis@theseas.softlab.ece.ntua.gr)
  69.               (WWW:      http://www.hpcl.cti.gr/~kyrimis
  70.