php.net |  support |  documentation |  report a bug |  advanced search |  search howto |  statistics |  random bug |  login

go to bug id or search bugs for

Bug #38692 PHP manual tarballs should include version in filename and be archived
Submitted: 2006-09-02 19:22 UTC Modified: 2006-09-03 18:03 UTC
From: mathieu dot bonnet at nalkym dot org Assigned:
Status: Wont fix Package: Website problem
PHP Version: Irrelevant OS:
Private report: No CVE-ID: None
View Developer Edit
Welcome back! If you're the original bug submitter, here's where you can edit the bug or add additional notes.
If you forgot your password, you can retrieve your password here.
Password:
Status:
Package:
Bug Type:
Summary:
From: mathieu dot bonnet at nalkym dot org
New email:
PHP Version: OS:

 

 [2006-09-02 19:22 UTC] mathieu dot bonnet at nalkym dot org 
Description:
------------
Hi,

To ease integration in distributions, if would be nice if PHP manual tarballs (http://www.php.net/distributions/manual/) had versions (date they were generated), and were archived for some time...

I'm creating an ebuild (Gentoo Linux) with the "php_manual_<lang>.tar.gz" files (but having versions for the other files -single HTML file and CHM versions- would probably be useful too).

Something like "php_manual_<lang>_YYYYMMDD.tar.gz" would do fine...

If space is a problem, a new versioned archive every month will do perfectly... (while the non-versioned version would always be the lastest possible, as it is now). If possible, they should be kept for a few semesters, like one or two years...


Thanks in advance.

Patches

Pull Requests

History

AllCommentsChangesGit/SVN commitsRelated reports
 [2006-09-03 11:01 UTC] nlopess@php.net 
nah, I don't think it worth it.. (old manuals are useless anyway)
Gentoo should rely only on its mirrors for such revision tracking *or* create a php-manual-cvs package, for example.
 [2006-09-03 18:03 UTC] mathieu dot bonnet at nalkym dot org 
>
> [...] old manuals are useless anyway
>


Yeah, but they provide some stability (networkless installations, install cds) and security (hashes/signatures)...

Anyone serious about PHP would anyway update the manual regularly... but an old manual is not useless, if surely not the best option...


>
> Gentoo should rely only on its mirrors
> for such revision tracking [...]
>


It means more work for maintainers in every distributions... (not that much, most probably, but this would still be redundant).


>
> [...] create a php-manual-cvs package
>


This is what I just did (https://bugs.gentoo.org/show_bug.cgi?id=126507), but it sure would have been easier if there were version numbers :)

The previous Gentoo ebuilds for the manual, used mirrored snapshots... official maintainers probably will do the same with newer snapshots... (though the last snapshots date back to 2005-08-22, which is why I wanted to help...).


Anyway, I'm not the Gentoo official maintainer for the PHP manual, so I won't insist.


Cya :)
 
PHP Copyright © 2001-2025 The PHP Group
All rights reserved. 		Last updated: Sat Jan 18 18:01:27 2025 UTC