LongNameChecker 1.0
_________________________


The main purpose of this utility is to check the longfilename of a file.
A check is performed to see if the longfilename is :

       1. Decidedly different from the real name and therfore possibly incorrect
       2. A duplicate of the longfilename exists in the same directory

Entering the path of a directory to be examined will result in that directory
being scanned and displayed. From the Options pull down menu it is possible to
select if only the directory is displayed or also all subdirectory

After the required directory has been selected a filter can be applied using
one of the 4 buttons:

       All             - display all files
       Different       - display only files that have a longname that
                         does not match the real name
       Longnames       - display only files with a longfilename
       Selected        - display only files that have been selected


If a file or multiple files are selected, then it is possible using the button

       "Change Selected"

to replace the longfilename with the real name and if required change it
back again using the button

       "Restore Selected"


Alternatively a specific file can be selected and using the RHMB a context menu
is displayed with trhe following options:

       Show difference  - Show both the real name and longmname indicating the
                          differencies.
       Edit longname    - Change the longfilename to a different value. If the
                          value entered is completely blank then the longname
                          will be deleted!
       Restore longname - Restore the longname back to the name it previously
                          had.

In the pull down menu "Options" it is possible to select how the difference
between the real name and longfilename is made, by ignoring the escape
character '!' and also by ignoring case differencies.

In the pull down menu "File" it is possible browse the file system and select
a drive or directory to be examined, Refresh the data displayed, or to exit
the program.

Using the search field in the menu bar, a search can be done to find a file or
directory matching the name entered. As soon as a character is entered the
search will begin displaying the first item found form the current position.
Using one of the three buttons allows you to either search for the next or
previous item or for a directory or file matching the name entered. A beep
is given if there is no match of the name.

A duplicate longfilename is always displayed in the colour red!


Background information:

A longfilename is an extended attribute .LONGNAME that contains the files
longfilename. This is displayed in the GUI either in the file listing in
"Details View" as a file's "Title" (2nd column) or if a file's properties
notebook tab page under the entry field "Icon" again as the file's "Title".

HOWEVER THE PRESENCE OF A NAME IN THE TITLE FIELD DOES NOT IMPLY THAT THERE
IS A .LONGNAME EA, AS IN THE ABSENCE OF THIS EA THE REAL NAME IS DISPLAYED!



This name can easily be modified using the GUI by changing the title name.
It does however automatically change the real name as well!
The real name can only be change by itself from the command line using the
rename command "REN".

The real name of a file (as normally diplayed from the command line using the
"DIR" command) is displayed both in the Details view in the 4th coloumn and
also in the properties notbook page as a file and also so named when examining
a file's properties.


This is software which has had limited testing so please use with care.
The memory usage has not been optimized and the error checking is limited.
You use it at your own risk!

If you have any comments/suggestions please feel free to email me.

Keith Merrington
k.merington@gmail.com
