[asterisk-commits] twilson: branch group/aco_xmldocs r374031 - in /team/group/aco_xmldocs: apps/...

SVN commits to the Asterisk project asterisk-commits at lists.digium.com
Fri Sep 28 13:28:46 CDT 2012


Author: twilson
Date: Fri Sep 28 13:28:42 2012
New Revision: 374031

URL: http://svnview.digium.com/svn/asterisk?view=rev&rev=374031
Log:
Add res_xmpp and chan_motif docs and remove "defaults" from docs

I forgot that I have the default/regex options filled at runtime.

res_xmpp and chan_motif had some options that were not documented in the sample files.
I'm running out of time, so I didn't document them either, but made note of what they were.
If I have time today, I'll go in and make docs for them.

Modified:
    team/group/aco_xmldocs/apps/confbridge/conf_config_parser.c
    team/group/aco_xmldocs/channels/chan_motif.c
    team/group/aco_xmldocs/configs/motif.conf.sample
    team/group/aco_xmldocs/configs/xmpp.conf.sample
    team/group/aco_xmldocs/res/res_xmpp.c

Modified: team/group/aco_xmldocs/apps/confbridge/conf_config_parser.c
URL: http://svnview.digium.com/svn/asterisk/team/group/aco_xmldocs/apps/confbridge/conf_config_parser.c?view=diff&rev=374031&r1=374030&r2=374031
==============================================================================
--- team/group/aco_xmldocs/apps/confbridge/conf_config_parser.c (original)
+++ team/group/aco_xmldocs/apps/confbridge/conf_config_parser.c Fri Sep 28 13:28:42 2012
@@ -52,25 +52,25 @@
 				<configOption name="type">
 					<synopsis>Define this configuration category as a user profile</synopsis>
 				</configOption>
-				<configOption name="admin" default="no">
+				<configOption name="admin">
 					<synopsis>Sets if the user is an admin or not</synopsis>
 				</configOption>
-				<configOption name="marked" default="no">
+				<configOption name="marked">
 					<synopsis>Sets if this is a marked user or not</synopsis>
 				</configOption>
-				<configOption name="startmuted" default="no">
+				<configOption name="startmuted">
 					<synopsis>Sets if all users should start out muted</synopsis>
 				</configOption>
-				<configOption name="music_on_hold_when_empty" default="no">
+				<configOption name="music_on_hold_when_empty">
 					<synopsis>Play MOH when user is alone or waiting on a marked user</synopsis>
 				</configOption>
-				<configOption name="quiet" default="no">
+				<configOption name="quiet">
 					<synopsis>Silence enter/leave prompts and user intros for this user</synopsis>
 				</configOption>
-				<configOption name="announce_user_count" default="no">
+				<configOption name="announce_user_count">
 					<synopsis>Sets if the number of users should be announced to the user</synopsis>
 				</configOption>
-				<configOption name="announce_user_count_all" default="no">
+				<configOption name="announce_user_count_all">
 					<synopsis>Announce user count to all the other users when this user joins</synopsis>
 					<description><para>Sets if the number of users should be announced to all the other users
 						in the conference when this user joins. This option can be either set to 'yes' or
@@ -78,22 +78,22 @@
 						count is above the specified number.
 					</para></description>
 				</configOption>
-				<configOption name="announce_only_user" default="yes">
+				<configOption name="announce_only_user">
 					<synopsis>Announce to a user when they join an empty conference</synopsis>
 				</configOption>
-				<configOption name="wait_marked" default="no">
+				<configOption name="wait_marked">
 					<synopsis>Sets if the user must wait for a marked user to enter before joining a conference</synopsis>
 				</configOption>
-				<configOption name="end_marked" default="no">
+				<configOption name="end_marked">
 					<synopsis>Kick the user from the conference when the last marked user leaves</synopsis>
 				</configOption>
-				<configOption name="talk_detection_events" default="no">
+				<configOption name="talk_detection_events">
 					<synopsis>Set whether or not notifications of when a user begins and ends talking should be sent out as events over AMI</synopsis>
 				</configOption>
-				<configOption name="dtmf_passthrough" default="no">
+				<configOption name="dtmf_passthrough">
 					<synopsis>Sets whether or not DTMF should pass through the conference</synopsis>
 				</configOption>
-				<configOption name="announce_join_leave" default="no">
+				<configOption name="announce_join_leave">
 					<synopsis>Prompt user for their name when joining a conference and play it to the conference when they enter</synopsis>
 				</configOption>
 				<configOption name="pin">
@@ -105,7 +105,7 @@
 				<configOption name="announcement">
 					<synopsis>Sound file to play to the user when they join a conference</synopsis>
 				</configOption>
