This is the mail archive of the gcc@gcc.gnu.org mailing list for the GCC project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

Re: "Documentation by paper"


>     Perhaps the documentation doesn't have to be in the file, but there
>     has to be some texinfo documentation for it ?

On Tue, Jan 27, 2004 at 10:50:28AM -0500, Richard Kenner wrote:
> No, I think it has to be in the file.  That's the most logical place for it
> and the only place that has any hope of being maintained as the file changes.

Paper documentation is nice as well, but the way to get both, and to keep
the code and documentation consistent, is to use doxygen-style comments
and use that to generate the documentation.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]