TEXT2CLP: Copy the Windows Clipboard contents to a File       Version 1.0a
Copyright (c) 1999 James Greene Informatics Consulting   <greene@gucc.org>
                   http://gucc.org/greene/consult

===============================================================================

CONTENTS
--------

1) What is TEXT2CLP
2) Installing TEXT2CLP
3) Using TEXT2CLP
4) Known Issues and Limitations
5) Support
6) Source Code availability

===============================================================================

What is TEXT2CLP? 
-----------------

TEXT2CLP is a FREEWARE command line utility for Windows 9x/NT batch files.
TEXT2CLP will copy the contents of a disk file to the Windows Clipboard.

James Greene Informatics Consulting also provides CLIP2TXT, a command
line utility to copy the contents of Windows clipboard to a disk file.


Installing TEXT2CLP
-------------------

TEXT2CLP is a single Win32 character-mode executable. It does not require
any additional .DLLs or other files, but will only run in a Windows 9x or
Windows NT "DOS-Box".

To install TEXT2CLP:

1) Download the TEXT2CLP.ZIP file from
   http://gucc.org/greene/software/TEXT2CLP.zip
2) Use PKUNZIP, WinZIP or some other ZIP utility to extract the contents
   of the TEXT2CLP.ZIP file. 

It is recommended to put the TEXT2CLP.exe file in a directory that is
contained in the PATH, e.g. C:\Windows\Command on Windows 9x, or
C:\WinNT\System32 on Windows NT.


Using TEXT2CLP
--------------

Usage: TEXT2CLP.exe [options] filename [options]

Options:  ( /option and --option are also accepted )
  -d[isplay]   = Display the clipboard contents on the screen.
  -h[elp]      = Display this usage information.
  -n[ologo]    = Don't display the Copyright banner.
  -q[uiet]     = Same as -nologo.
  -s[ilent]    = Same as -nologo.
  -t[ranslate] = Convert from Windows ANSI to MS-DOS ASCII codes.
  -?           = Same as -help.

  Options are not case-sensitive, and can be abbreviated to one character.
  The following options are all interpreted the same:
     -d, /d, -D, /D, --DISPLAY, /Display, -dIsP, ... you get the idea!

Examples:
  TEXT2CLP.exe FOO.TXT
  Copies the contents of FOO.TXT to the Windows Clipboard.

  C:\TEMP\TEXT2CLP\TEXT2CLP.exe -t "C:\My Documents\Long File Name.txt"
  Copies the contents of the specified file to the Clipboard as OEM text.
  Filenames containing spaces must be "enclosed in double quotes."


Known Issues and Limitations
----------------------------

* TEXT2CLP assumes that the file is text, and registers the data in the
  clipboard as such. If the selected file contains binary data, bad things
  may happen when 'pasting' this into other applications.


Support
-------

TEXT2CLP Version 1.0a (21. January 1999 at 08:56)
Copyright (c) 1999 James Greene Informatics Consulting
TEXT2CLP comes with NO WARRANTY to the extent permitted by law.
You may redistribute copies of TEXT2CLP under the terms of the
GNU General Public License. For more information about these
matters, see the file named COPYING.txt, or contact the author
at <greene@gucc.org>

Please report any bugs to <greene@gucc.org>


Source Code availability
------------------------

The ANSI C source code for TEXT2CLP is available from the author. 

TEXT2CLP was developed in ANSI C, and compiled with Watcom C/C++ v11.0.

The source code archive (TXT2CLPS.ZIP) contains:

   COPYING.TXT          GNU General Public License and copying information
   TEXT2CLP.C           The program source code
   TEXT2CLP.EXE         The program executable
   TEXT2CLP.ICO         32x32x16 and 16x16x16 icons
   TEXT2CLP.RC          Resource definitions (icon and version information)
   TEXT2CLP.TGT         Watcom IDE Target file
   TEXT2CLP.TXT         This file
   TEXT2CLP.WPJ         Watcom Project file

===============================================================================

