NAME

       deleg_proc - Creation of comm delegates (procedures)

SYNOPSIS

       package require Tcl  8.3

       package require interp::delegate::proc  ?0.2?

       ::interp::delegate::proc ?-async? name arguments comm id

_________________________________________________________________________________________________

DESCRIPTION

       This  package  provides  a  single command for the convenient creation of procedures which
       delegate the actual work to a remote location via a "channel" created by the package comm.

API

       ::interp::delegate::proc ?-async? name arguments comm id
              This commands creates a procedure which is named by name  and  returns  its  fully-
              qualified  name. All invokations of this procedure will delegate the actual work to
              the remote location identified by the comm channel comm and the endpoint id.

              The name of the remote procedure invoked by the delegator is [namespace tail name].
              I.e., namespace information is stripped from the call.

              Normally  the  generated  procedure marshalls the arguments, and returns the result
              from the remote procedure as its own result.  If  however  the  option  -async  was
              specified  then  the  generated  procedure  will  not  wait for a result and return
              immediately.

BUGS, IDEAS, FEEDBACK

       This document, and the package it describes,  will  undoubtedly  contain  bugs  and  other
       problems.    Please   report   such   in  the  category  interp  of  the  Tcllib  Trackers
       [http://core.tcl.tk/tcllib/reportlist].  Please also report any ideas for enhancements you
       may have for either package and/or documentation.

       When proposing code changes, please provide unified diffs, i.e the output of diff -u.

       Note further that attachments are strongly preferred over inlined patches. Attachments can
       be made by going to the Edit form of the ticket immediately after its creation,  and  then
       using the left-most button in the secondary navigation bar.

KEYWORDS

       comm, delegation, interpreter, procedure

CATEGORY

       Programming tools

COPYRIGHT

       Copyright (c) 2006 Andreas Kupries <andreas_kupries@users.sourceforge.net>