Tree Rename Version 2.00
Written by Alex Savvides, September 91
Alex says "This program may be freely distributed".
ABOUT TREE RENAME:
Tree Rename is a versatile utility used for renaming files from one
directory to another saving several individual *RENAME commands, thus
making the job very much easier, not to mention faster.
Useless information: It is called this after the MS-DOS 'TREE' command
(tree meaning all, or parts thereof).
The program was written on a BBC Micro B and should work on any other
BBC B without any trouble, though I suggest you page out any dodgy
ROMS prior to use, to ensure maximum compatibility. There is no
guarantee that the program works on a BBC Master, but if it does then
all the better.
The first version which appeared on Issue 14 of the PD Disks only
renamed one directory to another; Version 2 of the program does a
little more:
Selective Rename - Select the files you wish to rename to a new
directory
Global Rename - Renames ALL files to a new directory
Specific Rename - Rename all files in one directory to a new
directory
These three types of rename allow total re-organisation of your disks,
making the task of renaming certain files much faster, and with
minimum of fuss. The program is NON-DESTRUCTIVE. i.e it does not
access the sectors of the disk being used, so no major damage can be
done.
RUNNING THE PROGRAM
When the program is run, it defaults to drive 0, and performs a *CAT
which is hidden from screen display which reads the contents of
&0E00-&F000 in memory for the disk catalogue which is read into an
array. This may take a while, especially if the disk catalogue is
full (i.e 31 files). The work-screen will then appear (so-called, as
everything is done on this screen), along with the files on your disk;
all in CAPITAL letters for the purpose of 'file-exist' checking during
renaming. The DFS does not differentiate between upper and lower case
in filenames so there is nothing to worry about - the array contains
the files in capital letters, the filenames on disk have not been
changed!
The top of the screen shows what each file colour represents ...
Yellow : Any files you 'tag' will be shown in yellow on the screen
White : These files have not been tagged
Cyan : These files have just been renamed and cannot be tagged again
until 'C' (clear) has been pressed
Red : If, for any reason several files are of the same name but
appear in a different directory, (i.e A.prog, B.prog, C.prog)
then they will be made unavailable for renaming thus
preventing nasty 'exist' messages during renaming. If you
wish to rename them, then please do so from BASIC using
*RENAME
The commands are shown at the bottom of the screen ...
T (Tag all) : will tag ALL files ready for renaming. They will then
appear yellow as long as they do not match the rename
directory (if specified)
U (Untag all) : Any files that have been tagged will be untagged. They
will then appear white
D (Drive) : If you wish to change drives, press D, and enter the
new drive
S (Source) : Used to specify the source directory. Any files in
the specified directory will automatically be tagged
R (Rename) : Used to specify the directory to which tagged files
are to be renamed.
G (Go) : This will begin the rename. If anything is wrong, you
will be told - keep your eye on the blue bar for
messages
C (Clear) : Used after renaming has finished. All files are
tagged CYAN when renamed. This is in case you do not
wish to rename them again. It helps you keep track of
what has been renamed
Q (Quit) : A soft-reset is forced (Break is pressed).
* (Os command): Useful for any os commands you may wish to use.
Any of the above commands can be issued when prompted for.
SELECTING FILES
Now you know what the commands are, you now need to know how to select
the files you wish to rename, these are explained as the three ways
of renaming ...
1: Selective rename
This is done by using the cursor keys to move around the files, and
pressing RETURN to select (tag) a file which will then appear in
yellow to indicate it has been selected. The 'In use' count at the
bottom of the screen will then increment by one. You can continue to
tag as many WHITE files as you wish, or press T to tag all files at
once. When you have finished, you must then select the rename
directory (i.e the directory to which the files are to be renamed).
Press R and enter the rename directory. When this has been done, you
can start the rename by pressing G (Go).
Note: Any files in a directory matching the rename directory will be
ignored to save time when renaming.
2: Specific rename
Use this method if you want to rename all the files in one directory
to another. First, you need to specify the source directory from
which all files will be renamed, so press S, and enter the directory
you wish to use. Any files under this directory in the display will
be automatically tagged for you. Next, you must specify to which
directory the tagged files should be renamed. Press R and enter the
rename (destination) directory. Finally, G to start the rename.
3: Global rename
This method will rename ALL files regardless of their directory to a
new directory. First, press T to tag all files, the press R and
specify the rename directory. Finally, G to commence the rename.
During renaming, the files that have been successfully renamed will
appear in CYAN as their new name. Any existing files will be
ignored, then untagged and a message will appear to tell you so.
Press TAB to termimate renaming at any time. When renaming is
complete, you can press C to untag all files that appear in CYAN if
you wish.
I hope that these notes were easy to follow and that this utility is
of use to you.
Alex Savvides, September 1991.