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