
			  Windows Filename Completion

			   Copyright Jason Hood 2003

			     Freeware. Version 1.10


    ===========
    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 in Win98SE, should work in others).


    ============
    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 at "HKEY_CURRENT_USER\Software\Adoxa\wfNameC" that you might  like
    to remove.


    =====
    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.".
    Subsequent 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.

    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.	The initial completion path will be used as the current dir-
    ectory for the next completion, so	if  wfNameC  doesn't  recognise  the
    displayed folder, it should only be necessary to enter the complete path
    once.

    The filename to be completed stops at the current  cursor  position.  It
    starts  either  at	the  first  unterminated quote, the beginning of the
    line, the first word before the cursor to have a drive specifier, or the
    first  space  before  the cursor.  A filename with an opening quote will
    not have a closing quote automatically appended.  If you have not  spec-
    ified  a complete path, it might be necessary to add an opening quote to
    continue cycling names that have spaces.

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


    ===============
    Version History
    ===============

    1.10 - 13 to 25 January, 2003:

    * use the system link color in the About box;
    * terminate the filename at the  current  cursor  position,  instead  of
      using a quote;
    * allow slashes ("/"), but replace them with backslashes ("\");
    * allow  filenames	within the line, not just at the beginning (so it is
      possible to complete parameters of commands,  not  just  the  commands
      themselves);
    * work with multi-line edit controls (that are not too big);
    * the current directory will be set to the initial path;
    * fixed a bug when the initial completion was empty.


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

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


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

    mailto:jadoxa@yahoo.com.au
    http://wfnamec.adoxa.cjb.net/

    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, 25 January, 2003.
