===========================================================================
=    Welcome to this version of the Small File Handler program (v1.01)    =
===========================================================================
This program was written because we could not find any program that allowed
us to handle files in the way this program will.

We will explain the functions of the program and the way the program will
react in several situations.

All functions can be applied to all files in 1 folder (directory), or
a selection of these files.
The same files stay selected after a function end, unless an error has
occured (See "How does the program react" for more info on this)

If you have any comments on this program please feel free to send an e-mail
to one (or both) of the following adresses:
  jorres@xs4all.nl (Remco Slegtenhorst)
  john.rijpkema@xs4all.nl (John Rijpkema)

See for new versions: http://come.to/JoRReS

At the end of this document you'll find the changes and bugfixes that 
were made after this program was released.

With kind regards,
JoRReS Softworks.

+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

Functions of the Small File Handler program:
============================================

00. Selecting file(s) can be done by clicking on them (you can use the SHIFT or
    CTRL-key to select multiple files) or by pressing the Select Files button.
    A pop-up window will appear, an ENTER straight away will Select all files.
    You can also select only the files with a string, you specify, in the name,
    by pressing the Select using string button
    And as a counterpart, you can select all files, but NOT the ones with the
    specified string in the name, by pressing the Select except string butten.

01. Change extention of file(s).
    The extensions of the files selected are replaced by the given extension
    (the last 5 used extentions will remain present at all times)

02. Find and replace text in filename(s).
    The selected files are searched for the given find string (can be done
    case sensitive) which is than replaced by the replace text.
    (the last 6 used find and replace texts and case setting will remain
    present at all times)

03. Check lenght of filename(s).
    Check the selected files for Joliet burning (maximum filenamelenght is
    64 chars).
    When this function finds a file that is to long it will present a screen
    where you have the choice how to handle this (and the next) files that
    are to long. Choices are:
    a) Autorename All 
       This and all following files will be renamed automatically
    b) Autorename
       This file will be renamed to the newname given in the box
    c) Skip
       No action on this file
    d) Skip All
       No action on this and all following files
    e) Manual Rename
       You can change the filename the way you want it.

    With the exception of option a) and d) a different choice can be made
    for each following filename that is to long.

04. Change case of filename(s).
    Filenames are put in lowercase, UPPERCASE or Title Case.
    (last used case will remain selected)

05. Change case of directory(s).
    Direcory-name(s) are put in lowercase, UPPERCASE or Title Case.
   
06. Rename file(s).
    This function can be called through the button or by double clicking the
    file in the selection window (one file at a time).
    Selected files can be renamed one by one, with optional direct
    checking for Joliet length when changing the filename.

07. Rename file(s) from .TXT file 
    With this function it's possible to rename files according the textlines in 
    a TXT-file.
    Select a TXT-file, select the files you want to rename and select the same
    amout of lines in the TXT-file. After pressing the NEXT button you can 
    shuffle the files and/or TXT-lines so that the correct file will be renamed
    with the TXT-line you want.
    Before pressing the rename-button, specify if the file should keep there 
    original extention(default) or the extention from the TXT-line.
        
08. Remove and/or move parts of filename(s) 
    With this option you can shuffle and/or remove parts of filenames in by
    specifying a matrix.

09. Copy file(s) to... 
    This function will let you specify to whith directory you want to copy the
    files that you have selected. Duplicate files will be moved depending on
    the setting in preference window.

10. Move file(s) to... 
    This function will let you specify to whith directory you want to move the
    files that you have selected. Duplicate files will be moved depending on
    the setting in preference window.

11. Delete file(s)
    Select one or more files and press the delete button.

12. Undo Last action 
    This funcion will only undo your last action.
    If you deleted a file or added a MP3-ID, you cannot undo it !!!
        
13. Edit MP3 ID-tag info.

14. Add MP3 ID-tag info to MP3 file(s) 
    (This is done when ever needed)

15. Change file-extention from file(s) with MP3 ID-tag to .mp3 
    The programm will look through te selected files and see if there is a
    MP3 ID-tag present. If so the file extention is changed to .mp3.
    Files without a TAG remain unchanged or get the extentions specified in 
    the preference window.

16. Change MP3 ID-tag from Filename (specify your own layout) 
    The filename is split up into parts by using your specified matrix and 
    these pieces are put in the MP3 ID-tag fields.

17. Change Filename from MP3 ID-tag (specify your own layout) 
    The filename is build up by the given matrix from the info from the MP3
    ID-tag.
  
18. Specify Preferences 
    You can specify several preferences to make the programm react more to
    you liking.

+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++


How does the program react (Situation: function(s))
===================================================

Duplicate filename(s): 1,2
--------------------------
When a duplicate filename occurs as result of function 1 and 2, the next
filename(s) will be automatically renamed with (x) directly after the
filename. (x = a number starting at 1)
This will be applied to all files that don't exceed the maximum file lenght
of 246 chars. Filesnames that would become longer than this will loose
chars of the end of the filename so that the (x) can be added without
crossing the maximum lenght.
A messagebox informs you when this has happend.

  example: files "test.txt" and "test.viv" exist and are given the ".mp3"
           extension. "test.txt" will be renamed to "test.mp3", "test.viv"
           to test(1).mp3


Duplicate filename(s): 3a
-------------------------
The same way as described above only the maximum lenght is set to 64 chars.

Duplicate filename: 3d, 6
-------------------------
A message box informs you the new filename specified already exists so you
change the filename and try again.

To long filename(s): 1,2
------------------------
When a filename will become larger than 246 chars as result of this
function, no action will be taken. The files remain selected after the
function ends.
A messagebox informs you this has occured.
Only these files are selected after the function ends.

To long filename: 6
-------------------
A messagebox will appear that informs you of this situation so you can
change the filename.


File cannot be renamed because an error occured: all
----------------------------------------------------
The file is unselected and a messagebox informs you of the error found.
If applicable, the remaining files are processed normally.

+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++

Version Changes/Bugfixes/Additions
------- -------------------------------------------------------------------
Version A/B/C Modified/added 
1.01    A     Remove spaces before empty tags (preference setting)
        B     Run time error 5, when filling MP3 from filename and the 
              specification before or after * could not be found. 
        B     TitleCase change: if the last character in the extention of
              the filename is one of the preferenced characters to be
              followed by an Uppercase char. the program will crash
              (e.g. "Test This.tx ") 
        C     Typing error in Filename --> MP3 message box
1.00    A     Directory case change.
0.99h   C     Find field gets focus after Replace.
        C     Progress bar only counts selected files not all files in
              directory.
        C     Undo for last action. 
        B     No question if no files are selected when pressing the delete
              files button 
        B     Renaming file in root dir not possible because of error 
        A     Routines that handle file-rename from a text file. 
        A     MP3 ID Edit 
        A     MP3 ID change with filename 
        A     Rename File with MP3 ID 
        A     Preferences 
        A     Copy/Move files 
        A     Rename Files with MP3-TAG to .mp3 
        A     Rename Files from matrix 
        B     Reading from not ready drive no longer crashes program 
0.99g   C     Rename button default. 
        B     Renaming file but only change case not resulted in "file 
              already exists".
        A     Extra Renamecheck added. 
        B     Find and Replace text only case change produced duplicate
              filenames (1) 
        B     Run time error when only one file was present in a directory.
0.99f         First version ever released to the public 

+++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++


End of page