*********************************************************************** DragText - version 2.0 The Drag and Drop Enabler for OS/2 (C) Copyright R L Walsh 1994 - 1996 All Rights Reserved *********************************************************************** DTReadMe.Txt - quick start info for DragText *********************************************************************** C O N T E N T S ==================== - What It Does - Installation - Using DragText - New Features in v2.0 - Known Problems - Registration - License Agreement - File List This program is licensed to you under the provisions of the License Agreement included in this file and in the Online Help. Use of this program constitutes your acceptance of that Agreement. *********************************************************************** WHAT IT DOES ============ DragText v2.0 lets you handle text in windows, files, and the clipboard like objects that can be copied, moved, saved or deleted using drag and drop. Drag text from PM and VIO windows to: - the same or other windows - the Desktop or a folder to save it as a DTFile or Url object - the DragText Clipboard object (DTClip) - the Shredder - a DTFile's icon to append it to that file - program objects to open them - your Web browser if the text is a Url - your printer Drop a file or folder into a PM or VIO window to: - enter its name - insert a file's text - list a folder's contents. DragText works with many popular apps, including the Internet Access Kit, System Editor and EPM. DragText's Basic features are yours free for unlimited use. Its Extended features are yours to try for 6 weeks. Continued use costs only $15-20(US) by mail and $18 through BMT Micro. If not registered, the Extended features will cease working after your free trial period expires. *********************************************************************** INSTALLATION ============ Run DTSetup to install DragText v2.0 and enable your 6-week free trial of DragText's Extended features. It will copy files, create objects, and advise you of any restrictions imposed by your system. After a successful installation, you can load DragText v2.0 and use it immediately. DTSetup can be used later to uninstall DragText. Refer to DTSetup.Txt for a full description. *********************************************************************** USING DRAGTEXT ============== Run DragText at startup to load it. It will remain in memory until you reboot, but it will NOT appear in any task or window list. Run DragText again to open its Options Notebook whenever you need to: - set its options and defaults - disable it for a specific program - review runtime statistics and error messages - read the online Help DragText's help window has 'Forward' and 'Back' buttons to make browsing it easier. DragText supports 6 types of text window found in most PM apps: 1)Single-line Entryfields 3)List boxes 5)Spin buttons 2)Multi-line Entryfields 4)Combo boxes 6)Static text DragText also supports VIO (command line) windows via the clipboard and includes mouse-initiated text marking/copying/pasting It uses 6 icons and 3 mouse pointers that change as you drag text and files to identify what will happen if you drop at that point. -Press and hold CTRL to select a copy operation (this is the default); -press and hold SHIFT to select a move operation; -press and hold ALT to insert a file or folder's contents into a multi-line entryfield; -press and release INSERT to toggle between insert and replace mode in single-line entryfields only. Most defaults can be changed from the Options Notebook. Dragging Text ------------- Highlight the text, then begin dragging from anywhere within the window. You do not have to point at the selection nor does it have to be visible (e.g. in an MLE, you can scroll it out of view). Drag text between windows: - drag it to the target window - position it using the I-beam mouse pointer (not the icon) - drop it Create a DragText file or Url object: - drag it to the Desktop or any folder - drop it A file's title will be based on the text, minus punctuation. A Url objects's title comes from the Url, minus unnecessary words. Dragging Files and Folders -------------------------- Read a DragText file or Url object: - drag the file or object into ANY supported window - position it using the I-beam pointer - drop it DragText treats its own files and Urls the same as dragged text. Read any file: - drag the file into a multiline entryfield - use the I-beam pointer to position it - press the ALT key, then drop it List a directory's contents: - drag a folder icon into a multiline entryfield - use the I-beam pointer to position it - press the ALT key, then drop it Enter a filename: - drag a file icon into any supported window - use the I-beam pointer to position it - drop it *********************************************************************** NEW FEATURES IN v2.0 ==================== DragText v2.0 is a major update to v1.x. It uses a revised architecture that supports VIO windows and windows derived from standard PM classes. v2.0 adds these 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. - 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. - Drop text or a file on an existing DragText file to append it to the existing text. - 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. - Delay loading DragText at startup until the WPS and other apps are initialized. *********************************************************************** KNOWN PROBLEMS ============== ** 1. Desktop Hangs at Startup ** Description ----------- The system stops while setting up the Desktop. Some of the programs in your Startup folder may have run, and some icons may be visible on the Desktop. Ctrl-Esc may do nothing, or it may cause the WPS to crash and restart with your icons misplaced. This problem usually recurs with every reboot. Cause ----- There are a *lot* of possible causes, including DragText. The problem is probably timing-related (e.g. DT gets installed before the WPS is ready). Solutions --------- o Prevent the Startup Folder from Running Reboot. When the screen switches to a colored background after the drivers have loaded, press and hold Ctrl-Shift-F1 until all the icons on your Desktop appear. You can run the items in Startup manually, if desired. For unknown reasons, this often cures the problem. The next time you reboot, the Desktop probably won't hang. o Rearrange Objects in the Startup Folder In the Startup folder's WPS notebook, set the format for Icon view to 'Non-flowed', then turn off 'Always maintain sort order'. When you open the folder, the objects will be arranged in a column in the order they're run. You can rearrange them as needed. o Delay DragText's Startup from Config.Sys Place the following line anywhere in config.sys: SET DTDELAY=30 This will delay DT's startup for 30 seconds. You can change the delay to any value from 0 to 300 (5 minutes). After this delay, DragText will install itself. To prevent DragText from installing itself, enter this instead: SET DTDELAY=-1 DragText will run but its drag and drop facilities won't be loaded. This entry should be deleted from config.sys after a sucessful startup. Use DT's Options Notebook to set the delay. o Delay DragText's Startup from its Options Notebook Run DragText.Exe to open its Options Notebook to the Basic->Misc page. Under 'Other Options' select a startup delay from none to 90 seconds. The delay should be from the time objects in your Startup folder are run until your disk drives cease most activity. Warning! Entering 'SET DTDELAY=' in config.sys will override the Notebook's setting. Remove the entry from config.sys after a sucessful startup. o Remove DragText from your Startup Folder This shouldn't be necessary with a suitable startup delay. If you decide to run DT manually, be sure to reset the startup delay to 'none'. ** 2. Warp v4 Hangs when Dropping an Exe File into a Program Object ** Description ----------- For some users, dropping an exe file's icon into the 'Path and file name' field of a program object causes the WPS to hang. The focus cannot be moved from this entryfield. When the object's notebook is closed, the system hangs. Cause ----- When you shift the focus out of the 'Path and file name' field, the program object searches \os2\install\database.dat for special settings for that program. Because DragText changes the focus several times, it appears to interfere with the search function. Workaround ---------- Rename database.dat (e.g. 'database.org'). One user reports doing this, testing it, then restoring the file's name. Thereafter, he had no problems. If you use few Dos or WIndows programs, you may want to leave this renamed. *********************************************************************** REGISTRATION ============ DragText's Basic features (dragging text between windows and entering filenames) are free and require no registration. Unregistered users see a copyright message for 3 seconds at startup. DragText's Extended features (File, Url, VIO, and Clipboard features) require registration. They are enabled for 6 weeks after installation; Thereafter, they will be disabled until you register. DragText can be registered to individual users directly with the author ($15-$20) or through BMT Micro ($18). You will receive a registration number that you enter on the last page of the Options Notebook. Contact the author about site licensing and corporate registration. ---------- - Direct - ---------- Cost: $15 - $20 (US) The author can accept checks or money orders drawn in any stable major currency. o 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 sent me cash, but this was done entirely at their own risk. o 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). You can send email to: rlwalsh@packet.net ------------- - BMT Micro - ------------- Cost: $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. *********************************************************************** FILE LIST ========= Archive file drgtxt20.zip contains: 1. drgtxt20.001 Nov 30, 1996 02:00:00 2. drgtxt20.002 Nov 30, 1996 02:00:00 3. drgtxt20.003 Nov 30, 1996 02:00:00 4. drgtxt20.004 Nov 30, 1996 02:00:00 5. drgtxt20.005 Nov 30, 1996 02:00:00 6. drgtxt20.006 Nov 30, 1996 02:00:00 7. dtsetup.exe Nov 30, 1996 02:00:00 8. dtsetup.txt Nov 30, 1996 02:00:00 9. dtreadme.txt Nov 30, 1996 02:00:00 10. dthelp.txt Nov 30, 1996 02:00:00 11. file_id.diz Nov 30, 1996 02:00:00 *********************************************************************** Rich Walsh (rlwalsh@packet.net) Ft Myers, Florida November 30, 1996 *** end of DTReadMe.Txt ***********************************************