________________________________________________________________________

    DragText version 3.9

    A Distinctly Different Desktop Enhancement

    (C) Copyright 1994-2003,2007 RL Walsh  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
       -  New
       -  Changed
      Bugs and Limitations
      License Agreement
      File List
      Feature Summary
       -  Drag
       -  Drop
       -  Related Features
       -  OverDrag

________________________________________________________________________

Introduction
________________________________________________________________________


DragText v3.9 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.

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 drag,
  you can click the mouse or press a key 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) through Mensys (os2.mensys.nl) or BMT Micro (www.bmtmicro.com).
As always, upgrades are free for registered users (reregistration is
greatly appreciated).

________________________________________________________________________

Install / Remove
________________________________________________________________________


Run DTSetup to install DragText v3.9.  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.9 in a *new*
directory.  It should be able to copy your existing settings and
registration info.

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

________________________________________________________________________

New and Revised Features
________________________________________________________________________


New
---
DragText v3.9's primary new feature is NLS support.  It uses the
'Lang' environment variable to determine the correct language,
then loads the appropriate language support DLL, if available.

Translation is easy and no special tools are needed.  Open the new
'DTNLS' subdirectory & translate the English phrases in 'dt39_xx.txt'.
Then run 'dt39_xx.cmd' and identify your language.  The REXX script
will create a support dll and copy it to the main directory for
immediate use.  A complete description of the process can be found
in 'dt39_xx.txt'.


Changed
-------
Odin support has been removed from this version.  Existing support
no longer worked with later versions of Odin and could not be
easily fixed.

Several trivial bugs have been fixed.

________________________________________________________________________

Bugs and Limitations
________________________________________________________________________


OverDrag - On slower or heavily loaded systems, windows may
    not be repainted completely after being raised or lowered.
    To force an update, use the Redisplay hotkey (letter 'D'
    by default).  When the drag concludes, the screen will be
    updated automatically.

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.

________________________________________________________________________

 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 may 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 drgtxt39.zip contains:

  1. drgtxt39.001           2008-01-01      03:09:00
  2. drgtxt39.002           2008-01-01      03:09:00
  3. drgtxt39.003           2008-01-01      03:09:00
  4. drgtxt39.004           2008-01-01      03:09:00
  5. drgtxt39.005           2008-01-01      03:09:00
  6. drgtxt39.006           2008-01-01      03:09:00
  7. drgtxt39.007           2008-01-01      03:09:00
  8. drgtxt39.008           2008-01-01      03:09:00
  9. dtsetup.exe            2008-01-01      03:09:00
 10. dtsetup.txt            2008-01-01      03:09:00
 11. dtreadme.txt           2008-01-01      03:09:00

 12. dt39_de.dll            2008-01-01      03:09:00
 13. dtsetup_de.txt         2008-01-01      03:09:00
 14. dtreadme_de.txt        2008-01-01      03:09:00
 15. dt39_fr.dll            2008-01-01      03:09:00
 16. dtsetup_fr.txt         2008-01-01      03:09:00
 17. dtreadme_fr.txt        2008-01-01      03:09:00
 18. dt39_it.dll            2008-01-01      03:09:00
 19. dtsetup_it.txt         2008-01-01      03:09:00
 20. dtreadme_it.txt        2008-01-01      03:09:00
 21. dt39_nl.dll            2008-01-01      03:09:00
 22. dtsetup_nl.txt         2008-01-01      03:09:00
 23. dtreadme_nl.txt        2008-01-01      03:09:00
 24. dt39_sv.dll            2008-01-01      03:09:00
 25. dtsetup_sv.txt         2008-01-01      03:09:00
 26. dtreadme_sv.txt        2008-01-01      03:09:00

 27. dtnls39\dt39_xx.txt    2008-01-01      03:09:00
 28. dtnls39\dt39_xx.cmd    2008-01-01      03:09:00
 29. dtnls39\dtnls39.h      2008-01-01      03:09:00
 30. dtnls39\dtnls39.rc     2008-01-01      03:09:00
 31. dtnls39\dtnls39.dll    2008-01-01      03:09: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

2008-01-01

________________________________________________________________________
________________________________________________________________________

