_________________________________________________________
Clippy 1.3.0 Beta 20827
Copyright (c) 2002 Way Out There Software
Email: wots@mail.com
URL: http://wots.coolfreepage.com/
_________________________________________________________

1. OVERVIEW

How often have you needed to extract text from your emails, only to
find the simple, menial task to take more time than it should. You'll
have many '>' characters appearing at the beginning of lines because
your email has been replied to, back and forth, countless number of
times. Often, you'll also need to painstakingly reformat the text to
make it appear readable.

Now with Clippy, you'll be able to remove '>' characters and reformat
your text with a single click of a button.

But why stop there? You can re-align the '>' characters that have been
concatenated into a single line; Strip HTML tags; Convert the case of
letters; Remove line breaks; Count the number of lines and words; And
more.

Clippy works by taking the text that you have copied to the clipboard,
sending the text through it's conversion engine and pushing the
reformatted text to the clipboard.

2. NEW IN THIS RELEASE

Release 1.3.0 Beta 20827

User interface modifications
New:      New pre-defined clippers to reformat an email nicely.  They
          are examples of complex clippers.
          Existing users will have to temporarily overwrite their
          current clippy.ini file with the clippy.ini from this
          release, or somehow copy the new clippers over to their
          current ini file.
Modified: The new clipper that is duplicated will have "Copy of "
          prepended to the original name.
Fixed:    Editing buttons above the assigned operations list was
          incorrect.

Operation modifications
Modified: "Align quote" will accept more than one character for the
          quote parameter.
Modified: "Align quote" now works similarly to the other alignment
          operations.  That is, alignment and formatting is based on
          paragraphs rather than the entire text.

Release 1.3.0 Beta 20825

User interface modifications
New:      Duplicate button - make a copy of the currently selected item
          in the "Defined clippers" and "Assigned operations" lists.
New:      Double clicking on an item in the "Defined clippers" list
          will invoke the edit dialog.
          Double clicking on an item in the "Assigned operations" list
          will unassign the operation from the clipper.
Modified: Double clicking on the tray icon will open the options dialog.
          Single clicking to execute the default clipper remains.
Fixed:    The Clippy tray icon will not be responsive if there the 
          options sheet or a message box is being displayed.
          
Operation modifications
New:      "Quote" allows adding text to the beginning of each line, and
          optionally append text to each line.
New:      "Remove line" will remove the specified line number and lines
          containing the specified text.  Either parameter may be
          specified or both.
Modified: "Unquote" will allow the removal of multiple characters from
          the beginning of each line.
Fixed:    "Search and replace" will not give an error message when the
          replace parameter is blank.
Fixed:    "Search and replace" with a blank replace parameter was
          the entire text.

Known problems:
- The default hotkey will not work for all key combinations.


Release 1.2.0 Build 20616
Modified: Changed the minimum value of the tab width parameter to 1.
          Setting it to 0 (zero) caused Clippy to crash.

Release 1.2.0 Beta 20609
Fixed:    It crashes when the default clipper is executed either by 
          left-clicking on the taskbar icon or by the hotkey
Fixed:    When "Align fill" operation was executed, the first line
          of the text was not indented to the left margin parameter.
Modified: Removed the left and right margin parameters for the "Align
          quote" operation because they didn't make sense.
          
Release 1.2.0 Beta 20601
New:      "Delete to end-of-line from column" operation
New:      "Delete to end-of-line from string" operation
New:      "Sort lines" operation
New:      "Search and replace" operation
New:      All operations have their own separate copy of parameters
New:      Hotkey to invoke the default clipper
New:      Double click to assign operations to a clipper in the
          Edit Clipper window

Release 1.1.0 Build 20410
New:      "Remove duplicate blank lines" operation
New:      "Convert DOS to Unix" operation
New:      "Convert Unix to DOS" operation
Modified: Renamed "Trim trailing spaces" to "Trim trailing white space"
Fixed:    Remove linebreaks removed CR characters, leaving LF characters
          on their own.  LF characters on their own is not supported by 
          Notepad.
Fixed:    Successive executions of clippers did not read the text from 
          the clipboard correctly.

Release 1.0.1 Build 20408
- Fixed: (Win95/98/ME) After a clipper was executed, the result was not 
  sent back to the clipboard.

Release 1.0.0 Build 20401
- This is the first release.

3. FEATURES

- Remove leading email quote characters
- Re-align email quote characters
- Strip HTML
- Count characters, words and lines
- Reformat paragraphs
- plus more operations...

