home *** CD-ROM | disk | FTP | other *** search
/ NetNews Usenet Archive 1992 #16 / NN_1992_16.iso / spool / comp / unix / programm / 3989 < prev    next >
Encoding:
Text File  |  1992-07-29  |  2.0 KB  |  46 lines
  1. Newsgroups: comp.unix.programmer
  2. Path: sparky!uunet!psgrain!hippo!ucthpx!aim1!aim1!gram
  3. From: gram@aim1.aztec.co.za (Graham Wheeler)
  4. Subject: USL's crap manuals
  5. Message-ID: <gram.712420941@aim1>
  6. Organization: Aztec Information Management
  7. Date: Wed, 29 Jul 1992 14:42:21 GMT
  8. Lines: 36
  9.  
  10. This is just a gripe I want to get off my chest. I am seriously questioning
  11. the whole idea of UNIX being an open system. For one thing, you have this
  12. great concept of virtual file systems under SVR4. All very well, but let's
  13. say you now want to write code to support a new file system type. Good luck.
  14. It isn't documented in any of the manuals. There are a number of other
  15. examples, but file systems in particular should be documented (especially
  16. as there are glaring omissions, like no ISO9660 CD-ROM file system type).
  17.  
  18. My personal gripe is the STREAMS manual. Close on 200 pages that could 
  19. be chopped down to probably about 50. You have to really search for
  20. information, because it is so scattered around the place. Unless you're
  21. writing really trivial stuff, the manual isn't going to have half the
  22. information you need (maybe it does, but try to find it without resorting
  23. to re-reading the whole thing). And how publishers manage to get typos into
  24. source code in this day and age I don't know. The STREAMS manual has an
  25. appendix on debugging that is seriously in need of debugging itself. Take
  26. just one page as an example (D-12):
  27.  
  28.     cmn_err(CE_CONT,"^DUMP: 0 len data msg %s.0,
  29.             (dir==D_OUT)?"OUT":"IN");
  30.  
  31.     ...
  32.     cmn_err(CE_CONT,"^0UMP: non-data b_cont0);
  33.  
  34. These are the obvious ones, but it makes one wonder just how much you can
  35. trust these manuals.
  36.  
  37. GrumbleGrumbleGrumbleGrumbleGrumbleGrumbleGrumbleGrumbleGrumble!!!!!!
  38.  
  39. Hoo, boy, it's been a bad day 8-(.
  40.  
  41. -- 
  42. Graham Wheeler                     | "That which is weak conquers the strong,
  43. Software Systems Engineer/Student  | that which is soft conquers the hard."
  44. Aztec Information Management/UCT   |         Lao Tzu - Tao Te Ching Ch. 78
  45. gram@aim1.aztec.co.za / gram@cs.uct.ac.za 
  46.