Release Cycle

703pages on
this wiki
Add New Page
Add New Page Talk0


1. Freeciv Release Cycle begins when previous version is branched to its own stable branch. Part of that branching process is setting new version numbers and other version specific things to TRUNK. Version number is of form "<prev version>.99-dev" After that TRUNK is open for development of the features of the new version. This phase lasts at least one year. TRUNK is always in development build mode, meaning that many extra debug and sanity checking features are turned on to catch problems from the new code as soon as possible.

2. The new version itself is branched (Development Manager) New version continues development in stable branch. Only select new features can go in, while rapid development takes place in TRUNK for next release. Goal in the stable branch is to mature the features already in. Newly created branch remains in development build mode. Version label is changed to "-alpha"

3. Datafile format freeze (Development Manager) Formats of the custom content files used by the new version are declared frozen. After this point all revisions from the branch are compatible with same data files. Modders can start producing mods for the upcoming release knowing that mods compatible with current revision will be compatible with the release. Version number is set to match the upcoming release "<version>.0-alpha"

4. Network protocol freeze (Development Manager) Network protocol between freeciv server and client is declared frozen. After that point any client revision can work together with any server revision from the same branch. Branch is switched to beta build mode, mainly meaning that running the programs emits extra warnings about it being beta quality. Version label is changed to "-beta0"

5. Development Manager (in case of S2_6: cazfi) hands main responsibility of the branch to Release Manager (currently jtn). This may take place at the same time as Network protocol freeze (freeze will prevent a lot of further Development anyway), but can also be a bit later. When handing responsibility over, Development Manager should have collected list of changes since previous branch to help in writing of NEWS.

6. First beta (Release Manager) Followed by as many betas as necessary to reach release quality. Version labels are updated to match beta number

7. First Release Candidate (Release Manager) What is assumed to be content of first stable release from the branch. If serious issues are found from RC before stable release, new RCs are issued until one works. Version labels are update to match RC number.

8. First Stable Release (Release Manager) Followed by many more. There's no version label.

9. Abandoning the branch. At some point, usually a bit after first releases from the next version are already out, it's decided that no more releases from the branch will be made, except if needed to fix security vulnerabilities or other very serious issues found after that point.


Following things should be tested on regular basis, but at least once during a beta phase of a new major release.


Execute source code checks located in tests/ directory by running 'make src-check' in root build directory. Results get written to tests/

Unused entriesEdit

Run freeciv on "-d 3" debug level to see if there's any "unused entries" log messages from rulesets, tilesets, or any other data files.

Valgrind autogame serverEdit

We should get clean valgring report from server autogames.

Profile autogame serverEdit

Check that there's no new surprising CPU hogs

Build with different compilersEdit

Check that is up to dateEdit

Make sure that all the strings that should be collected for translation, are.

scensave checkEdit

Load scenarios from old versions, save them with /scensave command and diff result to old one to see that the changes are sensible.

Also on Fandom

Random Wiki