═══ 1. Copyright ═══

ManyClip is (c) Copyright International Business Machines Corporation 1991, 
1994. All rights Reserved. 


═══ 2. Installation ═══

The installation of ManyClip is very simple.  The MANYCLIP.EXE file should be 
placed in a directory in the PATH (as defined in the CONFIG.SYS file), and 
STARTed.  ManyClip will automatically hook into the clipboard, and will work 
seamlessly with any application that uses the clipboard. 

(C) Copyright 1991, 1993  IBM Corporation 


═══ 3. Using ManyClip ═══

ManyClip provides OS/2 with multiple text clipboards.  Non-text (ie, bitmap) 
clipboards are not affected; you will still have a single clipboard for each 
format. 

From an applications point of view, the use of ManyClip is completely 
transparent.  Any text that is cut or copied to the clipboard will be 
intercepted by ManyClip, and placed in one of its clipboards.  Any text pasted 
from the clipboard will always be taken from ManyClip active clipboard. 

There are five primary clipboards (initially numbered 1 through 5), and an 
unlimited number of secondary clipboards (named automatically when they are 
created).  Any of the clipboards can be used to paste from; see the Clipboards 
pulldown for details.  Which clipboard is used for text copied to the clipboard 
depends on the current mode; see the Mode menu. 

Several other features are available to manipulate the clipboards; see the help 
for the Services pulldown, for the Popup menu, or for the clipboard list for 
details. 


═══ 4. Clipboards pulldown ═══

Clipboards

This pulldown allows you to select which clipboard should be made active.  Only 
the primary clipboards (the first five clipboards, numbered 1 through 5) are 
listed.  The secondary clipboards will only be shown in the clipboard list 
window.  Further details for both types are given below. 


═══ 4.1. Clipboards ═══

Clipboards
  ├ Clipboard 1
  ├ Clipboard 2
  ├ Clipboard 3
  ├ Clipboard 4
  └ Clipboard 5

The primary clipboards are created by ManyClip.  They are initially numbered 1 
through 5 (the names can be manually changed), and can not be destroyed. The 
contents of the primary clipboards can be erased, and newly clipped text can 
either replace or append to the current text.  A secondary clipboard can be 
created from a primary clipboard. 

A secondary clipboard is one that has been created by you. The contents of the 
secondary clipboards can be erased, and newly clipped text can either replace 
or append to the current text. Secondary clipboards can be created from other 
secondary clipboards. Secondary clipboards can also be destroyed. 


═══ 4.2. Next and Previous clipboards ═══

Clipboards
  ├ Prev
  └ Next

These options allow you to rotate around the clipboards, in opposite 
directions.  The nomenclature refers to the dirction moved, while in sliding 
mode -- the previous direction may not always take you to the actual previous 
clip.  Previous will rotate in ascending order, while next will rotate in 
descending order.  This functionality can also be obtained by double clicking 
on the ManyClip window. 


═══ 5. Mode Menu ═══

Mode

The mode of ManyClip dictates where newly clipped text is placed.  You may find 
that one particular mode is more intuitive for you, but all four are useful in 
different scenarios. The modes are Sliding mode, Fixed mode, Append mode, and 
Rotate mode. 


═══ 5.1. Sliding mode ═══

Mode
  └ Sliding

Sliding mode is generally the most flexible mode.  Whenever text is clipped, 
the active clipboard is reset to primary clipboard 1, and the new text placed 
there.  The previous contents of clipboard 1 slide down into clipboard 2, the 
contents of clipboard two slide down into clipboard 3, and so on.  If a 
clipboard is empty, text from the preceding clipboard will slide into it, but 
following clipboards will not be effected. If all 5 clipboards have text in 
them, the contents of clipboard 5 will be lost. 

This mode allows you to use the clipboard normally, and always have the 5 most 
previous clips available to you.  Clipboard 1 will always be the most recent 
clip, and clipboard 5 will contain the oldest text (not including secondary 
clipboards).  Secondary clipboards are not affected at all in sliding mode. 


═══ 5.2. Fixed mode ═══

Mode
  └ Fixed

Fixed mode is useful if you wish to replace the contents of any clipboard 
(primary or secondary) with new text.  In fixed mode, the selection of which 
clipboard is active is not changed.  Primary and secondary clipboards can be 
overwritten in fixed mode.  Manual selection of the active clipboard is not 
affected. 


═══ 5.3. Append mode ═══

Mode
  └ Append

Append mode is useful if you wish to compile a list of items from various 
places.  It behaves in a similar fashion to fixed mode, in that the selection 
of which clipboard is active is not changed. However unlike fixed mode, the 
previous contents of the clipboard are not replaced, but appended to by the new 
text. 

