This is the mail archive of the
gcc@gcc.gnu.org
mailing list for the GCC project.
Re: Question about DECL_RESULT macro
- To: Ira Ruben <ira at apple dot com>
- Subject: Re: Question about DECL_RESULT macro
- From: "Joseph S. Myers" <jsm28 at cam dot ac dot uk>
- Date: Sat, 30 Jun 2001 00:14:23 +0100 (BST)
- cc: <gcc at gcc dot gnu dot org>
On Fri, 29 Jun 2001, Ira Ruben wrote:
> I am trying to gain more understanding of gcc trees. In
> cp/cp-tree.def, for TEMPLATE_DECL, the comments that document the key
> fields of a TEMPLATE_DECL
Not an answer to your question, but where comments duplicate .texi
documentation (in this case c-tree.texi) one is liable to get out of sync
with the other. In principle, unless we use literate programming, I think
in such cases we should say that the documentation for tree structures is
in the .texi manual and remove comments on data structures that duplicate
it. (And complete the tree manual, also distinguishing what features are
general, what are C/C++ only and what are C++ only.)
--
Joseph S. Myers
jsm28@cam.ac.uk