
__________________________________________________________________________



                        - DragText version 2.5 -
                  The Drag and Drop Enabler for OS/2*

                  (C) Copyright R L Walsh 1994 - 1997
                           All rights reserved





                                write to

                           rlwalsh@packet.net

                                -- or --

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


__________________________________________________________________________



__________________________________________________________________________
__________________________________________________________________________


    DTHelp.Txt
    ==========

    This file is the plain-text version of DragText's online Help.
    It is formatted for printing at 60 lines by 75 characters and
    should be viewed or printed in a non-proportional font.


__________________________________________________________________________
__________________________________________________________________________

    Contents
__________________________________________________________________________
__________________________________________________________________________


    Getting Started
    ---------------
        Installation / Removal
        Running DragText
        Frequently Asked Questions
        New and Revised Features in Version 2.5

    Using DragText
    --------------
        Dragging Text, Files, and Objects
        Icons and Pointers
        Modifier Keys and Defaults
        Supported PM Windows
        VIO Windows
            Using Drag and Drop in VIO Windows
            System Menu Options in VIO Windows
            Mouse Marking in VIO Windows
            Disabling DragText in VIO Windows

__________________________________________________________________________
__________________________________________________________________________

    Contents (continued)
__________________________________________________________________________
__________________________________________________________________________


    Options Notebook
    ----------------
        Basic Features
            Basic page
                Drag Defaults
                Background Drag
                Drop Options
            Miscellaneous page
                Icons and Pointers
            	Other Options
            Style page
                Style
                Colors
        Extended Features
            Extended page
                Enable Extended Features
                Install/Remove Workplace Classes
            File pages
                File and Url Titles
                Temporary Files
                File Handling Options
            Directory page
                Include
                Heading and Listing Format
                Meta-Characters
                Examples
            Urls page
                Url Identifiers
                Title Options
            VIO page
                Options
                Mouse Marking
        Disable
            Conflicts with Other Programs
            Disabling DragText for a Program
            Add a Program to the Restricted List
            Change a Program's Restrictions
            Remove a Program from the List
            Disabling DragText System-wide
        Info
            DLL Info
            Registration Information

__________________________________________________________________________
__________________________________________________________________________

    Contents (continued)
__________________________________________________________________________
__________________________________________________________________________


    Workplace Shell Classes
    -----------------------
        DTFile
            Changing the DTFile Icon
            Using DTFile Append
            DTFile Append Options
        DTClip
            Using DTClip's Icon
            Using DTClip's Window
            DTClip as a Clipboard Viewer
            Moving and Copying DTClip
            Installing and Removing DTClip
            DTClip Options

    About DragText
    --------------
        Registration
            Direct
            BMT Micro
        License Agreement


__________________________________________________________________________
__________________________________________________________________________

    Getting Started
    ---------------
__________________________________________________________________________


 Basic Features
 --------------
 DragText's Basic features add drag-and-drop text to many commonly used
 windows:  entryfields, listboxes, etc.  With DragText, you can copy or
 move text between these windows using drag-and-drop, delete text by
 dragging it to the Shredder, and enter a filename by dropping the file's
 icon into a window. The Basic features are offered without charge and
 require no registration.

 Extended Features
 -----------------
 DragText's Extended features provide seamless integration of text with
 files, directories, Url objects and other WPS objects, VIO (OS/2 and
 DOS command-line) windows, and the Clipboard.

 Drag text to a Workplace folder to create a file whose title is derived
 from the text.  If the dragged text is a URL, DragText will create a Url
 object.  Drop DragText files and Url objects on any supported window to
 recover the text.  You can drop a file from any source on a multiline
 entryfield, VIO window, or DragText's clipboard object to insert its
 contents.

 This version of DragText extends its WPS integration with the intro-
 duction of Object Drag.  Pressing Ctrl-Shift, then dragging from the
 system menu button of most any window will drag the WPS object that
 caused the window to open. The effect is identical to dragging the
 object from its WPS folder.  This feature does not require any new
 WPS classes.

 The Extended features provide additional WPS services through the use
 of two optional classes. DTClip offers a drag and drop interface for
 the clipboard.  You can use the object's icon directly, or open it to
 display a window that can be used as a clipboard viewer and editor.
 DTFile permits you to append text to an existing DragText file by
 dropping it on the file's icon.

 Support for VIO windows is also included with the Extended features.
 DragText 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.

 The Extended features are offered as shareware and require registration
 to prevent them from becoming disabled after your 6-week free trial ends.
 See the section on Registration details.


 Compatibility
 -------------
 DragText's features work with many commonly used applications, such as
 the System Editor (e.exe) and most of the windowed Internet-related
 programs supplied with OS/2. It is designed to add these features only
 to windows which lack them. It should never replace or interfere with
 the drag-and-drop support provided by your applications.

 Because its features are added-on, not built-in, it may not work for
 every possible window and conflicts may arise between DragText and some
 programs. If a conflict occurs, DragText can be partially or totally
 disabled for that 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 DragText.exe and put it (or a shadow)
       in your Startup Folder and/or on the Desktop
      offer you the option of installing two Workplace Shell classes
       that provide some of DragText's Extended features
      insert several entries in os2.ini to disable DragText for programs
       known to be incompatible, and
      display some information specific to your system.
 
  Removal
  -------
  To remove DragText from your system, you can either:

      run DTSetup and choose "Uninstall" to partially or completely
       remove it, or
      simply remove the program object from your Startup Folder to keep
       it from running.
 
  DragText's WPS classes can also be installed or removed using the
  Extended 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
