CLIP2TXT: 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 CLIP2TXT
2) Installing CLIP2TXT
3) Using CLIP2TXT
4) Known Issues and Limitations
5) Support
6) Source Code availability

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

What is CLIP2TXT? 
-----------------

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

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


Installing CLIP2TXT
-------------------

CLIP2TXT 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 CLIP2TXT:

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

It is recommended to put the CLIP2TXT.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 CLIP2TXT
--------------

Usage: CLIP2TXT.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!

  If no filename is specified, the clipboard contents will be displayed on
  the screen, translated for MS-DOS compatibility. In other words, 
  "CLIP2TXT > FOO.TXT" is equivalent to "CLIP2TXT -T FOO.TXT". If a filename
  is specified, the -T option must also be specified.

Examples:
  CLIP2TXT.exe FOO.TXT
  Copies the Windows Clipboard contents to the file FOO.TXT in the current
  directory.

  C:\TEMP\CLIP2TXT\clip2txt.exe -t "C:\My Documents\Long File Name.txt"
  Copies the Clipboard to the specified file. Filenames containing spaces must
  be "enclosed in double quotes."


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

* CLIP2TXT only works if the contents of the Windows Clipboard are text.
  If the Clipboard contains graphics or other binary data, an error
  message will be displayed, and the output file will be empty.

* CLIP2TXT v1.0 may not work if the Clipboard contains more than 64Kb of
  text. This may be corrected in a future release.


Support
-------

CLIP2TXT Version 1.0 (20. January 1999)
Copyright (c) 1999 James Greene Informatics Consulting
CLIP2TXT comes with NO WARRANTY to the extent permitted by law.
You may redistribute copies of CLIP2TXT under the terms of the
GNU General Public License. For more information about these
matters, see the file named COPYING, 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 CLIP2TXT is available from the author. 

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

The source code archive (CLP2TXTS.ZIP) contains:

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

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