The append will be made directly to the end of the old text - no intermediate 
lines will be added between the texts.  Both primary and secondary clipboards 
can be appended to.  Manual selection of the active clipboard in append mode is 
not affected. 


═══ 5.4. Rotate mode ═══

Mode
  └ Rotate

Rotate mode is unlike any of the other modes, in that it causes all new copies 
to the clipboard to be discarded.  To remind you of this, a warble sound will 
be made every time you copy to the clipboard while in this mode. 

When a copy is made, the clipboard will rotate to the next available clipboard. 
This allows you to paste the contents of multiple clipboards to an application, 
without having to switch to ManyClip. Simply paste, and then copy to rotate, 
and paste again. 


═══ 6. Services ═══

Services

The Services menu provides several methods of manipulating the clipboards. 
Most functions apply to the currently active clipboard, but some apply to all 
clipboards, or to abstract settings. 


═══ 6.1. Set Name ═══

Services
  └ Set Name

The Set Name option allows you to change the name of any clipboard.  Although 
the name of a clipboard is initially created from the contents of the 
clipboard, the name assigned will not change if the contents change. 


═══ 6.2. Create ═══

Services
  └ Create

The create option allows you to create a new (secondary) clipboard.  The 
contents of the currently active clipboard will then be copied to the new 
clipboard, no matter if the current clipboard is a primary or secondary 
clipboard. 

The Set Name function will be invoked automatically, to allow you to change the 
name of the new clipboard if you wish.  A deafult name will be provided for 
you.  If you hit default, a dynamically changing name will be used for the 
clipboard. 


═══ 6.3. Destroy ═══

Services
  └ Destroy

This option allows you to destroy a secondary clipboard.  The destruction of a 
clipboard is different than erasing a clipboard, in that erasing removes only 
the contents.  Destroying a clipboard will erase the contents and the clipboard 
itself.  This option will be disabled when the active clipboard is a primary 
clipboard. 

This function can be undone. 


═══ 6.4. Erase ═══

Services
  └ Erase

The erase option allows you to erase the contents of the clipboard. 

This option is particularly useful in sliding mode, as primary clipboards will 
slide into an empty clipboard, without pushing subsequent clipboards down. 
This can be used to prolong the length of time before the contents of clipboard 
5 are slid off the end, and lost. 

This function can be undone. 


═══ 6.5. Undo ═══

Services
  └ Undo

The undo option allows you to undo the most recent erase or destroy operation. 
The contents of the old clipboard will be placed in a new clipboard, named 
Undo. 

It is important to note that edit operations (from the pop-up menu) are not 
saved as part of the undo feature.  The undo data is not saved, and will be 
lost when ManyClip is closed. 


═══ 6.6. Print Clipboard ═══

Services
  └ Print Clipboard

The print menu provides the ability to print the contents of either one or all 
clipboards.  All printing is done as plain text.  You can print a clipboard 
now, or you can set which printer to use. 


═══ 6.6.1. Print now ═══

Services
  └ Print Clipboard
   └ Now

This option will copy the contents of the current clipboard to the active 
printer.  The printing will be done as simple plain text, with no formatting. 
This means that you will not be able to print directly to a printer that 
requires processing, such as a postscript printer. To print in this case, save 
the clipboard to a file, and then use the Work Place Shell to print the file. 


═══ 6.6.2. Printer selection options ═══

Services
  └ Print Clipboard
   ├ LPT1
   ├ LPT2
   └ LPT3

These menus will select which printer is the active printer. Any printing will 
be sent only to the active printer. 


═══ 6.7. Save Clipboards ═══

Services
  └ Save Clipboards

The Save Clipboards menu provides you with persistent clipboards that survive a 
system shutdown, and an easy way to save the clipboard to a file.  You can save 
the clipboards now, set that the clipboards should be saved on closing or every 
night, or you can save the current clipboard as a text file. 


═══ 6.7.1. Save Clipboards Now ═══

Services
  └ Save Clipboards
   └ Now

This option will save all the clipboard data to the designated directory, in a 
format that will be read when ManyClip next starts. This allows you to retain 
the contents of all the current clipboards, and reuse them in a future session. 
If you do not wish to have the clipboards saved automatically for you, you can 
use this option to determine when the data should be saved. 


═══ 6.7.2. Save Clipboards On Closing ═══

Services
  └ Save Clipboards
   └ On closing

This toggle allows you to specify if the clipboard contents should be 
automatically saved when ManyClip is closed.  The data will be written to the 
designated directory, in a format that will be read when ManyClip next starts. 
This allows you to retain the contents of all the clipboards, and reuse them in 
a future session. 


═══ 6.7.3. Save Clipboards Every Night ═══

Services
  └ Save Clipboards
   └ Every night