__________________________________________________________________________

 The first time DragText.exe is run during a session, it loads itself
 into memory, displays a copyright message for 3 seconds, and then
 terminates. DrgTxt25.dll, which implements the drag-and-drop features,
 remains resident for the rest of the session.  You will not see DragText
 in any list of windows or tasks.

 All supported windows created AFTER DragText.exe is run will provide
 drag-and-drop; those created before will not (this is the primary reason
 for putting DragText in your Startup Folder).

 Running DragText again will bring up the Options Notebook which has
 pages that let you:

      set options for the Basic features such as the default drag action
      configure the settings for the Extended features such as Files and
       Urls,
      Disable DragText for particular programs
      provide 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

__________________________________________________________________________

    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
       DragText.Exe), it stays there until you reboot.  (If you use
       Pstat or Watchcat, you will see DrgTxt25.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.


    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 2.5
__________________________________________________________________________

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

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

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

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

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

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

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

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

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

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

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

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

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


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

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

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

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

  Bug Fixes
  ---------

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

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

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



__________________________________________________________________________
__________________________________________________________________________

    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
      copy, move, or shadow WPS objects from the windows they open
      create a formatted listing of a folder's directory
      append text to existing DragText files
      copy text to and from the clipboard
 
  To help you identify the results from a drag and drop operation,
  DragText uses up to six 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.

      Text, Urls, Files, and Folders

      Icons and Pointers

      Modifier Keys and Defaults

      Supported PM Windows

      VIO Windows



__________________________________________________________________________

    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).  (Note:  for single-line Entryfields begin
 dragging without any highlighting to drag the entire contents of the
 field.)

 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.  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 a multiline entryfield
 by pressing Alt before you drop it.  Press Alt before you drop a folder
 to insert a formatted listing of its directory.  The formatting is
 controlled by the settings on the Directory Options page (Files->Dirs)
 of the Options notebook.

 Dragging Objects
 ----------------
 With Extended features enabled, press Ctrl-Shift, then begin dragging
 from a window's system menu button to drag the WPS object that opened
 the window. The effect is identical to dragging this object from its
 folder, except that the default action is Shadow.  Change this to Move
 or Copy by pressing Shift or Ctrl when you drop the object.  You must
 press Shift to drop files on program objects or the Shredder.

 The object you drag is the one you doubleclicked to open the first
 window. If you clicked on a file, you'll get the file.  If you clicked
 on a program object, then used it to open a file, you'll get the program
 object. If DragText can't identify the original object, it will beep.


 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.

__________________________________________________________________________

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

 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.



__________________________________________________________________________

    Modifier Keys and Defaults
__________________________________________________________________________


 Modifier Keys
 -------------
 DragText uses standard modifier keys and adds two others to override
 the default action.  Except for the Insert key, press and hold them
 before you drop, NOT when you begin a drag.  For Insert, press and
 release immediately while over an entryfield;  do NOT hold it down.

 Ctrl

      copy text and DragText files
      copy text onto itself
      for files, insert the file's formatted directory entry rather
       than its fully-qualified name (this usage may change in future
       versions)
 
  Shift

      move text
      copy a DragText file then delete it
      you can never move folders or files from other sources
 
  Alt

      over MLEs, VIO windows, DTFile and DTClip objects, insert a
       file's contents
      over MLEs, VIO windows, DTFile and DTClip objects, insert a
       folder's directory listing
 
  Insert

      over a single-line entryfield or a DTClip object's viewer
       window, toggle between inserting the dropped text into the
       current contents, and replacing the current contents with
       the dropped text.
 
  Defaults
  --------
  In all cases, the default operation is Copy.  You can change these
  defaults:

  On the Basic page

      copy/move text within a window
      copy/move text between windows
      insert/replace text in entryfields
 
  On the File Handling page:

      copy/move text from a window into a DragText file
      copy/move a DragText file into a window
      insert a file's name/contents into MLEs, etc.


