_______________________________________________________________________


                      - DragText version 3.3 - 

                 The Drag and Drop Enabler for OS/2*
               
                 (C) Copyright R L Walsh 1994 - 2000 
                         All rights reserved.
               
                              write to 

                       DragText@E-vertise.com

                              -- or --

                             Rich Walsh 
                          315 S. Barbour St 
                    Beverly Hills, Florida 34465 
                                U.S.A.


_______________________________________________________________________
_______________________________________________________________________

 DTHelp.Txt - the plain-text version of DragText's online Help.
_______________________________________________________________________
_______________________________________________________________________


 Contents
 ========

 Getting Started
     Installation / Removal
     Running DragText
     Frequently Asked Questions
     New and Revised Features in Version 3.3
     Bugs and Shortcomings

 Using DragText
     Dragging Text, Files, and Objects
     Using Pickup and Drop
     Icons and Pointers
     Supported PM Windows
     VIO Windows

 Options Notebook
     Basic Pages
     File pages
     VIO pages
     WPS pages
     Setup pages
     Info pages

 Workplace Shell Classes
     DTFile
     DTClip
     DTProgram

 About DragText
     Registration
     License Agreement

 Appendix:  Feature Summary
     Drag
     Drop
     Related Features


_______________________________________________________________________
_______________________________________________________________________

 Getting Started
_______________________________________________________________________
_______________________________________________________________________

 Basic Features
 DragText's Basic features are offered without charge and require
 no registration.

      Drag-and-Drop Text - Use drag and drop to copy, move,
       or delete the text found in standard edit windows, listboxes,
       etc. You can also enter a file's name by dropping its icon
       into a window.

      DTProgram - DTProgram is a comprehensive enhancement
       of the program object class with both general and drag &
       drop features.  Schedule objects to open automatically, set
       environment variables for any program, attach other objects
       to your programs, and more.
 
  Extended Features
  DragText's Extended features integrate text with files, WPS
  objects, and the clipboard, and add support for pickup-and-drop
  and VIO (command-line) windows.  They are offered as
  shareware and require registration for continued use.  See the
  section on Registration for details.

      Files and Urls - Drag text to a Workplace folder to create
       a DragText file;  it's title will be derived from the text. If
       the text is a URL, DT will create a Url object instead.
       Drop a DragText file or Url object on any supported window
       to insert its text.  You can also drop files from any source
       on many windows to insert their contents.

      Desktop Integration - Get direct access to WPS objects
       from almost any program using DragText's powerful WPS
       interface. Text Links lets you treat a filename or object ID
       like a shadow of the object it names. Window Links makes
       any window's System Menu button a shadow of the object
       which opened it. Both features let you drag the linked
       object, locate it, or use its menu.  DT complements these
       with Drop to Open:  drop an object on any System Menu
       button to open it, locate it, or show its menu.

      WPS Classes - DragText provides additional WPS services
       through the use of two optional classes. DTFile permits you
       to append text to an existing DragText file by dropping it on
       the file's icon. DTClip offers a drag and drop interface for
       the clipboard, plus DTSnip, an editor/viewer for both
       clipboard and dragged text.

      Pickup and Drop - Any window that lets you drag text also
       lets you pick it up so you don't have to keep MB2 pressed.
       Because DT copies your text and transfers it to the WPS for
       safekeeping, you can edit or close the source window
       without affecting your "lazy drag".

      VIO windows - Support for VIO windows is also included
       with the Extended features.  DT can drag text directly from
       these windows' video buffers, but it has to use the
       clipboard to drop text into them.  Full support for
       mouse-initiated marking, copying, and pasting is provided
       for your convenience.
 
  Compatibility
  DragText's features are available in nearly every program, but
  not necessarily in every window.  (See Supported PM Windows)
  It is designed to add its features only to windows which lack
  them and should never replace or interfere with the support
  provided by your applications unless explicitly instructed to do
  so.  If a conflict occurs, DragText can be partially or totally
  disabled for a specific program using the Disable page in the
  Options Notebook.


_______________________________________________________________________

 Installation / Removal 
_______________________________________________________________________

 Installation
 The installation program (DTSetup.Exe) will:

      move DragText's files to the directory of your choice
      create a program object for DrgTxt33.Exe and put it on your
       Desktop
      install the startup option you selected
      offer you the option of installing three Workplace Shell
       classes that provide some of DragText's features
      insert several entries in os2.ini to disable DragText for
       programs known to be incompatible
      insert entries in os2.ini to reenable DragText in programs
       that override it, and
      display some information specific to your system.
 
  If you are upgrading from a previous version, DTSetup will also
  transfer its settings and registration info to the new installation.

  Removal
  To remove DragText from your system, you can either:

      run DTSetup from your DragText directory and choose
       "Uninstall" to partially or completely remove it, or
      open DT's Options notebook to the Setup page and select the
       "Manual" Startup option so DragText no longer loads
       automatically
 
  DragText's WPS classes can also be installed or removed using
  the WPS page of the Options notebook. If you uninstall part or
  all of DragText, you will have to restart your system to remove
  it from memory if it was previously loaded.


_______________________________________________________________________

 Running DragText
_______________________________________________________________________
 
 DragText will be loaded into memory automatically during
 boot-up if you choose the Autoload Startup Option. Otherwise, it
 will be loaded the first time you run DrgTxt33.Exe, either from
 the WPS Startup folder or manually.  This first run will display a
 copyright message for 3 seconds, and then terminate. Regardless
 of how you load it, DragText will remain resident until you
 reboot and will not appear in any list of windows or tasks.

 All supported windows created AFTER DragText is loaded will
 provide drag-and-drop; those created before will not.  This is
 the primary reason for loading DragText as early as possible
 during startup.  Using Autoload will ensure that every possible
 window is DT-enabled.

 Running DrgTxt33.Exe after DT has been loaded will bring up its
 Options Notebook which has pages that let you:

      set options for the Basic features such as the default drag
       action
      enable and configure DragText's Extended features (File,
       Vio, and WPS features).
      Setup DragText's startup and compatibility options
      view Info about supported windows and the icons and
       pointers DragText uses
      get DLL info such as usage and errors, and
      review Product Information and enter your registration
       number
 

  Command-line Parameter
  DragText normally stores its INI file in the same directory as its
  EXE.  You can override this by specifying another directory as a
  command-line parameter.  The new path will be saved and used
  as the default until changed again.  You can also set this path
  from the Setup page of DT's Options notebook.

  Startup.Cmd
  Using Startup.Cmd to load DragText is no longer recommended,
  although it continues to work.  Instead, use the "autoload during
  boot" option available on the notebook's Setup page.


_______________________________________________________________________

 Frequently Asked Questions
