head	1.20;
access;
symbols
	core-8-5-9:1.16.2.1
	core-8-5-8:1.16
	macosx-cocoa-merge:1.18
	macosx-cocoa-premerge:1.18
	macosx-carbon-freeze:1.18
	core-8-5-7:1.16
	core-8-5-6:1.16
	core-8-6-b1:1.18
	core-8-6-a3:1.18
	core-8-5-5:1.16
	core-8-6-a2:1.17
	core-8-5-4:1.16
	core-8-5-3:1.16
	core-8-6-a1:1.16
	core-8-4-19:1.5.2.1
	core-8-5-branch:1.16.0.2
	core-8-5-2:1.16
	core-8-4-18:1.5.2.1
	core-8-5-1:1.16
	core-8-4-17:1.5.2.1
	core-8-5-0:1.16
	core-8-5-b3:1.15
	core-8-5-b2:1.14
	core-8-4-16:1.5.2.1
	core-8-5-b1:1.11
	core-stablilizer-merge:1.11
	core-stabilizer-branch:1.11.0.2
	core-stabilizer-merge:1.16
	core-8-4-15:1.5.2.1
	core-8-5-a6:1.11
	core-8-5-a5:1.11
	core-8-4-14:1.5.2.1
	core-8-5-a4:1.11
	core-8-4-13:1.5.2.1
	core-8-4-12:1.5.2.1
	core-8-4-11:1.5.2.1
	core-8-5-a3:1.10
	core-8-4-10:1.5.2.1
	core-8-4-9-branch:1.5.2.1.0.2
	core-8-5-a2:1.9
	core-8-4-9:1.5.2.1
	core-8-4-8:1.5.2.1
	core-8-4-7:1.5
	core-8-5-a1:1.6
	core-8-4-6:1.5
	core-8-4-5:1.5
	mistachkin-dev-branch:1.5.0.4
	core-8-4-4:1.5
	core-8-4-3:1.5
	core-8-4-branch:1.5.0.2
	core-8-4-2:1.5
	core-8-4-1:1.5
	core-8-3-5:1.2
	core-8-4-0:1.5
	macosx-8-4-merge-2002-08-31-trunk:1.5
	macosx-8-4-premerge-2002-08-31-branch:1.4.2.1
	macosx-8-4-premerge-2002-08-31-trunk:1.5
	macosx-8-4-merge-2002-08-30-branch:1.4.2.1
	macosx-8-4-merge-2002-08-30-trunk:1.5
	macosx-8-4-merge-2002-08-20-branch:1.4.2.1
	macosx-8-4-merge-2002-08-20-trunk:1.5
	core-8-4-b2:1.5
	core-8-4-b1:1.5
	macosx-premerge-6-9-02:1.4
	core-8-4-a4:1.4
	core-8-3-4:1.2
	macosx-8-4-branch:1.4.0.2
	macosx-8-4-branchpoint:1.4
	core-8-4-a3:1.4
	core-8-3-3:1.2
	dgp-privates-into-namespace:1.3.0.4
	tclpro-1-5-0:1.2
	core-8-4-win-speedup:1.3.0.2
	core-8-4-a2:1.3
	tclpro-1-4-1:1.2
	tclpro-1-4-0:1.2
	core-8-3-2:1.2
	ajuba-ajuba2-2-1-base:1.2
	ajuba-ajuba2-2-0:1.2
	core-8-4-a1:1.3
	core-8-3-1-branch:1.2.0.18
	core-8-3-1:1.2
	scriptics-sc-2-0-b5:1.2
	scriptics-sc-2-0-fixed:1.2
	scriptics-sc-2-0-b2:1.2
	scriptics-sc-2-0-b1:1.2
	core-8-3-0:1.2
	core-8-3-b2:1.2
	core-8-3-b1:1.2
	scriptics-sc-1-1:1.2
	scriptics-sc-1-1-b1:1.2
	core-8-2-3:1.2
	scriptics-sc-1-1-branch:1.2.0.16
	scriptics-sc-1-1-base:1.2
	scriptics-sc-1-0:1.2
	scriptics-sc-1-0-branch:1.2.0.14
	scriptics-sc-1-0-base:1.2
	core-8-2-2:1.2
	core-8-2-1:1.2
	scriptics-bc-1-0-b1:1.2
	core-8-2-1-branch:1.2.0.12
	scriptics-tclpro-1-3-0:1.2
	core-8-2-0:1.2
	core-8-2-b3-branch:1.2.0.10
	core-8-2-b3-base:1.2
	scriptics-tclpro-1-3-b4:1.2
	core-8-2-b2:1.2
	scriptics-tclpro-1-3-b3:1.2
	core-8-2-b1:1.2
	scriptics-tclpro-1-3-b2:1.2
	merge-to-mainline-5/21/99:1.2
	scriptics-tclpro-1-3-b2-branch:1.2.0.8
	core-8-1-1:1.2
	scriptics-tclpro-1-3-b1:1.2
	core-8-1-1-base:1.2
	core-8-1-0:1.2
	merge-to-mainline-4-29-99:1.2
	merge-to-mainline-4-23-99:1.2
	core-8-1-branch-old:1.1.0.4
	core-8-0-6-branch:1.2.0.6
	core-8-0-6-base:1.2
	core-8-0-5:1.2
	core-8-1-b3:1.1.4.1
	core-8-1-b2:1.1.4.1
	dev-8-1-stubs-branch:1.1.4.1.0.2
	dev-stubs-branch:1.2.0.4
	scriptics-tclpro-1-2:1.2
	scriptics-tclpro-1-2-b2:1.2
	core-8-1-merge-2/10/99:1.2
	core-8-0-5-branch:1.2.0.2
	core-8-0-5-base:1.2
	scriptics-tclpro-1-2-b1:1.2
	scriptics-tclpro-1-2-a1:1.2
	core-8-1-b1:1.1.4.1
	core-8-0-4:1.2
	core-8-1-a2:1.1
	core-8-0-2:1.1
	core-8-0-3:1.2;
