Documentation

h1. AG Projects - Software Repositories

h2. Debian and Ubuntu Linux packages

Install AG Projects software signing key:

<pre>
wget http://download.ag-projects.com/agp-debian-gpg.key
sudo apt-key add agp-debian-gpg.key
</pre>

Add the following lines to /etc/apt/sources.list

h3. Ubuntu Natty *Ubuntu Natty*

<pre>
deb http://ag-projects.com/ubuntu natty main
deb-src http://ag-projects.com/ubuntu natty main
</pre>

h3. Ubuntu Oneiric

<pre>
deb http://ag-projects.com/ubuntu oneiric main
deb-src http://ag-projects.com/ubuntu oneiric main
</pre>

h3. Ubuntu Precise

<pre>
deb http://ag-projects.com/ubuntu precise main
deb-src http://ag-projects.com/ubuntu precise main
</pre>

h3. Ubuntu Quantal

<pre>
deb http://ag-projects.com/ubuntu quantal main
deb-src http://ag-projects.com/ubuntu quantal main
</pre>

h3. Debian Stable

<pre>
deb http://ag-projects.com/debian stable main
deb-src http://ag-projects.com/debian stable main
</pre>

h3. Debian Unstable

<pre>
deb http://ag-projects.com/debian unstable main
deb-src http://ag-projects.com/debian unstable main
</pre>

To install or upgrade a software package:

<pre>
sudo apt-get update
sudo apt-get install package_name
</pre>

Replace @package_name@ with the name of the software package.

h2. Tar Archives

Some packages are available as tar archives:

http://download.ag-projects.com/

h2. Version Control Repositories

The source code is managed using darcs version control tool. The darcs repository can be fetched with:

<pre>
darcs get http://devel.ag-projects.com/repositories/package_name
</pre>

Replace @package_name@ with the name of the software package.

To obtain the incremental changes after the initial get run:

<pre>
darcs pull -a
</pre>

h2. Manual Installation

All python software packages can be installed system-wide using:

<pre>
sudo python setup.py install
</pre>

h2. Debian Package Building

Some of the packages are ready to be packaged for Debian like distributions by using this procedure:

Create under each repository a clean distribution file:
<pre>
python setup.py sdist
</pre>

Go to the ./dist directory and untar the file created at the step above.

Go to the newly created directory and type:

<pre>
debuild
</pre>

The .deb and related files are built in the upper directory.