_______________________________________________________________________

    1. Q:  Why can't I move the DTClip icon?

       A:  Dragging from this icon drags the clipboard's contents,
       not the object. To move/copy/shadow it, have Shift and/or
       Ctrl pressed when you begin to drag it.  See Moving and
       Copying DTClip for additional ways to manipulate the icon.

    2. Q:  Why doesn't DragText show up on my window list or
       task list?

       A:  DragText is NOT a task, process or window, so it won't
       appear in these lists.  Once you load it into memory (by
       running DrgTxt33.Exe), it stays there until you reboot.  (If
       you use Pstat or Watchcat, you will see DrgTxt33.Dll is in
       the list of dll's that have been loaded.)

    3. Q:  I completely disabled DragText for program X, but I can
       still drop text into program X's window.  Why doesn't
       Disable work?

       A:  You can only disable DragText for windows where
       DragText controls drag and drop.  You can tell when it is in
       control because the mouse pointer will include the letters
       "DT".  If you've enabled DragText's file-creation feature,
       you cannot prevent other programs from reading files it
       creates.  In this case, program X is in control and will let
       you transfer text using a DragText file.

    4. Q:  I set up my mouse so the left button is the "drag
       button", like in Windows.  How come I can't drag any text?

       A:  All the windows that DragText supports use the left
       button to move the cursor and select text.  These functions
       completely override any drag function assigned to this
       mouse button.  IBM would have to rewrite the software for
       these windows to change this.  You can still use DragText
       to insert a file's name or contents into a window.

    5. Q:  I tried disabling DragText for a program that runs in a
       VIO window, but I can still drag and drop from that
       window.

       A:  DragText supports the window, not the program whose
       output appears in it.  When you run that program, choose
       the DragText item in the window's System menu, then turn
       off drag, drop, and/or mouse marking.  See VIO Options for
       details.

    6. Q:  Why doesn't DragText work for one particular window in
       my program when it works for all the others.

       A:  There are at least two possible reasons:

           your program already supports drag and drop for this
            window;  since drag and drop isn't a visible feature,
            you may be unaware of it;
           the program may have installed some sort of special
            handling for this window that completely bypasses
            DragText.
       You may be able override this behavior and restore DragText
       functionality using the Reenable page of DT's Options
       notebook.

    7. Q:  How do I change the default icon for DragText files?

       A:  If you chose to install the "DTFile" WPS class, create
       an icon file named "MYFILE.ICO" and put it in your
       DragText directory.

    8. Q:  The Settings notebook for a DragText file shows three
       entries under "Current types".  Are they necessary?

       A:  Yes.  The first (",Plain Text," with commas before and
       after) works around an incompatibility between the
       Workplace Shell and the system's drag and drop functions.
       The second ("Plain Text") associates these files with your
       editor;  it also avoids problems when using System Editor.
       The third ("DragText") is used by the DTFile class and by
       DragText itself to identify these as DragText files.
 

_______________________________________________________________________

 New and Revised Features in Version 3.1
_______________________________________________________________________
 
 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
       other apps.

      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 content of your os2.ini.

      Url Handling - DragText has always been able to rejoin a
       Url split across several lines.  Now it handles Urls with
       embedded email/usenet quote marks (i.e. '>') as well. 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

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

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

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

  Other Changes

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

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

_______________________________________________________________________

 Bugs and Shortcomings
_______________________________________________________________________ 
 
      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.
 
      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
_______________________________________________________________________
_______________________________________________________________________
 
 When all features are enabled, DragText lets you use drag and
 drop to:

      copy, move, or delete text
      create files and Url objects
      insert the contents of a file or Url object in supported
       windows
      insert a file or WPS object's path in any supported window
      create a formatted listing of a folder's directory
      append text to existing DragText files
      copy text to and from the clipboard
      copy, move, or shadow WPS objects by name
      copy, move, or shadow WPS objects from the windows they
       open
      open, locate, or show the menu of any WPS object
 
  For a comprehensive list of DragText's features, see Appendix:
  Feature Summary

  To help you identify the results from a drag and drop operation,
  DragText uses up to nine icons and three pointers.  These
  results can be changed by using modifier keys or by setting
  DragText's default actions to suit your needs.  All of this is
  explained in detail in the following sections.

      Dragging Text, Files, and Objects

      Using Pickup and Drop

      Icons and Pointers

      Supported PM Windows

      VIO Windows

      Drag and Drop Summary
 

_______________________________________________________________________

 Dragging Text, Files, and Objects
_______________________________________________________________________
 
 Dragging Text
 To drag text out of any supported window, highlight it, 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).  To drag the entire
 contents of a Listbox, MLE, or VIO window without affecting
 your current selection, press Ctrl then drag. For single-line
 entryfields, begin dragging without highlighting any text.

 As you move the pointer over different windows, the icon and
 pointer will change to indicate what will happen if you drop the
 text at that point. For DragText-enabled windows, the text will
 be inserted into editable fields and matching text will be
 selected in listboxes and readonly spinbuttons (see restrictions
 below). You can delete text by dragging it to the Shredder.

 When the Extended features are enabled, dropping text into a
 Workplace folder will create a file, or a Url object if the text
 was a Url.

 You may also be able to insert text into a window that is not
 DragText-enabled if the program permits you to drop a file on it.
 In this case, DragText's "create a file" icon will be visible, not
 its "insert text" icon. You must have the Temporary Files option
 turned on for this to be successful.

 Dragging Files
 With the Basic features, you can drop a file or object into any
 supported window to insert its fully-qualified name (i.e. its
 complete path).  Shift-drop instead to insert its unqualified
 name. Using the Extended features, you can drop a
 DragText-created file into any window to insert its text.  You
 can also insert the contents of any file into an MLE or VIO
 window by pressing Alt before you drop it.  Alt-drop a folder in
 an MLE to insert a formatted listing of its directory.  The
 formatting is controlled by the settings on the Directories page
 (Files->Dirs) of the Options notebook.

 Dragging Objects
 With Window Links enabled, you can drag the WPS object that
 opened a window by dragging from that window's System Menu
 button. With Text Links enabled, you can drag objects named in
 text.  Highlight a filename, an object ID, or an object handle,
 press Ctrl-Shift, then drag.  In each case, the effect is identical
 to dragging this object from its folder.  The default drop action
 is "create a shadow", but you can change this to Move or Copy
 by pressing Shift or Ctrl when you drop the object.

 Restrictions:   While you can copy text from any supported
 window , you can only move or delete text from editable
 windows (i.e. those which aren't read-only or listboxes).
 Similarly, you can only move text into editable windows.  To
 comply with CUA standards, you cannot copy text onto itself;
 you can override this by pressing Ctrl before you drop. Also, you
 can only drop one file icon into a window at a time.


_______________________________________________________________________

 Using Pickup and Drop
_______________________________________________________________________
 
 When enabled, windows that let you drag text will let you pick
 it up as well by pressing Alt-MB2.  After you release the mouse
 button, your "lazy drag" will continue until you explicitly drop or
 cancel the pickup.

 This feature uses the WPS to work around a bug in all versions
 of Warp. DragText transfers a copy of your text to the WPS, then
 initiates the pickup from there.  As a result:
 -  you can edit or close the source window without affecting the
 text you've picked up
 -  a true 'Move' operation that deletes the original text is not
 possible - all drops are copies.  Despite this, DT offers 'Move'
 as an option to safeguard your pickup.  Without it, your pickup
 would be canceled rather than dropped if you accidentally pressed
 Shift-MB2.

 Usage
 DragText supports both pickup and drop for text and Urls only.
 While it is unable to pick up objects accessed through its WPS
 Link features, it does permit you to drop files and objects picked
 up using the WPS.  See below for details.

  Pickup    press Alt-MB2 in a DT-enabled window to pickup the
            selected text.
            press Ctrl-Alt-MB2 in a Listbox, MLE, or VIO window
            to pick up the entire contents of the window,
            regardless of highlighting.

  Drop      over a DT-enabled window, press either Ctrl-MB2 or
            Shift-MB2; both will insert a copy the text.
            over a WPS folder, press either Ctrl or Shift-MB2, or
            select either the 'Copy' or 'Move' option from the
            folder's menu;  any of these will copy the text to a
            file.

  Cancel    press Alt-MB2 over a DT-enabled window or an empty
            space in a WPS folder (e.g. the Desktop).

  Abort a Drop release Ctrl or Shift before releasing MB2.

  Test a Drop to see if a drop is valid, press and hold  Ctrl- or
            Shift-MB2. The "illegal" pointer will appear if it is
            invalid.  Release Ctrl or Shift before MB2 to abort the
            drop.
 
  Dropping Files and Objects
  Dropping a file or object you've picked up using the WPS is
  nearly the same as dropping one that was dragged the standard
  way.

      For objects other than files or folders, DT will always
       insert their full path and name, regardless of whether you
       use Ctrl or Shift-MB2.

      For files, DT will insert whatever it normally does by
       default: either the file's fully-qualified name or its contents.
       You can use Alt to toggle between 'insert name' and 'insert
       contents' but it's tricky!

         -  press and hold Ctrl-MB2
         -  now, press Alt as well
         -  finally, release MB2, then Ctrl-Alt

       Options to insert a file's unqualified name or directory entry
       are not available.

      For folders, DT always inserts the fully-qualified name by
       default. You can insert a formatted directory listing instead
       by pressing Alt, as described above.
 

_______________________________________________________________________

 Icons and Pointers
_______________________________________________________________________
 
 DragText uses mouse pointers to indicate whether DragText
 itself controls what will happen.  If it is in control, DragText
 will change icons as you drag to show what will happen if you
 make a drop.  When your drop creates a new file, DragText
 assigns the file a default icon.

 Pointers
 Whenever you drag text or a file over a window that DragText
 controls, the mouse pointer will always include the letters 'DT',
 and DragText will decide whether a drop is permitted.  If the
 pointer does not say 'DT', the program that owns the window is
 in control and it determines whether a drop is acceptable.  In
 this case, there is nothing DragText can do to prevent the
 program from accepting a drop.

 DragText uses three pointers:

            Insert - text will be inserted into editable fields; text
            will be matched and selected in listboxes and
            spinbuttons
            Replace - used only for single-line entryfields to
            indicate that dropped text will completely replace the
            current contents.  Press and release the Insert key in a
            normal fashion to toggle between insert and replace.
            Illegal - DragText will not permit a drop
 
  Drag Icons
  With all Extended Features enabled, DragText switches among
  six different icons. If only the Basic Features are enabled, it
  uses two.  This feature is disabled if you have one of the
  original versions of OS/2 Warp v3.0 because of a bug in them
  (see Change Icons for more information).

  DragText uses these icons:

            Text - text will be inserted into editable fields;
            matching text will be selected in listboxes and readonly
            spinbuttons [Basic and Extended features]. This icon is
            also used when you drag a DragText-created file over
            any DragText-enabled window [Extended features].

            Note:  if Change Icons is disabled, this is the only
            icon that will be used.
            File - this icon never appears over a DragText-enabled
            window.  Over the Workplace Shell, a drop will create
            a file; elsewhere, text will be transfered to the target
            program via a file [Extended features].
 
            Url object (not shown here) - if the text you are
            dragging is a URL, this icon appears after you leave a
            DragText window.  Over the Workplace Shell, a drop
            will create a WPS Url object; elsewhere, text will be
            transfered to the target program via a file [Extended
            features].
            File Name - when you drag a file or folder over a
            DragText window, this icon replaces the original to
            show that the file or folder's fully qualified name will
            be inserted [Basic and Extended features].
            File Contents - appears only when dragging a file
            over a multiline entryfield (you may have to press the
            Alt key).  The file's contents will be inserted [Extended
            features].
            Folder Contents - appears only when dragging a
            folder over a multiline entryfield (you must press the
            Alt key).  A listing of the folder's contents will be
            inserted [Extended features].
            Locate object - appears when you drag a file or WPS
            object over a system menu button.  It indicates that
            DragText will locate the object and open the folder
            containing it.
            Open object - appears when dragging a file or WPS
            object over a system menu button (you must press the
            Alt key). If you drop it, DragText will open the object.
            Show object's menu - press Ctrl while dragging a
            file or WPS object over a system menu button.  If you
            drop it, DragText will display the object's popup menu.
 

  File Icon
  The default icon assigned to files DragText creates is the same
  as the file icon shown above.  To avoid wasting disk space,
  DragText files share a single icon which is supplied by the
  DTFile WPS class.  You can change the default to an icon of
  your choice by creating an icon file named "MYFILE.ICO" and
  putting it in your DragText directory.


_______________________________________________________________________

 Supported PM Windows
_______________________________________________________________________
 
 DragText works with seven commonly-used types of windows
 found in most every application.  They may be used as the app's
 main window, or only in its dialogs and notebooks.  An example
 of each window appears on the Info page in the Options
 Notebook

 DragText also supports VIO (command-line) windows as an
 Extended feature. Refer to VIO Windows for details.

 Entryfield
 usually contains a single piece of information, such as a
 filename.

      to drag the entire contents, don't highlight any text, just
       drag
      to replace the entire contents, quickly press and release the
       Insert key while over the field.  The mouse pointer will
       change to show that you're in Replace mode.
 
  Note:  You can not drag text from "unreadable" entryfields
  (those which display asterisks rather than text).  You can still
  drop text on them.

  Multi-line Entryfield
  often used as the main text window in simpler apps such as the
  System Editor.

      insert the contents of any file by pressing the Alt key
       before you drop the file's icon.
      enter a formatted listing for a directory by pressing the Alt
       key before you drop the folder's icon (see Directories for
       details).
      drag all of the window's text without affecting the current
       selection by pressing Ctrl when you drag
 
  Listbox
  When you drag from a listbox, DT creates a list of the selected
  items with a newline between each entry.  Press Ctrl first to
  drag a list of every item.

  DT splits dropped text into lines, then searches for a matching
  entry for each line.  With single-selection listboxes, it stops
  after selecting the first match.  In multiple selection listboxes,
  it selects every matching item.  If no match is found, you'll hear
  a beep.

  DragText will never insert or delete text in a listbox.

  Combobox
  combines an entryfield with a listbox.  DragText handles each
  part as if it were a stand-alone window, with one exception. If
  the entryfield is read-only, dropping text on it will cause a
  search of the listbox for a matching entry, as described above.

  Spin Button
  combines an entryfield with a button.  If the entryfield part can
  be edited, it will be handled like a stand-alone entryfield.  If it
  is read-only, DragText will search for a matching item. If found,
  it will be displayed; otherwise, you'll hear a beep.

  Static Text
  used to display text that can't be edited, such as labels and
  error messages.  You can drag text from static text windows but
  you can never drop anything on them.

  System Menu Button
  the menu button at the left end of most titlebars can be used as
  a link to the WPS object that opened this window.  You can drag
  the linked object or click MB2 to show its menu.  When viewing
  files, you can also Ctrl-drag or Ctrl-click to access the viewer
  program's object.

  Titlebar
  drop text here to transfer it to a DTClip window

  Note:  You should be aware that some programs create their
  own window-types that closely resemble the standard ones.
  DragText may not support these look-alikes.


_______________________________________________________________________

 VIO Windows
_______________________________________________________________________
 
 Sometimes referred to as "text-mode" or "command-line"
 windows, VIO windows let OS/2 and DOS programs that were
 designed to use the full screen run on the Desktop in a window.
 Support for these windows is one of DragText's Extended
 features.

 When you drag text from a VIO window, DragText will read the
 selected text directly from the screen.  However, it will have to
 use the clipboard to drop text into these windows.  This is the
 only instance where DragText uses the clipboard.

 Refer to these sections for details on using DragText in VIO
 windows:

      Using Drag and Drop

      System Menu Options

      Mouse Marking

      Disabling DragText
 

_______________________________________________________________________

 Using Drag and Drop in VIO Windows
_______________________________________________________________________
 
 Drag
 Select the text to be dragged using either DragText's marking
 feature or another similar facility, then begin dragging.  To drag
 the entire content of a VIO window, don't highlight anything,
 just press Ctrl, then drag.

 Drop
 Text dropped on a VIO window is first copied to the clipboard,
 then pasted into the window at the current cursor location. For
 some OS/2 text-mode apps that offer mouse support, the cursor
 may move to the drop location.  Dropping a file inserts either its
 name or contents;  you can set the default on the Files->Other
 Files page in DragText's Options notebook.


_______________________________________________________________________

 System Menu Options in VIO Windows