-				<configOption name="denoise" default="no">
+				<configOption name="denoise">
 					<synopsis>Apply a denoise filter to the audio before mixing</synopsis>
 					<description><para>Sets whether or not a denoise filter should be applied
 						to the audio before mixing or not.  Off by default. Requires
@@ -126,7 +126,7 @@
 						due to its performance enhancements.
 					</para></description>
 				</configOption>
-				<configOption name="dsp_silence_threshold" default="2500">
+				<configOption name="dsp_silence_threshold">
 					<synopsis>The number ofmilliseconds of detected silence necessary to trigger silence detection</synopsis>
 					<description><para>
 						The time in milliseconds of sound falling within the what
@@ -158,7 +158,7 @@
 						By default this value is 2500ms. Valid values are 1 through 2^31
 					</para></description>
 				</configOption>
-				<configOption name="dsp_talking_threshold" default="60">
+				<configOption name="dsp_talking_threshold">
 					<synopsis>The number of milliseconds of detected non-silence necessary to triger talk detection</synopsis>
 					<description><para>
 						The time in milliseconds of sound above what the dsp has
@@ -188,7 +188,7 @@
 						By default this value is 160 ms. Valid values are 1 through 2^31
 					</para></description>
 				</configOption>
-				<configOption name="jitterbuffer" default="no">
+				<configOption name="jitterbuffer">
 					<synopsis>Place a jitter buffer on the user's audio stream before audio mixing is performed</synopsis>
 					<description><para>
 						Enabling this option places a jitterbuffer on the user's audio stream
@@ -207,10 +207,10 @@
 				<configOption name="type">
 					<synopsis>Define this configuration category as a bridge profile</synopsis>
 				</configOption>
-				<configOption name="jitterbuffer" default="no">
+				<configOption name="jitterbuffer">
 					<synopsis>Place a jitter buffer on the conference's audio stream</synopsis>
 				</configOption>
-				<configOption name="internal_sample_rate" default="auto">
+				<configOption name="internal_sample_rate">
 					<synopsis>Set the internal native sample rate for mixing the conference</synopsis>
 					<description><para>
 						Sets the internal native sample rate the
@@ -222,7 +222,7 @@
 						will be used.
 					</para></description>
 				</configOption>
-				<configOption name="mixing_interval" default="20">
+				<configOption name="mixing_interval">
 					<synopsis>Sets the internal mixing interval in milliseconds for the bridge</synopsis>
 					<description><para>
 						Sets the internal mixing interval in milliseconds for the bridge.  This
@@ -233,7 +233,7 @@
 						or 80.
 					</para></description>
 				</configOption>
-				<configOption name="record_conference" default="no">
+				<configOption name="record_conference">
 					<synopsis>Record the conference starting with the first active user's entrance and ending with the last active user's exit</synopsis>
 					<description><para>
 						Records the conference call starting when the first user
@@ -296,7 +296,7 @@
 						regardless if this limit is reached or not.
 					</para></description>
 				</configOption>
-				<configOption name="^sound_" regex="true">
+				<configOption name="^sound_">
 					<synopsis>Override the various conference bridge sound files</synopsis>
 					<description><para>
 						All sounds in the conference are customizable using the bridge profile options below.

Modified: team/group/aco_xmldocs/channels/chan_motif.c
URL: http://svnview.digium.com/svn/asterisk/team/group/aco_xmldocs/channels/chan_motif.c?view=diff&rev=374031&r1=374030&r2=374031
==============================================================================
--- team/group/aco_xmldocs/channels/chan_motif.c (original)
+++ team/group/aco_xmldocs/channels/chan_motif.c Fri Sep 28 13:28:42 2012
@@ -74,7 +74,7 @@
 		<configFile name="motif.conf">
 			<configObject name="endpoint">
 				<configOption name="context">
-					<synopsis></synopsis>
+					<synopsis>Default dialplan context that incoming sessions will be routed to</synopsis>
 				</configOption>
 				<configOption name="callgroup">
 					<synopsis></synopsis>
@@ -92,25 +92,25 @@
 					<synopsis></synopsis>
 				</configOption>
 				<configOption name="accountcode">
-					<synopsis></synopsis>
+					<synopsis>Accout code for CDR purposes</synopsis>
 				</configOption>
 				<configOption name="allow">
-					<synopsis></synopsis>
+					<synopsis>Codecs to allow</synopsis>
 				</configOption>
 				<configOption name="disallow">
-					<synopsis></synopsis>
+					<synopsis>Codecs to disallow</synopsis>
 				</configOption>
 				<configOption name="connection">
-					<synopsis></synopsis>
+					<synopsis>Connection to accept traffic on and on which to send traffic out</synopsis>
 				</configOption>
 				<configOption name="transport">
