home *** CD-ROM | disk | FTP | other *** search
/ NetNews Usenet Archive 1992 #31 / NN_1992_31.iso / spool / comp / text / 1514 < prev    next >
Encoding:
Text File  |  1993-01-02  |  1.9 KB  |  40 lines
  1. Newsgroups: comp.text
  2. Path: sparky!uunet!spool.mu.edu!yale.edu!ira.uka.de!smurf.sub.org!flatlin!pilhuhn!nextone!nitezki
  3. From: Nitezki@NiDat.sub.org (Peter Nitezki)
  4. Subject: Re: Easy way to create unix man pages?
  5. Message-ID: <1993Jan2.134151.11399@nidat.sub.org>
  6. Sender: nitezki@nidat.sub.org
  7. Organization: Nitezki Datensysteme, Kraichtal, Germany
  8. References: <1992Dec17.172023.9803@oakhill.sps.mot.com>
  9. Date: Sat, 2 Jan 1993 13:41:51 GMT
  10. Lines: 28
  11.  
  12. In article <1992Dec17.172023.9803@oakhill.sps.mot.com>  
  13. wcl@oakhill.sps.mot.com (Wayne Long) writes:
  14. > 
  15. > I'm looking for a filter, utility, or editor that
  16. > will take normal, what-you-see-is-what-you get
  17. > text, and convert it into a unix man page with
  18. > minimal hassle.
  19.  
  20. In my opinion, only a very sophisticated AI-system could do that, as Unix  
  21. man-pages are roff documents in declarative text format and WYSIWIG texts  
  22. are some kind of text-markup. Since I learned about half a dozen different  
  23. text formatters in between, I have never seen any way to get a good  
  24. translation from declarative to frame based and markup text  
  25. representation. In most cases the way goes back to ASCII and then to the  
  26. desired format by hand.
  27.  
  28. Man-pages are formatted using n(t)roff with an-macros (hence the call  
  29. nroff -man to see the formatted document on screen). The functionality is  
  30. limited so the complexity is quite low, which means it is easy to learn.
  31. Best is to start with a fairly complex example from the man-pages on your  
  32. system and then simply replace the text. You will see it's not too hard to  
  33. guess the functionality of the macros. Anyway, you can also start with a  
  34. textbook on Unix or some special literature on nroff/troff.
  35. -- 
  36. Peter Nitezki        | Nitezki@NiDat.sub.org # Blessed thou who knoweth
  37. NITEZKI DATENSYSTEME | Tel.:  +49 7251 62495 # not about the pleasure and
  38. Staarenbergstr. 44   | Fax :  +49 7251 69215 # delight of being hooked
  39. D-7527 Kraichtal 2   | GERMANY               # up to the Net. Peter 1,3-5
  40.