This toggle allows you to specify if the clipboard contents should be 
automatically saved every night, at 1:00am.  The data will be written to the 
designated directory, in a format that will be read when ManyClip next starts. 
This allows you to retain the contents of all the clipboards, and reuse them in 
a future session. 

This option is useful if you do not regularly shut OS/2 down, but wish the 
contents of the clipboards to saved regularly in case of system failure. 


═══ 6.7.4. Save as file... ═══

Services
  └ Save Clipboards
   └ Save as file

This option will save the contents of the current clipboard to a text file. 
This file can be used in any text editor (such as EPM), printed, or saved for 
later reference.  The file is not designed to be re-read by ManyClip at a later 
date. 


═══ 7. Popup menu ═══

Popup menu

The popup menu provides extra functionality, that applies specifically to the 
current clipboard.  Some actions are context sensitive - that is, they depend 
on the selection state of clipboard text. 

The primary functions of the popup menu are to select or exit edit mode, and to 
use ManyClips local clipboard. 


═══ 7.1. Edit ═══

Popup menu
  └ Edit

This item puts the current clipboard into an edit mode.  In this mode, you can 
make any changes you wish to the clipboard, including adding new text, deleting 
text, and reformatting the existing text. The mode is indicated by the 
background colour changing to white. Edit mode is ended by either reselecting 
Edit from the popup menu, or by switching to another OS/2 session.  This allows 
you to make a change to the clipboard, switch to your application, and paste 
the change -- no save operation is necessary. 

Note that there is no cancel operation from edit mode -- you cannot make 
changes, and then decide you do not wish to have them applied. 


═══ 7.2. Local Clipboard ═══

Popup menu
  ├ Local Copy
  ├ Local Cut
  └ Local Paste

Local copy, Local cut, and Local paste are the ManyClip equivalents to the 
normal copy, cut and paste to the clipboard operations. As ManyClip is always 
dealing with the clipboard, the usual operations would not allow one to cut and 
paste between clipboards.  The Local functions therefore do not affect the 
system clipboard, but are only valid from within ManyClip. 

Note that you do not have to be in edit mode to use these functions. 
Therefore, this provides an extremely fast way to remove portions of a 
clipboard, or to join two pieces of data. 


═══ 8. Other dialogs ═══


═══ 8.1. Clipboard List ═══

The clipboard list window shows you the title of every clipboard, or (empty) if 
it is empty.  This window will automatically close when you switch back to 
ManyClip or to another application, so you can quickly and easily refer to the 
list.  If you select (either with the enter key, or by double clicking with the 
mouse) a clipboard, that clipboard will be made the active one, and you will be 
returned to ManyClip. 


═══ 8.2. Set Clipboard Name ═══

This window allows you to enter a new name for the clipboard. The default name 
is derived from the current contents of the clipboard.  Setting the name will 
attach it to this clipboard, and it will not be affected by changes in the 
contents of the clipboard.  If you wish the clipboard to follow the default 
naming convention and dynamically change with the contents of the clipboard, 
hit the default button. 


═══ 8.3. Enter save directory ═══

Enter the directory name that the persistent clipboards should be saved in. The 
clipboards will be saved in a format that will be re-read by ManyClip when it 
is next started.  The data will be saved in the directory you select, in a file 
named ManyClip.INI.  The data can be saved immediately, when ManyClip closes, 
or automatically every night. 


═══ 9. Help for Key Assignments ═══

The following keys can be used to quickly manipulate ManyClip. 

Ctrl+1 
     Make primary clipboard 1 the active clipboard 

Ctrl+2 
     Make primary clipboard 2 the active clipboard 

Ctrl+3 
     Make primary clipboard 3 the active clipboard 

Ctrl+4 
     Make primary clipboard 4 the active clipboard 

Ctrl+5 
     Make primary clipboard 5 the active clipboard 

Ctrl+A 
     Switch ManyClip to append mode 

Ctrl+C 
     create a new clipboard 

Ctrl+F 
     Switch ManyClip to fixed mode 

Ctrl+L 
     Display the clipboard list 

Ctrl+P 
     Rotate to theprevious clipboard. 

Ctrl+N 
     Rotate to thenext clipboard. 

Ctrl+R 
     Switch ManyClip to rotate mode 

Ctrl+S 
     Switch ManyClip to sliding mode 

Ctrl+U 
     undo last erase or destroy 

F1 
     Activate this help 

Mouse button 1 double click 
     Rotate to theprevious clipboard. 

Mouse button 2 double click 
     Rotate to thenext clipboard. 

Mouse chord (buttons 1 and 2) 
     Display the clipboard list 

Mouse button 2 (by default) 
     Display clipboard popup menu