home *** CD-ROM | disk | FTP | other *** search
/ Usenet 1994 January / usenetsourcesnewsgroupsinfomagicjanuary1994.iso / sources / misc / volume3 / proto / proto.1 < prev    next >
Encoding:
Text File  |  1989-02-03  |  1.5 KB  |  48 lines
  1. .EV
  2. .T1 proto 1 "2/6/88"
  3. .SH NAME
  4. proto \- build ANSI style prototypes from C source code.
  5. .SH SYNTAX
  6. .B proto
  7. [\fB\-f\fP]  \fIinputfile\fP [\fIoutputfile\fp]
  8. .SH DESCRIPTION
  9. .I Proto
  10. builds a list of ANSI-style external declarations [\fIprototypes\fP] for all
  11. the functions in a given C source file.
  12. It produces this list in two forms:
  13. .nf
  14.     #ifdef HASPROTOS
  15.     <nice external prototype declarations>
  16.     #else
  17.     <old ikky external declarations for UNIX C compilers>
  18.     #endif
  19. .fi
  20. .PP
  21. You can then incorporate the file generated into your .h files.
  22. Make sure you #define HASPROTOS iff your compiler supports
  23. prototypes: otherwise you'll lose all the advantages.
  24. .PP
  25. If you omit the output file from the command line,
  26. the standard output will be used.
  27. .SH OPTIONS
  28. The only option this program accepts is \fB-f\fP,
  29. which causes it to place a pretty-printed form of the
  30. original function declarations in the output file,
  31. rather than the prototypes.
  32. .SH PORTABILITY
  33. This program should work fine on any system with a C compiler.
  34. If it doesn't, please let me know!
  35. .SH AUTHOR
  36. Duncan White,
  37. Dept Of Computing,
  38. Imperial College,
  39. London,
  40. England.
  41. .SH LIMITATIONS
  42. The grammar used for parsing is incomplete.
  43. In particular, array parameters, function parameters, and structure parameters
  44. not disguised by \fI#define's\fP or \fItypedef's\fP will not be recognised.
  45. .PP
  46. In addition, the entire function declaration, including the types of the
  47. parameters, must reside on a single line for it to be recognised.
  48.