The ChangeLog idiom is redundant given any decent SCM.
Time to phase it out here.
Signed-off-by: David Brownell <dbrownell@users.sourceforge.net>
release's tag. This is used only for producing these packages.
-# Checkout the appropriate tag:
<code>git checkout "${PACKAGE_VERSION}"</code>
release's tag. This is used only for producing these packages.
-# Checkout the appropriate tag:
<code>git checkout "${PACKAGE_VERSION}"</code>
- -# Produce a ChangeLog for the release (using @c git2cl).
-# @c bootstrap, @c configure, and @c make the package.
-# Run <code>make distcheck</code> to produce the distribution archives.
-# Run <code>make maintainer-clean</code> verify the repository is empty.
-# @c bootstrap, @c configure, and @c make the package.
-# Run <code>make distcheck</code> to produce the distribution archives.
-# Run <code>make maintainer-clean</code> verify the repository is empty.
- Allow users to access the documentation for each of our releases.
- Place static copies of the following files on the project website:
- @c NEWS: to provide a blurb for each release
- Allow users to access the documentation for each of our releases.
- Place static copies of the following files on the project website:
- @c NEWS: to provide a blurb for each release
- - @c ChangeLog: to show exactly what has been changed
- User's Guide, Developer Manual: to allow easy on-line viewing
-# Upload packages and post announcements of their availability:
-# Release packages into files section of project sites:
- User's Guide, Developer Manual: to allow easy on-line viewing
-# Upload packages and post announcements of their availability:
-# Release packages into files section of project sites:
- .zip: Windows
- Berlios:
-# Create the new release for the new version.
- .zip: Windows
- Berlios:
-# Create the new release for the new version.
- -# Provide @c NEWS and ChangeLog files, as requested.
+ -# Provide @c NEWS file, as requested.
-# Upload files via FTP to ftp://ftp.berlios.de/incoming/
-# Edit descriptions for each file.
-# Click button to send E-mail Release Notice.
-# Upload files via FTP to ftp://ftp.berlios.de/incoming/
-# Edit descriptions for each file.
-# Click button to send E-mail Release Notice.
build Compiles the project; runs configure, if needed.
Packaging Commands:
build Compiles the project; runs configure, if needed.
Packaging Commands:
- changelog Generate a new ChangeLog using ${SCM}2cl.
package Produce new distributable source archives.
stage Move archives to staging area for upload.
package Produce new distributable source archives.
stage Move archives to staging area for upload.
maybe_build() { [ -f "src/openocd" ] || do_build; }
do_build_clean() { [ -f Makefile ] && make maintainer-clean >/dev/null; }
maybe_build() { [ -f "src/openocd" ] || do_build; }
do_build_clean() { [ -f Makefile ] && make maintainer-clean >/dev/null; }
-do_changelog() {
- echo "Creating ChangeLog..."
- local CMD=tools/git2cl/git2cl
- eval ${CMD} ${OPTS} > ChangeLog
-}
-do_changelog_clean() {
- git checkout ChangeLog
-}
maybe_build
echo "Building distribution packages..."
make ${MAKE_OPTS} distcheck 2>&1 | perl tools/logger.pl > "release-pkg.log"
maybe_build
echo "Building distribution packages..."
make ${MAKE_OPTS} distcheck 2>&1 | perl tools/logger.pl > "release-pkg.log"
mv -v "${FILE}" archives/
done
cp -a NEWS archives/
mv -v "${FILE}" archives/
done
cp -a NEWS archives/
- cp -a ChangeLog archives/
}
do_stage_clean() { rm -v -f -r archives; }
do_clean() {
do_build_clean
do_package_clean
}
do_stage_clean() { rm -v -f -r archives; }
do_clean() {
do_build_clean
do_package_clean
rm -v -f release-*.log
}
do_clean_all() {
rm -v -f release-*.log
}
do_clean_all() {
git mv "NEWS" "NEWS-${RELEASE_VERSION}"
cat >NEWS <<NEWS
git mv "NEWS" "NEWS-${RELEASE_VERSION}"
cat >NEWS <<NEWS
-This file should include items worth mentioning in the
-OpenOCD ${NEXT_RELEASE_VERSION} source archive release.
-
-The following areas of OpenOCD functionality changed in this release:
+This file includes highlights of the changes made in the
+OpenOCD ${NEXT_RELEASE_VERSION} source archive release. See the
+repository history for details about what changed, including
+bugfixes and other issues not mentioned here.
Target Layer:
Flash Layer:
Board, Target, and Interface Configuration Scripts:
Target Layer:
Flash Layer:
Board, Target, and Interface Configuration Scripts:
Build and Release:
For more details about what has changed since the last release,
Build and Release:
For more details about what has changed since the last release,
-see the ChangeLog associated with this source archive. For older NEWS,
-see the NEWS files associated with each release (i.e. NEWS-<version>).
+see the git repository history. With gitweb, you can browse that
+in various levels of detail.
+
+For older NEWS, see the NEWS files associated with each release
+(i.e. NEWS-<version>).
For more information about contributing test reports, bug fixes, or new
features and device support, please read the new Developer Manual (or
For more information about contributing test reports, bug fixes, or new
features and device support, please read the new Developer Manual (or
[ "${CMD}" ] || usage
shift
[ "${CMD}" ] || usage
shift
-ACTION_CMDS="bootstrap|configure|build|changelog|package|stage|clean"
+ACTION_CMDS="bootstrap|configure|build|package|stage|clean"
MISC_CMDS="all|info|release|branch|reset|help|usage"
MISC_CMDS="all|info|release|branch|reset|help|usage"
-CLEAN_CMDS="build_clean|changelog_clean|package_clean|stage_clean|clean_all"
+CLEAN_CMDS="build_clean|package_clean|stage_clean|clean_all"
CMDS="|${ACTION_CMDS}|${CLEAN_CMDS}|${MISC_CMDS}|"
is_command() { echo "${CMDS}" | grep "|$1|" >/dev/null; }
CMDS="|${ACTION_CMDS}|${CLEAN_CMDS}|${MISC_CMDS}|"
is_command() { echo "${CMDS}" | grep "|$1|" >/dev/null; }