***********************************************************************

    DragText - version 2.5
    The Drag and Drop Enabler for OS/2
    (C) Copyright R L Walsh 1994 - 1997  All Rights Reserved

***********************************************************************

    DTReadMe.Txt - quick start info for DragText

***********************************************************************


      C O N T E N T S
    ====================
    -  What It Does
    -  Installation
    -  Using DragText
    -  New Features in v2.5
    -  Known Problem
    -  Registration
    -  License Agreement
    -  File List


This program is licensed to you under the provisions of the License
Agreement included in this file and in the Online Help.  Use of this
program constitutes your acceptance of that Agreement.


***********************************************************************

WHAT IT DOES
============

DragText v2.5 lets you handle text in windows, files, and the clipboard
like objects that can be copied, moved, saved or deleted using drag and
drop.

Drag text from PM and VIO windows to:
 -  the same or other windows
 -  the Desktop or a folder to save it as a DTFile or Url object
 -  the DragText Clipboard object (DTClip)
 -  the Shredder
 -  a DTFile's icon to append it to that file
 -  program objects to open them
 -  your Web browser if the text is a Url
 -  your printer

Drop a file or folder into a PM or VIO window to:
 -  enter its name
 -  insert a file's text
 -  list a folder's contents.

DragText works with many popular programs such as editors, emailers,
and other internet apps.  DragText's Basic features are yours free
for unlimited use.  Its Extended features are yours to try for 6 weeks.
Continued use costs only $20(US) by mail or through BMT Micro ($15-$18
before Jan 1, 1998).  If not registered, the Extended features will
cease working after your free trial period expires.


***********************************************************************

INSTALLATION
============

Run DTSetup to install DragText v2.5 and enable your 6-week free
trial of DragText's Extended features.  It will copy files, create
objects, and advise you of any restrictions imposed by your system.
After a successful installation, you can load DragText v2.5 and use
it immediately.  DTSetup can be used later to uninstall DragText.

Refer to DTSetup.Txt for a full description.


***********************************************************************

USING DRAGTEXT
==============

Run DragText at startup to load it.  It will remain in memory until
you reboot, but it will NOT appear in any task or window list.

Run DragText again to open its Options Notebook whenever you need to:
 - set its options and defaults
 - disable it for a specific program
 - review runtime statistics and error messages
 - read the online Help
DragText's help window has 'Forward' and 'Back' buttons to make
browsing it easier.

DragText supports 7 types of window found in most PM apps:

    1)Single-line Entryfields   3)List boxes    5)Spin buttons          
    2)Multi-line Entryfields    4)Combo boxes   6)Static text
    7)System menu buttons

DragText also supports VIO (command line) windows via the clipboard
and includes mouse-initiated text marking/copying/pasting .

It uses 6 icons and 3 mouse pointers that change as you drag text
and files to identify what will happen if you drop at that point.

-Press and hold CTRL to select a copy operation (this is the default);
-press and hold SHIFT to select a move operation;
-press and hold ALT to insert a file or folder's contents into a
 multi-line entryfield;
-press and release INSERT to toggle between insert and replace mode
 in single-line entryfields only.
Most defaults can be changed from the Options Notebook.


Dragging Text
-------------
Highlight the text, then begin dragging from anywhere within the
window.  You do not have to point at the selection nor does it have
to be visible (e.g. in an MLE, you can scroll it out of view).

Drag text between windows:
 - drag it to the target window
 - position it using the I-beam mouse pointer (not the icon)
 - drop it

Create a DragText file or Url object:
 - drag it to the Desktop or any folder
 - drop it
A file's title will be based on the text, minus punctuation.
A Url objects's title comes from the Url, minus unnecessary words.

Drag all of the text in an editor or command line window:
 - drag from the window's system menu button (at the left end of
   the titlebar)
No highlighting is needed.


Dragging Objects, Files, & Folders
----------------------------------

Read a DragText file or Url object:
 - drag the file or object into ANY supported window
 - position it using the I-beam pointer
 - drop it
DragText treats its own files and Urls the same as dragged text.

Read any file:
 - drag the file into a multiline entryfield
 - use the I-beam pointer to position it
 - press the ALT key, then drop it

