----------------------------------------------------------------------
                       Long File Name Enabler Ver 1.0
                      Copyrights (c) 1988 Oren Manzury
			     All Rights Reserved
----------------------------------------------------------------------

1. Intruduction

    Long File Name Enabler (LFNBLE) enrich your old win 3.x (16 bit)
    applications with windows 95 ability to use long filenames for
    your data.
    the old win 3.x application must use windows "common dialog box"
    library to implement the "Open" & "Save As" dialogs in order to 
    take advantage the long file name support. 

2. Features

   * Enable most of the win 3.x (16 bit) applications to use windows
     95 long filenames support.

   * Can be customized in per application basis (can be disabled for 
     particular application and still serve others).

   * Include uninstall option which will remove the software completely
     when you will not need it any more.

   * It is free software.

3. Archive content

    disk1                  installation diskette identification
    file_id.diz            short description of the software
    lfnble.inf             windows installer script file
    lfnble.drv             the enabler driver
    readme.txt             this file
    setup.exe              install program
   

4. System requirements

    This sofware was writen and tested on Windows 95, however it
    supposed to work on windows 98 either.
    It does not intend to work on windows NT.

5. Installation
   
    You can install LFNBLE in three easy ways:

    * Invoke the bundled "setup.exe" and restart your computer to let
      the changes take effect (this is the preferable way).

    * Right click the mouse pointing to the file "lfnble.inf" and 
      select "install" from the popup menu, then  restart the computer.

    * For those people who would like to make the modifications with
      theirs "bare hands" follow these steps:

      - Copy the file "lfnble.drv" to your WINDOWS\SYSTEM directory.

      - Edit the file "system.ini" (you should know the file position
        if you picked this way to install the software) as follow:

        + Append the string "lfnble" to your "drivers" entry in the
          "[boot]" section.

        + Add the entry "lfnble=lfnble.drv" to the "[drivers]" section.

      - Restart the computer.

    If you installed the software using the first two ways you can
    uninstall it completely using the "Add/Remove" applet in the
    control panel.
    The others should uninstall the software the opposite way they 
    used to install it.

    After successful installation you should see LFNBLE banner every 
    time you boot windows just before the shell appearance.

6.  "Common dialog box library"

    "Common dialog box library" is Microsoft attempt to make it easier
    for software developers to develop applications to windows operating
    system and assists users by providing a standard set of controls for
    performing certain operations (select colors and fonts, find text, 
    print & print setup, open and save files).

    The library is implemented in the dynamic link library COMMDLG.DLL
    and it is part of the windows operating system since version 3.1
    (the library was available for windows 3.0 as a redistributable)

    And indeed a lot of windows applications have been writen using
    the "common dialog library" so there is a good chance that the 16 bit
    old windows application that you stuck with is using COMMDLG.DLL 
    for implementing the "Open" & "Save As" dialogs.

    The common dialog box library allow developers to customize the 
    dialogs, so sometimes "Open/Save" dialog box which looks completely 
    different from the basic dialog, is still based on the library and 
    therefore can benefit from LFNBLE long filenames support (e.g. application
    which were developed using Borland OWL2.0 - very popular development
    framework for 16 bit applications).

    However there are still many applications, which are not using 
    COMMDLG.DLL, applications that were writen for windows version 3.0, 
    before the common dialogs were introduce and few newer applications
    (e.g. WinWord 6.0 for windows 3.1) with special needs. 
    these applications can't benefit from LFNBLE - sorry.
 
    In order to find out if your software is using COMMDLG.DLL do the
    following:

    * Using the windows explorer point to the executable file and right 
      click the mouse.

    * Select "quick view" from the popup menu.

    * Search for the module "COMMDLG" in the imported name table.

    If you found it then your executable is using the "common dialog 
    box library"

7.  Customizations

    There are four parameters that control LFNBLE behavior and can be 
    customized globally or separately for each application.

    The parameters are:

    (1) enable\disable LFNBLE operation.

        You can use this parameter to disable LFNBLE for specific 
        application (in case it caused you some troubles) and still
        use it for another.

        The default value is enable

    (2) allow\disallow multi-file selection.

        Multi-file selection is the ability to select more then one 
        file simultaneously. The drawback of mutil selection is the
        appearance of the files names in the dialog list box, files 
        with names which include spaces between words are shown in the
        short alias form (e.g. the file "this is very long file.txt"
        will appear as "thisis~1.txt")

        By disallow multi selection you can gain names appearance
        instead of the ability to select multiple files simultaneously.

        The default value is disallow multi-file selection.
    
    (3) enable\disable alias name notification for items selected from the files
        list box on the fly.

        "common dialog library" allow applications to monitor list box
        selections in order to process and display data in custom controls
        (e.g. applications can use this feature to compute the total 
        count of bytes each time the user select a file or cancel the
        selection of a file).

        In order not to break the old win 3.x applications which were
        writen with the 8.3 file system in mind, this parameter force 
        LFNBLE to report the short alias name for each selection of 
        file in the files list box.

        The default value is enable alias name notifications

    (4) enable\disable conversion of "edit box" long file name to 
        alias name after each file selection.

        Every time that you select file from the files list box, the 
        file name you selected appear in the "file name" edit box 
        on the top left corner of the dialog box.

        There are few applications that acquire the file name 
        directly from the list box in order to display some kind of 
        information about the file you selected (e.g. win3.1 "paint brush"
        is taking the file name directly from the list box each time 
        you press the "info" button).

        For these applications you need to enable the parameter in 
        order to benefit from the extra information they supply.

        The default value is disable conversion on the fly.


    In order to customize LFNBLE you have to edit the file 
    "system.ini" from your WINDOWS directory, you need to add entries 
    to the section "[lfnble]" (created by the installation process) 
    in the from:

    'executable file name' =  w x y z

    The 'executable file name' is the full application executable name 
    (including extension)

    w x y z are the parameters (1) - (4) which I just described.
    for each parameter use the digit '1' to specify enable/allow 
    and the digit '0' to specify disable/disallow.

    For example: 

    Suppose you want to allow multi file selection for "Borland c++ 
    compiler" (executable name bcw.exe) you should add to the "[lfnble]"
    section the entry 

    bcw.exe=1 1 1 0
  
    Suppose you want to disable LFNBLE for the application "Note Pad" 
    (executable name notepad.exe) you should add to the "[lfnble]"
    section the entry

    notepad.exe=0

    In order to change globally the default parameters, use the name
    "lfnble.drv" as executable name (e.g. lfnble.drv=q x y z)


    Restrat your computer after you change the "system.ini" file to let
    the changes take effect.

8. License agreement \ warranty
        
    This software is FREEWARE for private use only.

    This software may NOT be distributed or bundled with any product
    that is sold for commercial profit without the explicit permission
    of the author.

    You may make copies of this software to give to others, as long as 
    you include all of the files that you originally received with your 
    Copy. 

    It is allowed to distribute this product as part of CD collection
    of sharware\freeware software.

    Disclaimer:

    The author hereby disclaims all warranties relating to this 
    software, whether express or implied, including without limitation 
    any implied warranties of merchantability or fitness for a particular
    purpose.
    The author will not be liable for any special, incidental,
    consequential, indirect or similar damages due to loss of data 
    or any other reason, even if the author or an agent of the author
    has been advised of the possibility of such damages.
    use this software ON YOUR OWN RISK.

9. Contact Information

   If you have any comment \ question \ suggestions for improvements
   you can send me email to

       manzury@yahoo.com


   Enjoy

   Oren Manzury 
   
