Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 469756 - PMS EAPI version 2 and 3 pdfs inaccessible
Summary: PMS EAPI version 2 and 3 pdfs inaccessible
Status: RESOLVED FIXED
Alias: None
Product: Websites
Classification: Unclassified
Component: [OLD] Documentation (show other bugs)
Hardware: All Linux
: Normal normal (vote)
Assignee: PMS/EAPI
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2013-05-13 22:10 UTC by Matthew Millar
Modified: 2013-05-31 11:41 UTC (History)
0 users

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


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Matthew Millar 2013-05-13 22:10:11 UTC
The following links on http://www.gentoo.org/proj/en/qa/pms.xml are inaccessible:
eapi-2-approved-2008-09-25 (PDF) - http://distfiles.gentoo.org/distfiles/pms-2.pdf
eapi-3-approved-2010-01-18 (PDF) - http://distfiles.gentoo.org/distfiles/pms-3.pdf

Also, is pms-1 available? as there are a large number packages which still conform to this standard.
Comment 1 Alex Legler (RETIRED) archtester gentoo-dev Security 2013-05-24 16:52:28 UTC
These files really shouldn't be on the mirrors, rather in a project space.
Comment 2 Ulrich Müller gentoo-dev 2013-05-24 21:50:00 UTC
(In reply to comment #0)
> The following links on http://www.gentoo.org/proj/en/qa/pms.xml are
> inaccessible:
> eapi-2-approved-2008-09-25 (PDF) -
> http://distfiles.gentoo.org/distfiles/pms-2.pdf
> eapi-3-approved-2010-01-18 (PDF) -
> http://distfiles.gentoo.org/distfiles/pms-3.pdf

I've updated these links to point to my dev space. Thank you for reporting this.

> Also, is pms-1 available? as there are a large number packages which still
> conform to this standard.

The latest version includes all previous EAPIs, so old versions aren't really needed. I wonder if we shouldn't just keep the last version approved by the council and a recent snapshot from git. (Currently, that would be eapi-5-approved-2012-09-20 and HEAD.)
Comment 3 Matthew Millar 2013-05-31 11:36:04 UTC
Thanks for fixing the 404.

The reason I requested all versions of the EAPI documentation to be available, is mostly for academic purposes.

Since each version is an enhancement of the previous version, it would be useful to read the EAPI1 documentation, review several EAPI1 ebuilds, and then compare these to EAPI2 documentation and ebuilds, to comprehend the different programming techniques.

If I jump straight in at EAPI5, though I'll be able to program compliant ebuilds, I won't readily identify deprecated programming techniques in need of enhancement.
Comment 4 Ciaran McCreesh 2013-05-31 11:41:38 UTC
PMS documents every Council-approved EAPI, and it points out where the differences are. There's no need to read an earlier version to find out what earlier EAPIs look like.