imip-agent

Annotated docs/wiki/Downloads

1160:e42ef2cc0569
1156:02bd52e41638
1105:5aab37be2f7b
2016-04-22 Paul Boddie file changeset files shortlog Added a changelog and updated the release information.
paul@989 1 
= Downloads =
paul@989 2 
 
 paul@990      3 
Ultimately, the aim is make imip-agent available through Free Software
 
 paul@989      4 
operating system distributions such as Debian, providing packages that are
 
 paul@990      5 
trivially installed and that work with the rest of the system straight away
 
 paul@990      6 
upon installation.
 
 paul@990      7 
 
 paul@989      8 
Until this is realised, the software will need to be downloaded manually.
 
 paul@990      9 
See the [[../GettingStarted|getting started guide]] once you have obtained
 
 paul@990     10 
the software.
 
 paul@990     11 
 
 paul@1006     12 
Remember that certain [[../Prerequisites|prerequisites]] are needed for the
 
 paul@1006     13 
software to work.
 
 paul@1006     14 
 
 paul@990     15 
== Copyright and Licence ==
 
 paul@990     16 
 
 paul@990     17 
The imip-agent distribution is made available according to the terms of the
 
 paul@990     18 
[[http://www.gnu.org/copyleft/gpl.html|GNU GPL (version 3 or later)]]. See
 
 paul@990     19 
the `docs/COPYING.txt` and `docs/gpl-3.0.txt` files in the source code
 
 paul@990     20 
distribution for details.
 
 paul@989     21 
 
 paul@989     22 
== Repository ==
 
 paul@989     23 
 
 paul@989     24 
The source code repository is located at the following location:
 
 paul@989     25 
 
 paul@989     26 
http://hgweb.boddie.org.uk/imip-agent
 
 paul@989     27 
 
 paul@989     28 
The repository can be cloned using [[http://mercurial.selenic.com/|Mercurial]]
 
 paul@989     29 
as follows:
 
 paul@989     30 
 
 paul@989     31 
{{{
 
 paul@989     32 
hg clone http://hgweb.boddie.org.uk/imip-agent
 
 paul@989     33 
}}}
 
 paul@989     34 
 
 paul@989     35 
If you are familiar with version control systems and Mercurial in particular,
 
 paul@989     36 
it can be convenient to use this approach to obtain and update the software,
 
 paul@990     37 
although you should be aware that updates made available in the repository may,
 
 paul@990     38 
if deployed, cause the software to not function correctly on occasion, even if
 
 paul@990     39 
attempts are made to avoid such situations. Therefore, you should choose to
 
 paul@990     40 
update with care and be prepared to switch to a "known working" revision if
 
 paul@990     41 
necessary.
 
 paul@989     42 
 
 paul@989     43 
== Releases ==
 
 paul@989     44 
 
 paul@1156     45 
{{{#!wiki tip
 
 paul@1104     46 
See below for downloadable archives.
 
 paul@1156     47 
}}}
 
 paul@1104     48 
 
 paul@989     49 
Releases are tagged in the repository. The currently-supported releases are
 
 paul@989     50 
listed here for convenience:
 
 paul@989     51 
 
 paul@989     52 
{{{#!table
 
 paul@1104     53 
'''Release''' || '''Details'''
 
 paul@989     54 
==
 
 paul@1156     55 
0.2
 
 paul@1156     56 
|| [[http://hgweb.boddie.org.uk/imip-agent/rev/rel-0-2|changeset]]
 
 paul@1156     57 
.. [[http://hgweb.boddie.org.uk/imip-agent/file/rel-0-2|files]]
 
 paul@1156     58 
==
 
 paul@989     59 
0.1
 
 paul@1104     60 
|| [[http://hgweb.boddie.org.uk/imip-agent/rev/rel-0-1|changeset]]
 
 paul@1104     61 
.. [[http://hgweb.boddie.org.uk/imip-agent/file/rel-0-1|files]]
 
 paul@989     62 
}}}
 
 paul@1104     63 
 
 paul@1156     64 
Details of changes introduced in each new release can be found in the
 
 paul@1156     65 
[[../Changelog|changelog]].
 
 paul@1156     66 
 
 paul@1104     67 
=== Archives ===
 
 paul@1104     68 
 
 paul@1104     69 
Downloadable archives are provided below. Choose "get" to download the
 
 paul@1104     70 
appropriate file.
 
 paul@1104     71 
 
 paul@1104     72 
<<AttachList(,application/x-tar)>>
 
 paul@1105     73 
<<AttachList(,application/x-bzip2)>>
 
 paul@1104     74 
 
 paul@1104     75 
=== Signatures ===
 
 paul@1104     76 
 
 paul@1104     77 
Downloadable archive signatures are provided below. Choose "get" to download
 
 paul@1104     78 
the appropriate file.
 
 paul@1104     79 
 
 paul@1104     80 
<<AttachList(,text/plain)>>
 
 paul@1105     81 
<<AttachList(,application/pgp-signature)>>
 
 paul@1104     82 
 
 paul@1104     83 
To verify an archive, download the archive and accompanying signature file to
 
 paul@1104     84 
the same location and then run a command of the following form:
 
 paul@1104     85 
 
 paul@1104     86 
{{{
 
 paul@1104     87 
gpg --verify <signature file> <archive file>
 
 paul@1104     88 
}}}
 
 paul@1104     89 
 
 paul@1104     90 
For example:
 
 paul@1104     91 
 
 paul@1104     92 
{{{
 
 paul@1104     93 
gpg --verify imip-agent-0.1.tar.bz2.asc imip-agent-0.1.tar.bz2
 
 paul@1104     94 
}}}