________________________________________________________________________

    DragText - Version 3.3 update 1

    The Drag and Drop Enabler for OS/2

    (C) Copyright R L Walsh 1994 - 2000  All Rights Reserved

________________________________________________________________________

    DTReadMe.Txt - quick start info for DragText
________________________________________________________________________


      C O N T E N T S
    ____________________

    o  Introduction
    o  Installation
    o  New and Revised Features
       -  Reenable
       -  Autoload
       -  Enhancements
       -  Bugs Fixed
       -  Other Changes
    o  Bugs and Shortcomings
    o  Using v3.3
    o  Registration
    o  License Agreement
    o  File List
    o  Feature Summary
       -  Drag
       -  Drop
       -  Related Features


________________________________________________________________________

Introduction
________________________________________________________________________

DragText v3.3 is the latest release of a distinctly different Desktop
enhancement for OS/2 Warp.  Present almost everywhere yet invisible
until needed, DragText lets you do what others can't:

Handle Text as an Object - Text in windows, files, and the clipboard
  becomes an object that can be copied, moved, saved or deleted using
  drag & drop - and now, using pickup & drop as well.

Access WPS Objects from Any Program - Treat a filename or Object ID
  like a shadow of the object it names;  use a window's System Menu
  button as your link to the object that opened it.  Drag these
  objects or use their menus - you can navigate the Desktop without
  opening a folder or even leaving your app.

DragText's three WPS classes, DTProgram, DTClip, and DTFile, offer
still more features.  For a comprehensive listing of DT's primary
features, see "Drag, Drop, and Related Features" at the end of this
file.  All of its features are documented in its online help.

DragText works with many popular programs such as editors, emailers,
and other internet apps.  DT's Basic features free;  its Extended
features are yours to try for 6 weeks.  Continued use costs only
$20(US) by mail or through BMT Micro.  As always, upgrades are free
for registered users, though reregistration is greatly appreciated.

________________________________________________________________________

Installation / Removal
________________________________________________________________________

Run DTSetup to install DragText v3.3 and enable your 6-week free
trial of DragText's Extended features.  DTSetup also be used to
reinstall or uninstall DragText.  Refer to DTSetup.Txt for a full
description.

If you are upgrading, do not uninstall your previous version.
Instead, let DTSetup install v3.3 in a new directory.  It should
be able to copy your existing settings and registration info from
the previous version.  When you are satisfied that v3.3 works for
you, you can delete the previous version's directory.

IMPORTANT:  If you use STARTUP.CMD to load DragText, please edit
the file and *delete* all references to DT.  V3.3 makes this load
method obsolete.

________________________________________________________________________

New and Revised Features
________________________________________________________________________

DragText has undergone major internal restructuring to enable
v3.3's primary new features.  Minor changes have been made to
some of DragText's other components.


New Features
------------

  Reenable - If a program disables or overrides DragText in a
      supported window, you can now restore DT's features on an
      app-by-app, window-by-window basis, for drag or drop or both.
      Default settings reenable edit windows in Netscape 4.x, the
      latest version of System Editor (e.exe), and several others.

  Autoload - Instead of running DrgTxt33.Exe to load DragText, you
      can have OS/2 load it automatically during boot-up. This
      guarantees that every windowed program will be DT-enabled.
      You can turn this option on or off at any time from DT's
      Options notebook.


Enhancements
------------

  Startup Options - Use the new 'Setup' page in DT's Options
      notebook to select the method used to load DT:  Autoload,
      WPS Startup Folder, or Manually.  DragText will update
      os2.ini and the Startup folder, creating or deleting
      entries and objects as needed - nothing unnecessary
      will be left behind.

  Text Links - Ctrl-Shift F10 will now display the WPS menu for
      a file or object mentioned in text, the same way that
      Ctrl-Shift MB2 does.  In addition, you can now use a WPS
      object's numeric handle to access it.  This can be handy
      when exploring the contents of your os2.ini.

  Url Handling - DragText has always been able to rejoin a Url
      split across several lines.  Now it also handles Urls with
      embedded email/usenet quote marks (i.e. '>').  Just hilite
      the entire Url and DT will remove the quotes, spaces,
      linefeeds, etc. when you create a Url object.

  Options Notebook - The 'Disable' section has been renamed
      'Setup' and has two new pages:
      - Setup page - set your startup option, specify the path
          for DT's INI file, and create new Desktop objects for
          DragText and DTClip.
      - Reenable page - specify programs and windows where DT
          should reenable itself.


