[asterisk-commits] rmudgett: branch 1.8 r364108 - /branches/1.8/apps/app_directed_pickup.c

[SVN commits to the Asterisk project]

Author: rmudgett
Date: Thu Apr 26 16:10:00 2012
New Revision: 364108

URL: http://svnview.digium.com/svn/asterisk?view=rev&rev=364108
Log:
Update Pickup application documentation. (With feeling this time.)

Modified:
    branches/1.8/apps/app_directed_pickup.c

Modified: branches/1.8/apps/app_directed_pickup.c
URL: http://svnview.digium.com/svn/asterisk/branches/1.8/apps/app_directed_pickup.c?view=diff&rev=364108&r1=364107&r2=364108
==============================================================================
--- branches/1.8/apps/app_directed_pickup.c (original)
+++ branches/1.8/apps/app_directed_pickup.c Thu Apr 26 16:10:00 2012
@@ -78,14 +78,19 @@
 			<para>2) If the <replaceable>extension</replaceable> is specified with a
 			<replaceable>context</replaceable> of the special string
 			<literal>PICKUPMARK</literal> (for example 10 at PICKUPMARK), the application
-			will pickup a channel which has defined a channel variable
+			will pickup a channel which has defined the channel variable
 			<variable>PICKUPMARK</variable> with the same value as
 			<replaceable>extension</replaceable> (in this example,
 			<literal>10</literal>).</para>
 			<para>3) If the <replaceable>extension</replaceable> is specified
-			with a <replaceable>context</replaceable>, the channel executing at that
-			dialplan location will be picked up.  If no <replaceable>context</replaceable>
-			is specified, the current context will be used.</para>
+			with or without a <replaceable>context</replaceable>, the channel with a
+			matching <replaceable>extension</replaceable> and <replaceable>context</replaceable>
+			will be picked up.  If no <replaceable>context</replaceable> is specified,
+			the current context will be used.</para>
+			<note><para>The <replaceable>extension</replaceable> is typically set on
+			matching channels by the dial application that created the channel.  The
+			<replaceable>context</replaceable> is set on matching channels by the
+			channel driver for the device.</para></note>
 		</description>
 	</application>
 	<application name="PickupChan" language="en_US">