********************************************************
                               CExt V1.3

                           By Chris De Maeyer
        Sources (C)1994-98 Visionaty Software - All rights reserved

                Released as MAILWARE on 16 October 1994
              Updated version released on 1 February 1997
              Last final version  released on 22 May 1998
         ********************************************************         


 CExt is <MAILWare> for the Amiga.  No fee is requested to use it, nor
 anyone can ask anything for it (except for the media). Bare in mind
 that you may use & distribute these files as long as all files remain
 included and unchanged.  
 If you keep on using this program, you should reward me by sending
 mail (postcard/letter) to the address specified below.
 
 Disclaimer
 ==========
 I can't be held responsible for any damage inflicted on your computer
 system when using the files mentioned herein. However, this tool has
 been tested by myself and others on correct behaviour.
 It is your duty as user of this tool to report any strange occurences
 which evolve from using it.

 Using it !
 ==========
 CExt is a small Shell-only program and  its  work  should be clear:
 it renames files in the current directory, either it strips the
 ext. part, or it replaces the extension with a new one.

 It features an extention renumber function ! This for all anim
 artists out there which need a quick way to renumber their frames. You
 can set the basename for all frame files (default it will take the first
 filename [without ext] as its basename). Then, you can give the start
 frame number (defaults to 0) and an increment (defaults to 1).
 
 I know there might be other proggies around, with some more options.
 But, this program evolved from a sudden need for this utility. At the
 time I had nothing else to do it with. So, why shouldn't I just write
 one myself.
 Anyway, if you want more options... contact me !

 As said above, Cext is a Shell-only program, so do not try to use it
 from  Workbench.   It uses the standard parser of AmigaDOS.  Executing
 Cext with '??' as a parameter will give the following argument list :

    USAGE: cext FILE/A,
                EXT=EXTENTION/K,
                RENUM/S,BASE=BASENAME/K,SFR=STARTFRAME/K/N,
                        INC=INCREMENT/K/N,
                QUIET/S


 Now, a little explanation about the arguments:

    FILE            - here you MUST supply the file or pattern.

    EXT=<newext>    - invokes the program in change mode. Meaning: the
                      extensions will be replaces by a new one.

    RENUM           - will process the files in ext. numbering mode.
    
    BASE=<basename> - to supply a new basename for all frames (optional).
                      Defaults to first filename.
                      
    SFR=<number>    - start numbering from <number>. Defaults to 0.
    
    INC=<number>    - increment frames with <number>. Defaults to 1.
                      
    QUIET           - no output (for scripts).           
     
 It is obvious that EXT (change) mode can NOT be mixed with RENUM mode.
 If neither of these modes is chosen the ext. DELETE mode is selected.
 
 
 PPC Usage
 =========
 The program has been build using the SAS/C PPC compiler, to load either
 have the PPCLoadseg patch installed or run the module using the following
 command line:
 
        runelf cext.elf <your options>
        
        
 Examples
 ========       
 An example of how to use Cext is given below:
    
 DELETING EXTENTIONS

   6>dir
   cext.c         cext.doc
   test.h         test.o
   test.lnk       test.c

   6>cext #?.o
   [test.o] renamed to [test]

   6>dir
   cext.c         cext.doc
   test.h         test
   test.lnk       test.c

 REPLACING EXTENTIONS

   6>dir
   cext.c         cext.doc
   test.h         test.o
   test.lnk       test.c

   6>cext #?.o ext=object
   [test.o] renamed to [test.object]

   6>dir
   cext.c         cext.doc
   test.h         test.object
   test.lnk       test.c

 FRAME RENUMBERING

 (Note: the program will sort the files in ASCII order before processing)
  
   6>dir
   xyz.025        ytr.67
   treg.0001      gfr.89
 
   6>cext #? renum base=myframe quiet 
 
   6>dir
   myframe.0000   myframe.0001
   myframe.0002   myframe.0003
 
   6>cext myframe.#? renum sfr=100 inc=2 quiet
   
   6>dir
   myframe.0100   myframe.0102
   myframe.0104   myframe.0106
   
   
 Remark: if a file already exists with the same name. Cext will
         report this to you with following message: 'Couldn't rename
         file'.


 About Versions & Bugfixes
 =========================
 You can determine your current version by typing 'version cext' in
 the Shell window.

 1.3    - increased buffer sizes
        - included PPC version
        - some small changes
 1.2    - all valid files are buffered and sorted first
        - added ext. renumbering (options involved BASE, SFR, INC).
 1.1    - standard AmigaDOS options
        - added QUIET option.
 0.1    - enhancement: added -c option (UNIX option parsing).
 0.0    - initial version (test) delete only.


 The Author
 ==========
 If you want to send me bug-reports or comments:
 Since this is mailware, send to following address:

                           VISIONARY SOFTWARE
                           tav. Chris De Maeyer
                           Norbertijnenstraat 4
                           B-2040   ANTWERPEN
                           BELGIUM
                                
                           Email: cdemaeyer1@mmm.com
                                  ceppe@geocities.com
                           (only questions, bug reports...)

        Homepages: //www.geocities.com/siliconvalley/peaks/8452
                   //www.crosswinds.com/antwerp/~visionary
                   
 Other programs
 ==============
 FBack/FMirror
 LCount
 Mylists