
CMDFldr - Command Folder V 1.10 (c) Dirk Suesserott Dec 20 1993 

email: doyke@wiwi.uni-frankfurt.d400.de


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

CMDFldr is a Workplace class that replaces the WPFolder class shipped with 
OS/2 2.x.  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).  

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
====
I assume there are none.  Nevertheless, if you find one (or more) please tell
me.  Any suggestions are welcome, too.  
Please send email to doyke@wiwi.uni-frankfurt.d400.de




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



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 'Befehlzeile...'). 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

      - 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 already have installed some other
   replacements for the WPFolder class. Just try it.



De-Installation
===============
If you don't like the CMDFolder any more (i won't hope so) run the install 
program again.  Type 'u' to uninstall the CMDFolder.  The program will then 
re-replace the CMDFolder with the ordinary 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 won't be possible to remove the DLL without running the 
uninstall procedure.  



