----------------------------------------------------------------------------
Any fans of Italian Dance (Italo Disco) out there? I am a true freak and
would like to hear from you! Maybe to swap information and records... How
about the availability of 2nd hand records in your neighbourhood? Please,
contact me if you share my addiction to Italo Disco...(Address near EOF) 
----------------------------------------------------------------------------
!Help file for !Renamer version 2.00 (3 January 1993)
 
Written by Simon Baas


Introduction
============

!Renamer is a useful application for people who occasionally interact with
the SM-DOS world through floppies, thereby receiving software with lots of
uppercase filenames. Personally, I rather like the naming convention of first
letter and letters at wordboundaries uppercase and the rest lowercase as in
!RunImage, !SpriteFile etc. (Capitalised I think it is called).

(Interactive Help is implemented, so use it!)

Options
=======

The following options are available:

- Recursive        : Rename contents of directories and applications as well.

- Confirm          : Allow user to confirm each rename operation.

- Force            : If an object is locked, rename it anyway. Access is
                     preserved afterwards.

- Use wordfile     : If the filename contains words found in the 'WordFile'
                     (in the !Renamer application directory) then the word
                     from the wordfile is substituted in the filename. This
                     wordfile may be edited by the user. Note however that it
                     is loaded only when loading the !Renamer application so
                     when modifying the WordFile you should quit and reload
                     the !Renamer application for the new WordFile to take
                     effect. Also stick to the current format of the file,
                     that is: One word per line with *no* spaces or anything
                     behind it. Currently the contents of the WordFile is
                     only checked for words longer than 10 characters.
                     The word on line one has the highest priority.
                     The words in the WordFile have higher priority than the
                     First Capital/Uppercase/Lowercase options, discussed
                     next.
                     Note that the order of the words is very important. If
                     word A is a real prefix of word B then you should word
                     A below word B or else word B will never be found.

- First Capital    : The whole filename is converted to lowercase except for
                     the first letter, which is converted to uppercase. Note
                     that if a filename start with a '!' this is skipped and
                     the next letter is converted to capital.

- Uppercase        : The whole filename is converted to uppercase.

- Lowercase        : The whole filename is converted to lowercase.

Note: Of the last three options only one may be selected at the time. It is
      also possible to select none of the above three options: Click ADJUST
      on the currently selected one.

- Delete after     : The last occurence of the character displayed in the icon
                     after the 'Delete after' radio icon plus all trailing
                     characters will be deleted if 'Delete after' is on. Its
                     use is intended to delete DOS names extensions.
                     Note that all characters are allowed, including dots and
                     dollarsigns and such.

- Minimumlength    : Leafnames shorter than this value will not be renamed.
                     Intended to skip c, h and o directories. Note that to
                     rename all files, this value must be set to 1 of course.


Renaming
========

Drop a file selection unto the icon or options window to start a rename job.
A window (the 'renaming' window) pops up showing the name of the object
being currently processed.
If 'Confirm' is on, you will be asked for confirmation by means of 'Yes' and
'No' icons.

The possible choices in the Renaming window are:

- Abort : Abort current rename job altogether.
- No    : Do not rename the current object, but continue with the next.
- Yes   : Rename the current file as shown in the Renaming window.
- Quiet : Rename the current and all further objects without confirmation.

Note that during a rename operation with confirm it is possible to change the
type of renaming by changing the relevant options. The change in the filename
is shown immediately in the 'renaming' window. For this reason all objects
are shown in the 'renaming' window, even those of which the name will be
unaltered with the current option settings. After a change in the options
the filename could alter in such a way it will be renamed after all. 

When a rename job is in progress you can drop a new file selection unto the
icon or one of the windows. This selection will be added to the end of the
list of objects to process. This is nowhere indicated...

When a rename job is finished the 'renaming' window will be brought to the
front (this can also be done during renaming by clicking SELECT on the
renamer icon on the iconbar) and an OK icon appears. Clicking this will
close the window. You may also drop a new selection on any of the windows
to start a new rename job.

All comments and suggestions for future improvement are welcome but please
note that I cannot reply to letters without return postage and a self
addressed envelope.

The address is:

    Simon Baas
    Korte Kruisweg 7
    2676 XK  Maasdijk (The Netherlands)
    01745-13088

or: baas@rulwi.LeidenUniv.nl (until august 1993)

I would also, of course, welcome details of any bugs discovered so that I can
correct them.


Version Improvements
====================

0.80 First Release version
1.00 Major rewrite of internals
2.00 Major rewrite of internals
     Added extension character deletion.
     Added minimum leafname length option.
_____________________________________________________________________________

Disclaimer
==========

You may NOT change this application or use ANY part of it in other products
without my approval. You may spread it freely (with *ALL* files included),
but not for any profit. This software is provided 'as is'. Using it is
entirely at your own risk.
_____________________________________________________________________________
