Added example

1 files changed, 18 insertions, 1 deletions

diff --git a/doc/send.n b/doc/send.n
index 7a74003..5de1b84 100644
--- a/doc/send.n
+++ b/doc/send.n
@@ -5,7 +5,7 @@
 '\" See the file "license.terms" for information on usage and redistribution
 '\" of this file, and for a DISCLAIMER OF ALL WARRANTIES.
 '\" 
-'\" RCS: @(#) $Id: send.n,v 1.3 1999/04/16 01:51:09 stanton Exp $
+'\" RCS: @(#) $Id: send.n,v 1.4 2004/06/21 14:06:37 dkf Exp $
 '\" 
 .so man.macros
 .TH send n 4.0 Tk "Tk Built-In Commands"
@@ -91,6 +91,23 @@ such as that provide by \fBxauth\fR.
 Under Windows, \fBsend\fR is currently disabled.  Most of the
 functionality is provided by the \fBdde\fR command instead.
 .VE
+.SH EXAMPLE
+This script fragment can be used to make an application that only runs
+once on a particular display.
+.CS
+if {[tk appname FoobarApp] ne "FoobarApp"} {
+    \fBsend\fR -async FoobarApp RemoteStart $argv
+    exit
+}
+# The command that will be called remotely, which raises
+# the application main window and opens the requested files
+proc RemoteStart args {
+    raise .
+    foreach filename $args {
+        OpenFile $filename
+    }
+}
+.CE
 .SH KEYWORDS
 .VS
 application, dde, name, remote execution, security, send