-					<synopsis></synopsis>
+					<synopsis>The transport to use (ice-udp, google, or google-v1)</synopsis>
 				</configOption>
 				<configOption name="maxicecandidates">
-					<synopsis></synopsis>
+					<synopsis>Maximum number of ICE candidates to offer</synopsis>
 				</configOption>
 				<configOption name="maxpayloads">
-					<synopsis></synopsis>
+					<synopsis>Maximum number of pyaloads to offer</synopsis>
 				</configOption>
 			</configObject>
 		</configFile>

Modified: team/group/aco_xmldocs/configs/motif.conf.sample
URL: http://svnview.digium.com/svn/asterisk/team/group/aco_xmldocs/configs/motif.conf.sample?view=diff&rev=374031&r1=374030&r2=374031
==============================================================================
--- team/group/aco_xmldocs/configs/motif.conf.sample (original)
+++ team/group/aco_xmldocs/configs/motif.conf.sample Fri Sep 28 13:28:42 2012
@@ -70,18 +70,25 @@
 ;maxpayloads = 30      ; Maximum number of payloads we will offer
 
 ; Sample configuration entry for Jingle
-[jingle-endpoint](default)
-transport=ice-udp               ; Change the default protocol of outgoing sessions to Jingle ICE-UDP
-allow=g722                      ; Add G.722 as an allowed format since the other side may support it
-connection=local-jabber-account ; Connection to accept traffic on and send traffic out
-accountcode=jingle              ; Account code for CDR purposes
+;[jingle-endpoint](default)
+;transport=ice-udp               ; Change the default protocol of outgoing sessions to Jingle ICE-UDP
+;allow=g722                      ; Add G.722 as an allowed format since the other side may support it
+;connection=local-jabber-account ; Connection to accept traffic on and send traffic out
+;accountcode=jingle              ; Account code for CDR purposes
 
 ; Sample configuration entry for Google Talk
 [gtalk-endpoint](default)
-transport=google         ; Since this is a Google Talk endpoint we want to offer Google Jingle for outgoing sessions
-connection=gtalk-account
+;transport=google         ; Since this is a Google Talk endpoint we want to offer Google Jingle for outgoing sessions
+;connection=gtalk-account
 
 ; Sample configuration entry for Google Voice
-[gvoice](default)
-transport=google-v1       ; Google Voice uses the original Google Talk protocol
-connection=gvoice-account
+;[gvoice](default)
+;transport=google-v1       ; Google Voice uses the original Google Talk protocol
+;connection=gvoice-account
+
+; Additional options
+; callgroup
+; pickupgroup
+; language
+; musicclass
+; parkinglot

Modified: team/group/aco_xmldocs/configs/xmpp.conf.sample
URL: http://svnview.digium.com/svn/asterisk/team/group/aco_xmldocs/configs/xmpp.conf.sample?view=diff&rev=374031&r1=374030&r2=374031
==============================================================================
--- team/group/aco_xmldocs/configs/xmpp.conf.sample (original)
+++ team/group/aco_xmldocs/configs/xmpp.conf.sample Fri Sep 28 13:28:42 2012
@@ -37,3 +37,6 @@
 ;sendtodialplan=yes			; Send incoming messages into the dialplan.  Off by default.
 ;context=messages			; Dialplan context to send incoming messages to.  If not set,
 					; "default" will be used.
+;forceoldssl=no     ; Force the use of old-style SSL.
+;keepalive=
+

Modified: team/group/aco_xmldocs/res/res_xmpp.c
URL: http://svnview.digium.com/svn/asterisk/team/group/aco_xmldocs/res/res_xmpp.c?view=diff&rev=374031&r1=374030&r2=374031
==============================================================================
--- team/group/aco_xmldocs/res/res_xmpp.c (original)
+++ team/group/aco_xmldocs/res/res_xmpp.c Fri Sep 28 13:28:42 2012
@@ -278,91 +278,106 @@
 		<configFile name="xmpp.conf">
 			<configObject name="global">
 				<configOption name="debug">
-					<synopsis></synopsis>
+					<synopsis>Enable debugging</synopsis>
 				</configOption>
 				<configOption name="autoprune">
-					<synopsis></synopsis>
+					<synopsis>Auto-remove users from buddy list.</synopsis>
+					<description><para>Auto-remove users from buddy list. Depending on the setup
+					(e.g., using your personal Gtalk account for a test) this could cause loss of
+					the contact list.
+					</para></description>
 				</configOption>
 				<configOption name="autoregister">
-					<synopsis></synopsis>
+					<synopsis>Auto-register users bfrom buddy list</synopsis>
 				</configOption>
 				<configOption name="collection_nodes">
