Bug 477288

Summary:	Developer Handbook - Ebuild policy - CVS sources policy is outdated.
Product:	Community Relations	Reporter:	Tom Wijsman (TomWij) (RETIRED) <tomwij>
Component:	Developer Relations	Assignee:	Gentoo Community Relations Team <comrel>
Status:	RESOLVED WONTFIX
Severity:	normal	Keywords:	PATCH
Priority:	Normal
Version:	unspecified
Hardware:	All
OS:	Linux
URL:	http://www.gentoo.org/proj/en/devrel/handbook/handbook.xml?part=2&chap=1
See Also:	https://bugs.gentoo.org/show_bug.cgi?id=421993
Whiteboard:
Package list:		Runtime testing required:	---
Attachments:	hb-policy-ebuild.xml.patch

Description Tom Wijsman (TomWij) (RETIRED) gentoo-dev

2013-07-18 12:04:09 UTC

Created attachment 353572 [details, diff]
hb-policy-ebuild.xml.patch

Please see the attached patch, changes made:

1. CVS is changed to VCS.

2. References to "cvs.eclass" are changed to "VCS eclass based ebuild"; to give an example, for the first occurrence we make a mention of git-2.eclass.

3. An actual change in policy, to reflect the policy we use nowadays; whenever it was said to keyword something as ~[arch] it now reads to not give the ebuild any keywords. For reference see the discussion at  http://thread.gmane.org/gmane.linux.gentoo.devel/68885 which could be interpreted as a consensus; if not and if there is doubt, feel free to refer to the QA team.

This old policy was something I read in my early mentee days, I was some months later corrected at some point by reading other documentation as well as when asking; coming back to it now with some discussion about whether this is a policy, I as well as others forget about its existence, but someone looked it up and pointed out a policy on this actually exists. But, it conflicts which what is written and said in multiple other places.

I think that as developers barely know this policy exists, that it was never really looked at and as a result never got updated to the way we currently do things; therefore, to avoid any confusion as well as to have a policy to refer to please update hb-policy-ebuild.xml (see URL for what page I am referring to).

Thank you in advance.

Comment 1 Markos Chandras (RETIRED) gentoo-dev

2014-01-05 00:49:29 UTC

This document is outdated and deprecated. Such info should be moved to devmanual.

Which sort-of makes it duplicate of bug 421993