[svn-commits] rmudgett: branch 1.8 r363875 - /branches/1.8/apps/app_directed_pickup.c

[SVN commits to the Digium repositories]

Author: rmudgett
Date: Wed Apr 25 22:11:00 2012
New Revision: 363875

URL: http://svnview.digium.com/svn/asterisk?view=rev&rev=363875
Log:
Update Pickup application documentation. (Even better)

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=363875&r1=363874&r2=363875
==============================================================================
--- branches/1.8/apps/app_directed_pickup.c (original)
+++ branches/1.8/apps/app_directed_pickup.c Wed Apr 25 22:11:00 2012
@@ -57,26 +57,35 @@
 		</synopsis>
 		<syntax>
 			<parameter name="targets" argsep="&amp;">
-				<argument name="exten" argsep="@" required="true">
+				<argument name="extension" argsep="@" required="true">
+					<para>Specification of the pickup target.</para>
 					<argument name="extension" required="true"/>
 					<argument name="context" />
 				</argument>
-				<argument name="exten2" argsep="@" multiple="true">
+				<argument name="extension2" argsep="@" multiple="true">
+					<para>Additional specifications of pickup targets.</para>
 					<argument name="extension2" required="true"/>
 					<argument name="context2"/>
 				</argument>
 			</parameter>
 		</syntax>
 		<description>
-			<para>This application can pickup any ringing channel that is calling
-			the specified dialplan <replaceable>extension</replaceable>.  If no dialplan
-			<replaceable>context</replaceable> is specified, the current context will be
-			used.  If you use the special string <literal>PICKUPMARK</literal>
-			for the context, for example 10 at PICKUPMARK, this application tries to find a
-			channel which has defined a channel variable <variable>PICKUPMARK</variable>
-			with the same value as <replaceable>extension</replaceable> (in this example,
-			<literal>10</literal>).  When no parameter is specified, the application will
-			pickup a channel matching the pickup group of the active channel.</para>
+			<para>This application can pickup a specified ringing channel.  The channel
+			to pickup can be specified in the following ways.</para>
+			<para>1) If no <replaceable>extension</replaceable> targets are specified,
+			the application will pickup a channel matching the pickup group of the
+			requesting channel.</para>
+			<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
+			<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>
 		</description>
 	</application>
 	<application name="PickupChan" language="en_US">