diff options
Diffstat (limited to 'doc/dde.n')
-rw-r--r-- | doc/dde.n | 36 |
1 files changed, 7 insertions, 29 deletions
@@ -4,8 +4,8 @@ '\" '\" See the file "license.terms" for information on usage and redistribution '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES. -'\" -.TH dde n 1.4 dde "Tcl Bundled Packages" +'\" +.TH dde n 1.3 dde "Tcl Bundled Packages" .so man.macros .BS '\" Note: do not modify the .SH NAME line immediately below! @@ -13,15 +13,13 @@ dde \- Execute a Dynamic Data Exchange command .SH SYNOPSIS .sp -\fBpackage require dde 1.4\fR +\fBpackage require dde 1.3\fR .sp \fBdde servername\fR ?\fB\-force\fR? ?\fB\-handler \fIproc\fR? ?\fB\-\|\-\fR? ?\fItopic\fR? .sp -.VS 8.6 -\fBdde execute\fR ?\fB\-async\fR? ?\fB\-binary\fR? \fIservice topic data\fR +\fBdde execute\fR ?\fB\-async\fR? \fIservice topic data\fR .sp -\fBdde poke\fR ?\fB\-binary\fR? \fIservice topic item data\fR -.VE 8.6 +\fBdde poke\fR \fIservice topic item data\fR .sp \fBdde request\fR ?\fB\-binary\fR? \fIservice topic item\fR .sp @@ -71,7 +69,7 @@ procedure is called with all the arguments provided by the remote call. .RE .TP -\fBdde execute\fR ?\fB\-async\fR? ?\fB\-binary\fR? \fIservice topic data\fR +\fBdde execute\fR ?\fB\-async\fR? \fIservice topic data\fR . \fBdde execute\fR takes the \fIdata\fR and sends it to the server indicated by \fIservice\fR with the topic indicated by \fItopic\fR. Typically, @@ -82,15 +80,8 @@ script is run in the application. The \fB\-async\fR option requests asynchronous invocation. The command returns an error message if the script did not run, unless the \fB\-async\fR flag was used, in which case the command returns immediately with no error. -.VS 8.6 -Without the \fB\-binary\fR option all data will be sent in unicode. For -dde clients which don't implement the CF_UNICODE clipboard format, this -will automatically be translated to the system encoding. You can use -the \fB\-binary\fR option in combination with the result of -\fBencoding convertto\fR to send data in any other encoding. -.VE 8.6 .TP -\fBdde poke\fR ?\fB\-binary\fR? \fIservice topic item data\fR +\fBdde poke \fIservice topic item data\fR . \fBdde poke\fR passes the \fIdata\fR to the server indicated by \fIservice\fR using the \fItopic\fR and \fIitem\fR specified. Typically, @@ -99,13 +90,6 @@ specific but can be a command to the server or the name of a file to work on. The \fIitem\fR is also application specific and is often not used, but it must always be non-null. The \fIdata\fR field is given to the remote application. -.VS 8.6 -Without the \fB\-binary\fR option all data will be sent in unicode. For -dde clients which don't implement the CF_UNICODE clipboard format, this -will automatically be translated to the system encoding. You can use -the \fB\-binary\fR option in combination with the result of -\fBencoding convertto\fR to send data in any other encoding. -.VE 8.6 .TP \fBdde request\fR ?\fB\-binary\fR? \fIservice topic item\fR . @@ -139,7 +123,6 @@ command returns an error message if the script did not run, unless the \fB\-async\fR flag was used, in which case the command returns immediately with no error. This command can be used to replace send on Windows. .SH "DDE AND TCL" -.PP A Tcl interpreter always has a service name of \fBTclEval\fR. Each different interpreter of all running Tcl applications must be given a unique @@ -172,10 +155,8 @@ If for any reason the event queue is not flushed, DDE commands may hang until the event queue is flushed. This can create a deadlock situation. .SH EXAMPLE -.PP This asks Internet Explorer (which must already be running) to go to a particularly important website: -.PP .CS package require dde \fBdde execute\fR -async iexplore WWW_OpenURL http://www.tcl.tk/ @@ -184,6 +165,3 @@ package require dde tk(n), winfo(n), send(n) .SH KEYWORDS application, dde, name, remote execution -'\"Local Variables: -'\"mode: nroff -'\"End: |