locks; strict;
comment	@# @;


1.20
date	2010.03.04.13.32.20;	author dkf;	state Exp;
branches;
next	1.19;

1.19
date	2010.01.13.16.09.25;	author dkf;	state Exp;
branches;
next	1.18;

1.18
date	2008.09.23.13.36.37;	author dkf;	state Exp;
branches;
next	1.17;

1.17
date	2008.06.30.22.57.02;	author dkf;	state Exp;
branches;
next	1.16;

1.16
date	2007.12.13.15.23.43;	author dgp;	state Exp;
branches
	1.16.2.1;
next	1.15;

1.15
date	2007.10.29.16.04.13;	author dkf;	state Exp;
branches;
next	1.14;

1.14
date	2007.10.26.20.13.23;	author dgp;	state Exp;
branches;
next	1.13;

1.13
date	2007.10.24.14.32.58;	author dkf;	state Exp;
branches;
next	1.12;

1.12
date	2007.10.22.14.33.13;	author dkf;	state Exp;
branches;
next	1.11;

1.11
date	2005.08.04.10.01.59;	author dkf;	state Exp;
branches
	1.11.2.1;
next	1.10;

1.10
date	2005.04.06.21.11.54;	author dkf;	state Exp;
branches;
next	1.9;

1.9
date	2004.10.28.10.22.51;	author dkf;	state Exp;
branches;
next	1.8;

1.8
date	2004.06.18.21.27.38;	author dkf;	state Exp;
branches;
next	1.7;

1.7
date	2004.06.18.21.16.21;	author dkf;	state Exp;
branches;
next	1.6;

1.6
date	2004.03.04.00.06.06;	author hobbs;	state Exp;
branches;
next	1.5;

1.5
date	2002.07.04.01.09.47;	author hobbs;	state Exp;
branches
	1.5.2.1;
next	1.4;

1.4
date	2001.06.04.03.15.20;	author hobbs;	state Exp;
branches
	1.4.2.1;
next	1.3;

1.3
date	2000.05.14.23.25.03;	author ericm;	state Exp;
branches
	1.3.2.1
	1.3.4.1;
