
__________________________________________________________________________



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

                  (C) Copyright R L Walsh 1994 - 1996
                           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
    ---------------
        Overview
        Installation / Removal
        Running DragText
        Frequently Asked Questions
        New and Revised Features in Version 2.0

    Using DragText
    --------------
        Features
        Text, Urls, Files, and Folders
        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
    ----------------
        Notebook Layout
        Basic Features
            Drag Defaults
            Background Drag
            Reset notebook to default size
            Icons and Pointers
            Other Options
        Extended Features
            Enable Extended Features
            Install/Remove Workplace Classes
            File Creation Options
            File Handling Options
            Directory Listing Options
            Url Options
            VIO Options
        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

    Workplace Shell Classes
    -----------------------
        DragText's WPS 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
    ---------------
__________________________________________________________________________

    Overview
__________________________________________________________________________


 Basic Features
 --------------
 DragText's Basic features add drag-and-drop text features 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, VIO (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 the Clipboard to insert its contents.   

 The Extended features include two optional WPS classes to provide 
 additional services.  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.   

 The Extended features also include support for VIO windows via their 
 existing clipboard interface.  Full support for mouse-initiated marking, 
 copying, and pasting is provided.   

 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 programs in the Internet Access 
 Kit. 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 or 
  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. DrgTxt20.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 DrgTxt20.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.0
__________________________________________________________________________

 
 This version of DragText has been designated v2.0 because of a major 
 revision in its architecture that enables it to support windows that are 
 derived from those supported by previous versions (v1.x).   

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

      VIO (text-mode) window support via the clipboard.  Mouse-
       initiated text marking is included.  Support for drag and drop
       and mouse-marking can be enabled/disabled from the window's
       System menu.  (See VIO Windows)   

      A WPS-based Clipboard object that operates like a DragText-enabled
       window.  The object can be opened to display a floating clipboard
       viewer and editor. (See DTClip)   

      Drop text or a file on an existing DragText file to append it to
       the existing text.  (See DTFile)   

      Open program objects by dropping text on them.   

      Print dragged text by dropping it on a printer object.   

      Install and remove DragText's WPS classes from within its Options 
       Notebook.  (See Install/Remove WPS Classes)   
    

  Revised Features
  ----------------

      Temporary files are handled differently than in prior versions and 
       their creation is now the default.  They must be enabled to open 
       objects, print text, and drop text on windows that won't accept 
       dragged text but will accept a file. The "create a pipe" option
       has been removed.   

       Creating a DragText file when this option is enabled will cause
       the WPS to display a Copy dialog if you have its "Confirm on move, 
       copy, shadow" option set.  The file name shown will be that of 
       the temp file.  However, the copied file will have the standard 
       DragText-style file name.   

      The DTFile WPS class now supports templates and the "Create 
       Another" option on each object's context menu. A default template 
       that is deleteable is created when you register the class.   

      Unreadable entryfields (i.e. those which display asterisks rather 
       than text) can no longer be dragged from.  DragText now honors 
       this attempt at providing security.   


      Url object titles no longer include any periods. They are removed
       to prevent the system from misidentifying part of a Url as a file 
       extension.   

      The Options Notebook has been revised to accommodate the new 
       features.  There is now a separate side-tab for files in the 
       "Extended" section of the notebook.  Please note that there are 
       two pages associated with this tab. Use the page buttons to 
       access the second page.   

      Entering registration info causes all Extended features to be
       turned on when you reopen the Options notebook. Formerly, these
       had to be reenabled manually.  You must still close the notebook,
       then run dragtext.exe again to put your registration in effect.   



__________________________________________________________________________

    Using DragText
    --------------
__________________________________________________________________________

    Features
__________________________________________________________________________


 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 files and Url objects in supported windows 
      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 



__________________________________________________________________________

    Text, Urls, Files, and Folders
__________________________________________________________________________


 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 and Folders
 --------------------------
 With the Basic features, you can drop a file or folder 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.   

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

  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   

 Because the internal functioning of VIO windows is entirely 
 undocumented, DragText must rely on their existing clipboard interface 
 to move text in and out of them.  This is the only type of window 
 where DragText uses the clipboard.  For all other supported windows 
 windows, its operations are completely independent of the clipboard.   

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

      Using Drag and Drop 

      System Menu Options 

      Mouse Marking 

      Disabling DragText 



__________________________________________________________________________

    Using Drag and Drop in VIO Windows