Bugs Fixed
----------

  VIO - DT would ignore your choice of keys (i.e. Ctrl, Shift,
      and/or Alt) used to activate its mouse-marking feature and
      would revert to the default of "no keys pressed". (Update 1)

  DTFile/DTClip - The second and subsequent drops on these objects
      would fail if the drag did not pass over another icon or an
      empty space on the Desktop or in the target folder. (Update 1)

  WPS - The WPS would crash or hang due to an access violation 
      when dragging from a DT-enabled window owned by the WPS,
      and dropping on a DTClip or DTFile icon. (GA)

  Url Handling - Urls containing an embedded right bracket were
      truncated at the preceding character. (GA)

  FileStar - Because FileStar misidentifies dragged files as
      Netscape v2.02 Urls (DRM_HSTRSOURCENAME), DT would omit a
      file's path when inserting its name in text.  DT now works
      around this to achieve compatibility with both apps. (GA)


Other Changes
-------------

  Install Path - In order to support Autoload, DragText's
      installation path can not contain any spaces. (GA)

  All Text - Pressing Ctrl when you drag from an MLE, Listbox, or
      VIO window drags the entire contents of the window.  If this
      conflicts with your work habits, you can disable this feature
      on the Setup->Fixes page of DT's Options notebook. (GA)

  WPS Menus - All WPS menus now use the "topmost" window style
      intoduced by IBM to support ports of Windows apps.  Without
      this, menus might pop up below the requesting window. (Update 1)

________________________________________________________________________

Bugs and Shortcomings
________________________________________________________________________

  Autoload - one user of WSeB (v4.5) and one running Warp v4 with
      FP 14 report that DT loads but does not function.  Attempts
      to open the Options notebook only produce the initial splash
      screen.  To work around this:
        - run the copy of DTSetup in your current DragText directory
        - select a different 'Startup Option'
        - *uncheck* all of the WPS class options (optional)
        - press 'Install'.
      After you reboot, DT will function normally. (Update 1)

  DTProgram - there are limitations on the Environment feature,
      depending on how a program object is used.  This only affects
      OS/2 programs, not DOS and WinOS/2.
      -  if you open the object directly, this feature will work as
         expected:  the WPS will construct an environment for the
         program by merging your entries with the global environment.
      -  if you drop a file on this object, or open a file associated
         with this object, the WPS will only use your entries and
         will not construct a complete environment.
      This may be a serious problem for some apps but no problem at
      all for others.  You can work around this by using substitution
      variables (e.g. %PATH%) to copy required values from the global
      environment.  BEGINLIBPATH and ENDLIBPATH are not supported.

  Window Links and Text Links - some items on a linked object's popup
      menu don't work.  In particular, none of the entries on the
      'Create Another' submenu work except for the 'Default' entry.

      In some versions of Warp 3, a Window Link menu may first appear
      in the lower-left corner of the screen before moving to the
      proper position.

________________________________________________________________________

Using DragText v3.3
________________________________________________________________________

This section describes the use of new and revised features only.
For a comprehensive listing of DragText's primary features, see
the "Drag, Drop, and Related Features" section at the end of this
file.  All of DT's features are documented in its online help.


Reenable
--------
If an app has a window where DragText _should_ work (e.g. an MLE),
but it doesn't, Reenable may let you restore DT's features in that
window.  It only works with the types of windows that DT already
supports and does *not* add DragText's features to windows that never
had them (e.g. Netscape browser windows),

When a window is Reenabled, DT completely overrides an app's handling
of drag and/or drop.  This lets you:

  prevent a program from disabling DT, particularly when the program
   doesn't provide its own d&d (e.g. recent versions of System Editor)

  replace an app's native d&d with DragText's if you find DT's
   features are more useful (e.g. some editors and emailers)

  avoid some problems by letting DT handle d&d rather than using
   the app's buggy code (e.g. NewsReader/2).

Reenable should only be used where it is clearly needed because it
adds some complexity and overhead to affected windows.  For step by
step instructions, open the notebook to the Setup->Reenable page,
then press the 'Help' button.


About Autoload
--------------
The first time DragText's primary dll is loaded into memory, it
becomes part of the system and remains resident until you reboot.
All previous versions have used DT's exe to handle this initial
load.  v3.3 continues to support this method while offering a new
and possibly better one:  Autoload.

Autoload causes pmshell.exe to load DT's dll shortly after the
system enters graphics mode.  Since this occurs longs before any
windows are created, it guarantees that all possible windows are
DT-enabled,   In addition, this method is the standard way to load
dll's that add features's like DT's, so compatibility with future
versions of OS/2 is more likely.  (See "Bugs and Shortcomings"
above for a different perspective.)

Technical Notes:
Autoload adds drgtxt33.dll to the beginning of the list of dlls
stored in os2.ini under 'SYS_DLLS->LoadPerProcess'.  Putting it
first on the list causes it to be loaded *last*, but this is not
a requirement.  All that really matters is that it appear _before_
PMCTLS.  Unlike other dlls on the list, DT's includes its full
path.  This was done to avoid modifying your LIBPATH in config.sys.


