Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 3334 - Developers HOWTO needs updating.
Summary: Developers HOWTO needs updating.
Status: RESOLVED FIXED
Alias: None
Product: [OLD] Docs-developer
Classification: Unclassified
Component: Developers HOWTO (show other bugs)
Hardware: All Linux
: High normal (vote)
Assignee: John Davis (zhen) (RETIRED)
URL:
Whiteboard:
Keywords:
Depends on:
Blocks: 8032
  Show dependency tree
 
Reported: 2002-06-02 14:52 UTC by Olivier Reisch (RETIRED)
Modified: 2002-10-24 17:30 UTC (History)
1 user (show)

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 Olivier Reisch (RETIRED) gentoo-dev 2002-06-02 14:52:49 UTC
I am a new Gentoo developer and I believe the Developers HowTo on ebuilds is way
from being complete. A lot of variables like SLOT, LICENCE and certainly others
are not mentioned. Some more documentation on how to handle different
architectures using ${ARCH} could be a pointer for a several people too. There
are also several rules of thumb that have mostly been posted on mailing lists
that should certainly go into the docs.
Comment 1 John Davis (zhen) (RETIRED) gentoo-dev 2002-09-17 17:39:04 UTC
Do you have any ideas that you can post? I will try to add what I can, but I
need some ideas from the ebuild developers! 
Thanks,
//ZhEN
Comment 2 Olivier Reisch (RETIRED) gentoo-dev 2002-09-18 03:28:46 UTC
OK, here are some suggestions:  - Update of the ebuild variables listing, eg. remove A, add stuff like SLOT, LICENCE, etc. - Detail the workings of the ebuild keywording for multi platform compatibility and how to make use of the keywords to make plat form specific steps in an ebuild. (namely the x86, ppc, sparc and sparc64 keywords and how to use them, etc.) - Make sure all the USE variables are up to date in the listing - Make a clear reference to the CVS guide, which I think needs updating too. It should specifically show how a new developer switches from an rsync mirror to the CVS mirror (for emerge rsync for instance), how to check out the current CVS portage tree, how to enable keychains, what lintool and repoman are and how to use them.  Some of this is referenced in http://gentoo.org/~karltk/POLICY.txt and I believe adding most of this document into the Developer HowTO would be a good idea.  If that'd all be done, we would already have a way better Developer HowTO :) Thanks for your work. 
Comment 3 John Davis (zhen) (RETIRED) gentoo-dev 2002-10-02 18:13:07 UTC
I will take care of this when I get a chance. It needs done!

//ZhEN
Comment 4 John Davis (zhen) (RETIRED) gentoo-dev 2002-10-24 14:09:48 UTC
Is there a way to rsync to the cvs tree?

//ZhEN
Comment 5 John Davis (zhen) (RETIRED) gentoo-dev 2002-10-24 17:30:27 UTC
I covered all of this, look to the webpage, cause it will be there on the next
update ;-)

//ZhEN