Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!

Bug 212797

Summary: Improve package move documentation
Product: [OLD] Docs on www.gentoo.org Reporter: Ryan Hill (RETIRED) <rhill>
Component: Other documentsAssignee: Gentoo Quality Assurance Team <qa>
Status: RESOLVED OBSOLETE    
Severity: enhancement CC: ulm
Priority: High    
Version: unspecified   
Hardware: All   
OS: Linux   
URL: http://www.gentoo.org/proj/en/devrel/handbook/handbook.xml?part=2&chap=5#doc_chap6
Whiteboard:
Package list:
Runtime testing required: ---
Bug Depends on: 223401    
Bug Blocks:    

Description Ryan Hill (RETIRED) gentoo-dev 2008-03-09 06:17:02 UTC
As discussed in IRC, we need to better document the package move procedure that's in the dev handbook (and move it to the devguide).

- outline what steps are needed and the order in which to do them more clearly

- it's not just DEPEND you need to check, there's also stuff like built_with_use, etc.  every reference in the tree needs to be changed.  same with any of our documentation.

- remind the dev that ${P}/${PF}/${PN} will change and they may need to update their ebuilds accordingly

- adding an entry to /profiles/updates is listed twice

- document slotmove

- copy the ChangeLog instead of creating a new one so history is preserved
Comment 1 Ulrich Müller gentoo-dev 2009-04-12 09:45:10 UTC
- update category/package in first line of ChangeLog

(For the recent net-www moves really everyone forgot this.)