php.net |  support |  documentation |  report a bug |  advanced search |  search howto |  statistics |  random bug |  login
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
 [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-2024 The PHP Group
All rights reserved.
Last updated: Fri Dec 13 14:01:28 2024 UTC