Startup Options
---------------
Whenever you want to change the way DragText loads, turn to the new
'Setup' page in DT's Options notebook.  Use the 'Startup Options'
here to update your system and ensure that unnecessary entries and
objects are deleted.

  Autoload - DT will load during boot-up before any program.
   Selecting this option puts an entry in os2.ini and deletes
   DT's startup object from the WPS Startup folder.

  WPS Startup folder - DT will load shortly after the WPS starts.
   Selecting this option creates a separate DT program object in
   your Startup folder, and deletes DT's entry in os2.ini.

  Manually - DT will load the first time you open its Desktop
   program object.  Selecting this option deletes *both* DT's
   entry in os2.ini and its program object in the Startup folder.

_______________________________________________________________________

 Registration
_______________________________________________________________________
 
To keep DragText's Extended features from becoming disabled after
your 6-week free trial ends, register it directly with the author
or through BMT Micro.  You will receive a registration number to
enter on the last page of the Options Notebook. 


Direct 
------
The author can accept checks or money orders drawn in any major
currency. 

      U.S. Dollars:   Registration is $20 if your check is drawn
       in US dollars on a bank in the United States.  Some users
       in western Europe have successfully sent me cash, but this
       was done entirely at their own risk.   

      Other Currencies:   registration cost is the equivalent of
       $25 converted into your national currency.  You can determine
       the exchange rate by asking your bank or looking in the
       financial pages of your local newspaper. 

If you have any questions, email me before sending your payment. 
  
Mail your check or money order to: 
       Rich Walsh 
       315 S. Barbour St. 
       Beverly Hills, Florida  34465 
       U.S.A. 
  
Include your full name, mailing address, and email address
(if available).  Send email to:  DragText@E-vertise.com 


BMT Micro 
---------
Registration is $20.   

  Phone:         8:00am - 7:00pm EST (-5 GMT) 
                 (800) 414-4268 (Orders only) 
                 (910) 791-7052 (Orders / Order Inquires)   

  Fax:           (800) 346-1672 24 hours, 7 days a week 
                 (910) 350-2937 24 hours, 7 days a week   

  Internet:      bmt@wilmington.net 
                 http://www.bmtmicro.com   

  Compuserve:    Thomas Bradford, 74031,307   

  AOL            bmtmicro   

  BBS:           (910) 350-8061 10 lines, all 14.4K 
                 (910) 799-0923 28.8k v.FC   
  
BMT Micro accepts Visa, Mastercard, Discover, American Express,
Diner's Club, money order, cashiers checks, and personal checks.
They also accept DM and British currency via registered mail.
Personal checks are subject to clearance. 

BMT Micro accepts purchase orders from educational institutions,
governmental agencies and other verifiable businesses.  Terms are
"Due Upon Receipt" with a $250 minimum.

_______________________________________________________________________

 License Agreement
_______________________________________________________________________
 
DragText, its executables and documentation, is the copyrighted
property of Richard L. Walsh. It is licensed, not given, to you
for your personal use.  Selected features require the payment of
a registration fee for continued use.

You may copy and freely redistribute DragText to others, provided: 
        -  the recipient agrees to the terms of this license, 
        -  you transfer DragText as a whole and intact, and
        -  there is no cost to the recipient other than the
           costs of providing media and transmission.

You may not modify DragText in any way nor may you reverse assemble,
reverse compile, or otherwise translate or reverse engineer its
executable code or data. You may make additions to the documentation,
including translations into other languages, provided these are
contained in files separate from the originals and are identified
as addenda to the accompanying original documentation.

DragText is not warranted to be free of defects nor to be suitable
for any particular purpose the licensee may put it to. The licensee
agrees to use DragText at his or her own risk, and agrees to accept
all liabilities arising from its use, including all claims by third
parties, without recourse to the author or copyright holder.

THERE ARE NO WARRANTIES, EXPRESS OR IMPLIED, OF ANY SORT. BY YOUR
USE OF THE PROGRAM YOU AGREE TO THE TERMS OF THIS LICENSE.   

_______________________________________________________________________

File List
________________________________________________________________________

Archive file drgtxt33.zip contains:

  1. drgtxt33.001      May  1, 2000    03:30:00
  2. drgtxt33.002      Nov 24, 2000    03:30:02
  3. drgtxt33.003      May  1, 2000    03:30:00
  4. drgtxt33.004      Nov 24, 2000    03:30:02
  5. drgtxt33.005      May  1, 2000    03:30:00
  6. drgtxt33.006      Nov 24, 2000    03:30:02
  7. drgtxt33.007      May  1, 2000    03:30:00
  8. drgtxt33.008      Nov 24, 2000    03:30:02
  9. dtreadme.txt      Nov 24, 2000    03:30:02
 10. dtsetup.exe       May  1, 2000    03:30:00
 11. dtsetup.txt       Nov 24, 2000    03:30:02
 12. dthelp.txt        May  1, 2000    03:30:00

