summaryrefslogtreecommitdiffstats
path: root/crawl-ref/docs
diff options
context:
space:
mode:
authorEino Keskitalo <evktalo@users.sourceforge.net>2009-10-13 22:32:41 +0300
committerEino Keskitalo <evktalo@users.sourceforge.net>2009-10-13 22:37:19 +0300
commit39c854694b7c893d81f82d59b1e1ccacc8a8f6c7 (patch)
tree6d9a4c9a894db2763846f52a0946c7c632d4d477 /crawl-ref/docs
parent71d9e45b127b002654c77e677929401b9274ca43 (diff)
downloadcrawl-ref-39c854694b7c893d81f82d59b1e1ccacc8a8f6c7.tar.gz
crawl-ref-39c854694b7c893d81f82d59b1e1ccacc8a8f6c7.zip
Update docs/develop/release.txt with git commands. Reviewing by more experienced git users appreciated.
Section 0. should probably be rewritten, as git should make branching and merging much smoother. Signed-off-by: Eino Keskitalo <evktalo@users.sourceforge.net>
Diffstat (limited to 'crawl-ref/docs')
-rw-r--r--crawl-ref/docs/develop/release.txt28
1 files changed, 15 insertions, 13 deletions
diff --git a/crawl-ref/docs/develop/release.txt b/crawl-ref/docs/develop/release.txt
index e370a797af..89f2d156a1 100644
--- a/crawl-ref/docs/develop/release.txt
+++ b/crawl-ref/docs/develop/release.txt
@@ -6,7 +6,7 @@ for those the list begins with step 2.
0. Delay branching as long as possible
Try to delay additions that forseeably won't make it into the next version
- until the release is not too far off. Once trunk has been branched, you
+ until the release is not too far off. Once master has been branched, you
have to commit all important changes twice, and it's easy to forget one
of them.
@@ -15,9 +15,8 @@ for those the list begins with step 2.
branch before the release.
Thus, you'll need to branch as early as necessary and as late as possible.
-1. Branch trunk into the new version
- svn cp https://crawl-ref.svn.sourceforge.net/svnroot/crawl-ref/trunk
- https://crawl-ref.svn.sourceforge.net/svnroot/crawl-ref/branches/stone_soup-0.X
+1. Branch master into the new version
+ git push origin origin:refs/heads/stone_soup.0.X
2. Update version information
version.h: Set VER_NUM = 0.X, VER_QUAL = empty.
@@ -44,7 +43,7 @@ for those the list begins with step 2.
compiles correctly, then run some basic sanity tests including at least
the following:
* start a new game (both prechosen and random)
- * saving/loading
+ * saving/loading (including loading from previous minor version)
* being killed
* level creation for all branches/portal vaults (using &~, &L)
* accessing all help screens (including the ? submenus)
@@ -61,8 +60,11 @@ for those the list begins with step 2.
the doc, settings and dat subfolders contain all relevant files.
7. Tag the release
- svn cp https://crawl-ref.svn.sourceforge.net/svnroot/crawl-ref/branches/stone_soup-0.X
- https://crawl-ref.svn.sourceforge.net/svnroot/crawl-ref/tags/stone_soup-0.X
+ In the branch you're about to tag:
+ git tag -a release-0.X.y
+
+ You'll need to push the tag into repository:
+ git push --tags
The tags are some sort of frozen state of the source for all releases, so
this is the last step you take before the actual release. All further
@@ -71,12 +73,12 @@ for those the list begins with step 2.
merged into trunk AND branch AND the corresponding tag.
8. Checkout the release tag
- svn co https://crawl-ref.svn.sourceforge.net/svnroot/crawl-ref/tags/stone_soup-0.X
+ git checkout -b stone_soup-0.X release-0.X.y
+
+ You may want to make a new shallow clone into a new folder, to make sure you don't get any compilation stuff into the distribution.
- Do a clean checkout into a new folder, so you don't get any compilation
- stuff into the distribution. Package the source (as described in 6.) and
- build the binaries. If you want you can do some more sanity testing but it
- shouldn't be necessary anymore.
+ Package the source (as described in 6.) and build the binaries. If you want
+ you can do some more sanity testing but it shouldn't be necessary anymore.
9. Upload the files to Sourceforge
Probably requires SF permissions for file releases.
@@ -105,7 +107,7 @@ for those the list begins with step 2.
for some more detailed explanations.
11. Update the homepage
- ssh -t username,crawl-ref@shell.sourceforge.net create
+ ssh -t username,crawl-ref@web.sourceforge.net create
Go to /home/groups/c/cr/crawl-ref/htdocs.
Paste the changelog into a newly created 0.X.txt