Re: [PHPDOC] Alphabetical order? From: Hartmut Holzgraefe (hartmut <email protected>)
Date: 05/29/00

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)

--
Hartmut Holzgraefe         hartmut <email protected>           http://www.six.de