________________________________________________________________________

    DragText - Version 3.7

    A Distinctly Different Desktop Enhancement

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

________________________________________________________________________

    DTReadMe.Txt - quick start info for DragText
________________________________________________________________________


      C O N T E N T S
    ____________________

      Introduction
      Install / Remove
      New and Revised Features
       -  OverDrag
       -  Enhancements
       -  Bugs Fixed
      Using OverDrag
      Bugs and Limitations
      Registration
      License Agreement
      File List
      Feature Summary
       -  Drag
       -  Drop
       -  Related Features
       -  OverDrag

________________________________________________________________________

Introduction
________________________________________________________________________


DragText v3.7 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.  DragText supports both native OS/2 PM programs and
  Win32 programs running under Odin*.

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.

Eliminate the Obstacles to Drag & Drop - If you've ever cancelled
  a drag because the target window was covered or the folder you
  needed wasn't open yet, you'll like OverDrag.  Now when you use
  DT or the WPS, you can click the mouse or press a key as you drag
  to:  open folders, scroll windows, minimize & restore them, and
  more.  Rearrange your desktop as you drag, then let DT clean up
  when you're done.

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.

__________________________________________________________________________

Install / Remove
__________________________________________________________________________


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

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

To revert to a previous version of DragText, use this version's
DTSetup to uninstall v3.7.  Reboot, then run the copy of DTSetup
in the earlier version's installation directory.

________________________________________________________________________

New and Revised Features
________________________________________________________________________


DragText v3.7 adds a major innovation:


New Feature
-----------

  OverDrag - Enjoy the most versatile set of drag and drop features
      found on any platform whenever you use DragText or the WPS
      to drag text or objects.  The Basic features let you scroll,
      rearrange, minimize and restore windows as you drag.  With
      the Extended features enabled, you can open folders, locate
      WPS objects, and expand branches in Tree view while dragging.
      After the drag DT will cleanup, closing folders and restoring
      windows to their original state.


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

  File Dialogs - v3.7 offers improved WPS integration for 'Open' and
      'Save as' dialogs.  Handle any drive, directory, or file name
      listed like a WPS object.  Press Ctrl+Shift, then drag it, open
      it [press Enter], or popup its WPS menu [press F10 or click MB2].

  DTClip - The clipboard viewer now offers a search & replace feature.
      It's dialog is shared by all open viewers, making it easy to
      search multiple windows for the same text.


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

  DragText - dragging more than 255 characters of text between windows
      resulted in a memory leak because attempts to free PM's control
      structures failed.  This has been fixed by postponing the
      deallocation request.

  Window Link menus - selecting Copy, Move, or Create Shadow on these
      menus produced a blank dialog.  This has been fixed by using the
      same type of menu as Text Links.

  VIO windows - DT's use of Ctrl-Shift-Enter and Ctrl-Shift-F10
      prevented apps running in the window from receiving these
      keystrokes.  These WPS hotkeys can now be disabled for VIO
      windows globally, or on a window-by-window basis (recommended)
      from the window's DragText submenu.

__________________________________________________________________________

Using OverDrag
__________________________________________________________________________


OverDrag features are available whenever you use DragText or the
WPS to drag text or objects.  


Basics
------
OverDrag is easy to use if you remember that you can now use MB1
to do "MB1-like" things during drag & drop.

The Basic features let you point and click on:

 1. Scrollbars          scroll by line or page
 2. Min/max buttons     minimize a window
 3. Minimized windows   restore a window
 4. Titlebars/menubars  change z-order

When the Extended features are enabled, you can click MB1 on:

 5. Folder icons        open the folder
 6. Open objects        surface open windows
 7. Sysmenu buttons     open the parent folder
 8. Collapsed branches
    in Tree view        expand the branch


Hotkeys
-------
OverDrag isn't a "mouse-only" feature:  all of its functions can
be invoked using hotkeys instead.  In most cases, the mouse pointer
can be anywhere over a main window when you press a key.

OverDrag's default keyboard and mouse assignments can be configured
on the 'Basic->Keys & Buttons' page of DT's Options notebook - e.g.
you may want to use MB3 instead of MB1 as your "overdrag" button.


Other Features
--------------
OverDrag offers several other features that are controlled by settings
on the 'Basic->OverDrag' page of the Options notebook:

 9. Auto-raise - windows come to the surface as you drag over them,
    either immediately or after a short delay.

10. Cleanup - DT will close folders you opened and return minimized/
    restored windows to their original state when a drag ends.


Extra Features
--------------
OverDrag also enables users of XWorkplace's XPager & Object Desktop's
Control Center to switch virtual desktops during a drag.  However,
some precautions are required:

 x  XWorkplace - you *must* turn off 'mini-window mouse actions' in
    XPager's settings to avoid having your drag cancelled if you
    click on a mini-window.

 o  Object Desktop - you can only click on a *blank* portion of the
    virtual desktop.  Clicking on a mini-window will cancel your drag.


