imip-agent

Annotated docs/wiki/Downloads

1384:9baa0aae5b43
2017-10-31 Paul Boddie Provided a convenience function for instantiating handler objects. Added a mode that produces output instead of sending messages without also producing debugging information. client-editing-simplification
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@1223 55
0.3
paul@1223 56
|| [[http://hgweb.boddie.org.uk/imip-agent/rev/rel-0-3|changeset]]
paul@1223 57
.. [[http://hgweb.boddie.org.uk/imip-agent/file/rel-0-3|files]]
paul@1223 58
==
paul@1156 59
0.2
paul@1156 60
|| [[http://hgweb.boddie.org.uk/imip-agent/rev/rel-0-2|changeset]]
paul@1156 61
.. [[http://hgweb.boddie.org.uk/imip-agent/file/rel-0-2|files]]
paul@1156 62
==
paul@989 63
0.1
paul@1104 64
|| [[http://hgweb.boddie.org.uk/imip-agent/rev/rel-0-1|changeset]]
paul@1104 65
.. [[http://hgweb.boddie.org.uk/imip-agent/file/rel-0-1|files]]
paul@989 66
}}}
paul@1104 67
paul@1156 68
Details of changes introduced in each new release can be found in the
paul@1156 69
[[../Changelog|changelog]].
paul@1156 70
paul@1104 71
=== Archives ===
paul@1104 72
paul@1104 73
Downloadable archives are provided below. Choose "get" to download the
paul@1104 74
appropriate file.
paul@1104 75
paul@1104 76
<<AttachList(,application/x-tar)>>
paul@1105 77
<<AttachList(,application/x-bzip2)>>
paul@1104 78
paul@1104 79
=== Signatures ===
paul@1104 80
paul@1104 81
Downloadable archive signatures are provided below. Choose "get" to download
paul@1104 82
the appropriate file.
paul@1104 83
paul@1104 84
<<AttachList(,text/plain)>>
paul@1105 85
<<AttachList(,application/pgp-signature)>>
paul@1104 86
paul@1104 87
To verify an archive, download the archive and accompanying signature file to
paul@1104 88
the same location and then run a command of the following form:
paul@1104 89
paul@1104 90
{{{
paul@1104 91
gpg --verify <signature file> <archive file>
paul@1104 92
}}}
paul@1104 93
paul@1104 94
For example:
paul@1104 95
paul@1104 96
{{{
paul@1223 97
gpg --verify imip-agent-0.3.tar.bz2.asc imip-agent-0.3.tar.bz2
paul@1104 98
}}}