Drag the WPS object that opened a window:
 - press Ctrl-Shift
 - begin dragging from the window's system menu button
   (at the left end of the titlebar)
 - release Ctrl-Shift
 - drag to target, then drop it to create a shadow
   (press Shift or Ctrl to move or copy

List a directory's contents:
 - drag a folder icon into a multiline entryfield
 - use the I-beam pointer to position it
 - press the ALT key, then drop it

Enter a filename:
 - drag a file icon into any supported window
 - use the I-beam pointer to position it
 - drop it


***********************************************************************

NEW and REVISED FEATURES in v2.5
================================

DragText v2.5 adds two new uses for the system menu button (at the
left end of a window's titlebar), enhancements to existing file and
URL features, a revised Options notebook, workarounds to problems
caused by other programs, and of course, fixes for the three bugs
in v2.0.


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

 -  Full-text drag:  drag from the system menu button to get
    the entire contents of a command line or editor window.
    No highlighting is needed, and any existing highlighting
    will be unaffected.

 -  Object drag:  links a window to the WPS object that opened it.
    Dragging from any window's system menu button while pressing
    Ctrl-Shift is identical to dragging the linked object from
    its WPS folder.  The default operation is Shadow, but you can
    change this to Move or Copy by pressing Shift or Ctrl.

 -  Quick Help: selected items in DT's notebook provide a popup
    window offering a concise description of the feature and its
    options.


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

 -  Selectable styles and colors for DT's Options notebook;
    choose the style that you prefer:
     o "DragText" (top and side tabs),
     o "Warp v3" (all side tabs), or
     o "Warp v4" (the new notebook style with all top tabs).
    Use drag and drop to set the colors for the notebook's text,
    background, tabs, etc.

 -  VIO (text-mode) window support:  drags from VIO windows no
    longer use the clipboard;  drops into these windows still do.

 -  Enhanced URL handling:  DragText has always removed embedded
    and trailing spaces and line breaks from URLs.  It now removes
    leading and trailing quotes, periods, brackets, etc. as well.

 -  Additional filename option:  when dropping a file to insert its
    name, you can now press Shift to insert just its name without
    any path data.

 -  Improved codepage support for file titles:  DT now contains
    tables that identify the alphabetic characters in many codepages,
    including those for the Greek, Cyrillic, and Hebrew alphabets.

 -  Mystery text:  a minor addition that may let you insert some
    useful text when DragText doesn't recognize a program's private
    drag format.  If DT displays its "illegal" pointer, press Alt.
    If text is available, the icon will change to DT's "insert text"
    icon.  What that text is depends upon the source program and
    remains a mystery until you try it.

 -  Revised error message display in DragText.Exe:  error messages
    generated by the exe are now handled the same as dll errors:
    they are displayed on the DLL page of the Options notebook
    rather than in a popup window.


Workarounds
-----------

 -  PMMail v1.5x and v1.9x:  in some versions, dragging from
    an incoming email left remnants of PMMail's popup menu.
    DragText now dismisses all menus displayed by any program
    before beginning a drag.

 -  Netscape Navigator v2.02:  dragging from a VIO window to a
    browser window caused what appeared to be a system lockup.
    In fact, NS/2 was displaying an exception window that was
    completely invisible.  Navigator can not handle drags from
    windows created by secondary threads.  DT v2.0's VIO drags
    fit this description.  In v2.5, they originate directly
    from the VIO window, which is always created on thread 1.

 -  Netscape Navigator v2.02:  dragging from NS/2's browser
    window to a DT-enabled window within Navigator (e.g. the
    Location window) caused NS/2 to crash.  DragText's method
    for handling drops has been modified to accommodate this.


Bug Fixes
---------

 -  Some editors (e.g. System Editor, Text View) would refuse to
    save a modified file after dragging from their MLEs.  Making
    an additional change to the file was required to save it.

 -  DragText would handle dropped items that had already been
    handled by an app's native support if the item had previously
    been dragged over another DT-enabled window in the same program.

 -  DragText's background-drag feature interfered with popup menus
    in static class graphics windows if they were created as static
    text and then changed.  This only affected apps that do not wait
    until MB2 is clicked to display a menu.


***********************************************************************

KNOWN PROBLEM
=============

** Desktop Hangs at Startup **

Description
-----------
The system stops while setting up the Desktop.  Some of the programs in
your Startup folder may have run, and some icons may be visible on the
Desktop.  Ctrl-Esc may do nothing, or it may cause the WPS to crash and
restart with your icons misplaced.  This problem usually recurs with
every reboot.

Cause
-----
There are a *lot* of possible causes, including DragText.  The problem
is probably timing-related (e.g. DT gets installed before the WPS is
ready).

Solutions
---------

o Prevent the Startup Folder from Running
    Reboot.  When the screen switches to a colored background after
    the drivers have loaded, press and hold Ctrl-Shift-F1 until all
    the icons on your Desktop appear.  You can run the items in Startup
    manually, if desired.

    For unknown reasons, this often cures the problem.  The next time
    you reboot, the Desktop probably won't hang.

o Rearrange Objects in the Startup Folder
    In the Startup folder's WPS notebook, set the format for Icon view
    to 'Non-flowed', then turn off 'Always maintain sort order'.  When
    you open the folder, the objects will be arranged in a column in
    the order they're run.  You can rearrange them as needed.

o Delay DragText's Startup from Config.Sys
    Place the following line anywhere in config.sys:
      SET DTDELAY=30
    This will delay DT's startup for 30 seconds.  You can change the
    delay to any value from 0 to 300 (5 minutes).  After this delay,
    DragText will install itself.

    To prevent DragText from installing itself, enter this instead:
      SET DTDELAY=-1
    DragText will run but its drag and drop facilities won't be loaded.

    This entry should be deleted from config.sys after a sucessful
    startup.  Use DT's Options Notebook to set the delay.

o Delay DragText's Startup from its Options Notebook
    Run DragText.Exe to open its Options Notebook to the Basic->Misc
    page.  Under 'Other Options' select a startup delay from none to 90
    seconds.  The delay should be from the time objects in your Startup
    folder are run until your disk drives cease most activity.

    Warning!  Entering 'SET DTDELAY=' in config.sys will override the
    Notebook's setting.  Remove the entry from config.sys after a
    sucessful startup.

o Remove DragText from your Startup Folder
    This shouldn't be necessary with a suitable startup delay.  If you
    decide to run DT manually, be sure to reset the startup delay to
    'none'.


***********************************************************************

REGISTRATION
============

DragText's Basic features (dragging text between windows and entering
filenames) are free and require no registration.  Unregistered users
see a copyright message for 3 seconds at startup.

DragText's Extended features (File, Url, VIO, and Clipboard features)
require registration after your 6-week free trial ends.  To keep them
from becoming disabled, register DragText directly with the author or
through BMT Micro.  You will receive a registration number to enable
all features.


----------
- Direct -
----------

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

 o  U.S. Dollars ($20)
    ------------------
    Starting January 1, 1998, registration is $20;  for mail
    postmarked 1997, the cost is $15.  Your check must be 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.

 o  Other Currencies ($25)
    ----------------------
    registration cost is the _equivalent_ of $25(US) 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.  The additional cost covers my bank's fee for
    automated processing.  Your check will not be accepted if it
    converts to significantly less than $25, or if it requires
    special handling by my bank.

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

You can send email to:  rlwalsh@packet.net


-------------
- BMT Micro -
-------------

Starting January 1, 1998, registration is $20;  for orders
received in 1997, the cost is $18.

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

telnet:     bmt.wilmington.net

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,
    -there is no cost to the recipient other than the costs
     of providing media and transmission, and
    -it is not redistributed in conjunction with any software
     that may not also be freely redistributed by the recipient.

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

  1. drgtxt25.001    Nov 01, 1997    02:05:00
  2. drgtxt25.002    Nov 01, 1997    02:05:00
  3. drgtxt25.003    Nov 01, 1997    02:05:00
  4. drgtxt25.004    Nov 01, 1997    02:05:00
  5. drgtxt25.005    Nov 01, 1997    02:05:00
  6. drgtxt25.006    Nov 01, 1997    02:05:00
  7. drgtxt25.007    Nov 01, 1997    02:05:00
  8. dtsetup.exe     Nov 01, 1997    02:05:00
  9. dtsetup.txt     Nov 01, 1997    02:05:00
 10. dtreadme.txt    Nov 01, 1997    02:05:00
 11. dthelp.txt      Nov 01, 1997    02:05:00
 12. file_id.diz     Nov 01, 1997    02:05:00



***********************************************************************

Rich Walsh  (rlwalsh@packet.net)
Ft Myers, Florida

Nov 01, 1997

*** end of DTReadMe.Txt ***********************************************