__________________________________________________________________________

    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 Directory Listing Options
       for details).
 
  Listbox
  -------
  dropping text will cause DragText to search for a matching item. If
  found, it will be selected (highlighted); if not, you'll hear a beep.
  DragText will never insert text into 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

  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 two ways.
  Use it to drag all of the text in a VIO window or a main window that
  contains an MLE.  Press Ctrl-Shift first to drag the WPS object that
  opened this 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, this version of 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 acility, then begin dragging.  To drag the entire
 content of a VIO window, don't highlight anything, just drag from its
 system menu button.

 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 Extended->File Handling Options page
 in DragText's Options notebook (page 2 of the Files section).



__________________________________________________________________________

    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
  Extended->VIO Options page in DragText's Options notebook.

__________________________________________________________________________

    Mouse Marking in VIO Windows
__________________________________________________________________________

 
 DragText provides a mouse-initiated marking feature that operates
 similarly to 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 Extended->VIO Options 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.  If you encounter problems, you can disable it in either
 of two ways:

      from the Extended page of DragText's Options notebook so that it
       cannot be turned on for any window, or
      from the Extended->VIO Options page so that it can be turned on
       for selected windows from their 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 four major
 sections, each with a tab at the top of the notebook:

   Basic       set the default actions for DragText's Basic features

   Extended    set the default actions for DragText's Extended features

   Disable     restrict DragText's operation for any programs you specify

   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 Features
__________________________________________________________________________

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

      Basic page
            Drag Defaults
            Background Drag
            Drop Options
 
      Miscellaneous page
            Icons and Pointers
            Other Options
 
      Style page
            Style
            Colors
 
  All settings take effect as soon as you close the notebook,
  change to another page, or press the "Apply" button.


__________________________________________________________________________

    Basic Page
__________________________________________________________________________


 The Basic page contains settings for options all users may want to set:

  Drag Defaults       should DragText move or copy dragged text

  Background Drag     should a source window remain partially covered
                      when beginning a drag

  Drop Options        how should DragText handle dropped text
 

__________________________________________________________________________

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

 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.



__________________________________________________________________________

    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:

      never:  this feature is disabled
      always:  this feature is enabled
      Ctrl+MB2 only:  this feature is active only when you press and
       hold the Ctrl key as you press mouse button 2
 
  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.

__________________________________________________________________________

    Drop Options
__________________________________________________________________________

 
 Drops into entryfields
 ----------------------
 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.

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

    Miscellaneous Page
__________________________________________________________________________

 
 The Misc page contains settings for less often used options available
 to all users:

  Icons and Pointers  the size of the mouse pointer and how DragText
                      handles dragged icons

  Other Options       should DragText delay its installation at startup,
                      and other choices

__________________________________________________________________________

    Icons and Pointers
__________________________________________________________________________

 
 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.

 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 Warp Fixpack 8 or later
  (Fixpack in 31 was the latest available, as of September, 1997).
  It is also fixed v4.0.

  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.

__________________________________________________________________________

    Other Options
__________________________________________________________________________
 

 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 message can be viewed on the DLL
 Info page.

 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.


__________________________________________________________________________

    Style Page
__________________________________________________________________________


 The Style page lets you set the appearance of DragText's
 Options notebook:

  Style               choose the type of notebook you prefer

  Colors              set a color scheme for the notebook
 
__________________________________________________________________________

    Style
__________________________________________________________________________
 

 Style
 -----
 Choose the notebook style that you prefer:

      DragText: top and side tabs
      Warp v3:  all side tabs
      Warp v4:  the new notebook style with all top tabs
 
 You will have to close and reopen the notebook for any change
 to take effect.

 Reset notebook to default size
 ------------------------------
 Each time you close the Options Notebook, DragText saves its current
 size, position, and color scheme. Use this checkbox to restore all
 of these to their default values the next time you run DragText.exe.
 This is particularly useful if you change display resolutions.