next	1.2;

1.2
date	98.09.14.18.22.55;	author stanton;	state Exp;
branches;
next	1.1;

1.1
date	98.04.01.09.39.50;	author rjohnson;	state Exp;
branches
	1.1.4.1;
next	;

1.1.4.1
date	98.09.30.02.16.14;	author stanton;	state Exp;
branches;
next	;

1.3.2.1
date	2002.04.02.20.57.53;	author hobbs;	state Exp;
branches;
next	;

1.3.4.1
date	2001.07.03.20.01.07;	author dgp;	state Exp;
branches;
next	;

1.4.2.1
date	2002.08.20.20.27.00;	author das;	state Exp;
branches;
next	;

1.5.2.1
date	2004.10.28.10.19.29;	author dkf;	state Exp;
branches;
next	;

1.11.2.1
date	2007.10.24.12.59.30;	author dgp;	state Exp;
branches;
next	1.11.2.2;

1.11.2.2
date	2007.10.27.04.23.13;	author dgp;	state Exp;
branches;
next	1.11.2.3;

1.11.2.3
date	2007.11.01.16.37.14;	author dgp;	state Exp;
branches;
next	;

1.16.2.1
date	2010.03.04.13.34.00;	author dkf;	state Exp;
branches;
next	;


desc
@@


