aboutsummaryrefslogtreecommitdiffstats
path: root/doc/download.txt
blob: ebd7004f734d3f491a17192528f696cdf4141d1d (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103

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``.