Setting game version number

Package versioning and In game display

in configure.ac change
AC_INIT(freedroidRPG, 0.11rc1)

The "testing version" warning popup message is added automatically for builds with "rc" in the name.

---

Todo: Figure out if...

• Possible to make a version string that automatically updates svn version? AC_INIT(freedroidRPG, 0.11rc1  svn961 ) ?
  Other projects, eg ufoai, has this. Convenient for bug reports.
• Should rc builds be treated as "stable" to not be quitting due to float exceptions? This is true now, but should it?

---

Creating the packages

Before starting:

• Update src/vars.h with the languages that should be included.
• We probably need to properly handle creating new up to date po/*.pot files without any outdated cruft in them.

Linux source tarball

1) Do a new fresh checkout (so old cruft in your own version isn't included)
svn co https://freedroid.svn.sourceforge.net/svnroot/freedroid freedroid-clean
2) cd freedroid-clean
3) ./autogen.sh
4) ./configure
5) make dist-bzip2
6) Verify that the created tar works (unpack && ./configure && make) and game runs from src/ folder.
7) Also verify that make install works and installed game runs. (sudo make install, run it, sudo make uninstall)

Current manual fixups for Windows and MacOS?-binary versions:

• Remove any language dir in po/ that is not complete enough to be in the release (Windows and MacOS? currently irreversibly default to system localization.)

Windows .zip

1) Create a new empty folder with an appropriate name, eg freedroidrpg-0.11rc1-win32
2) Compile or download freedroidRPG.exe (AH usually has it here http://www.freedroid.org/freedroidRPG.exe ) and place it in the created folder
3) Add all needed DLLs to the folder ( http://ah34.free.fr/DLL/ )
4) Add the following files and subfolders from the Linux tarball
Files Required: COPYING (the GPL licence) README
Files Optional: HELP-WANTED NEWS Changelog
Folders: dialogs/ graphics/ map/ po/ sound/
5) Compress the folder into a zip.
6) Verify it extracts & runs properly.

Windows Self Extracting Archive

Get Cygal to do his SEA under Windows (that adds desktop links etc)

or, for more plain versions
1-4) As above, then
for SE zip:
http://www.info-zip.org/FAQ.html#unixSFX

for 7z:
5) 7za a -sfx freedroidrpg-0.11rc1-win32.exe freedroidrpg-0.11rc1-win32
6) Verify it extracts & runs properly.

http://www.tu-harburg.de/rzt/tuinfo/oberflaechen/linux/sfx.html

Advantage over zip: No risk of user using broken unziptool, about 5% smaller
Disadvantage: Some people don't like .exe packages

---

Todo:

Linux .deb package

http://ubuntuforums.org/showthread.php?t=51003

Beos
MacOS

---

Putting the files online

Temporary upload location.

Do NOT release from here. Only used this as a temporary storage location to eg allow a small group of users, eg the development team, to download and verify your package is working before putting it on the release server.

1) Before interacting with SFs services via commandline, you first need to create an active shell
ssh -t USERNAME,freedroid@shell.sourceforge.net create
2) In a new commandline window SCP the files 1 by 1 to the SF server
scp FILENAME USERNAME@shell.sf.net:/home/groups/f/fr/freedroid/htdocs
3) Send the proper link(s) to the target people.
http://www.freedroid.org/FILENAME

Remember to login and remove the files when not needed any more.
ssh -t USERNAME,freedroid@shell.sourceforge.net create
cd /home/groups/f/fr/freedroid/htdocs
rm FILENAME

If you need to verify the RSA keys for SF you find them here
http://alexandria.wiki.sourceforge.net/SSH+Host+Key+Fingerprints

SourceForge File Release System (FRS)

Note: You have to have the appropriate administration rights on SF for FreedroidRPG
1) Using eg Filezilla, connect to frs.sourceforge.net:22
2) Upload the files to the upload/ dir.
3) Login to your account on http://sourceforge.net/ with your browser.
4) Go to the freedroid project.
5) In the ADMIN tab select "File Releases"
https://sourceforge.net/project/admin/editpackages.php?group_id=54521
6) in FRS for package name: freedroidRPG press the add release button.
7) Name the release, eg freedroidRPG-0.11rc1 and continue
8) Fill in the form, committing the section after each change. Look on previous releases for file settings.
9) Verify links are working and correct packages are downloaded.

You find the relevant documentation here http://sourceforge.net/docman/?group_id=1 section E01
http://sourceforge.net/docman/display_doc.php?docid=6445&group_id=1

Announcing the release

FRS people monitoring this package

Put a marker in the box to mail these people

Maillist

Send out a mail

Website

Put up a news item on the front/news page
nano -w /home/groups/f/fr/freedroid/htdocs/data/news.txt

News item on SF

1) Login to your account on http://sourceforge.net/ with your browser.
2) Go to the freedroid project.
3) In the ADMIN tab select "News"
4) Press submit
5) Write the new entry