home *** CD-ROM | disk | FTP | other *** search
/ NetNews Usenet Archive 1992 #31 / NN_1992_31.iso / spool / comp / sys / sgi / admin / 93 < prev    next >
Encoding:
Text File  |  1992-12-30  |  2.2 KB  |  50 lines

  1. Newsgroups: comp.sys.sgi.admin
  2. Path: sparky!uunet!zaphod.mps.ohio-state.edu!sdd.hp.com!ncr-sd!crash!photon.photon.com!jhp
  3. From: jhp@photon.com (Jim Patterson)
  4. Subject: Re: writing man pages
  5. Message-ID: <1992Dec30.160918.15065@photon.com>
  6. Sender: usenet@photon.com (Usenet dummy users)
  7. Reply-To: jhp@photon.com
  8. Organization: Photon Research Associates, Inc.
  9. X-Newsreader: TIN [version 1.1 PL6]
  10. References: <STEVEMW.92Dec30005611@wvirginia.wv.tek.com>
  11. Date: Wed, 30 Dec 1992 16:09:18 GMT
  12. Lines: 36
  13.  
  14. Stephen M. Wynne (stevemw@wvirginia.wv.tek.com) wrote:
  15. : In article <1hqdjfINNrlh@tamsun.tamu.edu> vamsee@abgen.tamu.edu (Vamsee Lakamsani) writes:
  16. : >   We have some in-house  applications and we would like to write         
  17. : >   man pages for them so that these man pages look just like the 
  18. : >   standard UNIX man pages (describing command line options, version 
  19. : >   information etc.) What is the best way to do this on an SGI,
  20. : >   1. If the system has nroff/troff ?
  21. : >   2. If the system does not have nroff/troff ?
  22. : I realize that the DWB is a valuable product to ATT, and hence its
  23. : value-added (cough) price when UNIX distributors pass it on to us.
  24. : However, there is a nice package called groff from the GNU folks
  25. : that works really great. I'd like feedback from those of you who
  26. : are using it to completely replace the DWB -- I haven't successfully
  27. : gotten it to do things that the SGI versions of the DWB can do such
  28. : as formatting manual pages with the man(1) command. I format with
  29. : groff -man -Tascii > catn/foo.n.
  30.  
  31. I have completely replaced DWB with groff.  What I had to do was to
  32. link the groff executables to the names that the man command expects.
  33. You can find out what man wants by using the -p option.  You also need
  34. to make the directories /usr/pub and /usr/lib/tmac.  There needs to be
  35. any empty file /usr/pub/eqnchar and you need to copy the contents of
  36. the groff tmac directory to /usr/lib/tmac.
  37.  
  38. Hope this helps,
  39.  
  40. Jim
  41.  
  42. -- 
  43. James Patterson                 photon!jhp@ucsd.edu      jhp@photon.com
  44. Photon Research Associates   619-455-9741 (voice)     619-546-3903 (fax)
  45. "... three great virtues of a programmer: laziness,impatience and hubris "
  46.      Larry Wall in _Programming Perl_
  47.