
CMDFldr - Command Folder V 1.30 (c) Dirk Suesserott Mar 3 1994

email: doyke@rbi.informatik.uni-frankfurt.de
    or suesserott@wiwi.uni-frankfurt.de

Description:
============

CMDFldr is a Workplace class that replaces the WPFolder class shipped with 
OS/2 2.x.  It adds a submenu to each folder on the WPS and lets you start an 
OS/2 or DOS Window in the right path on the right drive.  In addition, it 
asks for confirmation of the 'arrange' item, which is useful especially for 
the desktop.  

I wrote it for OS/2 2.1 but it should also work with OS/2 2.0.  

If you click through many folders in order to find a particular file and then 
want to perform some commands on the file, it is often very difficult to open 
a command line and cd to the right path - without even knowing the full path 
name.  With CMDFolder installed this is no longer a problem:  Simply 
right-click on the folder containing your file and select 'Command line...'.  
And there you are.  CMDFolder will start a windowed OS/2 session in the right 
path on the right drive - wherever you are on whatever drive you are.  
CMDFolder is HPFS aware and works with long pathnames (including blanks).  It 
won't work on a drive itself (i.e.  you can't right-click on Drive C and open 
a command line.  That's because a drive does not belong to the class WPFolder 
but to the class WPDrive). 
If you wish, CMDFolder will also start an OS/2 fullscreen session or a DOS window
or fullscreen session.
In addition, CMDFolder also asks you to confirm the selection of the 'arrange'
or 'sort' item. If you already hit 'arrange' on the desktop by mistake, you'll
know why this is useful.

I hope you will have as much fun as i have with this tool.

