Re: Patch for documentation

On Wed, Aug 20, 2008 at 13:21, Anthony Bedford <Tony.Bedford@sun.com> wrote: > Hi Hannes, > > Ah thanks for that. > > I've attached another diff (unified this time). Hopefully this will be a bit > more useable. Replace "FALSE" with "&false;" and I think its perfect. > I'll push on with the existing templates for now, and if I get time later > have a look at helping out with creating some new templates. OK.. But the "new templates" will only be useful for the mysqli extension, as the current templates/skeletons fit perfectly for regular prefix_funcname() <-> prefix::funcname() mapping. Like I said before, mysqli randomly uses prefix_funcname() <-> prefix_suffix::funcname() or even prefix_suffix_funcname() <-> prefix::suffix_funcame() and various WTFs (which is the reason I ignored the entire mysqli doc when I upgraded bunch of extensions recently). Personally, I would like to remove the current mysqli docs and start from scratch to get the structure right and then copy&paste content from the old files... > You've probably been asked this before - is there a whitespace > checking/formatting tool available? At the bottom of each file are vim modelines which bunch of editors support these days. Regarding "when to add \n".. I don't think we have scripts to check that, its just something you get used to after reading, and writing, couple of files :) -Hannes