Notes
-----

 a. If windows don't repaint completely after using OverDrag, wait
    a moment.  750 ms. after an operation finishes, DT will update
    the entire desktop automatically.  You can also force an update
    at any time by pressing the 'Redisplay' hotkey ('D' by default).

    Since the automatic update is triggered by mouse movement, you
    can delay it by not moving the mouse for a second or two.  Use
    this when, e.g., opening a drive object in Tree view to ensure
    it is fully populated.

    If you find you have to use this "delaying tactic" frequently,
    increase the 'Redraw delay' setting on the Basic->OverDrag page
    of DT's notebook.  This gives windows belonging to other threads
    or processes more time to update themselves asynchronously.

 b. OverDrag emulates scrollbar mouse actions.  When deciding whether
    to page up or down, it only considers whether the mouse is above
    or below the center of the slider - the slider itself is ignored.

    Only native PM scrollbars are supported - those in Mozilla, Java
    and Win32 apps, etc. are not.  However, pressing the Page Up and
    Page Down hotkeys may work where the mouse doesn't.

 c. OverDrag's WPS features only work with icons in WPS folders or
    on O.D.'s TabLaunchpad.  Icons on menus, toolbars, etc., are
    not supported.

________________________________________________________________________

Bugs and Limitations
________________________________________________________________________


  Odin Support - Because Odin is still in development, DragText's
      performance in that environment may not be as reliable or
      trouble-free as it is with native OS/2 programs.

  DragText - If both the source and target windows belong to the
      same process, DT will not release the memory used to hold the
      system's d&d data structures until the it begins its next drag
      from that process.  This ensures compatibility with the WPS's
      implementation of drag and drop.

  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.  See the Help file for
      additional details.

  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.

  Lotus Notes v4.6 - a user reports that dragging an attachment from
      Notes over a VIO window and then over the Desktop causes the
      system to lock up.  I've been unable to locate a copy of that
      version, so this problem remains unresolved.

_______________________________________________________________________

 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.  Registration is $20 for checks drawn in US dollars on a
bank in the United States.  For checks drawn in other currencies,
the cost is the equivalent of $25 after conversion.

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:         1-800-414-4268 (orders)
                 1-910-792-9100 (orders & inquiries)
                 8:30am - 9:00pm EST (-5 UTC), Mon - Fri

  Fax:           1-910-792-1889

  Email:         orders@bmtmicro.com

  Web:           http://www.bmtmicro.com/BMTCatalog/os2/dragtext.html

BMT Micro accepts Visa, Mastercard, Discover, American Express,
JCB, and other major cards as well as money orders, cashiers checks,
and personal checks.  Personal checks are subject to clearance. 

________________________________________________________________________

 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, and
may package it with both noncommercial and commercial software
products provided:
    -  the recipient agrees to the terms of this license, 
    -  you transfer DragText as a whole and intact, and
    -  there is no additional 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 drgtxt37.zip contains:

  1. drgtxt37.001    Oct 22, 2002    03:07:00
  2. drgtxt37.002    Oct 22, 2002    03:07:00
  3. drgtxt37.003    Oct 22, 2002    03:07:00
  4. drgtxt37.004    Oct 22, 2002    03:07:00
  5. drgtxt37.005    Oct 22, 2002    03:07:00
  6. drgtxt37.006    Oct 22, 2002    03:07:00
  7. drgtxt37.007    Oct 22, 2002    03:07:00
  8. drgtxt37.008    Oct 22, 2002    03:07:00
  9. drgtxt37.009    Oct 22, 2002    03:07:00
 10. dtreadme.txt    Oct 22, 2002    03:07:00
 11. dtsetup.exe     Oct 22, 2002    03:07:00
 12. dtsetup.txt     Oct 22, 2002    03:07: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

      OverDrag

________________________________________________________________________

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     
  Ĵ
  Text Link   text     Ctrl-Shift Enter         open selected filename    
  Open        windows                           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. 

________________________________________________________________________

 OverDrag
________________________________________________________________________


 This table identifies: 

      What it's called (Feature) 
      What to press (Mouse / Keyboard) 
      What it does (Description) 

  Ŀ
  Feature  Mouse /    Description                     
           Keyboard                                   
  Ĵ
  Raise    Up arrow   moves the window under the      
                      pointer to the top              
  Ĵ
  Lower    Down arrow moves the window under the      
                      pointer to the bottom           
  Ĵ
  Rotate   Space bar  cycles through all windows under
                      the pointer.  The top window is 
           Button 3   sent to the bottom and the next 
                      window is surfaced.             
  Ĵ
  Auto     'A' key    turns auto-raise on and off     
                      during d&d without changing the 
                      default setting                 
  Ĵ
  Scroll   Page up    scrolls the window under the    
           Page down  pointer by one page             
  Ĵ
  Minimize Win key    minimizes or hides the window   
                      under the pointer               
  Ĵ
  Restore  Win key    restores a window minimized to  
                      the Desktop                     
  Ĵ
  Redisplay'D' key    redisplays the window under the 
                      pointer                         
  Ĵ
  Open     Enter      opens the folder icon under the 
  folder +            pointer                         
           Button 1                                   
  Ĵ
  Surface  Enter      brings an open object's default 
  object +            view to the top (including      
           Button 1   objects in the MinWin viewer)   
  Ĵ
  Open     Enter      over a window's SysMenu button, 
  parent +            opens the window's parent folder
           Button 1                                   
  Ĵ
  Expand   Enter      over a collapsed branch in Tree 
  branch +            view, expands that branch       
           Button 1                                   
  

  +   Extended feature, requires registration.
   
________________________________________________________________________
__________________________________________________________________________


Rich Walsh  <dragtext@e-vertise.com>
Ft Myers, FL

October 22, 2002

__________________________________________________________________________
__________________________________________________________________________
