Bad Penguin Packages
  " S y s t e m "
====================


 Author: Antonio Gallo <agx@linux.it>
   Date: Fri May 26 22:54:10 2000
Updated: Mon Jul 17 19:53:59 2000 - Added package.conf
Updated: Sat Aug 19 12:31:25 2000 - Added package.depots



Index
=====
    1. Directories Configuration
    2. Files & Directories
    3. Scripts & Binaries
    
    

1. Directories Configuration
============================

The Bad Penguin Package System is made of the following directories:
    /etc/badpenguin/bpp/           - configuration files
    /usr/share/badpenguin/packages - contains package downloaded by 
                                     internet or rebuilded locally
    /usr/share/badpenguin/sources  - contains source code downloaded by
                                     internet or manually copied by cdrom
    /usr/share/badpenguin/ports    - contains the 'ports' of any package
    /var/spool/badpenguin          - contains info on installed packages

Those directories are full configurable thru' the file
    /etc/badpenguin/bpp/package.conf



2. Files & Directories
======================

/etc/badpenguin/release
This file contains the distribution release version informations
	NAME="Bad Penguin"
	COMPATIBLE="Debian"
	VERSION="0.6.0pre4"
	MAJOR="0"
	MINOR="6"
	PATCHLEVEL="pre4"
	CODENAME="Firegarden"
	RELEASEDATE="`date`"

/etc/badpenguin/bpp/package.conf
This file contains the configuration value needed by the
scripts into package-tools
	DIST_VERSION="/etc/badpenguin/release"
	PACKAGE_CONF="/etc/badpenguin/bpp/package.conf"
	PACKAGE_DEPOTS="/etc/badpenguin/bpp/package.depots
	PKG_PKGDEPOT="/usr/share/badpenguin/packages"
	PKG_SRCDEPOT="/usr/share/badpenguin/sources"
	PKG_PORTSDIR="/usr/share/badpenguin/ports"
	PKG_SPOOLDIR="/var/spool/badpenguin"
	PKG_WORKDIR="/usr/local/src"
	PKG_VERSION="2.0.0"
	PKG_CATEGORIES="base games gnome palm www x11 x11-servers x11-wm
"

/etc/badpenguin/bpp/package.depots
This file contains a list of local, ftp or http directories that contains
mirror of the package depot.
Usually it is arranged in this way:
    /cdrom/badpenguin/packages
    /usr/share/badpenguin/packages
    ftp://ftp3.linux.it/pub/Linux/Badpenguin/packages | <tempfile> | <updatetime>
As you can see the file contains additional information for ftp and http
depot, in order to cache the list of the files on it.



3. Scripts & Binaries
======================


package-create
--------------
This tool help mantainers to create new packages from scratch.
You just invoke it as
    package-create /tempdir
and it will guide you thru' all the step to build a package
using the temporary directory you specified as first parameter.
package-create run thru` a lot of steps, you can jump or force
some steps by just using the step name as second parameter.



package-init
------------
This script creates all the necessary configuration 
files and directories used by the Bad Penguin package system.
Its mainly purpose is to allow people without Bad Penguin
to install and build .bpp packages.
    
    
package-rebuild
---------------
This tool is used to rebuild package from the ports directory.
It can be used by sysadmin to update their system or to compile
packages for a different architecture. It is mainly used by
'package-setup' to build a package from source when it is not
found upon the system.


package-repack
--------------
If you make some changes to the filesystem that should be added 
to the package then this tool let you build a package, available 
into the 'ports' directory, gathering binaries and libraries 
from the filesystem.


package-build
-------------
This tool is used to create a .bpp package from a directory tree.
It take care of setting up all the appropriate information files
for the package.


package-setup / setup
---------------------
This is the command line package manager tools, like rpm or dpkg.



EOF