_______________________________________________________________________
 
 DragText adds a new entry to the System Menu for VIO
 windows.  Choosing it displays a submenu that lets you turn
 these features on or off for that window only:

      Mouse Marking
      Drag
      Drop
 

  The initial settings for each window are controlled by the VIO
  page in DragText's Options notebook.


_______________________________________________________________________

 Mouse Marking in VIO Windows
_______________________________________________________________________
 
 DragText provides a mouse-initiated marking feature which
 operates like that included in Warp v4.0 but is somewhat more
 flexible.  You can choose whether to use mouse button 1 or 3 for
 marking, and whether a specific key must be pressed for it to
 become active.  These options are set using the Vio->Mouse
 Marking page in DragText's Options notebook.

 The only mouse action needed to use DragText is Mark.
 However, for your convenience, all of the standard mouse actions
 are supported:

  Mark      Press MB1 or MB3, then start moving the mouse.
            When you release the button, the text will remain
            marked, ready for it to be dragged.

  Copy      While marking (i.e. while MB1 or 3 is still down),
            press MB2.  The marked text will be copied to the
            clipboard and the highlighting will be removed.

  Paste     Press MB1 (or MB3) and MB2 at the same time.  The
            current contents of the clipboard will be pasted at the
            cursor location (not at the mouse pointer).
 

_______________________________________________________________________

 Disabling DragText in VIO Windows
_______________________________________________________________________
 
 DragText provides support for the window, NOT the program
 running in the window.  You cannot disable DragText for specific
 apps that run in a VIO window.  Use the Vio page of DragText's
 Options notebook to set VIO support on or off by default for new
 windows.  Then, override the default for a particular window
 from the 'DragText' item in its System Menu


_______________________________________________________________________
_______________________________________________________________________

 Options Notebook
_______________________________________________________________________
_______________________________________________________________________
 
 Whenever you need to change DragText's defaults or get help on
 using it, run DragText to open its Options Notebook.  There are
 six major sections:

   Basic       set the default actions for DragText's Basic features.

   Files       set options related to files, folders, and Urls

   Vio         control DragText's operation in command-line
               windows

   WPS         install DT's WPS classes and and enable its WPS
               features

   Setup       configure DragText's startup and compatibility
               options

   Info        get quick help, review error messages, enter your
               registration
 
  All settings take effect as soon as you close the notebook,
  change to another page, or press the "Apply" button.
 

_______________________________________________________________________

 Basic Pages
_______________________________________________________________________
 
 The three Basic pages let you set the default actions for
 DragText's Basic features which are available for all users.

      Basic

       Drag Defaults        should DragText move or copy text

       Drop Options         enable some handy options
 

      Miscellaneous

       Background Drag      drag from a window without bringing it
                            to the top

       Other Options        set DT's mouse pointer size;  enable
                            DT's distinctive error notification
 

      Style

       Set Colors           set colors for the notebook pages using
                            drag and drop

       Contents Window      control its appearance

       Size / Position      options that affect the notebook's
                            location
 
  All settings take effect as soon as you close the notebook,
  change to another page, or press the "Apply" button.


_______________________________________________________________________

 Drag Defaults
_______________________________________________________________________
 
 Between Windows
 when dragging text from one window to another, this determines
 whether the default action will be to copy or move the text

 Within a Window
 when dragging text from one part of a window to another, this
 determines whether the the text will be copied or moved

 These defaults can be overridden by pressing the Ctrl key (to
 copy) or the Shift key (to move) when you drop.

 Note:  In many situations, a move operation is not possible.  If
 the default is set to move, the text will be copied instead. If
 you explicitly request a move by pressing the Shift key, the
 operation will be refused.


_______________________________________________________________________

 Drop Options
_______________________________________________________________________

 Hilite Dropped Text
 When set to yes, DragText will highlight the text you drop into
 an editable window.  This permits you to repeatedly copy the
 same text, and makes it easier to move or delete text dropped in
 error.

 Entryfield Text
 When you drop text from another window into an entryfield (or
 the entryfield portion of a combobox or spin button), you can
 choose to have it:

      inserted into the existing text (the initial setting)
      completely replace the existing text (the recommended
       setting)
 
  When set to insert, DragText's 'I-beam' mouse pointer will be
  used.  When set to replace, the mouse pointer will change to an
  I-beam followed by three X's. (See Icons and Pointers) In use,
  press and immediately release the Insert key while over an
  entryfield to toggle between insert and replace.  You must be
  over a DragText-enabled window when you press Insert to avoid
  changing the system's global insert state.


_______________________________________________________________________

 Background Drag
_______________________________________________________________________
 
 Background Drag
 This option keeps a DragText-enabled window from coming to
 the top when you press mouse button 2 ("MB2", usually the
 right-hand button).  Enabling this feature will prevent the source
 of a drag from covering the intended target. Your choices are:

      disabled
      enabled
 
  You can disable this feature on a program-by-program basis
  using the Disable page.

 
  Important:

      This option affects all MB2 actions in DragText-enabled
       windows. If the window has a popup menu, clicking MB2
       will display the menu on top of all other windows but the
       window itself will remain partially covered.
      You can perform a drag even if the highlighted text is
       completely covered. Begin dragging from whatever portion of
       the window is visible.
      Some utility programs that add new functions to the mouse
       buttons may interfere with this DragText feature.
 

_______________________________________________________________________

 Other Options
_______________________________________________________________________
 
 Mouse Pointer Size
 You can choose whether DragText uses Normal sized I-beam
 and Illegal  mouse pointers or Large ones that may be more
 appropriate for high-resolution displays.

 Error Notification
 This determines whether DragText notifies you when it
 encounters an error. When set to beep, DragText will make a
 distinctive two-note beep. This is the initial and recommended
 setting.  When set to None, DragText will not notify you.

 In any case, the most recent error messages can be viewed on
 the DLL Info page.


_______________________________________________________________________

 Set Colors
_______________________________________________________________________
 
 Choose a color scheme for the notebook using drag and drop.

 Open a color pallete (usually in the System Setup folder), then
 drag a color to this area.  To set a background color, just drop
 it.  To set text color, press Ctrl, then drop.  Set the Contents
 window's colors and fonts by dropping them directly onto it.

 Default Schemes
 
      Color:  restores the default color scheme
      Gray:  sets the colors to gray backgrounds and dark blue
       text
 

_______________________________________________________________________

 Contents Window
_______________________________________________________________________
 
 Save on Exit
 When checked, DragText will save the state of the Contents
 window when you close the notebook.  When you reopen it, the
 last page you accessed will be restored.

 Icons and Lines
 These allow you to display or hide the Contents window's icons
 and lines.


_______________________________________________________________________

 Size / Position
_______________________________________________________________________
 
 Save on Exit
 When checked, DragText will save the notebook's size and
 position when you close it, and will restore these values when
 you reopen it.

 Save Now
 If you'd prefer to open the notebook with a fixed size and
 position, adjust it accordingly, then press 'Save Now'.  Don't
 forget to turn off 'Save on Exit'.

 Restore Default Size
 Reset the notebook to its original size.


_______________________________________________________________________

 File pages
_______________________________________________________________________
 
 Options on the six Files pages control DragText's handling of
 files, folders, and Url objects.

      Files
       enable file and Url handling and set filename formatting

      DragText Files
       should DT move or copy text when creating or reading DT
       files

      Other Files
       what should DT insert when you drop non-DT files

      Urls
       customize DragText's handling of Urls

      Directories
       filter and format DragText's directory listing options

      Temporary Files
       should DT create a temporary file whenever you begin a
       drag
 
  All settings take effect as soon as you close the notebook,
  change to another page, or press the "Apply" button.


_______________________________________________________________________

 Files
_______________________________________________________________________
 
 DragText's Extended features let you create and read files and
 Url objects using drag and drop.  The Files page offers some
 primary options for these features:

  Enable Extended Features - enable file and Url handling

  File and Url Titles - set filename formatting
 

_______________________________________________________________________

 Enable Extended Features
_______________________________________________________________________
 
 Enable DragText's file and Url handling features systemwide.

 Files
 
      create:  drop text on a folder or the Desktop to create a
       file whose name is taken from the text
      read:  drop files and Url objects on windows and objects to
       insert their contents
      disable:  turn off these features system-wide from here, or
       disable them for specific programs using the Disable page.
 
  Url objects
  DragText will create a Url object or file if the text you drop on
  a folder or the Desktop is recognized as a Uniform Resource
  Locator. DragText will remove any embedded spaces and newline
  characters, and will assign the object or file a name based on
  the Url.  If this feature is disabled, DragText will handle Urls
  like any other dragged text.


_______________________________________________________________________

 File and Url Titles
_______________________________________________________________________
 
 DragText files are given meaningful names based on the first
 few words of the text.  Url objects' names are based on the Url
 itself.  These options control how the will be formatted.

 Lines
 the maximum number of lines the title will use when displayed
 in a Workplace folder

 Chars
 the maximum number of characters in each line

 +/- Chars
 DragText can add or subtract this many characters to a line to
 avoid splitting a word in two

 Replace punctuation with
 this character will replace one or more consecutive spaces,
 punctuation, and control characters in file titles (but not in Url
 titles)

 Codepage Support
 controls how DragText decides if a character is a letter, number,
 or punctuation when creating file titles.  Leave this set to
 standard unless you switch between incompatible copdepages.

      standard:  if DT supports your codepage, it will use a
       built-in list of alphanumeric characters;  otherwise, it will
       use the generic method.
      ASCII:  only letters from the ASCII character set will be
       used (A-Z, a-z).  Accented characters and characters from
       non-Latin alphabets will be removed.
      generic:  DT will assume that characters which have both
       an upper and lowercase form are letters.
 
  DragText supports these alphabets and codepages:

       Latin:   437, 819, 850, 852, 1004
       Greek:   813, 869
       Cyrillic:   866, 878, 915
       Hebrew:   862, 916
 

_______________________________________________________________________

 DT Files
_______________________________________________________________________
 
 Creating a file:   the text used to create a file can be either
 copied or moved (i.e. deleted) from the source window.  Override
 the default by pressing Shift to move or Ctrl to copy when you
 drop the text.

 Dropping a DTFile:   when you drop a DragText file on a
 supported window, you can either copy or delete (i.e. move) the
 file.  You can override the default by pressing Shift to move or
 Ctrl to copy.


_______________________________________________________________________

 Other Files
_______________________________________________________________________
 
 When you drop a file DragText didn't create on one of these
 windows or objects, DragText will insert either the file's
 complete name or the file's contents. If it inserts the contents,
 DragText will replace all nulls with spaces and remove any
 trailing end-of-file (Ctrl-Z) character.  You can toggle these
 settings by pressing Alt when you drop the file.


_______________________________________________________________________

 Urls
_______________________________________________________________________
 
 If this feature is enabled, DragText will create a Url object or
 file if the text you drop on a folder or the Desktop is recognized
 as a Uniform Resource Locator.

 DragText will create a WPS object if either the WPUrl or
 WebExplorer_Url class is registered.  Otherwise, it will create a
 file that is functionally identical to an object, except for the
 class-specific settings notebook. Either can be dropped on most
 OS/2 Web browsers to load the Url.

  Url Identifiers     the prefixes DragText will recognize as URLs

  Title Options       create objects with meaningful names
 

_______________________________________________________________________

 Url Identifiers