-					<synopsis></synopsis>
+					<synopsis>Enable support for XEP-0248 for use with distributed device state</synopsis>
 				</configOption>
 				<configOption name="pubsub_autocreate">
-					<synopsis></synopsis>
+					<synopsis>Whether or not the PubSub server supports/is using auto-create for nodes</synopsis>
 				</configOption>
 				<configOption name="auth_policy">
-					<synopsis></synopsis>
+					<synopsis>Whether to automatically accept or deny users' subscription requests</synopsis>
 				</configOption>
 			</configObject>
 			<configObject name="client">
 				<configOption name="username">
-					<synopsis></synopsis>
+					<synopsis>XMPP username with optional resource</synopsis>
 				</configOption>
 				<configOption name="secret">
-					<synopsis></synopsis>
+					<synopsis>XMPP password</synopsis>
 				</configOption>
 				<configOption name="serverhost">
-					<synopsis></synopsis>
+					<synopsis>Route to server, e.g. talk.google.com</synopsis>
 				</configOption>
 				<configOption name="statusmessage">
-					<synopsis></synopsis>
+					<synopsis>Custom status message</synopsis>
 				</configOption>
 				<configOption name="pubsub_node">
-					<synopsis></synopsis>
+					<synopsis>Node for publishing events via PubSub</synopsis>
 				</configOption>
 				<configOption name="context">
-					<synopsis></synopsis>
+					<synopsis>Dialplan context to send incoming messages to</synopsis>
 				</configOption>
 				<configOption name="priority">
-					<synopsis></synopsis>
+					<synopsis>XMPP resource priority</synopsis>
 				</configOption>
 				<configOption name="port">
-					<synopsis></synopsis>
+					<synopsis>XMPP server port</synopsis>
 				</configOption>
 				<configOption name="timeout">
-					<synopsis></synopsis>
+					<synopsis>Timeout in seconds to hold incoming messages</synopsis>
+					<description><para>Timeout (in seconds) on the message stack. Messages stored longer
+					than this value will be deleted by Asterisk. This option applies to incoming messages only
+					which are intended to be processed by the JABBER_RECEIVE dialplan function.
+					</para></description>
 				</configOption>
-
 				<configOption name="debug">
-					<synopsis></synopsis>
+					<synopsis>Enable debugging</synopsis>
 				</configOption>
 				<configOption name="type">
-					<synopsis></synopsis>
+					<synopsis>Connection is either a client or a component</synopsis>
 				</configOption>
 				<configOption name="distribute_events">
-					<synopsis></synopsis>
+					<synopsis>Whether or not to distribute events using this connection</synopsis>
 				</configOption>
 				<configOption name="usetls">
-					<synopsis></synopsis>
+					<synopsis>Whether to use TLS for the connection or not</synopsis>
 				</configOption>
 				<configOption name="usesasl">
-					<synopsis></synopsis>
+					<synopsis>Whether to use SASL for the connection or not</synopsis>
 				</configOption>
 				<configOption name="forceoldssl">
-					<synopsis></synopsis>
+					<synopsis>Force the use of old-style SSL for the connection</synopsis>
 				</configOption>
 				<configOption name="keepalive">
 					<synopsis></synopsis>
 				</configOption>
 				<configOption name="autoprune">
-					<synopsis></synopsis>
+					<synopsis>Auto-remove users from buddy list.</synopsis>
+					<description><para>Auto-remove users from buddy list. Depending on the setup
+					(e.g., using your personal Gtalk account for a test) this could cause loss of
+					the contact list.
+					</para></description>
 				</configOption>
 				<configOption name="autoregister">
-					<synopsis></synopsis>
+					<synopsis>Auto-register users bfrom buddy list</synopsis>
 				</configOption>
 				<configOption name="auth_policy">
-					<synopsis></synopsis>
+					<synopsis>Whether to automatically accept or deny users' subscription requests</synopsis>
 				</configOption>
 				<configOption name="sendtodialplan">
-					<synopsis></synopsis>
+					<synopsis>Send incoming messages into the dialplan</synopsis>
 				</configOption>
 				<configOption name="status">
-					<synopsis></synopsis>
+					<synopsis>XMPP status-chat, available, away, xaway, or dnd</synopsis>
 				</configOption>
 				<configOption name="buddy">
-					<synopsis></synopsis>
+					<synopsis>Manual addition of buddy to list</synopsis>
+					<description><para>
+					Manual addition of buddy to the buddy list. For distributed events, these budies are
+					automatically added in the whitelist as 'owners' of the node(s).
+					</para></description>
 				</configOption>
 			</configObject>
 		</configFile>




More information about the asterisk-commits mailing list