__________________________________________________________________________

    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.

 The three boxes that set the notebook's colors affect different areas
 in the "Warp v4" style than in the other two styles.

      DragText and Warp v3 styles
       ---------------------------
            Notebook: the background color is used for the notebook
            binding, the selected tab(s), and the status line (where
            the page number appears). The text color is used to draw
            the lines that make up the notebook.
            Tabs: sets the background color for tabs that are not
            selected, and the text color for all tabs.
            Status text / Outside margin: sets the color of the
            page number text and the area between the notebook and
            the window frame.

      Warp v4 style
       -------------
            Notebook: is not used.
            Tab text: sets the text color for tabs that are not selected.
            The background color is ignored.
            Status line / Outside margin:   sets the colors used on the
            status line (where the page number appears).  It also controls
            the text color for the selected tab and the background color
            behind the tabs.
 
            Note:  You can not set the color of the gray border around
            each page.
 
  Reset to default
  ----------------
 
      Color:  restores the default color scheme for the current notebook
               style
      Gray:   sets the colors to gray backgrounds and dark blue text



__________________________________________________________________________

    Extended Features
__________________________________________________________________________
 

 The six pages under the Extended tab let you set the default actions
 for DragText's Extended features.  These features require registration
 for use after your 6-week trial period ends.

      Extended page
            Enable Extended Features
            Workplace Classes
 
      Files pages
            File and Url Titles
            Temporary Files
            File Handling
 
      Directory page
            Include
            Formating
            Meta-characters
            Examples
 
      Urls page
            Url Identifiers
            Title Options
 
      VIO page
            Options
            Mouse Marking
 

  All settings take effect as soon as you close the notebook,
  change to another page, or press the "Apply" button.



__________________________________________________________________________

    Extended Page
__________________________________________________________________________


 Options on the Extended page let you:

  Enable Extended Features    turn each feature on or off

  Workplace Classes           install and remove DTFile and DTClip
 

  All settings take effect as soon as you close the notebook,
  change to another page, or press the "Apply" button.


__________________________________________________________________________

    Enable Extended Features
__________________________________________________________________________

 
 Files
 -----
 Create files by dropping text on a folder or the Desktop.  Read files
 and directories by dropping them on any supported window or object. This
 feature can be disabled 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.

 VIO windows
 -----------
 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.

 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.

 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.

 Object Drag
 -----------
 You can use almost any window's system menu button to drag the WPS object
 that opened that window.  Just press Ctrl-Shift before dragging from it.
 The effect is identical to dragging the object  from its WPS folder. This
 feature uses existing WPS classes and requires no new ones.



__________________________________________________________________________

    Install/Remove Workplace Classes
__________________________________________________________________________


 DragText uses two Workplace Shell classes, DTFile and DTClip,  to
 provide some of its Extended features. These classes can be installed
 or removed at any time, regardless of whether any Extended features
 are enabled.

 When you turn to the Extended 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 for existing DragText files to acquire the
 new features provided by DTFile.  This should not be necessary for
 DTClip.  Also, be sure the features provided by these classes are
 enabled in the Enable Extended Features section of the Extended page.

 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 DTFile25.Dll or DTClip25.Dll could not be found in
 your DragText directory (all of DragText's program files must be in the
 same directory as DragText.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.  For DTFile, you may have to restart
 your system to remove it from memory.

 Recreating the Clipboard Object
 -------------------------------
 If you need to recreate your Clipboard Object (perhaps because you
 accidentally deleted it), simply remove the DTClip class, then install
 it again.



__________________________________________________________________________

    File Pages
__________________________________________________________________________
 
 Options on the two Files pages control:

  File and Url Titles   how DragText names the files and Url objects
                        it creates

  Temporary Files       whether it should create a temporary file
                        whenever you begin a drag

  File Handling         how it should handle files you drop on
                        supported windows
 

  All settings take effect as soon as you close the notebook,
  change to another page, or press the "Apply" button.

__________________________________________________________________________

    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


__________________________________________________________________________

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


__________________________________________________________________________

    File Handling Options
__________________________________________________________________________
 

 These options control how DragText will handle files dropped on
 supported windows and objects.

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


__________________________________________________________________________

    Directory Page
__________________________________________________________________________


 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:\DragText
            File DRAGTEXT.EXE was created on 12-25-95 at 01:10:00
            File DRAGTEXT.DLL was created on 12-25-95 at 01:10:00
            [etc.]

 
 Example 2 - creating a command file
 -----------------------------------
 
 [Heading]  cd %p
 [Listing]  ren %f %F
 
 [Output]   cd C:\DragText
            ren DragText.Exe DRAGTEXT.EXE
            ren DragText.Dll DRAGTEXT.DLL
            [etc.]



__________________________________________________________________________

    Url page
__________________________________________________________________________
 

 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://
 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.


__________________________________________________________________________

    VIO page
__________________________________________________________________________
 

 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

  Options             set marking and dragging on or off here -
                      override the setting from the window's System menu

  Mouse Marking       mark, copy, paste options


__________________________________________________________________________

    Options
__________________________________________________________________________
 

 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.

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


__________________________________________________________________________

    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.


__________________________________________________________________________

    Disable
__________________________________________________________________________
 

 The Disable page lets you restrict DragText's operation for any
 Presentation Manager-based programs you specify (e.g. System Editor).
 You cannot disable it 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
 Enable Extended Features for details).

 Normally, DragText is enabled for all programs.  However, if it
 conflicts with an application's use of drag-and-drop, you can partially
 or totally disable DragText for that program.

 The "Program" section of the dialog contains a list of all applications
 that currently have restrictions. The checkboxes under "Uncheck to
 Disable" show the window types on which DragText operates.  If a box
 is checked, DragText is enabled.

 If DragText's Extended features are enabled, you can disable them for a
 specific program. Uncheck Drag to disable file and Url object creation;
 uncheck Drop to disable reading files, directories, and Url objects.

 You can also disable Background Drag for specific programs.

 Important:   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 IBM's WebExplorer from
 accepting it because DragText does not control WebExplorer's drag and
 drop features.

 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 and will not appear next time you run DragText.  This is
       done to enhance DragText's performance.