_______________________________________________________________________
 
 When the beginning of your text matches one of these prefixes,
 DragText creates a Url object.  The default values are:  http://
 ftp:// https://
 You can add any identifier that your Web browser supports;  for
 example, you could add "gopher://". Separate each identifier
 with a space.

 DragText can also recognize incomplete Urls and fill in the
 missing identifier. Enter the identifier surrounded by angle
 brackets ('<' and '>'), followed by the letters DragText should
 try to match. The default values are:  <http://>www.
 <ftp://>ftp.
 Notice that each ends with a period:  this should keep DragText
 from misidentifying sentences beginning with these letters.


_______________________________________________________________________

 Title Options
_______________________________________________________________________
 
 DragText uses these options, plus its own rules, to format the
 Url as a title. They do not affect the object's contents.

 Remove from Hostname
 to provide shorter and more meaningful titles, you can have
 DragText remove unnecessary words from the hostname portion
 of the Url.  Each portion of the name, delimited by a dot or a
 slash, is compared to this list;  if it matches, the word is
 eliminated.  The wildcard characters '*' and '?' can be used.
 The default values are:  www* com net edu org ??
 Using "www*" will remove "www", "www1", "www-os2",
 etc.  Using "??" will remove all two-letter words, such as
 country identifiers (e.g. "ca" or "de").

 Line break after hostname
 when checked, only the hostname will appear on the first line of
 the title. Any path information will begin on the second line.  If
 the hostname is long enough to wrap to line 2, no line break will
 be added.

 Hostname only
 when checked, the Url title will include only the hostname.  No
 path information will appear in the title.


_______________________________________________________________________

 Directories
_______________________________________________________________________
 
 To insert a formatted listing of the files in a directory, drag a
 Workplace folder to a multiline entryfield, then drop it while
 pressing Alt. This listing will not include non-file objects (such
 as program objects or shadows).  This feature can be used to
 create simple command scripts, as shown in the Examples.

  Include             select the files and directories listed

  Formating           control how paths, filenames and dates are
                      formatted

  Meta-characters     the characters used to represent names, dates,
                      etc.

  Examples            creating a verbose listing and creating a
                      command file
 

_______________________________________________________________________

 Include
_______________________________________________________________________
 
 edit window
 like any request for a directory listing, this determines which
 files will be included.  The default is   *   which includes all
 files.  You could change this to "*.exe" to include only
 programs, or to "a*" to include only files whose names begin
 with the letter "a".

 Flags
 this lets you include or exclude files based on their standard
 attributes: Directory, Read-only, Archived, Hidden, and System.
 Plus ("+") includes files with that attribute while minus ("-")
 excludes files with the attribute. Equal ("=") requires a file to
 have the attribute to be included.  The default value of all pluses
 includes all files.  Setting the flags to "+D -R +A =H +S" would
 produce a listing of hidden files that weren't also read-only


_______________________________________________________________________

 Heading and Listing Format
_______________________________________________________________________
 
 Listing Format
 This sets the formatting for each file in the listing.  You can
 enter meta-characters (see below), fixed text, tabs, and carriage
 returns.  (Note: you must include a carriage return if you want
 each entry to appear on a separate line.)  The default value
 (followed by a carriage return) is:  %#  %d  %t %s %a %f
 If you erase the contents of this field, DragText will fill in the
 default value;  it cannot be left blank.

 Heading Format
 This produces a heading for your listing.  You may include fixed
 text, control characters, and the meta-characters for the path
 and file.  The file meta-character will be replaced by the search
 string.  If this field is left blank, no heading will be produced.


_______________________________________________________________________

 Meta-Characters
_______________________________________________________________________
 
 These represent the various components of a directory listing:

  %p        pathname as it appears on the disk with both upper and
            lowercase letters
  %P        pathname with all letters converted to uppercase
 
  %f        filename as it appears on the disk with both upper and
            lowercase letters
  %F        filename with all letters converted to uppercase
 
  %n        filename without its extension with both upper and
            lowercase letters
  %N        filename without its extension with all letters
            converted to uppercase
 
  %e        filename extension with both upper and lowercase
            letters
  %E        filename extension with all letters converted to
            uppercase
 
  %d        file date (same as %D) using your country's standard
            format
  %D        file date (same as %d) using your country's standard
            format
 
  %t        file time as HH:MM (plus AM or PM if you use a
            12-hour clock)
  %T        file time as HH:MM:SS (plus AM or PM if you use a
            12-hour clock)
 
  %s        file size to a maximum of 7 digits;  if the size is 10
            million or more, this field will contain 7 asterisks (i.e.
            "*******")
  %S        file size to a maximum of 10 digits
 
  %a        file attributes (including the directory flag) in
            lowercase letters
  %A        file attributes (including the directory flag) in
            uppercase letters
 
  %#        the sequence number of this entry, starting at 1
 
  %%        used to include a percent sign in your fixed text
 
  Note:  the pathname will not include a final backslash unless it
  is immediately followed by the filename


_______________________________________________________________________

 Examples
_______________________________________________________________________
 
  Example 1 - verbose listing
 
 [Heading]  Directory listing for %p
 [Listing]  File %F was created on %d at %T
 
 [Output]   Directory listing for C:\DrgTxt33
            File DRGTXT33.EXE was created on 04-22-00 at 03:30:00
            File DRGTXT33.DLL was created on 04-22-00 at 03:30:00
            [etc.]
 
 Example 2 - creating a command file
 
 [Heading]  cd %p
 [Listing]  ren %f %F
 
 [Output]   cd C:\DrgTxt33
            ren DrgTxt33.Exe DRGTXT33.EXE
            ren DrgTxt33.Dll DRGTXT33.DLL
            [etc.]
 

_______________________________________________________________________

 Temporary Files
_______________________________________________________________________
 
 These settings control whether DragText will create a temporary
 file every time you begin dragging text.  A temporary file is NOT
 needed to drop text on a folder or the Desktop to create a file.
 It is needed to drop text on: programs that will only accept a
 file; printer objects; and program objects (such as editors) to
 open them.  Because DragText uses a separate thread to create
 its temporary file, this shouldn't have a significant impact on
 overall performance.

 Create temp files
 
      always:  this is the most reliable setting for transferring
       text via a file, and is the default setting.  However, there
       will be background disk activity whenever you begin
       dragging text.
      Urls only:  a temporary file will be created only if the text
       is recognized as a URL.  This lets you drop Urls on your
       Web browser icon to open the program and load the Url, but
       avoids disk activity for other types of text.
      never:  this is the best setting if your apps will accept
       dragged text directly and you don't need to drop text on
       Workplace objects other than folders.
 
  File Name
  the name DragText uses when creating a file for any text other
  than a Url; it is reused every time you begin a drag.  The name
  must conform to the 8.3 naming convention.  The default value
  is:  DT_TEXT.

  Url Name
  the name DragText uses when creating a file for Url text; it is
  reused every time you drag a Url.  The name must conform to
  the 8.3 naming convention.  The default value is:  DT_URL.

  Path
  the disk directory where the temporary file is stored.  The
  default value is the directory where DrgTxt33.Exe is stored.

  Note:  If "Create temp files" is enabled, and you have the
  Workplace's "confirm copy" option set, a confirmation dialog
  will appear whenever you drop text on a folder or the Desktop.
  The file name shown will be that of the temporary file.
  However, the copied file will have a name based on the text or
  Url.


_______________________________________________________________________

 VIO pages
_______________________________________________________________________
 
 If VIO support is enabled, you can drag text and files into and
 out of these windows, subject to the settings on this page.  For
 details on DragText's VIO support, refer to VIO Window
 Overview

 
      Vio
       enable command line window support systemwide;  set
       defaults for newly opened Vio windows

      Mouse Marking
       enable DT's text-marking feature and control its operation
 

_______________________________________________________________________

 Vio
_______________________________________________________________________
 
 Enable Extended Feature
 Drag and drop text into VIO (OS/2 and DOS command line)
 windows.  For drags, DragText reads the selected text directly
 from the screen.  For drops, it uses the clipboard to paste the
 text.  To make marking VIO text easier, DragText offers a
 mouse-initiated marking feature similar to Warp v4.0 but more
 flexible.

 Drag & Drop
 Controls whether drag and/or drop is enabled for a VIO window
 when it is first opened.  Each VIO window has a DragText item
 in its System Menu that lets you change this setting for that
 window only.

 Mouse Marking
 Controls whether DragText's marking feature is enabled for a VIO
 window when it is first opened.  Each VIO window has a
 DragText item in its System Menu that lets you change this
 setting for that window only. Refer to Mouse Marking for details
 on how this feature works.


_______________________________________________________________________

 Mouse Marking
_______________________________________________________________________
 
 DragText provides a mouse-initiated marking feature that
 operates similarly to that included in Warp v4.0 but is somewhat
 more flexible.  DragText's marking feature will usually override
 other marking utilities that use the same combination of mouse
 buttons and keys.  Refer to Mouse Marking for details on how
 this feature works.

 Button
 Controls which button will be used for marking text.  Your
 choices are:

      mouse button 1 - usually the left mouse button
      mouse button 3 - the middle button on a 3-button mouse
 
  Keyboard
  Controls whether particular keys must be pressed along with the
  mouse button for DragText's marking feature to become active.
  This lets you avoid conflicts with both a VIO application's use
  of the mouse and with other marking utilities. Your options are:

      various combinations of Shift, Ctrl, and Alt - the selected
       key or keys must be pressed for DragText to take action

      no keys pressed - DragText will ignore the mouse action if
       Shift, Ctrl, or Alt are pressed

      ignore keyboard - DragText's marking feature will become
       active regardless of whether any keys are pressed.
 
  Remove last carriage return
  When checked, DragText will delete the carriage return that the
  system adds following the last line of text.


_______________________________________________________________________

 WPS pages
_______________________________________________________________________
 
 DragText provides three Workplace Shell classes, DTFile,
 DTClip, and DTProgram, plus WPS-integration features that
 operate independently of any class.

 DTProgram is a Basic (free) feature of DragText and is always
 enabled. The remainder are Extended features that require
 registration for continued use.  The WPS classes can be
 installed or removed at any time, regardless of registration
 status.

      WPS
       Install/Remove         install DragText's WPS classes
       Enable Classes         enable the WPS classes' features
 
      Window Links
       link windows to the objects that opened them
 
      Text Links
       link to files and objects named in text
 
      Drop to Open
       perform standard WPS actions using drag and drop
 
      Pickup and Drop
       drag text without having to keep MB2 pressed
 

_______________________________________________________________________

 Install/Remove Workplace Classes
_______________________________________________________________________
 
 When you turn to the WPS page, DragText checks to see if each
 class is currently registered. It then sets the button next to each
 name accordingly, either to Install or Remove

 Install
 DragText will attempt to register the corresponding WPS class.
 For DTClip, it will also attempt to create a Clipboard Object on
 the Desktop named "DTClip".  When complete, it will display a
 popup message window that says whether it succeeded or failed.

 If installation succeeds, the button will change to Remove. You
 may have to restart your system to have existing program
 objects and DragText files acquire the new features provided by
 DTProgram and DTFile.  This should not be necessary for
 DTClip.  Also, be sure the features provided by these classes are
 enabled (see Enable WPS Classes).

 If installation fails, the button may still change to Remove. If
 so, you should press it again so that Install reappears. The most
 likely reason for failure is that the required DLLs could not be
 found in your DragText directory (all of DragText's program files
 must be in the same directory as DrgTxt33.Exe).

 Remove
 DragText will display a message explaining what it is about to
 do, and will ask for confirmation.  If you press OK, it will
 attempt to remove the corresponding WPS class.  For DTClip, it
 will first try to delete the Clipboard Object it created when you
 installed this class. For DTFile, it will not delete any files.
 When complete, it will display a popup message window that
 says whether it succeeded or failed.  It is very unlikely that this
 will fail.  You may have to restart your system to remove
 DTProgram and DTFile from memory.


