How to get the source code from Mercurial
You are here: Home → Documentation → How to get the source code from Mercurial
Read access to the Coin3D and SIM Voleon Mercurial repositories is available for those who want to follow the development closely and want a convenient mechanism for keeping synchronized with the source code at all times.
To check out source code from the Mercurial repositories, you need the Mercurial version control system. In addition to the standard Mercurial command line client there are further Mercurial clients for different platforms and Integrated Development Environments to choose from. TortoiseHG offers an easy to use, graphical and well integrated Mercurial package for various platforms.
For information on all available Mercurial repositories, please consult our Mercurial repositories index. For up to date information on current development you can subscribe to the provided Mercurial RSS/Atom feeds or through the aggregated feed of all public repositories provided on Recent Activity. Furthermore, links to current snapshots in zip or tar.bz2 formats are provided to allow for downloads of the most recent repository without the need to install a Mercurial client on your setup.
The following instructions assume the usage of the standard Mercurial command line client.
To get a copy of a Mercurial repository, move to your source code
directory and issue a Mercurial checkout command:
$ hg clone https://bitbucket.org/Coin3D/repository-name repository-name
For example, to check out the older Coin-2 repository, run:
$ hg clone http://hg.sim.no/Coin-2/default Coin-2
The checkout command will create a directory 'Coin-2' in the current directory.
(The '$' characters at the start of the line just signifies a command prompt and should not be typed.) Note that no username and password is required. If you do get a username/password prompt, check that the repository url is spelled correctly, while keeping in mind that the repository names are case sensitive.
As mentioned earlier, in order to be notified about updates in the Coin3D related Mercurial repositories, subscribe yourself to the respective RSS/Atom feeds of each repository you are interested in or the aggregated feed on Planet Coin3D. To update the Mercurial repository itself, run:
$ hg pull -u
in your checked out source tree. All the latest changes to the sourcecode will then be fetched and merged with the sourcecode you already checked out.