__________________________________________________________________________

 
 Drag 
 ----
 Select the text to be dragged using either DragText's marking feature or 
 another similar facility, then begin dragging.  The text will be copied
 to the clipboard where DragText can access it and handle it like text
 from any other window.   

 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

__________________________________________________________________________

    Notebook Layout
__________________________________________________________________________

 
 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 press the "Apply" button, 
  change pages in the notebook, or close it. 



__________________________________________________________________________

    Basic Features
__________________________________________________________________________

 
 The two Basic pages let you set the default actions for DragText's 
 Basic features. All settings take effect as soon as you press the 
 "Apply" button, change pages in the notebook, or close it. 



__________________________________________________________________________

    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. 

 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. 



__________________________________________________________________________

    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. 



__________________________________________________________________________

    Reset notebook to default size
__________________________________________________________________________

 
 Each time you close the Options Notebook, DragText saves its current 
 size, position, and display attributes (e.g. the font used for notebook 
 tab text). 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. 



__________________________________________________________________________

    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 
  22 was the latest available, as of October, 1996).  It is also fixed in 
  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
__________________________________________________________________________
 

 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. 

 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.   



__________________________________________________________________________

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

 All settings take effect as soon as you press the "Apply" button, 
 change pages in the notebook, or close it. 

      Enable Extended Features 
      Workplace Classes 
      File Creation Options 
      File Handling Options 
      Directory Listing Options 
      Url Options 
      VIO Options 



__________________________________________________________________________

    Enable Extended Features
__________________________________________________________________________

 
 Enable all or parts of DragText's Extended features systemwide.   

 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
 -----------
 Text can be dragged from VIO (text-mode) windows and text or files 
 can be dropped onto them. Unlike any other windows, DragText must 
 use the clipboard to accomplish this.  Each drag or drop involving
 a VIO window will overwrite the current contents of the clipboard.
 To make marking VIO text easier, DragText offers a mouse-initiated
 marking feature similar to Warp v4.0 but somewhat 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.   



__________________________________________________________________________

    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 DTFile20.Dll or DTClip20.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 Creation Options
__________________________________________________________________________
 

 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)   

 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 Listing Options
__________________________________________________________________________

 
 If you drop a Workplace folder on a multiline entryfield while pressing 
 Alt, DragText will insert a formatted listing of the files in that disk 
 directory. This listing will not include non-file objects (such as 
 program objects or shadows).  This feature can be used to create 
 simple batch files, as shown in Example 2 below. 

 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 

 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 is "%#  %d  %t %s %a 
 %f" , followed by a carriage return.  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 

  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 batch file 
  
  [Heading]  cd %p
  [Listing]  ren %f %F
  
  [Output]   cd C:\DragText
             ren DragText.Exe DRAGTEXT.EXE
             ren DragText.Dll DRAGTEXT.DLL
             [etc.]


__________________________________________________________________________

    Url Options
__________________________________________________________________________
 
 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 IBM's WebExplorer or other 
 compatible Web browsers to load the Url. 

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

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

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

 Usage
 -----
 The usage section shows the number of processes (programs) that have 
 loaded Drgtxt20.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, Drgtxt20.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's WPS 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 DTFILE20.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  - $15 - $20 (US) 
__________________________________________________________________________


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

      U.S. Dollars:   registration is $15 if the check is drawn in US 
       dollars on a bank in the United States.  Some users in western 
       Europe have successfully sent me cash, but this was done entirely 
       at their own risk.   

      Other Currencies:   registration cost is the equivalent of $20 
       converted into your national currency.  The additional cost
       covers my bank's fee for automated processing.  Your check will
       not be accepted if it converts to significantly less than $20,
       or if my bank requires it to be processed manually. 

       You can determine the exchange rate by asking your bank or 
       looking in the financial pages of your local newspaper.  There
       are usually separate "buying" and "selling" rates.  Please use
       the rate that is less  favorable to you (i.e. will cost you more)
       because that is the rate I will get when I cash your check. 

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

  Send email to:  rlwalsh@packet.net 



__________________________________________________________________________

    BMT Micro  - $18 (US)   
__________________________________________________________________________


  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   

  BBS:           (910) 350-8061 10 lines, all 14.4K 
                 (910) 799-0923 28.8k v.FC   

  Internet:      bmt@wilmington.net   

  Compuserve:    Thomas Bradford, 74031,307   

  telnet:        bmt.wilmington.net   
  
  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.   



__________________________________________________________________________

