OS/2 Shareware BBS: 5 Edit/05-Edit.zip/mclip.zip/manyclip.HLP

OS/2 Help File | 1994-03-30 | 15KB | 475 lines

ΓòÉΓòÉΓòÉ 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