Documentation

h1. AG Projects - Software Repositories

h2. Debian and Ubuntu Linux

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 Trusty

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

h3. Ubuntu Utopic

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

h3. Ubuntu Vivid

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

h3. Debian Stable (Jessie)

<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 -us -uc
</pre>

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