home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Amiga Elysian Archive
/
AmigaElysianArchive.iso
/
newc_dev
/
ppdo.lha
/
PPDO
/
PPDO.doc
< prev
next >
Wrap
Text File
|
1992-11-21
|
7KB
|
196 lines
PPDO (PowerPackerDataOnly) 1.21
*******************************
Documentation by Thies Wellpott
(excuse my bad English, please)
1. Copyright
************
PPDO is FreeWare (c) 1992 Thies Wellpott. You may copy it for free provided
that
- no profit is made with it
- PPDO is not included with commercial software without written
agreement from the owner of the copyright
- PPDO is distributed with this documentation file, "PPDO.doc"
and both files are unmodified
The source code is for personal use only. It need not to be distributed
along with the program, but if it is the whole source code must be kept
with it (currently only "PPDO.c").
1.1. Warrenty
*************
YOU USE THIS PROGRAM COMPLETELY ON YOUR OWN RISK! If you destroy any file,
your computer, your car or even the whole universe or any part of it while
using it, do not blame me, it is not my fault!
1.2. Note to Nico François
**************************
This program should be no competition to your PowerPacker. There is no GUI,
no ARexx-port, no ability to crunch executables, etc. I use this tool to
crunch doc-files and song modules, and I thought it is nice enough to be
used by other Amiga users, so I spread it around. I think this is ok!?
2. Introduction
***************
The PowerPacker by Nico François is a nice tool, but the non-commercial
version (2.3b) is a bit slow. Because the PowerPacker file format is a kind
of pseudo-standard which is supported by many programs (text viewer, module
player, etc.) and is easily accessable via the powerpacker.library; it is
worth being used. Since version 35 the powerpacker.library supports
crunching using speedup buffers, so crunching is much faster than
PowerPacker 2.3b`s. For these reasons I wrote this little tool which
crunches files using the powerpacker.library.
PPDO requires the powerpacker.library V35+ (c) Nico François.
3. Usage
********
PPDO is runnable only from the CLI/Shell. It runs with Kickstart 1.2/1.3
and OS 2.0. If you start PPDO with no or wrong arguments or with a "?" as
the first argument you will get a usage info.
PPDO [FAST|MEDIOCRE|GOOD|VERYGOOD|BEST] [SMALL|MEDIUM|LARGE]
[COLOR0|COLOR1|POINTER|SCROLL|NONE] [CRUNCH|RECRUNCH|DECRUNCH]
[SUFFIX] [DESTDIR dir] [MINSIZE size] [PRI pri] File/M
FAST .. BEST specifies the crunch speed/efficiency; FAST is the fastest
but least efficient mode, BEST the slowest but most efficient mode.
SMALL .. LARGE specifies the size of the speedup buffer. The following
table shows the needed memory:
FAST MEDIOCRE - VERYGOOD BEST
SMALL 3K somewhere 33K
MEDIUM 5K inbetween 65K
LARGE 196K 256K
I recommend that you use LARGE because of the great speed improvement.
COLOR0 .. NONE specifies the flash type during decrunching. COLOR0 is the
background color, COLOR1 the first color (black with OS 2.0), POINTER
flashes the mouse pointer, SCROLL kills your monitor :^) (try it and you
will see), NONE will flash nothing.
CRUNCH If you pass this argument to PPDO it will crunch uncrunched files
and skip files already crunched with PPDO (or PowerPacker).
RECRUNCH crunches uncrunched files and recrunches (that means decrunching
and then crunching with the specified parameters (FAST, BEST, etc.))
crunched files.
DECRUNCH decrunches crunched files and skips uncrunched files.
SUFFIX adds ".pp" suffix to uncrunched files if there is not already this
suffix, removes ".pp" suffix from crunched files if it is there; examples
follow later.
DESTDIR dir this option will save the files to dir instead of their
original directory; examples follow later.
MINSIZE size a file must at least have size bytes to be crunched, a file
with a few hundred bytes for example is not worth being crunched.
PRI pri sets the task priority to pri during program execution (defaults
to -1).
File one or more filenames. Patterns are not allowed (yet). You may use
patterns with help of SPat: SPat PPDO #?/#?.doc will crunch all files
ending with .doc in all subdirectories of the current directory.
The default is: BEST LARGE POINTER CRUNCH MINSIZE 0 PRI -1.
Some examples:
PPDO abc.doc textfile
crunches the files abc.doc and textfile with the default options and saves
them to abc.doc and textfile
PPDO util/prg.man FAST SUFFIX
crunches the file util/prg.man with the fastest mode and saves it to
util/prg.man.pp
SPat PPDO #?/#?.(doc|dok|man) RECRUNCH MINSIZE 2000
recrunches all files ending with ".doc", ".dok" or ".man" which have at
least 2000 bytes.
In the following tables name is the original name of the file and
in the next columns you find the name the file will be saved to.
CRUNCH
name | no SUFFIX SUFFIX
---------------------+-----------------------------------------
abc | abc abc.pp
abc.pp | abc.pp abc.pp
dir/abc | dir/abc dir/abc.pp
dev:dir1/dir2/abc.pp | dev:dir1/dir2/abc.pp dev:dir1/dir2/abc.pp
DECRUNCH
name | no SUFFIX SUFFIX
----------+--------------------
abc | abc abc
abc.pp | abc.pp abc
abc.pp.pp | abc.pp.pp abc.pp
DESTDIR
name | DESTDIR ram: DESTDIR dev:dir DESTDIR ""
------------------+---------------------------------------------
abc | ram:abc dev:dir/abc abc
dir/abc | ram:abc dev:dir/abc abc
dev:abc | ram:abc dev:dir/abc abc
dev:dir1/dir2/abc | ram:abc dev:dir/abc abc
Ctrl-C / Ctrl-D handling:
During crunching the program is interruptable via Ctrl-C, PPDO will quit
immediately. If you press Ctrl-D the current crunch process will be
aborted, the next file will be loaded and processed (if their is any).
4. History
**********
V0.90 4.8.92
first code, first working version
V1.00 4.8.92
de-/recrunching added
V1.10 4.8.92
MINSIZE, PRI option added; Ctrl-C/D handling changed; minor fixes
V1.20 5.9.92
DESTDIR option added; text output changed a bit
V1.21 6.9.92
DESTDIR "" possible
Send bug reports, hints, ideas and 68040-cards :-) to:
Thies Wellpott
Moorhauser Weg 14
2948 Schortens 1
Germany
(no e-mail, sorry)