This is the mail archive of the
gcc@gcc.gnu.org
mailing list for the GCC project.
Re: Use of Texinfo commands for definitions
- To: "Joseph S. Myers" <jsm28 at cam dot ac dot uk>
- Subject: Re: Use of Texinfo commands for definitions
- From: Gerald Pfeifer <pfeifer at dbai dot tuwien dot ac dot at>
- Date: Thu, 7 Jun 2001 16:10:14 +0200 (CEST)
- cc: <gcc at gcc dot gnu dot org>
On Tue, 5 Jun 2001, Joseph S. Myers wrote:
> Texinfo provides various special commands such as @deftypefun for
> documenting functions and macros. As well as providing appropriate
> formatting, these generate the index entries automatically. It seems to
> me that it would be appropriate to use these throughout tm.texi and
> elsewhere; at present they are only used twice. Comments?
Yes. Two hypotheses why these macros haven't been used:
1. Earlier versions of texinfo did not offer them(?)
2. Those writing the docs just haven't been aware of them.
Both of these are historical theories, and I see no reason why we
wouldn't want to change this now -- given that someone is volunteering
to start with that.
Gerald
--
Gerald "Jerry" pfeifer@dbai.tuwien.ac.at http://www.dbai.tuwien.ac.at/~pfeifer/