DCFR v0.0.4

                             January 2nd, 1995

                             by Vincent Mallet


þ Disclaimer: see end of document.

þ First of all:

DCFR is FREEWARE, not public domain. You might use it, copy it, distribute
it, give it away to your friends, but you MAY NOT SELL IT nor disassemble it.
(DCFR may be included on a CD ROM)

If you find DCFR easy and usefull, you may want to send a little registration
of $10. This will help me in developping my BBS, but this is not required.
Send you checks to :-):         Vincent Mallet
                                1457 Chemin de St Etienne
                                06570 St Paul
                                FRANCE

þ What is DCFR?

As PKunZIP on ZIP files, DCFR lets you manipulate image files created with
DCF. You can view the contents of an image, or extracts files from it.


þ How to do it?

DCFR is _very_ easy to use.
Here's the DCFR usage (type DCFR at dos prompt to get it):

 ||   usage: DCFR [options] <filename> [filespec] [destpath] [options]
 ||
 ||   where <filename> is the DCF image file
 ||         [filespec]: optional: filespec with wildcard (ex: [0-9]*c.asm)
 ||   options: -e              extract files
 ||            -o              overwrite existing files
 ||            -a              restore attributes (Hidden System RO Archive)
 ||            -d              create directories when needed
 ||            -v              list image file (default)
 ||            -x<filespec>    exclude files (wildcards ok)

Some examples:

Suppose you've created an image file of a 1.44 diskette using DCF, and
this file is named FOO.DCF.

To view the contents of foo, just do:
        DCFR foo.DCF

You may use some strange filespec:
        DCFR foo.DCF [a-e1-5]*g*.*[8-9]

you want to extract all files, in the current directory:
        DCFR -e foo.dcf

extract all files, overwriting existing ones, with original attributes:
        DCFR -o foo.dcf -e -a

extract all ASM & C files, create subdirs if needed:
        DCFR -e -d foo.dcf *.asm *.c
    or  DCFR foo.dcf -ed *.asm *.c

extract all PAS & ASM files, create subdirs, overwrite existing,
exclude FOO*.* and FAA*.*
        DCFR -e -o -d -xfoo*.* -xfaa*.* foo.dcf *.asm *.pas
    or  DCFR foo.dcf -eodxfoo*.* *.asm *.pas -xfaa*.*
    or  DCFR -o foo.dcf -e *.asm *.pas -d -xfoo*.* -xfaa*.*

extract all files beginning with (a,b,c or d), to f:\toto\titi:
        DCFR -e foo.dcf [a-d]*.* f:\toto\titi
    or  DCFR -e foo.Dcf f:\toto\titi [a-d]*.*

Type DCFR if you want to get help.


þ Contacting the author:

If you want to contact me, you may:
 - send an e-mail:  mallet@aurora.unice.fr (until july, 1995)
        (or maybe:  vincent.mallet@f7.n323.z2.fidonet.org)

 - write through Fidonet:  Vincent Mallet, 2:323/7

 - call my bbs!  ZYLLIUS BBS (Nice, France)
                             +33 9332 0505 16.8k
                             +33 9332 0720 28.8k

 - send me a postcard (this is always appreciated!). See my address at the
   beginning of this little doc.


þ Disclaimer

This text is from the DCF v4.9 documentation by Chang Ping Lee , and applies
to DCFR.

                        DISCLAIMER  OF WARRANTY


        THIS SOFTWARE AND MANUAL ARE SUPPLIED "AS IS". THE AUTHOR HEREBY
        DISCLAIMS ALL WARRANTIES RELATING TO THIS SOFTWARE AND ITS
        DOCUMENTATION FILE, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED
        TO DAMAGE TO HARDWARE, SOFTWARE AND/OR DATA FROM USE OF THIS
        PRODUCT. IN NO EVENT WILL THE AUTHOR OF THIS SOFTWARE BE LIABLE
        TO YOU OR ANY OTHER PARTY FOR ANY DAMAGES. YOUR USE OF THIS
        SOFTWARE INDICATES THAT YOU HAVE READ AND AGREE TO THESE AND
        OTHER TERMS INCLUDED IN THIS DOCUMENTATION FILE.


þ Last word

[CREDITS: The wildcard matching is done with:
   REGEX Globber (Wild Card Matching) by J. Kercheval. Public Domain. ]

(Well, this is really a poor doc.. I don't think I'll ever write something
looking like a doc...)