Refactor usage pattern of xmldoc info tag.

This updates func_channel.c and main/message.c to use a generic xpointer
include instead of including info from each channel driver.  Now the
name attribute of info is CHANNEL or CHANNEL_EXAMPLES to be included in
documentation for func_channel.  Setting the name attribute of info to
MessageToInfo or MessageFromInfo causes it to be included in the
MessageSend application and AMI action.

Change-Id: I89fd8276a3250824241a618009714267d3a8d1ea

diff --git a/addons/chan_ooh323.c b/addons/chan_ooh323.c
index 127ba0c8fe74e7ee3e3d8be307c181dfd472b4b9..2a895650a50a9a3249eb4c57f450f42d00b1e9a7 100644 (file)
--- a/addons/chan_ooh323.c
+++ b/addons/chan_ooh323.c
@@ -23,7 +23,7 @@
  ***/
 
 /*** DOCUMENTATION
-<info name="OOH323CHANNEL" language="en_US" tech="OOH323">
+<info name="CHANNEL" language="en_US" tech="OOH323">
        <enumlist>
                <enum name="faxdetect">
                        <para>R/W Fax Detect</para>

diff --git a/channels/chan_dahdi.c b/channels/chan_dahdi.c
index cbe7dba545ba9f41526fef99f49a9231cf713d49..8cccf843b423ade742fce1eb1f0796419f0d02b0 100644 (file)
--- a/channels/chan_dahdi.c
+++ b/channels/chan_dahdi.c
@@ -178,7 +178,7 @@ ASTERISK_REGISTER_FILE()
                        <para>This application will Accept the R2 call either with charge or no charge.</para>
                </description>
        </application>
-       <info name="DAHDICHANNEL" language="en_US" tech="DAHDI">
+       <info name="CHANNEL" language="en_US" tech="DAHDI">
                <enumlist>
                        <enum name="dahdi_channel">
                                <para>R/O DAHDI channel related to this channel.</para>

diff --git a/channels/chan_iax2.c b/channels/chan_iax2.c
index 1b3e287af471edd8464c0855913c6f2976133ccc..456ba8f1ed102a67126a60b2e3208afebe39f6eb 100644 (file)
--- a/channels/chan_iax2.c
+++ b/channels/chan_iax2.c
@@ -212,7 +212,7 @@ ASTERISK_REGISTER_FILE()
                        <para>Gets or sets a variable that is sent to a remote IAX2 peer during call setup.</para>
                </description>
        </function>
-       <info name="IAXCHANNEL" language="en_US" tech="IAX">
+       <info name="CHANNEL" language="en_US" tech="IAX">
                <enumlist>
                        <enum name="osptoken">
                                <para>R/O Get the peer's osptoken.</para>

diff --git a/channels/chan_sip.c b/channels/chan_sip.c
index 2c44208b46cae87393aa11e8c148cb45e5ff2fd7..f57d4670b32ee7dd0ea7772cf42dd177431ac238 100644 (file)
--- a/channels/chan_sip.c
+++ b/channels/chan_sip.c
@@ -568,11 +568,11 @@ ASTERISK_REGISTER_FILE()
                        for all of the sip peers will be retrieved.</para>
                </description>
        </manager>
-       <info name="SIPMessageFromInfo" language="en_US" tech="SIP">
+       <info name="MessageFromInfo" language="en_US" tech="SIP">
                <para>The <literal>from</literal> parameter can be a configured peer name
                or in the form of "display-name" &lt;URI&gt;.</para>
        </info>
-       <info name="SIPMessageToInfo" language="en_US" tech="SIP">
+       <info name="MessageToInfo" language="en_US" tech="SIP">
                <para>Specifying a prefix of <literal>sip:</literal> will send the
                message as a SIP MESSAGE request.</para>
        </info>

diff --git a/channels/pjsip/dialplan_functions.c b/channels/pjsip/dialplan_functions.c
index 322f56483daca12c8792052017f5a5d27b48a762..4d888c8faa426a82995ad6c9d50b545a07d4812e 100644 (file)
--- a/channels/pjsip/dialplan_functions.c
+++ b/channels/pjsip/dialplan_functions.c
@@ -109,7 +109,7 @@
                <ref type="function">PJSIP_MEDIA_OFFER</ref>
        </see-also>
 </function>
-<info name="PJSIPCHANNEL" language="en_US" tech="PJSIP">
+<info name="CHANNEL" language="en_US" tech="PJSIP">
        <enumlist>
                <enum name="rtp">
                        <para>R/O Retrieve media related information.</para>
@@ -411,7 +411,7 @@
                </enum>
        </enumlist>
 </info>
-<info name="PJSIPCHANNEL_EXAMPLES" language="en_US" tech="PJSIP">
+<info name="CHANNEL_EXAMPLES" language="en_US" tech="PJSIP">
        <example title="PJSIP specific CHANNEL examples">
                ; Log the current Call-ID
                same => n,Log(NOTICE, ${CHANNEL(pjsip,call-id)})

diff --git a/channels/sip/dialplan_functions.c b/channels/sip/dialplan_functions.c
index 988378835fa6691f09a75bc8e7d61cf745ee460f..53d15dddb6dfc0327d077bd4fe0941f36ec8a18b 100644 (file)
--- a/channels/sip/dialplan_functions.c
+++ b/channels/sip/dialplan_functions.c
@@ -24,7 +24,7 @@
  ***/
 
 /*** DOCUMENTATION
-<info name="SIPCHANNEL" language="en_US" tech="SIP">
+<info name="CHANNEL" language="en_US" tech="SIP">
        <enumlist>
                <enum name="peerip">
                        <para>R/O Get the IP address of the peer.</para>

diff --git a/doc/appdocsxml.xslt b/doc/appdocsxml.xslt
index 6e4c5ac500dc60a94aba1f157f81f4de335ae9c4..f067decaef29141eb9cccb93c2d996fcbb81122d 100644 (file)
--- a/doc/appdocsxml.xslt
+++ b/doc/appdocsxml.xslt
@@ -6,7 +6,10 @@
 
     <xsl:template match="node()|@*">
         <xsl:copy>
-            <xsl:apply-templates select="node()|@*"/>
+            <xsl:for-each select="node()|@*">
+                <xsl:sort select="@tech"/>
+                <xsl:apply-templates select="."/>
+            </xsl:for-each>
         </xsl:copy>
     </xsl:template>
 

diff --git a/funcs/func_channel.c b/funcs/func_channel.c
index 9831dd71fd5aa40719ab64fef1a8bd35ef4b6efd..e816dcae00ca5e0373f82c29cdd79301cdef37bb 100644 (file)
--- a/funcs/func_channel.c
+++ b/funcs/func_channel.c
@@ -236,11 +236,7 @@ ASTERISK_REGISTER_FILE()
                                                <para>R/W The maximum number of forwards allowed.</para>
                                        </enum>
                                </enumlist>
-                               <xi:include xpointer="xpointer(/docs/info[@name='SIPCHANNEL'])" />
-                               <xi:include xpointer="xpointer(/docs/info[@name='PJSIPCHANNEL'])" />
-                               <xi:include xpointer="xpointer(/docs/info[@name='IAXCHANNEL'])" />
-                               <xi:include xpointer="xpointer(/docs/info[@name='DAHDICHANNEL'])" />
-                               <xi:include xpointer="xpointer(/docs/info[@name='OOH323CHANNEL'])" />
+                               <xi:include xpointer="xpointer(/docs/info[@name='CHANNEL'])" />
                        </parameter>
                </syntax>
                <description>
@@ -266,7 +262,7 @@ ASTERISK_REGISTER_FILE()
                                ; Log the current state of the channel
                                same => n,Log(NOTICE, This channel is: ${CHANNEL(state)})
                        </example>
-                       <xi:include xpointer="xpointer(/docs/info[@name='PJSIPCHANNEL_EXAMPLES'])" />
+                       <xi:include xpointer="xpointer(/docs/info[@name='CHANNEL_EXAMPLES'])" />
                </description>
        </function>
  ***/

