home *** CD-ROM | disk | FTP | other *** search
/ NetNews Usenet Archive 1992 #30 / NN_1992_30.iso / spool / gnu / misc / discuss / 3991 < prev    next >
Encoding:
Internet Message Format  |  1992-12-16  |  1.4 KB
  1. Path: sparky!uunet!caen!hellgate.utah.edu!cc.usu.edu!slhpv
  2. From: slhpv@cc.usu.edu
  3. Newsgroups: gnu.misc.discuss
  4. Subject: texinfo manual for C library functions
  5. Message-ID: <1992Dec15.194401.62079@cc.usu.edu>
  6. Date: 15 Dec 92 19:44:00 MDT
  7. References: <FISCHER.92Dec15014923@thor.iesd.auc.dk> <1992Dec15.042930.23371@pasteur.Berkeley.EDU> <DREIER.92Dec14235242@durban.berkeley.edu> <1glavuINNd1g@agate.berkeley.edu>
  8. Organization: Utah State University
  9. Lines: 37
  10.  
  11.  
  12. Has anyone created a texinfo file which documents the functions, types, and
  13. macros contained in a normal set of include files?
  14.  
  15. If not, is there any interest in having access to such documentation?
  16.  
  17. Specifically what I had in mind was a 'manual' organized according to
  18. include library, and indexed off function names.  A figure a typical entry
  19. would look like this:
  20.  
  21.                         <stdio.h>
  22. Overview:
  23.     stdio.h contains functions for handling I/O to normal files....
  24.  
  25. Types:
  26.     FILE    - structure used to hold information about a file
  27.     etc.
  28.  
  29. Constants:
  30.     NULL    - used to represent an empty pointer
  31.     etc.
  32.  
  33. Functions:
  34.     int fgets(char *string, int length, FILE *infile)
  35.         - reads characters from infile until a '\n' is encountered
  36.         or length characters have been read. These characters are
  37.         placed in string followed by a '\0'.
  38.     etc.
  39.  
  40. Macros:
  41.     you get the idea...
  42.  
  43. Does anyone know of such a beast, either in print or online.  Is anyone
  44. interested in having such a thing?  Is anyone interested in helping to
  45. create such a thing?
  46.  
  47. -Dave
  48.