1.20
log
@Added note about transfer types, prompted by question on Tcler's Chat.
@
text
@'\"
'\" Copyright (c) 1994 The Regents of the University of California.
'\" Copyright (c) 1994-1996 Sun Microsystems, Inc.
'\"
'\" See the file "license.terms" for information on usage and redistribution
'\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
'\" 
'\" RCS: @@(#) $Id: clipboard.n,v 1.19 2010/01/13 16:09:25 dkf Exp $
'\" 
.so man.macros
.TH clipboard n 8.4 Tk "Tk Built-In Commands"
.BS
'\" Note:  do not modify the .SH NAME line immediately below!
.SH NAME
clipboard \- Manipulate Tk clipboard
.SH SYNOPSIS
\fBclipboard \fIoption\fR ?\fIarg arg ...\fR?
.BE
.SH DESCRIPTION
.PP
This command provides a Tcl interface to the Tk clipboard,
which stores data for later retrieval using the selection mechanism 
(via the \fB\-selection CLIPBOARD\fR option).
In order to copy data into the clipboard, \fBclipboard clear\fR must
be called, followed by a sequence of one or more calls to \fBclipboard
append\fR.  To ensure that the clipboard is updated atomically, all
appends should be completed before returning to the event loop.
.PP
The first argument to \fBclipboard\fR determines the format of the
rest of the arguments and the behavior of the command.  The following
forms are currently supported:
.TP
\fBclipboard append\fR ?\fB\-displayof\fR \fIwindow\fR? ?\fB\-format\fR \fIformat\fR? ?\fB\-type\fR \fItype\fR? ?\fB\-\|\-\fR? \fIdata\fR
.
Appends \fIdata\fR to the clipboard on \fIwindow\fR's
display in the form given by \fItype\fR with the representation given
by \fIformat\fR and claims ownership of the clipboard on \fIwindow\fR's
display.
.RS
.PP
\fIType\fR specifies the form in which the selection is to be returned
(the desired
.QW target
for conversion, in ICCCM terminology), and
should be an atom name such as \fBSTRING\fR or \fBFILE_NAME\fR; see the
Inter-Client Communication Conventions Manual for complete details.
\fIType\fR defaults to \fBSTRING\fR.
.PP
The \fIformat\fR argument specifies the representation that should be
used to transmit the selection to the requester (the second column of
Table 2 of the ICCCM), and defaults to \fBSTRING\fR.  If \fIformat\fR is
\fBSTRING\fR, the selection is transmitted as 8-bit ASCII characters.  If
\fIformat\fR is \fBATOM\fR, then the \fIdata\fR is
divided into fields separated by white space; each field is converted
to its atom value, and the 32-bit atom value is transmitted instead of
the atom name.  For any other \fIformat\fR,  \fIdata\fR is divided
into fields separated by white space and each 
field is converted to a 32-bit integer; an array of integers is
transmitted to the selection requester.  Note that strings passed to
\fBclipboard append\fR are concatenated before conversion, so the
caller must take care to ensure appropriate spacing across string
boundaries.  All items appended to the clipboard with the same
\fItype\fR must have the same \fIformat\fR.
.PP
The \fIformat\fR argument is needed only for compatibility with
clipboard requesters that do not use Tk.  If the Tk toolkit is being
used to retrieve the \fBCLIPBOARD\fR selection then the value is
converted back to a string at the requesting end, so \fIformat\fR is
irrelevant.
.PP
A \fB\-\|\-\fR argument may be specified to mark the end of options:  the
next argument will always be used as \fIdata\fR.
This feature may be convenient if, for example, \fIdata\fR starts
with a \fB\-\fR.
.RE
.TP
\fBclipboard clear\fR ?\fB\-displayof\fR \fIwindow\fR?
.
Claims ownership of the clipboard on \fIwindow\fR's display and removes
any previous contents.  \fIWindow\fR defaults to
.QW . .
Returns an empty string.
.TP
\fBclipboard get\fR ?\fB\-displayof\fR \fIwindow\fR? ?\fB\-type\fR \fItype\fR?
.
Retrieve data from the clipboard on \fIwindow\fR's display.
\fIWindow\fR defaults to
.QW . .
\fIType\fR specifies the form in which
the data is to be returned and should be an atom name such as \fBSTRING\fR
or \fBFILE_NAME\fR.  \fIType\fR defaults to \fBSTRING\fR.  This command is
equivalent to
.QW "\fBselection\fR \fBget \-selection CLIPBOARD\fR" .
.RS
.PP
Note that on modern X11 systems, the most useful type to retrieve for
transferred strings is not \fBSTRING\fR, but rather \fBUTF8_STRING\fR.
.RE
.SH EXAMPLES
.PP
Get the current contents of the clipboard.
.CS
if {[catch {\fBclipboard get\fR} contents]} {
    # There were no clipboard contents at all
}
.CE
.PP
Set the clipboard to contain a fixed string.
.CS
\fBclipboard clear\fR
\fBclipboard append\fR "some fixed string"
.CE
.PP
You can put custom data into the clipboard by using a custom \fB\-type\fR
option. This is not necessarily portable, but can be very useful. The
method of passing Tcl scripts this way is effective, but should be mixed
with safe interpreters in production code.
.CS
# This is a very simple canvas serializer;
# it produces a script that recreates the item(s) when executed
proc getItemConfig {canvas tag} {
   set script {}
   foreach item [$canvas find withtag $tag] {
      append script {$canvas create } [$canvas type $item]
      append script { } [$canvas coords $item] { }
      foreach config [$canvas itemconf $item] {
         lassign $config name \- \- \- value
         append script [list $name $value] { }
      }
      append script \en
   }
   return [string trim $script]
}

# Set up a binding on a canvas to cut and paste an item
set c [canvas .c]
pack $c
$c create text 150 30 \-text "cut and paste me"
bind $c <<Cut>> {
   \fBclipboard clear\fR
   \fBclipboard append \-type\fR TkCanvasItem \e
         [getItemConfig %W current]
   # Delete because this is cut, not copy.
   %W delete current
}
bind $c <<Paste>> {
   catch {
      set canvas %W
      eval [\fBclipboard get \-type\fR TkCanvasItem]
   }
}
.CE
.SH "SEE ALSO"
interp(n), selection(n)
.SH KEYWORDS
clear, format, clipboard, append, selection, type
'\" Local Variables:
'\" mode: nroff
'\" End:
@


1.19
log
@Tidy up subcommand order and formatting
@
text
@d8 1
a8 1
'\" RCS: @@(#) $Id: clipboard.n,v 1.18 2008/09/23 13:36:37 dkf Exp $
d94 5
@


