+------------------------------------------------------------------------------+
| EnGarde APT Repository README                                                |
| Ryan W. Maple <ryan@guardiandigital.com>                                     |
+------------------------------------------------------------------------------+

Introduction
------------
  This document is intended to provide the reader with a basic understanding of
  how to configure and use the newly available APT repository for supplemental
  EnGarde packages.

  It is assumed that the reader of this document is a somewhat advanced user
  who does not mind working from the shell and knows how to use a basic text
  editor such as vi(1) or pico(1).

  This document will walk the reader through the following steps:

    * Downloading and configuring the APT package.

    * Keeping the local package index files up to date with the repository.

    * Installing packages from the repository

    * Upgrading packages against what is available in the repository.

Getting Started
---------------
  To get started, download and install the 'apt' package:

    # wget http://ftp.engardelinux.org/pub/engarde/people/ryan/engarde/feint/RPMS.extras/apt-0.3.19cnc55-1.5.0.i386.rpm

    # lidsadm -S -- -LIDS_GLOBAL
    # rpm -Uvh apt-0.3.19cnc55-1.5.0.i386.rpm

  Next, put the following lines into /etc/apt/sources.list:

    rpm http://ftp.engardelinux.org/pub/engarde/people/ryan engarde/feint extras
    rpm-src http://ftp.engardelinux.org/pub/engarde/people/ryan engarde/feint extras

  Finally, run 'apt-get update' to synchronize your local package index files
  against what is available in the repository:

    # apt-get update

Getting to Know apt-get(8)
--------------------------
  apt-get is a very easy tool.  To install a package:

    # apt-get install <package>

  For example, 'apt-get install nmap' would install the nmap package and any
  other packages on which it depends.

  apt-get can also be used to perform upgrades:

    # apt-get upgrade

  This command will upgrade any package you retrieved from the repository with
  the latest available version.

Adding Packages
---------------
  We are always looking for more packages to add to the repository.  Send all
  requests for new or updated packages to the engarde-users mailing list.

Mirrors
-------
  Below is a list of mirrors:

  * ftp.lug.udel.edu (Delaware, USA)

    rpm http://ftp.lug.udel.edu/pub/distributions/engarde/people/ryan engarde/feint extras
    rpm-src http://ftp.lug.udel.edu/pub/distributions/engarde/people/ryan engarde/feint extras

  * ftp.ibiblio.org (North Carolina, USA)

    rpm http://www.ibiblio.org/pub/linux/distributions/engarde/people/ryan engarde/feint extras
    rpm-src http://www.ibiblio.org/pub/linux/distributions/engarde/people/ryan engarde/feint extras

Support
-------
  All of the packages available in the APT repository are supported via the
  engarde-users mailing list:

    http://infocenter.guardiandigital.com/community/

  Please e-mail the list if you have any problems installing or using any
  of the packages in this repository.

  A few EnGarde users and developers also sit on IRC:

    Server:	irc.freenode.net
    Channel:	#EnGarde

+------------------------------------------------------------------------------+
$Id: README,v 1.5 2004/02/18 20:27:57 rwm Exp $