Re: [PHPDOC] Alphabetical order? From: eschmid+sic <email protected>
Date: 05/29/00

On Mon, May 29, 2000 at 08:37:56PM +0200, Ted Parnefors wrote:
> On Mon, 29 May 2000, Hartmut Holzgraefe wrote:
>
> > Ted Parnefors wrote:
> > >
> > > Just curious... The documentation sometimes seem to list the functions
> > > of the different modules in alphabetical order, and sometimes I can see no
> > > order at all,
> >
> > > is this just the way that it all grew out as more and more
> > > functions got documented
> >
> > i fear that's what happend
> >
> > > or is there some kind of order to it?
> >
> > not really
> >
> > i once suggested a more functional grouping within the files,
> > but answers where mixed and no decission followed
> > (and i didn't push it myself)
> > and so things stayed as they are
> >
> > but maybe its time have restart this and have a serious decision
> > this time?
> >
> > alphabetical ordered summaries can still be obtained using propper
> > stylesheets (i'll volunteer for this) while a more functional grouping
> > helps especially those who really read a chapter page by page
> > (reading about xyz_close() way before xyz_open() doesn't help so much)
> >
>
> How was your previous suggestion of ordering ?

I vote for a strict alphabetical ordering. Function summaries for many
functions like the pdf or swf couldn't be found quick because, there are
no functional grouping headings.

It would help people more if there is at least a complete example and a
descriptive text in the partintro.

-Egon 

--
Grueninger Str. 6, 70599 Stuttgart
http://php.net/manual/, http://php.net/books.php3
http://www.uni-hohenheim.de/~windband  
http://snaps.php.net/manual/, http://www.zend.com/