1.18
log
@Fix [Bug 2118116]
@
text
@d8 1
a8 1
'\" RCS: @@(#) $Id: clipboard.n,v 1.17 2008/06/30 22:57:02 dkf Exp $
a31 7
.PP
.TP
\fBclipboard clear\fR ?\fB\-displayof\fR \fIwindow\fR?
Claims ownership of the clipboard on \fIwindow\fR's display and removes
any previous contents.  \fIWindow\fR defaults to
.QW . .
Returns an empty string.
d34 1
d45 1
a45 1
should be an atom name such as STRING or FILE_NAME; see the
d47 1
a47 1
\fIType\fR defaults to STRING.
d51 3
a53 3
Table 2 of the ICCCM), and defaults to STRING.  If \fIformat\fR is
STRING, the selection is transmitted as 8-bit ASCII characters.  If
\fIformat\fR is ATOM, then the \fIdata\fR is
d67 2
a68 2
used to retrieve the CLIPBOARD selection then the value is converted back to
a string at the requesting end, so \fIformat\fR is
d77 7
d85 1
d90 2
a91 2
the data is to be returned and should be an atom name such as STRING
or FILE_NAME.  \fIType\fR defaults to STRING.  This command is
d93 1
a93 1
.QW "\fBselection get \-selection CLIPBOARD\fR" .
@


1.17
log
@Minor doc updates (removing out of date changebars, improving typedef formatting,
 etc.)
@
text
@a0 1
'\" -*- nroff -*-
d8 1
a8 1
'\" RCS: @@(#) $Id: clipboard.n,v 1.16 2007/12/13 15:23:43 dgp Exp $
d150 3
@


1.16
log
@merge stable branch onto HEAD
@
text
@d1 1
d9 1
a9 1
'\" RCS: @@(#) $Id: clipboard.n,v 1.11.2.3 2007/11/01 16:37:14 dgp Exp $
a19 1

d94 1
a146 1

a148 1

@


1.16.2.1
log
@Added note about transfer types, prompted by question on Tcler's Chat.
@
text
@d8 1
a8 1
'\" RCS: @@(#) $Id: clipboard.n,v 1.16 2007/12/13 15:23:43 dgp Exp $
a92 5
.RS
.PP
Note that on modern X11 systems, the most useful type to retrieve for
transferred strings is not \fBSTRING\fR, but rather \fBUTF8_STRING\fR.
.RE
@


1.15
log
@Lots more GOOBE stuff. Now works with 'make html'!
@
text
@d8 1
a8 1
'\" RCS: @@(#) $Id: clipboard.n,v 1.14 2007/10/26 20:13:23 dgp Exp $
@