diff --git a/main/message.c b/main/message.c
index 54c604c47d26b8205f96d5b259952d86f230475a..0fc67ec0259135ce239619e64e141136574bb315 100644 (file)
--- a/main/message.c
+++ b/main/message.c
@@ -123,16 +123,12 @@ ASTERISK_REGISTER_FILE()
                <syntax>
                        <parameter name="to" required="true">
                                <para>A To URI for the message.</para>
-                               <xi:include xpointer="xpointer(/docs/info[@name='PJSIPMessageToInfo'])" />
-                               <xi:include xpointer="xpointer(/docs/info[@name='SIPMessageToInfo'])" />
-                               <xi:include xpointer="xpointer(/docs/info[@name='XMPPMessageToInfo'])" />
+                               <xi:include xpointer="xpointer(/docs/info[@name='MessageToInfo'])" />
                        </parameter>
                        <parameter name="from" required="false">
                                <para>A From URI for the message if needed for the
                                message technology being used to send this message.</para>
-                               <xi:include xpointer="xpointer(/docs/info[@name='PJSIPMessageFromInfo'])" />
-                               <xi:include xpointer="xpointer(/docs/info[@name='SIPMessageFromInfo'])" />
-                               <xi:include xpointer="xpointer(/docs/info[@name='XMPPMessageFromInfo'])" />
+                               <xi:include xpointer="xpointer(/docs/info[@name='MessageFromInfo'])" />
                        </parameter>
                </syntax>
                <description>
