diff --git a/livesupport/doc/release.html b/livesupport/doc/release.html
index 863fef59d..228b3c381 100644
--- a/livesupport/doc/release.html
+++ b/livesupport/doc/release.html
@@ -13,7 +13,7 @@ Development Loan Fund, under the GNU GPL.
Makefile
with boost_version
from bin/dist.s
Make sure to check the versions for all the tools mentioned in these
files. Also check that there are no tools missing from the distribution
script that are mentioned in the master Makefile
.
+Updating release version and changelog
+Updating the release version and maintining a changelog helps people
+track the progress of the project. Also, building binary packages rely
+on this information, in particular debian packages won't build if there
+is a mismatch between the release version and the topmost entry in the
+debian changelog file.
+
+Curently, only the debian changelog keeps track of the changes and the
+version of LiveSupport. To update the changelog, edit etc/debian/changelog
,
+by inserting a section onto the top of the file:
+
+livesupport (<ls-version>-1) unstable; urgency=low
* Changes listed here
-- Package Maintainer <maintainer@foo.bar>
<timestamp>
+The timestamp above must be preceeded by two spaces, and must be an RFC
+2822 compliant date string, which is most easily produced by issuing
+the date -R
command. Please note that the debian package
+manager is quite picky on the format of the changelog file. See section
+4.4 of the Debian Policy Manual for more details.
+
+Don't forget to commit the changes made to the changelog into the CVS
+before proceeding.
Creating release tarballs
To create the release tarballs, invoke the distribution script bin/dist.sh
,