Documentation

h1. AG Projects - Software Repositories

h2. Debian and Ubuntu Linux

Install AG Projects software signing key:

<pre>

(cd /etc/apt/trusted.gpg.d/; sudo curl --remote-name http://download.ag-projects.com/agp-debian-key.gpg)

</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 Xenial

<pre>

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

deb-src http://ag-projects.com/ubuntu xenial 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.