@@ -168,16 +164,12 @@ ASTERISK_REGISTER_FILE()
                        <xi:include xpointer="xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])" />
                        <parameter name="To" required="true">
                                <para>The URI the message is to be sent to.</para>
-                               <xi:include xpointer="xpointer(/docs/info[@name='PJSIPMessageToInfo'])" />
-                               <xi:include xpointer="xpointer(/docs/info[@name='SIPMessageToInfo'])" />
-                               <xi:include xpointer="xpointer(/docs/info[@name='XMPPMessageToInfo'])" />
+                               <xi:include xpointer="xpointer(/docs/info[@name='MessageToInfo'])" />
                        </parameter>
                        <parameter name="From">
                                <para>A From URI for the message if needed for the
                                message technology being used to send this message.</para>
-                               <xi:include xpointer="xpointer(/docs/info[@name='PJSIPMessageFromInfo'])" />
-                               <xi:include xpointer="xpointer(/docs/info[@name='SIPMessageFromInfo'])" />
-                               <xi:include xpointer="xpointer(/docs/info[@name='XMPPMessageFromInfo'])" />
+                               <xi:include xpointer="xpointer(/docs/info[@name='MessageFromInfo'])" />
                        </parameter>
                        <parameter name="Body">
                                <para>The message body text.  This must not contain any newlines as that

diff --git a/res/res_pjsip_messaging.c b/res/res_pjsip_messaging.c
index b508a2a596e13a062ce463c4417fe847fdf68283..7efb1a20e6c44574b462f8c7db476bfb685fa9f0 100644 (file)
--- a/res/res_pjsip_messaging.c
+++ b/res/res_pjsip_messaging.c
@@ -24,11 +24,11 @@
  ***/
 
 /*** DOCUMENTATION
-       <info name="PJSIPMessageFromInfo" language="en_US" tech="PJSIP">
+       <info name="MessageFromInfo" language="en_US" tech="PJSIP">
                <para>The <literal>from</literal> parameter can be a configured endpoint
                or in the form of "display-name" &lt;URI&gt;.</para>
        </info>
-       <info name="PJSIPMessageToInfo" language="en_US" tech="PJSIP">
+       <info name="MessageToInfo" language="en_US" tech="PJSIP">
                <para>Specifying a prefix of <literal>pjsip:</literal> will send the
                message as a SIP MESSAGE request.</para>
        </info>

diff --git a/res/res_xmpp.c b/res/res_xmpp.c
index c2b7796285baa963dca27b223b4a086c240bca46..32e1dd1ffc9fa804f6c36585995350709118c9db 100644 (file)
--- a/res/res_xmpp.c
+++ b/res/res_xmpp.c
@@ -278,11 +278,11 @@ ASTERISK_REGISTER_FILE()
                        <para>Sends a message to a Jabber Client.</para>
                </description>
        </manager>
-       <info name="XMPPMessageToInfo" language="en_US" tech="XMPP">
+       <info name="MessageToInfo" language="en_US" tech="XMPP">
                <para>Specifying a prefix of <literal>xmpp:</literal> will send the
                message as an XMPP chat message.</para>
        </info>
-       <info name="XMPPMessageFromInfo" language="en_US" tech="XMPP">
+       <info name="MessageFromInfo" language="en_US" tech="XMPP">
                <para>Specifying a prefix of <literal>xmpp:</literal> will specify the
                account defined in <literal>xmpp.conf</literal> to send the message from.
                Note that this field is required for XMPP messages.</para>