Bugzilla Bug 126507

app-doc/php-docs needs a bump now that php5 is in portage and there are alot of
invalid functions from php4 in the portage php-docs.

Created an attachment (id=95859) [details]
Eclass to download latest PHP manual from the PHP website

The PHP manual is available in multiple language and formats. Moreover, the PHP
manual packages on the PHP website do not contain version numbers, and are
updated regularly, so if we do not mirror snapshots, we have to workaround some
problems related to Portage handling of package downloading (security hashes,
package update in DISTDIR -the name does not change with new version, so
Portage would not update it if not manually removed-, etc.). This eclass
support all this.

See eclass header for some notes and todo...

Created an attachment (id=95860) [details]
app-doc/php-manual-html-9999.ebuild

Ebuild for the PHP manual, using the php-manual eclass...

Note I renamed the package from php-docs to php-manual, and added the manual
format in the name...

Note this will download the latest version of the PHP manual (hence the
-9999)... 

If the manual packages are mirrored, this probably should be changed, even if
an ebuild to fetch the lastest version available would still be useful...

Created an attachment (id=95861) [details]
app-doc/php-manual-single-html-9999.ebuild

Ebuild for the latest version of the PHP manual, in a single HTML file...

Created an attachment (id=95862) [details]
app-doc/php-manual-chm-9999.ebuild

Ebuild for the PHP manual in CHM format (as there are viewers them under Linux)

Created an attachment (id=95863) [details]
app-doc/php-manual-echm-9999.ebuild

Ebuild for the PHP manual in extended CHM format (see
http://www.php.net/docs-echm.php)

- /!\ Do note I did not extensively test the eclass and ebuilds... they just
work for me, under normal circumstances... I do not have enough time to do
more.

- PHP.net enhancement proposal to include a version number (like the date the
manual packages were generated) in the PHP manual package filenames:
http://bugs.php.net/bug.php?id=38692 (not seen as necessary by upstream)

- Another @todo would be to build a PHP manual with
http://wiki.phpdoc.info/LiveDocs which would include user notes... (I really do
not have enough time to even try to do it)

Created an attachment (id=95869) [details]
Updated php-manual-html-9999.ebuild (forgot figures directory)

While checking old bugs about php-docs, I found I missed the "figures"
directory, from the HTML version of the manual... This is the corrected ebuild.

My question is, will app-doc/php-docs still be user? Development has been moved
to php-manual, and the latest version of php-docs is 20050822 (very outdated).
It should either be masked or removed.

(In reply to comment #8)
> My question is, will app-doc/php-docs still be user? Development has been moved
> to php-manual, and the latest version of php-docs is 20050822 (very outdated).
> It should either be masked or removed.
> 


I just went to irc.freenode.net/gentoo-php, and someone will update the
original php-docs ebuild :) (as long as the original ebuild is regularly
updated -well, LINGUAS support must be added, at least, as requested, notably,
in bug #38762-, there's probably no need to add the ebuilds I posted).

*** Bug 152693 has been marked as a duplicate of this bug. ***

Bumped.  Will look into the rest of this bug soon-ish and try and work
something out in an overlay.  Thanks, all, for comments and code!

*** Bug 38762 has been marked as a duplicate of this bug. ***

Added an ebuild w/ LINGUAS support to PHP overlay; will be moved to the tree
shortly.

http://overlays.gentoo.org/svn/proj/php/testing/migration/app-doc/php-docs/