1
.. IVLE - Informatics Virtual Learning Environment
2
Copyright (C) 2007-2009 The University of Melbourne
4
.. This program is free software; you can redistribute it and/or modify
5
it under the terms of the GNU General Public License as published by
6
the Free Software Foundation; either version 2 of the License, or
7
(at your option) any later version.
9
.. This program is distributed in the hope that it will be useful,
10
but WITHOUT ANY WARRANTY; without even the implied warranty of
11
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
12
GNU General Public License for more details.
14
.. You should have received a copy of the GNU General Public License
15
along with this program; if not, write to the Free Software
16
Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
22
To release IVLE, both generic source tarballs and Ubuntu packages should
25
These instructions expect to be run on a Debian-derived system with a
26
working IVLE installation. You also need to have your system set up with
27
write access to Launchpad branches.
30
Tag the release in Bazaar
31
=========================
33
To note down the release's revision in the Bazaar trunk, run ``bzr tag
37
Generate a source tarball
38
=========================
40
To generate a tarball of the current state of trunk, run ``bzr export
41
ivle-VERSION.tar.gz lp:ivle``.
44
Release it on Launchpad
45
=======================
47
As a member of the `IVLE Developers <https://launchpad.net/~ivle-dev>`_ team,
48
visit the `IVLE project page <https://launchpad.net/ivle>`_. There you'll see
49
a graph of IVLE's series, milestones and releases.
51
Clicking on the series in which this release should be created will present
52
a list of existing milestones and releases. If a milestone for this release
53
already exists, click "Release now". If not, click "Create release". Enter
54
the release date on the following form, and confirm the creation.
56
To upload the release tarball for the world to see, hit "Add download file" on
57
the release page. Give a meaningful description like "IVLE 1.0 source", select
58
the file, and ensure that the type is "Code Release Tarball".
63
`Launchpad release documentation <https://help.launchpad.net/Projects/SeriesMilestonesReleases>`_
64
All you could ever want to know about Launchpad's series, milestones and
68
Publish an Ubuntu package
69
=========================
71
An Ubuntu package is kept in the `PPA for production environments
72
<https://launchpad.net/~unimelb-ivle/+archive/production>`_. Releases should
73
be pushed out to there if destined for production systems. The packaging is
74
kept in a separate branch: `lp:~ivle-dev/ivle/debian-packaging
75
<https://code.launchpad.net/~ivle-dev/ivle/debian-packaging>`_.
77
You will need to be a member of the `University of Melbourne IVLE developers
78
<https://launchpad.net/~unimelb-ivle>`_ team, have an OpenPGP key assigned to
79
your account, and have signed the Ubuntu Code of Conduct. See the PPA
80
documentation linked below for instructions. You should be able to build
81
the package on any Debian-derived operating system that uses ``dpkg``.
82
You also need to have an SSH key `associated with your account
83
<https://help.launchpad.net/YourAccount/CreatingAnSSHKeyPair>`_ so you can
84
commit to the branch on Launchpad.
86
When performing a release, you should merge trunk into a checkout of the
87
packaging branch. Then run ``dch -i`` to add a new Debian changelog entry.
88
For the Debian version string, append ``-0ppa1`` to the IVLE version (eg.
89
``1.0-0ppa1``). Make sure that you target to the correct Ubuntu series
90
(currently ``hardy``). Also ensure that your name and email address are set
91
correctly at the bottom of the new entry.
93
Next ensure that you have a copy of the release tarball in the parent
94
directory, named ``ivle_VERSION.orig.tar.gz``. Once that's there, run
95
``debuild -S -sa -i`` inside the checkout to build the source package and
96
have the results placed in the parent directory.
98
``dput ppa:unimelb-ivle/production ivle_VERSION_source.changes`` will now
99
upload the package to the production PPA. You should receive an acknowledgement
100
email from Launchpad within five minutes, at which point Launchpad will begin
101
building binaries from the source package. You can check the build progress
102
on the `PPA detail page
103
<https://launchpad.net/~unimelb-ivle/+archive/production/+packages>`_.
105
Remember to commit to and push the ``debian-packaging`` branch when done.
109
`Launchpad PPA documentation <https://help.launchpad.net/Packaging/PPA>`_
110
All you could ever want to know about using Launchpad's PPA
113
`Ubuntu Packaging Guide <https://wiki.ubuntu.com/PackagingGuide/Basic>`_
114
All you could ever want to know about Ubuntu packaging.
added
removed
doc/dev/releases.rst
