Path: utzoo!attcan!uunet!zaphod.mps.ohio-state.edu!uakari.primate.wisc.edu!uflorida!gatech!prism!gg10
From: gg10@prism.gatech.EDU (GALLOWAY)
Newsgroups: comp.lang.c
Subject: Self-documenting source code
Keywords: C,troff,latex,documentation
Message-ID: <16900@hydra.gatech.EDU>
Date: 12 Nov 90 18:12:59 GMT
Organization: Georgia Institute of Technology
Lines: 17

Is anyone aware of any packages or systems which extract documentation
for use in troff-format man pages or latex documents directly from the
C source code?

I am thinking along the lines of a token based system of embedding keywords
nto comments which are extracted some sort of parser.

One use would be to extract descriptions and prototypes for library functions.
It would be a lot easier to ensure that the documentation is up to date if
it is kept close to the actual code.

Any thoughts or pointers would be appreciated.

Thanks,

Greg Galloway
Georgia Institute of Technology