
                          Windows Filename Completion

                           Copyright Jason Hood 2000

                            Version 1.00   Freeware


 ===========
 Description
 ===========

 Windows Filename Completion (wfNameC) is a utility  for  keyboard  users.   It
 allows filenames to be  completed  by  pressing a key. Two keys are available.
 One will cycle through all names; the other will display a  list.  These  keys
 can be used interchangeably (the  list  can  be  displayed during a cycle; the
 cycle will continue after a list selection).


 ============
 Requirements
 ============

 32-bit Windows (developed on Win98, but should work on Win95/NT/2000/ME).


 ============
 Installation
 ============

 Unzip to a directory of your choice.
 Run "wfNameC.exe".
 Select the desired hotkeys and options.
 Press OK.

 To uninstall, uncheck the "Start with Windows" option and exit.   Then  simply
 delete the directory you  placed  it  in.   There is also a registry entry you
 might like to remove at "HKEY_CURRENT_USER\Software\Adoxa\wfNameC".


 =====
 Usage
 =====

 When you are asked to enter a filename, it is no longer necessary to  type  in
 every character, or use the Browse dialog. Instead, just type the first couple
 of characters and press one of the new hotkeys.

 The cycle hotkey will automatically supply the common part of  every  matching
 filename. When pressed again, it will cycle through all the names.  Once every
 name has been displayed, it will again display the common part.  For  example,
 if the directory contains the files:

        makefile
        wfNameC.c
        wfNameC.exe
        wfNameC.h
        wfNameC.ico
        wfNameC.rc
        wfNameC.txt

 then typing "w" and pressing the cycle hotkey will  enter  "wfnamec.".  Subse-
 quent presses will then enter  "wfNameC.c",  "wfNameC.exe",  and  so  on until
 "wfNameC.txt", then back to "wfnamec.". Note  that  if  the  common  part  has
 already been entered, nothing will happen (it completes what's already there).
 So if you type nothing, the first press of the hotkey completes nothing (since
 the above names have   nothing  in  common),  then  the  second  will  display
 "makefile".  If you check the option "Cycle immediately", the common part will
 not be completed. Instead,  it will display the first name straight away, then
 the second, and so on, until going back to what you originally typed.

 The list hotkey will display a list of matching filenames, entering the common
 portion.  Additional keys will be added after the common portion, reducing the
 displayed names.  For example, typing "w" and then pressing  the  list  hotkey
 will enter "wfnamec." and display  all those files. Typing "t" will reduce the
 list to "wfNameC.txt".  Backspace  will  restore  it  to  the  complete  list.
 Backspace again, or Escape,  will  cancel  the list and restore what you typed
 (the "w").

 In both cases, if only one name matches it will complete immediately.   If  no
 names match, the default  beep is sounded. If a directory is selected from the
 list, a new completion will be started  with  the  files  in  that  directory,
 otherwise the cycle or list will continue with the original entry.

 The hotkeys can be used in the list (an alternative to Enter).  Using the list
 hotkey on a directory will also display the list for that directory.

 Wildcards can be entered explicitly. For example, if you just want a  list  of
 executable files, you can  type  "*.exe".  In this case, the cycle will always
 start immediately.

 Quotes will be handled correctly. The start quote will simply be  ignored,  as
 will any text after the  closing  quote.  This  could allow you to complete an
 existing directory for a new program. For example, installing a new card  game
 might supply a default path of "C:\Program Files\Author\NewGame". I would like
 to place  that  in  "E:\Games\Card\NewGame".  By  deleting  everything  except
 "NewGame", and adding "e:\g"  and  a  quote,  I could complete Games. The text
 would like this:

                e:\g"NewGame    ==>    E:\Games\"NewGame

 Then I could type "c" to complete Cards, and finally delete the quote.

 Note that it is usually necessary to enter a complete path (ie. drive and root
 directory).  If you are using Explorer-style Open or Save dialogs, though, the
 displayed folder will be recognized as the current directory.

 If you choose to hide the tray icon, simply run  "wfNameC.exe"  again to bring
 up the settings dialog.


 ===============
 Acknowledgments
 ===============

 Alex Vallat, who supplied me with his UAC source code.
 Jacob Navia, for LCC-Win32.


 =======
 Contact
 =======

 mailto:jadoxa@hotmail.com
 http://adoxa.homepage.com/wfnamec/

 Jason Hood
 11 Buckle Street
 North Rockhampton
 Qld 4701
 Australia


 ============
 Distribution
 ============

 The original zipfile can be freely distributed, by any means. However, I would
 like to be informed  if  it  is  placed  on  a  CD-ROM  (other than an archive
 compilation).  Modified versions may be distributed, as long as  the  original
 zipfile is included (I would prefer to be contacted).


 ==============================
 Jason Hood, 2 September, 2000.