1.14
log
@        * doc/*.1:              Revert doc changes that broke
        * doc/*.3:              `make html` so we can get the release
        * doc/*.n:              out the door.
@
text
@d8 1
a8 1
'\" RCS: @@(#) $Id: clipboard.n,v 1.11 2005/08/04 10:01:59 dkf Exp $
d24 1
a24 1
(via the \fB-selection CLIPBOARD\fR option).
d37 3
a39 2
any previous contents.  \fIWindow\fR defaults to ``.''.  Returns an
empty string.
d49 3
a51 1
(the desired ``target'' for conversion, in ICCCM terminology), and
d73 1
a73 1
clipboard requesters that don't use Tk.  If the Tk toolkit is being
d86 3
a88 1
\fIwindow\fR defaults to ".".  \fIType\fR specifies the form in which
d91 2
a92 1
equivalent to \fBselection get -selection CLIPBOARD\fR.
d120 1
a120 1
         lassign $config name - - - value
d123 1
a123 1
      append script \\n
d131 1
a131 1
$c create text 150 30 -text "cut and paste me"
d134 1
a134 1
   \fBclipboard append -type\fR TkCanvasItem \\
d142 1
a142 1
      eval [\fBclipboard get -type\fR TkCanvasItem]
@


1.13
log
@Lots of improvements to look and feel of manual pages
@
text
@d8 1
a8 1
'\" RCS: @@(#) $Id: clipboard.n,v 1.12 2007/10/22 14:33:13 dkf Exp $
d37 2
a38 3
any previous contents.  \fIWindow\fR defaults to
.QW . .
Returns an empty string.
d48 1
a48 3
(the desired
.QW target
for conversion, in ICCCM terminology), and
d128 1
a128 1
   \fBclipboard append -type\fR TkCanvasItem \e
@


1.12
log
@Documentation improvements, all minor.
@
text
@d8 1
a8 1
'\" RCS: @@(#) $Id: clipboard.n,v 1.11 2005/08/04 10:01:59 dkf Exp $
d37 3
a39 2
any previous contents.  \fIWindow\fR defaults to ``.''.  Returns an
empty string.
d49 3
a51 1
(the desired ``target'' for conversion, in ICCCM terminology), and
@


1.11
log
@Added another example.
@
text
@d8 1
a8 1
'\" RCS: @@(#) $Id: clipboard.n,v 1.10 2005/04/06 21:11:54 dkf Exp $
d128 1
a128 1
   \fBclipboard append -type\fR TkCanvasItem \\
@


1.11.2.1
log
@merge updates from HEAD
@
text
@d8 1
a8 1
'\" RCS: @@(#) $Id: clipboard.n,v 1.11 2005/08/04 10:01:59 dkf Exp $
d128 1
a128 1
   \fBclipboard append -type\fR TkCanvasItem \e
@


1.11.2.2
log
@merge updates from HEAD
@
text
@d8 1
a8 1
'\" RCS: @@(#) $Id: clipboard.n,v 1.11.2.1 2007/10/24 12:59:30 dgp Exp $
d128 1
a128 1
   \fBclipboard append -type\fR TkCanvasItem \\
@


1.11.2.3
log
@merge updates from HEAD
@
text
@d8 1
a8 1
'\" RCS: @@(#) $Id$
d24 1
a24 1
(via the \fB\-selection CLIPBOARD\fR option).
d37 2
a38 3
any previous contents.  \fIWindow\fR defaults to
.QW . .
Returns an empty string.
d48 1
a48 3
(the desired
.QW target
for conversion, in ICCCM terminology), and
d70 1
a70 1
clipboard requesters that do not use Tk.  If the Tk toolkit is being
d83 1
a83 3
\fIWindow\fR defaults to
.QW . .
\fIType\fR specifies the form in which
d86 1
a86 2
equivalent to
.QW "\fBselection get \-selection CLIPBOARD\fR" .
d114 1
a114 1
         lassign $config name \- \- \- value
d117 1
a117 1
      append script \en
d125 1
a125 1
$c create text 150 30 \-text "cut and paste me"
d128 1
a128 1
   \fBclipboard append \-type\fR TkCanvasItem \e
d136 1
a136 1
      eval [\fBclipboard get \-type\fR TkCanvasItem]
@


1.10
log
@Purge old and inaccurate .VS/.VE macros.
@
text
@d8 1
a8 1
'\" RCS: @@(#) $Id: clipboard.n,v 1.9 2004/10/28 10:22:51 dkf Exp $
d100 40
d142 1
a142 1
selection(n)
@


1.9
log
@Assorted minor documentation fixes
@
text
@d8 1
a8 1
'\" RCS: @@(#) $Id: clipboard.n,v 1.8 2004/06/18 21:27:38 dkf Exp $
a81 1
.VS 8.4
a86 1
.VE 8.4
@


1.8
log
@Fix missing parameter error
@
text
@d8 1
a8 1
'\" RCS: @@(#) $Id: clipboard.n,v 1.7 2004/06/18 21:16:21 dkf Exp $
a79 1
.VS 8.4
d82 1
d92 1
a92 1
if {[catch {\fBclipboard\fR get} contents]} {
d99 2
a100 2
\fBclipboard\fR clear
\fBclipboard\fR append "some fixed string"
@


1.7
log
@Added examples
@
text
@d8 1
a8 1
'\" RCS: @@(#) $Id: clipboard.n,v 1.6 2004/03/04 00:06:06 hobbs Exp $
d82 1
a82 1
\fBclipboard get\fR ?\fB\-displayof\fR \fIwindow\fR? ?\fB\-type\fR?
@


1.6
log
@minor doc fixes for html conversion
@
text
@d8 1
a8 1
'\" RCS: @@(#) $Id: clipboard.n,v 1.5 2002/07/04 01:09:47 hobbs Exp $
d89 13
d104 1
a104 1
selection
@


1.5
log
@minor doc clarification (lester)
@
text
@d8 1
a8 1
'\" RCS: @@(#) $Id: clipboard.n,v 1.4 2001/06/04 03:15:20 hobbs Exp $
d80 1
a81 1
.VS 8.4
@


1.5.2.1
log
@Backport of documentation fixes
@
text
@d8 1
a8 1
'\" RCS: @@(#) $Id: clipboard.n,v 1.5 2002/07/04 01:09:47 hobbs Exp $
a80 1
\fBclipboard get\fR ?\fB\-displayof\fR \fIwindow\fR? ?\fB\-type\fR \fItype\fR?
d82 1
a88 13
.SH EXAMPLES
Get the current contents of the clipboard.
.CS
if {[catch {\fBclipboard get\fR} contents]} {
    # There were no clipboard contents at all
}
.CE
.PP
Set the clipboard to contain a fixed string.
.CS
\fBclipboard clear\fR
\fBclipboard append\fR "some fixed string"
.CE
d91 1
a91 1
selection(n)
@


1.4
log
@	* doc/selection.n:
	* doc/clipboard.n: added SEE ALSOs to cross-reference selection
	and clipboard, with extra note for clipboard command in selection
	docs.  [Patch #422256]
@
text
@d8 1
a8 1
'\" RCS: @@(#) $Id: clipboard.n,v 1.3 2000/05/14 23:25:03 ericm Exp $
d23 2
a24 1
which stores data for later retrieval using the selection mechanism.
@


1.4.2.1
log
@merged with trunk at tag macosx-8-4-merge-2002-08-20-trunk
@
text
@d8 1
a8 1
'\" RCS: @@(#) $Id$
d23 1
a23 2
which stores data for later retrieval using the selection mechanism 
(via the \fB-selection CLIPBOARD\fR option).
@


1.3
log
@* doc/clipboard.n: Added documentation for "clipboard get".

* generic/tkClipboard.c (Tk_ClipboardCmd): Added "clipboard get"
subcommand [RFE: 4628].

* tests/clipboard.test: Updated to use "clipboard get" instead of
"selection get -s CLIPBOARD".
@
text
@d8 1
a8 1
'\" RCS: @@(#) $Id: clipboard.n,v 1.2 1998/09/14 18:22:55 stanton Exp $
d11 1
a11 1
.TH clipboard n 4.0 Tk "Tk Built-In Commands"
d80 1
d87 4
@


1.3.2.1
log
@sync with head
@
text
@d8 1
a8 1
'\" RCS: @@(#) $Id: clipboard.n,v 1.4 2001/06/04 03:15:20 hobbs Exp $
d11 1
a11 1
.TH clipboard n 8.4 Tk "Tk Built-In Commands"
a79 1
.VS 8.4
a85 4
.VE 8.4

.SH "SEE ALSO"
selection
@


1.3.4.1
log
@        * Merged in updates from HEAD branch.
@
text
@d8 1
a8 1
'\" RCS: @@(#) $Id: clipboard.n,v 1.4 2001/06/04 03:15:20 hobbs Exp $
d11 1
a11 1
.TH clipboard n 8.4 Tk "Tk Built-In Commands"
a79 1
.VS 8.4
a85 4
.VE 8.4

.SH "SEE ALSO"
selection
@


1.2
log
@Replaced SCCS strings, fixed binary files
@
text
@d8 1
a8 1
'\" RCS: @@(#) $Id$
d79 7
@


1.1
log
@Initial revision
@
text
@d8 1
a8 1
'\" SCCS: @@(#) clipboard.n 1.9 96/03/26 18:21:12
@


1.1.4.1
log
@Merged 8.0.3 changes into 8.1
@
text
@d8 1
a8 1
'\" RCS: @@(#) $Id: clipboard.n,v 1.2 1998/09/14 18:22:55 stanton Exp $
@


