[ecj] 125/145: Added debian/README.source documenting the upgrade process

[Emmanuel Bourg]

This is an automated email from the git hooks/post-receive script.

ebourg-guest pushed a commit to branch master
in repository ecj.

commit aa742d8d5c4b933e679f81235b803c65d74dacbd
Author: Emmanuel Bourg <ebourg at apache.org>
Date:   Tue Mar 27 13:02:28 2018 +0200

    Added debian/README.source documenting the upgrade process
---
 debian/README.source | 22 ++++++++++++++++++++++
 debian/changelog     |  1 +
 2 files changed, 23 insertions(+)

diff --git a/debian/README.source b/debian/README.source
new file mode 100644
index 0000000..6f0a255
--- /dev/null
+++ b/debian/README.source
@@ -0,0 +1,22 @@
+Information about ecj
+---------------------
+
+This package provides the Eclipse Compiler for Java independently of the Eclipse
+platform which may be more difficult to upgrade than this independent package.
+This compiler is used by Tomcat to compile the JSPs.
+
+Versioning
+----------
+
+There is a mismatch between the version of the Eclipse Platform which is used
+to tag the upstream source repository and the version of the Eclipse Compiler.
+The package caries the version of the compiler, this version is found in the
+org.eclipse.jdt.core/META-INF/MANIFEST.MF file in the upstream source tree.
+
+
+Updating
+--------
+
+1. Find the version of the compiler and add an entry in debian/changelog
+2. Update the TAG constant in debian/rules (with the version of the Eclipse Platform)
+3. Run ./debian/rules get-orig-source
diff --git a/debian/changelog b/debian/changelog
index 1e6fc18..f57c25d 100644
--- a/debian/changelog
+++ b/debian/changelog
@@ -3,6 +3,7 @@ ecj (3.11.1-3) UNRELEASED; urgency=medium
   * No longer build the -gcj packages (Closes: #892531)
   * Removed the Conflicts/Replaces fields referencing very old packages
   * Removed the build dependency on dpkg
+  * Added debian/README.source documenting the upgrade process
   * Added myself to the uploaders
   * Moved the package to Git
   * Standards-Version updated to 4.1.3

-- 
Alioth's /usr/local/bin/git-commit-notice on /srv/git.debian.org/git/pkg-java/ecj.git