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>

tcllib                                                 0.2                                      deleg_proc(3tcl)