This is the mail archive of the
gcc@gcc.gnu.org
mailing list for the GCC project.
Re: line-map.c
- From: Neil Booth <neil at daikokuya dot co dot uk>
- To: Richard Kenner <kenner at vlsi1 dot ultra dot nyu dot edu>
- Cc: gcc at gcc dot gnu dot org
- Date: Fri, 20 Jun 2003 06:49:14 +0100
- Subject: Re: line-map.c
- References: <10306191424.AA20257@vlsi1.ultra.nyu.edu>
Richard Kenner wrote:-
> This file is missing documentation in the start of the file saying what
> it's used for and giving an overview of the functions in the file.
>
> Could whoever wrote this please add the required documentation?
>
> I'd also like to take this opportunity to urge people to be more careful
> at ensuring the required documentation is available before approving patches.
As a maintainer for the area in question, I approved my own patch.
I think that the comment in the 1st line, plus the wealth of comments
in line-map.h, is more than enough. The code isn't exactly complicated.
Per has managed to change that file, and he didn't write it, so others
do seem quite capable of figuring out what it does.
Neil.