This is the mail archive of the
gcc@gcc.gnu.org
mailing list for the GCC project.
Re: An issue for the SC: horrible documentation quality of GCC
- From: dewar at gnat dot com (Robert Dewar)
- To: kenner at vlsi1 dot ultra dot nyu dot edu, matz at suse dot de
- Cc: gcc at gcc dot gnu dot org
- Date: Mon, 12 May 2003 07:31:40 -0400 (EDT)
- Subject: Re: An issue for the SC: horrible documentation quality of GCC
> Well, on the top of gcse.c it says, that one of the passes in GCSE is
> copy/constant propagation. This is a standard optimization, and hence the
> actual description of any algorithm (on the high level) seems superflous.
> Tricks used in the implementation should of course be documented, but have
> no place in any high level overview comments.
copy/constant propagation is really quite vague. it can refer to various
algorithms and intended optimizations. I think it is quite important to
define terms like this. Often people have taken a compiler course, or
read some particular book, or set of papers, and they assume that terminology
is standard. That's far from true in the compiler field in general, and in
optimization in particular, so it is quite important to define terms like
this clearly.