Documentation

h1. AG Projects - Software Repositories

h2. Debian and Ubuntu Linux

Install AG Projects software signing key:

<pre>
sudo curl -o /etc/apt/trusted.gpg.d/agp-debian-key.gpg http://download.ag-projects.com/agp-debian-key.gpg
</pre>

If you don't have Curl:
<pre>
sudo wget -O /etc/apt/trusted.gpg.d/agp-debian-key.gpg http://download.ag-projects.com/agp-debian-key.gpg
</pre>

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

h3. Ubuntu Bionic Beaver Trusty

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

h3. Ubuntu Cosmic Cuttlefish Xenial

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



h3. Debian Stable (Stretch)

<pre>
deb http://ag-projects.com/debian stretch main
deb-src http://ag-projects.com/debian stretch 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.