[svn-commits] rmudgett: branch rmudgett/parking r331407 - /team/rmudgett/parking/main/

[SVN commits to the Digium repositories]

Author: rmudgett
Date: Wed Aug 10 11:25:32 2011
New Revision: 331407

URL: http://svnview.digium.com/svn/asterisk?view=rev&rev=331407
Log:
Make Park and ParkedCall description less awkward.

Modified:
    team/rmudgett/parking/main/features.c

Modified: team/rmudgett/parking/main/features.c
URL: http://svnview.digium.com/svn/asterisk/team/rmudgett/parking/main/features.c?view=diff&rev=331407&r1=331406&r2=331407
==============================================================================
--- team/rmudgett/parking/main/features.c (original)
+++ team/rmudgett/parking/main/features.c Wed Aug 10 11:25:32 2011
@@ -229,10 +229,13 @@
 			</parameter>
 		</syntax>
 		<description>
-			<para>Used to connect to a parked call.  This application is always
-			registered internally and does not need to be explicitly added
-			into the dialplan, although you should include the parking lot
-			context.</para>
+			<para>Used to retrieve a parked call from a parking lot.</para>
+			<note>
+				<para>Parking lots automatically create and manage dialplan extensions in
+				the parking lot context.  You do not need to explicitly use this
+				application in your dialplan.  Instead, all you should do is include the
+				parking lot context in your dialplan.</para>
+			</note>
 		</description>
 		<see-also>
 			<ref type="application">Park</ref>
@@ -282,10 +285,7 @@
 		</syntax>
 		<description>
 			<para>Used to park yourself (typically in combination with a supervised
-			transfer to know the parking space). This application is always
-			registered internally and does not need to be explicitly added
-			into the dialplan, although you should include the parking lot
-			context.</para>
+			transfer to know the parking space).</para>
 			<para>If you set the <variable>PARKINGEXTEN</variable> variable to a
 			parking space extension in the parking lot, Park() will attempt to park the call
 			on that extension.  If the extension is already is in use then execution
@@ -301,6 +301,19 @@
 			parking lot will use this extension to access the parking lot.</para>
 			<para>If you set the <variable>PARKINGDYNPOS</variable> variable then the newly created dynamic parking lot
 			will use those parking postitions.</para>
+			<note>
+				<para>This application must be used as the first extension priority
+				to be recognized as a parking access extension.  DTMF transfers
+				and some channel drivers need this distinction to operate properly.
+				The parking access extension in this case is treated like a dialplan
+				hint.</para>
+			</note>
+			<note>
+				<para>Parking lots automatically create and manage dialplan extensions in
+				the parking lot context.  You do not need to explicitly use this
+				application in your dialplan.  Instead, all you should do is include the
+				parking lot context in your dialplan.</para>
+			</note>
 		</description>
 		<see-also>
 			<ref type="application">ParkAndAnnounce</ref>