_______________________________________________________________________

 Enable WPS Classes
_______________________________________________________________________
 
 Clipboard Object
 If the DTClip class is registered, the clipboard object it creates
 can be used like any other DragText-enabled window.  You can
 either use the object's icon to drag and drop text to and from the
 clipboard, or you can open it to display a window that can be
 used as a clipboard viewer and editor.

 Recreating the Clipboard Object
 If you need to recreate your Clipboard Object (perhaps because
 you accidentally deleted it), turn to the Setup page of the
 notebook, then click on the 'DTClip' button toward the bottom of
 the page.

 DTFile append
 If the DTFile class is registered, text or a file can be dropped
 on a DragText file to append it to the existing contents.


_______________________________________________________________________

 Window Links
_______________________________________________________________________
 
 This feature lets you use a window's System Menu button as if
 it were a shadow of the object which opened the window.  You
 can drag the original object or display its menu.

 Drag linked object
 When enabled, Ctrl-Shift drag from a window's System Menu
 button to drag the object which opened that window.  The effect
 is identical to dragging the object from its WPS folder, except
 that the default drop operation is "create a shadow".

 Show object's menu
 When enabled, clicking MB2 (the drag button) on a window's
 System Menu button will display the menu of the object that
 opened the window.  The first item on this menu is the object's
 title; selecting it will locate the object and open the folder it's
 in.

 When you open a file, the menu that appear's belongs to the file
 object. To display the menu for the program being used to view
 the file, press and hold Ctrl while clicking MB2.

 Notes

      DragText does not provide menus for windows that are
       owned by the WPS, such as folders or notebooks.
      Some menu items don't work when using a Window Link
       menu;  in particular, any of the 'Create another' choices
       except "Default".
      Window links does not work with open URL objects due to a
       bug in the WPUrl class.
 

_______________________________________________________________________

 Text Links
_______________________________________________________________________
 
 This feature provides instant access to WPS objects directly
 from text.  You can highlight a filename, an object ID, or an
 object handle, then drag the named object or show its menu.

 Drag linked object
 When enabled, Ctrl-Shift drag a filename or object ID to drag the
 named object.  The effect is identical to dragging the object
 from its WPS folder, except that the default drop operation is
 "create a shadow".

 Show object's menu
 When enabled, press Ctrl-Shift, then click MB2 (the drag button)
 on a filename or object ID to display the named object's menu.
 The first item on this menu is the object's title; selecting it
 will locate the object and open the folder it's in.

 Search Paths
 Text Links should always work with fully-qualified filenames
 (i.e. names that include a drive and directory), valid object IDs
 (e.g. <WP_DESKTOP>) and object handles (e.g. "34C9B"), and
 entries in File Open/Save dialogs.

 For filenames that aren't fully-qualified, DragText first searches
 the directories listed in the edit window, then for most files,
 the directories included in your PATH statement.

 Edit Window
 Add paths to frequently accessed files and directories that don't
 already appear in your config.sys's PATH statement.  The default
 DT search path includes the current directory, its parent, the
 root directory of your boot drive, and the root directories of your
 other fixed disks.  You can remove some of these, but leave the
 reference to your boot drive in place to avoid undesireable
 results (e.g. opening the wrong copy of config.sys).

 search LIBPATH for DLLs
 If this is checked (and Extended features are enabled), DragText
 will use the LIBPATH in your config.sys for dll files.  To do so,
 DT has to open and read config.sys when it loads.  If this
 causes problems, uncheck this option;  otherwise leave it
 checked.

 
 Note:  Object handles are the numeric identifiers the WPS uses
 internally to track objects.  They appear in the 'Key' or 'Value'
 fields for many entries in os2.ini and os2sys.ini.  If your ini
 editor is DT-enabled, you can use Text Links to identify the
 object a given entry refers to.

 Default
 Resets DT's search path and rereads LIBPATH from config.sys.

 Apply
 Puts any changes into effect immediately and rereads LIBPATH
 from config.sys.


_______________________________________________________________________

 Drop to Open
_______________________________________________________________________
 
 Drop to Open
 This feature lets you use drag and drop to perform standard WPS
 actions.  When enabled, you can drop an object on any window's
 system menu button (at the left end of most titlebars) to:

  Keys
  pressed     Action
  none        open the folder containing the object
  Alt         open the object in its default view
  Ctrl-Shift  display the object's WPS menu
 
  Default Drop Action
  Select the default (no keys pressed) action when you drop any
  object except a folder on a system menu button:

      Locate object:  open the folder containing the object
      Open object:  open the object in its default view
 
  You can override the default by pressing Alt when you drop.  You
  can also display an object's WPS menu by pressing Ctrl when
  you drop, but you can not make this the default action.


_______________________________________________________________________

 Pickup and Drop 
_______________________________________________________________________
 
 Pickup text
 When enabled, windows that let you drag text will let you pick
 it up as well by pressing Alt-MB2.  After you release the mouse
 button, your "lazy drag" will continue until you explicitly drop or
 cancel the pickup.

 This feature uses the WPS to work around a bug in all versions
 of Warp. DragText transfers a copy of your text to the WPS, then
 initiates the pickup from there.  As a result:
 -  you can edit or close the source window without affecting the
 text you've picked up
 -  a true 'Move' operation that deletes the original text is not
 possible - all drops are copies.  Despite this, DT offers 'Move'
 as an option to safeguard your pickup.  Without it, your pickup
 would be canceled rather than dropped if you accidentally pressed
 Shift-MB2.

 Usage
 DragText supports both pickup and drop for text and Urls only.
 While it is unable to pick up objects accessed through its WPS
 Link features, it does permit you to drop files and objects picked
 up using the WPS.  See below for details.

  Pickup    press Alt-MB2 in DT-enabled window to pickup the
            selected text.
            press Ctrl-Alt-MB2 in a Listbox, MLE, or VIO window
            to pick up the entire contents of the window,
            regardless of highlighting.

  Drop      over a DT-enabled window, press either Ctrl-MB2 or
            Shift-MB2; both will insert a copy the text.
            over a WPS folder, press either Ctrl or Shift-MB2, or
            select either the 'Copy' or 'Move' option from the
            folder's menu;  any of these will copy the text to a
            file,

  Cancel    press Alt-MB2 over a DT-enabled window or an empty
            space in a WPS folder (e.g. the Desktop).

  Abort a Drop release Ctrl or Shift before releasing MB2.

  Test a Drop to see if a drop is valid, press and hold  Ctrl- or
            Shift-MB2. The "illegal" pointer will appear if it is
            invalid.  Release Ctrl or Shift before MB2 to abort the
            drop.
 
  Dropping Files and Objects
  Dropping a file or object you've picked up using the WPS is
  nearly the same as dropping one that was dragged the standard
  way.

      For objects other than files or folders, DT will always
       insert their full path and name, regardless of whether you
       use Ctrl or Shift-MB2.
      For files, DT will insert whatever it normally does by
       default: either the file's fully-qualified name or its contents.
       You can use Alt to toggle between 'insert name' and 'insert
       contents' but it's tricky!
         -  press and hold Ctrl-MB2
         -  now, press Alt as well
         -  finally, release MB2, then Ctrl-Alt
       Options to insert a file's unqualified name or directory entry
       are not available.
      For folders, DT always inserts the fully-qualified name by
       default. You can insert a formatted directory listing instead
       by pressing Alt, as described above.
 

_______________________________________________________________________

 Setup pages
_______________________________________________________________________
 
 The Setup pages let you configure DragText's startup and
 compatibility options:

      Setup

       Startup Options          choose how and when DragText will
                                be loaded

       Ini Path                 select an alternate location for DT's
                                ini file

       Create Desktop Objects recreate your DragText and DTClip
                                icons
 

      Compatibility

       Conflicts with
       Other Programs           when they say "RTFM", they mean
                                this page

       Disable                  disable part or all of DragText for a
                                particular program

       Reenable                 restore DragText's control of drag
                                and drop in supported windows

       Fixes                    Most users will never need to change
                                these settings.
 

_______________________________________________________________________

Startup Options
_______________________________________________________________________

 Every time you reboot, DragText's primary dll, DrgTxt33.Dll, has
 to be reloaded before it can begin providing its services. The
 Startup Options control how, when, and if this will happen.

 Changing your current Startup Option may cause DragText to
 update SYS_DLLS->LoadPerProcess in os2.ini and/or create or
 delete a program object in your WPS Startup folder.  Using
 Startup Options ensures that unneeded entries and objects are
 deleted.

      manually
       DragText will load the first time you run DrgTxt33.Exe or
       open its Desktop program object.  You can do this at any
       time - or not at all.  Windows already open will never be
       DT-enabled while new ones will be.  Selecting this option
       removes DT's entry from os2.ini and deletes its object from
       the Startup folder.

      WPS Startup folder
       DragText will create a program object in your WPS Startup
       Folder so that DT loads shortly after the WPS starts up.
       This option lets you DT-enable almost all of your programs
       while still providing an easy way to keep DragText from
       loading:  delete its startup object.  Selecting this option
       removes DT's entry from os2.ini and creates an object in
       the Startup folder.

      autoload during boot
       DragText will put an entry in os2.ini that causes the shell
       (pmshell.exe) to load DrgTxt33.Dll automatically shortly after
       the screen enters graphics mode.  This option ensures that
       every possible window is DT-enabled.  It also provides the
       greatest likelihood of compatibility with other system
       enhancements and with future versions of OS/2. Selecting
       this option adds DT's entry to os2.ini and deletes its object
       from the Startup folder.
 
  Note:  When you load DragText using its exe, you can prevent it
  from installing its features by pressing and holding Ctrl+Shift
  while it starts up.  DragText's Options notebook will open but
  most settings will have no effect.  You can still use the
  notebook to remove DT's WPS classes, change your Startup
  option, etc. Closing the notebook will completely remove
  DragText from memory.


_______________________________________________________________________

