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

 TWCP  V 1.32 - Text Window Cut and Paste

 Copyright 1994 by Masar Software Ltd.
 All rights reserved.

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

 This is free software.

 If you find this program useful, let me know,
 SEND A POSTCARD WITH A PHOTO OF YOUR CITY to:

      Maurizio Sartori Masar
      Via MonteGrappa  7
      20044 Bernareggio
            (Milano)  ITALY

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

 Commercial distribution and/or use is prohibited without written consent by
 the author.

 Because the program is licensed free of charge, there is no warranty for the
 program, to the extent permitted by applicable law.  Except when otherwise
 stated in writing the copyright holders and/or other parties provide the
 program "as is" without warranty of any kind, either expressed or implied,
 including, but not limited to, the implied warranties of merchantability and
 fitness for a particular purpose.  The entire risk as to the quality and
 performance of the program is with you.  Should the program prove defective,
 you assume the cost of all necessary servicing, repair or correction.

 In no event unless required by applicable law or agreed to in writing will
 any copyright holder, or any other party who may modify and/or redistribute
 the program as permitted above, be liable to you for damages, including any
 general, special, incidental or consequential damages arising out of the use
 or inability to use the program (including but not limited to loss of data or
 data being rendered inaccurate or losses sustained by you or third parties or
 a failure of the program to operate with any other programs), even if such
 holder or other party has been advised of the possibility of such damages.

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

 TWCP  V 1.32 - Text Window Cut and Paste

 The TWCP application is a simple Presentation Manager application which let
 you Mark, Copy and Paste text and graphics from a DOS or OS/2 Window using
 the mouse, like in X Windows, without passing through the system menu.


 Version 1.00
      o Initial release.

 Version 1.10
      o Added option to eliminate last Carriage Return.


 Version 1.20
      o Rewritten Hook procedure.
      o Corrected problem with buttons 2 and 3 in mark operations.
      o Corrected problem with Disable button.
      o Corrected minor bugs.
      o Minor changes to documentation (added notes and warning).
      o Forced use of control key(s) if Button 1 is used for mark.

 Version 1.30
      o Added option to copy and paste in entry fields.
      o Added option "/L" to lower a window z-order clicking on its title.
      o Minor esthetical changes

 Version 1.31
      o Corrected problem with minimized icon drawing.
      o Corrected problem with errors in command line parameters.

  Version 1.32
      o Corrected problem with "/L" option
      o Enhanced "/L" option to allow use of any combination of mouse
        button and Shift, Alt and Ctrl keys.

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

 Known Bugs

 With OS/2 V 2.11 the TWCP can only be Minimized to Viewer, this is a
 problem of the Service Pack :-(, with other versions of OS/2 you can
 Hide, Minimize to Viewer or to Desktop as usual.

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

 In this package, you should receive these files:

  TWCP.EXE      -  Program file
  TWCPHOOK.DLL  -  Program hook library
  TWCP.HLP      -  Program help file
  READ.ME       -  Program description in ASCII format.

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

 To install TWCP copy TWCP.EXE in a directory in your PATH,
 TWCPHOOK.DLL in a directory in your LIBPATH and TWCP.HLP in a
 directory in your HELP path.

 That is all, now you can use TWCP.

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

 TWCP has the following syntax:

      TWCP [/? | /H] [/L[1,2,3,A,S,C]]

 Where

  /? /H     Print this help.
  /L        Enable Low It option

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

 Low It option

 This option is enabled with the /L[opt] switch in the command line.

 When this option is enabled you can low a window, putting it below all
 windows, clicking with Button 2 on its Title Bar.

 You can use the following modifiers to the option:

  1         Use mouse button 1.
  2         Use mouse button 2 (default).
  3         Use mouse button 3.
  C         Use CTRL key with mouse.
  A         Use ALT key with mouse.
  S         Use SHIFT key with mouse.

 Note:  /L1 isn't a valid option!

 Sample:  TWCP /L3AC will enable the option using button 3 with ALT
          and CTRL keys.

 Warning: When this option is enabled, applications' title bar will not see
          the button click: if a pop up menu is associated with a click of
          the button on the title bar, it will never be activated.

 Note: This option is not saved with the program profile, it must be
       specified every time TWCP is executed to have effect.

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

 This section explain how to use TWCP.

 To enable TWCP you should:

   1. Select the mouse button with which you want to Mark and Copy,
      checking the corresponding radio button.
   2. Chose which control key(s) (Shift, Alt, Ctrl) you would like to use
      together with the mouse to Mark and Copy, checking the
      corresponding check button.
   3. Select the mouse button with which you want to Paste checking
      the corresponding radio button.
   4. Chose which control key(s) (Shift, Alt, Ctrl) you would like to use
      together with the mouse to Paste, checking the corresponding check
      button.
   5. Enable TWCP clicking on the ENABLE button.

 Now you can start to use TWCP.


 To Disable TWCP you should click on the DISABLE button.


 To Mark and Copy a portion of text in a DOS or OS/2 Text window you
 should do the following:

   1. Press the Mark and Copy control key(s).
   2. Click the Mark and Copy mouse button where you want to start
      marking.
   3. Drag the mouse, holding down button and key, till the end of the
      portion of text you want to mark. Now the zone should be
      highlighted.
   4. Release the Mark and Copy mouse button.
   5. Release the Mark and Copy key.

 The text or graphics you marked is automatically copied to the Clipboard.

 Note:  If you release the control key(s) before releasing the mouse
        button, you remain in mark mode. To complete the operation, restart
        from point 1.


 To Paste from the Clipboard you should do the following:

   1. Press the Paste control key(s).
   2. Click the Paste mouse button in the window in which you want to
      paste.
   3. Release the Paste mouse button.
   4. Release the Paste key.

 The text or graphics is automatically pasted to the window.

 Warning: You should hold down the control key(s) till the paste
          operation is completed, otherwise the text program could loose
          the release of the control key(s).

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

 TWCP works installing a system hook that intercepts every mouse message
 posted.  If the message is directed to a DOS or OS/2 Text Window, that has a
 window class of type Shield, or to a Entry Field, #6 and #10 classes, and it
 is a Mark, Copy or Paste key combination, the messages for Mark, Copy or
 Paste are send to the window.

 Warning: Because the program relies on the class name, and there can
          be other windows with class name Shield that aren't DOS or OS/2
          Text Windows, the program can fail with those windows.
          The fields Class and Parent show the class name of every window in
          which the mouse is clicked.
          If you find a program that makes fail TWCP please let me know.

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

 Masar Software Ltd.

 For bugs or suggestions, please write to:

      Maurizio Sartori Masar
      Via MonteGrappa  7
      20044 Bernareggio
            (Milano)  ITALY

 or email to the INTERNET address:

      masar@cdc8g5.cdc.polimi.it
      masar@131.175.6.1


 Acknowledgments

 Thanks to Simona who helped me in writing the documentation.