For installation details see below.  There is also an uninstallation section 
(in case you don't like CMDFolders any more).  




Disclaimer
==========
The Program is supplied "AS IS" without any warranty of any kind, either 
expressed or implied, including, but not limited to, the implied warranties of 
merchantabilty and fitness for a particular purpose.  In no event i will be 
liable for any damages, either direct or consequential, caused by the use, or 
inability to use, this program, even if i have been advised of the possibility 
of such damages.  You are free to re-distribute this package as long as you 
don't get paid for it (if somebody wants to pay, please tell me).  



Bugs
====
Hmm, I don't know why, but CMDFolder wants the 'Sort' item of Drive C to be 
confirmed. This is strange, because Drive C is actually not a folder but a 
drive.
If you can help me or find other bugs, please tell me.  Any suggestions are
welcome, too.
Please send email to doyke@rbi.informatik.uni-frankfurt.de
                  or suesserott@wiwi.uni-frankfurt.de




Installation
============
   First of all, this package consists of four files:
      CMDFldr.ENG (38379 bytes) the English DLL
      CMDFldr.GER (38443 bytes) the German DLL
      install.exe (20064 bytes) installation program
      readme.txt  (some bytes)  this file.



Updating from previous versions to V 1.30
=========================================
   If you already have installed Command Folder V 1.10 or V 1.20, 
   there are three ways to update. The latter two are slow, because
   you have to boot multiple times and/or boot from floppy disk. 
   The 1st method is the fastest, but feel free.

   1st method:
      - add the following line as first line to your config.sys:
         'call=c:\os2\xcopy.exe c:\sucked\cmdfldr.dll c:\os2\dll'
      - make sure xcopy.exe is in the c:\os2 directory and source 
        and target directories are set appropriate (change the above
        line if necessary).
      - Reboot.
      - While rebooting OS/2 should tell you '1 file copied'.
      - After rebooting you should delete the 'xcopy'-line from the 
        config.sys.
      - That's it.

   2nd method:
      - You may fool OS/2 by booting from floppy-disk(s).
      - Insert OS/2 Installation Disk (Disk #0)
      - (Re)boot.
      - Insert 2nd disk (Disk #1) after OS/2 tells you.
      - ESCape to the command prompt after OS/2 asks you to
        either proceed with the installation or ESCape.
      - Copy the new CMDFolder.DLL over the old one.
      - press CTRL-ALT-DEL simultaneously in order to reboot
        (there is no way to shutdown).
      - That's it.

   3rd method:
      - Run my install program (no matter which version).
      - Type 'u' to un-install the old CMDFolder.
      - Wait until the install program shows something like
        'CMDFolder successfully uninstalled, please reboot'.
      - Do so.
      - Copy the new .DLL over the old one (make sure to use the
        right language (German or English, see below)
      - Run install program again.
      - Type 'i' to install the new .DLL.
      - Wait until the install program shows something like
        'CMDFolder successfully installed, please reboot'.
      - Do so.
      - That's it.

 


Quick Installation Guide:
=========================
   1. Rename either the German DLL (CMDFldr.GER) or
      the English DLL (CMDFldr.ENG) to CMDFldr.DLL
   2. Move the DLL into your libpath
   3. Run the install program (no parameters required)
   4. Reboot



Slow Installation Guide:
========================
   First Step:
      Rename either CMDFldr.GER or CMDFldr.ENG to CMDFldr.DLL The only
      difference between the DLLs is that one is in German language while the
      other one is in English language.  (i.e.  the new context menu will
      either show 'Command Line...'  or 'Befehlszeile...'). Do this by typing
      the following on a command line:

            'ren CMDFldr.ENG *.DLL'  (english version)
         or 'ren CMDFldr.GER *.DLL'  (german version)

      (without quotation marks, of course)


   Second Step:
      Move the DLL into any path included in your libpath statement in the 
      config.sys, e.g.  c:\os2\dll.  Do this by typing the following on a 
      command line:
 
         'copy /b CMDFldr.DLL c:\os2\dll'


   Third Step:
      Invoke the installation program by typing

          'install'

      There are no parameters required and therefore all parameters you 
      supply will be ignored.

      As you'll see, there is a little menu
         i)nstall
         u)ninstall
         e)xit
 
      Type 'i' to install the DLL. The program will register the DLL in the
      system and then replace the WPFolder class with the CMDFolder class
      (i.e. all ordinary folders sitting around and waiting for being 
      clicked will become CMDFolders sitting around and waiting for being
      clicked).
   Note:
      Don't be afraid: 'replace' does not mean that the contents of your
      folders are replaced or that the folders themselves are replaced. Only
      the Workplace class named WPFolder is replaced by a derived class named
      CMDFolder. The effect is that all objects (i.e. folders) that formerly
      belonged to the class WPFolder will then belong to the class CMDFolder
      and therefore have the new properties of the new class.


   Fourth and Last Step:
      Wait a few seconds. Your harddisk will start spinning. Don't panic,
      the program won't move, copy, or delete anything (i hope) but OS/2
      will search along the libpath to find the DLL. The install program 
      will show something like 'CMDFolder successfully installed'
      Now shutdown and reboot for the changes to take effect.



Trouble Shooting:
=================
   If the installation didn't succeed make sure that 

      - you renamed one of the files to 'CMDFldr.DLL' (not case sensitive).
        Do *not* rename the DLL to 'CMDFolder.DLL' or something like that.
        It is very important that the file is called CMDFldr.DLL. Otherwise
        OS/2 won't find it.
 
      - you moved the previously renamed DLL into your libpath (if you don't
        know what this means please refer to the OS/2 Online Reference Manual
        for further details)

   I'm not sure what happens if you have already installed some other
   replacements for the WPFolder class. Just try it.



De-Installation 
=============== 
If you don't like the CMDFolder any more (I will not hope so) run the install
program again.  Type 'u' to uninstall the CMDFolder.  The program will then
re-replace the CMDFolder with the original WPFolder class.  You should reboot
after Install tells you to do so.  All CMDFolders will become ordinary folders
again, the additional menu item 'Command line...'  will be removed from their
popup menus.  You should also delete the CMDFldr.DLL from your libpath after
rebooting.  It is not possible to delete the DLL without running the uninstall
procedure.



History
=======
Command Folder V 1.30, released Mar 3 1994
   - confirmation of 'Sort' now works with all submenu items (i.e. Sort by 
     Name, Sort by Size, ...)
   - confirmation of selection of 'Arrange' or 'Sort' menu items can now be
     set for each folder separately.

Command Folder V 1.20, released Feb 15 1994
   - now uses the command line interpreter as defined in config.sys
   - capable of starting DOS sessions and fullscreen OS/2 sessions - as well 
     as OS/2 windows
   - asks for confirmation of selection of 'Arrange' or 'Sort' menu items

Command Folder V 1.10, released Dec 20 1993
   - starts only OS/2 Windows (i.e. 'cmd.exe')