Ini Path
_______________________________________________________________________
 
 By default, DragText keeps its ini file in the same directory as
 its exe and dll files.  If this causes problems on your system
 (e.g. you don't have write-access to this directory), you can
 specify a different one.

 The Current path shows the location of the ini file that the
 notebook is using now.  The New path you enter here will be
 stored in os2.ini and used the next time you run DT. Entering
 your DragText directory, or simply erasing this field's current
 contents restores the default and erases the entry in os2.ini. If
 you press the 'Apply' button before you leave this page, you will
 be able to see whether DragText accepted your change or
 restored the default.

 Note:  Whenever you run DT, you can also use a command-line
 parameter to specify a new ini path.  The effect is identical to
 setting it here: the path is stored in os2.ini and used regardless
 of whether you continue specify it as a parameter.


_______________________________________________________________________

Create Desktop Objects
_______________________________________________________________________
 
 These buttons will create or recreate DragText's standard
 Desktop icons.

      DragText
       creates a program object for DragText whose object ID is
       <DT_DESKTOP>.  It is independent of the object that DT
       may create or delete in your WPS Startup folder
       (<DT_STARTUP>).

      DTClip
       creates an object of the DTClip WPS class whose object ID
       is <DT_CLIP>. To move or copy this object, press Shift or
       Ctrl before you begin dragging.  After the drag has started,
       you can release the key.
 

_______________________________________________________________________

Conflicts with Other Programs
_______________________________________________________________________

 DragText knows very little about the programs it works with and
 they know absolutely nothing about DragText.  Because of this,
 conflicts are possible - particularly with applications that have
 their own drag and drop functions.  DragText may interfere with
 an application, or in some cases, the application may interfere
 with DragText.

 DragText can usually tell when a program is handling drag and
 drop and avoids getting involved.  When this fails, you may get
 an error message or unexpected results.

 One way to eliminate this problem is to use the Disable page to
 disable part or all of DragText for that program.  It usually isn't
 necessary to disable DragText totally;  in most cases, disabling
 the particular type of window that is causing trouble will
 suffice.  You may find that disabling only drag or only drop for
 that window will solve the problem.

 A less obvious solution to conflicts may be the Reenable page.
 This lets DragText preempt an application's native drag and/or
 drop so it can provide these features.  Because DragText handles
 everything itself, the application never gets involved, eliminating
 the conflict.

 Unfortunately, some conflicts cannot be avoided.  After a drag
 begins, the source window has no control over where the object
 can be dropped.  This is controlled entirely by the target
 window. If the target thinks it can handle the object, it will
 accept it. Because the target has no reliable way to identify
 which program owns the source window, it can't accept drops
 from some programs but refuse them from others.  In other
 words, you can only disable the things that DragText controls:
 your ability to drag from and drop into particular windows,
 without regard for where the dragged object came from or is
 going to.

 The Disable and Reenable lists are checked when a program is
 launched, not during its execution.  If you need to add or revise
 settings for a running program, close it, make your updates, then
 restart the program.

 Note:  Many error messages arise from other problems in the
 system and are not directly the result of a conflict between
 DragText and your application program.


_______________________________________________________________________

Disable
_______________________________________________________________________
 
 Normally, DragText is enabled for all Presentation Manager-based
 (i.e. GUI) programs.  However, if it conflicts with an
 application's use of drag-and-drop, you can partially or totally
 disable DragText for that program.

 You cannot disable DragText for specific programs that run in a
 VIO (text-mode) window (e.g. TEdit).  If necessary, you can
 disable it for a particular VIO window from that window's
 System menu (refer to System Menu Options in VIO Windows for
 details).

 Program
 The "Program" section of the dialog contains a list of all
 applications that have restrictions.  To add a program, enter its
 name or drop its icon into the entryfield.  Path information is
 not needed and will be removed when you add this entry.

 Disable
 All of the window-types and features which can be disabled for
 a selected program appear here.  Initially, none of them are
 disabled. Check one or more boxes to partially or completely
 disable DragText for this application.

 Add / Remove button
 When you select a program from the list, this button displays the
 word "Remove".  Press it to delete the entry and reenable all
 DragText features for this program.

 When you add a new program to the list, the button changes to
 "Add". You must check at least one of the window or feature
 checkboxes before you can push it and add this program to the
 list.

 Notes:

      Restrictions are checked when a program is launched, not
       during its execution.  To add a restriction, close the
       application program, add the restriction, then restart the
       program.

      Only programs with restrictions are saved.  Programs whose
       settings match the default (no restrictions) will be dropped
       from the list.

      You can only disable file operations for DragText-enabled
       windows. These are windows where the mouse pointer
       changes to one of DragText's unique pointers (see Icons and
       Pointers for details).  You cannot prevent a program that
       accepts dropped files from accepting text rendered as a file
       or Url object. For example, if you drag a Url from a
       DragText window, you cannot prevent your web browser
       from accepting it because DragText does not control the
       browser's drag and drop features.
 

_______________________________________________________________________

Disabling DragText System-wide
_______________________________________________________________________
 
 DragText should continue to be supported in future versions of
 OS/2. Still, it is possible that unforeseen changes to the
 operating system will render DragText incompatible with a
 particular type of window. To retain the bulk of DragText's
 usefulness, you can disable that window type system-wide.

 On the Disable page, enter <ALL PROGRAMS> (the angle
 brackets are required). Uncheck both boxes for this window type,
 then press the "Add" button.  This option will be in effect for
 all newly launched programs;  those which are already running
 will not be affected.

 In extraordinary circumstances, you may find it necessary to
 disable DragText for all new windows in all programs.  To do
 this, follow the instructions above, but uncheck both boxes next
 to "All Windows".  In this case, DragText will be disabled for
 all new windows, including those created by programs that are
 already running.  Windows that already exist will not be
 affected.


_______________________________________________________________________

Reenable
_______________________________________________________________________
 
 When DragText interferes with a program, use the Disable page.
 When a program interferes with DragText, use this page to
 reenable DragText's features.

 Reenable is intended primarily for use with programs that
 disable DragText but add no drag and drop features of their own
 (e.g. the version of System Editor (e.exe) included in Warp v4.5).
 It can also be used in cases where you would prefer to use
 DragText rather than the program's native drag and drop (e.g.
 some editors and emailers). In some instances, using Reenable
 will resolve a conflict between DT and the host program that
 Disable can't fix (e.g. NewsReader/2).

 Reenable is a powerful feature but it adds some overhead and
 complexity to reenabled windows.  It should only be used where
 it is actually needed, and not for every window in every
 program. It only works in supported windows and can not add
 DT's features to other types of windows.

 Program
 The "Program" section of the dialog contains a list of
 applications that require this feature.  To add a program, enter
 its name or drop its icon into the entryfield.  Path information
 is not needed and will be removed when you add this entry.

 Reenable
 All of the window-types which can be reenabled for a selected
 program appear here.  Initially, none of them are reenabled.
 Choose only the windows that clearly require this feature for
 DragText to work properly. The most likely selection is
 "Multi-line EFs", since programs often modify these editor
 windows.

 Add / Remove button
 When you select a program from the list, this button displays the
 word "Remove".  Press it to delete the entry and remove
 DragText's special handling for this program.

 When you add a new program to the list, the button changes to
 "Add". It will be disabled until you check at least one of the
 window checkboxes.  Your new entry will not be saved until you
 press this button.

 Notes:

      Reenable settings are checked when a program is launched,
       not during its execution.  To add or change a setting, close
       the application program, update this page, then restart the
       program.

      Only programs with reenabled windows are saved.  Programs
       whose settings match the default (nothing checked) will be
       dropped from the list.
 

_______________________________________________________________________

Fixes
_______________________________________________________________________
 
 Most users will never need to change these settings.

  Startup Delay       use if the WPS hangs at startup

  Icons               control DragText's icon handling

  Misc                disable two other features:
                      file-handling in VIO windows, and
                      DT's 'All Text' function (i.e. Ctrl-drag)
 

_______________________________________________________________________

Startup Delay
_______________________________________________________________________
 
 If keeping DragText in your Startup Folder causes problems (e.g.
 the Desktop hangs), you can have DragText pause before
 installing itself.  Giving the WPS and other programs time to
 finish their initialization should eliminate any conflicts.

 Set this to None if you're not having problems.  Otherwise, see
 how many seconds pass from the time objects in your Startup
 Folder are run until your disk drives cease most activity.  Then
 select an equivalent Startup Delay.  For most systems, this
 should be 10 to 30 seconds.


_______________________________________________________________________

Icons
_______________________________________________________________________
 
 Change Icons
 This controls whether DragText automatically determines if it is
 safe to change the icon as you drag text or files over a
 DragText-enabled window. See below for a detailed explanation.
 Your choices are:

      auto-detect:  DragText will perform the check described
       below.  This is the default.
      yes:  change icons, regardless of the build level.
      no:  do not change icons, regardless of the build level.
 
  Details
  When you drag text or files over a DragText window, DragText
  can change the dragged icon to identify what will happen if you
  drop it.  However, a bug in all of the original releases of OS/2
  Warp v3.0 will cause the source application to crash if this
  feature is enabled.  The problem can be corrected by installing
  any available Warp v3 fixpack.  It is also fixed Warp in v4.x.

  At startup, DragText examines the "buildlevel" of PMMERGE.DLL
  to see if this fix is installed and then enables or disables this
  feature accordingly.  The results of its findings are displayed
  here (either auto-detect = yes or auto-detect = no). If DragText
  misidentifies the buildlevel, you can override it with this
  setting. To identify the buildlevel yourself, enter "ver /r" at an
  OS/2 command prompt. This feature should be enabled if the
  buildlevel is 8.232 or higher.

  Cache Icons
  DragText doesn't load an icon until it is needed.  It can then
  save it for later use or it can delete it to free up memory.
  Unless you run many programs simultaneously and are short of
  memory, you should probably leave caching enabled.

      yes:  leave icons in memory; this is the default.
      no:  delete the icon after use; this will free all icons,
       including those previously cached.
 

_______________________________________________________________________

Misc
_______________________________________________________________________
 
 VIO file handling
 Controls whether files can be created using text dragged from
 VIO windows, and whether existing files can be dropped in them
 to read the file's contents.  This is a global setting that affects
 all VIO windows.  This setting is here solely for completeness;
 it has no known use.

 All Text
 Pressing Ctrl when you drag from an MLE, Listbox, or VIO
 window will drag the entire contents of the window.  If this
 interferes with your work habits, you can disable this feature.


_______________________________________________________________________

 Info pages
_______________________________________________________________________
 
 The four Info pages provide information about DragText's usage
 and current status.  They contain no settings except for a place
 to enter your registration.

      Info
       practice your drag and drop using examples of each
       supported window

      Icons
       view each of the icons and pointers used as you drag text
       and files

      DLL
       review usage statistics and error messages

      DragText
       enter your registration number, review product info
 

_______________________________________________________________________

 DLL Info
_______________________________________________________________________
 
 The DLL Info page provides usage and error statistics for
 Drgtxt33.Dll.

 Usage
 The usage section shows the number of processes (programs)
 that have loaded Drgtxt33.Dll and the number currently using it.
 The latter figure will usually be at least 3 (two instances of
 pmshell.exe and DrgTxt33.Exe itself).

 Errors
 This section displays the total number of errors encountered
 during this session and the ID number of the last process to
 have an error. The text window displays the last 16 error
 messages in reverse order, with the most recent message first.

 When an error occurs, Drgtxt33.Dll will notify you if you choose
 this option on the Basic Features-> Misc page.  You can restart
 DrgTxt33.Exe and refer to this page to review the error message.

 Note:  None of these error messages are directly caused by user
 action. Rather, they report failures in DragText, other
 applications, or the operating system.  A few of them may help
 you identify conflicts with other programs, but most are
 meaningful only to the author.


_______________________________________________________________________

 Registration Information
_______________________________________________________________________
 
 After you register DragText you will receive a registration
 number.  Enter it on the last page (Info->DT) of the Options
 Notebook.  Enter your name exactly as it appears on your
 registration notice.  Close the notebook, then reopen it to reset
 your options.


_______________________________________________________________________
_______________________________________________________________________

 Workplace Shell Classes
_______________________________________________________________________
_______________________________________________________________________
 
 DragText uses three Workplace Shell classes, DTFile, DTClip,
 and DTProgram to provide additional features.

 DTFile

      lets you append text to an existing DragText file without
       having to open it
      assigns DragText files a unique icon that identifies them
 

  DTClip

      collect text from various sources in DTClip's editor
       windows by dropping the text on a titlebar or copying it to
       the clipboard
      use its icon as a drag and drop interface for the clipboard
 

  DTProgram

      a comprehensive enhancement of the WPS's Program Object
       class that offers both general-purpose and drag-and-drop
       features
 

  DTProgram is a Basic feature of DragText;  its enhancements
  are always enabled, even if DragText hasn't been loaded.  DTClip
  and DTFile are Extended features that require registration for
  continued use. DragText must be loaded before you can use them.

  All three classes can be installed or removed at any time,
  regardless of registration status.  If your free trial period for the
  Extended features has expired and you haven't registered
  DragText, you should remove DTFile and DTClip to avoid
  unnecessary system overhead.