__________________________________________________________________________

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

 To eliminate this problem, use the Disable page to disable DragText
 partially or totally 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 drags or only drops for that window will solve the
 problem.

 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.

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


 Add a Program to the Restricted List
 ------------------------------------
 Enter the name of the program (or drop its icon into the entryfield).
 Path info isn't needed and will be removed when you add this entry.

 To disable drag and/or drop for particular window types, uncheck the
 corresponding boxes. To disable DragText entirely uncheck "All Windows".

 Press the button labeled "Add".


 Change a Program's Restrictions
 -------------------------------
 Select the program from the list.  The checkboxes will show its current
 status.

 Make any necessary changes.

 Your changes will be saved when you select another program from the
 list, press the "Apply" button, change notebook pages, or exit.


 Remove a Program from the List
 ------------------------------
 Select the program from the list.  The checkboxes will show its current
 status.

 Press the "Remove" button.  The entry will be deleted immediately.
 -- or --
 Check all of the checkboxes (i.e. so that there are no restrictions).
 The entry will be deleted when you close the notebook.



__________________________________________________________________________

    Disabling DragText System-wide
__________________________________________________________________________

 
 DragText uses only documented features of OS/2 which should continue
 to be supported in future versions. 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.



__________________________________________________________________________

    Info
__________________________________________________________________________

 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

   DT       enter your registration number, review product info

__________________________________________________________________________

    DLL Info
__________________________________________________________________________

 The DLL Info page provides usage and error statistics for Drgtxt25.dll.

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

 Errors
 ------
 This section displays the total number of errors encountered during this
 session, the ID number of the last process to have an error, and the
 message associated with that error.

 When an error occurs, Drgtxt25.dll will notify you if you choose this
 option on the Basic Features-> Misc page.  You can restart
 DragText.exe and refer to this page to review the error message.

 Note:  These messages are intended for debugging and diagnostic
 purposes.  Except for identifying conflicts with other programs,
 they are of little use to the user.  All errors arise from flaws
 in DragText, other applications, or the operating system.

__________________________________________________________________________

    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 two Workplace Shell classes, DTFile and DTClip, to
 provide some of its Extended features.  Except for the features
 described below, DragText does not rely on the WPS and operates
 very well on systems where the WPS is not used.

 DTFile
 ------
      permits appending text to an existing DragText file without
       having to open it
      assigns DragText files a unique icon that identifies them
 

  DTClip
  ------
      provides a drag and drop interface for the clipboard
 

  DragText must be loaded and the Extended features provided by these
  classes must be enabled before you can use them.  DTClip and DTFile
  can be installed or removed at any time, regardless of whether any
  Extended features are enabled.  If your free trial period for the
  Extended features has expired and you haven't registered DragText,
  you should remove these classes to save memory.



