
Purpose
-------

FRENUM renames files which fit a given filespec according to a new
name made from a string and a number. The file extension is not
changed.

Existing filenames are previously sorted in RAM. The maximum number of
files which can be renamed in a single command is 4000.

The string is optional. The numbers will be made from a given minimum
amount of digits and a starting point for number generation.

Use: FRENUM filemask serial-ID a b
        filemask: file spec of files to be renumbered
        serial-ID: a string for identification (for none, enter *)
        a: minimum number of digits to append to SerialID
        b: starting number for 'aa'

Example:

        FRENUM *.jpg mypeg- 0 2

will rename all files matching *.jpg in the current directory to names
starting with mypeg-00.jpg up to as many files there are.

If there are more files than what is allowed by the minimum number of
digits, the number of digits is increased without asking.

Should that happen in the above example, file number 101, which would
be renamed to mypeg-100.jpg, will have the last digit truncated and a
renaming to mypeg-10.jpg will be attempted, which generates an error,
for that file already exists.

The program stops if more than 10 errors occur.

The string is optional but must be replaced by a '*'. Example:

        FRENUM *.jpg * 1762 6

renames all *.jpg files without using a string, starting at 1762
(001762.jpg) with a minimum of 6 digits.

Written with Turbo C 2/3 for MS-DOS 6.2. Compiled for the 8086.

*** I wrote and tested this program for my personal use. Feel free to
use it if you find it ok yourself. I will appreciate bug reports, but
due to lack of time it is unlikely that I might be able to do anything
about it until I get annoyed by that particular bug. Sorry about that.

Installation: Throw it somewhere in the path.

Status: Freeware, unsupported.

Distribution: free.

Contacting the author: jcm@mail.EUnet.pt

