Builds: Will all or just bundled PECL docs be in phpdoc manual builds? Meaning, will a separate PECL manual ever exist? As PECL grows the manual will grow and like we discussed having a separate developers manual this is a *similar* issue. PECL is going to be huge one day and contain many specialized extensions.
The decision was to now build all PECL docs with php docs, as
- users will not be aware of where the extension comes from anyway (lot of people use shared hosting) - php.net and mirror sites provide good ways to search and shortcut the manual - this will promote PECL extensions better, they will not be burried deep
Since livedocs will be the future presentation system, we can do all kinds of special marks on PECL extension pages.
Doc moves:
When (or if) will the Hartmut split script be run on all PECL extensions currently in peardoc?
Ref: http://marc.theaimsgroup.com/?l=phpdoc&m=107374866303330
Anytime someone sits down and does it :) It is a TODO item, but noone grabbed it yet.
Version info: Is this issue solved, will this go into the manual docs? Ref: http://marc.theaimsgroup.com/?l=phpdoc&m=107574257608183
The automatically generated version info needs to be extended in this direction, and human edited notes need to be added as well (much like we do now with function changes).
General information:
Before thinking about the above I proposed a format and some entities for all PECL docs and they still seem appropriate:
Ref: http://marc.theaimsgroup.com/?l=phpdoc&m=109108627618708
Yep, sure, they are. I had no time to deeply read your PECL proposals, but they are near the top of my TODO list :)
Maintainer rights: So all maintainers of these PECL extensions will have full phpdoc rights? Not a major concern, just curious.
Since all people having rights to php-src already have Karma to phpdoc, it is logical to add that to pecl extension maintainers too.
Goba
