Ayam Icon
Ayam

Start
News
Gallery
Features
Download
Docs

Mercurial

This document describes how to get the latest development version of Ayam from the Mercurial repository.
But first, a word of warning:
Versions of Ayam from Mercurial are not for production use, because they may write scene-files, that can not be read with any other version of Ayam (including the next official release version!)[1][2].
But if you are a developer and/or want to help finding bugs before official release you are of course welcome to try the latest version from the repository. The file Changes.txt (← direct link to webviewer!) lists all user visible changes to Ayam in the repository and will be updated on a weekly basis.

To work with the latest version of the Ayam source code, follow the instructions below:

  1. Download and install the Mercurial client (see also the official Mercurial home page).
  2. Enter into a shell:
    » hg clone http://hg.code.sf.net/p/ayam/mercurial ayam-mercurial
    This will clone the repository and place it in the current directory.
  3. Now you just need to change to the new directory:
    » cd ayam-mercurial
    and start working.

To update your repository to the latest changes you would enter:
» hg pull
followed by
» hg update
or short:
» hg pull -u

You can also check out the Ayam sources of a specific release version using
» hg update Release-1_1
Replace "Release-1_1" with the version you want to check out, e.g. "Release-1_4", "Release_1_5", or "Release_1_6".

Alternatively, you may browse the repository through a simple web interface.

If you find a bug in the development version of Ayam that is not present in the current official release, please, do not enter it to the bug tracking system, but rather send e-mail or post into the public forum.

1 This does not apply to versions with release tags.
2 Until the Ayam version string of the head contains a "pre" (e.g. "1.9pre") no incompatible changes to the file format or the internal data structures occurred (just bug-fixes and additional functionality).


Randolf Schultz, 15. Dec 2017
randolf.schultz@gmail.com