home *** CD-ROM | disk | FTP | other *** search
/ NetNews Usenet Archive 1992 #16 / NN_1992_16.iso / spool / comp / sys / sgi / 11415 < prev    next >
Encoding:
Text File  |  1992-07-26  |  1.9 KB  |  46 lines
  1. Newsgroups: comp.sys.sgi
  2. Path: sparky!uunet!usc!elroy.jpl.nasa.gov!decwrl!sgi!rhyolite!vjs
  3. From: vjs@rhyolite.wpd.sgi.com (Vernon Schryver)
  4. Subject: Re: Audio Questions
  5. Message-ID: <nq50jj4@rhyolite.wpd.sgi.com>
  6. Organization: Silicon Graphics, Inc.  Mountain View, CA
  7. References: <1992Jul25.163827.22304@news.iastate.edu> <nobregg@zuni.esd.sgi.com> <1992Jul26.222526.9166@news.iastate.edu>
  8. Date: Mon, 27 Jul 1992 02:38:30 GMT
  9. Lines: 35
  10.  
  11. In article <1992Jul26.222526.9166@news.iastate.edu>, bryan@pi.eai.iastate.edu (Bryan Manske) writes:
  12. > ...
  13. > Suggestion:  For the love of sanity, Someone PLEASE compile a comprehesive
  14. >              index for the hardbound manual sets with each (major) system
  15. >              release.
  16.  
  17. Sorry, but who should do that?  More to the point, who would?
  18.  
  19. A useful index would not be just the result of an index/TOC pass by
  20. text processing software.  Someone must go through all of the manuals
  21. and note the location of all of the good stuff.
  22.  
  23. The tech-writers will tell you that they do not get a fraction of the
  24. reviewing their efforts deserve.  Programmers are too busy doing other
  25. things that we find much more interesting than re-re-proof-reading
  26. manuals, including wasting time on netnews.  It is very hard to read
  27. something that goes on for pages and pages about stuff you are more
  28. than just a little familiar with.  You're too likely to pick out a
  29. place to improve and go work on the code.  You're too likely to read a
  30. page or a chapter and say "sheesh.  what obvious stuff!  why do they
  31. bother to waste paper on this?  everyone knows how that", whether
  32. "that" is the order of implicit rule applications in sendmail, the names
  33. of the fields in the kernel exception frame, or the undocumented args
  34. to uucico.
  35.  
  36. This is a hard problem.
  37.  
  38.  
  39. By the way, the following line in your article is not strictly legal
  40. and probably significantly and unnecessarily reduced its propagation:
  41.  
  42. Distribution: na
  43.  
  44.  
  45. Vernon Schryver,  vjs@sgi.com
  46.