_______________________________________________________________________

 DTFile
_______________________________________________________________________
 
 Files created by DragText become DTFile objects if this WPS
 class is installed.  Unlike a standard data file, you can drop text
 or another file on a DTFile's icon to append the new text to the
 end of the existing text. DragText must be loaded before you can
 use the append feature.  To identify them, DTFile objects share
 a default icon that doesn't change, regardless of any program
 associations.  You can replace this default icon with another if
 you wish.

 For additional information, refer to:

      Changing the DTFile Icon

      Using DTFile Append

      DTFile Append Options
 

_______________________________________________________________________

 Changing the DTFile Icon
_______________________________________________________________________
 
 To replace DTFile's default icon, create an icon file named
 MYFILE.ICO and place it in your DragText directory (i.e. the
 same directory as DTFile33.DLL).


_______________________________________________________________________

 Using DTFile Append
_______________________________________________________________________
 
 Drop text or a file on a DTFile's icon to add it to the file. The
 new text will be joined to the existing text according to the
 append options you select.  Refer to DTFile Append Options for a
 complete description.

 Important:  When dropping text or a file on an object's icon,
 the mouse pointer and the dragged image will not change the
 way it would over a DragText-enabled window.  However,
 standard DragText actions, such as pressing Alt to insert a
 dropped file's contents, will still work.


_______________________________________________________________________

 DTFile Append Options
_______________________________________________________________________
 
 Each DTFile object has two pages in its WPS notebook that
 control the way text or a file dropped on a DragText file icon
 will be joined to the existing text. The first page controls
 options for that file only. The second page sets system-wide
 options for all DTFile objects.

 Existing Text
 Controls whether any blank space following the existing text will
 be removed.  Null and end-of-file characters will always be
 removed, regardless of this setting.  Your choices are:

      remove trailing blank lines - lines containing only
       spaces, tabs, and newline characters will be deleted.  The
       last line of text will not be affected.
      remove trailing whitespace - all spaces, tabs, and
       newline characters after the last printable character will be
       deleted.  This is the default.
      do not edit - the file will be left as-is, except for trailing
       null and end-of-file characters.
 
  Separator
  Controls what text, if any, should be placed between the file's
  existing contents and the newly added text.

  edit window:   enter your separator text here exactly as it
  should appear in the file.  Blank lines in the separator will not
  be removed. If you don't want a separator, erase the entire
  contents of this window. If this window is too small for your
  needs, use another editor to format your separator text.  Then
  drag that text (or the file you saved it in) into this window.

  You can include the date and/or time of the append by entering
  these meta-characters in your separator text:

  %d        date (same as %D) using your country's standard
            format
  %D        date (same as %d) using your country's standard format
 
  %t        time as HH:MM (plus AM or PM if you use a 12-hour
            clock)
  %T        time as HH:MM:SS (plus AM or PM if you use a
            12-hour clock)
 

  Separator always on a new line:   checking this ensures that
  the separator always appears on the line following the existing
  text.  It will not add a blank line and will not have any effect if
  there is no separator.

  New Text
  Controls whether any blank space preceeding the new text will
  be removed. Null characters will always be changed to spaces,
  regardless of this setting. Your choices are:

      remove leading blank lines - lines containing only
       spaces, tabs, and newline characters will be deleted.  The
       first line containing printable text will not be affected.
       This is the default.
      remove leading whitespace - all spaces, tabs, and
       newline characters before the first printable character will
       be deleted.
      do not edit - the dropped text will be left as-is, except
       for leading nulls.
 
  New text always on a new line:   checking this ensures that
  the dropped text always appears on the line following the
  separator or existing text.  Otherwise, its position depends on
  whether the preceeding text ends with a newline character.

  Undo
  restore the settings that were in effect when the notebook was
  first opened

  Default
  On the first notebook page ("Options for This File"), resets this
  file's options to the system-wide defaults.  On the second
  notebook page ("DTFile Defaults"), resets the options to
  DTFile's built in defaults. When the defaults are already in
  effect, this button is disabled.


_______________________________________________________________________

 DTClip
_______________________________________________________________________
 
 DTClip's icon provides a drag and drop interface for the
 clipboard, while its windows  provides a "staging area" for your
 text handling. Collect text from various sources in a DTClip
 viewer window by dropping it on a titlebar or copying it to the
 clipboard, then edit and reuse it. New text can be appended
 before or after existing text, with an optional separator in
 between.

 The Options and Append pages in each object's WPS notebook
 control the default settings for any windows it opens.  Most of
 these can be changed for a window once it is open.  DTClip
 supports only text, not graphics.  DragText must be loaded before
 you can use this feature.

 For additional information, refer to:

      Using DTClip's Icon

      Using DTClip's Window

      DTClip as a Clipboard Viewer

      Moving and Copying DTClip

      Installing and Removing DTClip

      Notebook - Options page

      Notebook - Append page
 

_______________________________________________________________________

 Using DTClip's Icon
_______________________________________________________________________
 
 Drag from the object's icon to drag whatever text is on the
 clipboard.  DragText's standard text or Url icon will appear.  If
 the clipboard is empty or contains graphics, DTClip will beep
 and nothing will be dragged.

 Drop text or a file on the object's icon or window to copy it to
 the clipboard.  By default, the new text will replace any existing
 text.  To append the dropped text to the clipboard's existing
 text, quickly press and release Insert while over the object or
 window.

 Important:  When dropping text or a file on the object's icon,
 the mouse pointer and the dragged image will not change the
 way they would over a DragText-enabled window (e.g. DTClip's
 own window).  However, standard DragText actions, such as
 pressing Alt to insert a dropped file's contents, will still work.


_______________________________________________________________________

 Using DTClip's Window
_______________________________________________________________________
 
 Each DTClip viewer window operates independently once it is
 open; you can change its settings without affecting the object or
 other windows.  This lets you use one object to open multiple
 windows and assign a different function to each.  Alternately,
 you can create multiple DTClip objects with different default
 settings.

 Edit Window
 Text dropped on a titlebar and/or copied to the clipboard will
 appear in this window if the appropriate viewers are enabled.  It
 can be inserted before or after existing text, at the cursor, or it
 can replace existing text.  If enabled, a separator will be
 inserted whenever new text is appended to old.  The new text
 (but not the separator) will be highlighted so you can
 immediately drag it from the window.

 Menu
 All options which can be changed for this window appear on the
 menu. Any changes made affect only this window.  See Notebook
 - Options page and Notebook - Append page for descriptions of
 these options.

 Status bar
 This is an active status bar which lets you click on an item to
 change the setting it displays.  The status bar also provides
 buttons to Clear (erase) the window, and to Paste-append the
 contents of the clipboard.


_______________________________________________________________________

 DTClip as a Clipboard Viewer
_______________________________________________________________________
 
 When a DTClip window's clipboard viewer option is on, it will
 be updated automatically whenever the clipboard changes.  This
 option can be set independently for each DTClip window you
 open without affecting the status of other DTClip windows.

 Compatibility with Other Viewers
 OS/2 supports having only one viewer window at a time.  When
 a new viewer is established, the previous viewer no longer
 receives update notifications. However, DTClip and some other
 viewer apps such as ManyClip are designed to work around this
 restriction by forwarding the notification to the previous viewer.
 For DTClip, this is controlled by the "cooperate with other
 viewers" setting on the Options page of DTClip's notebook.
 When it is checked (the default), DTClip will forward the
 notification.

      OS/2 Clipboard Viewer utility - after starting this util,
       make DTClip the viewer.  It will forward notifications to
       the viewer util.

      ManyClip - ManyClip must always be the primary viewer.  If
       it is already running, click on its window immediately after
       making DTClip the viewer. This will restore ManyClip as the
       primary viewer and cause it to forward notifications to
       DTClip.
 

_______________________________________________________________________

 Moving and Copying DTClip
_______________________________________________________________________

 To copy, move, or shadow the object itself, have Ctrl and/or
 Shift pressed when you begin to drag.  Once DTClip's icon has
 begun to move, you can release these keys, if desired.  You can
 also move or copy the object by:

      using its menu options
      selecting other objects to be moved or copied at the same
       time
      performing these actions before DragText is loaded
 

_______________________________________________________________________

 Installing and Removing DTClip
_______________________________________________________________________
 
 DTClip can be installed or removed either by using the DTSetup
 program or by opening DragText's Options notebook to the WPS
 page and pressing the button next to DTClip.

 Each time you install DTClip, a Desktop object will be created;
 its WPS ID is "<DT_CLIP>".  Removing DTClip will explicitly
 delete this object.  Copies of it will not be deleted and may
 reappear if you later reinstall DTClip.

 If you need to recreate the Desktop object (e.g. you accidentally
 deleted it), simply remove the DTClip class, then install it
 again.  Restarting your system is not necessary.


_______________________________________________________________________

 Notebook - Options page
_______________________________________________________________________
 
 Most of these options control the default attributes for this
 object's windows and can be changed once a window is open.

 Titlebar drops
 When enabled, this object's windows will act as DTSnip
 viewers: text and files dropped on a titlebar will be inserted in
 its windows.  This attribute can be changed for any open
 window.

 open viewer when needed
 If titlebar drops are enabled, the object will automatically open a
 DTSnip viewer if one isn't open.

 Clipboard
 When enabled, this object's windows will act as clipboard
 viewers: text copied to the clipboard will be inserted in its
 windows.  This attribute can be changed for any open window.

 cooperate with other viewers
 if another clipboard viewer is active when DTClip becomes the
 viewer, DTClip will forward update notifications to the previous
 viewer when they are received.  If both DTClip and the other
 viewer start updating their windows continuously, turn this off.

 window visibility
 Keeps DTClip's windows from getting lost by ensuring that at
 least a portion of the window's text area is visible:

      float:  the window will check its visibility periodically and
       will move itself to the top if its text area is completely
       covered.
      rise:  the window will check its visibility whenever text is
       inserted, rising to the top if needed.
      normal:  the window will not check whether it is visible
 
  word wrap
  when enabled, no line of text will exceed the width of the
  window

  paste on open
  when enabled, the contents of the clipboard will be pasted into
  every viewer window when it opens, regardless of the clipboard
  viewer setting.

  Undo
  restore the settings that were in effect when the notebook was
  first opened

  Default
  use DTClip's built in default settings.  When they are already in
  effect, this button is disabled.


_______________________________________________________________________

 Notebook - Append page
_______________________________________________________________________
 
 Except for the separator text, these options control the default
 attributes for this object's windows and can be changed once a
 window is open.

 Viewer text
 When new text is sent to a viewer window, how should it be
 handled?

      insert after existing text
      insert at cursor
      insert before existing text
      replace existing text
 
  Dropped text
  When text is dropped directly on a viewer window, how should
  it be handled?

      handle like viewer text - the 'Viewer text' setting will
       control how dropped text is inserted
      insert normally - text will be inserted wherever you drop
       it
 
  Separator
  DTClip can insert one of several separators between old and new
  viewer text.  If the window is empty or set to "replace existing
  text" the separator will not be used.  Your choices are:

      insert text separator (the contents of edit window below
       will be used)
      insert blank line
      insert line break
      no separator
 
  Edit window
  The contents of this edit window will be placed between old and
  new viewer text if 'insert text separator' is enabled.  All
  windows opened by this object share this separator.

  Undo
  restore the settings that were in effect when the notebook was
  first opened

  Default
  use DTClip's built in default settings.  When they are already in
  effect, this button is disabled.


_______________________________________________________________________

 DTProgram