- Define new "clippers" by grouping one or more operations together
- System tray icon
- Single-click execution of the default clipper

Platforms: Win95/98/ME/2000 
100% FREEWARE 

4. USAGE

When you run Clippy, it will place itself in the system tray.

Built-in to Clippy are a number of operations. Each operation performs
a single, pre-defined function, such as remove line breaks, remove '>'
characters and convert spaces to tabs. You can think of operations as
your basic building blocks.

The power of Clippy comes from the ability to group one or more
operations together to perform a complete task called a clipper. When
you run a clipper, all the operations assigned to it will be perform on
the text in the clipboard, in the order that was specified. They act
like one seamless task.

Clippy comes with four pre-defined clippers:
- Unquote, remove linebreaks: removes email quote characters and 
  reformats each paragraph.
  
  For example, the following text:
    
    This is my reply to your reply.
    
    > This is my reply.
    
    > > This is my original message.
    
  Becomes:
  
    This is my reply to your reply.
    
    This is my reply.
    
    This is my original message.  
    
- Align quotes: vertically align email quote characters

  For example, the following text:
  
    > This is > > malformed > >>text.
    
  Becomes:
  
    >This is
    >
    >malformed
    >
    >
    >text.   

- Strip HTML, remove linebreaks: removes all HTML tags and converts
  some character entities, and removes linebreaks.  Thus leaving just
  the text of the HTML document.
  
  For example, the following HTML:
  
    <html>
    <head>
    <title>Welcome</title>
    <script>
    var i;
    </script>
    <style>
    body { background-color: black; }
    </style>
    </head>
    <body>
    <p>
      Hello there!
      My name is &quot;Clippy&quot;.
    </p>
    </body>
    </html>

  Becomes:
  
    Welome
    
    Hello there! My name is "Clippy".

- Reformat paragraph: reflows paragraphs.

  For example, the following text:
  
    But don't worry, you do not need programming skills. Creating a clipper is a simple matter of naming it and clicking a button to assigned selected operations.
    
    The Clippy installation package comes with a number of pre-defined clippers to get you started.

  Becomes:
  
    But don't worry, you do not need programming skills. Creating a clipper
    is a simple matter of naming it and clicking a button to assigned
    selected operations.
    
    The Clippy installation package comes with a number of pre-defined
    clippers to get you started.

4.1 OPTIONS

Right click on Clippy to get a popup menu.  The popup menu has
the following items:

- All your defined clippers: Clicking on one of your defined clippers 
  will execute it.
  
  The clipper in bold is the default clipper.  Clicking with the left
  mouse button on the Clippy icon in the system tray will automatically
  execute the default clipper.
  
- Options: this item will open a property sheet with all the Clippy
  options.

  In the Clippers page:
  
  - Clippers listbox: lists all of your defined clippers.  The five
    buttons above the listbox are:
    
    - Edit:      allows you to modify the selected clipper.
    - New:       allows you to create a new clipper.
    - Duplicate: creates a copy of the selected clipper.
    - Delete:    permanently removes the selected clipper.
    - Move up:   shifts the selected clipper up one item.
    - Move down: shifts the selected clipper down one item.
    
  - Assigned operations: lists all the operations assigned to the 
    selected clipper.  Operations assigned to clippers can only be
    modified in the Edit Clipper window.
    
  - Assigned operation parameters: lists the parameters for the
    selected assigned operation.  The parameters are modifiable from
    the Edit Clipper window.
    
  - Default clipper: selects the default clipper.
  
  - Default is the last used clipper: If this option is off, the
    default clipper will always be the one specified as the "Default
    clipper".  If this options is on, the default clipper will be
    the clipper you last executed.
    
  In the General page:
  
  - Do not show result message: Turning this option on will suppress
    the message box that appears after the execution of a clipper. The
    message informs you about the success or failure of the clipper.
    
  - Hot key for the default clipper: Set a hot key for the default
    clipper.
    
The options are saved in a file called clippy.ini.  The clippy.ini file
should be in the same directory as the Clippy program file.

5. UNINSTALL

If you installed Clippy using the installer, run the Add/Remove
programs icon from the Control Panel, and click the Remove button for
Clippy from the list.

If you installed Clippy using the zip file, just delete the clippy.exe
and clippy.ini files.

6. LICENSE

This software is FREEWARE.

You may use this software for personal and commercial use.  You may not
change or charge anything for it.  You may not include this software as
part of another commercial software.

Way Out There Software takes no responsibility for data losses or damage 
caused by the software.  You at your own risk.

