
DESCRIPTION:

	Pak is a very simple archiving program to store and extract 
	files from a multi-volume archive. The volume size can be set
	to any value (multiple of 1024 bytes) from the command line.
	It is useful to transfer files from different platforms with 
	floppy-disks.

USAGE:  
	pak [command] <option> archive name <input files>

	Command:

		c, create a new archive 
        	e, extract all files from a volume
		l, list the contents of an archive

	Options:

		-s [NUM], set the volume size to 1024*NUM bytes, the
			  default is 1422 blocks (one floppy disk size)
		-a,       extract (or list) all files from the archive 
			  (all volumes)

EXAMPLES:
   
     1.	Split the files backup1.tgz and backup2.tgz, in the current 
	directory, in a series of volumes (tars.pak, tars.p01, 
	tars.p02, ...) each of 1024 * 1422 = 1456128 bytes.
		
		pak c tars.pak backup1.tgz backup2.tgz 	

     2.	Create an archive named `programs' with all .c files in the 
	current directory. The size is 700*1024 bytes.
	** the wildcard expansion is done by the shell, therefore is 
	not available in DOS environment **
	
		pak c -s 700 programs *.c

     3.	Extract all files from all `disk' volumes (disk.pak, disk.p01,
	disk.p02, ...).

		pak e -a disk

     4.	Extract all files in volume disk.p02.
		
		pak e disk.p02	

     5.	List all files in `disk' archive.	

		pak l -a disk

NOTES:
	You can ONLY select files in current directory (you can NOT store
	full path names).

INSTALLATION:

	Edit the Makefile and check the define CC. Set the INVERT_BYTES
	option on machines with a different byte-order to provide for 
	compatibility of archives between different machine architectures.
	Run `make' to build the program.

	Pak has been successfully compiled in the following environments:

	- Linux 2.0.32, gcc version 2.7.2.3
	- Windows95, borland c/c++ 5.3
	- AIX 4, (** USE INVERT_BYTES **) 

COPYRIGHT NOTICE:

	Copyright (c) 1998, Emanuele Assenza.  (eassenza@lep.polito.it)

	This program is free software; you can redistribute it and/or 
	modify it under the terms of the GNU General Public License as 
	published by the Free Software Foundation.

	This program is distributed in the hope that it will be useful,
	but WITHOUT ANY WARRANTY; without even the implied warranty of
	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
	GNU General Public License for more details.                      

	You should have received a copy of the GNU General Public License
	along with this program; if not, write to the Free Software
	Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.        

