Re: [Gomp-discuss] fortran c/c++

[Pop Sébastian]

On Wed, Dec 18, 2002 at 06:34:53AM +0100, Lars Segerlund wrote:
> 
>  Also I think it would be important to have good documentation, since I 
> just have started hacking at gcc after being away from it for a while, 
> and the gcc documentation is not good, ( for someone wanting to help ), 
> take the tree-ssa issue, it's dokumented in the code !
> 
It's not the only place where you can find information about tree-ssa!
You could get the gcc/gcc-patches mailinglists boxes and just process them
with a filter on the subject [tree-ssa] or [ast-optimizer].  These are 
in fact all the rationales of every modification someone introduced in that
branch.  

The things are as they are because writing documentation that 
will completely fall in desuetude after only two or three months is not 
the right thing to do, IMHO.

>  So in order to attract competent developers, ( not scare them away ), 
> I think dokumentation would be a start, perhaps even the policy ( ouch ! 
> )  of 'nothing goes in if it's not documented' ?
> 
This is far too restrictive.
I agree that we should have some documentation, but only when things 
become to slow down...