Re: [PHP4BETA] cvs: /php4/ext/pgsql pgsql.c
| From: | Egon Schmid | Date: | Sun, 29 Aug 1999 18:55:56 +0000 |
| Subject: | Re: [PHP4BETA] cvs: /php4/ext/pgsql pgsql.c | ||
| References: | 1 | Groups: | php.version4 |
| Request: | Send a blank email to php-version4+get-3832@lists.php.net to get a copy of this message | ||
Rasmus Lerdorf wrote:
>
> Egon, what do you think about adding some additional tag to all the proto
> strings that indicate which section of the manual the function should be
> listed under? I think it might be useful to be able to generate a
> functional listing where functions are sorted by their chapter and then
> alphabetically inside each chapter just like the manual.
Yes I think it will be very usefull. Maybe the id string from the
chapter.
A checkdoc output showed the following:
php3: 1044 of 1345 functions documented (77% done, 23% remaining).
php4: 1044 of 1074 functions documented (97% done, 3% remaining).
and I hope I can contribute something after the third printing of our
book.
Best thing would be also, to write the version numbers in some SGML
tags.
There is no grouping in the functions reference. Most authors put them
in alphabetically. IMHO one deeper level will be (in the sense of
chapters and subchapters) more readable and the best for finding the
information. A grouping of database related functions would be very
handy.
I have seen you have handed out such a printed function reference at the
O'Reilly Open Software Convention. Is it sorted in some way? Can I have
one?
-Egon
PS: I have now probably a second problem with my mail account. My new
email address is: eschmid@s.netic.de My old was working all the the time
and it was correct redirected.