[gentoo-dev] Moving packages to dev-vcs

[Sebastian Pipping]

Hello!


So now that we have a new category "dev-vcs" we need to move suitable
stuff over there.  Moving packages is complex and error prone:
This mail tries to guide you through and summarize the process, please
read on.

HINT:  Please keep CVS' radius of operation small to reduce risks.


0. Prepare
==========
- Check if your package fits:
    Is it a "utility focused on version control"?

- Ensure that you have permission  (if you are not the main maintainer)

- Sync the whole tree including profiles
  (as you'll be inspecting reverse dependencies)


1. Copy
=======
- Duplicate any traces of dev-util/${PN} in profiles/ to dev-vcs/${PN}
  (fgrep -Rw "dev-util/${PN}" profiles/)

- Copy complete package dev-util/${PN} to dev-vcs/${PN}
  (watch out CVS directories)


2. Switch
=========
- Update eclasses
    fgrep -w "dev-util/${PN}" eclass/*.eclass

- Update reverse dependencies
    http://tinderbox.dev.gentoo.org/misc/dindex/dev-util/${PN}
    http://tinderbox.dev.gentoo.org/misc/rindex/dev-util/${PN}
                                        ^^^
    fgrep -w "dev-util/${PN}" */*/*.ebuild

- Append "move dev-util/${PN} dev-vcs/${PN}" line to
  profiles/updates/1Q-2010
  (must come last, described in [1])


3. Remove
=========
- Remove package dev-util/${PN} from CVS (as in [2])
    cd dev-util
    cvs rm -Rf ${PN}
    cvs ci -m "dev-util/${PN}: Remove (renamed to dev-vcs/${PN})" ${PN}
                                                                  ^^^^^
- Remove any traces of dev-util/${PN} in profiles/


4. Notify
=========
- Report back problems with this process

- Mail fellow maintainers of dev-util/${PN} about the move

- If ${PN} is a big one (Subversion, Git, you know the list)
  - Update documentation  (now or open a bug at least, please)
  - Drop sping@g.o. a mail to update references in Layman
  - (Notify users and developers through Planet Gentoo?)


5. Final words
==============
- Help for filling "profiles/updates" documentation is wanted,
  it's currently _all empty_:
  http://devmanual.gentoo.org/profiles/updates/index.html

- Feel free to CC yourself to dev-vcs bug #56967 [3]



Sebastian


[1]
http://www.gentoo.org/proj/en/devrel/handbook/handbook.xml?part=2&chap=5#doc_chap6
[2]
http://www.gentoo.org/proj/en/devrel/handbook/handbook.xml?part=2&chap=5#doc_chap7
[3] https://bugs.gentoo.org/show_bug.cgi?id=56967