Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 126507 - app-doc/php-docs needs bump
Summary: app-doc/php-docs needs bump
Status: RESOLVED FIXED
Alias: None
Product: Gentoo Linux
Classification: Unclassified
Component: [OLD] Unspecified (show other bugs)
Hardware: All Linux
: High enhancement (vote)
Assignee: PHP Bugs
URL:
Whiteboard:
Keywords:
: 38762 152693 (view as bug list)
Depends on: 120753
Blocks:
  Show dependency tree
 
Reported: 2006-03-17 02:12 UTC by Avuton Olrich
Modified: 2007-11-30 20:56 UTC (History)
4 users (show)

See Also:
Package list:
Runtime testing required: ---


Attachments
Eclass to download latest PHP manual from the PHP website (php-manual.eclass,6.67 KB, text/plain)
2006-09-03 10:20 UTC, email_deleted_GqKU
Details
app-doc/php-manual-html-9999.ebuild (php-manual-html-9999.ebuild,1.28 KB, text/plain)
2006-09-03 10:25 UTC, email_deleted_GqKU
Details
app-doc/php-manual-single-html-9999.ebuild (php-manual-single-html-9999.ebuild,837 bytes, text/plain)
2006-09-03 10:27 UTC, email_deleted_GqKU
Details
app-doc/php-manual-chm-9999.ebuild (php-manual-chm-9999.ebuild,811 bytes, text/plain)
2006-09-03 10:28 UTC, email_deleted_GqKU
Details
app-doc/php-manual-echm-9999.ebuild (php-manual-echm-9999.ebuild,1.99 KB, text/plain)
2006-09-03 10:29 UTC, email_deleted_GqKU
Details
Updated php-manual-html-9999.ebuild (forgot figures directory) (php-manual-html-9999.ebuild,1.41 KB, text/plain)
2006-09-03 11:25 UTC, email_deleted_GqKU
Details

Note You need to log in before you can comment on or make changes to this bug.
Description Avuton Olrich 2006-03-17 02:12:26 UTC
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.
Comment 1 email_deleted_GqKU 2006-09-03 10:20:36 UTC
Created attachment 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...
Comment 2 email_deleted_GqKU 2006-09-03 10:25:35 UTC
Created attachment 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...
Comment 3 email_deleted_GqKU 2006-09-03 10:27:05 UTC
Created attachment 95861 [details]
app-doc/php-manual-single-html-9999.ebuild

Ebuild for the latest version of the PHP manual, in a single HTML file...
Comment 4 email_deleted_GqKU 2006-09-03 10:28:13 UTC
Created attachment 95862 [details]
app-doc/php-manual-chm-9999.ebuild

Ebuild for the PHP manual in CHM format (as there are viewers them under Linux)
Comment 5 email_deleted_GqKU 2006-09-03 10:29:32 UTC
Created attachment 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)
Comment 6 email_deleted_GqKU 2006-09-03 10:39:48 UTC
- /!\ 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)
Comment 7 email_deleted_GqKU 2006-09-03 11:25:16 UTC
Created attachment 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.
Comment 8 Sam 2006-10-22 07:58:40 UTC
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.
Comment 9 email_deleted_GqKU 2006-10-22 14:15:41 UTC
(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).
Comment 10 Jakub Moc (RETIRED) gentoo-dev 2006-10-24 13:08:59 UTC
*** Bug 152693 has been marked as a duplicate of this bug. ***
Comment 11 Elfyn McBratney (beu) (RETIRED) gentoo-dev 2007-02-03 00:43:33 UTC
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!
Comment 12 Jakub Moc (RETIRED) gentoo-dev 2007-02-23 02:39:12 UTC
*** Bug 38762 has been marked as a duplicate of this bug. ***
Comment 13 Jakub Moc (RETIRED) gentoo-dev 2007-11-30 20:56:50 UTC
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/