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 Lucid

<pre>

deb	http://ag-projects.com/ubuntu lucid main 

deb-src http://ag-projects.com/ubuntu lucid main

</pre>

h3. Ubuntu Maverick

<pre>

deb	http://ag-projects.com/ubuntu maverick main 

deb-src http://ag-projects.com/ubuntu maverick main

</pre>

h3. *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. 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.