_______________________________________________________________________

Feature Summary
_______________________________________________________________________
 
The following tables provide a complete listing of every DragText
feature that involves the use of MB2 (the drag button, usually the
right-hand one).  DragText's WPS classes provide additional features
that are not included here.   

      Drag 

      Drop 

      Related Features 

_______________________________________________________________________

Drag
_______________________________________________________________________
 
This table identifies: 

     What you can drag (Dragged Item) 
     Where it comes from (Drag Source) 
     How to drag it (Required Action) 

  Ŀ
  Dragged Item        Drag Source    Required Action               
  Ĵ
  Selected text *     most windows   highlight text, then drag     
                                     or press Alt-MB2 to pickup;   
  Ĵ
  All text *          MLE, Listbox,  press Ctrl, then drag or      
                      & VIO windows  press Ctrl-Alt-MB2 to pickup; 
                                                                   
                      Entryfield     drag without highlighting,    
                      & Static text  or press Alt-MB2 to pickup;   
  Ĵ
  Clipboard text      DTClip icon    drag from icon,               
                                     or press Alt-MB2 to pickup;   
  Ĵ
  File or Object ID   most windows   highlight name or ID,         
  named in text                      then Ctrl-Shift drag;         
  Ĵ
  Object that opened  Sysmenu        Ctrl-Shift drag;              
  this window                                                      
  
  
  *   Basic (free) feature, except in VIO windows; all other features
      require registration. 
    
_______________________________________________________________________

 Drop
_______________________________________________________________________
 
This table identifies: 

     Where you can drop (Drop Target) 
     What you can drop (Dragged Item) 
     Which key is required (Key to Press) 
     What will happen (Drop Result) 

  Ŀ
  Drop Target  Dragged Item   Drop Result                 Key to Press
  Ĵ
  Text Window  Dragged text   insert text *                           
               DTFile         insert contents                         
               Url object     insert contents                         
               File / Object  insert path *                           
                              insert name only *          Shift       
               File           insert directory entry +    Ctrl        
                              insert contents +           Alt         
               Folder         insert formatted listing +  Alt         
               Unknown item   insert app-specific text *  Alt         
  Ĵ
  Folder       Dragged text   create file                             
               Url text       create Url object                       
  Ĵ
  System Menu  File / Object  locate object                           
  Button                      open object                 Alt         
                              popup object's WPS menu     Ctrl        
  Ĵ
  Titlebar     same as        copy to DTClip viewer                   
               Text Window                                            
  Ĵ
  DTClip Icon  same as        copy to clipboard                       
               Text Window    append to clipboard         [Insert] %  
  Ĵ
  DTFile Icon  same as        append to file                          
               Text Window                                            
  Ĵ
  DTProgram    Dragged text   open using text                         
  Icon                        as startup parameter;                   
               Multiple files open using filenames                    
                              as startup parameter;       Ctrl-Shift  
  

  NOTE:  to drop an object you have picked up, press Ctrl or Shift
  (to copy or move), then click MB2.  To cancel a pickup, Alt-click
  MB2 on the Desktop or a DragText-enabled window.

  *   Basic (free) feature;  all others require registration. 
  +   supported only in these windows/objects: MLE, VIO, Titlebar,
      DTClip, and DTFile 
  %   press and release Insert while over a DTClip icon to toggle
      between append and replace modes 
    
_______________________________________________________________________

 Related Features
_______________________________________________________________________
 
This table identifies: 

     What else DT does (Feature) 
     Where to use it (Window) 
     How to use it (Usage) 
     What it does (Result) 

  Ŀ
  Feature     Window   Usage                    Result                    
  Ĵ
  Window Link Sysmenu  click MB2                show menu of object that  
  Menus       button                            opened this window        
                       Ctrl-click MB2           menu of program object    
                                                used to open this window  
  Ĵ
  Text Link   text     Ctrl-Shift-click MB2     show menu for selected    
  Menus       windows  or Ctrl-Shift F10        filename or object ID     
  Ĵ
  Mouse       VIO      drag while pressing MB1  mark text                 
  Marking +            press MB2 while marking  copy to clipboard         
                       press MB1+MB2            paste from clipboard      
  Ĵ
  Background  most     actions using MB2        window won't be activated 
  Drag *      windows                           or brought to the top     
  
  
  *   Basic (free) feature;  all others require registration. 
  +   Options permit selection of MB1 or MB3 for marking, and whether
      selected keys must be pressed to activate this feature. 
   
_______________________________________________________________________
_______________________________________________________________________

Rich Walsh  (DragText@E-vertise.com)
Ft Myers, Florida

May  1, 2000 (GA)
Nov 24, 2000 (Update 1)
_______________________________________________________________________
_______________________________________________________________________

