Bad Penguin Packages
"Package Structure"
====================

 Author: Antonio Gallo <agx@linux.it>
   Date:               19-06-1998 (0.0.1)
   Date: Fri May 26 22:54:10 2000 (1.9.0)
Updated: Mon Jul 17 19:55:46 2000 (2.0.0)
Updated: Tue Jul 18 20:25:12 2000 (2.0.1)



Index
=====
    1. Bad Penguin's Packages
    2. Package's Files
    3. Package's Reference



1. Bad Penguin's Packages
=========================

A Bad Penguin Package (.bpp) is a tar+gzipped archive that contains
all the package's files plus 2 special directories:
    /install         - contains all the package's informations
    /install/compile - contains information on how to build the package
                       from the source
    /install/patches - contains patches to be applied to the source when
		       building a package from scratch
    /install/scripts - contains all the script executed by the packager
    /incoming        - contains all the files that have not to be overwritten
		       when installing the package



2. Package's Files
==================

This is the list of all the files you can find into the /install
subdirectory of a package:
    DESCRIPTION   - Contains the long description of the package.
    MANIFEST      - Contains the list of files included into the package.
    MD5MANIFEST	  - Contains MD5 checksums of each binary files.
    INFO          - This is the file with all the informations about the package.

This is the list of all the files you can find into the /install/compile
subdirectory of a package:
    PRE-CONFIG		- run before to configure (make distclean)
    CONFIGUR		- configure the source (./configure)
    POST-CONFIG		- run after configure (make clean")
    COMPILE		- compile the source (make)
    MAKETEST		- check the compiled things (make check)
    PRE-INSTALL		- before to install (make uninstall)
    INSTALL		- install the software (make install)
    POST-INSTALL	- after install (ldconfig)
this is special:
    CHECKSUM		- contains MD5 checksums of all the sources and patches
    
This is the list of all the files you can find into the /install/scripts
subdirectory of a package:
    PRE-INSTALL
		- run before 'install'
    INSTALL
		- run at 'install'
    POST-INSTALL
	- run after 'install' (scheduled)
    X-POST-INSTALL

	- run after 'install' (scheduled) but when start X11
    PRE-REMOVE
		- run before 'remove'
    REMOVE
		- run at 'remove'
    POST-REMOVE
		- run after 'remove' (scheduled)
    CLEANUP
		- run on 'cleanup', used to remove config files
    


3. Package's Reference
======================

This is the list of all the vars used into /install/INFO files.

Those are the main vars:
    SONAME		- name
    VERSION		- version
    CATEGORY		- category
    DISKNAME		- on which CD is the package
    ARCH		- minimum required arch of the package (use 'ANY' for docs)
    OPTIM		- arch for wich the package is optimized
    SUMMARY		- one line descriotion of the package's content
    DISKUSAGE
		- total bytes used by the package    
    STATUS	
	- status of the package (UNSTABLE, STABLE, ROCKSOLID)
    AUTHOR		- Name and e-mail of the author
    COPYRIGHT		- GPL, BSD, etc.
    MANTAINER		- E-mail of the mantainer
    HOMEPAGE		- Homepage of the software
    

those are info added by package-create:
    OSNAME		- Usually Linux
    OSVERSION		- Kernel version
    DISTRIBUTION	- Distribution name and version
    BUILDHOST		- Full name of the machine used to build the .bpp
    BUILDTIME		- Datetime of the build
    BUILDNUMBER		- (2.0.1) Number of time this package has been built
    BPPVERSION		- Version of the .bpp system
    

those are very important vars:
    CONFLICT		- list of the packages that conflicts with this one
			  and that should be removed when installing this one
    DISKUSAGES		- diskusages for each directory
    REQUEST		- list of all the dependencies

those are vars used to build from the source:
    SOURCEFILES		- list of the source to be used
    SOURCEMIRRORS	- list of sites where to get those sources
    SOURCEDIR		- subdirectory where to run all the /install/compile
			  scripts
    PATCHFILES		- list of addittional patch to download
    PATCHMIRRORS	- list of sites where to get those patches
    SOURCEREQUEST	- required packages to build this one


EOF