Getting The Latest Sources
========================================

All releases are signed with a :doc:`PGP key <pgpkey>`.

Unsure which release you want? Check the :ref:`FAQ <devel_vs_stable>`.

.. only:: not website

   .. note::

      If you are viewing this documentation offline, a more recent
      release `may be available <http://botan.randombit.net/download.html>`_

Current Stable Release (1.10)
----------------------------------------

The current stable release is `1.10.3
<http://botan.randombit.net/relnotes/1_10_3.html>`_ which was
released on 2012-07-10.

Sources:

`1.10.3 tar/gz <http://botan.randombit.net/files/Botan-1.10.3.tgz>`_
(`1.10.3 tar/gz sig <http://botan.randombit.net/files/Botan-1.10.3.tgz.asc>`_),

`1.10.3 tar/bzip <http://botan.randombit.net/files/Botan-1.10.3.tbz>`_
(`1.10.3 tar/bzip sig <http://botan.randombit.net/files/Botan-1.10.3.tbz.asc>`_)

..
  Windows binary installer for use with Visual C++ 2010:

  `1.10.1 x86-32 installer
  <http://botan.randombit.net/files/win32/botan-1.10.1_win32.exe>`_

  `1.10.1 x86-64 installer
  <http://botan.randombit.net/files/win32/botan-1.10.1_win64.exe>`_

Previous Stable Release (1.8)
----------------------------------------

The previous stable release is `1.8.13
<http://botan.randombit.net/news/releases/1_8_13.html>`_ which was
released on 2011-07-02.

Sources:

`1.8.13 tar/gz <http://botan.randombit.net/files/Botan-1.8.13.tgz>`_
(`1.8.13 tar/gz sig <http://botan.randombit.net/files/Botan-1.8.13.tgz.asc>`_),

`1.8.13 tar/bzip <http://botan.randombit.net/files/Botan-1.8.13.tbz>`_
(`1.8.13 tar/bzip sig <http://botan.randombit.net/files/Botan-1.8.13.tbz.asc>`_)

..
  Windows binary installer for use with Visual C++ 2008:

  `1.8.13 x86-32 installer
  <http://botan.randombit.net/files/win32/botan-1.8.13_win32.exe>`_

  `1.8.13 x86-64 installer
  <http://botan.randombit.net/files/win32/botan-1.8.13_win64.exe>`_

Accessing Version Control
----------------------------------------

Botan's development occurs using a distributed version control system
called `Monotone <http://www.monotone.ca>`_.

The main branch of development occurs on the branch named
``net.randombit.botan``; this is probably the branch you want (for
1.8, use ``net.randombit.botan.1_8`` instead). To download that branch
and set up a new workspace, run::

   $ mtn db init --db=botan.mtn
   $ mtn pull --db=botan.mtn randombit.net 'net.randombit.botan'
   [...]
   $ mtn checkout --db=botan.mtn --branch=net.randombit.botan
   [...]

By default the ``checkout`` command will place the workspace in a directory
with the same name as the branch you are checking out.  If you want a
different directory name, just include it after the ``--branch`` option (you
can also rename this directory at any time).

If this is the first time you've connected to the server, Monotone
will print::

  mtn: first time connecting to server randombit.net
  mtn: I'll assume it's really them, but you might want to double-check
  mtn: their key's fingerprint: 8c0b868f2247215c63c96983b1c8ca0f0f0cfd9a

The fingerprint shown above was the correct one as of September 21, 2010.

To pull further changes, from anywhere in the workspace run these commands::

  $ mtn pull
  [...]
  $ mtn update
  [summary of changes]

The ``mtn update`` command will give you a summary of which files changed;
to view the full changelog, run ``mtn log``.