> > bad: Foo() does bar;
> > good: The function foo() does bar.
> > 
> > Daniel
> 
> I agree with your second assertion. I could see a lot of 
> users getting confused if the first were followed blindly, 
> though (say, if one was documenting C). Which is one reason 
> (besides style) why I agree with the second assertion...:)

Im sorry but I feel we should keep all function names lowercase. Take a
look at http://php.net/manual/en/ref.pdf.php now, that really looks ugly
too me, there is no reason to have function names at beginning of
sentences and lets keep the manual consistent, if its all lowercase we
will encourage people to name their functions properly etc, we are not
going to start putting PdF_OpeN in the manual just because its supported
lets keep the manual consistent and keep it lowercase, this has worked
for the past x years and there is no real reason to change it.

- James

Reply via email to