__________________________________________________________________________

    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 DTFILE25.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 provides a drag and drop interface for the clipboard.
 Registering this class creates a Clipboard Object on the Desktop
 that operates like a DragText-enabled window.  Opening the object
 displays a window that can be used as a clipboard viewer and editor.
 The window offers an "always visible" option that keeps it from
 becoming completely covered by another window.  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

      DTClip Options



__________________________________________________________________________

    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
__________________________________________________________________________

 
 Drag and Drop
 -------------

 Drag : To drag the current contents of the clipboard, begin dragging
 without highlighting any text;  the window's contents will be updated.
 To drag a selected portion of the text, highlight it, then begin
 dragging;  the selection will be dragged and the window will not be
 updated.

 Drop : Dropped text can either replace the clipboard's current contents
 or be inserted into it.  Quickly press and release the Insert key while
 dragging over DTClip's window to toggle between insert and replace
 modes.

      In replace mode, the mouse pointer will become DragText's
       "I-beam with X's" pointer.  The dropped text will replace the
       current contents of both the window and the clipboard.
      In insert mode, the dropped text will be inserted into the
       window's current contents at the drop point.  The entire contents
       of the window will then be copied to the clipboard.
 

  Menu Items
  ----------

  Copy All : the current contents of the window will be copied to the
  clipboard.  Use this after editing the text in the window.

  Paste All : the contents of the clipboard will be pasted into the
  window, replacing whatever is currently in the window. Use this to
  update the window.

  Options : use the items on this submenu to change the default settings
  established on the Options page of the object's notebook. Refer to
  DTClip Options for a description of each.



__________________________________________________________________________

    DTClip as a Clipboard Viewer
__________________________________________________________________________


 When the clipboard viewer option is on, DTClip's window 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 Extended 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.


__________________________________________________________________________

    DTClip Options
__________________________________________________________________________

 
 These options are set from the first page of a DTClip object's WPS
 notebook. They apply to the window(s) displayed when you open the
 object.  Most are defaults that can be changed for a particular window
 from its Options submenu.

 word wrap
 ---------
 This can be changed from the Options submenu.

 keep window visible
 -------------------
 whenever the text area of the window becomes completely covered, it
 will place itself on top of all other windows.  If it is only partially
 covered, it will not move.  This can be changed from the Options
 submenu.

 check visibility
 controls how often the DTClip class should check to see if any of its
 windows are covered.  This is a global setting that affects all windows
 for all DTClip objects.

 clipboard viewer
 ----------------
 when enabled, the window will automatically be updated whenever the
 contents of the clipboard changes.  This can be changed from the
 Options submenu.

 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.

 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.



__________________________________________________________________________
__________________________________________________________________________

    About DragText
    --------------
__________________________________________________________________________

    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 stable
 major currency.

      U.S. Dollars:   Starting January 1, 1998, registration is $20;
       for mail postmarked 1997, the cost is $15.  Your check must be
       drawn in US dollars on a bank in the United States.  Some users
       in western Europe have successfully sent me cash, but this was
       done entirely at their own risk.

      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. The additional cost covers my
       bank's fee for automated processing. Your check will not be
       accepted if it converts to  significantly less than $25, or
       if it requires special handling by my bank.

       If you have any questions, email me before sending your payment.
 
  Mail your check or money order to:
            Rich Walsh
            315 S. Barbour St.
            Beverly Hills, Florida  34465
            U.S.A.
 
  Include your full name, mailing address, and email address.

  Send email to:  rlwalsh@packet.net




  BMT Micro
  ---------

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

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

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

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

  Compuserve:    Thomas Bradford, 74031,307

  AOL            bmtmicro

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

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


__________________________________________________________________________

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

 You may copy and freely redistribute DragText to others, provided:
         -  the recipient agrees to the terms of this license,
         -  you transfer DragText as a whole and intact,
         -  there is no cost to the recipient other than the costs of
            providing media and transmission, and
         -  it is not redistributed in conjunction with any software that
            may not also be freely redistributed by the recipient.
 
  You may not modify DragText in any way nor may you reverse
  assemble, reverse compile, or otherwise translate or reverse engineer
  its executable code or data. You may make additions to the
  documentation, including translations into other languages, provided
  these are contained in files separate from the originals and are
  identified as addenda to the accompanying original documentation.

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

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



 * OS/2 and Presentation Manager are trademarks of International
 Business Machines Corp.

__________________________________________________________________________