_______________________________________________________________________
 
 DTProgram is a Basic (free) feature of DragText that extends the
 WPS's Program Object class (WPProgram).  Most of its
 general-purpose and drag-and-drop enhancements are alway
 available and do not require DragText to be loaded.  You can
 install or remove DTProgram at any time by pushing a button on
 the WPS page of DragText's Option notebook, or by running
 DTSetup.Exe.

 With DTProgram installed, you can:

      add or modify environment variables for this program
      schedule programs for one-time or repeated execution
      add WPS objects to its Objects submenu for easy access;
       the program and working directories appear by default
      start multiple copies of a program without changing settings
      open multiple files in a single copy of a program
      use a drag & drop history list to reopen recently dropped
       files
      drop text on the object to open it with the text as a startup
       parameter
      use REXX to "drop" a file or text on the object
      close or kill programs from the icon that started them
 
  These features are described in detail in the following sections:

       Notebook pages
           Environment Page
           Schedule Page
           Objects Page
           Options Page
       Menus
           Open As submenu
           Objects submenu
           Close All menu item
       Drag and Drop
           Dropping Text on an Object
           Dropping Multiple Files
       REXX
           Setup Strings
 

_______________________________________________________________________

 Environment Page
_______________________________________________________________________
 
 This page has two separate uses, one for OS/2 programs and
 another for DOS and WinOS/2 programs.  See "Release Notes"
 for important limitations on this feature when used with with
 OS/2 programs.

 For OS/2 programs, it lets you customize the environment
 established by the SET statements in config.sys.  You can add
 new strings and modify existing ones.  You cannot delete
 existing variables, but you can usually get the same effect by
 setting them to some meaningless value.

 For DOS and WinOS/2 programs, it displays the non-default
 values set using the 'DOS Properties' or 'WinOS/2 Properties'
 button on the notebook's Session page.  You can use this to copy
 settings from one object to another.  Environment variables for
 DOS and WinOS/2 should be set in autoexec.bat; they cannot be
 set here.

 Add or Modify Environment Strings
 Enter strings in the edit window, one per line.  Each must be in
 the form 'VARIABLE=value' (e.g. TEMP=C:\MYAPP\TEMP).  The
 'SET' command that you would use elsewhere is not needed and
 will be removed. You can use substitution variables to merge
 new entries with existing variables.  For example,
 "PATH=c:\drgtxt33;%PATH%".

 Whenever you move the focus away from the edit window,
 DTProgram will examine each line and modify it, if necessary,
 to avoid invalid entries. For example, if you enter the word
 'HELLO' all by itself, DTProgram will change it to '?=HELLO'.
 'HELLO=' will be changed to 'HELLO=?'.

 Note:   In some cases, changing an existing variable may have
 no effect. For example, OS/2's online help system uses
 Presentation Manager's environment, not this program's, so
 changing the 'HELP=' path does nothing.


_______________________________________________________________________

 Schedule Page
_______________________________________________________________________
 
 Schedule this object to open automatically, either one time or on
 a regular basis.

 Open on Schedule
 When checked, the object is scheduled to open at the date and
 time shown.  This box must be unchecked to change any of the
 options on this page.

 Date and Time
 Shows when the object will next open.  These fields will be
 updated automatically if the 'Repeat' option is set.  To schedule
 this object, enter a date and time that is at least 20 seconds in
 the future.

 Repeat
 When checked, this object will be rescheduled every time it
 opens automatically.

 Interval
 Determines how often the object will be reopened.  This can be
 specified as a fixed interval, or as a daily, weekly or monthly
 event.

      after:  a fixed interval (1 second - 366 days)
      on the:  numbered day of the month (1 to 31). Objects
       scheduled for the 29th, 30th, or 31st will be opened on the
       last day of the month when necessary.
      every:  day, weekday, weekend day, day of the week, or
       week
      first:  day of the month that meets the criterion
      last:  day of the month that meets the criterion
 

  Skip if open
  When checked, the object will not be opened if it is already
  open. If unchecked, the results depend on the object's default
  open action:  either the open view will be surfaced or a new
  view will be opened.

  Skip if late
  If this object is scheduled to open while your system is off,
  DTProgram can either open it when the WPS starts (unchecked)
  or can skip it (checked). In either case, the object will return to
  its normal schedule if the 'Repeat' option is on.

  Undo
  Restores the settings in effect when you opened this object's
  notebook.

  Now
  Sets Date and Time to the current time plus 30 to 90 seconds.

  Next
  Adds the current repeat interval to Date and Time.

  Note:    DTProgram keeps scheduling records in os2.ini that
  should not be changed.  If they do not match the info stored by
  the scheduled objects, the record will be discarded and the
  object will not be opened.


_______________________________________________________________________

 Objects Page
_______________________________________________________________________
 
 Add and delete entries on the Objects submenu.

 Add up to 8 WPS objects of any kind by dropping them on the
 listbox. You can also enter an Object ID (e.g. <WP_SYSED>) or
 the full path of any file or directory, then press 'Add'.

 Add
 Adds the object whose name or Object ID was entered.  If the
 object cannot be found or is already on the list, the entry will be
 ignored. The 'Add' button has no effect when you drop an object
 on the listbox.

 Delete
 Deletes the currently selected object from the listbox.

 Undo
 Restores the settings in effect when you opened this object's
 notebook.


_______________________________________________________________________

 Options Page
_______________________________________________________________________
 
 Object ID
 Object IDs are names that can be assigned to objects to uniquely
 identify them.  These names are always surrounded by angle
 brackets, for example <WP_SYSED>  Assigning an object ID can
 be useful if you want to manipulate an object using REXX.

 The entryfield lets you view and edit the object's ID.  The 'Set'
 button puts your changes into effect.  You will be warned if the
 object's new ID is already assigned to another object.

 D & D History List

 The options here let you control the drag and drop history list
 that appears on the 'Open As' submenu.

 maintain list
 When checked, DTProgram will keep a list of the last 8 files
 dropped on this program object.  Unchecking this option prevents
 DTProgram from updating the list but does not clear any existing
 entries.

 clear list
 Pressing this deletes all entries currently on the list.  This may
 be desireable because the list can introduce a slight delay when
 displaying this object's menu.


_______________________________________________________________________

 Open As Submenu
_______________________________________________________________________
 
 New Window / Existing Window
 These menu entries let you override this object's default open
 action without changing it.

 'New Window' is always enabled.  It is checked if there are no
 open windows currently, or if the default is to open a new
 window every time.

 'Existing Window' is only enabled when this object is already
 open. It is checked if the default action is to activate an
 existing window.

 Drag and Drop History List
 Shows the last 8 files and directories dropped on this object.
 Selecting one of them is identical to dropping that file on this
 object once again.

 Scheduled Date and Time
 If you've set this object to open on schedule, the date and time
 when it will next open appears at the top of the menu.


_______________________________________________________________________

 Objects Submenu
_______________________________________________________________________
 
 The Objects submenu offers an easy way to open objects related
 to the current program.  Use it with DragText's Window Links
 feature to navigate the Desktop without having to open a folder
 or find an icon.

 The directory containing the program file, and the working
 directory (if any) always appear on the menu.  If there are files,
 folders, or other programs you frequently open along with the
 current program, add them to the menu using the WPS notebook's
 Objects Page.

 When Window Links is enabled, you can access this menu
 directly from any window this program opens. Just click (or
 Ctrl-click) MB2 on the window's system menu button.


_______________________________________________________________________

 Close All Menu item
_______________________________________________________________________
 
 Close all of this object's windows and programs from the icon
 that opened them.  Press Ctrl when selecting this item to kill
 any running programs.  This may allow you to terminate hung
 programs that have no entries in the window list.


_______________________________________________________________________

 Dropping Text on an Object
_______________________________________________________________________
 
 You can use DragText to open an object by dropping text on it;
 the dropped text will be used as a startup parameter.

 By default, the dropped text will be appended to any existing
 startup parameters with a space in between.  You can have the
 text inserted elsewhere by placing the '%*' substitution
 characters at the appropriate place(s).  DTProgram recognizes
 other substitution sequences (e.g. '%**F') but handles them the
 same as '%*'.  It ignores the single '%' intended to prevent
 startup parameters.


_______________________________________________________________________

 Dropping Multiple Files
_______________________________________________________________________
 
 When you drop several files on a program object, the WPS
 normally opens each file in a separate copy of the program.  The
 icon for each file is shown as being in use, rather than the
 program object.

 With DTProgram, you can also have a single copy of the program
 open all dropped files (if the program supports this).  To do so,
 press Ctrl-Shift when you drop them.  DTProgram will open the
 program object, passing the names of all dropped files as a
 single startup parameter.  Its icon, not the files', will be shown
 as being in use.

 The filenames will be joined with a space between each.  If any
 file's path contains a space, DTProgram will place quotes around
 it.  The resulting string will then be handled the same as
 dropped text, as described above.


_______________________________________________________________________

 Setup Strings
_______________________________________________________________________
 
 These can be used with the REXX functions SysCreateObject and
 SysSetObjectData to create and modify DTProgram objects.

 Drag and Drop functions
 
  DROPFILE     = fully-qualified filename
  Has the same effect as dropping the named file on this object:
  the file is opened using this program to view it.
 
  DROPTEXT     = string of up to 255 characters
  Has the same effect as using DragText to drop the text on this
  object:  this object is opened with the text inserted into the
  command line parameters.  See "Dropping Text on an Object" for
  more details.
 
  Schedule functions
  DTProgram assumes that all scheduling setup strings should be
  treated as a package.  If any one of them contains an error, none
  of them will be used.

  SCHEDULE     = ON | OFF
  Add/Remove this object to/from the list of scheduled objects
 
  DATE         = yyyy/mm/dd
  The next date that the object should be opened.  The year must
  have 4 digits, and the month and day must have 2 digits.
 
  TIME         = hh:mm:ss
  The next time that the object should be opened.  Taken with the
  date, it must be at least 20 seconds in the future.  Hours uses a
  24 hour clock (e.g. 1PM is 13);  hours, minutes, and seconds
  must all be 2 digits.
 
  REPEAT       = ON | OFF
  Set the object to reopen on a regular basis.  The year must have
  4 digits; the month and day must have 2.
 
  ALWAYSOPEN = ON | OFF
  If this object wasn't opened on schedule, open it as soon as
  possible thereafter;  otherwise, skip it.
 

_______________________________________________________________________
_______________________________________________________________________

 About DragText
_______________________________________________________________________
_______________________________________________________________________

 
                      - DragText version 3.3 -
                The Drag and Drop Enabler for OS/2*
 
               (C) Copyright R L Walsh 1994 - 2000
                          All rights reserved.
 
                               write to
                       DragText@E-vertise.com
                               -- or --
                             Rich Walsh
                          315 S. Barbour St
                    Beverly Hills, Florida 34465
                                 U.S.A.
 
 
                        Registering DragText
                         License Agreement
 
 * OS/2 and Presentation Manager are trademarks of International
 Business Machines Corp.


_______________________________________________________________________

 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.


_______________________________________________________________________

 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.


_______________________________________________________________________
_______________________________________________________________________

 Appendix:  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        drag from sysmenu             
  this window                                                      
  Ĵ
  Object being used   Sysmenu        Ctrl-drag from sysmenu        
  to view a file                                                   
  
 
  *   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       
 Ĵ
 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, 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    Sysmenu click MB2               show menu of object that
Link      button                          opened this window      
Menus             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    
Ĵ
Backgroundmost    actions using MB2       window won't activate or
Drag *    windows                         be 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.
 

_______________________________________________________________________
_______________________________________________________________________

