From: Gordon Hecker <gh@emlix.com>
Date: Mon, 15 Mar 2010 15:56:26 +0000 (+0100)
Subject: documentation: write migration documentation
X-Git-Tag: e2factory-2.3.4rc2~8
X-Git-Url: https://git.e2factory.org/?a=commitdiff_plain;h=8e36031a9cdceee9616179b40d3ea2024571eebf;p=e2factory.git

documentation: write migration documentation

Signed-off-by: Gordon Hecker <gh@emlix.com>
---

diff --git a/doc/manual/migration.text b/doc/manual/migration.text
index baa8c6a..441b87c 100644
--- a/doc/manual/migration.text
+++ b/doc/manual/migration.text
@@ -1,6 +1,27 @@
 Migrating to newer versions of e2factory
 -----------------------------
 
+### Migrating from e2factory-2.3.3 to e2factory-2.3.4 ###
+
+*   The file `.e2/version` was maintained with the project configuration
+    in versions up to 2.3.3. This is no longer the case now.
+
+Remove the `.e2/version` file from the repository
+
+    $ git rm .e2/version
+    $ git commit
+
+*   A file `.e2/global-version` is automatically created on project
+    checkout, using the server side project descriptor file.
+    This file must not be checked into the project repository.
+    If it is not possible to re-checkout the project, copy the file
+    `.e2/version` to `.e2/global-version` manually before removing
+    it, or fetching the update from upstream.
+
+### Migrating from e2factory-2.3.2 to e2factory-2.3.3 ###
+
+*   No changes required
+
 ### Migrating from e2factory-2.3.1 to e2factory-2.3.2 ###
 
 *   change the chroot configuration format according to the documentation