[asterisk-commits] lathama: trunk r304913 - in /trunk: ./ apps/ funcs/ res/
SVN commits to the Asterisk project
asterisk-commits at lists.digium.com
Sat Jan 29 18:23:03 CST 2011
Author: lathama
Date: Sat Jan 29 18:22:59 2011
New Revision: 304913
URL: http://svnview.digium.com/svn/asterisk?view=rev&rev=304913
Log:
Add Function and Application Relationships to documentation
Add and extend the see-also sections to the documentation for applications
and functions in an effort to expand the online documentation of the wiki.
Also check for and update any links to moved documentation in the doc folder.
Modified:
trunk/ (props changed)
trunk/apps/app_externalivr.c
trunk/apps/app_queue.c
trunk/apps/app_voicemail.c
trunk/funcs/func_callcompletion.c
trunk/funcs/func_realtime.c
trunk/res/res_calendar.c
Propchange: trunk/
------------------------------------------------------------------------------
Binary property 'branch-1.8-merged' - no diff available.
Modified: trunk/apps/app_externalivr.c
URL: http://svnview.digium.com/svn/asterisk/trunk/apps/app_externalivr.c?view=diff&rev=304913&r1=304912&r2=304913
==============================================================================
--- trunk/apps/app_externalivr.c (original)
+++ trunk/apps/app_externalivr.c Sat Jan 29 18:22:59 2011
@@ -85,7 +85,7 @@
all DTMF events received on the channel, and notification if the channel is
hung up. The received on the channel, and notification if the channel is hung
up. The application will not be forcibly terminated when the channel is hung up.
- See <filename>doc/externalivr.txt</filename> for a protocol specification.</para>
+ For more information see <filename>doc/asterisk.pdf</filename>.</para>
</description>
</application>
***/
Modified: trunk/apps/app_queue.c
URL: http://svnview.digium.com/svn/asterisk/trunk/apps/app_queue.c?view=diff&rev=304913&r1=304912&r2=304913
==============================================================================
--- trunk/apps/app_queue.c (original)
+++ trunk/apps/app_queue.c Sat Jan 29 18:22:59 2011
@@ -238,14 +238,19 @@
</variablelist>
</description>
<see-also>
+ <ref type="application">Queue</ref>
+ <ref type="application">QueueLog</ref>
<ref type="application">AddQueueMember</ref>
<ref type="application">RemoveQueueMember</ref>
<ref type="application">PauseQueueMember</ref>
<ref type="application">UnpauseQueueMember</ref>
- <ref type="application">AgentLogin</ref>
+ <ref type="function">QUEUE_VARIABLES</ref>
+ <ref type="function">QUEUE_MEMBER</ref>
<ref type="function">QUEUE_MEMBER_COUNT</ref>
+ <ref type="function">QUEUE_EXISTS</ref>
+ <ref type="function">QUEUE_WAITING_COUNT</ref>
<ref type="function">QUEUE_MEMBER_LIST</ref>
- <ref type="function">QUEUE_WAITING_COUNT</ref>
+ <ref type="function">QUEUE_MEMBER_PENALTY</ref>
</see-also>
</application>
<application name="AddQueueMember" language="en_US">
@@ -274,10 +279,19 @@
</variablelist>
</description>
<see-also>
+ <ref type="application">Queue</ref>
+ <ref type="application">QueueLog</ref>
+ <ref type="application">AddQueueMember</ref>
<ref type="application">RemoveQueueMember</ref>
<ref type="application">PauseQueueMember</ref>
<ref type="application">UnpauseQueueMember</ref>
- <ref type="application">AgentLogin</ref>
+ <ref type="function">QUEUE_VARIABLES</ref>
+ <ref type="function">QUEUE_MEMBER</ref>
+ <ref type="function">QUEUE_MEMBER_COUNT</ref>
+ <ref type="function">QUEUE_EXISTS</ref>
+ <ref type="function">QUEUE_WAITING_COUNT</ref>
+ <ref type="function">QUEUE_MEMBER_LIST</ref>
+ <ref type="function">QUEUE_MEMBER_PENALTY</ref>
</see-also>
</application>
<application name="RemoveQueueMember" language="en_US">
@@ -303,9 +317,18 @@
</description>
<see-also>
<ref type="application">Queue</ref>
+ <ref type="application">QueueLog</ref>
<ref type="application">AddQueueMember</ref>
+ <ref type="application">RemoveQueueMember</ref>
<ref type="application">PauseQueueMember</ref>
<ref type="application">UnpauseQueueMember</ref>
+ <ref type="function">QUEUE_VARIABLES</ref>
+ <ref type="function">QUEUE_MEMBER</ref>
+ <ref type="function">QUEUE_MEMBER_COUNT</ref>
+ <ref type="function">QUEUE_EXISTS</ref>
+ <ref type="function">QUEUE_WAITING_COUNT</ref>
+ <ref type="function">QUEUE_MEMBER_LIST</ref>
+ <ref type="function">QUEUE_MEMBER_PENALTY</ref>
</see-also>
</application>
<application name="PauseQueueMember" language="en_US">
@@ -337,7 +360,19 @@
<para>Example: PauseQueueMember(,SIP/3000)</para>
</description>
<see-also>
+ <ref type="application">Queue</ref>
+ <ref type="application">QueueLog</ref>
+ <ref type="application">AddQueueMember</ref>
+ <ref type="application">RemoveQueueMember</ref>
+ <ref type="application">PauseQueueMember</ref>
<ref type="application">UnpauseQueueMember</ref>
+ <ref type="function">QUEUE_VARIABLES</ref>
+ <ref type="function">QUEUE_MEMBER</ref>
+ <ref type="function">QUEUE_MEMBER_COUNT</ref>
+ <ref type="function">QUEUE_EXISTS</ref>
+ <ref type="function">QUEUE_WAITING_COUNT</ref>
+ <ref type="function">QUEUE_MEMBER_LIST</ref>
+ <ref type="function">QUEUE_MEMBER_PENALTY</ref>
</see-also>
</application>
<application name="UnpauseQueueMember" language="en_US">
@@ -366,7 +401,19 @@
<para>Example: UnpauseQueueMember(,SIP/3000)</para>
</description>
<see-also>
+ <ref type="application">Queue</ref>
+ <ref type="application">QueueLog</ref>
+ <ref type="application">AddQueueMember</ref>
+ <ref type="application">RemoveQueueMember</ref>
<ref type="application">PauseQueueMember</ref>
+ <ref type="application">UnpauseQueueMember</ref>
+ <ref type="function">QUEUE_VARIABLES</ref>
+ <ref type="function">QUEUE_MEMBER</ref>
+ <ref type="function">QUEUE_MEMBER_COUNT</ref>
+ <ref type="function">QUEUE_EXISTS</ref>
+ <ref type="function">QUEUE_WAITING_COUNT</ref>
+ <ref type="function">QUEUE_MEMBER_LIST</ref>
+ <ref type="function">QUEUE_MEMBER_PENALTY</ref>
</see-also>
</application>
<application name="QueueLog" language="en_US">
@@ -386,6 +433,18 @@
</description>
<see-also>
<ref type="application">Queue</ref>
+ <ref type="application">QueueLog</ref>
+ <ref type="application">AddQueueMember</ref>
+ <ref type="application">RemoveQueueMember</ref>
+ <ref type="application">PauseQueueMember</ref>
+ <ref type="application">UnpauseQueueMember</ref>
+ <ref type="function">QUEUE_VARIABLES</ref>
+ <ref type="function">QUEUE_MEMBER</ref>
+ <ref type="function">QUEUE_MEMBER_COUNT</ref>
+ <ref type="function">QUEUE_EXISTS</ref>
+ <ref type="function">QUEUE_WAITING_COUNT</ref>
+ <ref type="function">QUEUE_MEMBER_LIST</ref>
+ <ref type="function">QUEUE_MEMBER_PENALTY</ref>
</see-also>
</application>
<function name="QUEUE_VARIABLES" language="en_US">
@@ -426,6 +485,21 @@
<para>Makes the following queue variables available.</para>
<para>Returns <literal>0</literal> if queue is found and setqueuevar is defined, <literal>-1</literal> otherwise.</para>
</description>
+ <see-also>
+ <ref type="application">Queue</ref>
+ <ref type="application">QueueLog</ref>
+ <ref type="application">AddQueueMember</ref>
+ <ref type="application">RemoveQueueMember</ref>
+ <ref type="application">PauseQueueMember</ref>
+ <ref type="application">UnpauseQueueMember</ref>
+ <ref type="function">QUEUE_VARIABLES</ref>
+ <ref type="function">QUEUE_MEMBER</ref>
+ <ref type="function">QUEUE_MEMBER_COUNT</ref>
+ <ref type="function">QUEUE_EXISTS</ref>
+ <ref type="function">QUEUE_WAITING_COUNT</ref>
+ <ref type="function">QUEUE_MEMBER_LIST</ref>
+ <ref type="function">QUEUE_MEMBER_PENALTY</ref>
+ </see-also>
</function>
<function name="QUEUE_MEMBER" language="en_US">
<synopsis>
@@ -453,6 +527,21 @@
<description>
<para>Returns the number of members currently associated with the specified <replaceable>queuename</replaceable>.</para>
</description>
+ <see-also>
+ <ref type="application">Queue</ref>
+ <ref type="application">QueueLog</ref>
+ <ref type="application">AddQueueMember</ref>
+ <ref type="application">RemoveQueueMember</ref>
+ <ref type="application">PauseQueueMember</ref>
+ <ref type="application">UnpauseQueueMember</ref>
+ <ref type="function">QUEUE_VARIABLES</ref>
+ <ref type="function">QUEUE_MEMBER</ref>
+ <ref type="function">QUEUE_MEMBER_COUNT</ref>
+ <ref type="function">QUEUE_EXISTS</ref>
+ <ref type="function">QUEUE_WAITING_COUNT</ref>
+ <ref type="function">QUEUE_MEMBER_LIST</ref>
+ <ref type="function">QUEUE_MEMBER_PENALTY</ref>
+ </see-also>
</function>
<function name="QUEUE_MEMBER_COUNT" language="en_US">
<synopsis>
@@ -466,7 +555,19 @@
<warning><para>This function has been deprecated in favor of the <literal>QUEUE_MEMBER()</literal> function</para></warning>
</description>
<see-also>
+ <ref type="application">Queue</ref>
+ <ref type="application">QueueLog</ref>
+ <ref type="application">AddQueueMember</ref>
+ <ref type="application">RemoveQueueMember</ref>
+ <ref type="application">PauseQueueMember</ref>
+ <ref type="application">UnpauseQueueMember</ref>
+ <ref type="function">QUEUE_VARIABLES</ref>
+ <ref type="function">QUEUE_MEMBER</ref>
+ <ref type="function">QUEUE_MEMBER_COUNT</ref>
+ <ref type="function">QUEUE_EXISTS</ref>
+ <ref type="function">QUEUE_WAITING_COUNT</ref>
<ref type="function">QUEUE_MEMBER_LIST</ref>
+ <ref type="function">QUEUE_MEMBER_PENALTY</ref>
</see-also>
</function>
<function name="QUEUE_EXISTS" language="en_US">
@@ -479,6 +580,21 @@
<description>
<para>Returns 1 if the specified queue exists, 0 if it does not</para>
</description>
+ <see-also>
+ <ref type="application">Queue</ref>
+ <ref type="application">QueueLog</ref>
+ <ref type="application">AddQueueMember</ref>
+ <ref type="application">RemoveQueueMember</ref>
+ <ref type="application">PauseQueueMember</ref>
+ <ref type="application">UnpauseQueueMember</ref>
+ <ref type="function">QUEUE_VARIABLES</ref>
+ <ref type="function">QUEUE_MEMBER</ref>
+ <ref type="function">QUEUE_MEMBER_COUNT</ref>
+ <ref type="function">QUEUE_EXISTS</ref>
+ <ref type="function">QUEUE_WAITING_COUNT</ref>
+ <ref type="function">QUEUE_MEMBER_LIST</ref>
+ <ref type="function">QUEUE_MEMBER_PENALTY</ref>
+ </see-also>
</function>
<function name="QUEUE_WAITING_COUNT" language="en_US">
<synopsis>
@@ -490,6 +606,21 @@
<description>
<para>Returns the number of callers currently waiting in the specified <replaceable>queuename</replaceable>.</para>
</description>
+ <see-also>
+ <ref type="application">Queue</ref>
+ <ref type="application">QueueLog</ref>
+ <ref type="application">AddQueueMember</ref>
+ <ref type="application">RemoveQueueMember</ref>
+ <ref type="application">PauseQueueMember</ref>
+ <ref type="application">UnpauseQueueMember</ref>
+ <ref type="function">QUEUE_VARIABLES</ref>
+ <ref type="function">QUEUE_MEMBER</ref>
+ <ref type="function">QUEUE_MEMBER_COUNT</ref>
+ <ref type="function">QUEUE_EXISTS</ref>
+ <ref type="function">QUEUE_WAITING_COUNT</ref>
+ <ref type="function">QUEUE_MEMBER_LIST</ref>
+ <ref type="function">QUEUE_MEMBER_PENALTY</ref>
+ </see-also>
</function>
<function name="QUEUE_MEMBER_LIST" language="en_US">
<synopsis>
@@ -502,7 +633,19 @@
<para>Returns a comma-separated list of members associated with the specified <replaceable>queuename</replaceable>.</para>
</description>
<see-also>
+ <ref type="application">Queue</ref>
+ <ref type="application">QueueLog</ref>
+ <ref type="application">AddQueueMember</ref>
+ <ref type="application">RemoveQueueMember</ref>
+ <ref type="application">PauseQueueMember</ref>
+ <ref type="application">UnpauseQueueMember</ref>
+ <ref type="function">QUEUE_VARIABLES</ref>
+ <ref type="function">QUEUE_MEMBER</ref>
<ref type="function">QUEUE_MEMBER_COUNT</ref>
+ <ref type="function">QUEUE_EXISTS</ref>
+ <ref type="function">QUEUE_WAITING_COUNT</ref>
+ <ref type="function">QUEUE_MEMBER_LIST</ref>
+ <ref type="function">QUEUE_MEMBER_PENALTY</ref>
</see-also>
</function>
<function name="QUEUE_MEMBER_PENALTY" language="en_US">
@@ -516,6 +659,21 @@
<description>
<para>Gets or sets queue members penalty.</para>
</description>
+ <see-also>
+ <ref type="application">Queue</ref>
+ <ref type="application">QueueLog</ref>
+ <ref type="application">AddQueueMember</ref>
+ <ref type="application">RemoveQueueMember</ref>
+ <ref type="application">PauseQueueMember</ref>
+ <ref type="application">UnpauseQueueMember</ref>
+ <ref type="function">QUEUE_VARIABLES</ref>
+ <ref type="function">QUEUE_MEMBER</ref>
+ <ref type="function">QUEUE_MEMBER_COUNT</ref>
+ <ref type="function">QUEUE_EXISTS</ref>
+ <ref type="function">QUEUE_WAITING_COUNT</ref>
+ <ref type="function">QUEUE_MEMBER_LIST</ref>
+ <ref type="function">QUEUE_MEMBER_PENALTY</ref>
+ </see-also>
</function>
<manager name="Queues" language="en_US">
<synopsis>
Modified: trunk/apps/app_voicemail.c
URL: http://svnview.digium.com/svn/asterisk/trunk/apps/app_voicemail.c?view=diff&rev=304913&r1=304912&r2=304913
==============================================================================
--- trunk/apps/app_voicemail.c (original)
+++ trunk/apps/app_voicemail.c Sat Jan 29 18:22:59 2011
@@ -27,7 +27,7 @@
*
* \par See also
* \arg \ref Config_vm
- * \note For information about voicemail IMAP storage, read doc/imapstorage.txt
+ * \note For information about voicemail IMAP storage, read doc/asterisk.pdf
* \ingroup applications
* \note This module requires res_adsi to load. This needs to be optional
* during compilation.
Modified: trunk/funcs/func_callcompletion.c
URL: http://svnview.digium.com/svn/asterisk/trunk/funcs/func_callcompletion.c?view=diff&rev=304913&r1=304912&r2=304913
==============================================================================
--- trunk/funcs/func_callcompletion.c (original)
+++ trunk/funcs/func_callcompletion.c Sat Jan 29 18:22:59 2011
@@ -57,8 +57,8 @@
completion configuration parameter for a channel. Note that setting
a configuration parameter will only change the parameter for the
duration of the call.
-
- For more information on call completion in Asterisk, see <filename>doc/tex/ccss.tex</filename>.
+
+ For more information see <filename>doc/asterisk.pdf</filename>.
For more information on call completion parameters, see <filename>configs/ccss.conf.sample</filename>.</para>
</description>
</function>
Modified: trunk/funcs/func_realtime.c
URL: http://svnview.digium.com/svn/asterisk/trunk/funcs/func_realtime.c?view=diff&rev=304913&r1=304912&r2=304913
==============================================================================
--- trunk/funcs/func_realtime.c (original)
+++ trunk/funcs/func_realtime.c Sat Jan 29 18:22:59 2011
@@ -67,6 +67,12 @@
If there is no match, NULL will be returned by the function.
On a write, this function will always return NULL.</para>
</description>
+ <see-also>
+ <ref type="function">REALTIME_STORE</ref>
+ <ref type="function">REALTIME_DESTROY</ref>
+ <ref type="function">REALTIME_FIELD</ref>
+ <ref type="function">REALTIME_HASH</ref>
+ </see-also>
</function>
<function name="REALTIME_STORE" language="en_US">
<synopsis>
@@ -84,6 +90,12 @@
creates channel variable named RTSTOREID, which contains value of unique ID.
Currently, a maximum of 30 field/value pairs is supported.</para>
</description>
+ <see-also>
+ <ref type="function">REALTIME</ref>
+ <ref type="function">REALTIME_DESTROY</ref>
+ <ref type="function">REALTIME_FIELD</ref>
+ <ref type="function">REALTIME_HASH</ref>
+ </see-also>
</function>
<function name="REALTIME_DESTROY" language="en_US">
<synopsis>
@@ -100,6 +112,12 @@
<para>This function acts in the same way as REALTIME(....) does, except that
it destroys the matched record in the RT engine.</para>
</description>
+ <see-also>
+ <ref type="function">REALTIME</ref>
+ <ref type="function">REALTIME_STORE</ref>
+ <ref type="function">REALTIME_FIELD</ref>
+ <ref type="function">REALTIME_HASH</ref>
+ </see-also>
</function>
<function name="REALTIME_FIELD" language="en_US">
<synopsis>
@@ -117,6 +135,12 @@
<replaceable>value</replaceable>. When written to, the REALTIME_FIELD() function
performs identically to the REALTIME() function.</para>
</description>
+ <see-also>
+ <ref type="function">REALTIME</ref>
+ <ref type="function">REALTIME_STORE</ref>
+ <ref type="function">REALTIME_DESTROY</ref>
+ <ref type="function">REALTIME_HASH</ref>
+ </see-also>
</function>
<function name="REALTIME_HASH" language="en_US">
<synopsis>
@@ -134,6 +158,12 @@
it can be assigned to the HASH() function. The HASH() function then provides
a suitable method for retrieving each field value of the record.</para>
</description>
+ <see-also>
+ <ref type="function">REALTIME</ref>
+ <ref type="function">REALTIME_STORE</ref>
+ <ref type="function">REALTIME_DESTROY</ref>
+ <ref type="function">REALTIME_FIELD</ref>
+ </see-also>
</function>
***/
Modified: trunk/res/res_calendar.c
URL: http://svnview.digium.com/svn/asterisk/trunk/res/res_calendar.c?view=diff&rev=304913&r1=304912&r2=304913
==============================================================================
--- trunk/res/res_calendar.c (original)
+++ trunk/res/res_calendar.c Sat Jan 29 18:22:59 2011
@@ -53,6 +53,12 @@
<description>
<para>Check the specified calendar's current busy status.</para>
</description>
+ <see-also>
+ <ref type="function">CALENDAR_EVENT</ref>
+ <ref type="function">CALENDAR_QUERY</ref>
+ <ref type="function">CALENDAR_QUERY_RESULT</ref>
+ <ref type="function">CALENDAR_WRITE</ref>
+ </see-also>
</function>
<function name="CALENDAR_EVENT" language="en_US">
<synopsis>
@@ -79,6 +85,12 @@
<para>Whenever a calendar event notification call is made, the event data
may be accessed with this function.</para>
</description>
+ <see-also>
+ <ref type="function">CALENDAR_BUSY</ref>
+ <ref type="function">CALENDAR_QUERY</ref>
+ <ref type="function">CALENDAR_QUERY_RESULT</ref>
+ <ref type="function">CALENDAR_WRITE</ref>
+ </see-also>
</function>
<function name="CALENDAR_QUERY" language="en_US">
<synopsis>Query a calendar server and store the data on a channel
@@ -98,6 +110,12 @@
<para>Get a list of events in the currently accessible timeframe of the <replaceable>calendar</replaceable>
The function returns the id for accessing the result with CALENDAR_QUERY_RESULT()</para>
</description>
+ <see-also>
+ <ref type="function">CALENDAR_BUSY</ref>
+ <ref type="function">CALENDAR_EVENT</ref>
+ <ref type="function">CALENDAR_QUERY_RESULT</ref>
+ <ref type="function">CALENDAR_WRITE</ref>
+ </see-also>
</function>
<function name="CALENDAR_QUERY_RESULT" language="en_US">
<synopsis>
@@ -133,6 +151,12 @@
will return the data for that field. If multiple events matched the query, and <replaceable>entry</replaceable>
is provided, information from that event will be returned.</para>
</description>
+ <see-also>
+ <ref type="function">CALENDAR_BUSY</ref>
+ <ref type="function">CALENDAR_EVENT</ref>
+ <ref type="function">CALENDAR_QUERY</ref>
+ <ref type="function">CALENDAR_WRITE</ref>
+ </see-also>
</function>
<function name="CALENDAR_WRITE" language="en_US">
<synopsis>Write an event to a calendar</synopsis>
@@ -159,6 +183,12 @@
<para>Example: CALENDAR_WRITE(calendar,field1,field2,field3)=val1,val2,val3</para>
<para>The field and value arguments can easily be set/passed using the HASHKEYS() and HASH() functions</para>
</description>
+ <see-also>
+ <ref type="function">CALENDAR_BUSY</ref>
+ <ref type="function">CALENDAR_EVENT</ref>
+ <ref type="function">CALENDAR_QUERY</ref>
+ <ref type="function">CALENDAR_QUERY_RESULT</ref>
+ </see-also>
</function>
***/
More information about the asterisk-commits
mailing list