home *** CD-ROM | disk | FTP | other *** search
/ NetNews Usenet Archive 1992 #30 / NN_1992_30.iso / spool / gnu / misc / discuss / 3995 < prev    next >
Encoding:
Text File  |  1992-12-16  |  2.7 KB  |  66 lines
  1. Newsgroups: gnu.misc.discuss
  2. Path: sparky!uunet!mcsun!sunic!dkuug!daimi!lynbech
  3. From: lynbech@daimi.aau.dk (Christian Lynbech)
  4. Subject: Re: texinfo manual for C library functions
  5. Message-ID: <1992Dec16.090822.23542@daimi.aau.dk>
  6. Sender: news@daimi.aau.dk
  7. Organization: DAIMI: Computer Science Department, Aarhus University, Denmark
  8. References: <FISCHER.92Dec15014923@thor.iesd.auc.dk> <1992Dec15.042930.23371@pasteur.Berkeley.EDU> <DREIER.92Dec14235242@durban.berkeley.edu> <1glavuINNd1g@agate.berkeley.edu> <1992Dec15.194401.62079@cc.usu.edu>
  9. Date: Wed, 16 Dec 92 09:08:22 GMT
  10. Lines: 54
  11.  
  12. slhpv@cc.usu.edu writes:
  13.  
  14.  
  15. >Has anyone created a texinfo file which documents the functions, types, and
  16. >macros contained in a normal set of include files?
  17.  
  18. >If not, is there any interest in having access to such documentation?
  19.  
  20. >Specifically what I had in mind was a 'manual' organized according to
  21. >include library, and indexed off function names.  A figure a typical entry
  22. >would look like this:
  23.  
  24. [...stuff deleted...]
  25.  
  26. I think the idea is good and worthwhile, but would recommend some consideration
  27. before plunging into the project. The C library is pretty huge, and thus
  28. writing such a libc.info is a considerable task.
  29.  
  30. What is imporatnt is to assure one self that such a manual can do things that
  31. tha manual system do not. I my opinion, if libc.info is just another format for
  32. essentially the same information (perhaps with some crossreferencing), then
  33. some sort of intelligent emacs interface to the man system would be a much
  34. better investment of time and ressources.
  35.  
  36. For libc.info to be worth the effort, it should be like the elisp ref manual,
  37. which contains tons of explanations and examples, and then we are talking a
  38. major effort.
  39.  
  40. A man interface could deal with making of menus (based on for instance include
  41. libraries), indexes and references, parsing up the information from the actual
  42. manpages. The advantage of this would be that the system would go with whatever
  43. OS you would be programming on, where writing an texinfo file would fix which
  44. library we were talking about.
  45.  
  46. Such an interface may even exist already. One would for instance like to check
  47. out the hyperbole package, which are supposed to deal with navigating through
  48. massive amounts of information.
  49.  
  50.  
  51.  
  52. ------------------------------------------------------------------------------
  53. Christian Lynbech
  54.  
  55. DAIMI                        office: R0.32   phone: 5034
  56. University of Aarhus,DK-Denmark                 email: lynbech@daimi.aau.dk
  57. ------------------------------------------------------------------------------
  58.               EMACS, The One True Editor                       
  59.  
  60.  
  61. Hit the philistines three times over the head with the Elisp reference manual.
  62.  
  63.                                         - petonic@hal.com (Michael A. Petonic)
  64.  
  65.  
  66.