# =========================================================================
# Copyright 2004 Josh Glover <jmglov@jmglov.net>
#
# LICENCE:
#
#   This work is licensed under the Creative Commons Attribution-ShareAlike
#   License. To view a copy of this license, visit:
#
#   http://creativecommons.org/licenses/by-sa/2.0/
#
#   or send a letter to:
#
#   Creative Commons
#   559 Nathan Abbott Way
#   Stanford, California 94305, USA.
#
# gentoo-dev_ebuild-version-bump.txt
#
# DESCRIPTION:
#
#   Captain's Log for adding a new version of an existing package to
#   Portage.
#
# USAGE:
#
#   Read the Captain's Log, pasting bits into your terminal once you
#   have verified that all paths, settings and so on are right for your
#   environment, *OR*, copy the Captain's Log somewhere on your box,
#   edit it to fit your environment, and run it (possibly as root):
#
#   bash gentoo-dev_ebuild-version-bump.txt
#
# MODIFICATIONS:
#
#   Josh Glover <unix@jmglov.net> (2004/06/16): Initial revision
# =========================================================================

# 1. Setup variables
PORTAGE_CVS_PATH="$HOME/coding/gentoo-x86"

NAME="Josh Glover"
EMAIL="jmglov@gentoo.org"

SUB_NAME="Josh Glover"
SUB_BUG="51243"

CATEGORY="dev-util"
PN="redet"
PV="8.8"

# 2. Update package directory from CVS (just to be sure nothing has
#    changed)
cd ${PORTAGE_CVS_PATH}/${CATEGORY}/${PN}
cvs update -d

# 3. Save new version's ebuild into directory, or create it here if you do
#    not have a user-submitted ebuild

# 4. Add new ebuild to CVS
cd ${PORTAGE_CVS_PATH}/${CATEGORY}/${PN}
cvs add ${PN}-${PV}.ebuild

# 5. Create digest
cd ${PORTAGE_CVS_PATH}/${CATEGORY}/${PN}
PORTDIR_OVERLAY="${PORTAGE_CVS_PATH}" FEATURES="cvs autoaddcvs fixpackages" \
  ebuild ${PN}-${PV}.ebuild digest

# 6. Update ChangeLog
ECHANGELOG_USER="${NAME} <${EMAIL}>" \
  echangelog "Version bump; submitted by ${SUB_NAME} in bug #${SUB_BUG}"

# 7. Use repoman to perform perfunctory QA
PORTDIR_OVERLAY="${PORTAGE_CVS_PATH}" FEATURES="cvs autoaddcvs fixpackages" \
  repoman fix

# 8. Commit new files to CVS
PORTDIR_OVERLAY="${PORTAGE_CVS_PATH}" FEATURES="cvs autoaddcvs fixpackages" \
  repoman commit \
  -m "Version bump; submitted by ${SUB_NAME} in bug #${SUB_BUG}"