# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #
#                                                                     #
#                           Clipboard Manager                         #
#                                                                     #
#                                 Copyright (c)  Dmitry A. Kazakov    #
#                                                Luebeck              #
#                                                Winter 1994          #
#                                                                     #
#                               Last revision :  12:22 12 Oct 1997    #
#                                                                     #
#    This program is free software; you can redistribute it and/or    #
#    modify  it  under the terms of the GNU General Public License    #
#    as published by the Free Software Foundation; either  version    #
#    2 of the License, or (at your option) any later version. This    #
#    program is distributed in the hope that it  will  be  useful,    #
#    but  WITHOUT  ANY WARRANTY; without even the implied warranty    #
#    of MERCHANTABILITY or FITNESS FOR A PARTICULAR  PURPOSE.  See    #
#    the  GNU  General Public License for more details. You should    #
#    have received a copy of the GNU General Public License  along    #
#    with this program; if not, write to the Free Software Founda-    #
#    tion, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.              #
#                                                                     #
# # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # #

THE CLIPBOARD MANAGER UTILITY (version 3.0)
   The Clipboard Manager utility is a clipboard viewer for the Microsoft
   Windows 95 or NT. Any time when a  Windows  application  places  some
   text  onto  the clipboard, the utility tries to convert the clipboard
   contents.  According  to the radio  button  checked onto  the utility
   control panel the utility can:

      (o)  Leave the clipboard contents unchanged;
      (o)  Format the text in the clipboard;
      (o)  Sort lines in the clipboard;

   With the aid of the Clipboard Manager you can teach  your  preferable
   text editor to format  or  sort  the  selected  text.  Just  run  the
   clipboard  manager.  Choose  conversion  mode  on  the control panel.
   Select  the  text  you  want  to  convert. Make `Cut' and immediately
   `Paste'. Here you are!

REQUIREMENTS
   The  utility  was compiled using the Microsoft Visual C++ and Borland
   C++ compilers. However it is a pure Windows application, i.e. it uses
   neither Microsoft Foundation Classes (MFC) nor Borland class library.
   Theoretically it can be compiled by any C++  compiler  that  supports
   Win32 API.

FILES
   alpha\clipman.exe	- Ready to use executable (DEC Alpha native)
   ix86\clipman.exe	- Ready to use executable (Intel native)
   vc.mak       - Visual C++ specific make file
   bcc.mak	- Borland C++ specific make file
   *.bmp        - Bitmap files
   *.cpp        - Source files (C++)
   *.h          - Header files
   *.ico        - Icon files
   clipman.rc   - Windows resource script file
   copying      - GNU General Public License
   readme.txt   - This file

   NOTICE.  Tabs  are  used  in  source  texts. The texts may look a bit
   strange if your editor has tab stops other than 8.

BUILDING
   Open a Windows console and type (for Microsoft C++):

      nmake -f vc.mak

   or (Borland C++)

      make -f bcc.mak

   These commands should re-build the clipman.exe file.

BUTTONS
   The  Clipboard  Manager starts minimized. It shows its buttons on the
   taskbar.  Use  these  buttons to change the clipboard formatting mode
   without  task  switching.  Open  the  Clipboard Manager to change the
   default formatting mode and parameters. You can set:

   (o)  Initial mode: `Do not touch', `Format', `Sort'.

   (o)  The  tabulation  size (tells how the tab character is expanded).
        Initially tab is treated as 8 spaces.

   (o)  The right margin of the text used for justification. By  default
        it is set to 72.

   (o)  Up to four prefix-suffix pairs (see below).

   You can save the current settings using the Save button.

FORMATTING THE CLIPBOARD CONTENTS
   The  way  the  text is formatted is defined by the shape of the first
   two lines.
                For example, let's consider this paragraph.
            The paragraph indentation is taken from the second line.
            However the first line indentation is preserved.
            The formatted text is justified. So the result is

                For  example,  let's  consider   this   paragraph.   The
            paragraph indentation is taken from the second line. However
            the first  line indentation is preserved. The formatted text
            is justified. So the result is

            Note   how the paragraph is formatted when
                   the first line is less indented than the second one.
                   The paragraph indentation is lead by
                   the second line indentation.

            Note   how the paragraph is formatted when the first line is
                   less  indented  than  the  second  one. The paragraph
                   indentation is lead by the second line indentation.

   Hyphenations are correctly processed. Leading tabulators in the first
   two lines are expanded before text formatting. Other  tabulators  are
   assumed to be particular spaces.

FORMATTING USING PREFIXES AND SUFFIXES
   On the front panel of the Clipboard Manager you may find four  fields
   for formatting prefixes and suffixes. When a prefix  appears  in  the
   first formatted line the Clipboard Manager uses the  prefix  and  the
   corresponding suffix for formatting. The following example shows  how
   it works:

                    /*  Many C programmers like to arrange the multi-
		            /*  line comments using /* as the prefix and */ as
			the suffix for each line of a comment.
                        If you set /* as a prefix and */ as the
                        corresponding suffix of the Clipboard Manager,
                        this text will be formatted by
                        the following way:

                    /*  Many  C  programmers  like  to  arrange  the  */
                    /*  multi-line  comments  using /* as the prefix  */
                    /*  and  */  as  the  suffix  for each line of a  */
                    /*  comment. If you set /* as a prefix and */ as  */
                    /*  the  corresponding  suffix  of the Clipboard  */
                    /*  Manager,  this text will be formatted by the  */
                    /*  following way:                                */

   When a prefix is recognized, the Clipboard Manager works so as if the
   prefix and the corresponding suffix were removed from  all  lines  of
   the clipboard text BEFORE formatting. Formatting the text it adds the
   prefix and the suffix to each formatted line.

SORTING THE CLIPBOARD CONTENTS
   Lines in the clipboard are sorted  according  to  their  alphabetical
   order.  Tabulators  are considered as if they were expanded to spaces
   before sorting.

AUTHOR
   Dmitry A.Kazakov
   Luebeck, Germany
   Winter, 1994

