{"diffoscope-json-version": 1, "source1": "/srv/reproducible-results/rbuild-debian/r-b-build.5GIkmXcI/b1/asterisk_16.28.0~dfsg-0+deb11u3_armhf.changes", "source2": "/srv/reproducible-results/rbuild-debian/r-b-build.5GIkmXcI/b2/asterisk_16.28.0~dfsg-0+deb11u3_armhf.changes", "unified_diff": null, "details": [{"source1": "Files", "source2": "Files", "unified_diff": "@@ -21,8 +21,8 @@\n  97e2a20c6cc5974c55153c759a523a4b 320604 debug optional asterisk-voicemail-imapstorage-dbgsym_16.28.0~dfsg-0+deb11u3_armhf.deb\n  a64646ad2cbec11c4fa0055da005e941 1454428 comm optional asterisk-voicemail-imapstorage_16.28.0~dfsg-0+deb11u3_armhf.deb\n  6840d38be771a0a4ff95e6e673e59270 285424 debug optional asterisk-voicemail-odbcstorage-dbgsym_16.28.0~dfsg-0+deb11u3_armhf.deb\n  0348c564a80b1665a628cf896780eb3a 1441744 comm optional asterisk-voicemail-odbcstorage_16.28.0~dfsg-0+deb11u3_armhf.deb\n  0c218542bafb5096ec0ecf37278006f1 1435868 comm optional asterisk-voicemail_16.28.0~dfsg-0+deb11u3_armhf.deb\n  1748696e5f8eaf9be81cd7ba7db880a1 69972 debug optional asterisk-vpb-dbgsym_16.28.0~dfsg-0+deb11u3_armhf.deb\n  2974dbb0fabb42dcadeb773264615a60 1362604 comm optional asterisk-vpb_16.28.0~dfsg-0+deb11u3_armhf.deb\n- 211c1edadd570bceac48695870387382 2221504 comm optional asterisk_16.28.0~dfsg-0+deb11u3_armhf.deb\n+ d5eae40fc4bb70c7103d2f8277bdcf03 2221376 comm optional asterisk_16.28.0~dfsg-0+deb11u3_armhf.deb\n"}, {"source1": "asterisk_16.28.0~dfsg-0+deb11u3_armhf.deb", "source2": "asterisk_16.28.0~dfsg-0+deb11u3_armhf.deb", "unified_diff": null, "details": [{"source1": "file list", "source2": "file list", "unified_diff": "@@ -1,3 +1,3 @@\n -rw-r--r--   0        0        0        4 2023-06-22 12:47:22.000000 debian-binary\n--rw-r--r--   0        0        0     8236 2023-06-22 12:47:22.000000 control.tar.xz\n--rw-r--r--   0        0        0  2213076 2023-06-22 12:47:22.000000 data.tar.xz\n+-rw-r--r--   0        0        0     8232 2023-06-22 12:47:22.000000 control.tar.xz\n+-rw-r--r--   0        0        0  2212952 2023-06-22 12:47:22.000000 data.tar.xz\n"}, {"source1": "control.tar.xz", "source2": "control.tar.xz", "unified_diff": null, "details": [{"source1": "control.tar", "source2": "control.tar", "unified_diff": null, "details": [{"source1": "./md5sums", "source2": "./md5sums", "unified_diff": null, "details": [{"source1": "./md5sums", "source2": "./md5sums", "comments": ["Files differ"], "unified_diff": null}]}]}]}, {"source1": "data.tar.xz", "source2": "data.tar.xz", "unified_diff": null, "details": [{"source1": "data.tar", "source2": "data.tar", "unified_diff": null, "details": [{"source1": "./usr/share/asterisk/documentation/core-en_US.xml", "source2": "./usr/share/asterisk/documentation/core-en_US.xml", "unified_diff": null, "details": [{"source1": "./usr/share/asterisk/documentation/core-en_US.xml", "source2": "./usr/share/asterisk/documentation/core-en_US.xml", "comments": ["Ordering differences only"], "unified_diff": "@@ -1,508 +1,22 @@\n <?xml version=\"1.0\" encoding=\"utf-8\"?>\n <!DOCTYPE docs\n   SYSTEM 'appdocsxml.dtd'>\n <?xml-stylesheet type=\"text/xsl\" href=\"appdocsxml.xslt\"?>\n <docs xmlns:xi=\"http://www.w3.org/2001/XInclude\">\n-  <module language=\"en_US\" name=\"reqresp_parser\">\n-    <support_level>extended</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"config_parser\">\n-    <support_level>extended</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"utils\">\n-    <support_level>extended</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"dialplan_functions\">\n-    <support_level>extended</support_level>\n-  </module>\n-  <info name=\"CHANNEL\" language=\"en_US\" tech=\"SIP\">\n-    <enumlist>\n-      <enum name=\"peerip\">\n-        <para>R/O Get the IP address of the peer.</para>\n-      </enum>\n-      <enum name=\"recvip\">\n-        <para>R/O Get the source IP address of the peer.</para>\n-      </enum>\n-      <enum name=\"recvport\">\n-        <para>R/O Get the source port of the peer.</para>\n-      </enum>\n-      <enum name=\"from\">\n-        <para>R/O Get the URI from the From: header.</para>\n-      </enum>\n-      <enum name=\"uri\">\n-        <para>R/O Get the URI from the Contact: header.</para>\n-      </enum>\n-      <enum name=\"ruri\">\n-        <para>R/O Get the Request-URI from the INVITE header.</para>\n-      </enum>\n-      <enum name=\"useragent\">\n-        <para>R/O Get the useragent.</para>\n-      </enum>\n-      <enum name=\"peername\">\n-        <para>R/O Get the name of the peer.</para>\n-      </enum>\n-      <enum name=\"t38passthrough\">\n-        <para>\n-          R/O\n-          <literal>1</literal>\n-          if T38 is offered or enabled in this channel,\n-\t\t\totherwise\n-          <literal>0</literal>\n-        </para>\n-      </enum>\n-      <enum name=\"rtpqos\">\n-        <para>R/O Get QOS information about the RTP stream</para>\n-        <para>This option takes two additional arguments:</para>\n-        <para>Argument 1:</para>\n-        <para>\n-          <literal>audio</literal>\n-          Get data about the audio stream\n-        </para>\n-        <para>\n-          <literal>video</literal>\n-          Get data about the video stream\n-        </para>\n-        <para>\n-          <literal>text</literal>\n-          Get data about the text stream\n-        </para>\n-        <para>Argument 2:</para>\n-        <para>\n-          <literal>local_ssrc</literal>\n-          Local SSRC (stream ID)\n-        </para>\n-        <para>\n-          <literal>local_lostpackets</literal>\n-          Local lost packets\n-        </para>\n-        <para>\n-          <literal>local_jitter</literal>\n-          Local calculated jitter\n-        </para>\n-        <para>\n-          <literal>local_maxjitter</literal>\n-          Local calculated jitter (maximum)\n-        </para>\n-        <para>\n-          <literal>local_minjitter</literal>\n-          Local calculated jitter (minimum)\n-        </para>\n-        <para>\n-          <literal>local_normdevjitter</literal>\n-          Local calculated jitter (normal deviation)\n-        </para>\n-        <para>\n-          <literal>local_stdevjitter</literal>\n-          Local calculated jitter (standard deviation)\n-        </para>\n-        <para>\n-          <literal>local_count</literal>\n-          Number of received packets\n-        </para>\n-        <para>\n-          <literal>remote_ssrc</literal>\n-          Remote SSRC (stream ID)\n-        </para>\n-        <para>\n-          <literal>remote_lostpackets</literal>\n-          Remote lost packets\n-        </para>\n-        <para>\n-          <literal>remote_jitter</literal>\n-          Remote reported jitter\n-        </para>\n-        <para>\n-          <literal>remote_maxjitter</literal>\n-          Remote calculated jitter (maximum)\n-        </para>\n-        <para>\n-          <literal>remote_minjitter</literal>\n-          Remote calculated jitter (minimum)\n-        </para>\n-        <para>\n-          <literal>remote_normdevjitter</literal>\n-          Remote calculated jitter (normal deviation)\n-        </para>\n-        <para>\n-          <literal>remote_stdevjitter</literal>\n-          Remote calculated jitter (standard deviation)\n-        </para>\n-        <para>\n-          <literal>remote_count</literal>\n-          Number of transmitted packets\n-        </para>\n-        <para>\n-          <literal>rtt</literal>\n-          Round trip time\n-        </para>\n-        <para>\n-          <literal>maxrtt</literal>\n-          Round trip time (maximum)\n-        </para>\n-        <para>\n-          <literal>minrtt</literal>\n-          Round trip time (minimum)\n-        </para>\n-        <para>\n-          <literal>normdevrtt</literal>\n-          Round trip time (normal deviation)\n-        </para>\n-        <para>\n-          <literal>stdevrtt</literal>\n-          Round trip time (standard deviation)\n-        </para>\n-        <para>\n-          <literal>all</literal>\n-          All statistics (in a form suited to logging,\n-\t\t\tbut not for parsing)\n-        </para>\n-      </enum>\n-      <enum name=\"rtpdest\">\n-        <para>R/O Get remote RTP destination information.</para>\n-        <para>This option takes one additional argument:</para>\n-        <para>Argument 1:</para>\n-        <para>\n-          <literal>audio</literal>\n-          Get audio destination\n-        </para>\n-        <para>\n-          <literal>video</literal>\n-          Get video destination\n-        </para>\n-        <para>\n-          <literal>text</literal>\n-          Get text destination\n-        </para>\n-        <para>\n-          Defaults to\n-          <literal>audio</literal>\n-          if unspecified.\n-        </para>\n-      </enum>\n-      <enum name=\"rtpsource\">\n-        <para>R/O Get source RTP destination information.</para>\n-        <para>This option takes one additional argument:</para>\n-        <para>Argument 1:</para>\n-        <para>\n-          <literal>audio</literal>\n-          Get audio destination\n-        </para>\n-        <para>\n-          <literal>video</literal>\n-          Get video destination\n-        </para>\n-        <para>\n-          <literal>text</literal>\n-          Get text destination\n-        </para>\n-        <para>\n-          Defaults to\n-          <literal>audio</literal>\n-          if unspecified.\n-        </para>\n-      </enum>\n-    </enumlist>\n-  </info>\n-  <module language=\"en_US\" name=\"route\">\n-    <support_level>extended</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"security_events\">\n-    <support_level>extended</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"sig_pri\">\n-    <support_level>core</support_level>\n-  </module>\n-  <managerEvent language=\"en_US\" name=\"MCID\">\n-    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n-      <synopsis>Published when a malicious call ID request arrives.</synopsis>\n-      <syntax>\n-        <channel_snapshot/>\n-        <parameter name=\"MCallerIDNumValid\"/>\n-        <parameter name=\"MCallerIDNum\"/>\n-        <parameter name=\"MCallerIDton\"/>\n-        <parameter name=\"MCallerIDNumPlan\"/>\n-        <parameter name=\"MCallerIDNumPres\"/>\n-        <parameter name=\"MCallerIDNameValid\"/>\n-        <parameter name=\"MCallerIDName\"/>\n-        <parameter name=\"MCallerIDNameCharSet\"/>\n-        <parameter name=\"MCallerIDNamePres\"/>\n-        <parameter name=\"MCallerIDSubaddr\"/>\n-        <parameter name=\"MCallerIDSubaddrType\"/>\n-        <parameter name=\"MCallerIDSubaddrOdd\"/>\n-        <parameter name=\"MCallerIDPres\"/>\n-        <parameter name=\"MConnectedIDNumValid\"/>\n-        <parameter name=\"MConnectedIDNum\"/>\n-        <parameter name=\"MConnectedIDton\"/>\n-        <parameter name=\"MConnectedIDNumPlan\"/>\n-        <parameter name=\"MConnectedIDNumPres\"/>\n-        <parameter name=\"MConnectedIDNameValid\"/>\n-        <parameter name=\"MConnectedIDName\"/>\n-        <parameter name=\"MConnectedIDNameCharSet\"/>\n-        <parameter name=\"MConnectedIDNamePres\"/>\n-        <parameter name=\"MConnectedIDSubaddr\"/>\n-        <parameter name=\"MConnectedIDSubaddrType\"/>\n-        <parameter name=\"MConnectedIDSubaddrOdd\"/>\n-        <parameter name=\"MConnectedIDPres\"/>\n-      </syntax>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <module language=\"en_US\" name=\"chan_bridge_media\">\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"chan_motif\">\n-    <depend>iksemel</depend>\n-    <depend>res_xmpp</depend>\n-    <use type=\"external\">openssl</use>\n-    <support_level>core</support_level>\n-  </module>\n-  <configInfo name=\"chan_motif\" language=\"en_US\">\n-    <synopsis>Jingle Channel Driver</synopsis>\n-    <description>\n-      <para>\n-        <emphasis>Transports</emphasis>\n-      </para>\n-      <para>\n-        There are three different transports and protocol derivatives\n-\t\t\tsupported by\n-        <literal>chan_motif</literal>\n-        . They are in order of\n-\t\t\tpreference: Jingle using ICE-UDP, Google Jingle, and Google-V1.\n-      </para>\n-      <para>\n-        Jingle as defined in XEP-0166 supports the widest range of\n-\t\t\tfeatures. It is referred to as\n-        <literal>ice-udp</literal>\n-        . This is\n-\t\t\tthe specification that Jingle clients implement.\n-      </para>\n-      <para>\n-        Google Jingle follows the Jingle specification for signaling\n-\t\t\tbut uses a custom transport for media. It is supported by the\n-\t\t\tGoogle Talk Plug-in in Gmail and by some other Jingle clients. It\n-\t\t\tis referred to as\n-        <literal>google</literal>\n-        in this file.\n-      </para>\n-      <para>\n-        Google-V1 is the original Google Talk signaling protocol\n-\t\t\twhich uses an initial preliminary version of Jingle. It also uses\n-\t\t\tthe same custom transport as Google Jingle for media. It is\n-\t\t\tsupported by Google Voice, some other Jingle clients, and the\n-\t\t\tWindows Google Talk client. It is referred to as\n-        <literal>google-v1</literal>\n-        in this file.\n-      </para>\n-      <para>Incoming sessions will automatically switch to the correct\n-\t\t\ttransport once it has been determined.</para>\n-      <para>Outgoing sessions are capable of determining if the target\n-\t\t\tis capable of Jingle or a Google transport if the target is in the\n-\t\t\troster. Unfortunately it is not possible to differentiate between\n-\t\t\ta Google Jingle or Google-V1 capable resource until a session\n-\t\t\tinitiate attempt occurs. If a resource is determined to use a\n-\t\t\tGoogle transport it will initially use Google Jingle but will fall\n-\t\t\tback to Google-V1 if required.</para>\n-      <para>\n-        If an outgoing session attempt fails due to failure to\n-\t\t\tsupport the given transport\n-        <literal>chan_motif</literal>\n-        will\n-\t\t\tfall back in preference order listed previously until all\n-\t\t\ttransports have been exhausted.\n-      </para>\n-      <para>\n-        <emphasis>Dialing and Resource Selection Strategy</emphasis>\n-      </para>\n-      <para>Placing a call through an endpoint can be accomplished using the\n-\t\t\tfollowing dial string:</para>\n-      <para>\n-        <literal>Motif/[endpoint name]/[target]</literal>\n-      </para>\n-      <para>When placing an outgoing call through an endpoint the requested\n-\t\t\ttarget is searched for in the roster list. If present the first Jingle\n-\t\t\tor Google Jingle capable resource is specifically targeted. Since the\n-\t\t\tcapabilities of the resource are known the outgoing session initiation\n-\t\t\twill disregard the configured transport and use the determined one.</para>\n-      <para>\n-        If the target is not found in the roster the target will be used\n-\t\t\tas-is and a session will be initiated using the transport specified\n-\t\t\tin this configuration file. If no transport has been specified the\n-\t\t\tendpoint defaults to\n-        <literal>ice-udp</literal>\n-        .\n-      </para>\n-      <para>\n-        <emphasis>Video Support</emphasis>\n-      </para>\n-      <para>Support for video does not need to be explicitly enabled.\n-\t\t\tConfiguring any video codec on your endpoint will automatically enable\n-\t\t\tit.</para>\n-      <para>\n-        <emphasis>DTMF</emphasis>\n-      </para>\n-      <para>The only supported method for DTMF is RFC2833. This is always\n-\t\t\tenabled on audio streams and negotiated if possible.</para>\n-      <para>\n-        <emphasis>Incoming Calls</emphasis>\n-      </para>\n-      <para>\n-        Incoming calls will first look for the extension matching the\n-\t\t\tname of the endpoint in the configured context. If no such extension\n-\t\t\texists the call will automatically fall back to the\n-        <literal>s</literal>\n-        extension.\n-      </para>\n-      <para>\n-        <emphasis>CallerID</emphasis>\n-      </para>\n-      <para>The incoming caller id number is populated with the username of\n-\t\t\tthe caller and the name is populated with the full identity of the\n-\t\t\tcaller. If you would like to perform authentication or filtering\n-\t\t\tof incoming calls it is recommended that you use these fields to do so.</para>\n-      <para>\n-        Outgoing caller id can\n-        <emphasis>not</emphasis>\n-        be set.\n-      </para>\n-      <warning>\n-        <para>\n-          Multiple endpoints using the\n-\t\t\t\tsame connection is\n-          <emphasis>NOT</emphasis>\n-          supported. Doing so\n-\t\t\t\tmay result in broken calls.\n-        </para>\n-      </warning>\n-    </description>\n-    <configFile name=\"motif.conf\">\n-      <configObject name=\"endpoint\">\n-        <synopsis>The configuration for an endpoint.</synopsis>\n-        <configOption name=\"context\">\n-          <synopsis>Default dialplan context that incoming sessions will be routed to</synopsis>\n-        </configOption>\n-        <configOption name=\"callgroup\">\n-          <synopsis>A callgroup to assign to this endpoint.</synopsis>\n-        </configOption>\n-        <configOption name=\"pickupgroup\">\n-          <synopsis>A pickup group to assign to this endpoint.</synopsis>\n-        </configOption>\n-        <configOption name=\"language\">\n-          <synopsis>The default language for this endpoint.</synopsis>\n-        </configOption>\n-        <configOption name=\"musicclass\">\n-          <synopsis>Default music on hold class for this endpoint.</synopsis>\n-        </configOption>\n-        <configOption name=\"parkinglot\">\n-          <synopsis>Default parking lot for this endpoint.</synopsis>\n-        </configOption>\n-        <configOption name=\"accountcode\">\n-          <synopsis>Accout code for CDR purposes</synopsis>\n-        </configOption>\n-        <configOption name=\"allow\">\n-          <synopsis>Codecs to allow</synopsis>\n-        </configOption>\n-        <configOption name=\"disallow\">\n-          <synopsis>Codecs to disallow</synopsis>\n-        </configOption>\n-        <configOption name=\"connection\">\n-          <synopsis>Connection to accept traffic on and on which to send traffic out</synopsis>\n-        </configOption>\n-        <configOption name=\"transport\">\n-          <synopsis>The transport to use for the endpoint.</synopsis>\n-          <description>\n-            <para>\n-              The default outbound transport for this endpoint. Inbound\n-\t\t\t\t\t\tmessages are inferred. Allowed transports are\n-              <literal>ice-udp</literal>\n-              ,\n-              <literal>google</literal>\n-              , or\n-              <literal>google-v1</literal>\n-              . Note\n-\t\t\t\t\t\tthat\n-              <literal>chan_motif</literal>\n-              will fall back to transport\n-\t\t\t\t\t\tpreference order if the transport value chosen here fails.\n-            </para>\n-            <enumlist>\n-              <enum name=\"ice-udp\">\n-                <para>The Jingle protocol, as defined in XEP 0166.</para>\n-              </enum>\n-              <enum name=\"google\">\n-                <para>The Google Jingle protocol, which follows the Jingle\n-\t\t\t\t\t\t\t\tspecification for signaling but uses a custom transport for\n-\t\t\t\t\t\t\t\tmedia.</para>\n-              </enum>\n-              <enum name=\"google-v1\">\n-                <para>\n-                  Google-V1 is the original Google Talk signaling\n-\t\t\t\t\t\t\t\tprotocol which uses an initial preliminary version of Jingle.\n-\t\t\t\t\t\t\t\tIt also uses the same custom transport as\n-                  <literal>google</literal>\n-                  for media.\n-                </para>\n-              </enum>\n-            </enumlist>\n-          </description>\n-        </configOption>\n-        <configOption name=\"maxicecandidates\">\n-          <synopsis>Maximum number of ICE candidates to offer</synopsis>\n-        </configOption>\n-        <configOption name=\"maxpayloads\">\n-          <synopsis>Maximum number of payloads to offer</synopsis>\n-        </configOption>\n-      </configObject>\n-    </configFile>\n-  </configInfo>\n-  <module language=\"en_US\" name=\"chan_misdn\">\n-    <depend>isdnnet</depend>\n-    <depend>misdn</depend>\n-    <depend>suppserv</depend>\n-    <support_level>deprecated</support_level>\n-    <replacement>chan_dahdi</replacement>\n-    <deprecated_in>16</deprecated_in>\n-    <removed_in>19</removed_in>\n-  </module>\n-  <module language=\"en_US\" name=\"chan_rtp\">\n-    <depend>res_rtp_multicast</depend>\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"vcodecs\">\n+  <module language=\"en_US\" name=\"chan_alsa\">\n+    <depend>alsa</depend>\n     <support_level>extended</support_level>\n+    <deprecated_in>19</deprecated_in>\n+    <removed_in>21</removed_in>\n   </module>\n-  <module language=\"en_US\" name=\"chan_vpb.cc\">\n-    <depend>vpb</depend>\n-    <defaultenabled>yes</defaultenabled>\n-    <support_level>deprecated</support_level>\n-    <deprecated_in>16</deprecated_in>\n-    <removed_in>19</removed_in>\n-  </module>\n-  <module language=\"en_US\" name=\"parser\">\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"firmware\">\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"codec_pref\">\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"provision\">\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"format_compatibility\">\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"netsock\">\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"console_gui\">\n+  <module language=\"en_US\" name=\"chan_unistim\">\n     <support_level>extended</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"chan_console\">\n-    <depend>portaudio</depend>\n+  <module language=\"en_US\" name=\"vgrabbers\">\n     <support_level>extended</support_level>\n   </module>\n   <module language=\"en_US\" name=\"dialplan_functions\">\n     <support_level>core</support_level>\n   </module>\n   <function name=\"PJSIP_DIAL_CONTACTS\" language=\"en_US\">\n     <synopsis>Return a dial string for dialing all contacts on an AOR.</synopsis>\n@@ -1147,501 +661,21 @@\n \t\t; Log the destination address of the audio stream\n \t\tsame =&gt; n,Log(NOTICE, ${CHANNEL(rtp,dest)})\n \n \t\t; Store the round-trip time associated with a\n \t\t; video stream in the CDR field video-rtt\n \t\tsame =&gt; n,Set(CDR(video-rtt)=${CHANNEL(rtcp,rtt,video)})</example>\n   </info>\n-  <module language=\"en_US\" name=\"sig_ss7\">\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"chan_dahdi\">\n-    <depend>dahdi</depend>\n-    <depend>tonezone</depend>\n-    <use type=\"module\">res_smdi</use>\n-    <use type=\"external\">pri</use>\n-    <use type=\"external\">ss7</use>\n-    <use type=\"external\">openr2</use>\n+  <module language=\"en_US\" name=\"chan_rtp\">\n+    <depend>res_rtp_multicast</depend>\n     <support_level>core</support_level>\n   </module>\n-  <application name=\"DAHDISendKeypadFacility\" language=\"en_US\">\n-    <synopsis>Send digits out of band over a PRI.</synopsis>\n-    <syntax>\n-      <parameter name=\"digits\" required=\"true\"/>\n-    </syntax>\n-    <description>\n-      <para>This application will send the given string of digits in a Keypad\n-\t\t\tFacility IE over the current channel.</para>\n-    </description>\n-  </application>\n-  <application name=\"DAHDISendCallreroutingFacility\" language=\"en_US\">\n-    <synopsis>Send an ISDN call rerouting/deflection facility message.</synopsis>\n-    <syntax argsep=\",\">\n-      <parameter name=\"destination\" required=\"true\">\n-        <para>Destination number.</para>\n-      </parameter>\n-      <parameter name=\"original\">\n-        <para>Original called number.</para>\n-      </parameter>\n-      <parameter name=\"reason\">\n-        <para>\n-          Diversion reason, if not specified defaults to\n-          <literal>unknown</literal>\n-        </para>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>This application will send an ISDN switch specific call\n-\t\t\trerouting/deflection facility message over the current channel.\n-\t\t\tSupported switches depend upon the version of libpri in use.</para>\n-    </description>\n-  </application>\n-  <application name=\"DAHDIAcceptR2Call\" language=\"en_US\">\n-    <synopsis>Accept an R2 call if its not already accepted (you still need to answer it)</synopsis>\n-    <syntax>\n-      <parameter name=\"charge\" required=\"true\">\n-        <para>Yes or No.</para>\n-        <para>Whether you want to accept the call with charge or without charge.</para>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>This application will Accept the R2 call either with charge or no charge.</para>\n-    </description>\n-  </application>\n-  <function name=\"POLARITY\" language=\"en_US\">\n-    <synopsis>Set or get the polarity of a DAHDI channel.</synopsis>\n-    <syntax/>\n-    <description>\n-      <para>The POLARITY function can be used to set the polarity of a DAHDI channel.</para>\n-      <para>Applies only to FXS channels (using FXO signalling) with supporting hardware.</para>\n-      <para>The polarity can be set to the following numeric or named values:</para>\n-      <enumlist>\n-        <enum name=\"0\"/>\n-        <enum name=\"idle\"/>\n-        <enum name=\"1\"/>\n-        <enum name=\"reverse\"/>\n-      </enumlist>\n-      <para>However, when read, the function will always return 0 or 1.</para>\n-      <example title=\"Set idle polarity\">same =&gt; n,Set(POLARITY()=0)</example>\n-      <example title=\"Set reverse polarity\">same =&gt; n,NoOp(Current Polarity: ${POLARITY()})\n-\t\t\tsame =&gt; n,Set(POLARITY()=reverse)\n-\t\t\tsame =&gt; n,NoOp(New Polarity: ${POLARITY()})</example>\n-      <example title=\"Reverse the polarity from whatever it is currently\">same =&gt; n,Set(POLARITY()=${IF($[ &quot;${POLARITY()}&quot; = &quot;1&quot; ]?0:1)})</example>\n-    </description>\n-  </function>\n-  <info name=\"CHANNEL\" language=\"en_US\" tech=\"DAHDI\">\n-    <enumlist>\n-      <enum name=\"dahdi_channel\">\n-        <para>R/O DAHDI channel related to this channel.</para>\n-      </enum>\n-      <enum name=\"dahdi_span\">\n-        <para>R/O DAHDI span related to this channel.</para>\n-      </enum>\n-      <enum name=\"dahdi_group\">\n-        <para>R/O DAHDI logical group related to this channel.</para>\n-      </enum>\n-      <enum name=\"dahdi_type\">\n-        <para>R/O DAHDI channel type, one of:</para>\n-        <enumlist>\n-          <enum name=\"analog\"/>\n-          <enum name=\"mfc/r2\"/>\n-          <enum name=\"pri\"/>\n-          <enum name=\"pseudo\"/>\n-          <enum name=\"ss7\"/>\n-        </enumlist>\n-      </enum>\n-      <enum name=\"keypad_digits\">\n-        <para>R/O PRI Keypad digits that came in with the SETUP message.</para>\n-      </enum>\n-      <enum name=\"reversecharge\">\n-        <para>R/O PRI Reverse Charging Indication, one of:</para>\n-        <enumlist>\n-          <enum name=\"-1\">\n-            <para>None</para>\n-          </enum>\n-          <enum name=\" 1\">\n-            <para>Reverse Charging Requested</para>\n-          </enum>\n-        </enumlist>\n-      </enum>\n-      <enum name=\"no_media_path\">\n-        <para>R/O PRI Nonzero if the channel has no B channel.\n-\t\t\t\tThe channel is either on hold or a call waiting call.</para>\n-      </enum>\n-      <enum name=\"buffers\">\n-        <para>W/O Change the channel's buffer policy (for the current call only)</para>\n-        <para>This option takes two arguments:</para>\n-        <para>Number of buffers,</para>\n-        <para>Buffer policy being one of:</para>\n-        <para>\n-          <literal>full</literal>\n-        </para>\n-        <para>\n-          <literal>immediate</literal>\n-        </para>\n-        <para>\n-          <literal>half</literal>\n-        </para>\n-      </enum>\n-      <enum name=\"echocan_mode\">\n-        <para>W/O Change the configuration of the active echo\n-\t\t\t\tcanceller on the channel (if any), for the current call\n-\t\t\t\tonly.</para>\n-        <para>Possible values are:</para>\n-        <para>\n-          <literal>on</literal>\n-          Normal mode (the echo canceller is actually reinitialized)\n-        </para>\n-        <para>\n-          <literal>off</literal>\n-          Disabled\n-        </para>\n-        <para>\n-          <literal>fax</literal>\n-          FAX/data mode (NLP disabled if possible, otherwise\n-\t\t\t\t\tcompletely disabled)\n-        </para>\n-        <para>\n-          <literal>voice</literal>\n-          Voice mode (returns from FAX mode, reverting the changes that were made)\n-        </para>\n-      </enum>\n-    </enumlist>\n-  </info>\n-  <info name=\"Dial_Resource\" language=\"en_US\" tech=\"DAHDI\">\n-    <para>DAHDI allows several modifiers to be specified as part of the resource.</para>\n-    <para>The general syntax is :</para>\n-    <para>\n-      <literal>Dial(DAHDI/pseudo[/extension])</literal>\n-    </para>\n-    <para>\n-      <literal>Dial(DAHDI/&lt;channel#&gt;[c|r&lt;cadence#&gt;|d][/extension])</literal>\n-    </para>\n-    <para>\n-      <literal>Dial(DAHDI/(g|G|r|R)&lt;group#(0-63)&gt;[c|r&lt;cadence#&gt;|d][/extension])</literal>\n-    </para>\n-    <para>The following modifiers may be used before the channel number:</para>\n-    <enumlist>\n-      <enum name=\"g\">\n-        <para>Search forward, dialing on first available channel in group (lowest to highest).</para>\n-      </enum>\n-      <enum name=\"G\">\n-        <para>Search backward, dialing on first available channel in group (highest to lowest).</para>\n-      </enum>\n-      <enum name=\"r\">\n-        <para>Round robin search forward, picking up from where last left off (lowest to highest).</para>\n-      </enum>\n-      <enum name=\"R\">\n-        <para>Round robin search backward, picking up from where last left off (highest to lowest).</para>\n-      </enum>\n-    </enumlist>\n-    <para>The following modifiers may be used after the channel number:</para>\n-    <enumlist>\n-      <enum name=\"c\">\n-        <para>\n-          Wait for DTMF digit\n-          <literal>#</literal>\n-          before providing answer supervision.\n-        </para>\n-        <para>This can be useful on outbound calls via FXO ports, as otherwise\n-\t\t\tthey would indicate answer immediately.</para>\n-      </enum>\n-      <enum name=\"d\">\n-        <para>Force bearer capability for ISDN/SS7 call to digital.</para>\n-      </enum>\n-      <enum name=\"i\">\n-        <para>ISDN span channel restriction.</para>\n-        <para>Used by CC to ensure that the CC recall goes out the same span.\n-\t\t\tAlso to make ISDN channel names dialable when the sequence number\n-\t\t\tis stripped off.  (Used by DTMF attended transfer feature.)</para>\n-      </enum>\n-      <enum name=\"r\">\n-        <para>Specifies the distinctive ring cadence number to use immediately after\n-\t\t\tspecifying this option. There are 4 default built-in cadences, and up to 24\n-\t\t\ttotal cadences may be configured.</para>\n-      </enum>\n-    </enumlist>\n-    <example title=\"Dial 555-1212 on first available channel in group 1, searching from highest to lowest\">same =&gt; n,Dial(DAHDI/g1/5551212)</example>\n-    <example title=\"Ringing FXS channel 4 with ring cadence 2\">same =&gt; n,Dial(DAHDI/4r2)</example>\n-    <example title=\"Dial 555-1212 on channel 3 and require answer confirmation\">same =&gt; n,Dial(DAHDI/3c/5551212)</example>\n-  </info>\n-  <manager name=\"DAHDITransfer\" language=\"en_US\">\n-    <synopsis>Transfer DAHDI Channel.</synopsis>\n-    <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"DAHDIChannel\" required=\"true\">\n-        <para>DAHDI channel number to transfer.</para>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>Simulate a flash hook event by the user connected to the channel.</para>\n-      <note>\n-        <para>Valid only for analog channels.</para>\n-      </note>\n-    </description>\n-  </manager>\n-  <manager name=\"DAHDIHangup\" language=\"en_US\">\n-    <synopsis>Hangup DAHDI Channel.</synopsis>\n-    <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"DAHDIChannel\" required=\"true\">\n-        <para>DAHDI channel number to hangup.</para>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>Simulate an on-hook event by the user connected to the channel.</para>\n-      <note>\n-        <para>Valid only for analog channels.</para>\n-      </note>\n-    </description>\n-  </manager>\n-  <manager name=\"DAHDIDialOffhook\" language=\"en_US\">\n-    <synopsis>Dial over DAHDI channel while offhook.</synopsis>\n-    <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"DAHDIChannel\" required=\"true\">\n-        <para>DAHDI channel number to dial digits.</para>\n-      </parameter>\n-      <parameter name=\"Number\" required=\"true\">\n-        <para>Digits to dial.</para>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>Generate DTMF control frames to the bridged peer.</para>\n-    </description>\n-  </manager>\n-  <manager name=\"DAHDIDNDon\" language=\"en_US\">\n-    <synopsis>Toggle DAHDI channel Do Not Disturb status ON.</synopsis>\n-    <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"DAHDIChannel\" required=\"true\">\n-        <para>DAHDI channel number to set DND on.</para>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>\n-        Equivalent to the CLI command &quot;dahdi set dnd\n-        <variable>channel</variable>\n-        on&quot;.\n-      </para>\n-      <note>\n-        <para>Feature only supported by analog channels.</para>\n-      </note>\n-    </description>\n-  </manager>\n-  <manager name=\"DAHDIDNDoff\" language=\"en_US\">\n-    <synopsis>Toggle DAHDI channel Do Not Disturb status OFF.</synopsis>\n-    <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"DAHDIChannel\" required=\"true\">\n-        <para>DAHDI channel number to set DND off.</para>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>\n-        Equivalent to the CLI command &quot;dahdi set dnd\n-        <variable>channel</variable>\n-        off&quot;.\n-      </para>\n-      <note>\n-        <para>Feature only supported by analog channels.</para>\n-      </note>\n-    </description>\n-  </manager>\n-  <manager name=\"DAHDIShowChannels\" language=\"en_US\">\n-    <synopsis>Show status of DAHDI channels.</synopsis>\n-    <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"DAHDIChannel\">\n-        <para>Specify the specific channel number to show.  Show all channels if zero or not present.</para>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>Similar to the CLI command &quot;dahdi show channels&quot;.</para>\n-    </description>\n-  </manager>\n-  <manager name=\"DAHDIRestart\" language=\"en_US\">\n-    <synopsis>Fully Restart DAHDI channels (terminates calls).</synopsis>\n-    <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-    </syntax>\n-    <description>\n-      <para>Equivalent to the CLI command &quot;dahdi restart&quot;.</para>\n-    </description>\n-  </manager>\n-  <manager name=\"PRIShowSpans\" language=\"en_US\">\n-    <synopsis>Show status of PRI spans.</synopsis>\n-    <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"Span\">\n-        <para>Specify the specific span to show.  Show all spans if zero or not present.</para>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>Similar to the CLI command &quot;pri show spans&quot;.</para>\n-    </description>\n-  </manager>\n-  <manager name=\"PRIDebugSet\" language=\"en_US\">\n-    <synopsis>Set PRI debug levels for a span</synopsis>\n-    <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"Span\" required=\"true\">\n-        <para>Which span to affect.</para>\n-      </parameter>\n-      <parameter name=\"Level\" required=\"true\">\n-        <para>What debug level to set. May be a numerical value or a text value from the list below</para>\n-        <enumlist>\n-          <enum name=\"off\"/>\n-          <enum name=\"on\"/>\n-          <enum name=\"hex\"/>\n-          <enum name=\"intense\"/>\n-        </enumlist>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>Equivalent to the CLI command &quot;pri set debug &lt;level&gt; span &lt;span&gt;&quot;.</para>\n-    </description>\n-  </manager>\n-  <manager name=\"PRIDebugFileSet\" language=\"en_US\">\n-    <synopsis>Set the file used for PRI debug message output</synopsis>\n-    <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"File\" required=\"true\">\n-        <para>Path of file to write debug output.</para>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>Equivalent to the CLI command &quot;pri set debug file &lt;output-file&gt;&quot;</para>\n-    </description>\n-  </manager>\n-  <manager name=\"PRIDebugFileUnset\" language=\"en_US\">\n-    <synopsis>Disables file output for PRI debug messages</synopsis>\n-    <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-    </syntax>\n-  </manager>\n-  <managerEvent language=\"en_US\" name=\"AlarmClear\">\n-    <managerEventInstance class=\"EVENT_FLAG_SYSTEM\">\n-      <synopsis>Raised when an alarm is cleared on a DAHDI channel.</synopsis>\n-      <syntax>\n-        <parameter name=\"DAHDIChannel\">\n-          <para>The DAHDI channel on which the alarm was cleared.</para>\n-          <note>\n-            <para>This is not an Asterisk channel identifier.</para>\n-          </note>\n-        </parameter>\n-      </syntax>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <managerEvent language=\"en_US\" name=\"SpanAlarmClear\">\n-    <managerEventInstance class=\"EVENT_FLAG_SYSTEM\">\n-      <synopsis>Raised when an alarm is cleared on a DAHDI span.</synopsis>\n-      <syntax>\n-        <parameter name=\"Span\">\n-          <para>The span on which the alarm was cleared.</para>\n-        </parameter>\n-      </syntax>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <managerEvent language=\"en_US\" name=\"DNDState\">\n-    <managerEventInstance class=\"EVENT_FLAG_SYSTEM\">\n-      <synopsis>Raised when the Do Not Disturb state is changed on a DAHDI channel.</synopsis>\n-      <syntax>\n-        <parameter name=\"DAHDIChannel\">\n-          <para>The DAHDI channel on which DND status changed.</para>\n-          <note>\n-            <para>This is not an Asterisk channel identifier.</para>\n-          </note>\n-        </parameter>\n-        <parameter name=\"Status\">\n-          <enumlist>\n-            <enum name=\"enabled\"/>\n-            <enum name=\"disabled\"/>\n-          </enumlist>\n-        </parameter>\n-      </syntax>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <managerEvent language=\"en_US\" name=\"Alarm\">\n-    <managerEventInstance class=\"EVENT_FLAG_SYSTEM\">\n-      <synopsis>Raised when an alarm is set on a DAHDI channel.</synopsis>\n-      <syntax>\n-        <parameter name=\"DAHDIChannel\">\n-          <para>The channel on which the alarm occurred.</para>\n-          <note>\n-            <para>This is not an Asterisk channel identifier.</para>\n-          </note>\n-        </parameter>\n-        <parameter name=\"Alarm\">\n-          <para>A textual description of the alarm that occurred.</para>\n-        </parameter>\n-      </syntax>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <managerEvent language=\"en_US\" name=\"SpanAlarm\">\n-    <managerEventInstance class=\"EVENT_FLAG_SYSTEM\">\n-      <synopsis>Raised when an alarm is set on a DAHDI span.</synopsis>\n-      <syntax>\n-        <parameter name=\"Span\">\n-          <para>The span on which the alarm occurred.</para>\n-        </parameter>\n-        <parameter name=\"Alarm\">\n-          <para>A textual description of the alarm that occurred.</para>\n-        </parameter>\n-      </syntax>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <managerEvent language=\"en_US\" name=\"DAHDIChannel\">\n-    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n-      <synopsis>Raised when a DAHDI channel is created or an underlying technology is associated with a DAHDI channel.</synopsis>\n-      <syntax>\n-        <channel_snapshot/>\n-        <parameter name=\"DAHDIGroup\">\n-          <para>The DAHDI logical group associated with this channel.</para>\n-        </parameter>\n-        <parameter name=\"DAHDISpan\">\n-          <para>The DAHDI span associated with this channel.</para>\n-        </parameter>\n-        <parameter name=\"DAHDIChannel\">\n-          <para>The DAHDI channel associated with this channel.</para>\n-        </parameter>\n-      </syntax>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <module language=\"en_US\" name=\"chan_alsa\">\n-    <depend>alsa</depend>\n-    <support_level>extended</support_level>\n-    <deprecated_in>19</deprecated_in>\n-    <removed_in>21</removed_in>\n-  </module>\n-  <module language=\"en_US\" name=\"chan_unistim\">\n-    <support_level>extended</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"portinfo\">\n-    <support_level>extended</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"isdn_msg_parser\">\n-    <support_level>extended</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"isdn_lib\">\n-    <support_level>extended</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"ie\">\n+  <module language=\"en_US\" name=\"misdn_config\">\n     <support_level>extended</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"chan_pjsip\">\n-    <depend>pjproject</depend>\n-    <depend>res_pjsip</depend>\n-    <depend>res_pjsip_pubsub</depend>\n-    <depend>res_pjsip_session</depend>\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"bridge_native_dahdi\">\n-    <support_level>core</support_level>\n-  </module>\n   <module language=\"en_US\" name=\"chan_sip\">\n     <use type=\"module\">res_crypto</use>\n     <use type=\"module\">res_http_websocket</use>\n     <support_level>extended</support_level>\n     <deprecated_in>17</deprecated_in>\n     <removed_in>21</removed_in>\n   </module>\n@@ -2056,18 +1090,446 @@\n             <enum name=\"RTPTimeout\"/>\n             <enum name=\"SIPSessionTimer\"/>\n           </enumlist>\n         </parameter>\n       </syntax>\n     </managerEventInstance>\n   </managerEvent>\n-  <module language=\"en_US\" name=\"misdn_config\">\n+  <module language=\"en_US\" name=\"console_gui\">\n     <support_level>extended</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"vgrabbers\">\n+  <module language=\"en_US\" name=\"netsock\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"firmware\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"codec_pref\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"parser\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"provision\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"format_compatibility\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"sig_analog\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"chan_motif\">\n+    <depend>iksemel</depend>\n+    <depend>res_xmpp</depend>\n+    <use type=\"external\">openssl</use>\n+    <support_level>core</support_level>\n+  </module>\n+  <configInfo name=\"chan_motif\" language=\"en_US\">\n+    <synopsis>Jingle Channel Driver</synopsis>\n+    <description>\n+      <para>\n+        <emphasis>Transports</emphasis>\n+      </para>\n+      <para>\n+        There are three different transports and protocol derivatives\n+\t\t\tsupported by\n+        <literal>chan_motif</literal>\n+        . They are in order of\n+\t\t\tpreference: Jingle using ICE-UDP, Google Jingle, and Google-V1.\n+      </para>\n+      <para>\n+        Jingle as defined in XEP-0166 supports the widest range of\n+\t\t\tfeatures. It is referred to as\n+        <literal>ice-udp</literal>\n+        . This is\n+\t\t\tthe specification that Jingle clients implement.\n+      </para>\n+      <para>\n+        Google Jingle follows the Jingle specification for signaling\n+\t\t\tbut uses a custom transport for media. It is supported by the\n+\t\t\tGoogle Talk Plug-in in Gmail and by some other Jingle clients. It\n+\t\t\tis referred to as\n+        <literal>google</literal>\n+        in this file.\n+      </para>\n+      <para>\n+        Google-V1 is the original Google Talk signaling protocol\n+\t\t\twhich uses an initial preliminary version of Jingle. It also uses\n+\t\t\tthe same custom transport as Google Jingle for media. It is\n+\t\t\tsupported by Google Voice, some other Jingle clients, and the\n+\t\t\tWindows Google Talk client. It is referred to as\n+        <literal>google-v1</literal>\n+        in this file.\n+      </para>\n+      <para>Incoming sessions will automatically switch to the correct\n+\t\t\ttransport once it has been determined.</para>\n+      <para>Outgoing sessions are capable of determining if the target\n+\t\t\tis capable of Jingle or a Google transport if the target is in the\n+\t\t\troster. Unfortunately it is not possible to differentiate between\n+\t\t\ta Google Jingle or Google-V1 capable resource until a session\n+\t\t\tinitiate attempt occurs. If a resource is determined to use a\n+\t\t\tGoogle transport it will initially use Google Jingle but will fall\n+\t\t\tback to Google-V1 if required.</para>\n+      <para>\n+        If an outgoing session attempt fails due to failure to\n+\t\t\tsupport the given transport\n+        <literal>chan_motif</literal>\n+        will\n+\t\t\tfall back in preference order listed previously until all\n+\t\t\ttransports have been exhausted.\n+      </para>\n+      <para>\n+        <emphasis>Dialing and Resource Selection Strategy</emphasis>\n+      </para>\n+      <para>Placing a call through an endpoint can be accomplished using the\n+\t\t\tfollowing dial string:</para>\n+      <para>\n+        <literal>Motif/[endpoint name]/[target]</literal>\n+      </para>\n+      <para>When placing an outgoing call through an endpoint the requested\n+\t\t\ttarget is searched for in the roster list. If present the first Jingle\n+\t\t\tor Google Jingle capable resource is specifically targeted. Since the\n+\t\t\tcapabilities of the resource are known the outgoing session initiation\n+\t\t\twill disregard the configured transport and use the determined one.</para>\n+      <para>\n+        If the target is not found in the roster the target will be used\n+\t\t\tas-is and a session will be initiated using the transport specified\n+\t\t\tin this configuration file. If no transport has been specified the\n+\t\t\tendpoint defaults to\n+        <literal>ice-udp</literal>\n+        .\n+      </para>\n+      <para>\n+        <emphasis>Video Support</emphasis>\n+      </para>\n+      <para>Support for video does not need to be explicitly enabled.\n+\t\t\tConfiguring any video codec on your endpoint will automatically enable\n+\t\t\tit.</para>\n+      <para>\n+        <emphasis>DTMF</emphasis>\n+      </para>\n+      <para>The only supported method for DTMF is RFC2833. This is always\n+\t\t\tenabled on audio streams and negotiated if possible.</para>\n+      <para>\n+        <emphasis>Incoming Calls</emphasis>\n+      </para>\n+      <para>\n+        Incoming calls will first look for the extension matching the\n+\t\t\tname of the endpoint in the configured context. If no such extension\n+\t\t\texists the call will automatically fall back to the\n+        <literal>s</literal>\n+        extension.\n+      </para>\n+      <para>\n+        <emphasis>CallerID</emphasis>\n+      </para>\n+      <para>The incoming caller id number is populated with the username of\n+\t\t\tthe caller and the name is populated with the full identity of the\n+\t\t\tcaller. If you would like to perform authentication or filtering\n+\t\t\tof incoming calls it is recommended that you use these fields to do so.</para>\n+      <para>\n+        Outgoing caller id can\n+        <emphasis>not</emphasis>\n+        be set.\n+      </para>\n+      <warning>\n+        <para>\n+          Multiple endpoints using the\n+\t\t\t\tsame connection is\n+          <emphasis>NOT</emphasis>\n+          supported. Doing so\n+\t\t\t\tmay result in broken calls.\n+        </para>\n+      </warning>\n+    </description>\n+    <configFile name=\"motif.conf\">\n+      <configObject name=\"endpoint\">\n+        <synopsis>The configuration for an endpoint.</synopsis>\n+        <configOption name=\"context\">\n+          <synopsis>Default dialplan context that incoming sessions will be routed to</synopsis>\n+        </configOption>\n+        <configOption name=\"callgroup\">\n+          <synopsis>A callgroup to assign to this endpoint.</synopsis>\n+        </configOption>\n+        <configOption name=\"pickupgroup\">\n+          <synopsis>A pickup group to assign to this endpoint.</synopsis>\n+        </configOption>\n+        <configOption name=\"language\">\n+          <synopsis>The default language for this endpoint.</synopsis>\n+        </configOption>\n+        <configOption name=\"musicclass\">\n+          <synopsis>Default music on hold class for this endpoint.</synopsis>\n+        </configOption>\n+        <configOption name=\"parkinglot\">\n+          <synopsis>Default parking lot for this endpoint.</synopsis>\n+        </configOption>\n+        <configOption name=\"accountcode\">\n+          <synopsis>Accout code for CDR purposes</synopsis>\n+        </configOption>\n+        <configOption name=\"allow\">\n+          <synopsis>Codecs to allow</synopsis>\n+        </configOption>\n+        <configOption name=\"disallow\">\n+          <synopsis>Codecs to disallow</synopsis>\n+        </configOption>\n+        <configOption name=\"connection\">\n+          <synopsis>Connection to accept traffic on and on which to send traffic out</synopsis>\n+        </configOption>\n+        <configOption name=\"transport\">\n+          <synopsis>The transport to use for the endpoint.</synopsis>\n+          <description>\n+            <para>\n+              The default outbound transport for this endpoint. Inbound\n+\t\t\t\t\t\tmessages are inferred. Allowed transports are\n+              <literal>ice-udp</literal>\n+              ,\n+              <literal>google</literal>\n+              , or\n+              <literal>google-v1</literal>\n+              . Note\n+\t\t\t\t\t\tthat\n+              <literal>chan_motif</literal>\n+              will fall back to transport\n+\t\t\t\t\t\tpreference order if the transport value chosen here fails.\n+            </para>\n+            <enumlist>\n+              <enum name=\"ice-udp\">\n+                <para>The Jingle protocol, as defined in XEP 0166.</para>\n+              </enum>\n+              <enum name=\"google\">\n+                <para>The Google Jingle protocol, which follows the Jingle\n+\t\t\t\t\t\t\t\tspecification for signaling but uses a custom transport for\n+\t\t\t\t\t\t\t\tmedia.</para>\n+              </enum>\n+              <enum name=\"google-v1\">\n+                <para>\n+                  Google-V1 is the original Google Talk signaling\n+\t\t\t\t\t\t\t\tprotocol which uses an initial preliminary version of Jingle.\n+\t\t\t\t\t\t\t\tIt also uses the same custom transport as\n+                  <literal>google</literal>\n+                  for media.\n+                </para>\n+              </enum>\n+            </enumlist>\n+          </description>\n+        </configOption>\n+        <configOption name=\"maxicecandidates\">\n+          <synopsis>Maximum number of ICE candidates to offer</synopsis>\n+        </configOption>\n+        <configOption name=\"maxpayloads\">\n+          <synopsis>Maximum number of payloads to offer</synopsis>\n+        </configOption>\n+      </configObject>\n+    </configFile>\n+  </configInfo>\n+  <module language=\"en_US\" name=\"dialplan_functions\">\n+    <support_level>extended</support_level>\n+  </module>\n+  <info name=\"CHANNEL\" language=\"en_US\" tech=\"SIP\">\n+    <enumlist>\n+      <enum name=\"peerip\">\n+        <para>R/O Get the IP address of the peer.</para>\n+      </enum>\n+      <enum name=\"recvip\">\n+        <para>R/O Get the source IP address of the peer.</para>\n+      </enum>\n+      <enum name=\"recvport\">\n+        <para>R/O Get the source port of the peer.</para>\n+      </enum>\n+      <enum name=\"from\">\n+        <para>R/O Get the URI from the From: header.</para>\n+      </enum>\n+      <enum name=\"uri\">\n+        <para>R/O Get the URI from the Contact: header.</para>\n+      </enum>\n+      <enum name=\"ruri\">\n+        <para>R/O Get the Request-URI from the INVITE header.</para>\n+      </enum>\n+      <enum name=\"useragent\">\n+        <para>R/O Get the useragent.</para>\n+      </enum>\n+      <enum name=\"peername\">\n+        <para>R/O Get the name of the peer.</para>\n+      </enum>\n+      <enum name=\"t38passthrough\">\n+        <para>\n+          R/O\n+          <literal>1</literal>\n+          if T38 is offered or enabled in this channel,\n+\t\t\totherwise\n+          <literal>0</literal>\n+        </para>\n+      </enum>\n+      <enum name=\"rtpqos\">\n+        <para>R/O Get QOS information about the RTP stream</para>\n+        <para>This option takes two additional arguments:</para>\n+        <para>Argument 1:</para>\n+        <para>\n+          <literal>audio</literal>\n+          Get data about the audio stream\n+        </para>\n+        <para>\n+          <literal>video</literal>\n+          Get data about the video stream\n+        </para>\n+        <para>\n+          <literal>text</literal>\n+          Get data about the text stream\n+        </para>\n+        <para>Argument 2:</para>\n+        <para>\n+          <literal>local_ssrc</literal>\n+          Local SSRC (stream ID)\n+        </para>\n+        <para>\n+          <literal>local_lostpackets</literal>\n+          Local lost packets\n+        </para>\n+        <para>\n+          <literal>local_jitter</literal>\n+          Local calculated jitter\n+        </para>\n+        <para>\n+          <literal>local_maxjitter</literal>\n+          Local calculated jitter (maximum)\n+        </para>\n+        <para>\n+          <literal>local_minjitter</literal>\n+          Local calculated jitter (minimum)\n+        </para>\n+        <para>\n+          <literal>local_normdevjitter</literal>\n+          Local calculated jitter (normal deviation)\n+        </para>\n+        <para>\n+          <literal>local_stdevjitter</literal>\n+          Local calculated jitter (standard deviation)\n+        </para>\n+        <para>\n+          <literal>local_count</literal>\n+          Number of received packets\n+        </para>\n+        <para>\n+          <literal>remote_ssrc</literal>\n+          Remote SSRC (stream ID)\n+        </para>\n+        <para>\n+          <literal>remote_lostpackets</literal>\n+          Remote lost packets\n+        </para>\n+        <para>\n+          <literal>remote_jitter</literal>\n+          Remote reported jitter\n+        </para>\n+        <para>\n+          <literal>remote_maxjitter</literal>\n+          Remote calculated jitter (maximum)\n+        </para>\n+        <para>\n+          <literal>remote_minjitter</literal>\n+          Remote calculated jitter (minimum)\n+        </para>\n+        <para>\n+          <literal>remote_normdevjitter</literal>\n+          Remote calculated jitter (normal deviation)\n+        </para>\n+        <para>\n+          <literal>remote_stdevjitter</literal>\n+          Remote calculated jitter (standard deviation)\n+        </para>\n+        <para>\n+          <literal>remote_count</literal>\n+          Number of transmitted packets\n+        </para>\n+        <para>\n+          <literal>rtt</literal>\n+          Round trip time\n+        </para>\n+        <para>\n+          <literal>maxrtt</literal>\n+          Round trip time (maximum)\n+        </para>\n+        <para>\n+          <literal>minrtt</literal>\n+          Round trip time (minimum)\n+        </para>\n+        <para>\n+          <literal>normdevrtt</literal>\n+          Round trip time (normal deviation)\n+        </para>\n+        <para>\n+          <literal>stdevrtt</literal>\n+          Round trip time (standard deviation)\n+        </para>\n+        <para>\n+          <literal>all</literal>\n+          All statistics (in a form suited to logging,\n+\t\t\tbut not for parsing)\n+        </para>\n+      </enum>\n+      <enum name=\"rtpdest\">\n+        <para>R/O Get remote RTP destination information.</para>\n+        <para>This option takes one additional argument:</para>\n+        <para>Argument 1:</para>\n+        <para>\n+          <literal>audio</literal>\n+          Get audio destination\n+        </para>\n+        <para>\n+          <literal>video</literal>\n+          Get video destination\n+        </para>\n+        <para>\n+          <literal>text</literal>\n+          Get text destination\n+        </para>\n+        <para>\n+          Defaults to\n+          <literal>audio</literal>\n+          if unspecified.\n+        </para>\n+      </enum>\n+      <enum name=\"rtpsource\">\n+        <para>R/O Get source RTP destination information.</para>\n+        <para>This option takes one additional argument:</para>\n+        <para>Argument 1:</para>\n+        <para>\n+          <literal>audio</literal>\n+          Get audio destination\n+        </para>\n+        <para>\n+          <literal>video</literal>\n+          Get video destination\n+        </para>\n+        <para>\n+          <literal>text</literal>\n+          Get text destination\n+        </para>\n+        <para>\n+          Defaults to\n+          <literal>audio</literal>\n+          if unspecified.\n+        </para>\n+      </enum>\n+    </enumlist>\n+  </info>\n+  <module language=\"en_US\" name=\"security_events\">\n+    <support_level>extended</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"utils\">\n+    <support_level>extended</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"reqresp_parser\">\n+    <support_level>extended</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"config_parser\">\n+    <support_level>extended</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"route\">\n     <support_level>extended</support_level>\n   </module>\n   <module language=\"en_US\" name=\"chan_iax2\">\n     <use type=\"module\">res_crypto</use>\n     <use type=\"external\">crypto</use>\n     <support_level>core</support_level>\n   </module>\n@@ -2225,29 +1687,93 @@\n     <syntax>\n       <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n     </syntax>\n     <description>\n       <para>Show IAX registrations.</para>\n     </description>\n   </manager>\n-  <module language=\"en_US\" name=\"chan_nbs\">\n-    <depend>nbs</depend>\n+  <module language=\"en_US\" name=\"sig_pri\">\n+    <support_level>core</support_level>\n+  </module>\n+  <managerEvent language=\"en_US\" name=\"MCID\">\n+    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n+      <synopsis>Published when a malicious call ID request arrives.</synopsis>\n+      <syntax>\n+        <channel_snapshot/>\n+        <parameter name=\"MCallerIDNumValid\"/>\n+        <parameter name=\"MCallerIDNum\"/>\n+        <parameter name=\"MCallerIDton\"/>\n+        <parameter name=\"MCallerIDNumPlan\"/>\n+        <parameter name=\"MCallerIDNumPres\"/>\n+        <parameter name=\"MCallerIDNameValid\"/>\n+        <parameter name=\"MCallerIDName\"/>\n+        <parameter name=\"MCallerIDNameCharSet\"/>\n+        <parameter name=\"MCallerIDNamePres\"/>\n+        <parameter name=\"MCallerIDSubaddr\"/>\n+        <parameter name=\"MCallerIDSubaddrType\"/>\n+        <parameter name=\"MCallerIDSubaddrOdd\"/>\n+        <parameter name=\"MCallerIDPres\"/>\n+        <parameter name=\"MConnectedIDNumValid\"/>\n+        <parameter name=\"MConnectedIDNum\"/>\n+        <parameter name=\"MConnectedIDton\"/>\n+        <parameter name=\"MConnectedIDNumPlan\"/>\n+        <parameter name=\"MConnectedIDNumPres\"/>\n+        <parameter name=\"MConnectedIDNameValid\"/>\n+        <parameter name=\"MConnectedIDName\"/>\n+        <parameter name=\"MConnectedIDNameCharSet\"/>\n+        <parameter name=\"MConnectedIDNamePres\"/>\n+        <parameter name=\"MConnectedIDSubaddr\"/>\n+        <parameter name=\"MConnectedIDSubaddrType\"/>\n+        <parameter name=\"MConnectedIDSubaddrOdd\"/>\n+        <parameter name=\"MConnectedIDPres\"/>\n+      </syntax>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <module language=\"en_US\" name=\"ie\">\n+    <support_level>extended</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"portinfo\">\n+    <support_level>extended</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"isdn_msg_parser\">\n+    <support_level>extended</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"isdn_lib\">\n+    <support_level>extended</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"chan_oss\">\n+    <depend>oss</depend>\n     <support_level>deprecated</support_level>\n     <deprecated_in>16</deprecated_in>\n     <removed_in>19</removed_in>\n   </module>\n-  <module language=\"en_US\" name=\"console_board\">\n-    <support_level>extended</support_level>\n-  </module>\n   <module language=\"en_US\" name=\"chan_phone\">\n     <depend>ixjuser</depend>\n     <support_level>deprecated</support_level>\n     <deprecated_in>16</deprecated_in>\n     <removed_in>19</removed_in>\n   </module>\n+  <module language=\"en_US\" name=\"chan_bridge_media\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"bridge_native_dahdi\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"chan_nbs\">\n+    <depend>nbs</depend>\n+    <support_level>deprecated</support_level>\n+    <deprecated_in>16</deprecated_in>\n+    <removed_in>19</removed_in>\n+  </module>\n+  <module language=\"en_US\" name=\"console_board\">\n+    <support_level>extended</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"sig_ss7\">\n+    <support_level>core</support_level>\n+  </module>\n   <module language=\"en_US\" name=\"chan_skinny\">\n     <support_level>extended</support_level>\n     <deprecated_in>19</deprecated_in>\n     <removed_in>21</removed_in>\n   </module>\n   <manager name=\"SKINNYdevices\" language=\"en_US\">\n     <synopsis>List SKINNY devices (text format).</synopsis>\n@@ -2291,35 +1817,512 @@\n         <para>The line name you want to check.</para>\n       </parameter>\n     </syntax>\n     <description>\n       <para>Show one SKINNY line with details on current status.</para>\n     </description>\n   </manager>\n-  <module language=\"en_US\" name=\"chan_oss\">\n-    <depend>oss</depend>\n-    <support_level>deprecated</support_level>\n-    <deprecated_in>16</deprecated_in>\n-    <removed_in>19</removed_in>\n+  <module language=\"en_US\" name=\"chan_dahdi\">\n+    <depend>dahdi</depend>\n+    <depend>tonezone</depend>\n+    <use type=\"module\">res_smdi</use>\n+    <use type=\"external\">pri</use>\n+    <use type=\"external\">ss7</use>\n+    <use type=\"external\">openr2</use>\n+    <support_level>core</support_level>\n   </module>\n+  <application name=\"DAHDISendKeypadFacility\" language=\"en_US\">\n+    <synopsis>Send digits out of band over a PRI.</synopsis>\n+    <syntax>\n+      <parameter name=\"digits\" required=\"true\"/>\n+    </syntax>\n+    <description>\n+      <para>This application will send the given string of digits in a Keypad\n+\t\t\tFacility IE over the current channel.</para>\n+    </description>\n+  </application>\n+  <application name=\"DAHDISendCallreroutingFacility\" language=\"en_US\">\n+    <synopsis>Send an ISDN call rerouting/deflection facility message.</synopsis>\n+    <syntax argsep=\",\">\n+      <parameter name=\"destination\" required=\"true\">\n+        <para>Destination number.</para>\n+      </parameter>\n+      <parameter name=\"original\">\n+        <para>Original called number.</para>\n+      </parameter>\n+      <parameter name=\"reason\">\n+        <para>\n+          Diversion reason, if not specified defaults to\n+          <literal>unknown</literal>\n+        </para>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>This application will send an ISDN switch specific call\n+\t\t\trerouting/deflection facility message over the current channel.\n+\t\t\tSupported switches depend upon the version of libpri in use.</para>\n+    </description>\n+  </application>\n+  <application name=\"DAHDIAcceptR2Call\" language=\"en_US\">\n+    <synopsis>Accept an R2 call if its not already accepted (you still need to answer it)</synopsis>\n+    <syntax>\n+      <parameter name=\"charge\" required=\"true\">\n+        <para>Yes or No.</para>\n+        <para>Whether you want to accept the call with charge or without charge.</para>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>This application will Accept the R2 call either with charge or no charge.</para>\n+    </description>\n+  </application>\n+  <function name=\"POLARITY\" language=\"en_US\">\n+    <synopsis>Set or get the polarity of a DAHDI channel.</synopsis>\n+    <syntax/>\n+    <description>\n+      <para>The POLARITY function can be used to set the polarity of a DAHDI channel.</para>\n+      <para>Applies only to FXS channels (using FXO signalling) with supporting hardware.</para>\n+      <para>The polarity can be set to the following numeric or named values:</para>\n+      <enumlist>\n+        <enum name=\"0\"/>\n+        <enum name=\"idle\"/>\n+        <enum name=\"1\"/>\n+        <enum name=\"reverse\"/>\n+      </enumlist>\n+      <para>However, when read, the function will always return 0 or 1.</para>\n+      <example title=\"Set idle polarity\">same =&gt; n,Set(POLARITY()=0)</example>\n+      <example title=\"Set reverse polarity\">same =&gt; n,NoOp(Current Polarity: ${POLARITY()})\n+\t\t\tsame =&gt; n,Set(POLARITY()=reverse)\n+\t\t\tsame =&gt; n,NoOp(New Polarity: ${POLARITY()})</example>\n+      <example title=\"Reverse the polarity from whatever it is currently\">same =&gt; n,Set(POLARITY()=${IF($[ &quot;${POLARITY()}&quot; = &quot;1&quot; ]?0:1)})</example>\n+    </description>\n+  </function>\n+  <info name=\"CHANNEL\" language=\"en_US\" tech=\"DAHDI\">\n+    <enumlist>\n+      <enum name=\"dahdi_channel\">\n+        <para>R/O DAHDI channel related to this channel.</para>\n+      </enum>\n+      <enum name=\"dahdi_span\">\n+        <para>R/O DAHDI span related to this channel.</para>\n+      </enum>\n+      <enum name=\"dahdi_group\">\n+        <para>R/O DAHDI logical group related to this channel.</para>\n+      </enum>\n+      <enum name=\"dahdi_type\">\n+        <para>R/O DAHDI channel type, one of:</para>\n+        <enumlist>\n+          <enum name=\"analog\"/>\n+          <enum name=\"mfc/r2\"/>\n+          <enum name=\"pri\"/>\n+          <enum name=\"pseudo\"/>\n+          <enum name=\"ss7\"/>\n+        </enumlist>\n+      </enum>\n+      <enum name=\"keypad_digits\">\n+        <para>R/O PRI Keypad digits that came in with the SETUP message.</para>\n+      </enum>\n+      <enum name=\"reversecharge\">\n+        <para>R/O PRI Reverse Charging Indication, one of:</para>\n+        <enumlist>\n+          <enum name=\"-1\">\n+            <para>None</para>\n+          </enum>\n+          <enum name=\" 1\">\n+            <para>Reverse Charging Requested</para>\n+          </enum>\n+        </enumlist>\n+      </enum>\n+      <enum name=\"no_media_path\">\n+        <para>R/O PRI Nonzero if the channel has no B channel.\n+\t\t\t\tThe channel is either on hold or a call waiting call.</para>\n+      </enum>\n+      <enum name=\"buffers\">\n+        <para>W/O Change the channel's buffer policy (for the current call only)</para>\n+        <para>This option takes two arguments:</para>\n+        <para>Number of buffers,</para>\n+        <para>Buffer policy being one of:</para>\n+        <para>\n+          <literal>full</literal>\n+        </para>\n+        <para>\n+          <literal>immediate</literal>\n+        </para>\n+        <para>\n+          <literal>half</literal>\n+        </para>\n+      </enum>\n+      <enum name=\"echocan_mode\">\n+        <para>W/O Change the configuration of the active echo\n+\t\t\t\tcanceller on the channel (if any), for the current call\n+\t\t\t\tonly.</para>\n+        <para>Possible values are:</para>\n+        <para>\n+          <literal>on</literal>\n+          Normal mode (the echo canceller is actually reinitialized)\n+        </para>\n+        <para>\n+          <literal>off</literal>\n+          Disabled\n+        </para>\n+        <para>\n+          <literal>fax</literal>\n+          FAX/data mode (NLP disabled if possible, otherwise\n+\t\t\t\t\tcompletely disabled)\n+        </para>\n+        <para>\n+          <literal>voice</literal>\n+          Voice mode (returns from FAX mode, reverting the changes that were made)\n+        </para>\n+      </enum>\n+    </enumlist>\n+  </info>\n+  <info name=\"Dial_Resource\" language=\"en_US\" tech=\"DAHDI\">\n+    <para>DAHDI allows several modifiers to be specified as part of the resource.</para>\n+    <para>The general syntax is :</para>\n+    <para>\n+      <literal>Dial(DAHDI/pseudo[/extension])</literal>\n+    </para>\n+    <para>\n+      <literal>Dial(DAHDI/&lt;channel#&gt;[c|r&lt;cadence#&gt;|d][/extension])</literal>\n+    </para>\n+    <para>\n+      <literal>Dial(DAHDI/(g|G|r|R)&lt;group#(0-63)&gt;[c|r&lt;cadence#&gt;|d][/extension])</literal>\n+    </para>\n+    <para>The following modifiers may be used before the channel number:</para>\n+    <enumlist>\n+      <enum name=\"g\">\n+        <para>Search forward, dialing on first available channel in group (lowest to highest).</para>\n+      </enum>\n+      <enum name=\"G\">\n+        <para>Search backward, dialing on first available channel in group (highest to lowest).</para>\n+      </enum>\n+      <enum name=\"r\">\n+        <para>Round robin search forward, picking up from where last left off (lowest to highest).</para>\n+      </enum>\n+      <enum name=\"R\">\n+        <para>Round robin search backward, picking up from where last left off (highest to lowest).</para>\n+      </enum>\n+    </enumlist>\n+    <para>The following modifiers may be used after the channel number:</para>\n+    <enumlist>\n+      <enum name=\"c\">\n+        <para>\n+          Wait for DTMF digit\n+          <literal>#</literal>\n+          before providing answer supervision.\n+        </para>\n+        <para>This can be useful on outbound calls via FXO ports, as otherwise\n+\t\t\tthey would indicate answer immediately.</para>\n+      </enum>\n+      <enum name=\"d\">\n+        <para>Force bearer capability for ISDN/SS7 call to digital.</para>\n+      </enum>\n+      <enum name=\"i\">\n+        <para>ISDN span channel restriction.</para>\n+        <para>Used by CC to ensure that the CC recall goes out the same span.\n+\t\t\tAlso to make ISDN channel names dialable when the sequence number\n+\t\t\tis stripped off.  (Used by DTMF attended transfer feature.)</para>\n+      </enum>\n+      <enum name=\"r\">\n+        <para>Specifies the distinctive ring cadence number to use immediately after\n+\t\t\tspecifying this option. There are 4 default built-in cadences, and up to 24\n+\t\t\ttotal cadences may be configured.</para>\n+      </enum>\n+    </enumlist>\n+    <example title=\"Dial 555-1212 on first available channel in group 1, searching from highest to lowest\">same =&gt; n,Dial(DAHDI/g1/5551212)</example>\n+    <example title=\"Ringing FXS channel 4 with ring cadence 2\">same =&gt; n,Dial(DAHDI/4r2)</example>\n+    <example title=\"Dial 555-1212 on channel 3 and require answer confirmation\">same =&gt; n,Dial(DAHDI/3c/5551212)</example>\n+  </info>\n+  <manager name=\"DAHDITransfer\" language=\"en_US\">\n+    <synopsis>Transfer DAHDI Channel.</synopsis>\n+    <syntax>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      <parameter name=\"DAHDIChannel\" required=\"true\">\n+        <para>DAHDI channel number to transfer.</para>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>Simulate a flash hook event by the user connected to the channel.</para>\n+      <note>\n+        <para>Valid only for analog channels.</para>\n+      </note>\n+    </description>\n+  </manager>\n+  <manager name=\"DAHDIHangup\" language=\"en_US\">\n+    <synopsis>Hangup DAHDI Channel.</synopsis>\n+    <syntax>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      <parameter name=\"DAHDIChannel\" required=\"true\">\n+        <para>DAHDI channel number to hangup.</para>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>Simulate an on-hook event by the user connected to the channel.</para>\n+      <note>\n+        <para>Valid only for analog channels.</para>\n+      </note>\n+    </description>\n+  </manager>\n+  <manager name=\"DAHDIDialOffhook\" language=\"en_US\">\n+    <synopsis>Dial over DAHDI channel while offhook.</synopsis>\n+    <syntax>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      <parameter name=\"DAHDIChannel\" required=\"true\">\n+        <para>DAHDI channel number to dial digits.</para>\n+      </parameter>\n+      <parameter name=\"Number\" required=\"true\">\n+        <para>Digits to dial.</para>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>Generate DTMF control frames to the bridged peer.</para>\n+    </description>\n+  </manager>\n+  <manager name=\"DAHDIDNDon\" language=\"en_US\">\n+    <synopsis>Toggle DAHDI channel Do Not Disturb status ON.</synopsis>\n+    <syntax>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      <parameter name=\"DAHDIChannel\" required=\"true\">\n+        <para>DAHDI channel number to set DND on.</para>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>\n+        Equivalent to the CLI command &quot;dahdi set dnd\n+        <variable>channel</variable>\n+        on&quot;.\n+      </para>\n+      <note>\n+        <para>Feature only supported by analog channels.</para>\n+      </note>\n+    </description>\n+  </manager>\n+  <manager name=\"DAHDIDNDoff\" language=\"en_US\">\n+    <synopsis>Toggle DAHDI channel Do Not Disturb status OFF.</synopsis>\n+    <syntax>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      <parameter name=\"DAHDIChannel\" required=\"true\">\n+        <para>DAHDI channel number to set DND off.</para>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>\n+        Equivalent to the CLI command &quot;dahdi set dnd\n+        <variable>channel</variable>\n+        off&quot;.\n+      </para>\n+      <note>\n+        <para>Feature only supported by analog channels.</para>\n+      </note>\n+    </description>\n+  </manager>\n+  <manager name=\"DAHDIShowChannels\" language=\"en_US\">\n+    <synopsis>Show status of DAHDI channels.</synopsis>\n+    <syntax>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      <parameter name=\"DAHDIChannel\">\n+        <para>Specify the specific channel number to show.  Show all channels if zero or not present.</para>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>Similar to the CLI command &quot;dahdi show channels&quot;.</para>\n+    </description>\n+  </manager>\n+  <manager name=\"DAHDIRestart\" language=\"en_US\">\n+    <synopsis>Fully Restart DAHDI channels (terminates calls).</synopsis>\n+    <syntax>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+    </syntax>\n+    <description>\n+      <para>Equivalent to the CLI command &quot;dahdi restart&quot;.</para>\n+    </description>\n+  </manager>\n+  <manager name=\"PRIShowSpans\" language=\"en_US\">\n+    <synopsis>Show status of PRI spans.</synopsis>\n+    <syntax>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      <parameter name=\"Span\">\n+        <para>Specify the specific span to show.  Show all spans if zero or not present.</para>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>Similar to the CLI command &quot;pri show spans&quot;.</para>\n+    </description>\n+  </manager>\n+  <manager name=\"PRIDebugSet\" language=\"en_US\">\n+    <synopsis>Set PRI debug levels for a span</synopsis>\n+    <syntax>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      <parameter name=\"Span\" required=\"true\">\n+        <para>Which span to affect.</para>\n+      </parameter>\n+      <parameter name=\"Level\" required=\"true\">\n+        <para>What debug level to set. May be a numerical value or a text value from the list below</para>\n+        <enumlist>\n+          <enum name=\"off\"/>\n+          <enum name=\"on\"/>\n+          <enum name=\"hex\"/>\n+          <enum name=\"intense\"/>\n+        </enumlist>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>Equivalent to the CLI command &quot;pri set debug &lt;level&gt; span &lt;span&gt;&quot;.</para>\n+    </description>\n+  </manager>\n+  <manager name=\"PRIDebugFileSet\" language=\"en_US\">\n+    <synopsis>Set the file used for PRI debug message output</synopsis>\n+    <syntax>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      <parameter name=\"File\" required=\"true\">\n+        <para>Path of file to write debug output.</para>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>Equivalent to the CLI command &quot;pri set debug file &lt;output-file&gt;&quot;</para>\n+    </description>\n+  </manager>\n+  <manager name=\"PRIDebugFileUnset\" language=\"en_US\">\n+    <synopsis>Disables file output for PRI debug messages</synopsis>\n+    <syntax>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+    </syntax>\n+  </manager>\n+  <managerEvent language=\"en_US\" name=\"AlarmClear\">\n+    <managerEventInstance class=\"EVENT_FLAG_SYSTEM\">\n+      <synopsis>Raised when an alarm is cleared on a DAHDI channel.</synopsis>\n+      <syntax>\n+        <parameter name=\"DAHDIChannel\">\n+          <para>The DAHDI channel on which the alarm was cleared.</para>\n+          <note>\n+            <para>This is not an Asterisk channel identifier.</para>\n+          </note>\n+        </parameter>\n+      </syntax>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <managerEvent language=\"en_US\" name=\"SpanAlarmClear\">\n+    <managerEventInstance class=\"EVENT_FLAG_SYSTEM\">\n+      <synopsis>Raised when an alarm is cleared on a DAHDI span.</synopsis>\n+      <syntax>\n+        <parameter name=\"Span\">\n+          <para>The span on which the alarm was cleared.</para>\n+        </parameter>\n+      </syntax>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <managerEvent language=\"en_US\" name=\"DNDState\">\n+    <managerEventInstance class=\"EVENT_FLAG_SYSTEM\">\n+      <synopsis>Raised when the Do Not Disturb state is changed on a DAHDI channel.</synopsis>\n+      <syntax>\n+        <parameter name=\"DAHDIChannel\">\n+          <para>The DAHDI channel on which DND status changed.</para>\n+          <note>\n+            <para>This is not an Asterisk channel identifier.</para>\n+          </note>\n+        </parameter>\n+        <parameter name=\"Status\">\n+          <enumlist>\n+            <enum name=\"enabled\"/>\n+            <enum name=\"disabled\"/>\n+          </enumlist>\n+        </parameter>\n+      </syntax>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <managerEvent language=\"en_US\" name=\"Alarm\">\n+    <managerEventInstance class=\"EVENT_FLAG_SYSTEM\">\n+      <synopsis>Raised when an alarm is set on a DAHDI channel.</synopsis>\n+      <syntax>\n+        <parameter name=\"DAHDIChannel\">\n+          <para>The channel on which the alarm occurred.</para>\n+          <note>\n+            <para>This is not an Asterisk channel identifier.</para>\n+          </note>\n+        </parameter>\n+        <parameter name=\"Alarm\">\n+          <para>A textual description of the alarm that occurred.</para>\n+        </parameter>\n+      </syntax>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <managerEvent language=\"en_US\" name=\"SpanAlarm\">\n+    <managerEventInstance class=\"EVENT_FLAG_SYSTEM\">\n+      <synopsis>Raised when an alarm is set on a DAHDI span.</synopsis>\n+      <syntax>\n+        <parameter name=\"Span\">\n+          <para>The span on which the alarm occurred.</para>\n+        </parameter>\n+        <parameter name=\"Alarm\">\n+          <para>A textual description of the alarm that occurred.</para>\n+        </parameter>\n+      </syntax>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <managerEvent language=\"en_US\" name=\"DAHDIChannel\">\n+    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n+      <synopsis>Raised when a DAHDI channel is created or an underlying technology is associated with a DAHDI channel.</synopsis>\n+      <syntax>\n+        <channel_snapshot/>\n+        <parameter name=\"DAHDIGroup\">\n+          <para>The DAHDI logical group associated with this channel.</para>\n+        </parameter>\n+        <parameter name=\"DAHDISpan\">\n+          <para>The DAHDI span associated with this channel.</para>\n+        </parameter>\n+        <parameter name=\"DAHDIChannel\">\n+          <para>The DAHDI channel associated with this channel.</para>\n+        </parameter>\n+      </syntax>\n+    </managerEventInstance>\n+  </managerEvent>\n   <module language=\"en_US\" name=\"chan_mgcp\">\n     <support_level>extended</support_level>\n     <deprecated_in>19</deprecated_in>\n     <removed_in>21</removed_in>\n   </module>\n+  <module language=\"en_US\" name=\"chan_vpb.cc\">\n+    <depend>vpb</depend>\n+    <defaultenabled>yes</defaultenabled>\n+    <support_level>deprecated</support_level>\n+    <deprecated_in>16</deprecated_in>\n+    <removed_in>19</removed_in>\n+  </module>\n+  <module language=\"en_US\" name=\"chan_misdn\">\n+    <depend>isdnnet</depend>\n+    <depend>misdn</depend>\n+    <depend>suppserv</depend>\n+    <support_level>deprecated</support_level>\n+    <replacement>chan_dahdi</replacement>\n+    <deprecated_in>16</deprecated_in>\n+    <removed_in>19</removed_in>\n+  </module>\n+  <module language=\"en_US\" name=\"chan_pjsip\">\n+    <depend>pjproject</depend>\n+    <depend>res_pjsip</depend>\n+    <depend>res_pjsip_pubsub</depend>\n+    <depend>res_pjsip_session</depend>\n+    <support_level>core</support_level>\n+  </module>\n   <module language=\"en_US\" name=\"console_video\">\n     <support_level>extended</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"sig_analog\">\n-    <support_level>core</support_level>\n+  <module language=\"en_US\" name=\"vcodecs\">\n+    <support_level>extended</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"chan_console\">\n+    <depend>portaudio</depend>\n+    <support_level>extended</support_level>\n   </module>\n   <module language=\"en_US\" name=\"pbx_lua\">\n     <depend>lua</depend>\n     <support_level>extended</support_level>\n   </module>\n+  <module language=\"en_US\" name=\"pbx_loopback\">\n+    <support_level>core</support_level>\n+  </module>\n   <module language=\"en_US\" name=\"pbx_config\">\n     <support_level>core</support_level>\n   </module>\n   <manager name=\"DialplanExtensionAdd\" language=\"en_US\">\n     <synopsis>Add an extension to the dialplan</synopsis>\n     <syntax>\n       <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n@@ -2364,22 +2367,22 @@\n       </parameter>\n       <parameter name=\"Priority\" required=\"false\">\n         <para>If provided, only remove this priority from the extension instead of all\n \t\t\t\tpriorities in the extension.</para>\n       </parameter>\n     </syntax>\n   </manager>\n-  <module language=\"en_US\" name=\"pbx_loopback\">\n-    <support_level>core</support_level>\n+  <module language=\"en_US\" name=\"pbx_realtime\">\n+    <support_level>extended</support_level>\n   </module>\n   <module language=\"en_US\" name=\"dundi-parser\">\n     <support_level>extended</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"pbx_realtime\">\n-    <support_level>extended</support_level>\n+  <module language=\"en_US\" name=\"pbx_spool\">\n+    <support_level>core</support_level>\n   </module>\n   <module language=\"en_US\" name=\"pbx_dundi\">\n     <depend>zlib</depend>\n     <use type=\"module\">res_crypto</use>\n     <use type=\"external\">crypto</use>\n     <support_level>extended</support_level>\n   </module>\n@@ -2485,924 +2488,4278 @@\n     <description>\n       <para>Execute the named subroutine, defined in AEL, from another dialplan\n \t\t\tlanguage, such as extensions.conf, Realtime extensions, or Lua.</para>\n       <para>The purpose of this application is to provide a sane entry point into\n \t\t\tAEL subroutines, the implementation of which may change from time to time.</para>\n     </description>\n   </application>\n-  <module language=\"en_US\" name=\"pbx_spool\">\n+  <module language=\"en_US\" name=\"app_bridgeaddchan\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"app_skel\">\n-    <defaultenabled>no</defaultenabled>\n+  <application name=\"BridgeAdd\" language=\"en_US\">\n+    <synopsis>Join a bridge that contains the specified channel.</synopsis>\n+    <syntax>\n+      <parameter name=\"name\">\n+        <para>Name of the channel in an existing bridge</para>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>This application places the incoming channel into\n+\t\t\tthe bridge containing the specified channel. The specified\n+\t\t\tchannel only needs to be the prefix of a full channel name\n+\t\t\tIE. 'SIP/cisco0001'.</para>\n+    </description>\n+  </application>\n+  <module language=\"en_US\" name=\"app_test\">\n+    <support_level>extended</support_level>\n+  </module>\n+  <application name=\"TestServer\" language=\"en_US\">\n+    <synopsis>Execute Interface Test Server.</synopsis>\n+    <syntax/>\n+    <description>\n+      <para>\n+        Perform test server function and write call report. Results stored in\n+        <filename>/var/log/asterisk/testreports/&lt;testid&gt;-server.txt</filename>\n+      </para>\n+    </description>\n+    <see-also>\n+      <ref type=\"application\">TestClient</ref>\n+    </see-also>\n+  </application>\n+  <application name=\"TestClient\" language=\"en_US\">\n+    <synopsis>Execute Interface Test Client.</synopsis>\n+    <syntax>\n+      <parameter name=\"testid\" required=\"true\">\n+        <para>An ID to identify this test.</para>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>\n+        Executes test client with given\n+        <replaceable>testid</replaceable>\n+        . Results stored in\n+        <filename>/var/log/asterisk/testreports/&lt;testid&gt;-client.txt</filename>\n+      </para>\n+    </description>\n+    <see-also>\n+      <ref type=\"application\">TestServer</ref>\n+    </see-also>\n+  </application>\n+  <module language=\"en_US\" name=\"app_stream_echo\">\n     <support_level>core</support_level>\n   </module>\n-  <application name=\"SkelGuessNumber\" language=\"en_US\">\n-    <synopsis>An example number guessing game</synopsis>\n+  <application name=\"StreamEcho\" language=\"en_US\">\n+    <synopsis>Echo media, up to 'N' streams of a type, and DTMF back to the calling party</synopsis>\n     <syntax>\n-      <parameter name=\"level\" required=\"true\"/>\n-      <parameter name=\"options\">\n-        <optionlist>\n-          <option name=\"c\">\n-            <para>The computer should cheat</para>\n-          </option>\n-          <option name=\"n\">\n-            <para>How many games to play before hanging up</para>\n-          </option>\n-        </optionlist>\n+      <parameter name=\"num\" required=\"false\">\n+        <para>The number of streams of a type to echo back. If '0' is specified then\n+\t\t\tall streams of a type are removed.</para>\n+      </parameter>\n+      <parameter name=\"type\" required=\"false\">\n+        <para>The media type of the stream(s) to add or remove (in the case of &quot;num&quot;\n+\t\t\tbeing '0'). This can be set to either &quot;audio&quot; or &quot;video&quot; (default). If &quot;num&quot;\n+\t\t\tis empty (i.e. not specified) then this parameter is ignored.</para>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>This simple number guessing application is a template to build other applications\n-\t\tfrom. It shows you the basic structure to create your own Asterisk applications.</para>\n+      <para>If a &quot;num&quot; (the number of streams) is not given then this simply echos\n+\t\t\tback any media or DTMF frames (note, however if '#' is detected then the\n+\t\t\tapplication exits) read from the calling channel back to itself. This means\n+\t\t\tfor any relevant frame read from a particular stream it is written back out\n+\t\t\tto the associated write stream in a one to one fashion.</para>\n+      <para>However if a &quot;num&quot; is specified, and if the calling channel allows it\n+\t\t\t(a new offer is made requesting the allowance of additional streams) then any\n+\t\t\tany media received, like before, is echoed back onto each stream. However, in\n+\t\t\tthis case a relevant frame received on a stream of the given &quot;type&quot; is also\n+\t\t\techoed back out to the other streams of that same type. It should be noted that\n+\t\t\twhen operating in this mode only the first stream found of the given &quot;type&quot; is\n+\t\t\tallowed from the original offer. And this first stream found is also the only\n+\t\t\tstream of that &quot;type&quot; granted read (send/receive) capabilities in the new offer\n+\t\t\twhereas the additional ones are set to receive only.</para>\n+      <note>\n+        <para>This does not echo CONTROL, MODEM, or NULL frames.</para>\n+      </note>\n     </description>\n   </application>\n-  <configInfo name=\"app_skel\" language=\"en_US\">\n-    <configFile name=\"app_skel.conf\">\n-      <configObject name=\"globals\">\n-        <synopsis>Options that apply globally to app_skel</synopsis>\n-        <configOption name=\"games\">\n-          <synopsis>The number of games a single execution of SkelGuessNumber will play</synopsis>\n-        </configOption>\n-        <configOption name=\"cheat\">\n-          <synopsis>Should the computer cheat?</synopsis>\n-          <description>\n-            <para>If enabled, the computer will ignore winning guesses.</para>\n-          </description>\n-        </configOption>\n-      </configObject>\n-      <configObject name=\"sounds\">\n-        <synopsis>Prompts for SkelGuessNumber to play</synopsis>\n-        <configOption name=\"prompt\" default=\"please-enter-your&amp;number&amp;queue-less-than\">\n-          <synopsis>A prompt directing the user to enter a number less than the max number</synopsis>\n-        </configOption>\n-        <configOption name=\"wrong_guess\" default=\"vm-pls-try-again\">\n-          <synopsis>The sound file to play when a wrong guess is made</synopsis>\n-        </configOption>\n-        <configOption name=\"right_guess\" default=\"auth-thankyou\">\n-          <synopsis>The sound file to play when a correct guess is made</synopsis>\n-        </configOption>\n-        <configOption name=\"too_low\">\n-          <synopsis>The sound file to play when a guess is too low</synopsis>\n-        </configOption>\n-        <configOption name=\"too_high\">\n-          <synopsis>The sound file to play when a guess is too high</synopsis>\n-        </configOption>\n-        <configOption name=\"lose\" default=\"vm-goodbye\">\n-          <synopsis>The sound file to play when a player loses</synopsis>\n-        </configOption>\n-      </configObject>\n-      <configObject name=\"level\">\n-        <synopsis>Defined levels for the SkelGuessNumber game</synopsis>\n-        <configOption name=\"max_number\">\n-          <synopsis>The maximum in the range of numbers to guess (1 is the implied minimum)</synopsis>\n-        </configOption>\n-        <configOption name=\"max_guesses\">\n-          <synopsis>The maximum number of guesses before a game is considered lost</synopsis>\n-        </configOption>\n-      </configObject>\n-    </configFile>\n-  </configInfo>\n-  <module language=\"en_US\" name=\"app_voicemail_imapstorage\">\n-    <depend>openssl</depend>\n-    <depend>imap_tk</depend>\n-    <use type=\"module\">res_adsi</use>\n-    <use type=\"module\">res_smdi</use>\n-    <defaultenabled>yes</defaultenabled>\n+  <module language=\"en_US\" name=\"app_dial\">\n     <support_level>core</support_level>\n   </module>\n-  <application name=\"VoiceMail\" language=\"en_US\">\n-    <synopsis>Leave a Voicemail message.</synopsis>\n+  <application name=\"Dial\" language=\"en_US\">\n+    <synopsis>Attempt to connect to another device or endpoint and bridge the call.</synopsis>\n     <syntax>\n-      <parameter name=\"mailboxs\" argsep=\"&amp;\" required=\"true\">\n-        <argument name=\"mailbox1\" argsep=\"@\" required=\"true\">\n-          <argument name=\"mailbox\" required=\"true\"/>\n-          <argument name=\"context\"/>\n+      <parameter name=\"Technology/Resource\" required=\"false\" argsep=\"&amp;\">\n+        <argument name=\"Technology/Resource\" required=\"true\">\n+          <para>\n+            Specification of the device(s) to dial.  These must be in the format of\n+            <literal>Technology/Resource</literal>\n+            , where\n+            <replaceable>Technology</replaceable>\n+            represents a particular channel driver, and\n+            <replaceable>Resource</replaceable>\n+            represents a resource available to that particular channel driver.\n+          </para>\n         </argument>\n-        <argument name=\"mailbox2\" argsep=\"@\" multiple=\"true\">\n-          <argument name=\"mailbox\" required=\"true\"/>\n-          <argument name=\"context\"/>\n+        <argument name=\"Technology2/Resource2\" required=\"false\" multiple=\"true\">\n+          <para>Optional extra devices to dial in parallel</para>\n+          <para>If you need more than one enter them as\n+\t\t\t\t\tTechnology2/Resource2&amp;Technology3/Resource3&amp;.....</para>\n         </argument>\n+        <xi:include xpointer=\"xpointer(/docs/info[@name='Dial_Resource'])\"/>\n       </parameter>\n-      <parameter name=\"options\">\n+      <parameter name=\"timeout\" required=\"false\">\n+        <para>Specifies the number of seconds we attempt to dial the specified devices.</para>\n+        <para>If not specified, this defaults to 136 years.</para>\n+      </parameter>\n+      <parameter name=\"options\" required=\"false\">\n         <optionlist>\n-          <option name=\"b\">\n+          <option name=\"A\" argsep=\":\">\n+            <argument name=\"x\">\n+              <para>The file to play to the called party</para>\n+            </argument>\n+            <argument name=\"y\">\n+              <para>The file to play to the calling party</para>\n+            </argument>\n             <para>\n-              Play the\n-              <literal>busy</literal>\n-              greeting to the calling party.\n+              Play an announcement to the called and/or calling parties, where\n+              <replaceable>x</replaceable>\n+              is the prompt to be played to the called party and\n+              <replaceable>y</replaceable>\n+              is the prompt\n+\t\t\t\t\tto be played to the caller. The files may be different and will be played to each party\n+\t\t\t\t\tsimultaneously.\n+            </para>\n+          </option>\n+          <option name=\"a\">\n+            <para>\n+              Immediately answer the calling channel when the called channel answers in\n+\t\t\t\t\tall cases. Normally, the calling channel is answered when the called channel\n+\t\t\t\t\tanswers, but when options such as\n+              <literal>A()</literal>\n+              and\n+              <literal>M()</literal>\n+              are used, the calling channel is\n+\t\t\t\t\tnot answered until all actions on the called channel (such as playing an\n+\t\t\t\t\tannouncement) are completed.  This option can be used to answer the calling\n+\t\t\t\t\tchannel before doing anything on the called channel. You will rarely need to use\n+\t\t\t\t\tthis option, the default behavior is adequate in most cases.\n+            </para>\n+          </option>\n+          <option name=\"b\" argsep=\"^\">\n+            <para>\n+              Before initiating an outgoing call,\n+              <literal>Gosub</literal>\n+              to the specified\n+\t\t\t\t\tlocation using the newly created channel.  The\n+              <literal>Gosub</literal>\n+              will be\n+\t\t\t\t\texecuted for each destination channel.\n+            </para>\n+            <argument name=\"context\" required=\"false\"/>\n+            <argument name=\"exten\" required=\"false\"/>\n+            <argument name=\"priority\" required=\"true\" hasparams=\"optional\" argsep=\"^\">\n+              <argument name=\"arg1\" multiple=\"true\" required=\"true\"/>\n+              <argument name=\"argN\"/>\n+            </argument>\n+          </option>\n+          <option name=\"B\" argsep=\"^\">\n+            <para>\n+              Before initiating the outgoing call(s),\n+              <literal>Gosub</literal>\n+              to the\n+\t\t\t\t\tspecified location using the current channel.\n+            </para>\n+            <argument name=\"context\" required=\"false\"/>\n+            <argument name=\"exten\" required=\"false\"/>\n+            <argument name=\"priority\" required=\"true\" hasparams=\"optional\" argsep=\"^\">\n+              <argument name=\"arg1\" multiple=\"true\" required=\"true\"/>\n+              <argument name=\"argN\"/>\n+            </argument>\n+          </option>\n+          <option name=\"C\">\n+            <para>Reset the call detail record (CDR) for this call.</para>\n+          </option>\n+          <option name=\"c\">\n+            <para>\n+              If the Dial() application cancels this call, always set\n+              <variable>HANGUPCAUSE</variable>\n+              to 'answered elsewhere'\n             </para>\n           </option>\n           <option name=\"d\">\n-            <argument name=\"c\"/>\n             <para>\n-              Accept digits for a new extension in context\n-              <replaceable>c</replaceable>\n-              ,\n-\t\t\t\t\t\tif played during the greeting. Context defaults to the current context.\n+              Allow the calling user to dial a 1 digit extension while waiting for\n+\t\t\t\t\ta call to be answered. Exit to that extension if it exists in the\n+\t\t\t\t\tcurrent context, or the context defined in the\n+              <variable>EXITCONTEXT</variable>\n+              variable,\n+\t\t\t\t\tif it exists.\n+            </para>\n+            <para>\n+              NOTE: Many SIP and ISDN phones cannot send DTMF digits until the call is\n+\t\t\t\t\tconnected.  If you wish to use this option with these phones, you\n+\t\t\t\t\tcan use the\n+              <literal>Answer</literal>\n+              application before dialing.\n+            </para>\n+          </option>\n+          <option name=\"D\" argsep=\":\">\n+            <argument name=\"called\"/>\n+            <argument name=\"calling\"/>\n+            <argument name=\"progress\"/>\n+            <argument name=\"mfprogress\"/>\n+            <argument name=\"mfwink\"/>\n+            <argument name=\"sfprogress\"/>\n+            <argument name=\"sfwink\"/>\n+            <para>\n+              Send the specified DTMF strings\n+              <emphasis>after</emphasis>\n+              the called\n+\t\t\t\t\tparty has answered, but before the call gets bridged.  The\n+              <replaceable>called</replaceable>\n+              DTMF string is sent to the called party, and the\n+              <replaceable>calling</replaceable>\n+              DTMF string is sent to the calling party.  Both arguments\n+\t\t\t\t\tcan be used alone.  If\n+              <replaceable>progress</replaceable>\n+              is specified, its DTMF is sent\n+\t\t\t\t\tto the called party immediately after receiving a\n+              <literal>PROGRESS</literal>\n+              message.\n+            </para>\n+            <para>\n+              See\n+              <literal>SendDTMF</literal>\n+              for valid digits.\n+            </para>\n+            <para>\n+              If\n+              <replaceable>mfprogress</replaceable>\n+              is specified, its MF is sent\n+\t\t\t\t\tto the called party immediately after receiving a\n+              <literal>PROGRESS</literal>\n+              message.\n+\t\t\t\t\tIf\n+              <replaceable>mfwink</replaceable>\n+              is specified, its MF is sent\n+\t\t\t\t\tto the called party immediately after receiving a\n+              <literal>WINK</literal>\n+              message.\n+            </para>\n+            <para>\n+              See\n+              <literal>SendMF</literal>\n+              for valid digits.\n+            </para>\n+            <para>\n+              If\n+              <replaceable>sfprogress</replaceable>\n+              is specified, its SF is sent\n+\t\t\t\t\tto the called party immediately after receiving a\n+              <literal>PROGRESS</literal>\n+              message.\n+\t\t\t\t\tIf\n+              <replaceable>sfwink</replaceable>\n+              is specified, its SF is sent\n+\t\t\t\t\tto the called party immediately after receiving a\n+              <literal>WINK</literal>\n+              message.\n+            </para>\n+            <para>\n+              See\n+              <literal>SendSF</literal>\n+              for valid digits.\n             </para>\n           </option>\n+          <option name=\"E\">\n+            <para>Enable echoing of sent MF or SF digits back to caller (e.g. &quot;hearpulsing&quot;).\n+\t\t\t\t\tUsed in conjunction with the D option.</para>\n+          </option>\n           <option name=\"e\">\n-            <para>Play greetings as early media -- only answer the channel just\n-\t\t\t\t\t\tbefore accepting the voice message.</para>\n+            <para>\n+              Execute the\n+              <literal>h</literal>\n+              extension for peer after the call ends\n+            </para>\n+          </option>\n+          <option name=\"f\">\n+            <argument name=\"x\" required=\"false\"/>\n+            <para>\n+              If\n+              <replaceable>x</replaceable>\n+              is not provided, force the CallerID sent on a call-forward or\n+\t\t\t\t\tdeflection to the dialplan extension of this\n+              <literal>Dial()</literal>\n+              using a dialplan\n+              <literal>hint</literal>\n+              .\n+\t\t\t\t\tFor example, some PSTNs do not allow CallerID to be set to anything\n+\t\t\t\t\tother than the numbers assigned to you.\n+\t\t\t\t\tIf\n+              <replaceable>x</replaceable>\n+              is provided, force the CallerID sent to\n+              <replaceable>x</replaceable>\n+              .\n+            </para>\n+          </option>\n+          <option name=\"F\" argsep=\"^\">\n+            <argument name=\"context\" required=\"false\"/>\n+            <argument name=\"exten\" required=\"false\"/>\n+            <argument name=\"priority\" required=\"true\"/>\n+            <para>\n+              When the caller hangs up, transfer the\n+              <emphasis>called</emphasis>\n+              party\n+\t\t\t\t\tto the specified destination and\n+              <emphasis>start</emphasis>\n+              execution at that location.\n+            </para>\n+            <para>NOTE: Any channel variables you want the called channel to inherit from the caller channel must be\n+\t\t\t\t\tprefixed with one or two underbars ('_').</para>\n+          </option>\n+          <option name=\"F\">\n+            <para>\n+              When the caller hangs up, transfer the\n+              <emphasis>called</emphasis>\n+              party to the next priority of the current extension\n+\t\t\t\t\tand\n+              <emphasis>start</emphasis>\n+              execution at that location.\n+            </para>\n+            <para>NOTE: Any channel variables you want the called channel to inherit from the caller channel must be\n+\t\t\t\t\tprefixed with one or two underbars ('_').</para>\n+            <para>NOTE: Using this option from a Macro() or GoSub() might not make sense as there would be no return points.</para>\n           </option>\n           <option name=\"g\">\n-            <argument name=\"#\" required=\"true\"/>\n-            <para>Use the specified amount of gain when recording the voicemail\n-\t\t\t\t\t\tmessage. The units are whole-number decibels (dB). Only works on supported\n-\t\t\t\t\t\ttechnologies, which is DAHDI only.</para>\n+            <para>Proceed with dialplan execution at the next priority in the current extension if the\n+\t\t\t\t\tdestination channel hangs up.</para>\n           </option>\n-          <option name=\"s\">\n-            <para>Skip the playback of instructions for leaving a message to the\n-\t\t\t\t\t\tcalling party.</para>\n+          <option name=\"G\" argsep=\"^\">\n+            <argument name=\"context\" required=\"false\"/>\n+            <argument name=\"exten\" required=\"false\"/>\n+            <argument name=\"priority\" required=\"true\"/>\n+            <para>\n+              If the call is answered, transfer the calling party to\n+\t\t\t\t\tthe specified\n+              <replaceable>priority</replaceable>\n+              and the called party to the specified\n+              <replaceable>priority</replaceable>\n+              plus one.\n+            </para>\n+            <para>NOTE: You cannot use any additional action post answer options in conjunction with this option.</para>\n           </option>\n-          <option name=\"S\">\n-            <para>Skip the playback of instructions for leaving a message to the\n-\t\t\t\t\t\tcalling party, but only if a greeting has been recorded by the\n-\t\t\t\t\t\tmailbox user.</para>\n+          <option name=\"h\">\n+            <para>\n+              Allow the called party to hang up by sending the DTMF sequence\n+\t\t\t\t\tdefined for disconnect in\n+              <filename>features.conf</filename>\n+              .\n+            </para>\n           </option>\n-          <option name=\"t\">\n-            <argument name=\"x\" required=\"false\"/>\n-            <para>Play a custom beep tone to the caller instead of the default one.\n-\t\t\t\t\t\tIf this option is used but no file is specified, the beep is suppressed.</para>\n+          <option name=\"H\">\n+            <para>\n+              Allow the calling party to hang up by sending the DTMF sequence\n+\t\t\t\t\tdefined for disconnect in\n+              <filename>features.conf</filename>\n+              .\n+            </para>\n+            <para>\n+              NOTE: Many SIP and ISDN phones cannot send DTMF digits until the call is\n+\t\t\t\t\tconnected.  If you wish to allow DTMF disconnect before the dialed\n+\t\t\t\t\tparty answers with these phones, you can use the\n+              <literal>Answer</literal>\n+              application before dialing.\n+            </para>\n           </option>\n-          <option name=\"u\">\n+          <option name=\"i\">\n+            <para>Asterisk will ignore any forwarding requests it may receive on this dial attempt.</para>\n+          </option>\n+          <option name=\"I\">\n+            <para>Asterisk will ignore any connected line update requests or any redirecting party\n+\t\t\t\t\tupdate requests it may receive on this dial attempt.</para>\n+          </option>\n+          <option name=\"k\">\n             <para>\n-              Play the\n-              <literal>unavailable</literal>\n-              greeting.\n+              Allow the called party to enable parking of the call by sending\n+\t\t\t\t\tthe DTMF sequence defined for call parking in\n+              <filename>features.conf</filename>\n+              .\n             </para>\n           </option>\n-          <option name=\"U\">\n+          <option name=\"K\">\n             <para>\n-              Mark message as\n-              <literal>URGENT</literal>\n+              Allow the calling party to enable parking of the call by sending\n+\t\t\t\t\tthe DTMF sequence defined for call parking in\n+              <filename>features.conf</filename>\n               .\n             </para>\n           </option>\n-          <option name=\"P\">\n+          <option name=\"L\" argsep=\":\">\n+            <argument name=\"x\" required=\"true\">\n+              <para>Maximum call time, in milliseconds</para>\n+            </argument>\n+            <argument name=\"y\">\n+              <para>Warning time, in milliseconds</para>\n+            </argument>\n+            <argument name=\"z\">\n+              <para>Repeat time, in milliseconds</para>\n+            </argument>\n             <para>\n-              Mark message as\n-              <literal>PRIORITY</literal>\n+              Limit the call to\n+              <replaceable>x</replaceable>\n+              milliseconds. Play a warning when\n+              <replaceable>y</replaceable>\n+              milliseconds are\n+\t\t\t\t\tleft. Repeat the warning every\n+              <replaceable>z</replaceable>\n+              milliseconds until time expires.\n+            </para>\n+            <para>This option is affected by the following variables:</para>\n+            <variablelist>\n+              <variable name=\"LIMIT_PLAYAUDIO_CALLER\">\n+                <value name=\"yes\" default=\"true\"/>\n+                <value name=\"no\"/>\n+                <para>If set, this variable causes Asterisk to play the prompts to the caller.</para>\n+              </variable>\n+              <variable name=\"LIMIT_PLAYAUDIO_CALLEE\">\n+                <value name=\"yes\"/>\n+                <value name=\"no\" default=\"true\"/>\n+                <para>If set, this variable causes Asterisk to play the prompts to the callee.</para>\n+              </variable>\n+              <variable name=\"LIMIT_TIMEOUT_FILE\">\n+                <value name=\"filename\"/>\n+                <para>\n+                  If specified,\n+                  <replaceable>filename</replaceable>\n+                  specifies the sound prompt to play when the timeout is reached.\n+\t\t\t\t\t\t\tIf not set, the time remaining will be announced.\n+                </para>\n+              </variable>\n+              <variable name=\"LIMIT_CONNECT_FILE\">\n+                <value name=\"filename\"/>\n+                <para>\n+                  If specified,\n+                  <replaceable>filename</replaceable>\n+                  specifies the sound prompt to play when the call begins.\n+\t\t\t\t\t\t\tIf not set, the time remaining will be announced.\n+                </para>\n+              </variable>\n+              <variable name=\"LIMIT_WARNING_FILE\">\n+                <value name=\"filename\"/>\n+                <para>\n+                  If specified,\n+                  <replaceable>filename</replaceable>\n+                  specifies the sound prompt to play as\n+\t\t\t\t\t\t\ta warning when time\n+                  <replaceable>x</replaceable>\n+                  is reached. If not set, the time remaining will be announced.\n+                </para>\n+              </variable>\n+            </variablelist>\n+          </option>\n+          <option name=\"m\">\n+            <argument name=\"class\" required=\"false\"/>\n+            <para>\n+              Provide hold music to the calling party until a requested\n+\t\t\t\t\tchannel answers. A specific music on hold\n+              <replaceable>class</replaceable>\n+              (as defined in\n+              <filename>musiconhold.conf</filename>\n+              ) can be specified.\n+            </para>\n+          </option>\n+          <option name=\"M\" argsep=\"^\">\n+            <argument name=\"macro\" required=\"true\">\n+              <para>Name of the macro that should be executed.</para>\n+            </argument>\n+            <argument name=\"arg\" multiple=\"true\">\n+              <para>Macro arguments</para>\n+            </argument>\n+            <para>\n+              Execute the specified\n+              <replaceable>macro</replaceable>\n+              for the\n+              <emphasis>called</emphasis>\n+              channel\n+\t\t\t\t\tbefore connecting to the calling channel. Arguments can be specified to the Macro\n+\t\t\t\t\tusing\n+              <literal>^</literal>\n+              as a delimiter. The macro can set the variable\n+              <variable>MACRO_RESULT</variable>\n+              to specify the following actions after the macro is\n+\t\t\t\t\tfinished executing:\n+            </para>\n+            <variablelist>\n+              <variable name=\"MACRO_RESULT\">\n+                <para>If set, this action will be taken after the macro finished executing.</para>\n+                <value name=\"ABORT\">Hangup both legs of the call</value>\n+                <value name=\"CONGESTION\">Behave as if line congestion was encountered</value>\n+                <value name=\"BUSY\">Behave as if a busy signal was encountered</value>\n+                <value name=\"CONTINUE\">Hangup the called party and allow the calling party to continue dialplan execution at the next priority</value>\n+                <value name=\"GOTO:[[&lt;context&gt;^]&lt;exten&gt;^]&lt;priority&gt;\">Transfer the call to the specified destination.</value>\n+              </variable>\n+            </variablelist>\n+            <para>\n+              NOTE: You cannot use any additional action post answer options in conjunction\n+\t\t\t\t\twith this option. Also, pbx services are run on the peer (called) channel,\n+\t\t\t\t\tso you will not be able to set timeouts via the\n+              <literal>TIMEOUT()</literal>\n+              function in this macro.\n+            </para>\n+            <para>\n+              WARNING: Be aware of the limitations that macros have, specifically with regards to use of\n+\t\t\t\t\tthe\n+              <literal>WaitExten</literal>\n+              application. For more information, see the documentation for\n+              <literal>Macro()</literal>\n               .\n             </para>\n+            <para>\n+              NOTE: Macros are deprecated, GoSub should be used instead,\n+\t\t\t\t\tsee the\n+              <literal>U</literal>\n+              option.\n+            </para>\n+          </option>\n+          <option name=\"n\">\n+            <argument name=\"delete\">\n+              <para>\n+                With\n+                <replaceable>delete</replaceable>\n+                either not specified or set to\n+                <literal>0</literal>\n+                ,\n+\t\t\t\t\t\tthe recorded introduction will not be deleted if the caller hangs up while the remote party has not\n+\t\t\t\t\t\tyet answered.\n+              </para>\n+              <para>\n+                With\n+                <replaceable>delete</replaceable>\n+                set to\n+                <literal>1</literal>\n+                , the introduction will\n+\t\t\t\t\t\talways be deleted.\n+              </para>\n+            </argument>\n+            <para>\n+              This option is a modifier for the call screening/privacy mode. (See the\n+              <literal>p</literal>\n+              and\n+              <literal>P</literal>\n+              options.) It specifies\n+\t\t\t\t\tthat no introductions are to be saved in the\n+              <directory>priv-callerintros</directory>\n+              directory.\n+            </para>\n+          </option>\n+          <option name=\"N\">\n+            <para>This option is a modifier for the call screening/privacy mode. It specifies\n+\t\t\t\t\tthat if CallerID is present, do not screen the call.</para>\n+          </option>\n+          <option name=\"o\">\n+            <argument name=\"x\" required=\"false\"/>\n+            <para>\n+              If\n+              <replaceable>x</replaceable>\n+              is not provided, specify that the CallerID that was present on the\n+              <emphasis>calling</emphasis>\n+              channel be stored as the CallerID on the\n+              <emphasis>called</emphasis>\n+              channel.\n+\t\t\t\t\tThis was the behavior of Asterisk 1.0 and earlier.\n+\t\t\t\t\tIf\n+              <replaceable>x</replaceable>\n+              is provided, specify the CallerID stored on the\n+              <emphasis>called</emphasis>\n+              channel.\n+\t\t\t\t\tNote that\n+              <literal>o(${CALLERID(all)})</literal>\n+              is similar to option\n+              <literal>o</literal>\n+              without the parameter.\n+            </para>\n+          </option>\n+          <option name=\"O\">\n+            <argument name=\"mode\">\n+              <para>\n+                With\n+                <replaceable>mode</replaceable>\n+                either not specified or set to\n+                <literal>1</literal>\n+                ,\n+\t\t\t\t\t\tthe originator hanging up will cause the phone to ring back immediately.\n+              </para>\n+              <para>\n+                With\n+                <replaceable>mode</replaceable>\n+                set to\n+                <literal>2</literal>\n+                , when the operator\n+\t\t\t\t\t\tflashes the trunk, it will ring their phone back.\n+              </para>\n+            </argument>\n+            <para>\n+              Enables\n+              <emphasis>operator services</emphasis>\n+              mode.  This option only\n+\t\t\t\t\tworks when bridging a DAHDI channel to another DAHDI channel\n+\t\t\t\t\tonly. If specified on non-DAHDI interfaces, it will be ignored.\n+\t\t\t\t\tWhen the destination answers (presumably an operator services\n+\t\t\t\t\tstation), the originator no longer has control of their line.\n+\t\t\t\t\tThey may hang up, but the switch will not release their line\n+\t\t\t\t\tuntil the destination party (the operator) hangs up.\n+            </para>\n           </option>\n-        </optionlist>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>This application allows the calling party to leave a message for the specified\n-\t\t\tlist of mailboxes. When multiple mailboxes are specified, the greeting will be taken from\n-\t\t\tthe first mailbox specified. Dialplan execution will stop if the specified mailbox does not\n-\t\t\texist.</para>\n-      <para>The Voicemail application will exit if any of the following DTMF digits are received:</para>\n-      <enumlist>\n-        <enum name=\"0\">\n-          <para>\n-            Jump to the\n-            <literal>o</literal>\n-            extension in the current dialplan context.\n-          </para>\n-        </enum>\n-        <enum name=\"*\">\n-          <para>\n-            Jump to the\n-            <literal>a</literal>\n-            extension in the current dialplan context.\n-          </para>\n-        </enum>\n-      </enumlist>\n-      <para>This application will set the following channel variable upon completion:</para>\n-      <variablelist>\n-        <variable name=\"VMSTATUS\">\n-          <para>This indicates the status of the execution of the VoiceMail application.</para>\n-          <value name=\"SUCCESS\"/>\n-          <value name=\"USEREXIT\"/>\n-          <value name=\"FAILED\"/>\n-        </variable>\n-      </variablelist>\n-    </description>\n-    <see-also>\n-      <ref type=\"application\">VoiceMailMain</ref>\n-    </see-also>\n-  </application>\n-  <application name=\"VoiceMailMain\" language=\"en_US\">\n-    <synopsis>Check Voicemail messages.</synopsis>\n-    <syntax>\n-      <parameter name=\"mailbox\" required=\"true\" argsep=\"@\">\n-        <argument name=\"mailbox\"/>\n-        <argument name=\"context\"/>\n-      </parameter>\n-      <parameter name=\"options\">\n-        <optionlist>\n           <option name=\"p\">\n+            <para>This option enables screening mode. This is basically Privacy mode\n+\t\t\t\t\twithout memory.</para>\n+          </option>\n+          <option name=\"P\">\n+            <argument name=\"x\"/>\n             <para>\n-              Consider the\n-              <replaceable>mailbox</replaceable>\n-              parameter as a prefix to\n-\t\t\t\t\t\tthe mailbox that is entered by the caller.\n+              Enable privacy mode. Use\n+              <replaceable>x</replaceable>\n+              as the family/key in the AstDB database if\n+\t\t\t\t\tit is provided. The current extension is used if a database family/key is not specified.\n             </para>\n           </option>\n-          <option name=\"g\">\n-            <argument name=\"#\" required=\"true\"/>\n-            <para>Use the specified amount of gain when recording a voicemail message.\n-\t\t\t\t\t\tThe units are whole-number decibels (dB).</para>\n+          <option name=\"Q\">\n+            <argument name=\"cause\" required=\"true\"/>\n+            <para>\n+              Specify the Q.850/Q.931\n+              <replaceable>cause</replaceable>\n+              to send on\n+\t\t\t\t\tunanswered channels when another channel answers the call.\n+\t\t\t\t\tAs with\n+              <literal>Hangup()</literal>\n+              ,\n+              <replaceable>cause</replaceable>\n+              can be a numeric cause code or a name such as\n+              <literal>NO_ANSWER</literal>\n+              ,\n+              <literal>USER_BUSY</literal>\n+              ,\n+              <literal>CALL_REJECTED</literal>\n+              or\n+              <literal>ANSWERED_ELSEWHERE</literal>\n+              (the default if Q isn't specified).\n+\t\t\t\t\t\tYou can also specify\n+              <literal>0</literal>\n+              or\n+              <literal>NONE</literal>\n+              to send no cause.  See the\n+              <filename>causes.h</filename>\n+              file for the\n+\t\t\t\t\t\tfull list of valid causes and names.\n+            </para>\n+            <para>NOTE: chan_sip does not support setting the cause on a CANCEL to anything\n+\t\t\t\t\tother than ANSWERED_ELSEWHERE.</para>\n           </option>\n           <option name=\"r\">\n-            <para>&quot;Read only&quot;. Prevent user from deleting any messages.</para>\n-            <para>This applies only to specific executions of VoiceMailMain, NOT the mailbox itself.</para>\n+            <para>Default: Indicate ringing to the calling party, even if the called party isn't actually ringing. Pass no audio to the calling\n+\t\t\t\t\tparty until the called channel has answered.</para>\n+            <argument name=\"tone\" required=\"false\">\n+              <para>\n+                Indicate progress to calling party. Send audio 'tone' from the\n+                <filename>indications.conf</filename>\n+                tonezone currently in use.\n+              </para>\n+            </argument>\n+          </option>\n+          <option name=\"R\">\n+            <para>Default: Indicate ringing to the calling party, even if the called party isn't actually ringing.\n+\t\t\t\t\tAllow interruption of the ringback if early media is received on the channel.</para>\n+          </option>\n+          <option name=\"S\">\n+            <argument name=\"x\" required=\"true\"/>\n+            <para>\n+              Hang up the call\n+              <replaceable>x</replaceable>\n+              seconds\n+              <emphasis>after</emphasis>\n+              the called party has\n+\t\t\t\t\tanswered the call.\n+            </para>\n           </option>\n           <option name=\"s\">\n-            <para>Skip checking the passcode for the mailbox.</para>\n+            <argument name=\"x\" required=\"true\"/>\n+            <para>\n+              Force the outgoing CallerID tag parameter to be set to the string\n+              <replaceable>x</replaceable>\n+              .\n+            </para>\n+            <para>\n+              Works with the\n+              <literal>f</literal>\n+              option.\n+            </para>\n           </option>\n-          <option name=\"a\">\n-            <argument name=\"folder\" required=\"true\"/>\n+          <option name=\"t\">\n             <para>\n-              Skip folder prompt and go directly to\n-              <replaceable>folder</replaceable>\n-              specified.\n-\t\t\t\t\t\tDefaults to\n-              <literal>INBOX</literal>\n-              (or\n-              <literal>0</literal>\n-              ).\n+              Allow the called party to transfer the calling party by sending the\n+\t\t\t\t\tDTMF sequence defined in\n+              <filename>features.conf</filename>\n+              . This setting does not perform policy enforcement on\n+\t\t\t\t\ttransfers initiated by other methods.\n             </para>\n-            <enumlist>\n-              <enum name=\"0\">\n-                <para>INBOX</para>\n-              </enum>\n-              <enum name=\"1\">\n-                <para>Old</para>\n-              </enum>\n-              <enum name=\"2\">\n-                <para>Work</para>\n-              </enum>\n-              <enum name=\"3\">\n-                <para>Family</para>\n-              </enum>\n-              <enum name=\"4\">\n-                <para>Friends</para>\n-              </enum>\n-              <enum name=\"5\">\n-                <para>Cust1</para>\n-              </enum>\n-              <enum name=\"6\">\n-                <para>Cust2</para>\n-              </enum>\n-              <enum name=\"7\">\n-                <para>Cust3</para>\n-              </enum>\n-              <enum name=\"8\">\n-                <para>Cust4</para>\n-              </enum>\n-              <enum name=\"9\">\n-                <para>Cust5</para>\n-              </enum>\n-            </enumlist>\n+          </option>\n+          <option name=\"T\">\n+            <para>\n+              Allow the calling party to transfer the called party by sending the\n+\t\t\t\t\tDTMF sequence defined in\n+              <filename>features.conf</filename>\n+              . This setting does not perform policy enforcement on\n+\t\t\t\t\ttransfers initiated by other methods.\n+            </para>\n+          </option>\n+          <option name=\"U\" argsep=\"^\">\n+            <argument name=\"x\" required=\"true\">\n+              <para>\n+                Name of the subroutine context to execute via\n+                <literal>Gosub</literal>\n+                .\n+\t\t\t\t\t\tThe subroutine execution starts in the named context at the s exten and priority 1.\n+              </para>\n+            </argument>\n+            <argument name=\"arg\" multiple=\"true\" required=\"false\">\n+              <para>\n+                Arguments for the\n+                <literal>Gosub</literal>\n+                routine\n+              </para>\n+            </argument>\n+            <para>\n+              Execute via\n+              <literal>Gosub</literal>\n+              the routine\n+              <replaceable>x</replaceable>\n+              for the\n+              <emphasis>called</emphasis>\n+              channel before connecting\n+\t\t\t\t\tto the calling channel. Arguments can be specified to the\n+              <literal>Gosub</literal>\n+              using\n+              <literal>^</literal>\n+              as a delimiter. The\n+              <literal>Gosub</literal>\n+              routine can set the variable\n+              <variable>GOSUB_RESULT</variable>\n+              to specify the following actions after the\n+              <literal>Gosub</literal>\n+              returns.\n+            </para>\n+            <variablelist>\n+              <variable name=\"GOSUB_RESULT\">\n+                <value name=\"ABORT\">Hangup both legs of the call.</value>\n+                <value name=\"CONGESTION\">Behave as if line congestion was encountered.</value>\n+                <value name=\"BUSY\">Behave as if a busy signal was encountered.</value>\n+                <value name=\"CONTINUE\">Hangup the called party and allow the calling party\n+\t\t\t\t\t\t\t\tto continue dialplan execution at the next priority.</value>\n+                <value name=\"GOTO:[[&lt;context&gt;^]&lt;exten&gt;^]&lt;priority&gt;\">Transfer the call to the specified destination.</value>\n+              </variable>\n+            </variablelist>\n+            <para>\n+              NOTE: You cannot use any additional action post answer options in conjunction\n+\t\t\t\t\twith this option. Also, pbx services are run on the\n+              <emphasis>called</emphasis>\n+              channel,\n+\t\t\t\t\tso you will not be able to set timeouts via the\n+              <literal>TIMEOUT()</literal>\n+              function in this routine.\n+            </para>\n+          </option>\n+          <option name=\"u\">\n+            <argument name=\"x\" required=\"true\">\n+              <para>\n+                Force the outgoing callerid presentation indicator parameter to be set\n+\t\t\t\t\t\tto one of the values passed in\n+                <replaceable>x</replaceable>\n+                :\n+                <literal>allowed_not_screened</literal>\n+                <literal>allowed_passed_screen</literal>\n+                <literal>allowed_failed_screen</literal>\n+                <literal>allowed</literal>\n+                <literal>prohib_not_screened</literal>\n+                <literal>prohib_passed_screen</literal>\n+                <literal>prohib_failed_screen</literal>\n+                <literal>prohib</literal>\n+                <literal>unavailable</literal>\n+              </para>\n+            </argument>\n+            <para>\n+              Works with the\n+              <literal>f</literal>\n+              option.\n+            </para>\n+          </option>\n+          <option name=\"w\">\n+            <para>\n+              Allow the called party to enable recording of the call by sending\n+\t\t\t\t\tthe DTMF sequence defined for one-touch recording in\n+              <filename>features.conf</filename>\n+              .\n+            </para>\n+          </option>\n+          <option name=\"W\">\n+            <para>\n+              Allow the calling party to enable recording of the call by sending\n+\t\t\t\t\tthe DTMF sequence defined for one-touch recording in\n+              <filename>features.conf</filename>\n+              .\n+            </para>\n+          </option>\n+          <option name=\"x\">\n+            <para>\n+              Allow the called party to enable recording of the call by sending\n+\t\t\t\t\tthe DTMF sequence defined for one-touch automixmonitor in\n+              <filename>features.conf</filename>\n+              .\n+            </para>\n+          </option>\n+          <option name=\"X\">\n+            <para>\n+              Allow the calling party to enable recording of the call by sending\n+\t\t\t\t\tthe DTMF sequence defined for one-touch automixmonitor in\n+              <filename>features.conf</filename>\n+              .\n+            </para>\n+          </option>\n+          <option name=\"z\">\n+            <para>On a call forward, cancel any dial timeout which has been set for this call.</para>\n           </option>\n         </optionlist>\n       </parameter>\n+      <parameter name=\"URL\">\n+        <para>The optional URL will be sent to the called party if the channel driver supports it.</para>\n+      </parameter>\n     </syntax>\n     <description>\n+      <para>This application will place calls to one or more specified channels. As soon\n+\t\t\tas one of the requested channels answers, the originating channel will be\n+\t\t\tanswered, if it has not already been answered. These two channels will then\n+\t\t\tbe active in a bridged call. All other channels that were requested will then\n+\t\t\tbe hung up.</para>\n+      <para>Unless there is a timeout specified, the Dial application will wait\n+\t\t\tindefinitely until one of the called channels answers, the user hangs up, or\n+\t\t\tif all of the called channels are busy or unavailable. Dialplan execution will\n+\t\t\tcontinue if no requested channels can be called, or if the timeout expires.\n+\t\t\tThis application will report normal termination if the originating channel\n+\t\t\thangs up, or if the call is bridged and either of the parties in the bridge\n+\t\t\tends the call.</para>\n       <para>\n-        This application allows the calling party to check voicemail messages. A specific\n-        <replaceable>mailbox</replaceable>\n-        , and optional corresponding\n-        <replaceable>context</replaceable>\n+        If the\n+        <variable>OUTBOUND_GROUP</variable>\n+        variable is set, all peer channels created by this\n+\t\t\tapplication will be put into that group (as in\n+        <literal>Set(GROUP()=...</literal>\n+        ).\n+\t\t\tIf the\n+        <variable>OUTBOUND_GROUP_ONCE</variable>\n+        variable is set, all peer channels created by this\n+\t\t\tapplication will be put into that group (as in\n+        <literal>Set(GROUP()=...</literal>\n+        ). Unlike\n+        <variable>OUTBOUND_GROUP</variable>\n         ,\n-\t\t\tmay be specified. If a\n-        <replaceable>mailbox</replaceable>\n-        is not provided, the calling party will\n-\t\t\tbe prompted to enter one. If a\n-        <replaceable>context</replaceable>\n-        is not specified, the\n-        <literal>default</literal>\n-        context will be used.\n+\t\t\thowever, the variable will be unset after use.\n       </para>\n-      <para>The VoiceMailMain application will exit if the following DTMF digit is entered as Mailbox\n-\t\t\tor Password, and the extension exists:</para>\n-      <enumlist>\n-        <enum name=\"*\">\n-          <para>\n-            Jump to the\n-            <literal>a</literal>\n-            extension in the current dialplan context.\n-          </para>\n-        </enum>\n-      </enumlist>\n+      <example title=\"Dial with 30 second timeout\">same =&gt; n,Dial(PJSIP/alice,30)</example>\n+      <example title=\"Parallel dial with 45 second timeout\">same =&gt; n,Dial(PJSIP/alice&amp;PJIP/bob,45)</example>\n+      <example title=\"Dial with 'g' continuation option\">same =&gt; n,Dial(PJSIP/alice,,g)\n+\t\t\t same =&gt; n,Log(NOTICE, Alice call result: ${DIALSTATUS})</example>\n+      <example title=\"Dial with transfer/recording features for calling party\">same =&gt; n,Dial(PJSIP/alice,,TX)</example>\n+      <example title=\"Dial with call length limit\">same =&gt; n,Dial(PJSIP/alice,,L(60000:30000:10000))</example>\n+      <example title=\"Dial alice and bob and send NO_ANSWER to bob instead of ANSWERED_ELSEWHERE when alice answers\">same =&gt; n,Dial(PJSIP/alice&amp;PJSIP/bob,,Q(NO_ANSWER))</example>\n+      <example title=\"Dial with pre-dial subroutines\">[default]\n+\t\t\texten =&gt; callee_channel,1,NoOp(ARG1=${ARG1} ARG2=${ARG2})\n+\t\t\t same =&gt; n,Log(NOTICE, I'm called on channel ${CHANNEL} prior to it starting the dial attempt)\n+\t\t\t same =&gt; n,Return()\n+\t\t\texten =&gt; called_channel,1,NoOp(ARG1=${ARG1} ARG2=${ARG2})\n+\t\t\t same =&gt; n,Log(NOTICE, I'm called on outbound channel ${CHANNEL} prior to it being used to dial someone)\n+\t\t\t same =&gt; n,Return()\n+\t\t\texten =&gt; _X.,1,NoOp()\n+\t\t\t same =&gt; n,Dial(PJSIP/alice,,b(default^called_channel^1(my_gosub_arg1^my_gosub_arg2))B(default^callee_channel^1(my_gosub_arg1^my_gosub_arg2)))\n+\t\t\t same =&gt; n,Hangup()</example>\n+      <example title=\"Dial with post-answer subroutine executed on outbound channel\">[my_gosub_routine]\n+\t\t\texten =&gt; s,1,NoOp(ARG1=${ARG1} ARG2=${ARG2})\n+\t\t\t same =&gt; n,Playback(hello)\n+\t\t\t same =&gt; n,Return()\n+\t\t\t[default]\n+\t\t\texten =&gt; _X.,1,NoOp()\n+\t\t\t same =&gt; n,Dial(PJSIP/alice,,U(my_gosub_routine^my_gosub_arg1^my_gosub_arg2))\n+\t\t\t same =&gt; n,Hangup()</example>\n+      <example title=\"Dial into ConfBridge using 'G' option\">same =&gt; n,Dial(PJSIP/alice,,G(jump_to_here))\n+\t\t\t same =&gt; n(jump_to_here),Goto(confbridge)\n+\t\t\t same =&gt; n,Goto(confbridge)\n+\t\t\t same =&gt; n(confbridge),ConfBridge(${EXTEN})</example>\n+      <para>This application sets the following channel variables:</para>\n+      <variablelist>\n+        <variable name=\"DIALEDTIME\">\n+          <para>This is the time from dialing a channel until when it is disconnected.</para>\n+        </variable>\n+        <variable name=\"DIALEDTIME_MS\">\n+          <para>This is the milliseconds version of the DIALEDTIME variable.</para>\n+        </variable>\n+        <variable name=\"ANSWEREDTIME\">\n+          <para>This is the amount of time for actual call.</para>\n+        </variable>\n+        <variable name=\"ANSWEREDTIME_MS\">\n+          <para>This is the milliseconds version of the ANSWEREDTIME variable.</para>\n+        </variable>\n+        <variable name=\"RINGTIME\">\n+          <para>This is the time from creating the channel to the first RINGING event received. Empty if there was no ring.</para>\n+        </variable>\n+        <variable name=\"RINGTIME_MS\">\n+          <para>This is the milliseconds version of the RINGTIME variable.</para>\n+        </variable>\n+        <variable name=\"PROGRESSTIME\">\n+          <para>This is the time from creating the channel to the first PROGRESS event received. Empty if there was no such event.</para>\n+        </variable>\n+        <variable name=\"PROGRESSTIME_MS\">\n+          <para>This is the milliseconds version of the PROGRESSTIME variable.</para>\n+        </variable>\n+        <variable name=\"DIALEDPEERNAME\">\n+          <para>The name of the outbound channel that answered the call.</para>\n+        </variable>\n+        <variable name=\"DIALEDPEERNUMBER\">\n+          <para>The number that was dialed for the answered outbound channel.</para>\n+        </variable>\n+        <variable name=\"FORWARDERNAME\">\n+          <para>If a call forward occurred, the name of the forwarded channel.</para>\n+        </variable>\n+        <variable name=\"DIALSTATUS\">\n+          <para>This is the status of the call</para>\n+          <value name=\"CHANUNAVAIL\">Either the dialed peer exists but is not currently reachable, e.g.\n+\t\t\t\t\t\tendpoint is not registered, or an attempt was made to call a\n+\t\t\t\t\t\tnonexistent location, e.g. nonexistent DNS hostname.</value>\n+          <value name=\"CONGESTION\">Channel or switching congestion occured when routing the call.\n+\t\t\t\t\t\tThis can occur if there is a slow or no response from the remote end.</value>\n+          <value name=\"NOANSWER\">Called party did not answer.</value>\n+          <value name=\"BUSY\">The called party was busy or indicated a busy status.\n+\t\t\t\t\t\tNote that some SIP devices will respond with 486 Busy if their Do Not Disturb\n+\t\t\t\t\t\tmodes are active. In this case, you can use DEVICE_STATUS to check if the\n+\t\t\t\t\t\tendpoint is actually in use, if needed.</value>\n+          <value name=\"ANSWER\">The call was answered.\n+\t\t\t\t\t\tAny other result implicitly indicates the call was not answered.</value>\n+          <value name=\"CANCEL\">Dial was cancelled before call was answered or reached some other terminating event.</value>\n+          <value name=\"DONTCALL\">For the Privacy and Screening Modes.\n+\t\t\t\t\t\tWill be set if the called party chooses to send the calling party to the 'Go Away' script.</value>\n+          <value name=\"TORTURE\">For the Privacy and Screening Modes.\n+\t\t\t\t\t\tWill be set if the called party chooses to send the calling party to the 'torture' script.</value>\n+          <value name=\"INVALIDARGS\">Dial failed due to invalid syntax.</value>\n+        </variable>\n+      </variablelist>\n     </description>\n     <see-also>\n-      <ref type=\"application\">VoiceMail</ref>\n+      <ref type=\"application\">RetryDial</ref>\n+      <ref type=\"application\">SendDTMF</ref>\n+      <ref type=\"application\">Gosub</ref>\n+      <ref type=\"application\">Macro</ref>\n     </see-also>\n   </application>\n-  <application name=\"MailboxExists\" language=\"en_US\">\n-    <synopsis>Check to see if Voicemail mailbox exists.</synopsis>\n+  <application name=\"RetryDial\" language=\"en_US\">\n+    <synopsis>Place a call, retrying on failure allowing an optional exit extension.</synopsis>\n     <syntax>\n-      <parameter name=\"mailbox\" required=\"true\" argsep=\"@\">\n-        <argument name=\"mailbox\" required=\"true\"/>\n-        <argument name=\"context\"/>\n+      <parameter name=\"announce\" required=\"true\">\n+        <para>Filename of sound that will be played when no channel can be reached</para>\n       </parameter>\n-      <parameter name=\"options\">\n-        <para>None options.</para>\n+      <parameter name=\"sleep\" required=\"true\">\n+        <para>Number of seconds to wait after a dial attempt failed before a new attempt is made</para>\n+      </parameter>\n+      <parameter name=\"retries\" required=\"true\">\n+        <para>Number of retries</para>\n+        <para>When this is reached flow will continue at the next priority in the dialplan</para>\n+      </parameter>\n+      <parameter name=\"dialargs\" required=\"true\">\n+        <para>Same format as arguments provided to the Dial application</para>\n       </parameter>\n     </syntax>\n     <description>\n-      <note>\n-        <para>DEPRECATED. Use VM_INFO(mailbox[@context],exists) instead.</para>\n-      </note>\n       <para>\n-        Check to see if the specified\n-        <replaceable>mailbox</replaceable>\n-        exists. If no voicemail\n-        <replaceable>context</replaceable>\n-        is specified, the\n-        <literal>default</literal>\n-        context\n-\t\t\twill be used.\n+        This application will attempt to place a call using the normal Dial application.\n+\t\t\tIf no channel can be reached, the\n+        <replaceable>announce</replaceable>\n+        file will be played.\n+\t\t\tThen, it will wait\n+        <replaceable>sleep</replaceable>\n+        number of seconds before retrying the call.\n+\t\t\tAfter\n+        <replaceable>retries</replaceable>\n+        number of attempts, the calling channel will continue at the next priority in the dialplan.\n+\t\t\tIf the\n+        <replaceable>retries</replaceable>\n+        setting is set to 0, this application will retry endlessly.\n+\t\t\tWhile waiting to retry a call, a 1 digit extension may be dialed. If that\n+\t\t\textension exists in either the context defined in\n+        <variable>EXITCONTEXT</variable>\n+        or the current\n+\t\t\tone, The call will jump to that extension immediately.\n+\t\t\tThe\n+        <replaceable>dialargs</replaceable>\n+        are specified in the same format that arguments are provided\n+\t\t\tto the Dial application.\n       </para>\n-      <para>This application will set the following channel variable upon completion:</para>\n-      <variablelist>\n-        <variable name=\"VMBOXEXISTSSTATUS\">\n-          <para>This will contain the status of the execution of the MailboxExists application.\n-\t\t\t\t\tPossible values include:</para>\n-          <value name=\"SUCCESS\"/>\n-          <value name=\"FAILED\"/>\n-        </variable>\n-      </variablelist>\n     </description>\n     <see-also>\n-      <ref type=\"function\">VM_INFO</ref>\n+      <ref type=\"application\">Dial</ref>\n     </see-also>\n   </application>\n-  <application name=\"VMAuthenticate\" language=\"en_US\">\n-    <synopsis>Authenticate with Voicemail passwords.</synopsis>\n+  <module language=\"en_US\" name=\"app_verbose\">\n+    <support_level>core</support_level>\n+  </module>\n+  <application name=\"Verbose\" language=\"en_US\">\n+    <synopsis>Send arbitrary text to verbose output.</synopsis>\n     <syntax>\n-      <parameter name=\"mailbox\" required=\"true\" argsep=\"@\">\n-        <argument name=\"mailbox\"/>\n-        <argument name=\"context\"/>\n+      <parameter name=\"level\">\n+        <para>Must be an integer value.  If not specified, defaults to 0.</para>\n       </parameter>\n-      <parameter name=\"options\">\n-        <optionlist>\n-          <option name=\"s\">\n-            <para>Skip playing the initial prompts.</para>\n-          </option>\n-        </optionlist>\n+      <parameter name=\"message\" required=\"true\">\n+        <para>Output text message.</para>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>\n-        This application behaves the same way as the Authenticate application, but the passwords\n-\t\t\tare taken from\n-        <filename>voicemail.conf</filename>\n-        . If the\n-        <replaceable>mailbox</replaceable>\n-        is\n-\t\t\tspecified, only that mailbox's password will be considered valid. If the\n-        <replaceable>mailbox</replaceable>\n-        is not specified, the channel variable\n-        <variable>AUTH_MAILBOX</variable>\n-        will be set with the authenticated\n-\t\t\tmailbox.\n-      </para>\n-      <para>The VMAuthenticate application will exit if the following DTMF digit is entered as Mailbox\n-\t\t\tor Password, and the extension exists:</para>\n-      <enumlist>\n-        <enum name=\"*\">\n-          <para>\n-            Jump to the\n-            <literal>a</literal>\n-            extension in the current dialplan context.\n-          </para>\n-        </enum>\n-      </enumlist>\n+      <para>Sends an arbitrary text message to verbose output.</para>\n     </description>\n   </application>\n-  <application name=\"VoiceMailPlayMsg\" language=\"en_US\">\n-    <synopsis>Play a single voice mail msg from a mailbox by msg id.</synopsis>\n+  <application name=\"Log\" language=\"en_US\">\n+    <synopsis>Send arbitrary text to a selected log level.</synopsis>\n     <syntax>\n-      <parameter name=\"mailbox\" required=\"true\" argsep=\"@\">\n-        <argument name=\"mailbox\"/>\n-        <argument name=\"context\"/>\n+      <parameter name=\"level\" required=\"true\">\n+        <para>\n+          Level must be one of\n+          <literal>ERROR</literal>\n+          ,\n+          <literal>WARNING</literal>\n+          ,\n+          <literal>NOTICE</literal>\n+          ,\n+          <literal>DEBUG</literal>\n+          ,\n+          <literal>VERBOSE</literal>\n+          ,\n+          <literal>DTMF</literal>\n+          , or\n+\t\t\t\tthe name of a custom dynamic logging level.\n+        </para>\n       </parameter>\n-      <parameter name=\"msg_id\" required=\"true\">\n-        <para>The msg id of the msg to play back.</para>\n+      <parameter name=\"message\" required=\"true\">\n+        <para>Output text message.</para>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>This application sets the following channel variable upon completion:</para>\n-      <variablelist>\n-        <variable name=\"VOICEMAIL_PLAYBACKSTATUS\">\n-          <para>The status of the playback attempt as a text string.</para>\n-          <value name=\"SUCCESS\"/>\n-          <value name=\"FAILED\"/>\n-        </variable>\n-      </variablelist>\n+      <para>Sends an arbitrary text message to a selected log level.</para>\n     </description>\n   </application>\n-  <application name=\"VMSayName\" language=\"en_US\">\n-    <synopsis>Play the name of a voicemail user</synopsis>\n+  <module language=\"en_US\" name=\"app_mf\">\n+    <support_level>extended</support_level>\n+  </module>\n+  <application name=\"ReceiveMF\" language=\"en_US\">\n+    <since>\n+      <version>16.21.0</version>\n+      <version>18.7.0</version>\n+      <version>19.0.0</version>\n+    </since>\n+    <synopsis>Detects MF digits on a channel and saves them to a variable.</synopsis>\n     <syntax>\n-      <parameter name=\"mailbox\" required=\"true\" argsep=\"@\">\n-        <argument name=\"mailbox\"/>\n-        <argument name=\"context\"/>\n+      <parameter name=\"variable\" required=\"true\">\n+        <para>\n+          The input digits will be stored in the given\n+          <replaceable>variable</replaceable>\n+          name.\n+        </para>\n       </parameter>\n-    </syntax>\n-    <description>\n-      <para>\n-        This application will say the recorded name of the voicemail user specified as the\n-\t\t\targument to this application. If no context is provided,\n-        <literal>default</literal>\n-        is assumed.\n-      </para>\n-      <para>Similar to the Background() application, playback of the recorded\n-\t\t\tname can be interrupted by entering an extension, which will be searched\n-\t\t\tfor in the current context.</para>\n-    </description>\n-  </application>\n-  <function name=\"MAILBOX_EXISTS\" language=\"en_US\">\n-    <synopsis>Tell if a mailbox is configured.</synopsis>\n-    <syntax argsep=\"@\">\n-      <parameter name=\"mailbox\" required=\"true\"/>\n-      <parameter name=\"context\"/>\n-    </syntax>\n-    <description>\n-      <note>\n-        <para>DEPRECATED. Use VM_INFO(mailbox[@context],exists) instead.</para>\n-      </note>\n-      <para>\n-        Returns a boolean of whether the corresponding\n-        <replaceable>mailbox</replaceable>\n-        exists.\n-\t\t\tIf\n-        <replaceable>context</replaceable>\n-        is not specified, defaults to the\n-        <literal>default</literal>\n-        context.\n-      </para>\n-    </description>\n-    <see-also>\n-      <ref type=\"function\">VM_INFO</ref>\n-    </see-also>\n-  </function>\n-  <function name=\"VM_INFO\" language=\"en_US\">\n-    <synopsis>Returns the selected attribute from a mailbox.</synopsis>\n-    <syntax argsep=\",\">\n-      <parameter name=\"mailbox\" argsep=\"@\" required=\"true\">\n-        <argument name=\"mailbox\" required=\"true\"/>\n-        <argument name=\"context\"/>\n+      <parameter name=\"timeout\">\n+        <para>\n+          The number of seconds to wait for all digits, if greater\n+\t\t\t\tthan\n+          <literal>0</literal>\n+          . Can be floating point. Default\n+\t\t\t\tis no timeout.\n+        </para>\n       </parameter>\n-      <parameter name=\"attribute\" required=\"true\">\n+      <parameter name=\"options\">\n         <optionlist>\n-          <option name=\"count\">\n-            <para>\n-              Count of messages in specified\n-              <replaceable>folder</replaceable>\n-              .\n-\t\t\t\t\t\tIf\n-              <replaceable>folder</replaceable>\n-              is not specified, defaults to\n-              <literal>INBOX</literal>\n-              .\n-            </para>\n+          <option name=\"d\">\n+            <para>Delay audio by a frame to try to extra quelch.</para>\n           </option>\n-          <option name=\"email\">\n-            <para>E-mail address associated with the mailbox.</para>\n+          <option name=\"l\">\n+            <para>Receive digits even if a key pulse (KP) has not yet\n+\t\t\t\t\t\tbeen received. By default, this application will ignore\n+\t\t\t\t\t\tall other digits until a KP has been received.</para>\n           </option>\n-          <option name=\"exists\">\n-            <para>\n-              Returns a boolean of whether the corresponding\n-              <replaceable>mailbox</replaceable>\n-              exists.\n-            </para>\n+          <option name=\"k\">\n+            <para>Do not return a character for the KP digit.</para>\n           </option>\n-          <option name=\"fullname\">\n-            <para>Full name associated with the mailbox.</para>\n+          <option name=\"m\">\n+            <para>Mute conference.</para>\n           </option>\n-          <option name=\"language\">\n-            <para>Mailbox language if overridden, otherwise the language of the channel.</para>\n+          <option name=\"n\">\n+            <para>Maximum number of digits, regardless of the sequence.</para>\n           </option>\n-          <option name=\"locale\">\n-            <para>Mailbox locale if overridden, otherwise global locale.</para>\n+          <option name=\"o\">\n+            <para>Enable override. Repeated KPs will clear all previous digits.</para>\n           </option>\n-          <option name=\"pager\">\n-            <para>Pager e-mail address associated with the mailbox.</para>\n+          <option name=\"q\">\n+            <para>Quelch MF from in-band.</para>\n           </option>\n-          <option name=\"password\">\n-            <para>Mailbox access password.</para>\n+          <option name=\"r\">\n+            <para>&quot;Radio&quot; mode (relaxed MF).</para>\n           </option>\n-          <option name=\"tz\">\n-            <para>Mailbox timezone if overridden, otherwise global timezone</para>\n+          <option name=\"s\">\n+            <para>Do not return a character for ST digits.</para>\n           </option>\n         </optionlist>\n       </parameter>\n-      <parameter name=\"folder\" required=\"false\">\n-        <para>\n-          If not specified,\n-          <literal>INBOX</literal>\n-          is assumed.\n-        </para>\n-      </parameter>\n     </syntax>\n     <description>\n       <para>\n-        Returns the selected attribute from the specified\n-        <replaceable>mailbox</replaceable>\n-        .\n-\t\t\tIf\n-        <replaceable>context</replaceable>\n-        is not specified, defaults to the\n-        <literal>default</literal>\n-        context. Where the\n-        <replaceable>folder</replaceable>\n-        can be specified, common folders\n-\t\t\tinclude\n-        <literal>INBOX</literal>\n-        ,\n-        <literal>Old</literal>\n-        ,\n-        <literal>Work</literal>\n-        ,\n-        <literal>Family</literal>\n-        and\n-        <literal>Friends</literal>\n+        Reads a ST, STP, ST2P, or ST3P-terminated string of MF digits from\n+\t\t\tthe user in to the given\n+        <replaceable>variable</replaceable>\n         .\n       </para>\n+      <para>\n+        This application does not automatically answer the channel and\n+\t\t\tshould be preceded with\n+        <literal>Answer</literal>\n+        or\n+        <literal>Progress</literal>\n+        as needed.\n+      </para>\n+      <variablelist>\n+        <variable name=\"RECEIVEMFSTATUS\">\n+          <para>This is the status of the read operation.</para>\n+          <value name=\"START\"/>\n+          <value name=\"ERROR\"/>\n+          <value name=\"HANGUP\"/>\n+          <value name=\"MAXDIGITS\"/>\n+          <value name=\"TIMEOUT\"/>\n+        </variable>\n+      </variablelist>\n     </description>\n-  </function>\n-  <manager name=\"VoicemailUsersList\" language=\"en_US\">\n-    <synopsis>List All Voicemail User Information.</synopsis>\n-    <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-    </syntax>\n-    <description/>\n-  </manager>\n-  <manager name=\"VoicemailUserStatus\" language=\"en_US\">\n-    <synopsis>Show the status of given voicemail user's info.</synopsis>\n+    <see-also>\n+      <ref type=\"application\">Read</ref>\n+      <ref type=\"application\">SendMF</ref>\n+      <ref type=\"application\">ReceiveSF</ref>\n+    </see-also>\n+  </application>\n+  <application name=\"SendMF\" language=\"en_US\">\n+    <since>\n+      <version>16.21.0</version>\n+      <version>18.7.0</version>\n+      <version>19.0.0</version>\n+    </since>\n+    <synopsis>Sends arbitrary MF digits on the current or specified channel.</synopsis>\n     <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"Context\" required=\"true\">\n-        <para>The context you want to check.</para>\n+      <parameter name=\"digits\" required=\"true\">\n+        <para>List of digits 0-9,*#ABC to send; w for a half-second pause,\n+\t\t\t\talso f or F for a flash-hook if the channel supports flash-hook,\n+\t\t\t\th or H for 250 ms of 2600 Hz,\n+\t\t\t\tand W for a wink if the channel supports wink.</para>\n+        <para>Key pulse and start digits are not included automatically.\n+\t\t\t\t* is used for KP, # for ST, A for STP, B for ST2P, and C for ST3P.</para>\n       </parameter>\n-      <parameter name=\"Mailbox\" required=\"true\">\n-        <para>The mailbox you want to check.</para>\n+      <parameter name=\"timeout_ms\" required=\"false\">\n+        <para>Amount of time to wait in ms between tones. (defaults to 50ms).</para>\n+      </parameter>\n+      <parameter name=\"duration_ms\" required=\"false\">\n+        <para>Duration of each numeric digit (defaults to 55ms).</para>\n+      </parameter>\n+      <parameter name=\"duration_ms_kp\" required=\"false\">\n+        <para>Duration of KP digits (defaults to 120ms).</para>\n+      </parameter>\n+      <parameter name=\"duration_ms_st\" required=\"false\">\n+        <para>Duration of ST, STP, ST2P, and ST3P digits (defaults to 65ms).</para>\n+      </parameter>\n+      <parameter name=\"channel\" required=\"false\">\n+        <para>Channel where digits will be played</para>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>Retrieves the status of the given voicemail user.</para>\n+      <para>It will send all digits or terminate if it encounters an error.</para>\n     </description>\n-  </manager>\n-  <manager name=\"VoicemailRefresh\" language=\"en_US\">\n-    <synopsis>Tell Asterisk to poll mailboxes for a change</synopsis>\n+    <see-also>\n+      <ref type=\"application\">ReceiveMF</ref>\n+      <ref type=\"application\">SendSF</ref>\n+      <ref type=\"application\">SendDTMF</ref>\n+    </see-also>\n+  </application>\n+  <manager name=\"PlayMF\" language=\"en_US\">\n+    <since>\n+      <version>16.21.0</version>\n+      <version>18.7.0</version>\n+      <version>19.0.0</version>\n+    </since>\n+    <synopsis>Play MF digit on a specific channel.</synopsis>\n     <syntax>\n       <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"Context\"/>\n-      <parameter name=\"Mailbox\"/>\n+      <parameter name=\"Channel\" required=\"true\">\n+        <para>Channel name to send digit to.</para>\n+      </parameter>\n+      <parameter name=\"Digit\" required=\"true\">\n+        <para>The MF digit to play.</para>\n+      </parameter>\n+      <parameter name=\"Duration\" required=\"false\">\n+        <para>The duration, in milliseconds, of the digit to be played.</para>\n+      </parameter>\n     </syntax>\n     <description>\n-      <para>\n-        Normally, MWI indicators are only sent when Asterisk itself\n-\t\t\tchanges a mailbox.  With external programs that modify the content\n-\t\t\tof a mailbox from outside the application, an option exists called\n-        <literal>pollmailboxes</literal>\n-        that will cause voicemail to\n-\t\t\tcontinually scan all mailboxes on a system for changes.  This can\n-\t\t\tcause a large amount of load on a system.  This command allows\n-\t\t\texternal applications to signal when a particular mailbox has\n-\t\t\tchanged, thus permitting external applications to modify mailboxes\n-\t\t\tand MWI to work without introducing considerable CPU load.\n-      </para>\n-      <para>\n-        If\n-        <replaceable>Context</replaceable>\n-        is not specified, all\n-\t\t\tmailboxes on the system will be polled for changes.  If\n-        <replaceable>Context</replaceable>\n-        is specified, but\n-        <replaceable>Mailbox</replaceable>\n-        is omitted, then all mailboxes\n-\t\t\twithin\n-        <replaceable>Context</replaceable>\n-        will be polled.\n-\t\t\tOtherwise, only a single mailbox will be polled for changes.\n-      </para>\n+      <para>Plays an MF digit on the specified channel.</para>\n     </description>\n   </manager>\n-  <module language=\"en_US\" name=\"app_sayunixtime\">\n+  <module language=\"en_US\" name=\"app_speech_utils\">\n+    <depend>res_speech</depend>\n     <support_level>core</support_level>\n   </module>\n-  <application name=\"SayUnixTime\" language=\"en_US\">\n-    <synopsis>Says a specified time in a custom format.</synopsis>\n+  <application name=\"SpeechCreate\" language=\"en_US\">\n+    <synopsis>Create a Speech Structure.</synopsis>\n     <syntax>\n-      <parameter name=\"unixtime\" required=\"false\">\n-        <para>time, in seconds since Jan 1, 1970.  May be negative. Defaults to now.</para>\n-      </parameter>\n-      <parameter name=\"timezone\" required=\"false\">\n-        <para>\n-          timezone, see\n-          <directory>/usr/share/zoneinfo</directory>\n-          for a list. Defaults to machine default.\n-        </para>\n-      </parameter>\n-      <parameter name=\"format\" required=\"false\">\n-        <para>\n-          a format the time is to be said in.  See\n-          <filename>voicemail.conf</filename>\n-          .\n-\t\t\t\tDefaults to\n-          <literal>ABdY &quot;digits/at&quot; IMp</literal>\n-        </para>\n+      <parameter name=\"engine_name\" required=\"true\"/>\n+    </syntax>\n+    <description>\n+      <para>This application creates information to be used by all the other applications.\n+\t\t\tIt must be called before doing any speech recognition activities such as activating a grammar.\n+\t\t\tIt takes the engine name to use as the argument, if not specified the default engine will be used.</para>\n+      <para>Sets the ERROR channel variable to 1 if the engine cannot be used.</para>\n+    </description>\n+  </application>\n+  <application name=\"SpeechActivateGrammar\" language=\"en_US\">\n+    <synopsis>Activate a grammar.</synopsis>\n+    <syntax>\n+      <parameter name=\"grammar_name\" required=\"true\"/>\n+    </syntax>\n+    <description>\n+      <para>This activates the specified grammar to be recognized by the engine.\n+\t\t\tA grammar tells the speech recognition engine what to recognize, and how to portray it back to you\n+\t\t\tin the dialplan. The grammar name is the only argument to this application.</para>\n+      <para>Hangs up the channel on failure. If this is not desired, use TryExec.</para>\n+    </description>\n+  </application>\n+  <application name=\"SpeechStart\" language=\"en_US\">\n+    <synopsis>Start recognizing voice in the audio stream.</synopsis>\n+    <syntax/>\n+    <description>\n+      <para>Tell the speech recognition engine that it should start trying to get results from audio being\n+\t\t\tfed to it.</para>\n+      <para>Hangs up the channel on failure. If this is not desired, use TryExec.</para>\n+    </description>\n+  </application>\n+  <application name=\"SpeechBackground\" language=\"en_US\">\n+    <synopsis>Play a sound file and wait for speech to be recognized.</synopsis>\n+    <syntax>\n+      <parameter name=\"sound_file\" required=\"true\"/>\n+      <parameter name=\"timeout\">\n+        <para>Timeout integer in seconds. Note the timeout will only start\n+\t\t\t\tonce the sound file has stopped playing.</para>\n       </parameter>\n-      <parameter name=\"options\" required=\"false\">\n+      <parameter name=\"options\">\n         <optionlist>\n-          <option name=\"j\">\n-            <para>\n-              Allow the calling user to dial digits to jump to that extension.\n-\t\t\t\t\t\tThis option is automatically enabled if\n-              <variable>SAY_DTMF_INTERRUPT</variable>\n-              is present on the channel and\n-\t\t\t\t\t\tset to 'true' (case insensitive)\n-            </para>\n+          <option name=\"n\">\n+            <para>Don't answer the channel if it has not already been answered.</para>\n           </option>\n         </optionlist>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>\n-        Uses some of the sound files stored in\n-        <directory>/var/lib/asterisk/sounds</directory>\n-        to construct a phrase\n-\t\t\tsaying the specified date and/or time in the specified format.\n-      </para>\n+      <para>This application plays a sound file and waits for the person to speak. Once they start speaking playback\n+\t\t\tof the file stops, and silence is heard. Once they stop talking the processing sound is played to indicate\n+\t\t\tthe speech recognition engine is working. Once results are available the application returns and results\n+\t\t\t(score and text) are available using dialplan functions.</para>\n+      <para>The first text and score are ${SPEECH_TEXT(0)} AND ${SPEECH_SCORE(0)} while the second are ${SPEECH_TEXT(1)}\n+\t\t\tand ${SPEECH_SCORE(1)}.</para>\n+      <para>The first argument is the sound file and the second is the timeout integer in seconds.</para>\n+      <para>Hangs up the channel on failure. If this is not desired, use TryExec.</para>\n     </description>\n-    <see-also>\n-      <ref type=\"function\">STRFTIME</ref>\n-      <ref type=\"function\">STRPTIME</ref>\n-      <ref type=\"function\">IFTIME</ref>\n-    </see-also>\n   </application>\n-  <application name=\"DateTime\" language=\"en_US\">\n-    <synopsis>Says a specified time in a custom format.</synopsis>\n+  <application name=\"SpeechDeactivateGrammar\" language=\"en_US\">\n+    <synopsis>Deactivate a grammar.</synopsis>\n     <syntax>\n-      <parameter name=\"unixtime\">\n-        <para>time, in seconds since Jan 1, 1970.  May be negative. Defaults to now.</para>\n-      </parameter>\n-      <parameter name=\"timezone\">\n-        <para>\n-          timezone, see\n-          <filename>/usr/share/zoneinfo</filename>\n-          for a list. Defaults to machine default.\n-        </para>\n-      </parameter>\n-      <parameter name=\"format\">\n-        <para>\n-          a format the time is to be said in.  See\n-          <filename>voicemail.conf</filename>\n-          .\n-\t\t\t\tDefaults to\n-          <literal>ABdY &quot;digits/at&quot; IMp</literal>\n-        </para>\n+      <parameter name=\"grammar_name\" required=\"true\">\n+        <para>The grammar name to deactivate</para>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>Say the date and time in a specified format.</para>\n+      <para>This deactivates the specified grammar so that it is no longer recognized.</para>\n+      <para>Hangs up the channel on failure. If this is not desired, use TryExec.</para>\n     </description>\n   </application>\n-  <module language=\"en_US\" name=\"app_morsecode\">\n-    <support_level>extended</support_level>\n+  <application name=\"SpeechProcessingSound\" language=\"en_US\">\n+    <synopsis>Change background processing sound.</synopsis>\n+    <syntax>\n+      <parameter name=\"sound_file\" required=\"true\"/>\n+    </syntax>\n+    <description>\n+      <para>This changes the processing sound that SpeechBackground plays back when the speech recognition engine is\n+\t\t\tprocessing and working to get results.</para>\n+      <para>Hangs up the channel on failure. If this is not desired, use TryExec.</para>\n+    </description>\n+  </application>\n+  <application name=\"SpeechDestroy\" language=\"en_US\">\n+    <synopsis>End speech recognition.</synopsis>\n+    <syntax/>\n+    <description>\n+      <para>This destroys the information used by all the other speech recognition applications.\n+\t\t\tIf you call this application but end up wanting to recognize more speech, you must call SpeechCreate()\n+\t\t\tagain before calling any other application.</para>\n+      <para>Hangs up the channel on failure. If this is not desired, use TryExec.</para>\n+    </description>\n+  </application>\n+  <application name=\"SpeechLoadGrammar\" language=\"en_US\">\n+    <synopsis>Load a grammar.</synopsis>\n+    <syntax>\n+      <parameter name=\"grammar_name\" required=\"true\"/>\n+      <parameter name=\"path\" required=\"true\"/>\n+    </syntax>\n+    <description>\n+      <para>Load a grammar only on the channel, not globally.</para>\n+      <para>Hangs up the channel on failure. If this is not desired, use TryExec.</para>\n+    </description>\n+  </application>\n+  <application name=\"SpeechUnloadGrammar\" language=\"en_US\">\n+    <synopsis>Unload a grammar.</synopsis>\n+    <syntax>\n+      <parameter name=\"grammar_name\" required=\"true\"/>\n+    </syntax>\n+    <description>\n+      <para>Unload a grammar.</para>\n+      <para>Hangs up the channel on failure. If this is not desired, use TryExec.</para>\n+    </description>\n+  </application>\n+  <function name=\"SPEECH_SCORE\" language=\"en_US\">\n+    <synopsis>Gets the confidence score of a result.</synopsis>\n+    <syntax argsep=\"/\">\n+      <parameter name=\"nbest_number\"/>\n+      <parameter name=\"result_number\" required=\"true\"/>\n+    </syntax>\n+    <description>\n+      <para>Gets the confidence score of a result.</para>\n+    </description>\n+  </function>\n+  <function name=\"SPEECH_TEXT\" language=\"en_US\">\n+    <synopsis>Gets the recognized text of a result.</synopsis>\n+    <syntax argsep=\"/\">\n+      <parameter name=\"nbest_number\"/>\n+      <parameter name=\"result_number\" required=\"true\"/>\n+    </syntax>\n+    <description>\n+      <para>Gets the recognized text of a result.</para>\n+    </description>\n+  </function>\n+  <function name=\"SPEECH_GRAMMAR\" language=\"en_US\">\n+    <synopsis>Gets the matched grammar of a result if available.</synopsis>\n+    <syntax argsep=\"/\">\n+      <parameter name=\"nbest_number\"/>\n+      <parameter name=\"result_number\" required=\"true\"/>\n+    </syntax>\n+    <description>\n+      <para>Gets the matched grammar of a result if available.</para>\n+    </description>\n+  </function>\n+  <function name=\"SPEECH_ENGINE\" language=\"en_US\">\n+    <synopsis>Get or change a speech engine specific attribute.</synopsis>\n+    <syntax>\n+      <parameter name=\"name\" required=\"true\"/>\n+    </syntax>\n+    <description>\n+      <para>Changes a speech engine specific attribute.</para>\n+    </description>\n+  </function>\n+  <function name=\"SPEECH_RESULTS_TYPE\" language=\"en_US\">\n+    <synopsis>Sets the type of results that will be returned.</synopsis>\n+    <syntax/>\n+    <description>\n+      <para>Sets the type of results that will be returned. Valid options are normal or nbest.</para>\n+    </description>\n+  </function>\n+  <function name=\"SPEECH\" language=\"en_US\">\n+    <synopsis>Gets information about speech recognition results.</synopsis>\n+    <syntax>\n+      <parameter name=\"argument\" required=\"true\">\n+        <enumlist>\n+          <enum name=\"status\">\n+            <para>\n+              Returns\n+              <literal>1</literal>\n+              upon speech object existing,\n+\t\t\t\t\t\tor\n+              <literal>0</literal>\n+              if not\n+            </para>\n+          </enum>\n+          <enum name=\"spoke\">\n+            <para>\n+              Returns\n+              <literal>1</literal>\n+              if spoker spoke,\n+\t\t\t\t\t\tor\n+              <literal>0</literal>\n+              if not\n+            </para>\n+          </enum>\n+          <enum name=\"results\">\n+            <para>Returns number of results that were recognized.</para>\n+          </enum>\n+        </enumlist>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>Gets information about speech recognition results.</para>\n+    </description>\n+  </function>\n+  <module language=\"en_US\" name=\"app_confbridge\">\n+    <support_level>core</support_level>\n   </module>\n-  <application name=\"Morsecode\" language=\"en_US\">\n-    <synopsis>Plays morse code.</synopsis>\n+  <application name=\"ConfBridge\" language=\"en_US\">\n+    <synopsis>Conference bridge application.</synopsis>\n     <syntax>\n-      <parameter name=\"string\" required=\"true\">\n-        <para>String to playback as morse code to channel</para>\n+      <parameter name=\"conference\" required=\"true\">\n+        <para>Name of the conference bridge.  You are not limited to just\n+\t\t\t\tnumbers.</para>\n+      </parameter>\n+      <parameter name=\"bridge_profile\">\n+        <para>The bridge profile name from confbridge.conf.  When left blank,\n+\t\t\t\ta dynamically built bridge profile created by the CONFBRIDGE dialplan\n+\t\t\t\tfunction is searched for on the channel and used.  If no dynamic\n+\t\t\t\tprofile is present, the 'default_bridge' profile found in\n+\t\t\t\tconfbridge.conf is used.</para>\n+        <para>It is important to note that while user profiles may be unique\n+\t\t\t\tfor each participant, mixing bridge profiles on a single conference\n+\t\t\t\tis _NOT_ recommended and will produce undefined results.</para>\n+      </parameter>\n+      <parameter name=\"user_profile\">\n+        <para>The user profile name from confbridge.conf.  When left blank,\n+\t\t\t\ta dynamically built user profile created by the CONFBRIDGE dialplan\n+\t\t\t\tfunction is searched for on the channel and used.  If no dynamic\n+\t\t\t\tprofile is present, the 'default_user' profile found in\n+\t\t\t\tconfbridge.conf is used.</para>\n+      </parameter>\n+      <parameter name=\"menu\">\n+        <para>The name of the DTMF menu in confbridge.conf to be applied to\n+\t\t\t\tthis channel.  When left blank, a dynamically built menu profile\n+\t\t\t\tcreated by the CONFBRIDGE dialplan function is searched for on\n+\t\t\t\tthe channel and used. If no dynamic profile is present, the\n+\t\t\t\t'default_menu' profile found in confbridge.conf is used.</para>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>Plays the Morse code equivalent of the passed string.</para>\n-      <para>This application does not automatically answer and should be preceeded by\n-\t\t\tan application such as Answer() or Progress().</para>\n-      <para>This application uses the following variables:</para>\n+      <para>Enters the user into a specified conference bridge.  The user can\n+\t\t\texit the conference by hangup or DTMF menu option.</para>\n+      <para>This application sets the following channel variable upon completion:</para>\n       <variablelist>\n-        <variable name=\"MORSEDITLEN\">\n-          <para>Use this value in (ms) for length of dit</para>\n-        </variable>\n-        <variable name=\"MORSETONE\">\n-          <para>The pitch of the tone in (Hz), default is 800</para>\n-        </variable>\n-        <variable name=\"MORSESPACETONE\">\n-          <para>The pitch of the spaces in (Hz), default is 0</para>\n-        </variable>\n-        <variable name=\"MORSETYPE\">\n-          <para>The code type to use (AMERICAN for standard American Morse\n-\t\t\t\t\tor INTERNATIONAL for international code.\n-\t\t\t\t\tDefault is INTERNATIONAL).</para>\n+        <variable name=\"CONFBRIDGE_RESULT\">\n+          <value name=\"FAILED\">The channel encountered an error and could not enter the conference.</value>\n+          <value name=\"HANGUP\">The channel exited the conference by hanging up.</value>\n+          <value name=\"KICKED\">The channel was kicked from the conference.</value>\n+          <value name=\"ENDMARKED\">The channel left the conference as a result of the last marked user leaving.</value>\n+          <value name=\"DTMF\">The channel pressed a DTMF sequence to exit the conference.</value>\n+          <value name=\"TIMEOUT\">The channel reached its configured timeout.</value>\n         </variable>\n       </variablelist>\n     </description>\n     <see-also>\n-      <ref type=\"application\">SayAlpha</ref>\n-      <ref type=\"application\">SayPhonetic</ref>\n+      <ref type=\"application\">ConfKick</ref>\n+      <ref type=\"function\">CONFBRIDGE</ref>\n+      <ref type=\"function\">CONFBRIDGE_INFO</ref>\n+      <ref type=\"function\">CONFBRIDGE_CHANNELS</ref>\n     </see-also>\n   </application>\n-  <module language=\"en_US\" name=\"app_waitforcond\">\n-    <support_level>extended</support_level>\n-  </module>\n-  <application name=\"WaitForCondition\" language=\"en_US\">\n+  <application name=\"ConfKick\" language=\"en_US\">\n     <since>\n-      <version>16.20.0</version>\n-      <version>18.6.0</version>\n+      <version>16.19.0</version>\n+      <version>18.5.0</version>\n       <version>19.0.0</version>\n     </since>\n-    <synopsis>Wait (sleep) until the given condition is true.</synopsis>\n+    <synopsis>Kicks channel(s) from the requested ConfBridge.</synopsis>\n     <syntax>\n-      <parameter name=\"replacementchar\" required=\"true\">\n-        <para>\n-          Specifies the character in the expression used to replace the\n-          <literal>$</literal>\n-          character. This character should not be used anywhere in the expression itself.\n-        </para>\n-      </parameter>\n-      <parameter name=\"expression\" required=\"true\">\n+      <parameter name=\"conference\" required=\"true\"/>\n+      <parameter name=\"channel\">\n         <para>\n-          A modified logical expression with the\n-          <literal>$</literal>\n-          characters replaced by\n-          <replaceable>replacementchar</replaceable>\n-          . This is necessary to pass the expression itself\n-\t\t\t\tinto the application, rather than its initial evaluation.\n+          The channel to kick,\n+          <literal>all</literal>\n+          to kick all users, or\n+          <literal>participants</literal>\n+          to kick all non-admin participants. Default is all.\n         </para>\n       </parameter>\n-      <parameter name=\"timeout\">\n-        <para>The maximum amount of time, in seconds, this application should wait for a condition\n-\t\t\t\tto become true before dialplan execution continues automatically to the next priority.\n-\t\t\t\tBy default, there is no timeout.</para>\n-      </parameter>\n-      <parameter name=\"interval\">\n-        <para>The frequency, in seconds, of polling the condition, which can be adjusted depending\n-\t\t\t\ton how time-sensitive execution needs to be. By default, this is 0.05.</para>\n-      </parameter>\n     </syntax>\n     <description>\n-      <para>\n-        Waits until\n-        <replaceable>expression</replaceable>\n-        evaluates to true, checking every\n-        <replaceable>interval</replaceable>\n-        seconds for up to\n-        <replaceable>timeout</replaceable>\n-        . Default\n-\t\t\tis evaluate\n-        <replaceable>expression</replaceable>\n-        every 50 milliseconds with no timeout.\n-      </para>\n-      <example title=\"Wait for condition dialplan variable/function to become 1 for up to 40 seconds, checking every 500ms\">same =&gt; n,WaitForCondition(#,#[&quot;#{condition}&quot;=&quot;1&quot;],40,0.5)</example>\n-      <para>\n-        Sets\n-        <variable>WAITFORCONDITIONSTATUS</variable>\n-        to one of the following values:\n-      </para>\n+      <para>Kicks the requested channel(s) from a conference bridge.</para>\n       <variablelist>\n-        <variable name=\"WAITFORCONDITIONSTATUS\">\n-          <value name=\"TRUE\">Condition evaluated to true before timeout expired.</value>\n-          <value name=\"FAILURE\">Invalid argument.</value>\n-          <value name=\"TIMEOUT\">Timeout elapsed without condition evaluating to true.</value>\n-          <value name=\"HANGUP\">Channel hung up before condition became true.</value>\n+        <variable name=\"CONFKICKSTATUS\">\n+          <value name=\"FAILURE\">Could not kick any users with the provided arguments.</value>\n+          <value name=\"SUCCESS\">Successfully kicked users from specified conference bridge.</value>\n         </variable>\n       </variablelist>\n     </description>\n+    <see-also>\n+      <ref type=\"application\">ConfBridge</ref>\n+      <ref type=\"function\">CONFBRIDGE</ref>\n+      <ref type=\"function\">CONFBRIDGE_INFO</ref>\n+      <ref type=\"function\">CONFBRIDGE_CHANNELS</ref>\n+    </see-also>\n   </application>\n-  <module language=\"en_US\" name=\"app_directed_pickup\">\n-    <support_level>core</support_level>\n-  </module>\n-  <application name=\"Pickup\" language=\"en_US\">\n-    <synopsis>Directed extension call pickup.</synopsis>\n+  <function name=\"CONFBRIDGE\" language=\"en_US\">\n+    <synopsis>Set a custom dynamic bridge, user, or menu profile on a channel for the\n+\t\t\tConfBridge application using the same options available in confbridge.conf.</synopsis>\n     <syntax>\n-      <parameter name=\"targets\" argsep=\"&amp;\">\n-        <argument name=\"extension\" argsep=\"@\" required=\"true\">\n-          <para>Specification of the pickup target.</para>\n-          <argument name=\"extension\" required=\"true\"/>\n-          <argument name=\"context\"/>\n-        </argument>\n-        <argument name=\"extension2\" argsep=\"@\" multiple=\"true\">\n-          <para>Additional specifications of pickup targets.</para>\n-          <argument name=\"extension2\" required=\"true\"/>\n-          <argument name=\"context2\"/>\n-        </argument>\n+      <parameter name=\"type\" required=\"true\">\n+        <para>To what type of conference profile the option applies.</para>\n+        <enumlist>\n+          <enum name=\"bridge\"/>\n+          <enum name=\"menu\"/>\n+          <enum name=\"user\"/>\n+        </enumlist>\n+      </parameter>\n+      <parameter name=\"option\" required=\"true\">\n+        <para>\n+          Option refers to a\n+          <filename>confbridge.conf</filename>\n+          option\n+\t\t\t\tthat is being set dynamically on this channel, or\n+          <literal>clear</literal>\n+          to remove already applied profile options from the channel.\n+        </para>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>This application can pickup a specified ringing channel.  The channel\n-\t\t\tto pickup can be specified in the following ways.</para>\n       <para>\n-        1) If no\n-        <replaceable>extension</replaceable>\n-        targets are specified,\n-\t\t\tthe application will pickup a channel matching the pickup group of the\n-\t\t\trequesting channel.\n+        A custom profile uses the default profile type settings defined in\n+        <filename>confbridge.conf</filename>\n+        as defaults if the profile template\n+\t\t\tis not explicitly specified first.\n       </para>\n       <para>\n-        2) If the\n-        <replaceable>extension</replaceable>\n-        is specified with a\n-        <replaceable>context</replaceable>\n-        of the special string\n-        <literal>PICKUPMARK</literal>\n-        (for example 10@PICKUPMARK), the application\n-\t\t\twill pickup a channel which has defined the channel variable\n-        <variable>PICKUPMARK</variable>\n-        with the same value as\n-        <replaceable>extension</replaceable>\n-        (in this example,\n-        <literal>10</literal>\n-        ).\n+        For\n+        <literal>bridge</literal>\n+        profiles the default template is\n+        <literal>default_bridge</literal>\n+        .\n       </para>\n       <para>\n-        3) If the\n-        <replaceable>extension</replaceable>\n-        is specified\n-\t\t\twith or without a\n-        <replaceable>context</replaceable>\n-        , the channel with a\n-\t\t\tmatching\n-        <replaceable>extension</replaceable>\n-        and\n-        <replaceable>context</replaceable>\n-        will be picked up.  If no\n-        <replaceable>context</replaceable>\n-        is specified,\n-\t\t\tthe current context will be used.\n+        For\n+        <literal>menu</literal>\n+        profiles the default template is\n+        <literal>default_menu</literal>\n+        .\n       </para>\n-      <note>\n-        <para>\n-          The\n-          <replaceable>extension</replaceable>\n-          is typically set on\n-\t\t\tmatching channels by the dial application that created the channel.  The\n-          <replaceable>context</replaceable>\n-          is set on matching channels by the\n-\t\t\tchannel driver for the device.\n-        </para>\n-      </note>\n-    </description>\n-  </application>\n-  <application name=\"PickupChan\" language=\"en_US\">\n-    <synopsis>Pickup a ringing channel.</synopsis>\n-    <syntax>\n-      <parameter name=\"channel\" argsep=\"&amp;\" required=\"true\">\n-        <argument name=\"channel\" required=\"true\"/>\n-        <argument name=\"channel2\" required=\"false\" multiple=\"true\"/>\n-        <para>\n-          List of channel names or channel uniqueids to pickup if ringing.\n-\t\t\t\t\tFor example, a channel name could be\n-          <literal>SIP/bob</literal>\n-          or\n-          <literal>SIP/bob-00000000</literal>\n-          to find\n-          <literal>SIP/bob-00000000</literal>\n-          .\n-        </para>\n-      </parameter>\n-      <parameter name=\"options\" required=\"false\">\n-        <optionlist>\n-          <option name=\"p\">\n-            <para>\n-              Supplied channel names are prefixes.  For example,\n-              <literal>SIP/bob</literal>\n-              will match\n-              <literal>SIP/bob-00000000</literal>\n-              and\n-              <literal>SIP/bobby-00000000</literal>\n-              .\n-            </para>\n-          </option>\n-        </optionlist>\n-      </parameter>\n-    </syntax>\n-    <description>\n       <para>\n-        Pickup a specified\n-        <replaceable>channel</replaceable>\n-        if ringing.\n+        For\n+        <literal>user</literal>\n+        profiles the default template is\n+        <literal>default_user</literal>\n+        .\n       </para>\n-    </description>\n-  </application>\n-  <module language=\"en_US\" name=\"app_voicemail_odbcstorage\">\n-    <depend>unixodbc</depend>\n-    <use type=\"module\">res_adsi</use>\n-    <use type=\"module\">res_smdi</use>\n-    <defaultenabled>yes</defaultenabled>\n-    <support_level>core</support_level>\n-  </module>\n-  <application name=\"VoiceMail\" language=\"en_US\">\n-    <synopsis>Leave a Voicemail message.</synopsis>\n-    <syntax>\n-      <parameter name=\"mailboxs\" argsep=\"&amp;\" required=\"true\">\n-        <argument name=\"mailbox1\" argsep=\"@\" required=\"true\">\n-          <argument name=\"mailbox\" required=\"true\"/>\n-          <argument name=\"context\"/>\n+      <para>---- Example 1 ----</para>\n+      <para>In this example the custom user profile set on the channel will\n+\t\t\tautomatically be used by the ConfBridge application.</para>\n+      <example title=\"Example 1\">exten =&gt; 1,1,Answer()</example>\n+      <para>; In this example the effect of the following line is</para>\n+      <para>; implied:</para>\n+      <example title=\"Example 1b\">same =&gt; n,Set(CONFBRIDGE(user,template)=default_user)\n+\t\t\tsame =&gt; n,Set(CONFBRIDGE(user,announce_join_leave)=yes)\n+\t\t\tsame =&gt; n,Set(CONFBRIDGE(user,startmuted)=yes)\n+\t\t\tsame =&gt; n,ConfBridge(1)</example>\n+      <para>---- Example 2 ----</para>\n+      <para>\n+        This example shows how to use a predefined user profile in\n+        <filename>confbridge.conf</filename>\n+        as a template for a dynamic profile.\n+\t\t\tHere we make an admin/marked user out of the\n+        <literal>my_user</literal>\n+        profile that you define in\n+        <filename>confbridge.conf</filename>\n+        .\n+      </para>\n+      <example title=\"Example 2\">exten =&gt; 1,1,Answer()\n+\t\t\tsame =&gt; n,Set(CONFBRIDGE(user,template)=my_user)\n+\t\t\tsame =&gt; n,Set(CONFBRIDGE(user,admin)=yes)\n+\t\t\tsame =&gt; n,Set(CONFBRIDGE(user,marked)=yes)\n+\t\t\tsame =&gt; n,ConfBridge(1)</example>\n+    </description>\n+  </function>\n+  <function name=\"CONFBRIDGE_INFO\" language=\"en_US\">\n+    <synopsis>Get information about a ConfBridge conference.</synopsis>\n+    <syntax>\n+      <parameter name=\"type\" required=\"true\">\n+        <para>What conference information is requested.</para>\n+        <enumlist>\n+          <enum name=\"admins\">\n+            <para>Get the number of admin users in the conference.</para>\n+          </enum>\n+          <enum name=\"locked\">\n+            <para>Determine if the conference is locked. (0 or 1)</para>\n+          </enum>\n+          <enum name=\"marked\">\n+            <para>Get the number of marked users in the conference.</para>\n+          </enum>\n+          <enum name=\"muted\">\n+            <para>Determine if the conference is muted. (0 or 1)</para>\n+          </enum>\n+          <enum name=\"parties\">\n+            <para>Get the number of users in the conference.</para>\n+          </enum>\n+        </enumlist>\n+      </parameter>\n+      <parameter name=\"conf\" required=\"true\">\n+        <para>The name of the conference being referenced.</para>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>This function returns a non-negative integer for valid conference\n+\t\t\tnames and an empty string for invalid conference names.</para>\n+    </description>\n+    <see-also>\n+      <ref type=\"function\">CONFBRIDGE_CHANNELS</ref>\n+    </see-also>\n+  </function>\n+  <function name=\"CONFBRIDGE_CHANNELS\" language=\"en_US\">\n+    <since>\n+      <version>16.26.0</version>\n+      <version>18.12.0</version>\n+      <version>19.4.0</version>\n+    </since>\n+    <synopsis>Get a list of channels in a ConfBridge conference.</synopsis>\n+    <syntax>\n+      <parameter name=\"type\" required=\"true\">\n+        <para>What conference information is requested.</para>\n+        <enumlist>\n+          <enum name=\"admins\">\n+            <para>Get the number of admin users in the conference.</para>\n+          </enum>\n+          <enum name=\"marked\">\n+            <para>Get the number of marked users in the conference.</para>\n+          </enum>\n+          <enum name=\"parties\">\n+            <para>Get the number of total users in the conference.</para>\n+          </enum>\n+          <enum name=\"active\">\n+            <para>Get the number of active users in the conference.</para>\n+          </enum>\n+          <enum name=\"waiting\">\n+            <para>Get the number of waiting users in the conference.</para>\n+          </enum>\n+        </enumlist>\n+      </parameter>\n+      <parameter name=\"conf\" required=\"true\">\n+        <para>The name of the conference being referenced.</para>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>This function returns a comma-separated list of channels in a ConfBridge conference, optionally filtered by a type of participant.</para>\n+    </description>\n+    <see-also>\n+      <ref type=\"function\">CONFBRIDGE_INFO</ref>\n+    </see-also>\n+  </function>\n+  <manager name=\"ConfbridgeList\" language=\"en_US\">\n+    <synopsis>List participants in a conference.</synopsis>\n+    <syntax>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      <parameter name=\"Conference\" required=\"true\">\n+        <para>Conference number.</para>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>Lists all users in a particular ConfBridge conference.\n+\t\t\tConfbridgeList will follow as separate events, followed by a final event called\n+\t\t\tConfbridgeListComplete.</para>\n+    </description>\n+  </manager>\n+  <managerEvent language=\"en_US\" name=\"ConfbridgeList\">\n+    <managerEventInstance class=\"EVENT_FLAG_REPORTING\">\n+      <synopsis>Raised as part of the ConfbridgeList action response list.</synopsis>\n+      <syntax>\n+        <parameter name=\"Conference\">\n+          <para>The name of the Confbridge conference.</para>\n+        </parameter>\n+        <parameter name=\"Admin\">\n+          <para>Identifies this user as an admin user.</para>\n+          <enumlist>\n+            <enum name=\"Yes\"/>\n+            <enum name=\"No\"/>\n+          </enumlist>\n+        </parameter>\n+        <parameter name=\"MarkedUser\">\n+          <para>Identifies this user as a marked user.</para>\n+          <enumlist>\n+            <enum name=\"Yes\"/>\n+            <enum name=\"No\"/>\n+          </enumlist>\n+        </parameter>\n+        <parameter name=\"WaitMarked\">\n+          <para>Must this user wait for a marked user to join?</para>\n+          <enumlist>\n+            <enum name=\"Yes\"/>\n+            <enum name=\"No\"/>\n+          </enumlist>\n+        </parameter>\n+        <parameter name=\"EndMarked\">\n+          <para>Does this user get kicked after the last marked user leaves?</para>\n+          <enumlist>\n+            <enum name=\"Yes\"/>\n+            <enum name=\"No\"/>\n+          </enumlist>\n+        </parameter>\n+        <parameter name=\"Waiting\">\n+          <para>Is this user waiting for a marked user to join?</para>\n+          <enumlist>\n+            <enum name=\"Yes\"/>\n+            <enum name=\"No\"/>\n+          </enumlist>\n+        </parameter>\n+        <parameter name=\"Muted\">\n+          <para>The current mute status.</para>\n+          <enumlist>\n+            <enum name=\"Yes\"/>\n+            <enum name=\"No\"/>\n+          </enumlist>\n+        </parameter>\n+        <parameter name=\"Talking\">\n+          <para>Is this user talking?</para>\n+          <enumlist>\n+            <enum name=\"Yes\"/>\n+            <enum name=\"No\"/>\n+          </enumlist>\n+        </parameter>\n+        <parameter name=\"AnsweredTime\">\n+          <para>The number of seconds the channel has been up.</para>\n+        </parameter>\n+        <channel_snapshot/>\n+      </syntax>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <manager name=\"ConfbridgeListRooms\" language=\"en_US\">\n+    <synopsis>List active conferences.</synopsis>\n+    <syntax>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+    </syntax>\n+    <description>\n+      <para>Lists data about all active conferences.\n+\t\t\t\tConfbridgeListRooms will follow as separate events, followed by a final event called\n+\t\t\t\tConfbridgeListRoomsComplete.</para>\n+    </description>\n+  </manager>\n+  <manager name=\"ConfbridgeMute\" language=\"en_US\">\n+    <synopsis>Mute a Confbridge user.</synopsis>\n+    <syntax>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      <parameter name=\"Conference\" required=\"true\"/>\n+      <parameter name=\"Channel\" required=\"true\">\n+        <para>If this parameter is not a complete channel name, the first channel with this prefix will be used.</para>\n+        <para>If this parameter is &quot;all&quot;, all channels will be muted.</para>\n+        <para>If this parameter is &quot;participants&quot;, all non-admin channels will be muted.</para>\n+      </parameter>\n+    </syntax>\n+    <description/>\n+  </manager>\n+  <manager name=\"ConfbridgeUnmute\" language=\"en_US\">\n+    <synopsis>Unmute a Confbridge user.</synopsis>\n+    <syntax>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      <parameter name=\"Conference\" required=\"true\"/>\n+      <parameter name=\"Channel\" required=\"true\">\n+        <para>If this parameter is not a complete channel name, the first channel with this prefix will be used.</para>\n+        <para>If this parameter is &quot;all&quot;, all channels will be unmuted.</para>\n+        <para>If this parameter is &quot;participants&quot;, all non-admin channels will be unmuted.</para>\n+      </parameter>\n+    </syntax>\n+    <description/>\n+  </manager>\n+  <manager name=\"ConfbridgeKick\" language=\"en_US\">\n+    <synopsis>Kick a Confbridge user.</synopsis>\n+    <syntax>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      <parameter name=\"Conference\" required=\"true\"/>\n+      <parameter name=\"Channel\" required=\"true\">\n+        <para>If this parameter is &quot;all&quot;, all channels will be kicked from the conference.</para>\n+        <para>If this parameter is &quot;participants&quot;, all non-admin channels will be kicked from the conference.</para>\n+      </parameter>\n+    </syntax>\n+    <description/>\n+  </manager>\n+  <manager name=\"ConfbridgeLock\" language=\"en_US\">\n+    <synopsis>Lock a Confbridge conference.</synopsis>\n+    <syntax>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      <parameter name=\"Conference\" required=\"true\"/>\n+    </syntax>\n+    <description/>\n+  </manager>\n+  <manager name=\"ConfbridgeUnlock\" language=\"en_US\">\n+    <synopsis>Unlock a Confbridge conference.</synopsis>\n+    <syntax>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      <parameter name=\"Conference\" required=\"true\"/>\n+    </syntax>\n+    <description/>\n+  </manager>\n+  <manager name=\"ConfbridgeStartRecord\" language=\"en_US\">\n+    <synopsis>Start recording a Confbridge conference.</synopsis>\n+    <syntax>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      <parameter name=\"Conference\" required=\"true\"/>\n+      <parameter name=\"RecordFile\" required=\"false\"/>\n+    </syntax>\n+    <description>\n+      <para>Start recording a conference. If recording is already present an error will be returned. If RecordFile is not provided, the default record file specified in the conference's bridge profile will be used, if that is not present either a file will automatically be generated in the monitor directory.</para>\n+    </description>\n+  </manager>\n+  <manager name=\"ConfbridgeStopRecord\" language=\"en_US\">\n+    <synopsis>Stop recording a Confbridge conference.</synopsis>\n+    <syntax>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      <parameter name=\"Conference\" required=\"true\"/>\n+    </syntax>\n+    <description/>\n+  </manager>\n+  <manager name=\"ConfbridgeSetSingleVideoSrc\" language=\"en_US\">\n+    <synopsis>Set a conference user as the single video source distributed to all other participants.</synopsis>\n+    <syntax>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      <parameter name=\"Conference\" required=\"true\"/>\n+      <parameter name=\"Channel\" required=\"true\">\n+        <para>If this parameter is not a complete channel name, the first channel with this prefix will be used.</para>\n+      </parameter>\n+    </syntax>\n+    <description/>\n+  </manager>\n+  <module language=\"en_US\" name=\"app_dumpchan\">\n+    <support_level>core</support_level>\n+  </module>\n+  <application name=\"DumpChan\" language=\"en_US\">\n+    <synopsis>Dump Info About The Calling Channel.</synopsis>\n+    <syntax>\n+      <parameter name=\"level\">\n+        <para>Minimum verbose level</para>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>\n+        Displays information on channel and listing of all channel\n+\t\t\tvariables. If\n+        <replaceable>level</replaceable>\n+        is specified, output is only\n+\t\t\tdisplayed when the verbose level is currently set to that number\n+\t\t\tor greater.\n+      </para>\n+    </description>\n+    <see-also>\n+      <ref type=\"application\">NoOp</ref>\n+      <ref type=\"application\">Verbose</ref>\n+    </see-also>\n+  </application>\n+  <module language=\"en_US\" name=\"app_senddtmf\">\n+    <support_level>core</support_level>\n+  </module>\n+  <application name=\"SendDTMF\" language=\"en_US\">\n+    <synopsis>Sends arbitrary DTMF digits</synopsis>\n+    <syntax>\n+      <parameter name=\"digits\" required=\"true\">\n+        <para>List of digits 0-9,*#,a-d,A-D to send also w for a half second pause,\n+\t\t\t\tW for a one second pause, and f or F for a flash-hook if the channel supports\n+\t\t\t\tflash-hook.</para>\n+      </parameter>\n+      <parameter name=\"timeout_ms\" required=\"false\">\n+        <para>Amount of time to wait in ms between tones. (defaults to .25s)</para>\n+      </parameter>\n+      <parameter name=\"duration_ms\" required=\"false\">\n+        <para>Duration of each digit</para>\n+      </parameter>\n+      <parameter name=\"channel\" required=\"false\">\n+        <para>Channel where digits will be played</para>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>It will send all digits or terminate if it encounters an error.</para>\n+    </description>\n+    <see-also>\n+      <ref type=\"application\">Read</ref>\n+    </see-also>\n+  </application>\n+  <manager name=\"PlayDTMF\" language=\"en_US\">\n+    <synopsis>Play DTMF signal on a specific channel.</synopsis>\n+    <syntax>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      <parameter name=\"Channel\" required=\"true\">\n+        <para>Channel name to send digit to.</para>\n+      </parameter>\n+      <parameter name=\"Digit\" required=\"true\">\n+        <para>The DTMF digit to play.</para>\n+      </parameter>\n+      <parameter name=\"Duration\" required=\"false\">\n+        <para>The duration, in milliseconds, of the digit to be played.</para>\n+      </parameter>\n+      <parameter name=\"Receive\" required=\"false\">\n+        <para>Emulate receiving DTMF on this channel instead of sending it out.</para>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>Plays a dtmf digit on the specified channel.</para>\n+    </description>\n+  </manager>\n+  <module language=\"en_US\" name=\"app_softhangup\">\n+    <support_level>core</support_level>\n+  </module>\n+  <application name=\"SoftHangup\" language=\"en_US\">\n+    <synopsis>Hangs up the requested channel.</synopsis>\n+    <syntax>\n+      <parameter name=\"Technology/Resource\" required=\"true\"/>\n+      <parameter name=\"options\">\n+        <optionlist>\n+          <option name=\"a\">\n+            <para>Hang up all channels on a specified device instead of a single resource</para>\n+          </option>\n+        </optionlist>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>Hangs up the requested channel.  If there are no channels to\n+\t\t\thangup, the application will report it.</para>\n+    </description>\n+  </application>\n+  <module language=\"en_US\" name=\"app_stasis\">\n+    <depend>res_stasis</depend>\n+    <support_level>core</support_level>\n+  </module>\n+  <application name=\"Stasis\" language=\"en_US\">\n+    <synopsis>Invoke an external Stasis application.</synopsis>\n+    <syntax>\n+      <parameter name=\"app_name\" required=\"true\">\n+        <para>Name of the application to invoke.</para>\n+      </parameter>\n+      <parameter name=\"args\">\n+        <para>Optional comma-delimited arguments for the\n+\t\t\t\tapplication invocation.</para>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>Invoke a Stasis application.</para>\n+      <para>This application will set the following channel variable upon\n+\t\t\tcompletion:</para>\n+      <variablelist>\n+        <variable name=\"STASISSTATUS\">\n+          <para>This indicates the status of the execution of the\n+\t\t\t\t\tStasis application.</para>\n+          <value name=\"SUCCESS\">The channel has exited Stasis without any failures in\n+\t\t\t\t\t\tStasis.</value>\n+          <value name=\"FAILED\">A failure occurred when executing the Stasis\n+\t\t\t\t\t\tThe app registry is not instantiated; The app\n+\t\t\t\t\t\tapplication. Some (not all) possible reasons for this:\n+\t\t\t\t\t\trequested is not registered; The app requested is not\n+\t\t\t\t\t\tactive; Stasis couldn't send a start message.</value>\n+        </variable>\n+      </variablelist>\n+    </description>\n+  </application>\n+  <module language=\"en_US\" name=\"app_zapateller\">\n+    <support_level>extended</support_level>\n+  </module>\n+  <application name=\"Zapateller\" language=\"en_US\">\n+    <synopsis>Block telemarketers with SIT.</synopsis>\n+    <syntax>\n+      <parameter name=\"options\" required=\"true\">\n+        <para>Comma delimited list of options.</para>\n+        <optionlist>\n+          <option name=\"answer\">\n+            <para>Causes the line to be answered before playing the tone.</para>\n+          </option>\n+          <option name=\"nocallerid\">\n+            <para>Causes Zapateller to only play the tone if there is no\n+\t\t\t\t\t\tcallerid information available.</para>\n+          </option>\n+        </optionlist>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>Generates special information tone to block telemarketers from calling you.</para>\n+      <para>This application will set the following channel variable upon completion:</para>\n+      <variablelist>\n+        <variable name=\"ZAPATELLERSTATUS\">\n+          <para>This will contain the last action accomplished by the\n+\t\t\t\t\tZapateller application. Possible values include:</para>\n+          <value name=\"NOTHING\"/>\n+          <value name=\"ANSWERED\"/>\n+          <value name=\"ZAPPED\"/>\n+        </variable>\n+      </variablelist>\n+    </description>\n+  </application>\n+  <module language=\"en_US\" name=\"app_dtmfstore\">\n+    <support_level>extended</support_level>\n+  </module>\n+  <application name=\"StoreDTMF\" language=\"en_US\">\n+    <since>\n+      <version>16.20.0</version>\n+      <version>18.6.0</version>\n+      <version>19.0.0</version>\n+    </since>\n+    <synopsis>Stores DTMF digits transmitted or received on a channel.</synopsis>\n+    <syntax>\n+      <parameter name=\"direction\" required=\"true\">\n+        <para>\n+          Must be\n+          <literal>TX</literal>\n+          or\n+          <literal>RX</literal>\n+          to\n+\t\t\t\tstore digits, or\n+          <literal>remove</literal>\n+          to disable.\n+        </para>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>\n+        The StoreDTMF function can be used to obtain digits sent in the\n+        <literal>TX</literal>\n+        or\n+        <literal>RX</literal>\n+        direction of any channel.\n+      </para>\n+      <para>The arguments are:</para>\n+      <para>\n+        <replaceable>var_name</replaceable>\n+        : Name of variable to which to append\n+\t\t\tdigits.\n+      </para>\n+      <para>\n+        <replaceable>max_digits</replaceable>\n+        : The maximum number of digits to\n+\t\t\tstore in the variable. Defaults to 0 (no maximum). After reading\n+        <literal>maximum</literal>\n+        digits, no more digits will be stored.\n+      </para>\n+      <example title=\"Store digits in CDR variable\">same =&gt; n,StoreDTMF(TX,CDR(digits))</example>\n+      <example title=\"Store up to 24 digits\">same =&gt; n,StoreDTMF(RX,testvar,24)</example>\n+      <example title=\"Disable digit collection\">same =&gt; n,StoreDTMF(remove)</example>\n+    </description>\n+  </application>\n+  <module language=\"en_US\" name=\"app_waitforsilence\">\n+    <support_level>extended</support_level>\n+  </module>\n+  <application name=\"WaitForSilence\" language=\"en_US\">\n+    <synopsis>Waits for a specified amount of silence.</synopsis>\n+    <syntax>\n+      <parameter name=\"silencerequired\">\n+        <para>\n+          If not specified, defaults to\n+          <literal>1000</literal>\n+          milliseconds.\n+        </para>\n+      </parameter>\n+      <parameter name=\"iterations\">\n+        <para>\n+          If not specified, defaults to\n+          <literal>1</literal>\n+          .\n+        </para>\n+      </parameter>\n+      <parameter name=\"timeout\">\n+        <para>Is specified only to avoid an infinite loop in cases where silence is never achieved.</para>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>\n+        Waits for up to\n+        <replaceable>silencerequired</replaceable>\n+        milliseconds of silence,\n+        <replaceable>iterations</replaceable>\n+        times. An optional\n+        <replaceable>timeout</replaceable>\n+        specified the number of seconds to return after, even if we do not receive the specified amount of silence.\n+\t\t\tUse\n+        <replaceable>timeout</replaceable>\n+        with caution, as it may defeat the purpose of this application, which\n+\t\t\tis to wait indefinitely until silence is detected on the line. This is particularly useful for reverse-911-type\n+\t\t\tcall broadcast applications where you need to wait for an answering machine to complete its spiel before\n+\t\t\tplaying a message.\n+      </para>\n+      <para>Typically you will want to include two or more calls to WaitForSilence when dealing with an answering\n+\t\t\tmachine; first waiting for the spiel to finish, then waiting for the beep, etc.</para>\n+      <example title=\"Wait for half a second of silence, twice\">same =&gt; n,WaitForSilence(500,2)</example>\n+      <example title=\"Wait for one second of silence, once\">same =&gt; n,WaitForSilence(1000)</example>\n+      <example title=\"Wait for 300 ms of silence, 3 times, and returns after 10 seconds, even if no silence detected\">same =&gt; n,WaitForSilence(300,3,10)</example>\n+      <para>\n+        Sets the channel variable\n+        <variable>WAITSTATUS</variable>\n+        to one of these values:\n+      </para>\n+      <variablelist>\n+        <variable name=\"WAITSTATUS\">\n+          <value name=\"SILENCE\">if exited with silence detected.</value>\n+          <value name=\"TIMEOUT\">if exited without silence detected after timeout.</value>\n+        </variable>\n+      </variablelist>\n+    </description>\n+    <see-also>\n+      <ref type=\"application\">WaitForNoise</ref>\n+    </see-also>\n+  </application>\n+  <application name=\"WaitForNoise\" language=\"en_US\">\n+    <synopsis>Waits for a specified amount of noise.</synopsis>\n+    <syntax>\n+      <parameter name=\"noiserequired\">\n+        <para>\n+          If not specified, defaults to\n+          <literal>1000</literal>\n+          milliseconds.\n+        </para>\n+      </parameter>\n+      <parameter name=\"iterations\">\n+        <para>\n+          If not specified, defaults to\n+          <literal>1</literal>\n+          .\n+        </para>\n+      </parameter>\n+      <parameter name=\"timeout\">\n+        <para>Is specified only to avoid an infinite loop in cases where silence is never achieved.</para>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>\n+        Waits for up to\n+        <replaceable>noiserequired</replaceable>\n+        milliseconds of noise,\n+        <replaceable>iterations</replaceable>\n+        times. An optional\n+        <replaceable>timeout</replaceable>\n+        specified the number of seconds to return after, even if we do not receive the specified amount of noise.\n+\t\t\tUse\n+        <replaceable>timeout</replaceable>\n+        with caution, as it may defeat the purpose of this application, which\n+\t\t\tis to wait indefinitely until noise is detected on the line.\n+      </para>\n+    </description>\n+    <see-also>\n+      <ref type=\"application\">WaitForSilence</ref>\n+    </see-also>\n+  </application>\n+  <module language=\"en_US\" name=\"app_system\">\n+    <support_level>core</support_level>\n+  </module>\n+  <application name=\"System\" language=\"en_US\">\n+    <synopsis>Execute a system command.</synopsis>\n+    <syntax>\n+      <parameter name=\"command\" required=\"true\">\n+        <para>Command to execute</para>\n+        <warning>\n+          <para>\n+            Do not use untrusted strings such as\n+            <variable>CALLERID(num)</variable>\n+            or\n+            <variable>CALLERID(name)</variable>\n+            as part of the command parameters.  You\n+\t\t\t\trisk a command injection attack executing arbitrary commands if the untrusted\n+\t\t\t\tstrings aren't filtered to remove dangerous characters.  See function\n+            <variable>FILTER()</variable>\n+            .\n+          </para>\n+        </warning>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>Executes a command  by  using  system(). If the command\n+\t\t\tfails, the console should report a fallthrough.</para>\n+      <para>\n+        Result of execution is returned in the\n+        <variable>SYSTEMSTATUS</variable>\n+        channel variable:\n+      </para>\n+      <variablelist>\n+        <variable name=\"SYSTEMSTATUS\">\n+          <value name=\"FAILURE\">Could not execute the specified command.</value>\n+          <value name=\"SUCCESS\">Specified command successfully executed.</value>\n+        </variable>\n+      </variablelist>\n+    </description>\n+  </application>\n+  <application name=\"TrySystem\" language=\"en_US\">\n+    <synopsis>Try executing a system command.</synopsis>\n+    <syntax>\n+      <parameter name=\"command\" required=\"true\">\n+        <para>Command to execute</para>\n+        <warning>\n+          <para>\n+            Do not use untrusted strings such as\n+            <variable>CALLERID(num)</variable>\n+            or\n+            <variable>CALLERID(name)</variable>\n+            as part of the command parameters.  You\n+\t\t\t\trisk a command injection attack executing arbitrary commands if the untrusted\n+\t\t\t\tstrings aren't filtered to remove dangerous characters.  See function\n+            <variable>FILTER()</variable>\n+            .\n+          </para>\n+        </warning>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>Executes a command  by  using  system().</para>\n+      <para>\n+        Result of execution is returned in the\n+        <variable>SYSTEMSTATUS</variable>\n+        channel variable:\n+      </para>\n+      <variablelist>\n+        <variable name=\"SYSTEMSTATUS\">\n+          <value name=\"FAILURE\">Could not execute the specified command.</value>\n+          <value name=\"SUCCESS\">Specified command successfully executed.</value>\n+          <value name=\"APPERROR\">Specified command successfully executed, but returned error code.</value>\n+        </variable>\n+      </variablelist>\n+    </description>\n+  </application>\n+  <module language=\"en_US\" name=\"conf_state_single_marked\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"conf_state_multi_marked\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"conf_state_multi\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"conf_state\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"conf_state_inactive\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"conf_state_empty\">\n+    <support_level>core</support_level>\n+  </module>\n+  <managerEvent language=\"en_US\" name=\"ConfbridgeStart\">\n+    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n+      <synopsis>Raised when a conference starts.</synopsis>\n+      <syntax>\n+        <parameter name=\"Conference\">\n+          <para>The name of the Confbridge conference.</para>\n+        </parameter>\n+        <bridge_snapshot/>\n+      </syntax>\n+      <see-also>\n+        <ref type=\"managerEvent\">ConfbridgeEnd</ref>\n+        <ref type=\"application\">ConfBridge</ref>\n+      </see-also>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <managerEvent language=\"en_US\" name=\"ConfbridgeEnd\">\n+    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n+      <synopsis>Raised when a conference ends.</synopsis>\n+      <syntax>\n+        <parameter name=\"Conference\">\n+          <para>The name of the Confbridge conference.</para>\n+        </parameter>\n+        <bridge_snapshot/>\n+      </syntax>\n+      <see-also>\n+        <ref type=\"managerEvent\">ConfbridgeStart</ref>\n+        <ref type=\"application\">ConfBridge</ref>\n+      </see-also>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <managerEvent language=\"en_US\" name=\"ConfbridgeJoin\">\n+    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n+      <synopsis>Raised when a channel joins a Confbridge conference.</synopsis>\n+      <syntax>\n+        <parameter name=\"Conference\">\n+          <para>The name of the Confbridge conference.</para>\n+        </parameter>\n+        <bridge_snapshot/>\n+        <channel_snapshot/>\n+        <parameter name=\"Admin\">\n+          <para>Identifies this user as an admin user.</para>\n+          <enumlist>\n+            <enum name=\"Yes\"/>\n+            <enum name=\"No\"/>\n+          </enumlist>\n+        </parameter>\n+        <parameter name=\"Muted\">\n+          <para>The joining mute status.</para>\n+          <enumlist>\n+            <enum name=\"Yes\"/>\n+            <enum name=\"No\"/>\n+          </enumlist>\n+        </parameter>\n+      </syntax>\n+      <see-also>\n+        <ref type=\"managerEvent\">ConfbridgeLeave</ref>\n+        <ref type=\"application\">ConfBridge</ref>\n+      </see-also>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <managerEvent language=\"en_US\" name=\"ConfbridgeLeave\">\n+    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n+      <synopsis>Raised when a channel leaves a Confbridge conference.</synopsis>\n+      <syntax>\n+        <parameter name=\"Conference\">\n+          <para>The name of the Confbridge conference.</para>\n+        </parameter>\n+        <bridge_snapshot/>\n+        <channel_snapshot/>\n+        <parameter name=\"Admin\">\n+          <para>Identifies this user as an admin user.</para>\n+          <enumlist>\n+            <enum name=\"Yes\"/>\n+            <enum name=\"No\"/>\n+          </enumlist>\n+        </parameter>\n+      </syntax>\n+      <see-also>\n+        <ref type=\"managerEvent\">ConfbridgeJoin</ref>\n+        <ref type=\"application\">ConfBridge</ref>\n+      </see-also>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <managerEvent language=\"en_US\" name=\"ConfbridgeRecord\">\n+    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n+      <synopsis>Raised when a conference starts recording.</synopsis>\n+      <syntax>\n+        <parameter name=\"Conference\">\n+          <para>The name of the Confbridge conference.</para>\n+        </parameter>\n+        <bridge_snapshot/>\n+      </syntax>\n+      <see-also>\n+        <ref type=\"managerEvent\">ConfbridgeStopRecord</ref>\n+        <ref type=\"application\">ConfBridge</ref>\n+      </see-also>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <managerEvent language=\"en_US\" name=\"ConfbridgeStopRecord\">\n+    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n+      <synopsis>Raised when a conference that was recording stops recording.</synopsis>\n+      <syntax>\n+        <parameter name=\"Conference\">\n+          <para>The name of the Confbridge conference.</para>\n+        </parameter>\n+        <bridge_snapshot/>\n+      </syntax>\n+      <see-also>\n+        <ref type=\"managerEvent\">ConfbridgeRecord</ref>\n+        <ref type=\"application\">ConfBridge</ref>\n+      </see-also>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <managerEvent language=\"en_US\" name=\"ConfbridgeMute\">\n+    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n+      <synopsis>Raised when a Confbridge participant mutes.</synopsis>\n+      <syntax>\n+        <parameter name=\"Conference\">\n+          <para>The name of the Confbridge conference.</para>\n+        </parameter>\n+        <bridge_snapshot/>\n+        <channel_snapshot/>\n+        <parameter name=\"Admin\">\n+          <para>Identifies this user as an admin user.</para>\n+          <enumlist>\n+            <enum name=\"Yes\"/>\n+            <enum name=\"No\"/>\n+          </enumlist>\n+        </parameter>\n+      </syntax>\n+      <see-also>\n+        <ref type=\"managerEvent\">ConfbridgeUnmute</ref>\n+        <ref type=\"application\">ConfBridge</ref>\n+      </see-also>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <managerEvent language=\"en_US\" name=\"ConfbridgeUnmute\">\n+    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n+      <synopsis>Raised when a confbridge participant unmutes.</synopsis>\n+      <syntax>\n+        <parameter name=\"Conference\">\n+          <para>The name of the Confbridge conference.</para>\n+        </parameter>\n+        <bridge_snapshot/>\n+        <channel_snapshot/>\n+        <parameter name=\"Admin\">\n+          <para>Identifies this user as an admin user.</para>\n+          <enumlist>\n+            <enum name=\"Yes\"/>\n+            <enum name=\"No\"/>\n+          </enumlist>\n+        </parameter>\n+      </syntax>\n+      <see-also>\n+        <ref type=\"managerEvent\">ConfbridgeMute</ref>\n+        <ref type=\"application\">ConfBridge</ref>\n+      </see-also>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <managerEvent language=\"en_US\" name=\"ConfbridgeTalking\">\n+    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n+      <synopsis>Raised when a confbridge participant begins or ends talking.</synopsis>\n+      <syntax>\n+        <parameter name=\"Conference\">\n+          <para>The name of the Confbridge conference.</para>\n+        </parameter>\n+        <bridge_snapshot/>\n+        <channel_snapshot/>\n+        <parameter name=\"TalkingStatus\">\n+          <enumlist>\n+            <enum name=\"on\"/>\n+            <enum name=\"off\"/>\n+          </enumlist>\n+        </parameter>\n+        <parameter name=\"Admin\">\n+          <para>Identifies this user as an admin user.</para>\n+          <enumlist>\n+            <enum name=\"Yes\"/>\n+            <enum name=\"No\"/>\n+          </enumlist>\n+        </parameter>\n+      </syntax>\n+      <see-also>\n+        <ref type=\"application\">ConfBridge</ref>\n+      </see-also>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <module language=\"en_US\" name=\"conf_state_single\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"conf_config_parser\">\n+    <support_level>core</support_level>\n+  </module>\n+  <configInfo name=\"app_confbridge\" language=\"en_US\">\n+    <synopsis>Conference Bridge Application</synopsis>\n+    <configFile name=\"confbridge.conf\">\n+      <configObject name=\"global\">\n+        <synopsis>Unused, but reserved.</synopsis>\n+      </configObject>\n+      <configObject name=\"user_profile\">\n+        <synopsis>A named profile to apply to specific callers.</synopsis>\n+        <description>\n+          <para>\n+            Callers in a ConfBridge have a profile associated with them\n+\t\t\t\tthat determine their options. A configuration section is determined to be a\n+\t\t\t\tuser_profile when the\n+            <literal>type</literal>\n+            parameter has a value\n+\t\t\t\tof\n+            <literal>user</literal>\n+            .\n+          </para>\n+        </description>\n+        <configOption name=\"type\">\n+          <synopsis>Define this configuration category as a user profile.</synopsis>\n+          <description>\n+            <para>The type parameter determines how a context in the\n+\t\t\t\t\tconfiguration file is interpreted.</para>\n+            <enumlist>\n+              <enum name=\"user\">\n+                <para>\n+                  Configure the context as a\n+                  <replaceable>user_profile</replaceable>\n+                </para>\n+              </enum>\n+              <enum name=\"bridge\">\n+                <para>\n+                  Configure the context as a\n+                  <replaceable>bridge_profile</replaceable>\n+                </para>\n+              </enum>\n+              <enum name=\"menu\">\n+                <para>\n+                  Configure the context as a\n+                  <replaceable>menu</replaceable>\n+                </para>\n+              </enum>\n+            </enumlist>\n+          </description>\n+        </configOption>\n+        <configOption name=\"admin\">\n+          <synopsis>Sets if the user is an admin or not</synopsis>\n+        </configOption>\n+        <configOption name=\"send_events\" default=\"no\">\n+          <synopsis>Sets if events are send to the user</synopsis>\n+          <description>\n+            <para>If events are enabled for this bridge and this option is\n+\t\t\t\t\tset, users will receive events like join, leave, talking, etc. via text\n+\t\t\t\t\tmessages.  For users accessing the bridge via chan_pjsip, this means\n+\t\t\t\t\tin-dialog MESSAGE messages.  This is most useful for WebRTC participants\n+\t\t\t\t\twhere the browser application can use the messages to alter the user\n+\t\t\t\t\tinterface.</para>\n+          </description>\n+        </configOption>\n+        <configOption name=\"echo_events\" default=\"yes\">\n+          <synopsis>Sets if events are echoed back to the user that\n+\t\t\t\t\ttriggered them</synopsis>\n+          <description>\n+            <para>If events are enabled for this user and this option\n+\t\t\t\t\tis set, the user will receive events they trigger, talking, mute, etc.\n+\t\t\t\t\tIf not set, they will not receive their own events.</para>\n+          </description>\n+        </configOption>\n+        <configOption name=\"marked\">\n+          <synopsis>Sets if this is a marked user or not</synopsis>\n+        </configOption>\n+        <configOption name=\"startmuted\">\n+          <synopsis>Sets if all users should start out muted</synopsis>\n+        </configOption>\n+        <configOption name=\"music_on_hold_when_empty\">\n+          <synopsis>Play MOH when user is alone or waiting on a marked user</synopsis>\n+        </configOption>\n+        <configOption name=\"quiet\">\n+          <synopsis>Silence enter/leave prompts and user intros for this user</synopsis>\n+        </configOption>\n+        <configOption name=\"hear_own_join_sound\">\n+          <synopsis>Determines if the user also hears the join sound when they enter a conference</synopsis>\n+        </configOption>\n+        <configOption name=\"announce_user_count\">\n+          <synopsis>Sets if the number of users should be announced to the user</synopsis>\n+        </configOption>\n+        <configOption name=\"announce_user_count_all\">\n+          <synopsis>Announce user count to all the other users when this user joins</synopsis>\n+          <description>\n+            <para>Sets if the number of users should be announced to all the other users\n+\t\t\t\t\tin the conference when this user joins. This option can be either set to 'yes' or\n+\t\t\t\t\ta number. When set to a number, the announcement will only occur once the user\n+\t\t\t\t\tcount is above the specified number.</para>\n+          </description>\n+        </configOption>\n+        <configOption name=\"announce_only_user\">\n+          <synopsis>Announce to a user when they join an empty conference</synopsis>\n+        </configOption>\n+        <configOption name=\"wait_marked\">\n+          <synopsis>Sets if the user must wait for a marked user to enter before joining a conference</synopsis>\n+        </configOption>\n+        <configOption name=\"end_marked\">\n+          <synopsis>Kick the user from the conference when the last marked user leaves</synopsis>\n+        </configOption>\n+        <configOption name=\"talk_detection_events\">\n+          <synopsis>Set whether or not notifications of when a user begins and ends talking should be sent out as events over AMI</synopsis>\n+        </configOption>\n+        <configOption name=\"dtmf_passthrough\">\n+          <synopsis>Sets whether or not DTMF should pass through the conference</synopsis>\n+        </configOption>\n+        <configOption name=\"announce_join_leave\">\n+          <synopsis>Prompt user for their name when joining a conference and play it to the conference when they enter</synopsis>\n+        </configOption>\n+        <configOption name=\"announce_join_leave_review\">\n+          <synopsis>Prompt user for their name when joining a conference and play it to the conference when they enter.\n+\t\t\t\t\tThe user will be asked to review the recording of their name before entering the conference.</synopsis>\n+        </configOption>\n+        <configOption name=\"pin\">\n+          <synopsis>Sets a PIN the user must enter before joining the conference</synopsis>\n+        </configOption>\n+        <configOption name=\"music_on_hold_class\">\n+          <synopsis>The MOH class to use for this user</synopsis>\n+        </configOption>\n+        <configOption name=\"announcement\">\n+          <synopsis>Sound file to play to the user when they join a conference</synopsis>\n+        </configOption>\n+        <configOption name=\"denoise\">\n+          <synopsis>Apply a denoise filter to the audio before mixing</synopsis>\n+          <description>\n+            <para>\n+              Sets whether or not a denoise filter should be applied\n+\t\t\t\t\tto the audio before mixing or not.  Off by default. Requires\n+              <literal>codec_speex</literal>\n+              to be built and installed.  Do not confuse this option\n+\t\t\t\t\twith\n+              <replaceable>drop_silence</replaceable>\n+              .  Denoise is useful if there is a lot of background\n+\t\t\t\t\tnoise for a user as it attempts to remove the noise while preserving\n+\t\t\t\t\tthe speech.  This option does NOT remove silence from being mixed into\n+\t\t\t\t\tthe conference and does come at the cost of a slight performance hit.\n+            </para>\n+          </description>\n+        </configOption>\n+        <configOption name=\"dsp_drop_silence\">\n+          <synopsis>Drop what Asterisk detects as silence from audio sent to the bridge</synopsis>\n+          <description>\n+            <para>This option drops what Asterisk detects as silence from\n+\t\t\t\t\tentering into the bridge.  Enabling this option will drastically\n+\t\t\t\t\timprove performance and help remove the buildup of background\n+\t\t\t\t\tnoise from the conference. Highly recommended for large conferences\n+\t\t\t\t\tdue to its performance enhancements.</para>\n+          </description>\n+        </configOption>\n+        <configOption name=\"dsp_silence_threshold\">\n+          <synopsis>The number of milliseconds of silence necessary to declare talking stopped.</synopsis>\n+          <description>\n+            <para>\n+              The time in milliseconds of sound falling below the\n+              <replaceable>dsp_talking_threshold</replaceable>\n+              option when\n+\t\t\t\t\t\ta user is considered to stop talking.  This value affects several\n+\t\t\t\t\t\toperations and should not be changed unless the impact on call\n+\t\t\t\t\t\tquality is fully understood.\n+            </para>\n+            <para>What this value affects internally:</para>\n+            <para>1. When talk detection AMI events are enabled, this value\n+\t\t\t\t\t\tdetermines when the user has stopped talking after a\n+\t\t\t\t\t\tperiod of talking.  If this value is set too low\n+\t\t\t\t\t\tAMI events indicating the user has stopped talking\n+\t\t\t\t\t\tmay get falsely sent out when the user briefly pauses\n+\t\t\t\t\t\tduring mid sentence.</para>\n+            <para>\n+              2. The\n+              <replaceable>drop_silence</replaceable>\n+              option\n+\t\t\t\t\t\tdepends on this value to determine when the user's audio should\n+\t\t\t\t\t\tbegin to be dropped from the conference bridge after the user\n+\t\t\t\t\t\tstops talking.  If this value is set too low the user's\n+\t\t\t\t\t\taudio stream may sound choppy to the other participants.  This\n+\t\t\t\t\t\tis caused by the user transitioning constantly from silence to\n+\t\t\t\t\t\ttalking during mid sentence.\n+            </para>\n+            <para>The best way to approach this option is to set it slightly\n+\t\t\t\t\t\tabove the maximum amount of milliseconds of silence a user may\n+\t\t\t\t\t\tgenerate during natural speech.</para>\n+            <para>Valid values are 1 through 2^31.</para>\n+          </description>\n+        </configOption>\n+        <configOption name=\"dsp_talking_threshold\">\n+          <synopsis>Average magnitude threshold to determine talking.</synopsis>\n+          <description>\n+            <para>The minimum average magnitude per sample in a frame\n+\t\t\t\t\t\tfor the DSP to consider talking/noise present.  A value below\n+\t\t\t\t\t\tthis level is considered silence.  This value affects several\n+\t\t\t\t\t\toperations and should not be changed unless the impact on call\n+\t\t\t\t\t\tquality is fully understood.</para>\n+            <para>What this value affects internally:</para>\n+            <para>1. Audio is only mixed out of a user's incoming audio\n+\t\t\t\t\t\tstream if talking is detected.  If this value is set too\n+\t\t\t\t\t\thigh the user will hear himself talking.</para>\n+            <para>2. When talk detection AMI events are enabled, this value\n+\t\t\t\t\t\tdetermines when talking has begun which results in\n+\t\t\t\t\t\tan AMI event to fire.  If this value is set too low\n+\t\t\t\t\t\tAMI events may be falsely triggered by variants in\n+\t\t\t\t\t\troom noise.</para>\n+            <para>\n+              3. The\n+              <replaceable>drop_silence</replaceable>\n+              option\n+\t\t\t\t\t\tdepends on this value to determine when the user's audio should\n+\t\t\t\t\t\tbe mixed into the bridge after periods of silence.  If this value\n+\t\t\t\t\t\tis too high the user's speech will get discarded as they will\n+\t\t\t\t\t\tbe considered silent.\n+            </para>\n+            <para>Valid values are 1 through 2^15.</para>\n+          </description>\n+        </configOption>\n+        <configOption name=\"jitterbuffer\">\n+          <synopsis>Place a jitter buffer on the user's audio stream before audio mixing is performed</synopsis>\n+          <description>\n+            <para>\n+              Enabling this option places a jitterbuffer on the user's audio stream\n+\t\t\t\t\t\tbefore audio mixing is performed.  This is highly recommended but will\n+\t\t\t\t\t\tadd a slight delay to the audio.  This option is using the\n+              <literal>JITTERBUFFER</literal>\n+              dialplan function's default adaptive jitterbuffer.  For a more fine tuned\n+\t\t\t\t\t\tjitterbuffer, disable this option and use the\n+              <literal>JITTERBUFFER</literal>\n+              dialplan function\n+\t\t\t\t\t\ton the user before entering the ConfBridge application.\n+            </para>\n+          </description>\n+        </configOption>\n+        <configOption name=\"template\">\n+          <synopsis>When using the CONFBRIDGE dialplan function, use a user profile as a template for creating a new temporary profile</synopsis>\n+        </configOption>\n+        <configOption name=\"timeout\">\n+          <synopsis>Kick the user out of the conference after this many seconds. 0 means there is no timeout for the user.</synopsis>\n+        </configOption>\n+        <configOption name=\"text_messaging\" default=\"yes\">\n+          <synopsis>Sets if text messages are sent to the user.</synopsis>\n+          <description>\n+            <para>If text messaging is enabled for this user then\n+\t\t\t\t\ttext messages will be sent to it. These may be events or from other\n+\t\t\t\t\tparticipants in the conference bridge. If disabled then no text\n+\t\t\t\t\tmessages are sent to the user.</para>\n+          </description>\n+        </configOption>\n+        <configOption name=\"answer_channel\" default=\"yes\">\n+          <synopsis>Sets if a user's channel should be answered if currently unanswered.</synopsis>\n+        </configOption>\n+      </configObject>\n+      <configObject name=\"bridge_profile\">\n+        <synopsis>A named profile to apply to specific bridges.</synopsis>\n+        <description>\n+          <para>\n+            ConfBridge bridges have a profile associated with them\n+\t\t\t\tthat determine their options. A configuration section is determined to be a\n+            <literal>bridge_profile</literal>\n+            when the\n+            <literal>type</literal>\n+            parameter has a value\n+\t\t\t\tof\n+            <literal>bridge</literal>\n+            .\n+          </para>\n+        </description>\n+        <configOption name=\"type\">\n+          <synopsis>Define this configuration category as a bridge profile</synopsis>\n+          <description>\n+            <para>The type parameter determines how a context in the\n+\t\t\t\t\tconfiguration file is interpreted.</para>\n+            <enumlist>\n+              <enum name=\"user\">\n+                <para>\n+                  Configure the context as a\n+                  <replaceable>user_profile</replaceable>\n+                </para>\n+              </enum>\n+              <enum name=\"bridge\">\n+                <para>\n+                  Configure the context as a\n+                  <replaceable>bridge_profile</replaceable>\n+                </para>\n+              </enum>\n+              <enum name=\"menu\">\n+                <para>\n+                  Configure the context as a\n+                  <replaceable>menu</replaceable>\n+                </para>\n+              </enum>\n+            </enumlist>\n+          </description>\n+        </configOption>\n+        <configOption name=\"jitterbuffer\">\n+          <synopsis>Place a jitter buffer on the conference's audio stream</synopsis>\n+        </configOption>\n+        <configOption name=\"internal_sample_rate\">\n+          <synopsis>Set the internal native sample rate for mixing the conference</synopsis>\n+          <description>\n+            <para>Sets the internal native sample rate the\n+\t\t\t\t\t\tconference is mixed at.  This is set to automatically\n+\t\t\t\t\t\tadjust the sample rate to the best quality by default.\n+\t\t\t\t\t\tOther values can be anything from 8000-192000.  If a\n+\t\t\t\t\t\tsample rate is set that Asterisk does not support, the\n+\t\t\t\t\t\tclosest sample rate Asterisk does support to the one requested\n+\t\t\t\t\t\twill be used.</para>\n+          </description>\n+        </configOption>\n+        <configOption name=\"maximum_sample_rate\">\n+          <synopsis>Set the maximum native sample rate for mixing the conference</synopsis>\n+          <description>\n+            <para>Sets the maximum native sample rate the\n+\t\t\t\t\t\tconference is mixed at. This is set to not have a\n+\t\t\t\t\t\tmaximum by default. If a sample rate is specified,\n+\t\t\t\t\t\tthough, the native sample rate will never exceed it.</para>\n+          </description>\n+        </configOption>\n+        <configOption name=\"language\" default=\"en\">\n+          <synopsis>The language used for announcements to the conference.</synopsis>\n+          <description>\n+            <para>By default, announcements to a conference use English.  Which means\n+\t\t\t\t\t\tthe prompts played to all users within the conference will be\n+\t\t\t\t\t\tEnglish.  By changing the language of a bridge, this will change\n+\t\t\t\t\t\tthe language of the prompts played to all users.</para>\n+          </description>\n+        </configOption>\n+        <configOption name=\"mixing_interval\">\n+          <synopsis>Sets the internal mixing interval in milliseconds for the bridge</synopsis>\n+          <description>\n+            <para>Sets the internal mixing interval in milliseconds for the bridge.  This\n+\t\t\t\t\t\tnumber reflects how tight or loose the mixing will be for the conference.\n+\t\t\t\t\t\tIn order to improve performance a larger mixing interval such as 40ms may\n+\t\t\t\t\t\tbe chosen.  Using a larger mixing interval comes at the cost of introducing\n+\t\t\t\t\t\tlarger amounts of delay into the bridge.  Valid values here are 10, 20, 40,\n+\t\t\t\t\t\tor 80.</para>\n+          </description>\n+        </configOption>\n+        <configOption name=\"binaural_active\">\n+          <synopsis>If true binaural conferencing with stereo audio is active</synopsis>\n+          <description>\n+            <para>Activates binaural mixing for a conference bridge.\n+\t\t\t\t\t\tBinaural features are disabled by default.</para>\n+          </description>\n+        </configOption>\n+        <configOption name=\"record_conference\">\n+          <synopsis>Record the conference starting with the first active user's entrance and ending with the last active user's exit</synopsis>\n+          <description>\n+            <para>\n+              Records the conference call starting when the first user\n+\t\t\t\t\t\tenters the room, and ending when the last user exits the room.\n+\t\t\t\t\t\tThe default recorded filename is\n+              <filename>'confbridge-${name of conference bridge}-${start time}.wav'</filename>\n+              and the default format is 8khz slinear.  This file will be\n+\t\t\t\t\t\tlocated in the configured monitoring directory in\n+              <filename>asterisk.conf</filename>\n+              .\n+            </para>\n+          </description>\n+        </configOption>\n+        <configOption name=\"record_file\" default=\"confbridge-${name of conference bridge}-${start time}.wav\">\n+          <synopsis>The filename of the conference recording</synopsis>\n+          <description>\n+            <para>\n+              When\n+              <replaceable>record_conference</replaceable>\n+              is set to yes, the specific name of the\n+\t\t\t\t\t\trecord file can be set using this option.  Note that since multiple\n+\t\t\t\t\t\tconferences may use the same bridge profile, this may cause issues\n+\t\t\t\t\t\tdepending on the configuration.  It is recommended to only use this\n+\t\t\t\t\t\toption dynamically with the\n+              <literal>CONFBRIDGE()</literal>\n+              dialplan function. This\n+\t\t\t\t\t\tallows the record name to be specified and a unique name to be chosen.\n+\t\t\t\t\t\tBy default, the record_file is stored in Asterisk's spool/monitor directory\n+\t\t\t\t\t\twith a unique filename starting with the 'confbridge' prefix.\n+            </para>\n+          </description>\n+        </configOption>\n+        <configOption name=\"record_file_append\" default=\"yes\">\n+          <synopsis>Append to record file when starting/stopping on same conference recording</synopsis>\n+          <description>\n+            <para>\n+              When\n+              <replaceable>record_file_append</replaceable>\n+              is set to yes, stopping and starting recording on a\n+\t\t\t\t\t\tconference adds the new portion to end of current record_file. When this is\n+\t\t\t\t\t\tset to no, a new\n+              <replaceable>record_file</replaceable>\n+              is generated every time you start then stop recording\n+\t\t\t\t\t\ton a conference.\n+            </para>\n+          </description>\n+        </configOption>\n+        <configOption name=\"record_file_timestamp\" default=\"yes\">\n+          <synopsis>Append the start time to the record_file name so that it is unique.</synopsis>\n+          <description>\n+            <para>\n+              When\n+              <replaceable>record_file_timestamp</replaceable>\n+              is set to yes, the start time is appended to\n+              <replaceable>record_file</replaceable>\n+              so that the filename is unique. This allows you to specify\n+\t\t\t\t\t\ta\n+              <replaceable>record_file</replaceable>\n+              but not overwrite existing recordings.\n+            </para>\n+          </description>\n+        </configOption>\n+        <configOption name=\"record_options\" default=\"\">\n+          <synopsis>Pass additional options to MixMonitor when recording</synopsis>\n+          <description>\n+            <para>\n+              Pass additional options to MixMonitor when\n+              <replaceable>record_conference</replaceable>\n+              is set to yes.\n+\t\t\t\t\t\tSee\n+              <literal>MixMonitor</literal>\n+              for available options.\n+            </para>\n+          </description>\n+        </configOption>\n+        <configOption name=\"record_command\" default=\"\">\n+          <synopsis>Execute a command after recording ends</synopsis>\n+          <description>\n+            <para>\n+              Executes the specified command when recording ends. Any strings matching\n+              <literal>^{X}</literal>\n+              will be\n+\t\t\t\t\t\tunescaped to\n+              <variable>X</variable>\n+              . All variables will be evaluated at the time ConfBridge is called.\n+            </para>\n+          </description>\n+        </configOption>\n+        <configOption name=\"regcontext\">\n+          <synopsis>The name of the context into which to register the name of the conference bridge as NoOP() at priority 1</synopsis>\n+          <description>\n+            <para>When set this will cause the name of the created conference to be registered\n+\t\t\t\t\t\tinto the named context at priority 1 with an operation of NoOP().  This can\n+\t\t\t\t\t\tthen be used in other parts of the dialplan to test for the existence of a\n+\t\t\t\t\t\tspecific conference bridge.\n+\t\t\t\t\t\tYou should be aware that there are potential races between testing for the\n+\t\t\t\t\t\texistence of a bridge, and taking action upon that information, consider\n+\t\t\t\t\t\tfor example two callers executing the check simultaneously, and then taking\n+\t\t\t\t\t\tspecial action as &quot;first caller&quot; into the bridge.  The same for exiting,\n+\t\t\t\t\t\tdirectly after the check the bridge can be destroyed before the new caller\n+\t\t\t\t\t\tenters (creating a new bridge), for example, and the &quot;first member&quot; actions\n+\t\t\t\t\t\tcould thus be missed.</para>\n+          </description>\n+        </configOption>\n+        <configOption name=\"video_mode\">\n+          <synopsis>Sets how confbridge handles video distribution to the conference participants</synopsis>\n+          <description>\n+            <para>\n+              Sets how confbridge handles video distribution to the conference participants.\n+\t\t\t\t\t\tNote that participants wanting to view and be the source of a video feed\n+              <emphasis>MUST</emphasis>\n+              be sharing the same video codec.  Also, using video in conjunction with\n+\t\t\t\t\t\twith the jitterbuffer currently results in the audio being slightly out of sync\n+\t\t\t\t\t\twith the video.  This is a result of the jitterbuffer only working on the audio\n+\t\t\t\t\t\tstream.  It is recommended to disable the jitterbuffer when video is used.\n+            </para>\n+            <enumlist>\n+              <enum name=\"none\">\n+                <para>No video sources are set by default in the conference. It is still\n+\t\t\t\t\t\t\t\tpossible for a user to be set as a video source via AMI or DTMF action\n+\t\t\t\t\t\t\t\tat any time.</para>\n+              </enum>\n+              <enum name=\"follow_talker\">\n+                <para>The video feed will follow whoever is talking and providing video.</para>\n+              </enum>\n+              <enum name=\"last_marked\">\n+                <para>The last marked user to join the conference with video capabilities\n+\t\t\t\t\t\t\t\twill be the single source of video distributed to all participants.\n+\t\t\t\t\t\t\t\tIf multiple marked users are capable of video, the last one to join\n+\t\t\t\t\t\t\t\tis always the source, when that user leaves it goes to the one who\n+\t\t\t\t\t\t\t\tjoined before them.</para>\n+              </enum>\n+              <enum name=\"first_marked\">\n+                <para>The first marked user to join the conference with video capabilities\n+\t\t\t\t\t\t\t\tis the single source of video distribution among all participants. If\n+\t\t\t\t\t\t\t\tthat user leaves, the marked user to join after them becomes the source.</para>\n+              </enum>\n+              <enum name=\"sfu\">\n+                <para>Selective Forwarding Unit - Sets multi-stream\n+\t\t\t\t\t\t\t\toperation for a multi-party video conference.</para>\n+              </enum>\n+            </enumlist>\n+          </description>\n+        </configOption>\n+        <configOption name=\"max_members\">\n+          <synopsis>Limit the maximum number of participants for a single conference</synopsis>\n+          <description>\n+            <para>This option limits the number of participants for a single\n+\t\t\t\t\t\tconference to a specific number.  By default conferences\n+\t\t\t\t\t\thave no participant limit. After the limit is reached, the\n+\t\t\t\t\t\tconference will be locked until someone leaves.  Note however\n+\t\t\t\t\t\tthat an Admin user will always be alowed to join the conference\n+\t\t\t\t\t\tregardless if this limit is reached or not.</para>\n+          </description>\n+        </configOption>\n+        <configOption name=\"sound_\">\n+          <synopsis>Override the various conference bridge sound files</synopsis>\n+          <description>\n+            <para>\n+              All sounds in the conference are customizable using the bridge profile options below.\n+\t\t\t\t\t\tSimply state the option followed by the filename or full path of the filename after\n+\t\t\t\t\t\tthe option.  Example:\n+              <literal>sound_had_joined=conf-hasjoin</literal>\n+              This will play the\n+              <literal>conf-hasjoin</literal>\n+              sound file found in the sounds directory when announcing someone's name is joining the\n+\t\t\t\t\t\tconference.\n+            </para>\n+            <enumlist>\n+              <enum name=\"sound_join\">\n+                <para>The sound played to everyone when someone enters the conference.</para>\n+              </enum>\n+              <enum name=\"sound_leave\">\n+                <para>The sound played to everyone when someone leaves the conference.</para>\n+              </enum>\n+              <enum name=\"sound_has_joined\">\n+                <para>\n+                  The sound played before announcing someone's name has\n+\t\t\t\t\t\t\t\t\t\tjoined the conference. This is used for user intros.\n+\t\t\t\t\t\t\t\t\t\tExample\n+                  <literal>&quot;_____ has joined the conference&quot;</literal>\n+                </para>\n+              </enum>\n+              <enum name=\"sound_has_left\">\n+                <para>\n+                  The sound played when announcing someone's name has\n+\t\t\t\t\t\t\t\t\t\tleft the conference. This is used for user intros.\n+\t\t\t\t\t\t\t\t\t\tExample\n+                  <literal>&quot;_____ has left the conference&quot;</literal>\n+                </para>\n+              </enum>\n+              <enum name=\"sound_kicked\">\n+                <para>The sound played to a user who has been kicked from the conference.</para>\n+              </enum>\n+              <enum name=\"sound_muted\">\n+                <para>The sound played when the mute option it toggled on.</para>\n+              </enum>\n+              <enum name=\"sound_unmuted\">\n+                <para>The sound played when the mute option it toggled off.</para>\n+              </enum>\n+              <enum name=\"sound_binaural_on\">\n+                <para>The sound played when binaural audio is turned on.</para>\n+              </enum>\n+              <enum name=\"sound_binaural_off\">\n+                <para>The sound played when the binaural audio is turned off.</para>\n+              </enum>\n+              <enum name=\"sound_only_person\">\n+                <para>The sound played when the user is the only person in the conference.</para>\n+              </enum>\n+              <enum name=\"sound_only_one\">\n+                <para>The sound played to a user when there is only one other\n+\t\t\t\t\t\t\t\t\t\tperson is in the conference.</para>\n+              </enum>\n+              <enum name=\"sound_there_are\">\n+                <para>The sound played when announcing how many users there\n+\t\t\t\t\t\t\t\t\t\tare in a conference.</para>\n+              </enum>\n+              <enum name=\"sound_other_in_party\">\n+                <para>\n+                  This file is used in conjunction with\n+                  <literal>sound_there_are</literal>\n+                  when announcing how many users there are in the conference.\n+\t\t\t\t\t\t\t\t\t\tThe sounds are stringed together like this.\n+                  <literal>&quot;sound_there_are&quot; ${number of participants} &quot;sound_other_in_party&quot;</literal>\n+                </para>\n+              </enum>\n+              <enum name=\"sound_place_into_conference\">\n+                <para>The sound played when someone is placed into the conference\n+\t\t\t\t\t\t\t\t\t\tafter waiting for a marked user.</para>\n+              </enum>\n+              <enum name=\"sound_wait_for_leader\">\n+                <para>The sound played when a user is placed into a conference that\n+\t\t\t\t\t\t\t\t\t\tcan not start until a marked user enters.</para>\n+              </enum>\n+              <enum name=\"sound_leader_has_left\">\n+                <para>The sound played when the last marked user leaves the conference.</para>\n+              </enum>\n+              <enum name=\"sound_get_pin\">\n+                <para>The sound played when prompting for a conference pin number.</para>\n+              </enum>\n+              <enum name=\"sound_invalid_pin\">\n+                <para>The sound played when an invalid pin is entered too many times.</para>\n+              </enum>\n+              <enum name=\"sound_locked\">\n+                <para>The sound played to a user trying to join a locked conference.</para>\n+              </enum>\n+              <enum name=\"sound_locked_now\">\n+                <para>The sound played to an admin after toggling the conference to locked mode.</para>\n+              </enum>\n+              <enum name=\"sound_unlocked_now\">\n+                <para>The sound played to an admin after toggling the conference to unlocked mode.</para>\n+              </enum>\n+              <enum name=\"sound_error_menu\">\n+                <para>The sound played when an invalid menu option is entered.</para>\n+              </enum>\n+            </enumlist>\n+          </description>\n+        </configOption>\n+        <configOption name=\"video_update_discard\" default=\"2000\">\n+          <synopsis>Sets the amount of time in milliseconds after sending a video update to discard subsequent video updates</synopsis>\n+          <description>\n+            <para>Sets the amount of time in milliseconds after sending a video update request\n+\t\t\t\t\t\tthat subsequent video updates should be discarded. This means that if we\n+\t\t\t\t\t\tsend a video update we will discard any other video update requests until\n+\t\t\t\t\t\tafter the configured amount of time has elapsed. This prevents flooding of\n+\t\t\t\t\t\tvideo update requests from clients.</para>\n+          </description>\n+        </configOption>\n+        <configOption name=\"remb_send_interval\" default=\"0\">\n+          <synopsis>Sets the interval in milliseconds that a combined REMB frame will be sent to video sources</synopsis>\n+          <description>\n+            <para>Sets the interval in milliseconds that a combined REMB frame will be sent\n+\t\t\t\t\t\tto video sources. This is done by taking all REMB frames that have been\n+\t\t\t\t\t\treceived since the last REMB frame was sent, making a combined value,\n+\t\t\t\t\t\tand sending it to the source. A REMB frame contains receiver estimated\n+\t\t\t\t\t\tmaximum bitrate information. By creating a combined REMB frame the\n+\t\t\t\t\t\tsender of video can be influenced on the bitrate they choose, allowing\n+\t\t\t\t\t\tbetter quality for all receivers.</para>\n+          </description>\n+        </configOption>\n+        <configOption name=\"remb_behavior\" default=\"average\">\n+          <synopsis>Sets how REMB reports are generated from multiple sources</synopsis>\n+          <description>\n+            <para>Sets how REMB reports are combined from multiple sources to form one. A REMB report\n+\t\t\t\t\t\tconsists of information about the receiver estimated maximum bitrate. As a source\n+\t\t\t\t\t\tstream may be forwarded to multiple receivers the reports must be combined into\n+\t\t\t\t\t\ta single one which is sent to the sender.</para>\n+            <enumlist>\n+              <enum name=\"average\">\n+                <para>The average of all estimated maximum bitrates is taken and sent\n+\t\t\t\t\t\t\t\tto the sender.</para>\n+              </enum>\n+              <enum name=\"lowest\">\n+                <para>The lowest estimated maximum bitrate is forwarded to the sender.</para>\n+              </enum>\n+              <enum name=\"highest\">\n+                <para>The highest estimated maximum bitrate is forwarded to the sender.</para>\n+              </enum>\n+              <enum name=\"average_all\">\n+                <para>The average of all estimated maximum bitrates is taken from all\n+\t\t\t\t\t\t\t\treceivers in the bridge and a single value is sent to each sender.</para>\n+              </enum>\n+              <enum name=\"lowest_all\">\n+                <para>The lowest estimated maximum bitrate of all receivers in the bridge\n+\t\t\t\t\t\t\t\tis taken and sent to each sender.</para>\n+              </enum>\n+              <enum name=\"highest_all\">\n+                <para>The highest estimated maximum bitrate of all receivers in the bridge\n+\t\t\t\t\t\t\t\tis taken and sent to each sender.</para>\n+              </enum>\n+              <enum name=\"force\">\n+                <para>\n+                  The bitrate configured in\n+                  <literal>remb_estimated_bitrate</literal>\n+                  is sent to each sender.\n+                </para>\n+              </enum>\n+            </enumlist>\n+          </description>\n+          <see-also>\n+            <ref type=\"configOption\">remb_estimated_bitrate</ref>\n+          </see-also>\n+        </configOption>\n+        <configOption name=\"remb_estimated_bitrate\">\n+          <synopsis>Sets the estimated bitrate sent to each participant in REMB reports</synopsis>\n+          <description>\n+            <para>\n+              When\n+              <literal>remb_behavior</literal>\n+              is set to\n+              <literal>force</literal>\n+              ,\n+\t\t\t\t\t    this options sets the estimated bitrate (in bits per second) sent to each participant\n+\t\t\t\t\t    in REMB reports.\n+            </para>\n+          </description>\n+          <see-also>\n+            <ref type=\"configOption\">remb_behavior</ref>\n+          </see-also>\n+        </configOption>\n+        <configOption name=\"enable_events\" default=\"no\">\n+          <synopsis>Enables events for this bridge</synopsis>\n+          <description>\n+            <para>\n+              If enabled, recipients who joined the bridge via a channel driver\n+\t\t\t\t\t\tthat supports Enhanced Messaging (currently only chan_pjsip) will\n+\t\t\t\t\t\treceive in-dialog messages containing a JSON body describing the\n+\t\t\t\t\t\tevent.  The Content-Type header will be\n+              <literal>text/x-ast-confbridge-event</literal>\n+              .\n+\t\t\t\t\t\tThis feature must also be enabled in user profiles.\n+            </para>\n+          </description>\n+        </configOption>\n+        <configOption name=\"template\">\n+          <synopsis>When using the CONFBRIDGE dialplan function, use a bridge profile as a template for creating a new temporary profile</synopsis>\n+        </configOption>\n+      </configObject>\n+      <configObject name=\"menu\">\n+        <synopsis>A conference user menu</synopsis>\n+        <description>\n+          <para>\n+            Conference users, as defined by a\n+            <replaceable>conf_user</replaceable>\n+            ,\n+\t\t\t\t\tcan have a DTMF menu assigned to their profile when they enter the\n+            <literal>ConfBridge</literal>\n+            application.\n+          </para>\n+        </description>\n+        <configOption name=\"type\">\n+          <synopsis>Define this configuration category as a menu</synopsis>\n+          <description>\n+            <para>The type parameter determines how a context in the\n+\t\t\t\t\tconfiguration file is interpreted.</para>\n+            <enumlist>\n+              <enum name=\"user\">\n+                <para>\n+                  Configure the context as a\n+                  <replaceable>user_profile</replaceable>\n+                </para>\n+              </enum>\n+              <enum name=\"bridge\">\n+                <para>\n+                  Configure the context as a\n+                  <replaceable>bridge_profile</replaceable>\n+                </para>\n+              </enum>\n+              <enum name=\"menu\">\n+                <para>\n+                  Configure the context as a\n+                  <replaceable>menu</replaceable>\n+                </para>\n+              </enum>\n+            </enumlist>\n+          </description>\n+        </configOption>\n+        <configOption name=\"template\">\n+          <synopsis>When using the CONFBRIDGE dialplan function, use a menu profile as a template for creating a new temporary profile</synopsis>\n+        </configOption>\n+        <configOption name=\"^[0-9A-D*#]+$\">\n+          <synopsis>DTMF sequences to assign various confbridge actions to</synopsis>\n+          <description>\n+            <para>The ConfBridge application also has the ability to apply custom DTMF menus to\n+\t\t\t\t\teach channel using the application.  Like the User and Bridge profiles a menu\n+\t\t\t\t\tis passed in to ConfBridge as an argument in the dialplan.</para>\n+            <para>Below is a list of menu actions that can be assigned to a DTMF sequence.</para>\n+            <note>\n+              <para>\n+                To have the first DTMF digit in a sequence be the '#' character, you need to\n+\t\t\t\t\t\tescape it.  If it is not escaped then normal config file processing will\n+\t\t\t\t\t\tthink it is a directive like #include.  For example: The mute setting is\n+\t\t\t\t\t\ttoggled when\n+                <literal>#1</literal>\n+                is pressed.\n+              </para>\n+              <para>\n+                <literal>\\#1=toggle_mute</literal>\n+              </para>\n+            </note>\n+            <note>\n+              <para>\n+                A single DTMF sequence can have multiple actions associated with it. This is\n+\t\t\t\t\taccomplished by stringing the actions together and using a\n+                <literal>,</literal>\n+                as the\n+\t\t\t\t\tdelimiter.  Example:  Both listening and talking volume is reset when\n+                <literal>5</literal>\n+                is\n+\t\t\t\t\tpressed.\n+                <literal>5=reset_talking_volume, reset_listening_volume</literal>\n+              </para>\n+            </note>\n+            <enumlist>\n+              <enum name=\"playback(filename&amp;filename2&amp;...)\">\n+                <para>\n+                  <literal>playback</literal>\n+                  will play back an audio file to a channel\n+\t\t\t\t\t\t\tand then immediately return to the conference.\n+\t\t\t\t\t\t\tThis file can not be interupted by DTMF.\n+\t\t\t\t\t\t\tMultiple files can be chained together using the\n+                  <literal>&amp;</literal>\n+                  character.\n+                </para>\n+              </enum>\n+              <enum name=\"playback_and_continue(filename&amp;filename2&amp;...)\">\n+                <para>\n+                  <literal>playback_and_continue</literal>\n+                  will\n+\t\t\t\t\t\t\tplay back a prompt while continuing to\n+\t\t\t\t\t\t\tcollect the dtmf sequence.  This is useful\n+\t\t\t\t\t\t\twhen using a menu prompt that describes all\n+\t\t\t\t\t\t\tthe menu options.  Note however that any DTMF\n+\t\t\t\t\t\t\tduring this action will terminate the prompts\n+\t\t\t\t\t\t\tplayback.  Prompt files can be chained together\n+\t\t\t\t\t\t\tusing the\n+                  <literal>&amp;</literal>\n+                  character as a delimiter.\n+                </para>\n+              </enum>\n+              <enum name=\"toggle_mute\">\n+                <para>Toggle turning on and off mute.  Mute will make the user silent\n+\t\t\t\t\t\t\tto everyone else, but the user will still be able to listen in.</para>\n+              </enum>\n+              <enum name=\"toggle_binaural\">\n+                <para>Toggle turning on and off binaural audio processing.</para>\n+              </enum>\n+              <enum name=\"no_op\">\n+                <para>This action does nothing (No Operation). Its only real purpose exists for\n+\t\t\t\t\t\t\tbeing able to reserve a sequence in the config as a menu exit sequence.</para>\n+              </enum>\n+              <enum name=\"decrease_listening_volume\">\n+                <para>Decreases the channel's listening volume.</para>\n+              </enum>\n+              <enum name=\"increase_listening_volume\">\n+                <para>Increases the channel's listening volume.</para>\n+              </enum>\n+              <enum name=\"reset_listening_volume\">\n+                <para>Reset channel's listening volume to default level.</para>\n+              </enum>\n+              <enum name=\"decrease_talking_volume\">\n+                <para>Decreases the channel's talking volume.</para>\n+              </enum>\n+              <enum name=\"increase_talking_volume\">\n+                <para>Increases the channel's talking volume.</para>\n+              </enum>\n+              <enum name=\"reset_talking_volume\">\n+                <para>Reset channel's talking volume to default level.</para>\n+              </enum>\n+              <enum name=\"dialplan_exec(context,exten,priority)\">\n+                <para>\n+                  The\n+                  <literal>dialplan_exec</literal>\n+                  action allows a user\n+\t\t\t\t\t\t\tto escape from the conference and execute\n+\t\t\t\t\t\t\tcommands in the dialplan.  Once the dialplan\n+\t\t\t\t\t\t\texits the user will be put back into the\n+\t\t\t\t\t\t\tconference.  The possibilities are endless!\n+                </para>\n+              </enum>\n+              <enum name=\"leave_conference\">\n+                <para>This action allows a user to exit the conference and continue\n+\t\t\t\t\t\t\texecution in the dialplan.</para>\n+              </enum>\n+              <enum name=\"admin_kick_last\">\n+                <para>This action allows an Admin to kick the last participant from the\n+\t\t\t\t\t\t\tconference. This action will only work for admins which allows\n+\t\t\t\t\t\t\ta single menu to be used for both users and admins.</para>\n+              </enum>\n+              <enum name=\"admin_toggle_conference_lock\">\n+                <para>This action allows an Admin to toggle locking and\n+\t\t\t\t\t\t\tunlocking the conference.  Non admins can not use\n+\t\t\t\t\t\t\tthis action even if it is in their menu.</para>\n+              </enum>\n+              <enum name=\"set_as_single_video_src\">\n+                <para>\n+                  This action allows any user to set themselves as the\n+\t\t\t\t\t\t\tsingle video source distributed to all participants.\n+\t\t\t\t\t\t\tThis will make the video feed stick to them regardless\n+\t\t\t\t\t\t\tof what the\n+                  <literal>video_mode</literal>\n+                  is set to.\n+                </para>\n+              </enum>\n+              <enum name=\"release_as_single_video_src\">\n+                <para>\n+                  This action allows a user to release themselves as\n+\t\t\t\t\t\t\tthe video source.  If\n+                  <literal>video_mode</literal>\n+                  is not set to\n+                  <literal>none</literal>\n+                  this action will result in the conference returning to\n+\t\t\t\t\t\t\twhatever video mode the bridge profile is using.\n+                </para>\n+                <para>\n+                  Note that this action will have no effect if the user\n+\t\t\t\t\t\t\tis not currently the video source.  Also, the user is\n+\t\t\t\t\t\t\tnot guaranteed by using this action that they will not\n+\t\t\t\t\t\t\tbecome the video source again.  The bridge will return\n+\t\t\t\t\t\t\tto whatever operation the\n+                  <literal>video_mode</literal>\n+                  option is set to\n+\t\t\t\t\t\t\tupon release of the video src.\n+                </para>\n+              </enum>\n+              <enum name=\"admin_toggle_mute_participants\">\n+                <para>This action allows an administrator to toggle the mute\n+\t\t\t\t\t\t\tstate for all non-admins within a conference.  All\n+\t\t\t\t\t\t\tadmin users are unaffected by this option.  Note that all\n+\t\t\t\t\t\t\tusers, regardless of their admin status, are notified\n+\t\t\t\t\t\t\tthat the conference is muted.</para>\n+              </enum>\n+              <enum name=\"participant_count\">\n+                <para>This action plays back the number of participants currently\n+\t\t\t\t\t\t\tin a conference</para>\n+              </enum>\n+            </enumlist>\n+          </description>\n+        </configOption>\n+      </configObject>\n+    </configFile>\n+  </configInfo>\n+  <module language=\"en_US\" name=\"app_macro\">\n+    <defaultenabled>no</defaultenabled>\n+    <support_level>deprecated</support_level>\n+    <replacement>app_stack (GoSub)</replacement>\n+    <deprecated_in>16</deprecated_in>\n+    <removed_in>21</removed_in>\n+  </module>\n+  <application name=\"Macro\" language=\"en_US\">\n+    <synopsis>Macro Implementation.</synopsis>\n+    <syntax>\n+      <parameter name=\"name\" required=\"true\">\n+        <para>The name of the macro</para>\n+      </parameter>\n+      <parameter name=\"args\">\n+        <argument name=\"arg1\" required=\"true\"/>\n+        <argument name=\"arg2\" multiple=\"true\"/>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>\n+        Executes a macro using the context macro-\n+        <replaceable>name</replaceable>\n+        ,\n+\t\t\tjumping to the\n+        <literal>s</literal>\n+        extension of that context and executing each step,\n+\t\t\tthen returning when the steps end.\n+      </para>\n+      <para>\n+        The calling extension, context, and priority are stored in\n+        <variable>MACRO_EXTEN</variable>\n+        ,\n+        <variable>MACRO_CONTEXT</variable>\n+        and\n+        <variable>MACRO_PRIORITY</variable>\n+        respectively. Arguments\n+\t\t\tbecome\n+        <variable>ARG1</variable>\n+        ,\n+        <variable>ARG2</variable>\n+        , etc in the macro context.\n+      </para>\n+      <para>If you Goto out of the Macro context, the Macro will terminate and control will be returned\n+\t\t\tat the location of the Goto.</para>\n+      <para>\n+        If\n+        <variable>MACRO_OFFSET</variable>\n+        is set at termination, Macro will attempt to continue\n+\t\t\tat priority MACRO_OFFSET + N + 1 if such a step exists, and N + 1 otherwise.\n+      </para>\n+      <warning>\n+        <para>Because of the way Macro is implemented (it executes the priorities contained within\n+\t\t\tit via sub-engine), and a fixed per-thread memory stack allowance, macros are limited to 7 levels\n+\t\t\tof nesting (macro calling macro calling macro, etc.); It may be possible that stack-intensive\n+\t\t\tapplications in deeply nested macros could cause asterisk to crash earlier than this limit.\n+\t\t\tIt is advised that if you need to deeply nest macro calls, that you use the Gosub application\n+\t\t\t(now allows arguments like a Macro) with explicit Return() calls instead.</para>\n+      </warning>\n+      <warning>\n+        <para>\n+          Use of the application\n+          <literal>WaitExten</literal>\n+          within a macro will not function\n+\t\t\tas expected. Please use the\n+          <literal>Read</literal>\n+          application in order to read DTMF from a channel\n+\t\t\tcurrently executing a macro.\n+        </para>\n+      </warning>\n+    </description>\n+    <see-also>\n+      <ref type=\"application\">MacroExit</ref>\n+      <ref type=\"application\">Goto</ref>\n+      <ref type=\"application\">Gosub</ref>\n+    </see-also>\n+  </application>\n+  <application name=\"MacroIf\" language=\"en_US\">\n+    <synopsis>Conditional Macro implementation.</synopsis>\n+    <syntax argsep=\"?\">\n+      <parameter name=\"expr\" required=\"true\"/>\n+      <parameter name=\"destination\" required=\"true\" argsep=\":\">\n+        <argument name=\"macroiftrue\" required=\"true\">\n+          <argument name=\"macroiftrue\" required=\"true\"/>\n+          <argument name=\"arg1\" multiple=\"true\"/>\n+        </argument>\n+        <argument name=\"macroiffalse\">\n+          <argument name=\"macroiffalse\" required=\"true\"/>\n+          <argument name=\"arg1\" multiple=\"true\"/>\n+        </argument>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>\n+        Executes macro defined in\n+        <replaceable>macroiftrue</replaceable>\n+        if\n+        <replaceable>expr</replaceable>\n+        is true (otherwise\n+        <replaceable>macroiffalse</replaceable>\n+        if provided)\n+      </para>\n+      <para>Arguments and return values as in application Macro()</para>\n+      <xi:include xpointer=\"xpointer(/docs/application[@name='Macro']/description/warning[2])\"/>\n+    </description>\n+    <see-also>\n+      <ref type=\"application\">GotoIf</ref>\n+      <ref type=\"application\">GosubIf</ref>\n+      <ref type=\"function\">IF</ref>\n+    </see-also>\n+  </application>\n+  <application name=\"MacroExclusive\" language=\"en_US\">\n+    <synopsis>Exclusive Macro Implementation.</synopsis>\n+    <syntax>\n+      <parameter name=\"name\" required=\"true\">\n+        <para>The name of the macro</para>\n+      </parameter>\n+      <parameter name=\"arg1\"/>\n+      <parameter name=\"arg2\" multiple=\"true\"/>\n+    </syntax>\n+    <description>\n+      <para>\n+        Executes macro defined in the context macro-\n+        <replaceable>name</replaceable>\n+        .\n+\t\t\tOnly one call at a time may run the macro. (we'll wait if another call is busy\n+\t\t\texecuting in the Macro)\n+      </para>\n+      <para>Arguments and return values as in application Macro()</para>\n+      <xi:include xpointer=\"xpointer(/docs/application[@name='Macro']/description/warning[2])\"/>\n+    </description>\n+    <see-also>\n+      <ref type=\"application\">Macro</ref>\n+    </see-also>\n+  </application>\n+  <application name=\"MacroExit\" language=\"en_US\">\n+    <synopsis>Exit from Macro.</synopsis>\n+    <syntax/>\n+    <description>\n+      <para>Causes the currently running macro to exit as if it had\n+\t\t\tended normally by running out of priorities to execute.\n+\t\t\tIf used outside a macro, will likely cause unexpected behavior.</para>\n+    </description>\n+    <see-also>\n+      <ref type=\"application\">Macro</ref>\n+    </see-also>\n+  </application>\n+  <module language=\"en_US\" name=\"app_sendtext\">\n+    <support_level>core</support_level>\n+  </module>\n+  <application name=\"SendText\" language=\"en_US\">\n+    <synopsis>Send a Text Message on a channel.</synopsis>\n+    <syntax>\n+      <parameter name=\"text\" required=\"false\"/>\n+    </syntax>\n+    <description>\n+      <para>\n+        Sends\n+        <replaceable>text</replaceable>\n+        to the current channel.\n+      </para>\n+      <note>\n+        <para>\n+          <literal>current channel</literal>\n+          could be the caller or callee depending\n+\t\t\ton the context in which this application is called.\n+        </para>\n+      </note>\n+      <para/>\n+      <para>The following variables can be set:</para>\n+      <variablelist>\n+        <variable name=\"SENDTEXT_FROM_DISPLAYNAME\">\n+          <para>\n+            If set and this channel supports enhanced messaging, this value will be\n+\t\t\t\t\tused as the\n+            <literal>From</literal>\n+            display name.\n+          </para>\n+        </variable>\n+        <variable name=\"SENDTEXT_TO_DISPLAYNAME\">\n+          <para>\n+            If set and this channel supports enhanced messaging, this value will be\n+\t\t\t\t\tused as the\n+            <literal>To</literal>\n+            display name.\n+          </para>\n+        </variable>\n+        <variable name=\"SENDTEXT_CONTENT_TYPE\">\n+          <para>\n+            If set and this channel supports enhanced messaging, this value will be\n+\t\t\t\t\tused as the message\n+            <literal>Content-Type</literal>\n+            .  If not specified, the\n+\t\t\t\t\tdefault of\n+            <literal>text/plain</literal>\n+            will be used.\n+          </para>\n+          <para>\n+            <emphasis>Warning:</emphasis>\n+            Messages of types other than\n+            <literal>text/*</literal>\n+            cannot be sent via channel drivers that do not\n+\t\t\t\t\tsupport Enhanced Messaging. An attempt to do so will be ignored and will result\n+\t\t\t\t\tin the\n+            <literal>SENDTEXTSTATUS</literal>\n+            variable being set to\n+            <literal>UNSUPPORTED</literal>\n+            .\n+          </para>\n+        </variable>\n+        <variable name=\"SENDTEXT_BODY\">\n+          <para>If set this value will be used as the message body and any text supplied\n+\t\t\t\t\tas a function parameter will be ignored.</para>\n+        </variable>\n+      </variablelist>\n+      <para/>\n+      <para>Result of transmission will be stored in the following variables:</para>\n+      <variablelist>\n+        <variable name=\"SENDTEXTTYPE\">\n+          <value name=\"NONE\">No message sent.</value>\n+          <value name=\"BASIC\">Message body sent without attributes because the channel driver\n+\t\t\t\t\t\tdoesn't support enhanced messaging.</value>\n+          <value name=\"ENHANCED\">The message was sent using enhanced messaging.</value>\n+        </variable>\n+        <variable name=\"SENDTEXTSTATUS\">\n+          <value name=\"SUCCESS\">Transmission succeeded.</value>\n+          <value name=\"FAILURE\">Transmission failed.</value>\n+          <value name=\"UNSUPPORTED\">Text transmission not supported by channel.</value>\n+        </variable>\n+      </variablelist>\n+      <para/>\n+      <note>\n+        <para>The text encoding and transmission method is completely at the\n+\t\t\tdiscretion of the channel driver.  chan_pjsip will use in-dialog SIP MESSAGE\n+\t\t\tmessages always.  chan_sip will use T.140 via RTP if a text media type was\n+\t\t\tnegotiated and in-dialog SIP MESSAGE messages otherwise.</para>\n+      </note>\n+      <para/>\n+      <para>Examples:</para>\n+      <example title=\"Send a simple message\">same =&gt; n,SendText(Your Text Here)</example>\n+      <para>If the channel driver supports enhanced messaging (currently only chan_pjsip),\n+\t\t\tyou can set additional variables:</para>\n+      <example title=\"Alter the From display name\">same =&gt; n,Set(SENDTEXT_FROM_DISPLAYNAME=Really From Bob)\n+\t\t\t same =&gt; n,SendText(Your Text Here)</example>\n+      <example title=\"Send a JSON String\">same =&gt; n,Set(SENDTEXT_CONTENT_TYPE=text/json)\n+\t\t\t same =&gt; n,SendText({&quot;foo&quot;:a, &quot;bar&quot;:23})</example>\n+      <example title=\"Send a JSON String (alternate)\">same =&gt; n,Set(SENDTEXT_CONTENT_TYPE=text/json)\n+\t\t\t same =&gt; n,Set(SENDTEXT_BODY={&quot;foo&quot;:a, &quot;bar&quot;:23})\n+\t\t\t same =&gt; n,SendText()</example>\n+    </description>\n+    <see-also>\n+      <ref type=\"application\">SendImage</ref>\n+      <ref type=\"application\">SendURL</ref>\n+      <ref type=\"application\">ReceiveText</ref>\n+    </see-also>\n+  </application>\n+  <application name=\"ReceiveText\" language=\"en_US\">\n+    <since>\n+      <version>16.24.0</version>\n+      <version>18.10.0</version>\n+      <version>19.2.0</version>\n+    </since>\n+    <synopsis>Receive a Text Message on a channel.</synopsis>\n+    <syntax>\n+      <parameter name=\"timeout\" required=\"false\">\n+        <para>Time in seconds to wait for text. Default is 0 (forever).</para>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>\n+        Waits for\n+        <replaceable>timeout</replaceable>\n+        seconds on the current channel\n+\t\t\tto receive text.\n+      </para>\n+      <para>Result of transmission will be stored in the following variables:</para>\n+      <variablelist>\n+        <variable name=\"RECEIVETEXTMESSAGE\">\n+          <para>The received text message.</para>\n+        </variable>\n+        <variable name=\"RECEIVETEXTSTATUS\">\n+          <value name=\"SUCCESS\">Transmission succeeded.</value>\n+          <value name=\"FAILURE\">Transmission failed or timed out.</value>\n+        </variable>\n+      </variablelist>\n+      <example title=\"Receive message on channel\">same =&gt; n,ReceiveText()\n+\t\t\t same =&gt; n,NoOp(${RECEIVETEXTMESSAGE})</example>\n+    </description>\n+    <see-also>\n+      <ref type=\"application\">SendText</ref>\n+      <ref type=\"application\">SendImage</ref>\n+      <ref type=\"application\">SendURL</ref>\n+    </see-also>\n+  </application>\n+  <module language=\"en_US\" name=\"app_page\">\n+    <depend>app_confbridge</depend>\n+    <support_level>core</support_level>\n+  </module>\n+  <application name=\"Page\" language=\"en_US\">\n+    <synopsis>Page series of phones</synopsis>\n+    <syntax>\n+      <parameter name=\"Technology/Resource\" required=\"false\" argsep=\"&amp;\">\n+        <argument name=\"Technology/Resource\" required=\"true\">\n+          <para>\n+            Specification of the device(s) to dial. These must be in the format of\n+            <literal>Technology/Resource</literal>\n+            , where\n+            <replaceable>Technology</replaceable>\n+            represents a particular channel driver, and\n+            <replaceable>Resource</replaceable>\n+            represents a resource\n+\t\t\t\t\tavailable to that particular channel driver.\n+          </para>\n+        </argument>\n+        <argument name=\"Technology2/Resource2\" multiple=\"true\">\n+          <para>Optional extra devices to dial in parallel</para>\n+          <para>If you need more than one, enter them as Technology2/Resource2&amp;\n+\t\t\t\t\tTechnology3/Resource3&amp;.....</para>\n+        </argument>\n+      </parameter>\n+      <parameter name=\"options\">\n+        <optionlist>\n+          <option name=\"b\" argsep=\"^\">\n+            <para>Before initiating an outgoing call, Gosub to the specified\n+\t\t\t\t\tlocation using the newly created channel.  The Gosub will be\n+\t\t\t\t\texecuted for each destination channel.</para>\n+            <argument name=\"context\" required=\"false\"/>\n+            <argument name=\"exten\" required=\"false\"/>\n+            <argument name=\"priority\" required=\"true\" hasparams=\"optional\" argsep=\"^\">\n+              <argument name=\"arg1\" multiple=\"true\" required=\"true\"/>\n+              <argument name=\"argN\"/>\n+            </argument>\n+          </option>\n+          <option name=\"B\" argsep=\"^\">\n+            <para>Before initiating the outgoing call(s), Gosub to the specified\n+\t\t\t\t\tlocation using the current channel.</para>\n+            <argument name=\"context\" required=\"false\"/>\n+            <argument name=\"exten\" required=\"false\"/>\n+            <argument name=\"priority\" required=\"true\" hasparams=\"optional\" argsep=\"^\">\n+              <argument name=\"arg1\" multiple=\"true\" required=\"true\"/>\n+              <argument name=\"argN\"/>\n+            </argument>\n+          </option>\n+          <option name=\"d\">\n+            <para>Full duplex audio</para>\n+          </option>\n+          <option name=\"i\">\n+            <para>Ignore attempts to forward the call</para>\n+          </option>\n+          <option name=\"q\">\n+            <para>Quiet, do not play beep to caller</para>\n+          </option>\n+          <option name=\"r\">\n+            <para>\n+              Record the page into a file (\n+              <literal>CONFBRIDGE(bridge,record_conference)</literal>\n+              )\n+            </para>\n+          </option>\n+          <option name=\"s\">\n+            <para>\n+              Only dial a channel if its device state says that it is\n+              <literal>NOT_INUSE</literal>\n+            </para>\n+          </option>\n+          <option name=\"A\">\n+            <argument name=\"x\" required=\"true\">\n+              <para>The announcement to playback to all devices</para>\n+            </argument>\n+            <para>Play an announcement to all paged participants</para>\n+          </option>\n+          <option name=\"n\">\n+            <para>\n+              Do not play announcement to caller (alters\n+              <literal>A(x)</literal>\n+              behavior)\n+            </para>\n+          </option>\n+        </optionlist>\n+      </parameter>\n+      <parameter name=\"timeout\">\n+        <para>Specify the length of time that the system will attempt to connect a call.\n+\t\t\t\tAfter this duration, any page calls that have not been answered will be hung up by the\n+\t\t\t\tsystem.</para>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>\n+        Places outbound calls to the given\n+        <replaceable>technology</replaceable>\n+        /\n+        <replaceable>resource</replaceable>\n+        and dumps them into a conference bridge as muted participants. The original\n+\t\t\tcaller is dumped into the conference as a speaker and the room is\n+\t\t\tdestroyed when the original caller leaves.\n+      </para>\n+    </description>\n+    <see-also>\n+      <ref type=\"application\">ConfBridge</ref>\n+    </see-also>\n+  </application>\n+  <module language=\"en_US\" name=\"app_ivrdemo\">\n+    <defaultenabled>no</defaultenabled>\n+    <support_level>extended</support_level>\n+  </module>\n+  <application name=\"IVRDemo\" language=\"en_US\">\n+    <synopsis>IVR Demo Application.</synopsis>\n+    <syntax>\n+      <parameter name=\"filename\" required=\"true\"/>\n+    </syntax>\n+    <description>\n+      <para>This is a skeleton application that shows you the basic structure to create your\n+\t\t\town asterisk applications and demonstrates the IVR demo.</para>\n+    </description>\n+  </application>\n+  <module language=\"en_US\" name=\"app_exec\">\n+    <support_level>core</support_level>\n+  </module>\n+  <application name=\"Exec\" language=\"en_US\">\n+    <synopsis>Executes dialplan application.</synopsis>\n+    <syntax>\n+      <parameter name=\"appname\" required=\"true\" hasparams=\"true\">\n+        <para>Application name and arguments of the dialplan application to execute.</para>\n+        <argument name=\"arguments\" required=\"true\"/>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>Allows an arbitrary application to be invoked even when not\n+\t\t\thard coded into the dialplan.  If the underlying application\n+\t\t\tterminates the dialplan, or if the application cannot be found,\n+\t\t\tExec will terminate the dialplan.</para>\n+      <para>To invoke external applications, see the application System.\n+\t\t\tIf you would like to catch any error instead, see TryExec.</para>\n+    </description>\n+  </application>\n+  <application name=\"TryExec\" language=\"en_US\">\n+    <synopsis>Executes dialplan application, always returning.</synopsis>\n+    <syntax>\n+      <parameter name=\"appname\" required=\"true\" hasparams=\"true\">\n+        <argument name=\"arguments\" required=\"true\"/>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>Allows an arbitrary application to be invoked even when not\n+\t\t\thard coded into the dialplan. To invoke external applications\n+\t\t\tsee the application System.  Always returns to the dialplan.\n+\t\t\tThe channel variable TRYSTATUS will be set to one of:</para>\n+      <variablelist>\n+        <variable name=\"TRYSTATUS\">\n+          <value name=\"SUCCESS\">If the application returned zero.</value>\n+          <value name=\"FAILED\">If the application returned non-zero.</value>\n+          <value name=\"NOAPP\">If the application was not found or was not specified.</value>\n+        </variable>\n+      </variablelist>\n+    </description>\n+  </application>\n+  <application name=\"ExecIf\" language=\"en_US\">\n+    <synopsis>Executes dialplan application, conditionally.</synopsis>\n+    <syntax argsep=\"?\">\n+      <parameter name=\"expression\" required=\"true\"/>\n+      <parameter name=\"execapp\" required=\"true\" argsep=\":\">\n+        <argument name=\"appiftrue\" required=\"true\" hasparams=\"true\">\n+          <argument name=\"args\" required=\"true\"/>\n+        </argument>\n+        <argument name=\"appiffalse\" required=\"false\" hasparams=\"true\">\n+          <argument name=\"args\" required=\"true\"/>\n+        </argument>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>\n+        If\n+        <replaceable>expr</replaceable>\n+        is true, execute and return the\n+\t\t\tresult of\n+        <replaceable>appiftrue(args)</replaceable>\n+        .\n+      </para>\n+      <para>\n+        If\n+        <replaceable>expr</replaceable>\n+        is true, but\n+        <replaceable>appiftrue</replaceable>\n+        is not found,\n+\t\t\tthen the application will return a non-zero value.\n+      </para>\n+    </description>\n+  </application>\n+  <module language=\"en_US\" name=\"app_bridgewait\">\n+    <depend>bridge_holding</depend>\n+    <support_level>core</support_level>\n+  </module>\n+  <application name=\"BridgeWait\" language=\"en_US\">\n+    <synopsis>Put a call into the holding bridge.</synopsis>\n+    <syntax>\n+      <parameter name=\"name\">\n+        <para>\n+          Name of the holding bridge to join. This is a handle for\n+          <literal>BridgeWait</literal>\n+          only and does not affect the actual bridges that are created. If not provided,\n+\t\t\t\tthe reserved name\n+          <literal>default</literal>\n+          will be used.\n+        </para>\n+      </parameter>\n+      <parameter name=\"role\" required=\"false\">\n+        <para>Defines the channel's purpose for entering the holding bridge. Values are case sensitive.</para>\n+        <enumlist>\n+          <enum name=\"participant\">\n+            <para>The channel will enter the holding bridge to be placed on hold\n+\t\t\t\t\t\tuntil it is removed from the bridge for some reason. (default)</para>\n+          </enum>\n+          <enum name=\"announcer\">\n+            <para>The channel will enter the holding bridge to make announcements\n+\t\t\t\t\t\tto channels that are currently in the holding bridge. While an\n+\t\t\t\t\t\tannouncer is present, holding for the participants will be\n+\t\t\t\t\t\tsuspended.</para>\n+          </enum>\n+        </enumlist>\n+      </parameter>\n+      <parameter name=\"options\">\n+        <optionlist>\n+          <option name=\"m\">\n+            <argument name=\"class\" required=\"true\"/>\n+            <para>The specified MOH class will be used/suggested for\n+\t\t\t\t\t\tmusic on hold operations. This option will only be useful for\n+\t\t\t\t\t\tentertainment modes that use it (m and h).</para>\n+          </option>\n+          <option name=\"e\">\n+            <para>Which entertainment mechanism should be used while on hold\n+\t\t\t\t\t\tin the holding bridge. Only the first letter is read.</para>\n+            <enumlist>\n+              <enum name=\"m\">\n+                <para>Play music on hold (default)</para>\n+              </enum>\n+              <enum name=\"r\">\n+                <para>Ring without pause</para>\n+              </enum>\n+              <enum name=\"s\">\n+                <para>Generate silent audio</para>\n+              </enum>\n+              <enum name=\"h\">\n+                <para>Put the channel on hold</para>\n+              </enum>\n+              <enum name=\"n\">\n+                <para>No entertainment</para>\n+              </enum>\n+            </enumlist>\n+          </option>\n+          <option name=\"S\">\n+            <argument name=\"duration\" required=\"true\"/>\n+            <para>\n+              Automatically exit the bridge and return to the PBX after\n+              <emphasis>duration</emphasis>\n+              seconds.\n+            </para>\n+          </option>\n+        </optionlist>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>This application places the incoming channel into a holding bridge.\n+\t\t\tThe channel will then wait in the holding bridge until some event occurs\n+\t\t\twhich removes it from the holding bridge.</para>\n+      <note>\n+        <para>This application will answer calls which haven't already\n+\t\t\tbeen answered.</para>\n+      </note>\n+    </description>\n+  </application>\n+  <module language=\"en_US\" name=\"app_alarmreceiver\">\n+    <support_level>extended</support_level>\n+  </module>\n+  <application name=\"AlarmReceiver\" language=\"en_US\">\n+    <synopsis>Provide support for receiving alarm reports from a burglar or fire alarm panel.</synopsis>\n+    <syntax/>\n+    <description>\n+      <para>\n+        This application should be called whenever there is an alarm panel calling in to dump its events.\n+\t\t\tThe application will handshake with the alarm panel, and receive events, validate them, handshake them,\n+\t\t\tand store them until the panel hangs up. Once the panel hangs up, the application will run the system\n+\t\t\tcommand specified by the eventcmd setting in\n+        <filename>alarmreceiver.conf</filename>\n+        and pipe the\n+\t\t\tevents to the standard input of the application.\n+\t\t\tThe configuration file also contains settings for DTMF timing, and for the loudness of the\n+\t\t\tacknowledgement tones.\n+      </para>\n+      <note>\n+        <para>Few Ademco DTMF signalling formats are detected automatically: Contact ID, Express 4+1,\n+\t\t\tExpress 4+2, High Speed and Super Fast.</para>\n+      </note>\n+      <para>The application is affected by the following variables:</para>\n+      <variablelist>\n+        <variable name=\"ALARMRECEIVER_CALL_LIMIT\">\n+          <para>Maximum call time, in milliseconds.</para>\n+          <para>If set, this variable causes application to exit after the specified time.</para>\n+        </variable>\n+        <variable name=\"ALARMRECEIVER_RETRIES_LIMIT\">\n+          <para>Maximum number of retries per call.</para>\n+          <para>If set, this variable causes application to exit after the specified number of messages.</para>\n+        </variable>\n+      </variablelist>\n+    </description>\n+    <see-also>\n+      <ref type=\"filename\">alarmreceiver.conf</ref>\n+    </see-also>\n+  </application>\n+  <module language=\"en_US\" name=\"app_playback\">\n+    <support_level>core</support_level>\n+  </module>\n+  <application name=\"Playback\" language=\"en_US\">\n+    <synopsis>Play a file.</synopsis>\n+    <syntax>\n+      <parameter name=\"filenames\" required=\"true\" argsep=\"&amp;\">\n+        <argument name=\"filename\" required=\"true\"/>\n+        <argument name=\"filename2\" multiple=\"true\"/>\n+      </parameter>\n+      <parameter name=\"options\">\n+        <para>Comma separated list of options</para>\n+        <optionlist>\n+          <option name=\"skip\">\n+            <para>Do not play if not answered</para>\n+          </option>\n+          <option name=\"noanswer\">\n+            <para>Playback without answering, otherwise the channel will\n+\t\t\t\t\t\tbe answered before the sound is played.</para>\n+            <note>\n+              <para>Not all channel types support playing messages while still on hook.</para>\n+            </note>\n+          </option>\n+          <option name=\"say\">\n+            <para>Play using the say.conf file.</para>\n+          </option>\n+          <option name=\"mix\">\n+            <para>Play using a mix of filename and the say.conf file.</para>\n+          </option>\n+        </optionlist>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>Plays back given filenames (do not put extension of wav/alaw etc).\n+\t\t\tThe Playback application answers the channel if no options are specified.\n+\t\t\tIf the file is non-existent it will fail.</para>\n+      <para>This application sets the following channel variable upon completion:</para>\n+      <variablelist>\n+        <variable name=\"PLAYBACKSTATUS\">\n+          <para>The status of the playback attempt as a text string.</para>\n+          <value name=\"SUCCESS\"/>\n+          <value name=\"FAILED\"/>\n+        </variable>\n+      </variablelist>\n+      <para>See Also: Background (application) -- for playing sound files that are interruptible</para>\n+      <para>WaitExten (application) -- wait for digits from caller, optionally play music on hold</para>\n+    </description>\n+    <see-also>\n+      <ref type=\"application\">Background</ref>\n+      <ref type=\"application\">WaitExten</ref>\n+      <ref type=\"application\">ControlPlayback</ref>\n+      <ref type=\"agi\">stream file</ref>\n+      <ref type=\"agi\">control stream file</ref>\n+      <ref type=\"manager\">ControlPlayback</ref>\n+    </see-also>\n+  </application>\n+  <module language=\"en_US\" name=\"app_controlplayback\">\n+    <support_level>core</support_level>\n+  </module>\n+  <application name=\"ControlPlayback\" language=\"en_US\">\n+    <synopsis>Play a file with fast forward and rewind.</synopsis>\n+    <syntax>\n+      <parameter name=\"filename\" required=\"true\"/>\n+      <parameter name=\"skipms\">\n+        <para>This is number of milliseconds to skip when rewinding or\n+\t\t\t\tfast-forwarding.</para>\n+      </parameter>\n+      <parameter name=\"ff\">\n+        <para>\n+          Fast-forward when this DTMF digit is received. (defaults to\n+          <literal>#</literal>\n+          )\n+        </para>\n+      </parameter>\n+      <parameter name=\"rew\">\n+        <para>\n+          Rewind when this DTMF digit is received. (defaults to\n+          <literal>*</literal>\n+          )\n+        </para>\n+      </parameter>\n+      <parameter name=\"stop\">\n+        <para>Stop playback when this DTMF digit is received.</para>\n+      </parameter>\n+      <parameter name=\"pause\">\n+        <para>Pause playback when this DTMF digit is received.</para>\n+      </parameter>\n+      <parameter name=\"restart\">\n+        <para>Restart playback when this DTMF digit is received.</para>\n+      </parameter>\n+      <parameter name=\"options\">\n+        <optionlist>\n+          <option name=\"o\">\n+            <argument name=\"time\" required=\"true\">\n+              <para>\n+                Start at\n+                <replaceable>time</replaceable>\n+                ms from the\n+\t\t\t\t\t\t\tbeginning of the file.\n+              </para>\n+            </argument>\n+          </option>\n+        </optionlist>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>\n+        This application will play back the given\n+        <replaceable>filename</replaceable>\n+        .\n+      </para>\n+      <para>It sets the following channel variables upon completion:</para>\n+      <variablelist>\n+        <variable name=\"CPLAYBACKSTATUS\">\n+          <para>Contains the status of the attempt as a text string</para>\n+          <value name=\"SUCCESS\"/>\n+          <value name=\"USERSTOPPED\"/>\n+          <value name=\"REMOTESTOPPED\"/>\n+          <value name=\"ERROR\"/>\n+        </variable>\n+        <variable name=\"CPLAYBACKOFFSET\">\n+          <para>\n+            Contains the offset in ms into the file where playback\n+\t\t\t\t\twas at when it stopped.\n+            <literal>-1</literal>\n+            is end of file.\n+          </para>\n+        </variable>\n+        <variable name=\"CPLAYBACKSTOPKEY\">\n+          <para>If the playback is stopped by the user this variable contains\n+\t\t\t\t\tthe key that was pressed.</para>\n+        </variable>\n+      </variablelist>\n+    </description>\n+  </application>\n+  <manager name=\"ControlPlayback\" language=\"en_US\">\n+    <synopsis>Control the playback of a file being played to a channel.</synopsis>\n+    <syntax>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      <parameter name=\"Channel\" required=\"true\">\n+        <para>The name of the channel that currently has a file being played back to it.</para>\n+      </parameter>\n+      <parameter name=\"Control\" required=\"true\">\n+        <enumlist>\n+          <enum name=\"stop\">\n+            <para>Stop the playback operation.</para>\n+          </enum>\n+          <enum name=\"forward\">\n+            <para>\n+              Move the current position in the media forward. The amount\n+\t\t\t\t\t\tof time that the stream moves forward is determined by the\n+              <replaceable>skipms</replaceable>\n+              value passed to the application\n+\t\t\t\t\t\tthat initiated the playback.\n+            </para>\n+            <note>\n+              <para>\n+                The default skipms value is\n+                <literal>3000</literal>\n+                ms.\n+              </para>\n+            </note>\n+          </enum>\n+          <enum name=\"reverse\">\n+            <para>\n+              Move the current position in the media backward. The amount\n+\t\t\t\t\t\tof time that the stream moves backward is determined by the\n+              <replaceable>skipms</replaceable>\n+              value passed to the application\n+\t\t\t\t\t\tthat initiated the playback.\n+            </para>\n+            <note>\n+              <para>\n+                The default skipms value is\n+                <literal>3000</literal>\n+                ms.\n+              </para>\n+            </note>\n+          </enum>\n+          <enum name=\"pause\">\n+            <para>Pause/unpause the playback operation, if supported.\n+\t\t\t\t\t\tIf not supported, stop the playback.</para>\n+          </enum>\n+          <enum name=\"restart\">\n+            <para>Restart the playback operation, if supported.\n+\t\t\t\t\t\tIf not supported, stop the playback.</para>\n+          </enum>\n+        </enumlist>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>Control the operation of a media file being played back to a channel.\n+\t\t\tNote that this AMI action does not initiate playback of media to channel, but\n+\t\t\trather controls the operation of a media operation that was already initiated\n+\t\t\ton the channel.</para>\n+      <note>\n+        <para>\n+          The\n+          <literal>pause</literal>\n+          and\n+          <literal>restart</literal>\n+          <replaceable>Control</replaceable>\n+          options will stop a playback\n+\t\t\t\toperation if that operation was not initiated from the\n+          <replaceable>ControlPlayback</replaceable>\n+          application or the\n+          <replaceable>control stream file</replaceable>\n+          AGI command.\n+        </para>\n+      </note>\n+    </description>\n+    <see-also>\n+      <ref type=\"application\">Playback</ref>\n+      <ref type=\"application\">ControlPlayback</ref>\n+      <ref type=\"agi\">stream file</ref>\n+      <ref type=\"agi\">control stream file</ref>\n+    </see-also>\n+  </manager>\n+  <module language=\"en_US\" name=\"app_festival\">\n+    <support_level>extended</support_level>\n+  </module>\n+  <application name=\"Festival\" language=\"en_US\">\n+    <synopsis>Say text to the user.</synopsis>\n+    <syntax>\n+      <parameter name=\"text\" required=\"true\"/>\n+      <parameter name=\"intkeys\"/>\n+    </syntax>\n+    <description>\n+      <para>\n+        Connect to Festival, send the argument, get back the waveform, play it to the user,\n+\t\t\tallowing any given interrupt keys to immediately terminate and return the value, or\n+        <literal>any</literal>\n+        to allow any number back (useful in dialplan).\n+      </para>\n+    </description>\n+  </application>\n+  <module language=\"en_US\" name=\"app_skel\">\n+    <defaultenabled>no</defaultenabled>\n+    <support_level>core</support_level>\n+  </module>\n+  <application name=\"SkelGuessNumber\" language=\"en_US\">\n+    <synopsis>An example number guessing game</synopsis>\n+    <syntax>\n+      <parameter name=\"level\" required=\"true\"/>\n+      <parameter name=\"options\">\n+        <optionlist>\n+          <option name=\"c\">\n+            <para>The computer should cheat</para>\n+          </option>\n+          <option name=\"n\">\n+            <para>How many games to play before hanging up</para>\n+          </option>\n+        </optionlist>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>This simple number guessing application is a template to build other applications\n+\t\tfrom. It shows you the basic structure to create your own Asterisk applications.</para>\n+    </description>\n+  </application>\n+  <configInfo name=\"app_skel\" language=\"en_US\">\n+    <configFile name=\"app_skel.conf\">\n+      <configObject name=\"globals\">\n+        <synopsis>Options that apply globally to app_skel</synopsis>\n+        <configOption name=\"games\">\n+          <synopsis>The number of games a single execution of SkelGuessNumber will play</synopsis>\n+        </configOption>\n+        <configOption name=\"cheat\">\n+          <synopsis>Should the computer cheat?</synopsis>\n+          <description>\n+            <para>If enabled, the computer will ignore winning guesses.</para>\n+          </description>\n+        </configOption>\n+      </configObject>\n+      <configObject name=\"sounds\">\n+        <synopsis>Prompts for SkelGuessNumber to play</synopsis>\n+        <configOption name=\"prompt\" default=\"please-enter-your&amp;number&amp;queue-less-than\">\n+          <synopsis>A prompt directing the user to enter a number less than the max number</synopsis>\n+        </configOption>\n+        <configOption name=\"wrong_guess\" default=\"vm-pls-try-again\">\n+          <synopsis>The sound file to play when a wrong guess is made</synopsis>\n+        </configOption>\n+        <configOption name=\"right_guess\" default=\"auth-thankyou\">\n+          <synopsis>The sound file to play when a correct guess is made</synopsis>\n+        </configOption>\n+        <configOption name=\"too_low\">\n+          <synopsis>The sound file to play when a guess is too low</synopsis>\n+        </configOption>\n+        <configOption name=\"too_high\">\n+          <synopsis>The sound file to play when a guess is too high</synopsis>\n+        </configOption>\n+        <configOption name=\"lose\" default=\"vm-goodbye\">\n+          <synopsis>The sound file to play when a player loses</synopsis>\n+        </configOption>\n+      </configObject>\n+      <configObject name=\"level\">\n+        <synopsis>Defined levels for the SkelGuessNumber game</synopsis>\n+        <configOption name=\"max_number\">\n+          <synopsis>The maximum in the range of numbers to guess (1 is the implied minimum)</synopsis>\n+        </configOption>\n+        <configOption name=\"max_guesses\">\n+          <synopsis>The maximum number of guesses before a game is considered lost</synopsis>\n+        </configOption>\n+      </configObject>\n+    </configFile>\n+  </configInfo>\n+  <module language=\"en_US\" name=\"app_voicemail\">\n+    <use type=\"module\">res_adsi</use>\n+    <use type=\"module\">res_smdi</use>\n+    <defaultenabled>yes</defaultenabled>\n+    <support_level>core</support_level>\n+  </module>\n+  <application name=\"VoiceMail\" language=\"en_US\">\n+    <synopsis>Leave a Voicemail message.</synopsis>\n+    <syntax>\n+      <parameter name=\"mailboxs\" argsep=\"&amp;\" required=\"true\">\n+        <argument name=\"mailbox1\" argsep=\"@\" required=\"true\">\n+          <argument name=\"mailbox\" required=\"true\"/>\n+          <argument name=\"context\"/>\n         </argument>\n         <argument name=\"mailbox2\" argsep=\"@\" multiple=\"true\">\n           <argument name=\"mailbox\" required=\"true\"/>\n           <argument name=\"context\"/>\n         </argument>\n       </parameter>\n       <parameter name=\"options\">\n@@ -3904,250 +7261,89 @@\n \t\t\twithin\n         <replaceable>Context</replaceable>\n         will be polled.\n \t\t\tOtherwise, only a single mailbox will be polled for changes.\n       </para>\n     </description>\n   </manager>\n-  <module language=\"en_US\" name=\"app_speech_utils\">\n-    <depend>res_speech</depend>\n-    <support_level>core</support_level>\n-  </module>\n-  <application name=\"SpeechCreate\" language=\"en_US\">\n-    <synopsis>Create a Speech Structure.</synopsis>\n-    <syntax>\n-      <parameter name=\"engine_name\" required=\"true\"/>\n-    </syntax>\n-    <description>\n-      <para>This application creates information to be used by all the other applications.\n-\t\t\tIt must be called before doing any speech recognition activities such as activating a grammar.\n-\t\t\tIt takes the engine name to use as the argument, if not specified the default engine will be used.</para>\n-      <para>Sets the ERROR channel variable to 1 if the engine cannot be used.</para>\n-    </description>\n-  </application>\n-  <application name=\"SpeechActivateGrammar\" language=\"en_US\">\n-    <synopsis>Activate a grammar.</synopsis>\n-    <syntax>\n-      <parameter name=\"grammar_name\" required=\"true\"/>\n-    </syntax>\n-    <description>\n-      <para>This activates the specified grammar to be recognized by the engine.\n-\t\t\tA grammar tells the speech recognition engine what to recognize, and how to portray it back to you\n-\t\t\tin the dialplan. The grammar name is the only argument to this application.</para>\n-      <para>Hangs up the channel on failure. If this is not desired, use TryExec.</para>\n-    </description>\n-  </application>\n-  <application name=\"SpeechStart\" language=\"en_US\">\n-    <synopsis>Start recognizing voice in the audio stream.</synopsis>\n-    <syntax/>\n-    <description>\n-      <para>Tell the speech recognition engine that it should start trying to get results from audio being\n-\t\t\tfed to it.</para>\n-      <para>Hangs up the channel on failure. If this is not desired, use TryExec.</para>\n-    </description>\n-  </application>\n-  <application name=\"SpeechBackground\" language=\"en_US\">\n-    <synopsis>Play a sound file and wait for speech to be recognized.</synopsis>\n-    <syntax>\n-      <parameter name=\"sound_file\" required=\"true\"/>\n-      <parameter name=\"timeout\">\n-        <para>Timeout integer in seconds. Note the timeout will only start\n-\t\t\t\tonce the sound file has stopped playing.</para>\n-      </parameter>\n-      <parameter name=\"options\">\n-        <optionlist>\n-          <option name=\"n\">\n-            <para>Don't answer the channel if it has not already been answered.</para>\n-          </option>\n-        </optionlist>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>This application plays a sound file and waits for the person to speak. Once they start speaking playback\n-\t\t\tof the file stops, and silence is heard. Once they stop talking the processing sound is played to indicate\n-\t\t\tthe speech recognition engine is working. Once results are available the application returns and results\n-\t\t\t(score and text) are available using dialplan functions.</para>\n-      <para>The first text and score are ${SPEECH_TEXT(0)} AND ${SPEECH_SCORE(0)} while the second are ${SPEECH_TEXT(1)}\n-\t\t\tand ${SPEECH_SCORE(1)}.</para>\n-      <para>The first argument is the sound file and the second is the timeout integer in seconds.</para>\n-      <para>Hangs up the channel on failure. If this is not desired, use TryExec.</para>\n-    </description>\n-  </application>\n-  <application name=\"SpeechDeactivateGrammar\" language=\"en_US\">\n-    <synopsis>Deactivate a grammar.</synopsis>\n-    <syntax>\n-      <parameter name=\"grammar_name\" required=\"true\">\n-        <para>The grammar name to deactivate</para>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>This deactivates the specified grammar so that it is no longer recognized.</para>\n-      <para>Hangs up the channel on failure. If this is not desired, use TryExec.</para>\n-    </description>\n-  </application>\n-  <application name=\"SpeechProcessingSound\" language=\"en_US\">\n-    <synopsis>Change background processing sound.</synopsis>\n-    <syntax>\n-      <parameter name=\"sound_file\" required=\"true\"/>\n-    </syntax>\n-    <description>\n-      <para>This changes the processing sound that SpeechBackground plays back when the speech recognition engine is\n-\t\t\tprocessing and working to get results.</para>\n-      <para>Hangs up the channel on failure. If this is not desired, use TryExec.</para>\n-    </description>\n-  </application>\n-  <application name=\"SpeechDestroy\" language=\"en_US\">\n-    <synopsis>End speech recognition.</synopsis>\n-    <syntax/>\n-    <description>\n-      <para>This destroys the information used by all the other speech recognition applications.\n-\t\t\tIf you call this application but end up wanting to recognize more speech, you must call SpeechCreate()\n-\t\t\tagain before calling any other application.</para>\n-      <para>Hangs up the channel on failure. If this is not desired, use TryExec.</para>\n-    </description>\n-  </application>\n-  <application name=\"SpeechLoadGrammar\" language=\"en_US\">\n-    <synopsis>Load a grammar.</synopsis>\n-    <syntax>\n-      <parameter name=\"grammar_name\" required=\"true\"/>\n-      <parameter name=\"path\" required=\"true\"/>\n-    </syntax>\n-    <description>\n-      <para>Load a grammar only on the channel, not globally.</para>\n-      <para>Hangs up the channel on failure. If this is not desired, use TryExec.</para>\n-    </description>\n-  </application>\n-  <application name=\"SpeechUnloadGrammar\" language=\"en_US\">\n-    <synopsis>Unload a grammar.</synopsis>\n-    <syntax>\n-      <parameter name=\"grammar_name\" required=\"true\"/>\n-    </syntax>\n-    <description>\n-      <para>Unload a grammar.</para>\n-      <para>Hangs up the channel on failure. If this is not desired, use TryExec.</para>\n-    </description>\n-  </application>\n-  <function name=\"SPEECH_SCORE\" language=\"en_US\">\n-    <synopsis>Gets the confidence score of a result.</synopsis>\n-    <syntax argsep=\"/\">\n-      <parameter name=\"nbest_number\"/>\n-      <parameter name=\"result_number\" required=\"true\"/>\n-    </syntax>\n-    <description>\n-      <para>Gets the confidence score of a result.</para>\n-    </description>\n-  </function>\n-  <function name=\"SPEECH_TEXT\" language=\"en_US\">\n-    <synopsis>Gets the recognized text of a result.</synopsis>\n-    <syntax argsep=\"/\">\n-      <parameter name=\"nbest_number\"/>\n-      <parameter name=\"result_number\" required=\"true\"/>\n-    </syntax>\n-    <description>\n-      <para>Gets the recognized text of a result.</para>\n-    </description>\n-  </function>\n-  <function name=\"SPEECH_GRAMMAR\" language=\"en_US\">\n-    <synopsis>Gets the matched grammar of a result if available.</synopsis>\n-    <syntax argsep=\"/\">\n-      <parameter name=\"nbest_number\"/>\n-      <parameter name=\"result_number\" required=\"true\"/>\n-    </syntax>\n-    <description>\n-      <para>Gets the matched grammar of a result if available.</para>\n-    </description>\n-  </function>\n-  <function name=\"SPEECH_ENGINE\" language=\"en_US\">\n-    <synopsis>Get or change a speech engine specific attribute.</synopsis>\n-    <syntax>\n-      <parameter name=\"name\" required=\"true\"/>\n-    </syntax>\n-    <description>\n-      <para>Changes a speech engine specific attribute.</para>\n-    </description>\n-  </function>\n-  <function name=\"SPEECH_RESULTS_TYPE\" language=\"en_US\">\n-    <synopsis>Sets the type of results that will be returned.</synopsis>\n-    <syntax/>\n-    <description>\n-      <para>Sets the type of results that will be returned. Valid options are normal or nbest.</para>\n-    </description>\n-  </function>\n-  <function name=\"SPEECH\" language=\"en_US\">\n-    <synopsis>Gets information about speech recognition results.</synopsis>\n-    <syntax>\n-      <parameter name=\"argument\" required=\"true\">\n-        <enumlist>\n-          <enum name=\"status\">\n-            <para>\n-              Returns\n-              <literal>1</literal>\n-              upon speech object existing,\n-\t\t\t\t\t\tor\n-              <literal>0</literal>\n-              if not\n-            </para>\n-          </enum>\n-          <enum name=\"spoke\">\n-            <para>\n-              Returns\n-              <literal>1</literal>\n-              if spoker spoke,\n-\t\t\t\t\t\tor\n-              <literal>0</literal>\n-              if not\n-            </para>\n-          </enum>\n-          <enum name=\"results\">\n-            <para>Returns number of results that were recognized.</para>\n-          </enum>\n-        </enumlist>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>Gets information about speech recognition results.</para>\n-    </description>\n-  </function>\n-  <module language=\"en_US\" name=\"app_bridgeaddchan\">\n-    <support_level>core</support_level>\n+  <module language=\"en_US\" name=\"app_morsecode\">\n+    <support_level>extended</support_level>\n   </module>\n-  <application name=\"BridgeAdd\" language=\"en_US\">\n-    <synopsis>Join a bridge that contains the specified channel.</synopsis>\n+  <application name=\"Morsecode\" language=\"en_US\">\n+    <synopsis>Plays morse code.</synopsis>\n     <syntax>\n-      <parameter name=\"name\">\n-        <para>Name of the channel in an existing bridge</para>\n+      <parameter name=\"string\" required=\"true\">\n+        <para>String to playback as morse code to channel</para>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>This application places the incoming channel into\n-\t\t\tthe bridge containing the specified channel. The specified\n-\t\t\tchannel only needs to be the prefix of a full channel name\n-\t\t\tIE. 'SIP/cisco0001'.</para>\n+      <para>Plays the Morse code equivalent of the passed string.</para>\n+      <para>This application does not automatically answer and should be preceeded by\n+\t\t\tan application such as Answer() or Progress().</para>\n+      <para>This application uses the following variables:</para>\n+      <variablelist>\n+        <variable name=\"MORSEDITLEN\">\n+          <para>Use this value in (ms) for length of dit</para>\n+        </variable>\n+        <variable name=\"MORSETONE\">\n+          <para>The pitch of the tone in (Hz), default is 800</para>\n+        </variable>\n+        <variable name=\"MORSESPACETONE\">\n+          <para>The pitch of the spaces in (Hz), default is 0</para>\n+        </variable>\n+        <variable name=\"MORSETYPE\">\n+          <para>The code type to use (AMERICAN for standard American Morse\n+\t\t\t\t\tor INTERNATIONAL for international code.\n+\t\t\t\t\tDefault is INTERNATIONAL).</para>\n+        </variable>\n+      </variablelist>\n     </description>\n+    <see-also>\n+      <ref type=\"application\">SayAlpha</ref>\n+      <ref type=\"application\">SayPhonetic</ref>\n+    </see-also>\n   </application>\n-  <module language=\"en_US\" name=\"app_mp3\">\n+  <module language=\"en_US\" name=\"app_jack\">\n+    <depend>jack</depend>\n+    <depend>resample</depend>\n     <support_level>extended</support_level>\n   </module>\n-  <application name=\"MP3Player\" language=\"en_US\">\n-    <synopsis>Play an MP3 file or M3U playlist file or stream.</synopsis>\n+  <application name=\"JACK\" language=\"en_US\">\n+    <synopsis>Jack Audio Connection Kit</synopsis>\n     <syntax>\n-      <parameter name=\"Location\" required=\"true\">\n-        <para>Location of the file to be played.\n-\t\t\t\t(argument passed to mpg123)</para>\n+      <parameter name=\"options\" required=\"false\">\n+        <optionlist>\n+          <option name=\"s\">\n+            <argument name=\"name\" required=\"true\">\n+              <para>Connect to the specified jack server name</para>\n+            </argument>\n+          </option>\n+          <option name=\"i\">\n+            <argument name=\"name\" required=\"true\">\n+              <para>Connect the output port that gets created to the specified jack input port</para>\n+            </argument>\n+          </option>\n+          <option name=\"o\">\n+            <argument name=\"name\" required=\"true\">\n+              <para>Connect the input port that gets created to the specified jack output port</para>\n+            </argument>\n+          </option>\n+          <option name=\"c\">\n+            <argument name=\"name\" required=\"true\">\n+              <para>By default, Asterisk will use the channel name for the jack client name.</para>\n+              <para>Use this option to specify a custom client name.</para>\n+            </argument>\n+          </option>\n+        </optionlist>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>Executes mpg123 to play the given location, which typically would be a mp3 filename\n-\t\t\tor m3u playlist filename or a URL. Please read https://en.wikipedia.org/wiki/M3U\n-\t\t\tto see what the M3U playlist file format is like.</para>\n-      <para>Note that mpg123 does not support HTTPS, so use HTTP for web streams.</para>\n-      <para>User can exit by pressing any key on the dialpad, or by hanging up.</para>\n-      <example title=\"Play an MP3 playlist\">exten =&gt; 1234,1,MP3Player(/var/lib/asterisk/playlist.m3u)</example>\n-      <para>This application does not automatically answer and should be preceeded by an\n-\t\t\tapplication such as Answer() or Progress().</para>\n+      <para>When executing this application, two jack ports will be created;\n+\t\t\tone input and one output. Other applications can be hooked up to\n+\t\t\tthese ports to access audio coming from, or being send to the channel.</para>\n     </description>\n   </application>\n   <module language=\"en_US\" name=\"app_waituntil\">\n     <support_level>core</support_level>\n   </module>\n   <application name=\"WaitUntil\" language=\"en_US\">\n     <synopsis>Wait (sleep) until the current time is the given epoch.</synopsis>\n@@ -4171,2063 +7367,732 @@\n           <value name=\"FAILURE\">Invalid argument.</value>\n           <value name=\"HANGUP\">Channel hungup before time elapsed.</value>\n           <value name=\"PAST\">Time specified had already past.</value>\n         </variable>\n       </variablelist>\n     </description>\n   </application>\n-  <module language=\"en_US\" name=\"app_statsd\">\n-    <depend>res_statsd</depend>\n-    <defaultenabled>no</defaultenabled>\n-    <support_level>extended</support_level>\n-  </module>\n-  <application name=\"StatsD\" language=\"en_US\">\n-    <synopsis>Allow statistics to be passed to the StatsD server from the dialplan.</synopsis>\n-    <syntax>\n-      <parameter name=\"metric_type\" required=\"true\">\n-        <para>The metric type to be sent to StatsD. Valid metric types\n-\t\t\t\tare 'g' for gauge, 'c' for counter, 'ms' for timer, and 's' for\n-\t\t\t\tsets.</para>\n-      </parameter>\n-      <parameter name=\"statistic_name\" required=\"true\">\n-        <para>The name of the variable to be sent to StatsD. Statistic\n-\t\t\t\tnames cannot contain the pipe (|) character.</para>\n-      </parameter>\n-      <parameter name=\"value\" required=\"true\">\n-        <para>The value of the variable to be sent to StatsD. Values\n-\t\t\t\tmust be numeric. Values for gauge and counter metrics can be\n-\t\t\t\tsent with a '+' or '-' to update a value after the value has\n-\t\t\t\tbeen initialized. Only counters can be initialized as negative.\n-\t\t\t\tSets can send a string as the value parameter, but the string\n-\t\t\t\tcannot contain the pipe character.</para>\n-      </parameter>\n-      <parameter name=\"sample_rate\">\n-        <para>The value of the sample rate to be sent to StatsD. Sample\n-\t\t\t\trates less than or equal to 0 will never be sent and sample rates\n-\t\t\t\tgreater than or equal to 1 will always be sent. Any rate\n-\t\t\t\tbetween 1 and 0 will be compared to a randomly generated value,\n-\t\t\t\tand if it is greater than the random value, it will be sent.</para>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>\n-        This dialplan application sends statistics to the StatsD\n-\t\t\tserver specified inside of\n-        <literal>statsd.conf</literal>\n-        .\n-      </para>\n-    </description>\n-  </application>\n-  <module language=\"en_US\" name=\"app_forkcdr\">\n+  <module language=\"en_US\" name=\"app_queue\">\n+    <use type=\"module\">res_monitor</use>\n     <support_level>core</support_level>\n   </module>\n-  <application name=\"ForkCDR\" language=\"en_US\">\n-    <synopsis>Forks the current Call Data Record for this channel.</synopsis>\n+  <application name=\"Queue\" language=\"en_US\">\n+    <synopsis>Queue a call for a call queue.</synopsis>\n     <syntax>\n+      <parameter name=\"queuename\" required=\"true\"/>\n       <parameter name=\"options\">\n         <optionlist>\n-          <option name=\"a\">\n-            <para>If the channel is answered, set the answer time on\n-\t\t\t\t\t\tthe forked CDR to the current time. If this option is\n-\t\t\t\t\t\tnot used, the answer time on the forked CDR will be the\n-\t\t\t\t\t\tanswer time on the original CDR. If the channel is not\n-\t\t\t\t\t\tanswered, this option has no effect.</para>\n+          <option name=\"b\" argsep=\"^\">\n             <para>\n-              Note that this option is implicitly assumed if the\n-              <literal>r</literal>\n-              option is used.\n+              Before initiating an outgoing call,\n+              <literal>Gosub</literal>\n+              to the specified\n+\t\t\t\t\t\tlocation using the newly created channel.  The\n+              <literal>Gosub</literal>\n+              will be\n+\t\t\t\t\t\texecuted for each destination channel.\n             </para>\n+            <argument name=\"context\" required=\"false\"/>\n+            <argument name=\"exten\" required=\"false\"/>\n+            <argument name=\"priority\" required=\"true\" hasparams=\"optional\" argsep=\"^\">\n+              <argument name=\"arg1\" multiple=\"true\" required=\"true\"/>\n+              <argument name=\"argN\"/>\n+            </argument>\n           </option>\n-          <option name=\"e\">\n-            <para>End (finalize) the original CDR.</para>\n+          <option name=\"B\" argsep=\"^\">\n+            <para>\n+              Before initiating the outgoing call(s),\n+              <literal>Gosub</literal>\n+              to the\n+\t\t\t\t\t\tspecified location using the current channel.\n+            </para>\n+            <argument name=\"context\" required=\"false\"/>\n+            <argument name=\"exten\" required=\"false\"/>\n+            <argument name=\"priority\" required=\"true\" hasparams=\"optional\" argsep=\"^\">\n+              <argument name=\"arg1\" multiple=\"true\" required=\"true\"/>\n+              <argument name=\"argN\"/>\n+            </argument>\n+          </option>\n+          <option name=\"C\">\n+            <para>Mark all calls as &quot;answered elsewhere&quot; when cancelled.</para>\n+          </option>\n+          <option name=\"c\">\n+            <para>Continue in the dialplan if the callee hangs up.</para>\n+          </option>\n+          <option name=\"d\">\n+            <para>data-quality (modem) call (minimum delay).</para>\n+          </option>\n+          <option name=\"F\" argsep=\"^\">\n+            <argument name=\"context\" required=\"false\"/>\n+            <argument name=\"exten\" required=\"false\"/>\n+            <argument name=\"priority\" required=\"true\"/>\n+            <para>\n+              When the caller hangs up, transfer the\n+              <emphasis>called member</emphasis>\n+              to the specified destination and\n+              <emphasis>start</emphasis>\n+              execution at that location.\n+            </para>\n+            <para>NOTE: Any channel variables you want the called channel to inherit from the caller channel must be\n+\t\t\t\t\t\tprefixed with one or two underbars ('_').</para>\n+          </option>\n+          <option name=\"F\">\n+            <para>\n+              When the caller hangs up, transfer the\n+              <emphasis>called member</emphasis>\n+              to the next priority of\n+\t\t\t\t\t\tthe current extension and\n+              <emphasis>start</emphasis>\n+              execution at that location.\n+            </para>\n+            <para>NOTE: Any channel variables you want the called channel to inherit from the caller channel must be\n+\t\t\t\t\t\tprefixed with one or two underbars ('_').</para>\n+            <para>NOTE: Using this option from a Macro() or GoSub() might not make sense as there would be no return points.</para>\n+          </option>\n+          <option name=\"h\">\n+            <para>\n+              Allow\n+              <emphasis>callee</emphasis>\n+              to hang up by pressing\n+              <literal>*</literal>\n+              .\n+            </para>\n+          </option>\n+          <option name=\"H\">\n+            <para>\n+              Allow\n+              <emphasis>caller</emphasis>\n+              to hang up by pressing\n+              <literal>*</literal>\n+              .\n+            </para>\n+          </option>\n+          <option name=\"i\">\n+            <para>Ignore call forward requests from queue members and do nothing\n+\t\t\t\t\t\twhen they are requested.</para>\n+          </option>\n+          <option name=\"I\">\n+            <para>Asterisk will ignore any connected line update requests or any redirecting party\n+\t\t\t\t\t\tupdate requests it may receive on this dial attempt.</para>\n+          </option>\n+          <option name=\"k\">\n+            <para>\n+              Allow the\n+              <emphasis>called</emphasis>\n+              party to enable parking of the call by sending\n+\t\t\t\t\t\tthe DTMF sequence defined for call parking in\n+              <filename>features.conf</filename>\n+              .\n+            </para>\n+          </option>\n+          <option name=\"K\">\n+            <para>\n+              Allow the\n+              <emphasis>calling</emphasis>\n+              party to enable parking of the call by sending\n+\t\t\t\t\t\tthe DTMF sequence defined for call parking in\n+              <filename>features.conf</filename>\n+              .\n+            </para>\n+          </option>\n+          <option name=\"m\">\n+            <para>\n+              Custom music on hold class to use, which will override the music on hold class configured\n+\t\t\t\t\t\tin\n+              <filename>queues.conf</filename>\n+              , if specified.\n+            </para>\n+            <para>Note that CHANNEL(musicclass), if set, will still override this option.</para>\n+          </option>\n+          <option name=\"n\">\n+            <para>No retries on the timeout; will exit this application and\n+\t\t\t\t\t\tgo to the next step.</para>\n           </option>\n           <option name=\"r\">\n-            <para>Reset the start and answer times on the forked CDR.\n-\t\t\t\t\t\tThis will set the start and answer times (if the channel\n-\t\t\t\t\t\tis answered) to be set to the current time.</para>\n+            <para>Ring instead of playing MOH. Periodic Announcements are still made, if applicable.</para>\n+          </option>\n+          <option name=\"R\">\n+            <para>Ring instead of playing MOH when a member channel is actually ringing.</para>\n+          </option>\n+          <option name=\"t\">\n             <para>\n-              Note that this option implicitly assumes the\n-              <literal>a</literal>\n-              option.\n+              Allow the\n+              <emphasis>called</emphasis>\n+              user to transfer the calling user.\n             </para>\n           </option>\n-          <option name=\"v\">\n-            <para>Do not copy CDR variables and attributes from the\n-\t\t\t\t\t\toriginal CDR to the forked CDR.</para>\n-            <warning>\n-              <para>This option has changed. Previously, the\n-\t\t\t\t\t\tvariables were removed from the original CDR. This no\n-\t\t\t\t\t\tlonger occurs - this option now controls whether or not\n-\t\t\t\t\t\ta forked CDR inherits the variables from the original\n-\t\t\t\t\t\tCDR.</para>\n-            </warning>\n+          <option name=\"T\">\n+            <para>\n+              Allow the\n+              <emphasis>calling</emphasis>\n+              user to transfer the call.\n+            </para>\n           </option>\n-        </optionlist>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>Causes the Call Data Record engine to fork a new CDR starting\n-\t\t\tfrom the time the application is executed. The forked CDR will be\n-\t\t\tlinked to the end of the CDRs associated with the channel.</para>\n-    </description>\n-    <see-also>\n-      <ref type=\"function\">CDR</ref>\n-      <ref type=\"application\">NoCDR</ref>\n-      <ref type=\"application\">ResetCDR</ref>\n-    </see-also>\n-  </application>\n-  <module language=\"en_US\" name=\"app_minivm\">\n-    <support_level>extended</support_level>\n-  </module>\n-  <application name=\"MinivmRecord\" language=\"en_US\">\n-    <synopsis>Receive Mini-Voicemail and forward via e-mail.</synopsis>\n-    <syntax>\n-      <parameter name=\"mailbox\" required=\"true\" argsep=\"@\">\n-        <argument name=\"username\" required=\"true\">\n-          <para>Voicemail username</para>\n-        </argument>\n-        <argument name=\"domain\" required=\"true\">\n-          <para>Voicemail domain</para>\n-        </argument>\n-      </parameter>\n-      <parameter name=\"options\" required=\"false\">\n-        <optionlist>\n-          <option name=\"0\">\n+          <option name=\"w\">\n             <para>\n-              Jump to the\n-              <literal>o</literal>\n-              extension in the current dialplan context.\n+              Allow the\n+              <emphasis>called</emphasis>\n+              user to write the conversation to\n+\t\t\t\t\t\tdisk via Monitor.\n             </para>\n           </option>\n-          <option name=\"*\">\n+          <option name=\"W\">\n             <para>\n-              Jump to the\n-              <literal>a</literal>\n-              extension in the current dialplan context.\n+              Allow the\n+              <emphasis>calling</emphasis>\n+              user to write the conversation to\n+\t\t\t\t\t\tdisk via Monitor.\n             </para>\n           </option>\n-          <option name=\"g\">\n-            <argument name=\"gain\">\n-              <para>Amount of gain to use</para>\n-            </argument>\n-            <para>Use the specified amount of gain when recording the voicemail message.\n-\t\t\t\t\tThe units are whole-number decibels (dB).</para>\n+          <option name=\"x\">\n+            <para>\n+              Allow the\n+              <emphasis>called</emphasis>\n+              user to write the conversation\n+\t\t\t\t\t\tto disk via MixMonitor.\n+            </para>\n+          </option>\n+          <option name=\"X\">\n+            <para>\n+              Allow the\n+              <emphasis>calling</emphasis>\n+              user to write the conversation to\n+\t\t\t\t\t\tdisk via MixMonitor.\n+            </para>\n           </option>\n         </optionlist>\n       </parameter>\n-    </syntax>\n-    <description>\n-      <para>\n-        This application is part of the Mini-Voicemail system, configured in\n-        <filename>minivm.conf</filename>\n-      </para>\n-      <para>MiniVM records audio file in configured format and forwards message to e-mail and pager.</para>\n-      <para>If there's no user account for that address, a temporary account will be used with default options.</para>\n-      <para>\n-        The recorded file name and path will be stored in\n-        <variable>MVM_FILENAME</variable>\n-        and the duration\n-\t\tof the message will be stored in\n-        <variable>MVM_DURATION</variable>\n-      </para>\n-      <note>\n+      <parameter name=\"URL\">\n         <para>\n-          If the caller hangs up after the recording, the only way to send the message and clean up is to\n-\t\texecute in the\n-          <literal>h</literal>\n-          extension. The application will exit if any of the following DTMF digits\n-\t\tare received and the requested extension exist in the current context.\n+          <replaceable>URL</replaceable>\n+          will be sent to the called party if the channel supports it.\n         </para>\n-      </note>\n+      </parameter>\n+      <parameter name=\"announceoverride\" argsep=\"&amp;\">\n+        <argument name=\"filename\" required=\"true\">\n+          <para>\n+            Announcement file(s) to play to agent before bridging call, overriding the announcement(s)\n+\t\t\t\t\tconfigured in\n+            <filename>queues.conf</filename>\n+            , if any.\n+          </para>\n+        </argument>\n+        <argument name=\"filename2\" multiple=\"true\"/>\n+      </parameter>\n+      <parameter name=\"timeout\">\n+        <para>\n+          Will cause the queue to fail out after a specified number of\n+\t\t\t\tseconds, checked between each\n+          <filename>queues.conf</filename>\n+          <replaceable>timeout</replaceable>\n+          and\n+          <replaceable>retry</replaceable>\n+          cycle.\n+        </para>\n+      </parameter>\n+      <parameter name=\"AGI\">\n+        <para>Will setup an AGI script to be executed on the calling party's channel once they are\n+\t\t\t\tconnected to a queue member.</para>\n+      </parameter>\n+      <parameter name=\"macro\">\n+        <para>Will run a macro on the called party's channel (the queue member) once the parties are connected.</para>\n+        <para>NOTE: Macros are deprecated, GoSub should be used instead.</para>\n+      </parameter>\n+      <parameter name=\"gosub\">\n+        <para>Will run a gosub on the called party's channel (the queue member)\n+\t\t\t\tonce the parties are connected.  The subroutine execution starts in the\n+\t\t\t\tnamed context at the s exten and priority 1.</para>\n+      </parameter>\n+      <parameter name=\"rule\">\n+        <para>Will cause the queue's defaultrule to be overridden by the rule specified.</para>\n+      </parameter>\n+      <parameter name=\"position\">\n+        <para>\n+          Attempt to enter the caller into the queue at the numerical position specified.\n+          <literal>1</literal>\n+          would attempt to enter the caller at the head of the queue, and\n+          <literal>3</literal>\n+          would attempt to place\n+\t\t\t\tthe caller third in the queue.\n+        </para>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>In addition to transferring the call, a call may be parked and then picked\n+\t\t\tup by another user.</para>\n+      <para>This application will return to the dialplan if the queue does not exist, or\n+\t\t\tany of the join options cause the caller to not enter the queue.</para>\n+      <para>This application does not automatically answer and should be preceeded\n+\t\t\tby an application such as Answer(), Progress(), or Ringing().</para>\n+      <para>This application sets the following channel variables upon completion:</para>\n       <variablelist>\n-        <variable name=\"MVM_RECORD_STATUS\">\n-          <para>This is the status of the record operation</para>\n-          <value name=\"SUCCESS\"/>\n-          <value name=\"USEREXIT\"/>\n-          <value name=\"FAILED\"/>\n+        <variable name=\"QUEUESTATUS\">\n+          <para>The status of the call as a text string.</para>\n+          <value name=\"TIMEOUT\"/>\n+          <value name=\"FULL\"/>\n+          <value name=\"JOINEMPTY\"/>\n+          <value name=\"LEAVEEMPTY\"/>\n+          <value name=\"JOINUNAVAIL\"/>\n+          <value name=\"LEAVEUNAVAIL\"/>\n+          <value name=\"CONTINUE\"/>\n+          <value name=\"WITHDRAW\"/>\n+        </variable>\n+        <variable name=\"ABANDONED\">\n+          <para>If the call was not answered by an agent this variable will be TRUE.</para>\n+          <value name=\"TRUE\"/>\n+        </variable>\n+        <variable name=\"DIALEDPEERNUMBER\">\n+          <para>Resource of the agent that was dialed set on the outbound channel.</para>\n+        </variable>\n+        <variable name=\"QUEUE_WITHDRAW_INFO\">\n+          <para>If the call was successfully withdrawn from the queue, and the withdraw request was provided with optional withdraw info, the withdraw info will be stored in this variable.</para>\n         </variable>\n       </variablelist>\n     </description>\n+    <see-also>\n+      <ref type=\"application\">Queue</ref>\n+      <ref type=\"application\">QueueLog</ref>\n+      <ref type=\"application\">AddQueueMember</ref>\n+      <ref type=\"application\">RemoveQueueMember</ref>\n+      <ref type=\"application\">PauseQueueMember</ref>\n+      <ref type=\"application\">UnpauseQueueMember</ref>\n+      <ref type=\"function\">QUEUE_VARIABLES</ref>\n+      <ref type=\"function\">QUEUE_MEMBER</ref>\n+      <ref type=\"function\">QUEUE_MEMBER_COUNT</ref>\n+      <ref type=\"function\">QUEUE_EXISTS</ref>\n+      <ref type=\"function\">QUEUE_GET_CHANNEL</ref>\n+      <ref type=\"function\">QUEUE_WAITING_COUNT</ref>\n+      <ref type=\"function\">QUEUE_MEMBER_LIST</ref>\n+      <ref type=\"function\">QUEUE_MEMBER_PENALTY</ref>\n+    </see-also>\n   </application>\n-  <application name=\"MinivmGreet\" language=\"en_US\">\n-    <synopsis>Play Mini-Voicemail prompts.</synopsis>\n+  <application name=\"AddQueueMember\" language=\"en_US\">\n+    <synopsis>Dynamically adds queue members.</synopsis>\n     <syntax>\n-      <parameter name=\"mailbox\" required=\"true\" argsep=\"@\">\n-        <argument name=\"username\" required=\"true\">\n-          <para>Voicemail username</para>\n-        </argument>\n-        <argument name=\"domain\" required=\"true\">\n-          <para>Voicemail domain</para>\n-        </argument>\n-      </parameter>\n-      <parameter name=\"options\" required=\"false\">\n-        <optionlist>\n-          <option name=\"b\">\n-            <para>\n-              Play the\n-              <literal>busy</literal>\n-              greeting to the calling party.\n-            </para>\n-          </option>\n-          <option name=\"s\">\n-            <para>Skip the playback of instructions for leaving a message to the calling party.</para>\n-          </option>\n-          <option name=\"u\">\n-            <para>\n-              Play the\n-              <literal>unavailable</literal>\n-              greeting.\n-            </para>\n-          </option>\n-        </optionlist>\n-      </parameter>\n+      <parameter name=\"queuename\" required=\"true\"/>\n+      <parameter name=\"interface\"/>\n+      <parameter name=\"penalty\"/>\n+      <parameter name=\"options\"/>\n+      <parameter name=\"membername\"/>\n+      <parameter name=\"stateinterface\"/>\n+      <parameter name=\"wrapuptime\"/>\n     </syntax>\n     <description>\n-      <para>This application is part of the Mini-Voicemail system, configured in minivm.conf.</para>\n-      <para>MinivmGreet() plays default prompts or user specific prompts for an account.</para>\n-      <para>Busy and unavailable messages can be choosen, but will be overridden if a temporary\n-\t\tmessage exists for the account.</para>\n+      <para>Dynamically adds interface to an existing queue. If the interface is\n+\t\t\talready in the queue it will return an error.</para>\n+      <para>This application sets the following channel variable upon completion:</para>\n       <variablelist>\n-        <variable name=\"MVM_GREET_STATUS\">\n-          <para>This is the status of the greeting playback.</para>\n-          <value name=\"SUCCESS\"/>\n-          <value name=\"USEREXIT\"/>\n-          <value name=\"FAILED\"/>\n+        <variable name=\"AQMSTATUS\">\n+          <para>The status of the attempt to add a queue member as a text string.</para>\n+          <value name=\"ADDED\"/>\n+          <value name=\"MEMBERALREADY\"/>\n+          <value name=\"NOSUCHQUEUE\"/>\n         </variable>\n       </variablelist>\n     </description>\n+    <see-also>\n+      <ref type=\"application\">Queue</ref>\n+      <ref type=\"application\">QueueLog</ref>\n+      <ref type=\"application\">AddQueueMember</ref>\n+      <ref type=\"application\">RemoveQueueMember</ref>\n+      <ref type=\"application\">PauseQueueMember</ref>\n+      <ref type=\"application\">UnpauseQueueMember</ref>\n+      <ref type=\"function\">QUEUE_VARIABLES</ref>\n+      <ref type=\"function\">QUEUE_MEMBER</ref>\n+      <ref type=\"function\">QUEUE_MEMBER_COUNT</ref>\n+      <ref type=\"function\">QUEUE_EXISTS</ref>\n+      <ref type=\"function\">QUEUE_GET_CHANNEL</ref>\n+      <ref type=\"function\">QUEUE_WAITING_COUNT</ref>\n+      <ref type=\"function\">QUEUE_MEMBER_LIST</ref>\n+      <ref type=\"function\">QUEUE_MEMBER_PENALTY</ref>\n+    </see-also>\n   </application>\n-  <application name=\"MinivmNotify\" language=\"en_US\">\n-    <synopsis>Notify voicemail owner about new messages.</synopsis>\n+  <application name=\"RemoveQueueMember\" language=\"en_US\">\n+    <synopsis>Dynamically removes queue members.</synopsis>\n     <syntax>\n-      <parameter name=\"mailbox\" required=\"true\" argsep=\"@\">\n-        <argument name=\"username\" required=\"true\">\n-          <para>Voicemail username</para>\n-        </argument>\n-        <argument name=\"domain\" required=\"true\">\n-          <para>Voicemail domain</para>\n-        </argument>\n-      </parameter>\n-      <parameter name=\"options\" required=\"false\">\n-        <optionlist>\n-          <option name=\"template\">\n-            <para>E-mail template to use for voicemail notification</para>\n-          </option>\n-        </optionlist>\n-      </parameter>\n+      <parameter name=\"queuename\" required=\"true\"/>\n+      <parameter name=\"interface\"/>\n     </syntax>\n     <description>\n-      <para>This application is part of the Mini-Voicemail system, configured in minivm.conf.</para>\n       <para>\n-        MiniVMnotify forwards messages about new voicemail to e-mail and pager. If there's no user\n-\t\taccount for that address, a temporary account will be used with default options (set in\n-        <filename>minivm.conf</filename>\n-        ).\n-      </para>\n-      <para>\n-        If the channel variable\n-        <variable>MVM_COUNTER</variable>\n-        is set, this will be used in the message\n-\t\tfile name and available in the template for the message.\n+        If the interface is\n+        <emphasis>NOT</emphasis>\n+        in the queue it will return an error.\n       </para>\n-      <para>If no template is given, the default email template will be used to send email and default pager\n-\t\ttemplate to send paging message (if the user account is configured with a paging address.</para>\n+      <para>This application sets the following channel variable upon completion:</para>\n       <variablelist>\n-        <variable name=\"MVM_NOTIFY_STATUS\">\n-          <para>This is the status of the notification attempt</para>\n-          <value name=\"SUCCESS\"/>\n-          <value name=\"FAILED\"/>\n+        <variable name=\"RQMSTATUS\">\n+          <value name=\"REMOVED\"/>\n+          <value name=\"NOTINQUEUE\"/>\n+          <value name=\"NOSUCHQUEUE\"/>\n+          <value name=\"NOTDYNAMIC\"/>\n         </variable>\n       </variablelist>\n+      <example title=\"Remove queue member\">same =&gt; n,RemoveQueueMember(techsupport,SIP/3000)</example>\n     </description>\n+    <see-also>\n+      <ref type=\"application\">Queue</ref>\n+      <ref type=\"application\">QueueLog</ref>\n+      <ref type=\"application\">AddQueueMember</ref>\n+      <ref type=\"application\">RemoveQueueMember</ref>\n+      <ref type=\"application\">PauseQueueMember</ref>\n+      <ref type=\"application\">UnpauseQueueMember</ref>\n+      <ref type=\"function\">QUEUE_VARIABLES</ref>\n+      <ref type=\"function\">QUEUE_MEMBER</ref>\n+      <ref type=\"function\">QUEUE_MEMBER_COUNT</ref>\n+      <ref type=\"function\">QUEUE_EXISTS</ref>\n+      <ref type=\"function\">QUEUE_GET_CHANNEL</ref>\n+      <ref type=\"function\">QUEUE_WAITING_COUNT</ref>\n+      <ref type=\"function\">QUEUE_MEMBER_LIST</ref>\n+      <ref type=\"function\">QUEUE_MEMBER_PENALTY</ref>\n+    </see-also>\n   </application>\n-  <application name=\"MinivmDelete\" language=\"en_US\">\n-    <synopsis>Delete Mini-Voicemail voicemail messages.</synopsis>\n+  <application name=\"PauseQueueMember\" language=\"en_US\">\n+    <synopsis>Pauses a queue member.</synopsis>\n     <syntax>\n-      <parameter name=\"filename\" required=\"true\">\n-        <para>File to delete</para>\n+      <parameter name=\"queuename\"/>\n+      <parameter name=\"interface\" required=\"true\"/>\n+      <parameter name=\"options\"/>\n+      <parameter name=\"reason\">\n+        <para>Is used to add extra information to the appropriate queue_log entries and manager events.</para>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>\n-        This application is part of the Mini-Voicemail system, configured in\n-        <filename>minivm.conf</filename>\n-        .\n-      </para>\n-      <para>It deletes voicemail file set in MVM_FILENAME or given filename.</para>\n+      <para>Pauses (blocks calls for) a queue member. The given interface will be paused in the given queue.\n+\t\t\tThis prevents any calls from being sent from the queue to the interface until it is\n+\t\t\tunpaused with UnpauseQueueMember or the manager interface.  If no queuename is given,\n+\t\t\tthe interface is paused in every queue it is a member of. The application will fail if the\n+\t\t\tinterface is not found.</para>\n+      <para>This application sets the following channel variable upon completion:</para>\n       <variablelist>\n-        <variable name=\"MVM_DELETE_STATUS\">\n-          <para>This is the status of the delete operation.</para>\n-          <value name=\"SUCCESS\"/>\n-          <value name=\"FAILED\"/>\n+        <variable name=\"PQMSTATUS\">\n+          <para>The status of the attempt to pause a queue member as a text string.</para>\n+          <value name=\"PAUSED\"/>\n+          <value name=\"NOTFOUND\"/>\n         </variable>\n       </variablelist>\n+      <example title=\"Pause queue member\">same =&gt; n,PauseQueueMember(,SIP/3000)</example>\n     </description>\n+    <see-also>\n+      <ref type=\"application\">Queue</ref>\n+      <ref type=\"application\">QueueLog</ref>\n+      <ref type=\"application\">AddQueueMember</ref>\n+      <ref type=\"application\">RemoveQueueMember</ref>\n+      <ref type=\"application\">PauseQueueMember</ref>\n+      <ref type=\"application\">UnpauseQueueMember</ref>\n+      <ref type=\"function\">QUEUE_VARIABLES</ref>\n+      <ref type=\"function\">QUEUE_MEMBER</ref>\n+      <ref type=\"function\">QUEUE_MEMBER_COUNT</ref>\n+      <ref type=\"function\">QUEUE_EXISTS</ref>\n+      <ref type=\"function\">QUEUE_GET_CHANNEL</ref>\n+      <ref type=\"function\">QUEUE_WAITING_COUNT</ref>\n+      <ref type=\"function\">QUEUE_MEMBER_LIST</ref>\n+      <ref type=\"function\">QUEUE_MEMBER_PENALTY</ref>\n+    </see-also>\n   </application>\n-  <application name=\"MinivmAccMess\" language=\"en_US\">\n-    <synopsis>Record account specific messages.</synopsis>\n+  <application name=\"UnpauseQueueMember\" language=\"en_US\">\n+    <synopsis>Unpauses a queue member.</synopsis>\n     <syntax>\n-      <parameter name=\"mailbox\" required=\"true\" argsep=\"@\">\n-        <argument name=\"username\" required=\"true\">\n-          <para>Voicemail username</para>\n-        </argument>\n-        <argument name=\"domain\" required=\"true\">\n-          <para>Voicemail domain</para>\n-        </argument>\n-      </parameter>\n-      <parameter name=\"options\" required=\"false\">\n-        <optionlist>\n-          <option name=\"u\">\n-            <para>\n-              Record the\n-              <literal>unavailable</literal>\n-              greeting.\n-            </para>\n-          </option>\n-          <option name=\"b\">\n-            <para>\n-              Record the\n-              <literal>busy</literal>\n-              greeting.\n-            </para>\n-          </option>\n-          <option name=\"t\">\n-            <para>Record the temporary greeting.</para>\n-          </option>\n-          <option name=\"n\">\n-            <para>Account name.</para>\n-          </option>\n-        </optionlist>\n+      <parameter name=\"queuename\"/>\n+      <parameter name=\"interface\" required=\"true\"/>\n+      <parameter name=\"options\"/>\n+      <parameter name=\"reason\">\n+        <para>Is used to add extra information to the appropriate queue_log entries and manager events.</para>\n       </parameter>\n     </syntax>\n     <description>\n       <para>\n-        This application is part of the Mini-Voicemail system, configured in\n-        <filename>minivm.conf</filename>\n-        .\n+        Unpauses (resumes calls to) a queue member. This is the counterpart to\n+        <literal>PauseQueueMember()</literal>\n+        and operates exactly the same way, except it unpauses instead of pausing the given interface.\n       </para>\n-      <para>Use this application to record account specific audio/video messages for busy, unavailable\n-\t\tand temporary messages.</para>\n-      <para>Account specific directories will be created if they do not exist.</para>\n+      <para>This application sets the following channel variable upon completion:</para>\n       <variablelist>\n-        <variable name=\"MVM_ACCMESS_STATUS\">\n-          <para>This is the result of the attempt to record the specified greeting.</para>\n-          <para>\n-            <literal>FAILED</literal>\n-            is set if the file can't be created.\n-          </para>\n-          <value name=\"SUCCESS\"/>\n-          <value name=\"FAILED\"/>\n+        <variable name=\"UPQMSTATUS\">\n+          <para>The status of the attempt to unpause a queue member as a text string.</para>\n+          <value name=\"UNPAUSED\"/>\n+          <value name=\"NOTFOUND\"/>\n         </variable>\n       </variablelist>\n+      <example title=\"Unpause queue member\">same =&gt; n,UnpauseQueueMember(,SIP/3000)</example>\n     </description>\n+    <see-also>\n+      <ref type=\"application\">Queue</ref>\n+      <ref type=\"application\">QueueLog</ref>\n+      <ref type=\"application\">AddQueueMember</ref>\n+      <ref type=\"application\">RemoveQueueMember</ref>\n+      <ref type=\"application\">PauseQueueMember</ref>\n+      <ref type=\"application\">UnpauseQueueMember</ref>\n+      <ref type=\"function\">QUEUE_VARIABLES</ref>\n+      <ref type=\"function\">QUEUE_MEMBER</ref>\n+      <ref type=\"function\">QUEUE_MEMBER_COUNT</ref>\n+      <ref type=\"function\">QUEUE_EXISTS</ref>\n+      <ref type=\"function\">QUEUE_GET_CHANNEL</ref>\n+      <ref type=\"function\">QUEUE_WAITING_COUNT</ref>\n+      <ref type=\"function\">QUEUE_MEMBER_LIST</ref>\n+      <ref type=\"function\">QUEUE_MEMBER_PENALTY</ref>\n+    </see-also>\n   </application>\n-  <application name=\"MinivmMWI\" language=\"en_US\">\n-    <synopsis>Send Message Waiting Notification to subscriber(s) of mailbox.</synopsis>\n+  <application name=\"QueueLog\" language=\"en_US\">\n+    <synopsis>Writes to the queue_log file.</synopsis>\n     <syntax>\n-      <parameter name=\"mailbox\" required=\"true\" argsep=\"@\">\n-        <argument name=\"username\" required=\"true\">\n-          <para>Voicemail username</para>\n-        </argument>\n-        <argument name=\"domain\" required=\"true\">\n-          <para>Voicemail domain</para>\n-        </argument>\n-      </parameter>\n-      <parameter name=\"urgent\" required=\"true\">\n-        <para>Number of urgent messages in mailbox.</para>\n-      </parameter>\n-      <parameter name=\"new\" required=\"true\">\n-        <para>Number of new messages in mailbox.</para>\n-      </parameter>\n-      <parameter name=\"old\" required=\"true\">\n-        <para>Number of old messages in mailbox.</para>\n-      </parameter>\n+      <parameter name=\"queuename\" required=\"true\"/>\n+      <parameter name=\"uniqueid\" required=\"true\"/>\n+      <parameter name=\"agent\" required=\"true\"/>\n+      <parameter name=\"event\" required=\"true\"/>\n+      <parameter name=\"additionalinfo\"/>\n     </syntax>\n     <description>\n-      <para>\n-        This application is part of the Mini-Voicemail system, configured in\n-        <filename>minivm.conf</filename>\n-        .\n-      </para>\n-      <para>MinivmMWI is used to send message waiting indication to any devices whose channels have\n-\t\tsubscribed to the mailbox passed in the first parameter.</para>\n+      <para>Allows you to write your own events into the queue log.</para>\n+      <example title=\"Log custom queue event\">same =&gt; n,QueueLog(101,${UNIQUEID},${AGENT},WENTONBREAK,600)</example>\n+    </description>\n+    <see-also>\n+      <ref type=\"application\">Queue</ref>\n+      <ref type=\"application\">QueueLog</ref>\n+      <ref type=\"application\">AddQueueMember</ref>\n+      <ref type=\"application\">RemoveQueueMember</ref>\n+      <ref type=\"application\">PauseQueueMember</ref>\n+      <ref type=\"application\">UnpauseQueueMember</ref>\n+      <ref type=\"function\">QUEUE_VARIABLES</ref>\n+      <ref type=\"function\">QUEUE_MEMBER</ref>\n+      <ref type=\"function\">QUEUE_MEMBER_COUNT</ref>\n+      <ref type=\"function\">QUEUE_EXISTS</ref>\n+      <ref type=\"function\">QUEUE_GET_CHANNEL</ref>\n+      <ref type=\"function\">QUEUE_WAITING_COUNT</ref>\n+      <ref type=\"function\">QUEUE_MEMBER_LIST</ref>\n+      <ref type=\"function\">QUEUE_MEMBER_PENALTY</ref>\n+    </see-also>\n+  </application>\n+  <application name=\"QueueUpdate\" language=\"en_US\">\n+    <synopsis>Writes to the queue_log file for outbound calls and updates Realtime Data.\n+\t\t\tIs used at h extension to be able to have all the parameters.</synopsis>\n+    <syntax>\n+      <parameter name=\"queuename\" required=\"true\"/>\n+      <parameter name=\"uniqueid\" required=\"true\"/>\n+      <parameter name=\"agent\" required=\"true\"/>\n+      <parameter name=\"status\" required=\"true\"/>\n+      <parameter name=\"talktime\" required=\"true\"/>\n+      <parameter name=\"params\" required=\"false\"/>\n+    </syntax>\n+    <description>\n+      <para>Allows you to write Outbound events into the queue log.</para>\n+      <example title=\"Write outbound event into queue log\">exten =&gt; h,1,QueueUpdate(${QUEUE}, ${UNIQUEID}, ${AGENT}, ${DIALSTATUS}, ${ANSWEREDTIME}, ${DIALEDTIME} | ${DIALEDNUMBER})</example>\n     </description>\n   </application>\n-  <function name=\"MINIVMCOUNTER\" language=\"en_US\">\n-    <synopsis>Reads or sets counters for MiniVoicemail message.</synopsis>\n-    <syntax argsep=\":\">\n-      <parameter name=\"account\" required=\"true\">\n-        <para>If account is given and it exists, the counter is specific for the account.</para>\n-        <para>If account is a domain and the domain directory exists, counters are specific for a domain.</para>\n-      </parameter>\n-      <parameter name=\"name\" required=\"true\">\n-        <para>The name of the counter is a string, up to 10 characters.</para>\n-      </parameter>\n-      <parameter name=\"operand\">\n-        <para>The counters never goes below zero. Valid operands for changing the value of a counter when assigning a value are:</para>\n+  <function name=\"QUEUE_VARIABLES\" language=\"en_US\">\n+    <synopsis>Return Queue information in variables.</synopsis>\n+    <syntax>\n+      <parameter name=\"queuename\" required=\"true\">\n         <enumlist>\n-          <enum name=\"i\">\n-            <para>Increment by value.</para>\n+          <enum name=\"QUEUEMAX\">\n+            <para>Maxmimum number of calls allowed.</para>\n           </enum>\n-          <enum name=\"d\">\n-            <para>Decrement by value.</para>\n+          <enum name=\"QUEUESTRATEGY\">\n+            <para>The strategy of the queue.</para>\n           </enum>\n-          <enum name=\"s\">\n-            <para>Set to value.</para>\n+          <enum name=\"QUEUECALLS\">\n+            <para>Number of calls currently in the queue.</para>\n+          </enum>\n+          <enum name=\"QUEUEHOLDTIME\">\n+            <para>Current average hold time.</para>\n+          </enum>\n+          <enum name=\"QUEUECOMPLETED\">\n+            <para>Number of completed calls for the queue.</para>\n+          </enum>\n+          <enum name=\"QUEUEABANDONED\">\n+            <para>Number of abandoned calls.</para>\n+          </enum>\n+          <enum name=\"QUEUESRVLEVEL\">\n+            <para>Queue service level.</para>\n+          </enum>\n+          <enum name=\"QUEUESRVLEVELPERF\">\n+            <para>Current service level performance.</para>\n           </enum>\n         </enumlist>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>The operation is atomic and the counter is locked while changing the value. The counters are stored as text files in the minivm account directories. It might be better to use realtime functions if you are using a database to operate your Asterisk.</para>\n+      <para>Makes the following queue variables available.</para>\n+      <para>\n+        Returns\n+        <literal>0</literal>\n+        if queue is found and setqueuevar is defined,\n+        <literal>-1</literal>\n+        otherwise.\n+      </para>\n     </description>\n     <see-also>\n-      <ref type=\"application\">MinivmRecord</ref>\n-      <ref type=\"application\">MinivmGreet</ref>\n-      <ref type=\"application\">MinivmNotify</ref>\n-      <ref type=\"application\">MinivmDelete</ref>\n-      <ref type=\"application\">MinivmAccMess</ref>\n-      <ref type=\"application\">MinivmMWI</ref>\n-      <ref type=\"function\">MINIVMACCOUNT</ref>\n+      <ref type=\"application\">Queue</ref>\n+      <ref type=\"application\">QueueLog</ref>\n+      <ref type=\"application\">AddQueueMember</ref>\n+      <ref type=\"application\">RemoveQueueMember</ref>\n+      <ref type=\"application\">PauseQueueMember</ref>\n+      <ref type=\"application\">UnpauseQueueMember</ref>\n+      <ref type=\"function\">QUEUE_VARIABLES</ref>\n+      <ref type=\"function\">QUEUE_MEMBER</ref>\n+      <ref type=\"function\">QUEUE_MEMBER_COUNT</ref>\n+      <ref type=\"function\">QUEUE_EXISTS</ref>\n+      <ref type=\"function\">QUEUE_GET_CHANNEL</ref>\n+      <ref type=\"function\">QUEUE_WAITING_COUNT</ref>\n+      <ref type=\"function\">QUEUE_MEMBER_LIST</ref>\n+      <ref type=\"function\">QUEUE_MEMBER_PENALTY</ref>\n     </see-also>\n   </function>\n-  <function name=\"MINIVMACCOUNT\" language=\"en_US\">\n-    <synopsis>Gets MiniVoicemail account information.</synopsis>\n-    <syntax argsep=\":\">\n-      <parameter name=\"account\" required=\"true\"/>\n-      <parameter name=\"item\" required=\"true\">\n-        <para>Valid items are:</para>\n+  <function name=\"QUEUE_MEMBER\" language=\"en_US\">\n+    <synopsis>Provides a count of queue members based on the provided criteria, or updates a\n+\t\t\tqueue member's settings.</synopsis>\n+    <syntax>\n+      <parameter name=\"queuename\" required=\"false\"/>\n+      <parameter name=\"option\" required=\"true\">\n         <enumlist>\n-          <enum name=\"path\">\n-            <para>Path to account mailbox (if account exists, otherwise temporary mailbox).</para>\n-          </enum>\n-          <enum name=\"hasaccount\">\n-            <para>1 is static Minivm account exists, 0 otherwise.</para>\n-          </enum>\n-          <enum name=\"fullname\">\n-            <para>Full name of account owner.</para>\n-          </enum>\n-          <enum name=\"email\">\n-            <para>Email address used for account.</para>\n-          </enum>\n-          <enum name=\"etemplate\">\n-            <para>Email template for account (default template if none is configured).</para>\n+          <enum name=\"logged\">\n+            <para>Returns the number of logged-in members for the specified queue.</para>\n           </enum>\n-          <enum name=\"ptemplate\">\n-            <para>Pager template for account (default template if none is configured).</para>\n+          <enum name=\"free\">\n+            <para>Returns the number of logged-in members for the specified queue that either can take calls or are currently wrapping up after a previous call.</para>\n           </enum>\n-          <enum name=\"accountcode\">\n-            <para>Account code for the voicemail account.</para>\n+          <enum name=\"ready\">\n+            <para>Returns the number of logged-in members for the specified queue that are immediately available to answer a call.</para>\n           </enum>\n-          <enum name=\"pincode\">\n-            <para>Pin code for voicemail account.</para>\n+          <enum name=\"count\">\n+            <para>Returns the total number of members for the specified queue.</para>\n           </enum>\n-          <enum name=\"timezone\">\n-            <para>Time zone for voicemail account.</para>\n+          <enum name=\"penalty\">\n+            <para>\n+              Gets or sets queue member penalty.  If\n+              <replaceable>queuename</replaceable>\n+              is not specified\n+\t\t\t\t\t\twhen setting the penalty then the penalty is set in all queues\n+\t\t\t\t\t\tthe interface is a member.\n+            </para>\n           </enum>\n-          <enum name=\"language\">\n-            <para>Language for voicemail account.</para>\n+          <enum name=\"paused\">\n+            <para>\n+              Gets or sets queue member paused status.  If\n+              <replaceable>queuename</replaceable>\n+              is not specified\n+\t\t\t\t\t\twhen setting the paused status then the paused status is set\n+\t\t\t\t\t\tin all queues the interface is a member.\n+            </para>\n           </enum>\n-          <enum name=\"&lt;channel variable name&gt;\">\n-            <para>Channel variable value (set in configuration for account).</para>\n+          <enum name=\"ringinuse\">\n+            <para>\n+              Gets or sets queue member ringinuse.  If\n+              <replaceable>queuename</replaceable>\n+              is not specified\n+\t\t\t\t\t\twhen setting ringinuse then ringinuse is set\n+\t\t\t\t\t\tin all queues the interface is a member.\n+            </para>\n           </enum>\n         </enumlist>\n       </parameter>\n+      <parameter name=\"interface\" required=\"false\"/>\n     </syntax>\n     <description>\n-      <para/>\n+      <para>Allows access to queue counts [R] and member information [R/W].</para>\n+      <para>\n+        <replaceable>queuename</replaceable>\n+        is required for all read operations.\n+      </para>\n+      <para>\n+        <replaceable>interface</replaceable>\n+        is required for all member operations.\n+      </para>\n     </description>\n     <see-also>\n-      <ref type=\"application\">MinivmRecord</ref>\n-      <ref type=\"application\">MinivmGreet</ref>\n-      <ref type=\"application\">MinivmNotify</ref>\n-      <ref type=\"application\">MinivmDelete</ref>\n-      <ref type=\"application\">MinivmAccMess</ref>\n-      <ref type=\"application\">MinivmMWI</ref>\n-      <ref type=\"function\">MINIVMCOUNTER</ref>\n+      <ref type=\"application\">Queue</ref>\n+      <ref type=\"application\">QueueLog</ref>\n+      <ref type=\"application\">AddQueueMember</ref>\n+      <ref type=\"application\">RemoveQueueMember</ref>\n+      <ref type=\"application\">PauseQueueMember</ref>\n+      <ref type=\"application\">UnpauseQueueMember</ref>\n+      <ref type=\"function\">QUEUE_VARIABLES</ref>\n+      <ref type=\"function\">QUEUE_MEMBER</ref>\n+      <ref type=\"function\">QUEUE_MEMBER_COUNT</ref>\n+      <ref type=\"function\">QUEUE_EXISTS</ref>\n+      <ref type=\"function\">QUEUE_GET_CHANNEL</ref>\n+      <ref type=\"function\">QUEUE_WAITING_COUNT</ref>\n+      <ref type=\"function\">QUEUE_MEMBER_LIST</ref>\n+      <ref type=\"function\">QUEUE_MEMBER_PENALTY</ref>\n     </see-also>\n   </function>\n-  <managerEvent language=\"en_US\" name=\"MiniVoiceMail\">\n-    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n-      <synopsis>Raised when a notification is sent out by a MiniVoiceMail application</synopsis>\n-      <syntax>\n-        <channel_snapshot/>\n-        <parameter name=\"Action\">\n-          <para>\n-            What action was taken. Currently, this will always be\n-            <literal>SentNotification</literal>\n-          </para>\n-        </parameter>\n-        <parameter name=\"Mailbox\">\n-          <para>\n-            The mailbox that the notification was about, specified as\n-            <literal>mailbox</literal>\n-            @\n-            <literal>context</literal>\n-          </para>\n-        </parameter>\n-        <parameter name=\"Counter\">\n-          <para>\n-            A message counter derived from the\n-            <literal>MVM_COUNTER</literal>\n-            channel variable.\n-          </para>\n-        </parameter>\n-      </syntax>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <module language=\"en_US\" name=\"app_channelredirect\">\n-    <support_level>core</support_level>\n-  </module>\n-  <application name=\"ChannelRedirect\" language=\"en_US\">\n-    <synopsis>Redirects given channel to a dialplan target</synopsis>\n+  <function name=\"QUEUE_MEMBER_COUNT\" language=\"en_US\">\n+    <synopsis>Count number of members answering a queue.</synopsis>\n     <syntax>\n-      <parameter name=\"channel\" required=\"true\"/>\n-      <parameter name=\"context\" required=\"false\"/>\n-      <parameter name=\"extension\" required=\"false\"/>\n-      <parameter name=\"priority\" required=\"true\"/>\n+      <parameter name=\"queuename\" required=\"true\"/>\n     </syntax>\n     <description>\n-      <para>Sends the specified channel to the specified extension priority</para>\n-      <para>This application sets the following channel variables upon completion</para>\n-      <variablelist>\n-        <variable name=\"CHANNELREDIRECT_STATUS\">\n-          <value name=\"NOCHANNEL\"/>\n-          <value name=\"SUCCESS\"/>\n-          <para>Are set to the result of the redirection</para>\n-        </variable>\n-      </variablelist>\n+      <para>\n+        Returns the number of members currently associated with the specified\n+        <replaceable>queuename</replaceable>\n+        .\n+      </para>\n+      <warning>\n+        <para>\n+          This function has been deprecated in favor of the\n+          <literal>QUEUE_MEMBER()</literal>\n+          function\n+        </para>\n+      </warning>\n     </description>\n-  </application>\n-  <module language=\"en_US\" name=\"app_db\">\n-    <support_level>core</support_level>\n-  </module>\n-  <application name=\"DBdeltree\" language=\"en_US\">\n-    <synopsis>Delete a family or keytree from the asterisk database.</synopsis>\n-    <syntax argsep=\"/\">\n-      <parameter name=\"family\" required=\"true\"/>\n-      <parameter name=\"keytree\"/>\n+    <see-also>\n+      <ref type=\"application\">Queue</ref>\n+      <ref type=\"application\">QueueLog</ref>\n+      <ref type=\"application\">AddQueueMember</ref>\n+      <ref type=\"application\">RemoveQueueMember</ref>\n+      <ref type=\"application\">PauseQueueMember</ref>\n+      <ref type=\"application\">UnpauseQueueMember</ref>\n+      <ref type=\"function\">QUEUE_VARIABLES</ref>\n+      <ref type=\"function\">QUEUE_MEMBER</ref>\n+      <ref type=\"function\">QUEUE_MEMBER_COUNT</ref>\n+      <ref type=\"function\">QUEUE_EXISTS</ref>\n+      <ref type=\"function\">QUEUE_GET_CHANNEL</ref>\n+      <ref type=\"function\">QUEUE_WAITING_COUNT</ref>\n+      <ref type=\"function\">QUEUE_MEMBER_LIST</ref>\n+      <ref type=\"function\">QUEUE_MEMBER_PENALTY</ref>\n+    </see-also>\n+  </function>\n+  <function name=\"QUEUE_EXISTS\" language=\"en_US\">\n+    <synopsis>Check if a named queue exists on this server</synopsis>\n+    <syntax>\n+      <parameter name=\"queuename\"/>\n     </syntax>\n     <description>\n-      <para>\n-        This application will delete a\n-        <replaceable>family</replaceable>\n-        or\n-        <replaceable>keytree</replaceable>\n-        from the Asterisk database.\n-      </para>\n+      <para>Returns 1 if the specified queue exists, 0 if it does not</para>\n     </description>\n     <see-also>\n-      <ref type=\"function\">DB_DELETE</ref>\n-      <ref type=\"function\">DB</ref>\n+      <ref type=\"application\">Queue</ref>\n+      <ref type=\"application\">QueueLog</ref>\n+      <ref type=\"application\">AddQueueMember</ref>\n+      <ref type=\"application\">RemoveQueueMember</ref>\n+      <ref type=\"application\">PauseQueueMember</ref>\n+      <ref type=\"application\">UnpauseQueueMember</ref>\n+      <ref type=\"function\">QUEUE_VARIABLES</ref>\n+      <ref type=\"function\">QUEUE_MEMBER</ref>\n+      <ref type=\"function\">QUEUE_MEMBER_COUNT</ref>\n+      <ref type=\"function\">QUEUE_EXISTS</ref>\n+      <ref type=\"function\">QUEUE_GET_CHANNEL</ref>\n+      <ref type=\"function\">QUEUE_WAITING_COUNT</ref>\n+      <ref type=\"function\">QUEUE_MEMBER_LIST</ref>\n+      <ref type=\"function\">QUEUE_MEMBER_PENALTY</ref>\n     </see-also>\n-  </application>\n-  <module language=\"en_US\" name=\"app_readexten\">\n-    <support_level>core</support_level>\n-  </module>\n-  <application name=\"ReadExten\" language=\"en_US\">\n-    <synopsis>Read an extension into a variable.</synopsis>\n+  </function>\n+  <function name=\"QUEUE_GET_CHANNEL\" language=\"en_US\">\n+    <synopsis>Return caller at the specified position in a queue.</synopsis>\n     <syntax>\n-      <parameter name=\"variable\" required=\"true\"/>\n-      <parameter name=\"filename\">\n-        <para>\n-          File to play before reading digits or tone with option\n-          <literal>i</literal>\n-        </para>\n-      </parameter>\n-      <parameter name=\"context\">\n-        <para>Context in which to match extensions.</para>\n-      </parameter>\n-      <parameter name=\"option\">\n-        <optionlist>\n-          <option name=\"s\">\n-            <para>Return immediately if the channel is not answered.</para>\n-          </option>\n-          <option name=\"i\">\n-            <para>\n-              Play\n-              <replaceable>filename</replaceable>\n-              as an indication tone from your\n-              <filename>indications.conf</filename>\n-              or a directly specified list of\n-\t\t\t\t\t\tfrequencies and durations.\n-            </para>\n-          </option>\n-          <option name=\"n\">\n-            <para>Read digits even if the channel is not answered.</para>\n-          </option>\n-          <option name=\"p\">\n-            <para>\n-              The extension entered will be considered complete when a\n-              <literal>#</literal>\n-              is entered.\n-            </para>\n-          </option>\n-        </optionlist>\n-      </parameter>\n-      <parameter name=\"timeout\">\n-        <para>\n-          An integer number of seconds to wait for a digit response. If\n-\t\t\t\tgreater than\n-          <literal>0</literal>\n-          , that value will override the default timeout.\n-        </para>\n-      </parameter>\n+      <parameter name=\"queuename\" required=\"true\"/>\n+      <parameter name=\"position\"/>\n     </syntax>\n     <description>\n       <para>\n-        Reads a\n-        <literal>#</literal>\n-        terminated string of digits from the user into the given variable.\n-      </para>\n-      <para>Will set READEXTENSTATUS on exit with one of the following statuses:</para>\n-      <variablelist>\n-        <variable name=\"READEXTENSTATUS\">\n-          <value name=\"OK\">A valid extension exists in ${variable}.</value>\n-          <value name=\"TIMEOUT\">No extension was entered in the specified time.  Also sets ${variable} to &quot;t&quot;.</value>\n-          <value name=\"INVALID\">An invalid extension, ${INVALID_EXTEN}, was entered.  Also sets ${variable} to &quot;i&quot;.</value>\n-          <value name=\"SKIP\">Line was not up and the option 's' was specified.</value>\n-          <value name=\"ERROR\">Invalid arguments were passed.</value>\n-        </variable>\n-      </variablelist>\n-    </description>\n-  </application>\n-  <module language=\"en_US\" name=\"app_chanspy\">\n-    <support_level>core</support_level>\n-  </module>\n-  <application name=\"ChanSpy\" language=\"en_US\">\n-    <synopsis>Listen to a channel, and optionally whisper into it.</synopsis>\n-    <syntax>\n-      <parameter name=\"chanprefix\"/>\n-      <parameter name=\"options\">\n-        <optionlist>\n-          <option name=\"b\">\n-            <para>Only spy on channels involved in a bridged call.</para>\n-          </option>\n-          <option name=\"B\">\n-            <para>Instead of whispering on a single channel barge in on both\n-\t\t\t\t\t\tchannels involved in the call.</para>\n-          </option>\n-          <option name=\"c\">\n-            <argument name=\"digit\" required=\"true\">\n-              <para>Specify a DTMF digit that can be used to spy on the next available channel.</para>\n-            </argument>\n-          </option>\n-          <option name=\"d\">\n-            <para>Override the typical numeric DTMF functionality and instead\n-\t\t\t\t\t\tuse DTMF to switch between spy modes.</para>\n-            <enumlist>\n-              <enum name=\"4\">\n-                <para>spy mode</para>\n-              </enum>\n-              <enum name=\"5\">\n-                <para>whisper mode</para>\n-              </enum>\n-              <enum name=\"6\">\n-                <para>barge mode</para>\n-              </enum>\n-            </enumlist>\n-          </option>\n-          <option name=\"e\">\n-            <argument name=\"ext\" required=\"true\"/>\n-            <para>\n-              Enable\n-              <emphasis>enforced</emphasis>\n-              mode, so the spying channel can\n-\t\t\t\t\t\tonly monitor extensions whose name is in the\n-              <replaceable>ext</replaceable>\n-              : delimited\n-\t\t\t\t\t\tlist.\n-            </para>\n-          </option>\n-          <option name=\"E\">\n-            <para>Exit when the spied-on channel hangs up.</para>\n-          </option>\n-          <option name=\"g\">\n-            <argument name=\"grp\" required=\"true\">\n-              <para>\n-                Only spy on channels in which one or more of the groups\n-\t\t\t\t\t\t\tlisted in\n-                <replaceable>grp</replaceable>\n-                matches one or more groups from the\n-                <variable>SPYGROUP</variable>\n-                variable set on the channel to be spied upon.\n-              </para>\n-            </argument>\n-            <note>\n-              <para>\n-                both\n-                <replaceable>grp</replaceable>\n-                and\n-                <variable>SPYGROUP</variable>\n-                can contain\n-\t\t\t\t\t\teither a single group or a colon-delimited list of groups, such\n-\t\t\t\t\t\tas\n-                <literal>sales:support:accounting</literal>\n-                .\n-              </para>\n-            </note>\n-          </option>\n-          <option name=\"l\">\n-            <para>Allow usage of a long queue to store audio frames.</para>\n-            <note>\n-              <para>This may introduce some delay in the received audio feed, but will improve the audio quality.</para>\n-            </note>\n-          </option>\n-          <option name=\"n\" argsep=\"@\">\n-            <para>\n-              Say the name of the person being spied on if that person has recorded\n-\t\t\t\t\t\this/her name. If a context is specified, then that voicemail context will\n-\t\t\t\t\t\tbe searched when retrieving the name, otherwise the\n-              <literal>default</literal>\n-              context\n-\t\t\t\t\t\tbe used when searching for the name (i.e. if SIP/1000 is the channel being\n-\t\t\t\t\t\tspied on and no mailbox is specified, then\n-              <literal>1000</literal>\n-              will be used when searching\n-\t\t\t\t\t\tfor the name).\n-            </para>\n-            <argument name=\"mailbox\"/>\n-            <argument name=\"context\"/>\n-          </option>\n-          <option name=\"o\">\n-            <para>Only listen to audio coming from this channel.</para>\n-          </option>\n-          <option name=\"q\">\n-            <para>Don't play a beep when beginning to spy on a channel, or speak the\n-\t\t\t\t\t\tselected channel name.</para>\n-          </option>\n-          <option name=\"r\">\n-            <para>\n-              Record the session to the monitor spool directory. An optional base for the filename\n-\t\t\t\t\t\tmay be specified. The default is\n-              <literal>chanspy</literal>\n-              .\n-            </para>\n-            <argument name=\"basename\"/>\n-          </option>\n-          <option name=\"s\">\n-            <para>Skip the playback of the channel type (i.e. SIP, IAX, etc) when\n-\t\t\t\t\t\tspeaking the selected channel name.</para>\n-          </option>\n-          <option name=\"S\">\n-            <para>Stop when no more channels are left to spy on.</para>\n-          </option>\n-          <option name=\"u\">\n-            <para>\n-              The\n-              <literal>chanprefix</literal>\n-              parameter is a channel uniqueid\n-\t\t\t\t\t\tor fully specified channel name.\n-            </para>\n-          </option>\n-          <option name=\"v\">\n-            <argument name=\"value\"/>\n-            <para>\n-              Adjust the initial volume in the range from\n-              <literal>-4</literal>\n-              to\n-              <literal>4</literal>\n-              . A negative value refers to a quieter setting.\n-            </para>\n-          </option>\n-          <option name=\"w\">\n-            <para>\n-              Enable\n-              <literal>whisper</literal>\n-              mode, so the spying channel can talk to\n-\t\t\t\t\t\tthe spied-on channel.\n-            </para>\n-          </option>\n-          <option name=\"W\">\n-            <para>\n-              Enable\n-              <literal>private whisper</literal>\n-              mode, so the spying channel can\n-\t\t\t\t\t\ttalk to the spied-on channel but cannot listen to that channel.\n-            </para>\n-          </option>\n-          <option name=\"x\">\n-            <argument name=\"digit\" required=\"true\">\n-              <para>Specify a DTMF digit that can be used to exit the application while actively\n-\t\t\t\t\t\t\tspying on a channel. If there is no channel being spied on, the DTMF digit will be\n-\t\t\t\t\t\t\tignored.</para>\n-            </argument>\n-          </option>\n-          <option name=\"X\">\n-            <para>\n-              Allow the user to exit ChanSpy to a valid single digit\n-\t\t\t\t\t\tnumeric extension in the current context or the context\n-\t\t\t\t\t\tspecified by the\n-              <variable>SPY_EXIT_CONTEXT</variable>\n-              channel variable. The\n-\t\t\t\t\t\tname of the last channel that was spied on will be stored\n-\t\t\t\t\t\tin the\n-              <variable>SPY_CHANNEL</variable>\n-              variable.\n-            </para>\n-          </option>\n-        </optionlist>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>\n-        This application is used to listen to the audio from an Asterisk channel. This includes the audio\n-\t\t\tcoming in and out of the channel being spied on. If the\n-        <literal>chanprefix</literal>\n-        parameter is specified,\n-\t\t\tonly channels beginning with this string will be spied upon.\n-      </para>\n-      <para>While spying, the following actions may be performed:</para>\n-      <para>\n-        - Dialing\n-        <literal>#</literal>\n-        cycles the volume level.\n-      </para>\n-      <para>\n-        - Dialing\n-        <literal>*</literal>\n-        will stop spying and look for another channel to spy on.\n-      </para>\n-      <para>\n-        - Dialing a series of digits followed by\n-        <literal>#</literal>\n-        builds a channel name to append\n-\t\t\tto\n-        <literal>chanprefix</literal>\n-        . For example, executing ChanSpy(Agent) and then dialing the digits '1234#'\n-\t\t\twhile spying will begin spying on the channel 'Agent/1234'. Note that this feature will be overridden\n-\t\t\tif the 'd' or 'u' options are used.\n-      </para>\n-      <note>\n-        <para>\n-          The\n-          <replaceable>X</replaceable>\n-          option supersedes the three features above in that if a valid\n-\t\t\tsingle digit extension exists in the correct context ChanSpy will exit to it.\n-\t\t\tThis also disables choosing a channel based on\n-          <literal>chanprefix</literal>\n-          and a digit sequence.\n-        </para>\n-      </note>\n-    </description>\n-    <see-also>\n-      <ref type=\"application\">ExtenSpy</ref>\n-      <ref type=\"managerEvent\">ChanSpyStart</ref>\n-      <ref type=\"managerEvent\">ChanSpyStop</ref>\n-    </see-also>\n-  </application>\n-  <application name=\"ExtenSpy\" language=\"en_US\">\n-    <synopsis>Listen to a channel, and optionally whisper into it.</synopsis>\n-    <syntax>\n-      <parameter name=\"exten\" required=\"true\" argsep=\"@\">\n-        <argument name=\"exten\" required=\"true\">\n-          <para>Specify extension.</para>\n-        </argument>\n-        <argument name=\"context\">\n-          <para>\n-            Optionally specify a context, defaults to\n-            <literal>default</literal>\n-            .\n-          </para>\n-        </argument>\n-      </parameter>\n-      <parameter name=\"options\">\n-        <optionlist>\n-          <option name=\"b\">\n-            <para>Only spy on channels involved in a bridged call.</para>\n-          </option>\n-          <option name=\"B\">\n-            <para>Instead of whispering on a single channel barge in on both\n-\t\t\t\t\t\tchannels involved in the call.</para>\n-          </option>\n-          <option name=\"c\">\n-            <argument name=\"digit\" required=\"true\">\n-              <para>Specify a DTMF digit that can be used to spy on the next available channel.</para>\n-            </argument>\n-          </option>\n-          <option name=\"d\">\n-            <para>Override the typical numeric DTMF functionality and instead\n-\t\t\t\t\t\tuse DTMF to switch between spy modes.</para>\n-            <enumlist>\n-              <enum name=\"4\">\n-                <para>spy mode</para>\n-              </enum>\n-              <enum name=\"5\">\n-                <para>whisper mode</para>\n-              </enum>\n-              <enum name=\"6\">\n-                <para>barge mode</para>\n-              </enum>\n-            </enumlist>\n-          </option>\n-          <option name=\"e\">\n-            <argument name=\"ext\" required=\"true\"/>\n-            <para>\n-              Enable\n-              <emphasis>enforced</emphasis>\n-              mode, so the spying channel can\n-\t\t\t\t\t\tonly monitor extensions whose name is in the\n-              <replaceable>ext</replaceable>\n-              : delimited\n-\t\t\t\t\t\tlist.\n-            </para>\n-          </option>\n-          <option name=\"E\">\n-            <para>Exit when the spied-on channel hangs up.</para>\n-          </option>\n-          <option name=\"g\">\n-            <argument name=\"grp\" required=\"true\">\n-              <para>\n-                Only spy on channels in which one or more of the groups\n-\t\t\t\t\t\t\tlisted in\n-                <replaceable>grp</replaceable>\n-                matches one or more groups from the\n-                <variable>SPYGROUP</variable>\n-                variable set on the channel to be spied upon.\n-              </para>\n-            </argument>\n-            <note>\n-              <para>\n-                both\n-                <replaceable>grp</replaceable>\n-                and\n-                <variable>SPYGROUP</variable>\n-                can contain\n-\t\t\t\t\t\teither a single group or a colon-delimited list of groups, such\n-\t\t\t\t\t\tas\n-                <literal>sales:support:accounting</literal>\n-                .\n-              </para>\n-            </note>\n-          </option>\n-          <option name=\"l\">\n-            <para>Allow usage of a long queue to store audio frames.</para>\n-            <note>\n-              <para>This may introduce some delay in the received audio feed, but will improve the audio quality.</para>\n-            </note>\n-          </option>\n-          <option name=\"n\" argsep=\"@\">\n-            <para>\n-              Say the name of the person being spied on if that person has recorded\n-\t\t\t\t\t\this/her name. If a context is specified, then that voicemail context will\n-\t\t\t\t\t\tbe searched when retrieving the name, otherwise the\n-              <literal>default</literal>\n-              context\n-\t\t\t\t\t\tbe used when searching for the name (i.e. if SIP/1000 is the channel being\n-\t\t\t\t\t\tspied on and no mailbox is specified, then\n-              <literal>1000</literal>\n-              will be used when searching\n-\t\t\t\t\t\tfor the name).\n-            </para>\n-            <argument name=\"mailbox\"/>\n-            <argument name=\"context\"/>\n-          </option>\n-          <option name=\"o\">\n-            <para>Only listen to audio coming from this channel.</para>\n-          </option>\n-          <option name=\"q\">\n-            <para>Don't play a beep when beginning to spy on a channel, or speak the\n-\t\t\t\t\t\tselected channel name.</para>\n-          </option>\n-          <option name=\"r\">\n-            <para>\n-              Record the session to the monitor spool directory. An optional base for the filename\n-\t\t\t\t\t\tmay be specified. The default is\n-              <literal>chanspy</literal>\n-              .\n-            </para>\n-            <argument name=\"basename\"/>\n-          </option>\n-          <option name=\"s\">\n-            <para>Skip the playback of the channel type (i.e. SIP, IAX, etc) when\n-\t\t\t\t\t\tspeaking the selected channel name.</para>\n-          </option>\n-          <option name=\"S\">\n-            <para>Stop when there are no more extensions left to spy on.</para>\n-          </option>\n-          <option name=\"v\">\n-            <argument name=\"value\"/>\n-            <para>\n-              Adjust the initial volume in the range from\n-              <literal>-4</literal>\n-              to\n-              <literal>4</literal>\n-              . A negative value refers to a quieter setting.\n-            </para>\n-          </option>\n-          <option name=\"w\">\n-            <para>\n-              Enable\n-              <literal>whisper</literal>\n-              mode, so the spying channel can talk to\n-\t\t\t\t\t\tthe spied-on channel.\n-            </para>\n-          </option>\n-          <option name=\"W\">\n-            <para>\n-              Enable\n-              <literal>private whisper</literal>\n-              mode, so the spying channel can\n-\t\t\t\t\t\ttalk to the spied-on channel but cannot listen to that channel.\n-            </para>\n-          </option>\n-          <option name=\"x\">\n-            <argument name=\"digit\" required=\"true\">\n-              <para>Specify a DTMF digit that can be used to exit the application while actively\n-\t\t\t\t\t\t\tspying on a channel. If there is no channel being spied on, the DTMF digit will be\n-\t\t\t\t\t\t\tignored.</para>\n-            </argument>\n-          </option>\n-          <option name=\"X\">\n-            <para>\n-              Allow the user to exit ChanSpy to a valid single digit\n-\t\t\t\t\t\tnumeric extension in the current context or the context\n-\t\t\t\t\t\tspecified by the\n-              <variable>SPY_EXIT_CONTEXT</variable>\n-              channel variable. The\n-\t\t\t\t\t\tname of the last channel that was spied on will be stored\n-\t\t\t\t\t\tin the\n-              <variable>SPY_CHANNEL</variable>\n-              variable.\n-            </para>\n-          </option>\n-        </optionlist>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>This application is used to listen to the audio from an Asterisk channel. This includes\n-\t\t\tthe audio coming in and out of the channel being spied on. Only channels created by outgoing calls for the\n-\t\t\tspecified extension will be selected for spying. If the optional context is not supplied,\n-\t\t\tthe current channel's context will be used.</para>\n-      <para>While spying, the following actions may be performed:</para>\n-      <para>\n-        - Dialing\n-        <literal>#</literal>\n-        cycles the volume level.\n-      </para>\n-      <para>\n-        - Dialing\n-        <literal>*</literal>\n-        will stop spying and look for another channel to spy on.\n-      </para>\n-      <note>\n-        <para>\n-          The\n-          <replaceable>X</replaceable>\n-          option supersedes the three features above in that if a valid\n-\t\t\tsingle digit extension exists in the correct context ChanSpy will exit to it.\n-\t\t\tThis also disables choosing a channel based on\n-          <literal>chanprefix</literal>\n-          and a digit sequence.\n-        </para>\n-      </note>\n-    </description>\n-    <see-also>\n-      <ref type=\"application\">ChanSpy</ref>\n-      <ref type=\"managerEvent\">ChanSpyStart</ref>\n-      <ref type=\"managerEvent\">ChanSpyStop</ref>\n-    </see-also>\n-  </application>\n-  <application name=\"DAHDIScan\" language=\"en_US\">\n-    <synopsis>Scan DAHDI channels to monitor calls.</synopsis>\n-    <syntax>\n-      <parameter name=\"group\">\n-        <para>\n-          Limit scanning to a channel\n-          <replaceable>group</replaceable>\n-          by setting this option.\n-        </para>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>\n-        Allows a call center manager to monitor DAHDI channels in a\n-\t\t\tconvenient way.  Use\n-        <literal>#</literal>\n-        to select the next channel and use\n-        <literal>*</literal>\n-        to exit.\n-      </para>\n-    </description>\n-    <see-also>\n-      <ref type=\"managerEvent\">ChanSpyStart</ref>\n-      <ref type=\"managerEvent\">ChanSpyStop</ref>\n-    </see-also>\n-  </application>\n-  <module language=\"en_US\" name=\"app_stasis\">\n-    <depend>res_stasis</depend>\n-    <support_level>core</support_level>\n-  </module>\n-  <application name=\"Stasis\" language=\"en_US\">\n-    <synopsis>Invoke an external Stasis application.</synopsis>\n-    <syntax>\n-      <parameter name=\"app_name\" required=\"true\">\n-        <para>Name of the application to invoke.</para>\n-      </parameter>\n-      <parameter name=\"args\">\n-        <para>Optional comma-delimited arguments for the\n-\t\t\t\tapplication invocation.</para>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>Invoke a Stasis application.</para>\n-      <para>This application will set the following channel variable upon\n-\t\t\tcompletion:</para>\n-      <variablelist>\n-        <variable name=\"STASISSTATUS\">\n-          <para>This indicates the status of the execution of the\n-\t\t\t\t\tStasis application.</para>\n-          <value name=\"SUCCESS\">The channel has exited Stasis without any failures in\n-\t\t\t\t\t\tStasis.</value>\n-          <value name=\"FAILED\">A failure occurred when executing the Stasis\n-\t\t\t\t\t\tThe app registry is not instantiated; The app\n-\t\t\t\t\t\tapplication. Some (not all) possible reasons for this:\n-\t\t\t\t\t\trequested is not registered; The app requested is not\n-\t\t\t\t\t\tactive; Stasis couldn't send a start message.</value>\n-        </variable>\n-      </variablelist>\n-    </description>\n-  </application>\n-  <module language=\"en_US\" name=\"app_cdr\">\n-    <support_level>core</support_level>\n-  </module>\n-  <application name=\"NoCDR\" language=\"en_US\">\n-    <synopsis>Tell Asterisk to not maintain a CDR for this channel.</synopsis>\n-    <syntax/>\n-    <description>\n-      <para>\n-        This application will tell Asterisk not to maintain a CDR for\n-\t\t\tthe current channel. This does\n-        <emphasis>NOT</emphasis>\n-        mean that\n-\t\t\tinformation is not tracked; rather, if the channel is hung up no\n-\t\t\tCDRs will be created for that channel.\n-      </para>\n-      <para>If a subsequent call to ResetCDR occurs, all non-finalized\n-\t\t\tCDRs created for the channel will be enabled.</para>\n-      <note>\n-        <para>This application is deprecated. Please use the CDR_PROP\n-\t\t\tfunction to disable CDRs on a channel.</para>\n-      </note>\n-    </description>\n-    <see-also>\n-      <ref type=\"application\">ResetCDR</ref>\n-      <ref type=\"function\">CDR_PROP</ref>\n-    </see-also>\n-  </application>\n-  <application name=\"ResetCDR\" language=\"en_US\">\n-    <synopsis>Resets the Call Data Record.</synopsis>\n-    <syntax>\n-      <parameter name=\"options\">\n-        <optionlist>\n-          <option name=\"v\">\n-            <para>Save the CDR variables during the reset.</para>\n-          </option>\n-          <option name=\"e\">\n-            <para>Enable the CDRs for this channel only (negate\n-\t\t\t\t\t\teffects of NoCDR).</para>\n-          </option>\n-        </optionlist>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>This application causes the Call Data Record to be reset.\n-\t\t\tDepending on the flags passed in, this can have several effects.\n-\t\t\tWith no options, a reset does the following:</para>\n-      <para>\n-        1. The\n-        <literal>start</literal>\n-        time is set to the current time.\n-      </para>\n-      <para>\n-        2. If the channel is answered, the\n-        <literal>answer</literal>\n-        time is set to the\n-\t\t\tcurrent time.\n-      </para>\n-      <para>\n-        3. All variables are wiped from the CDR. Note that this step\n-\t\t\tcan be prevented with the\n-        <literal>v</literal>\n-        option.\n-      </para>\n-      <para>\n-        On the other hand, if the\n-        <literal>e</literal>\n-        option is\n-\t\t\tspecified, the effects of the NoCDR application will be lifted. CDRs\n-\t\t\twill be re-enabled for this channel.\n-      </para>\n-      <note>\n-        <para>\n-          The\n-          <literal>e</literal>\n-          option is deprecated. Please\n-\t\t\tuse the CDR_PROP function instead.\n-        </para>\n-      </note>\n-    </description>\n-    <see-also>\n-      <ref type=\"application\">ForkCDR</ref>\n-      <ref type=\"application\">NoCDR</ref>\n-      <ref type=\"function\">CDR_PROP</ref>\n-    </see-also>\n-  </application>\n-  <module language=\"en_US\" name=\"app_record\">\n-    <support_level>core</support_level>\n-  </module>\n-  <application name=\"Record\" language=\"en_US\">\n-    <synopsis>Record to a file.</synopsis>\n-    <syntax>\n-      <parameter name=\"filename\" required=\"true\" argsep=\".\">\n-        <argument name=\"filename\" required=\"true\"/>\n-        <argument name=\"format\" required=\"true\">\n-          <para>Is the format of the file type to be recorded (wav, gsm, etc).</para>\n-        </argument>\n-      </parameter>\n-      <parameter name=\"silence\">\n-        <para>Is the number of seconds of silence to allow before returning.</para>\n-      </parameter>\n-      <parameter name=\"maxduration\">\n-        <para>Is the maximum recording duration in seconds. If missing\n-\t\t\t\tor 0 there is no maximum.</para>\n-      </parameter>\n-      <parameter name=\"options\">\n-        <optionlist>\n-          <option name=\"a\">\n-            <para>Append to existing recording rather than replacing.</para>\n-          </option>\n-          <option name=\"n\">\n-            <para>Do not answer, but record anyway if line not yet answered.</para>\n-          </option>\n-          <option name=\"o\">\n-            <para>\n-              Exit when 0 is pressed, setting the variable\n-              <variable>RECORD_STATUS</variable>\n-              to\n-              <literal>OPERATOR</literal>\n-              instead of\n-              <literal>DTMF</literal>\n-            </para>\n-          </option>\n-          <option name=\"q\">\n-            <para>quiet (do not play a beep tone).</para>\n-          </option>\n-          <option name=\"s\">\n-            <para>skip recording if the line is not yet answered.</para>\n-          </option>\n-          <option name=\"t\">\n-            <para>use alternate '*' terminator key (DTMF) instead of default '#'</para>\n-          </option>\n-          <option name=\"u\">\n-            <para>Don't truncate recorded silence.</para>\n-          </option>\n-          <option name=\"x\">\n-            <para>Ignore all terminator keys (DTMF) and keep recording until hangup.</para>\n-          </option>\n-          <option name=\"k\">\n-            <para>Keep recorded file upon hangup.</para>\n-          </option>\n-          <option name=\"y\">\n-            <para>Terminate recording if *any* DTMF digit is received.</para>\n-          </option>\n-        </optionlist>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>\n-        If filename contains\n-        <literal>%d</literal>\n-        , these characters will be replaced with a number\n-\t\t\tincremented by one each time the file is recorded.\n-\t\t\tUse\n-        <astcli>core show file formats</astcli>\n-        to see the available formats on your system\n-\t\t\tUser can press\n-        <literal>#</literal>\n-        to terminate the recording and continue to the next priority.\n-\t\t\tIf the user hangs up during a recording, all data will be lost and the application will terminate.\n-      </para>\n-      <variablelist>\n-        <variable name=\"RECORDED_FILE\">\n-          <para>Will be set to the final filename of the recording, without an extension.</para>\n-        </variable>\n-        <variable name=\"RECORD_STATUS\">\n-          <para>This is the final status of the command</para>\n-          <value name=\"DTMF\">A terminating DTMF was received ('#' or '*', depending upon option 't')</value>\n-          <value name=\"SILENCE\">The maximum silence occurred in the recording.</value>\n-          <value name=\"SKIP\">The line was not yet answered and the 's' option was specified.</value>\n-          <value name=\"TIMEOUT\">The maximum length was reached.</value>\n-          <value name=\"HANGUP\">The channel was hung up.</value>\n-          <value name=\"ERROR\">An unrecoverable error occurred, which resulted in a WARNING to the logs.</value>\n-        </variable>\n-      </variablelist>\n-    </description>\n-  </application>\n-  <module language=\"en_US\" name=\"app_reload\">\n-    <support_level>extended</support_level>\n-  </module>\n-  <application name=\"Reload\" language=\"en_US\">\n-    <since>\n-      <version>16.20.0</version>\n-      <version>18.6.0</version>\n-      <version>19.0.0</version>\n-    </since>\n-    <synopsis>Reloads an Asterisk module, blocking the channel until the reload has completed.</synopsis>\n-    <syntax>\n-      <parameter name=\"module\" required=\"false\">\n-        <para>The full name(s) of the target module(s) or resource(s) to reload.\n-\t\t\t\tIf omitted, everything will be reloaded.</para>\n-        <para>\n-          The full names MUST be specified (e.g.\n-          <literal>chan_iax2</literal>\n-          to reload IAX2 or\n-          <literal>pbx_config</literal>\n-          to reload the dialplan.\n-        </para>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>Reloads the specified (or all) Asterisk modules and reports success or failure.\n-\t\t\tSuccess is determined by each individual module, and if all reloads are successful,\n-\t\t\tthat is considered an aggregate success. If multiple modules are specified and any\n-\t\t\tmodule fails, then FAILURE will be returned. It is still possible that other modules\n-\t\t\tdid successfully reload, however.</para>\n-      <para>\n-        Sets\n-        <variable>RELOADSTATUS</variable>\n-        to one of the following values:\n-      </para>\n-      <variablelist>\n-        <variable name=\"RELOADSTATUS\">\n-          <value name=\"SUCCESS\">Specified module(s) reloaded successfully.</value>\n-          <value name=\"FAILURE\">Some or all of the specified modules failed to reload.</value>\n-        </variable>\n-      </variablelist>\n-    </description>\n-  </application>\n-  <module language=\"en_US\" name=\"app_queue\">\n-    <use type=\"module\">res_monitor</use>\n-    <support_level>core</support_level>\n-  </module>\n-  <application name=\"Queue\" language=\"en_US\">\n-    <synopsis>Queue a call for a call queue.</synopsis>\n-    <syntax>\n-      <parameter name=\"queuename\" required=\"true\"/>\n-      <parameter name=\"options\">\n-        <optionlist>\n-          <option name=\"b\" argsep=\"^\">\n-            <para>\n-              Before initiating an outgoing call,\n-              <literal>Gosub</literal>\n-              to the specified\n-\t\t\t\t\t\tlocation using the newly created channel.  The\n-              <literal>Gosub</literal>\n-              will be\n-\t\t\t\t\t\texecuted for each destination channel.\n-            </para>\n-            <argument name=\"context\" required=\"false\"/>\n-            <argument name=\"exten\" required=\"false\"/>\n-            <argument name=\"priority\" required=\"true\" hasparams=\"optional\" argsep=\"^\">\n-              <argument name=\"arg1\" multiple=\"true\" required=\"true\"/>\n-              <argument name=\"argN\"/>\n-            </argument>\n-          </option>\n-          <option name=\"B\" argsep=\"^\">\n-            <para>\n-              Before initiating the outgoing call(s),\n-              <literal>Gosub</literal>\n-              to the\n-\t\t\t\t\t\tspecified location using the current channel.\n-            </para>\n-            <argument name=\"context\" required=\"false\"/>\n-            <argument name=\"exten\" required=\"false\"/>\n-            <argument name=\"priority\" required=\"true\" hasparams=\"optional\" argsep=\"^\">\n-              <argument name=\"arg1\" multiple=\"true\" required=\"true\"/>\n-              <argument name=\"argN\"/>\n-            </argument>\n-          </option>\n-          <option name=\"C\">\n-            <para>Mark all calls as &quot;answered elsewhere&quot; when cancelled.</para>\n-          </option>\n-          <option name=\"c\">\n-            <para>Continue in the dialplan if the callee hangs up.</para>\n-          </option>\n-          <option name=\"d\">\n-            <para>data-quality (modem) call (minimum delay).</para>\n-          </option>\n-          <option name=\"F\" argsep=\"^\">\n-            <argument name=\"context\" required=\"false\"/>\n-            <argument name=\"exten\" required=\"false\"/>\n-            <argument name=\"priority\" required=\"true\"/>\n-            <para>\n-              When the caller hangs up, transfer the\n-              <emphasis>called member</emphasis>\n-              to the specified destination and\n-              <emphasis>start</emphasis>\n-              execution at that location.\n-            </para>\n-            <para>NOTE: Any channel variables you want the called channel to inherit from the caller channel must be\n-\t\t\t\t\t\tprefixed with one or two underbars ('_').</para>\n-          </option>\n-          <option name=\"F\">\n-            <para>\n-              When the caller hangs up, transfer the\n-              <emphasis>called member</emphasis>\n-              to the next priority of\n-\t\t\t\t\t\tthe current extension and\n-              <emphasis>start</emphasis>\n-              execution at that location.\n-            </para>\n-            <para>NOTE: Any channel variables you want the called channel to inherit from the caller channel must be\n-\t\t\t\t\t\tprefixed with one or two underbars ('_').</para>\n-            <para>NOTE: Using this option from a Macro() or GoSub() might not make sense as there would be no return points.</para>\n-          </option>\n-          <option name=\"h\">\n-            <para>\n-              Allow\n-              <emphasis>callee</emphasis>\n-              to hang up by pressing\n-              <literal>*</literal>\n-              .\n-            </para>\n-          </option>\n-          <option name=\"H\">\n-            <para>\n-              Allow\n-              <emphasis>caller</emphasis>\n-              to hang up by pressing\n-              <literal>*</literal>\n-              .\n-            </para>\n-          </option>\n-          <option name=\"i\">\n-            <para>Ignore call forward requests from queue members and do nothing\n-\t\t\t\t\t\twhen they are requested.</para>\n-          </option>\n-          <option name=\"I\">\n-            <para>Asterisk will ignore any connected line update requests or any redirecting party\n-\t\t\t\t\t\tupdate requests it may receive on this dial attempt.</para>\n-          </option>\n-          <option name=\"k\">\n-            <para>\n-              Allow the\n-              <emphasis>called</emphasis>\n-              party to enable parking of the call by sending\n-\t\t\t\t\t\tthe DTMF sequence defined for call parking in\n-              <filename>features.conf</filename>\n-              .\n-            </para>\n-          </option>\n-          <option name=\"K\">\n-            <para>\n-              Allow the\n-              <emphasis>calling</emphasis>\n-              party to enable parking of the call by sending\n-\t\t\t\t\t\tthe DTMF sequence defined for call parking in\n-              <filename>features.conf</filename>\n-              .\n-            </para>\n-          </option>\n-          <option name=\"m\">\n-            <para>\n-              Custom music on hold class to use, which will override the music on hold class configured\n-\t\t\t\t\t\tin\n-              <filename>queues.conf</filename>\n-              , if specified.\n-            </para>\n-            <para>Note that CHANNEL(musicclass), if set, will still override this option.</para>\n-          </option>\n-          <option name=\"n\">\n-            <para>No retries on the timeout; will exit this application and\n-\t\t\t\t\t\tgo to the next step.</para>\n-          </option>\n-          <option name=\"r\">\n-            <para>Ring instead of playing MOH. Periodic Announcements are still made, if applicable.</para>\n-          </option>\n-          <option name=\"R\">\n-            <para>Ring instead of playing MOH when a member channel is actually ringing.</para>\n-          </option>\n-          <option name=\"t\">\n-            <para>\n-              Allow the\n-              <emphasis>called</emphasis>\n-              user to transfer the calling user.\n-            </para>\n-          </option>\n-          <option name=\"T\">\n-            <para>\n-              Allow the\n-              <emphasis>calling</emphasis>\n-              user to transfer the call.\n-            </para>\n-          </option>\n-          <option name=\"w\">\n-            <para>\n-              Allow the\n-              <emphasis>called</emphasis>\n-              user to write the conversation to\n-\t\t\t\t\t\tdisk via Monitor.\n-            </para>\n-          </option>\n-          <option name=\"W\">\n-            <para>\n-              Allow the\n-              <emphasis>calling</emphasis>\n-              user to write the conversation to\n-\t\t\t\t\t\tdisk via Monitor.\n-            </para>\n-          </option>\n-          <option name=\"x\">\n-            <para>\n-              Allow the\n-              <emphasis>called</emphasis>\n-              user to write the conversation\n-\t\t\t\t\t\tto disk via MixMonitor.\n-            </para>\n-          </option>\n-          <option name=\"X\">\n-            <para>\n-              Allow the\n-              <emphasis>calling</emphasis>\n-              user to write the conversation to\n-\t\t\t\t\t\tdisk via MixMonitor.\n-            </para>\n-          </option>\n-        </optionlist>\n-      </parameter>\n-      <parameter name=\"URL\">\n-        <para>\n-          <replaceable>URL</replaceable>\n-          will be sent to the called party if the channel supports it.\n-        </para>\n-      </parameter>\n-      <parameter name=\"announceoverride\" argsep=\"&amp;\">\n-        <argument name=\"filename\" required=\"true\">\n-          <para>\n-            Announcement file(s) to play to agent before bridging call, overriding the announcement(s)\n-\t\t\t\t\tconfigured in\n-            <filename>queues.conf</filename>\n-            , if any.\n-          </para>\n-        </argument>\n-        <argument name=\"filename2\" multiple=\"true\"/>\n-      </parameter>\n-      <parameter name=\"timeout\">\n-        <para>\n-          Will cause the queue to fail out after a specified number of\n-\t\t\t\tseconds, checked between each\n-          <filename>queues.conf</filename>\n-          <replaceable>timeout</replaceable>\n-          and\n-          <replaceable>retry</replaceable>\n-          cycle.\n-        </para>\n-      </parameter>\n-      <parameter name=\"AGI\">\n-        <para>Will setup an AGI script to be executed on the calling party's channel once they are\n-\t\t\t\tconnected to a queue member.</para>\n-      </parameter>\n-      <parameter name=\"macro\">\n-        <para>Will run a macro on the called party's channel (the queue member) once the parties are connected.</para>\n-        <para>NOTE: Macros are deprecated, GoSub should be used instead.</para>\n-      </parameter>\n-      <parameter name=\"gosub\">\n-        <para>Will run a gosub on the called party's channel (the queue member)\n-\t\t\t\tonce the parties are connected.  The subroutine execution starts in the\n-\t\t\t\tnamed context at the s exten and priority 1.</para>\n-      </parameter>\n-      <parameter name=\"rule\">\n-        <para>Will cause the queue's defaultrule to be overridden by the rule specified.</para>\n-      </parameter>\n-      <parameter name=\"position\">\n-        <para>\n-          Attempt to enter the caller into the queue at the numerical position specified.\n-          <literal>1</literal>\n-          would attempt to enter the caller at the head of the queue, and\n-          <literal>3</literal>\n-          would attempt to place\n-\t\t\t\tthe caller third in the queue.\n-        </para>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>In addition to transferring the call, a call may be parked and then picked\n-\t\t\tup by another user.</para>\n-      <para>This application will return to the dialplan if the queue does not exist, or\n-\t\t\tany of the join options cause the caller to not enter the queue.</para>\n-      <para>This application does not automatically answer and should be preceeded\n-\t\t\tby an application such as Answer(), Progress(), or Ringing().</para>\n-      <para>This application sets the following channel variables upon completion:</para>\n-      <variablelist>\n-        <variable name=\"QUEUESTATUS\">\n-          <para>The status of the call as a text string.</para>\n-          <value name=\"TIMEOUT\"/>\n-          <value name=\"FULL\"/>\n-          <value name=\"JOINEMPTY\"/>\n-          <value name=\"LEAVEEMPTY\"/>\n-          <value name=\"JOINUNAVAIL\"/>\n-          <value name=\"LEAVEUNAVAIL\"/>\n-          <value name=\"CONTINUE\"/>\n-          <value name=\"WITHDRAW\"/>\n-        </variable>\n-        <variable name=\"ABANDONED\">\n-          <para>If the call was not answered by an agent this variable will be TRUE.</para>\n-          <value name=\"TRUE\"/>\n-        </variable>\n-        <variable name=\"DIALEDPEERNUMBER\">\n-          <para>Resource of the agent that was dialed set on the outbound channel.</para>\n-        </variable>\n-        <variable name=\"QUEUE_WITHDRAW_INFO\">\n-          <para>If the call was successfully withdrawn from the queue, and the withdraw request was provided with optional withdraw info, the withdraw info will be stored in this variable.</para>\n-        </variable>\n-      </variablelist>\n-    </description>\n-    <see-also>\n-      <ref type=\"application\">Queue</ref>\n-      <ref type=\"application\">QueueLog</ref>\n-      <ref type=\"application\">AddQueueMember</ref>\n-      <ref type=\"application\">RemoveQueueMember</ref>\n-      <ref type=\"application\">PauseQueueMember</ref>\n-      <ref type=\"application\">UnpauseQueueMember</ref>\n-      <ref type=\"function\">QUEUE_VARIABLES</ref>\n-      <ref type=\"function\">QUEUE_MEMBER</ref>\n-      <ref type=\"function\">QUEUE_MEMBER_COUNT</ref>\n-      <ref type=\"function\">QUEUE_EXISTS</ref>\n-      <ref type=\"function\">QUEUE_GET_CHANNEL</ref>\n-      <ref type=\"function\">QUEUE_WAITING_COUNT</ref>\n-      <ref type=\"function\">QUEUE_MEMBER_LIST</ref>\n-      <ref type=\"function\">QUEUE_MEMBER_PENALTY</ref>\n-    </see-also>\n-  </application>\n-  <application name=\"AddQueueMember\" language=\"en_US\">\n-    <synopsis>Dynamically adds queue members.</synopsis>\n-    <syntax>\n-      <parameter name=\"queuename\" required=\"true\"/>\n-      <parameter name=\"interface\"/>\n-      <parameter name=\"penalty\"/>\n-      <parameter name=\"options\"/>\n-      <parameter name=\"membername\"/>\n-      <parameter name=\"stateinterface\"/>\n-      <parameter name=\"wrapuptime\"/>\n-    </syntax>\n-    <description>\n-      <para>Dynamically adds interface to an existing queue. If the interface is\n-\t\t\talready in the queue it will return an error.</para>\n-      <para>This application sets the following channel variable upon completion:</para>\n-      <variablelist>\n-        <variable name=\"AQMSTATUS\">\n-          <para>The status of the attempt to add a queue member as a text string.</para>\n-          <value name=\"ADDED\"/>\n-          <value name=\"MEMBERALREADY\"/>\n-          <value name=\"NOSUCHQUEUE\"/>\n-        </variable>\n-      </variablelist>\n-    </description>\n-    <see-also>\n-      <ref type=\"application\">Queue</ref>\n-      <ref type=\"application\">QueueLog</ref>\n-      <ref type=\"application\">AddQueueMember</ref>\n-      <ref type=\"application\">RemoveQueueMember</ref>\n-      <ref type=\"application\">PauseQueueMember</ref>\n-      <ref type=\"application\">UnpauseQueueMember</ref>\n-      <ref type=\"function\">QUEUE_VARIABLES</ref>\n-      <ref type=\"function\">QUEUE_MEMBER</ref>\n-      <ref type=\"function\">QUEUE_MEMBER_COUNT</ref>\n-      <ref type=\"function\">QUEUE_EXISTS</ref>\n-      <ref type=\"function\">QUEUE_GET_CHANNEL</ref>\n-      <ref type=\"function\">QUEUE_WAITING_COUNT</ref>\n-      <ref type=\"function\">QUEUE_MEMBER_LIST</ref>\n-      <ref type=\"function\">QUEUE_MEMBER_PENALTY</ref>\n-    </see-also>\n-  </application>\n-  <application name=\"RemoveQueueMember\" language=\"en_US\">\n-    <synopsis>Dynamically removes queue members.</synopsis>\n-    <syntax>\n-      <parameter name=\"queuename\" required=\"true\"/>\n-      <parameter name=\"interface\"/>\n-    </syntax>\n-    <description>\n-      <para>\n-        If the interface is\n-        <emphasis>NOT</emphasis>\n-        in the queue it will return an error.\n-      </para>\n-      <para>This application sets the following channel variable upon completion:</para>\n-      <variablelist>\n-        <variable name=\"RQMSTATUS\">\n-          <value name=\"REMOVED\"/>\n-          <value name=\"NOTINQUEUE\"/>\n-          <value name=\"NOSUCHQUEUE\"/>\n-          <value name=\"NOTDYNAMIC\"/>\n-        </variable>\n-      </variablelist>\n-      <example title=\"Remove queue member\">same =&gt; n,RemoveQueueMember(techsupport,SIP/3000)</example>\n-    </description>\n-    <see-also>\n-      <ref type=\"application\">Queue</ref>\n-      <ref type=\"application\">QueueLog</ref>\n-      <ref type=\"application\">AddQueueMember</ref>\n-      <ref type=\"application\">RemoveQueueMember</ref>\n-      <ref type=\"application\">PauseQueueMember</ref>\n-      <ref type=\"application\">UnpauseQueueMember</ref>\n-      <ref type=\"function\">QUEUE_VARIABLES</ref>\n-      <ref type=\"function\">QUEUE_MEMBER</ref>\n-      <ref type=\"function\">QUEUE_MEMBER_COUNT</ref>\n-      <ref type=\"function\">QUEUE_EXISTS</ref>\n-      <ref type=\"function\">QUEUE_GET_CHANNEL</ref>\n-      <ref type=\"function\">QUEUE_WAITING_COUNT</ref>\n-      <ref type=\"function\">QUEUE_MEMBER_LIST</ref>\n-      <ref type=\"function\">QUEUE_MEMBER_PENALTY</ref>\n-    </see-also>\n-  </application>\n-  <application name=\"PauseQueueMember\" language=\"en_US\">\n-    <synopsis>Pauses a queue member.</synopsis>\n-    <syntax>\n-      <parameter name=\"queuename\"/>\n-      <parameter name=\"interface\" required=\"true\"/>\n-      <parameter name=\"options\"/>\n-      <parameter name=\"reason\">\n-        <para>Is used to add extra information to the appropriate queue_log entries and manager events.</para>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>Pauses (blocks calls for) a queue member. The given interface will be paused in the given queue.\n-\t\t\tThis prevents any calls from being sent from the queue to the interface until it is\n-\t\t\tunpaused with UnpauseQueueMember or the manager interface.  If no queuename is given,\n-\t\t\tthe interface is paused in every queue it is a member of. The application will fail if the\n-\t\t\tinterface is not found.</para>\n-      <para>This application sets the following channel variable upon completion:</para>\n-      <variablelist>\n-        <variable name=\"PQMSTATUS\">\n-          <para>The status of the attempt to pause a queue member as a text string.</para>\n-          <value name=\"PAUSED\"/>\n-          <value name=\"NOTFOUND\"/>\n-        </variable>\n-      </variablelist>\n-      <example title=\"Pause queue member\">same =&gt; n,PauseQueueMember(,SIP/3000)</example>\n-    </description>\n-    <see-also>\n-      <ref type=\"application\">Queue</ref>\n-      <ref type=\"application\">QueueLog</ref>\n-      <ref type=\"application\">AddQueueMember</ref>\n-      <ref type=\"application\">RemoveQueueMember</ref>\n-      <ref type=\"application\">PauseQueueMember</ref>\n-      <ref type=\"application\">UnpauseQueueMember</ref>\n-      <ref type=\"function\">QUEUE_VARIABLES</ref>\n-      <ref type=\"function\">QUEUE_MEMBER</ref>\n-      <ref type=\"function\">QUEUE_MEMBER_COUNT</ref>\n-      <ref type=\"function\">QUEUE_EXISTS</ref>\n-      <ref type=\"function\">QUEUE_GET_CHANNEL</ref>\n-      <ref type=\"function\">QUEUE_WAITING_COUNT</ref>\n-      <ref type=\"function\">QUEUE_MEMBER_LIST</ref>\n-      <ref type=\"function\">QUEUE_MEMBER_PENALTY</ref>\n-    </see-also>\n-  </application>\n-  <application name=\"UnpauseQueueMember\" language=\"en_US\">\n-    <synopsis>Unpauses a queue member.</synopsis>\n-    <syntax>\n-      <parameter name=\"queuename\"/>\n-      <parameter name=\"interface\" required=\"true\"/>\n-      <parameter name=\"options\"/>\n-      <parameter name=\"reason\">\n-        <para>Is used to add extra information to the appropriate queue_log entries and manager events.</para>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>\n-        Unpauses (resumes calls to) a queue member. This is the counterpart to\n-        <literal>PauseQueueMember()</literal>\n-        and operates exactly the same way, except it unpauses instead of pausing the given interface.\n-      </para>\n-      <para>This application sets the following channel variable upon completion:</para>\n-      <variablelist>\n-        <variable name=\"UPQMSTATUS\">\n-          <para>The status of the attempt to unpause a queue member as a text string.</para>\n-          <value name=\"UNPAUSED\"/>\n-          <value name=\"NOTFOUND\"/>\n-        </variable>\n-      </variablelist>\n-      <example title=\"Unpause queue member\">same =&gt; n,UnpauseQueueMember(,SIP/3000)</example>\n-    </description>\n-    <see-also>\n-      <ref type=\"application\">Queue</ref>\n-      <ref type=\"application\">QueueLog</ref>\n-      <ref type=\"application\">AddQueueMember</ref>\n-      <ref type=\"application\">RemoveQueueMember</ref>\n-      <ref type=\"application\">PauseQueueMember</ref>\n-      <ref type=\"application\">UnpauseQueueMember</ref>\n-      <ref type=\"function\">QUEUE_VARIABLES</ref>\n-      <ref type=\"function\">QUEUE_MEMBER</ref>\n-      <ref type=\"function\">QUEUE_MEMBER_COUNT</ref>\n-      <ref type=\"function\">QUEUE_EXISTS</ref>\n-      <ref type=\"function\">QUEUE_GET_CHANNEL</ref>\n-      <ref type=\"function\">QUEUE_WAITING_COUNT</ref>\n-      <ref type=\"function\">QUEUE_MEMBER_LIST</ref>\n-      <ref type=\"function\">QUEUE_MEMBER_PENALTY</ref>\n-    </see-also>\n-  </application>\n-  <application name=\"QueueLog\" language=\"en_US\">\n-    <synopsis>Writes to the queue_log file.</synopsis>\n-    <syntax>\n-      <parameter name=\"queuename\" required=\"true\"/>\n-      <parameter name=\"uniqueid\" required=\"true\"/>\n-      <parameter name=\"agent\" required=\"true\"/>\n-      <parameter name=\"event\" required=\"true\"/>\n-      <parameter name=\"additionalinfo\"/>\n-    </syntax>\n-    <description>\n-      <para>Allows you to write your own events into the queue log.</para>\n-      <example title=\"Log custom queue event\">same =&gt; n,QueueLog(101,${UNIQUEID},${AGENT},WENTONBREAK,600)</example>\n-    </description>\n-    <see-also>\n-      <ref type=\"application\">Queue</ref>\n-      <ref type=\"application\">QueueLog</ref>\n-      <ref type=\"application\">AddQueueMember</ref>\n-      <ref type=\"application\">RemoveQueueMember</ref>\n-      <ref type=\"application\">PauseQueueMember</ref>\n-      <ref type=\"application\">UnpauseQueueMember</ref>\n-      <ref type=\"function\">QUEUE_VARIABLES</ref>\n-      <ref type=\"function\">QUEUE_MEMBER</ref>\n-      <ref type=\"function\">QUEUE_MEMBER_COUNT</ref>\n-      <ref type=\"function\">QUEUE_EXISTS</ref>\n-      <ref type=\"function\">QUEUE_GET_CHANNEL</ref>\n-      <ref type=\"function\">QUEUE_WAITING_COUNT</ref>\n-      <ref type=\"function\">QUEUE_MEMBER_LIST</ref>\n-      <ref type=\"function\">QUEUE_MEMBER_PENALTY</ref>\n-    </see-also>\n-  </application>\n-  <application name=\"QueueUpdate\" language=\"en_US\">\n-    <synopsis>Writes to the queue_log file for outbound calls and updates Realtime Data.\n-\t\t\tIs used at h extension to be able to have all the parameters.</synopsis>\n-    <syntax>\n-      <parameter name=\"queuename\" required=\"true\"/>\n-      <parameter name=\"uniqueid\" required=\"true\"/>\n-      <parameter name=\"agent\" required=\"true\"/>\n-      <parameter name=\"status\" required=\"true\"/>\n-      <parameter name=\"talktime\" required=\"true\"/>\n-      <parameter name=\"params\" required=\"false\"/>\n-    </syntax>\n-    <description>\n-      <para>Allows you to write Outbound events into the queue log.</para>\n-      <example title=\"Write outbound event into queue log\">exten =&gt; h,1,QueueUpdate(${QUEUE}, ${UNIQUEID}, ${AGENT}, ${DIALSTATUS}, ${ANSWEREDTIME}, ${DIALEDTIME} | ${DIALEDNUMBER})</example>\n-    </description>\n-  </application>\n-  <function name=\"QUEUE_VARIABLES\" language=\"en_US\">\n-    <synopsis>Return Queue information in variables.</synopsis>\n-    <syntax>\n-      <parameter name=\"queuename\" required=\"true\">\n-        <enumlist>\n-          <enum name=\"QUEUEMAX\">\n-            <para>Maxmimum number of calls allowed.</para>\n-          </enum>\n-          <enum name=\"QUEUESTRATEGY\">\n-            <para>The strategy of the queue.</para>\n-          </enum>\n-          <enum name=\"QUEUECALLS\">\n-            <para>Number of calls currently in the queue.</para>\n-          </enum>\n-          <enum name=\"QUEUEHOLDTIME\">\n-            <para>Current average hold time.</para>\n-          </enum>\n-          <enum name=\"QUEUECOMPLETED\">\n-            <para>Number of completed calls for the queue.</para>\n-          </enum>\n-          <enum name=\"QUEUEABANDONED\">\n-            <para>Number of abandoned calls.</para>\n-          </enum>\n-          <enum name=\"QUEUESRVLEVEL\">\n-            <para>Queue service level.</para>\n-          </enum>\n-          <enum name=\"QUEUESRVLEVELPERF\">\n-            <para>Current service level performance.</para>\n-          </enum>\n-        </enumlist>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>Makes the following queue variables available.</para>\n-      <para>\n-        Returns\n-        <literal>0</literal>\n-        if queue is found and setqueuevar is defined,\n-        <literal>-1</literal>\n-        otherwise.\n-      </para>\n-    </description>\n-    <see-also>\n-      <ref type=\"application\">Queue</ref>\n-      <ref type=\"application\">QueueLog</ref>\n-      <ref type=\"application\">AddQueueMember</ref>\n-      <ref type=\"application\">RemoveQueueMember</ref>\n-      <ref type=\"application\">PauseQueueMember</ref>\n-      <ref type=\"application\">UnpauseQueueMember</ref>\n-      <ref type=\"function\">QUEUE_VARIABLES</ref>\n-      <ref type=\"function\">QUEUE_MEMBER</ref>\n-      <ref type=\"function\">QUEUE_MEMBER_COUNT</ref>\n-      <ref type=\"function\">QUEUE_EXISTS</ref>\n-      <ref type=\"function\">QUEUE_GET_CHANNEL</ref>\n-      <ref type=\"function\">QUEUE_WAITING_COUNT</ref>\n-      <ref type=\"function\">QUEUE_MEMBER_LIST</ref>\n-      <ref type=\"function\">QUEUE_MEMBER_PENALTY</ref>\n-    </see-also>\n-  </function>\n-  <function name=\"QUEUE_MEMBER\" language=\"en_US\">\n-    <synopsis>Provides a count of queue members based on the provided criteria, or updates a\n-\t\t\tqueue member's settings.</synopsis>\n-    <syntax>\n-      <parameter name=\"queuename\" required=\"false\"/>\n-      <parameter name=\"option\" required=\"true\">\n-        <enumlist>\n-          <enum name=\"logged\">\n-            <para>Returns the number of logged-in members for the specified queue.</para>\n-          </enum>\n-          <enum name=\"free\">\n-            <para>Returns the number of logged-in members for the specified queue that either can take calls or are currently wrapping up after a previous call.</para>\n-          </enum>\n-          <enum name=\"ready\">\n-            <para>Returns the number of logged-in members for the specified queue that are immediately available to answer a call.</para>\n-          </enum>\n-          <enum name=\"count\">\n-            <para>Returns the total number of members for the specified queue.</para>\n-          </enum>\n-          <enum name=\"penalty\">\n-            <para>\n-              Gets or sets queue member penalty.  If\n-              <replaceable>queuename</replaceable>\n-              is not specified\n-\t\t\t\t\t\twhen setting the penalty then the penalty is set in all queues\n-\t\t\t\t\t\tthe interface is a member.\n-            </para>\n-          </enum>\n-          <enum name=\"paused\">\n-            <para>\n-              Gets or sets queue member paused status.  If\n-              <replaceable>queuename</replaceable>\n-              is not specified\n-\t\t\t\t\t\twhen setting the paused status then the paused status is set\n-\t\t\t\t\t\tin all queues the interface is a member.\n-            </para>\n-          </enum>\n-          <enum name=\"ringinuse\">\n-            <para>\n-              Gets or sets queue member ringinuse.  If\n-              <replaceable>queuename</replaceable>\n-              is not specified\n-\t\t\t\t\t\twhen setting ringinuse then ringinuse is set\n-\t\t\t\t\t\tin all queues the interface is a member.\n-            </para>\n-          </enum>\n-        </enumlist>\n-      </parameter>\n-      <parameter name=\"interface\" required=\"false\"/>\n-    </syntax>\n-    <description>\n-      <para>Allows access to queue counts [R] and member information [R/W].</para>\n-      <para>\n-        <replaceable>queuename</replaceable>\n-        is required for all read operations.\n-      </para>\n-      <para>\n-        <replaceable>interface</replaceable>\n-        is required for all member operations.\n-      </para>\n-    </description>\n-    <see-also>\n-      <ref type=\"application\">Queue</ref>\n-      <ref type=\"application\">QueueLog</ref>\n-      <ref type=\"application\">AddQueueMember</ref>\n-      <ref type=\"application\">RemoveQueueMember</ref>\n-      <ref type=\"application\">PauseQueueMember</ref>\n-      <ref type=\"application\">UnpauseQueueMember</ref>\n-      <ref type=\"function\">QUEUE_VARIABLES</ref>\n-      <ref type=\"function\">QUEUE_MEMBER</ref>\n-      <ref type=\"function\">QUEUE_MEMBER_COUNT</ref>\n-      <ref type=\"function\">QUEUE_EXISTS</ref>\n-      <ref type=\"function\">QUEUE_GET_CHANNEL</ref>\n-      <ref type=\"function\">QUEUE_WAITING_COUNT</ref>\n-      <ref type=\"function\">QUEUE_MEMBER_LIST</ref>\n-      <ref type=\"function\">QUEUE_MEMBER_PENALTY</ref>\n-    </see-also>\n-  </function>\n-  <function name=\"QUEUE_MEMBER_COUNT\" language=\"en_US\">\n-    <synopsis>Count number of members answering a queue.</synopsis>\n-    <syntax>\n-      <parameter name=\"queuename\" required=\"true\"/>\n-    </syntax>\n-    <description>\n-      <para>\n-        Returns the number of members currently associated with the specified\n-        <replaceable>queuename</replaceable>\n-        .\n-      </para>\n-      <warning>\n-        <para>\n-          This function has been deprecated in favor of the\n-          <literal>QUEUE_MEMBER()</literal>\n-          function\n-        </para>\n-      </warning>\n-    </description>\n-    <see-also>\n-      <ref type=\"application\">Queue</ref>\n-      <ref type=\"application\">QueueLog</ref>\n-      <ref type=\"application\">AddQueueMember</ref>\n-      <ref type=\"application\">RemoveQueueMember</ref>\n-      <ref type=\"application\">PauseQueueMember</ref>\n-      <ref type=\"application\">UnpauseQueueMember</ref>\n-      <ref type=\"function\">QUEUE_VARIABLES</ref>\n-      <ref type=\"function\">QUEUE_MEMBER</ref>\n-      <ref type=\"function\">QUEUE_MEMBER_COUNT</ref>\n-      <ref type=\"function\">QUEUE_EXISTS</ref>\n-      <ref type=\"function\">QUEUE_GET_CHANNEL</ref>\n-      <ref type=\"function\">QUEUE_WAITING_COUNT</ref>\n-      <ref type=\"function\">QUEUE_MEMBER_LIST</ref>\n-      <ref type=\"function\">QUEUE_MEMBER_PENALTY</ref>\n-    </see-also>\n-  </function>\n-  <function name=\"QUEUE_EXISTS\" language=\"en_US\">\n-    <synopsis>Check if a named queue exists on this server</synopsis>\n-    <syntax>\n-      <parameter name=\"queuename\"/>\n-    </syntax>\n-    <description>\n-      <para>Returns 1 if the specified queue exists, 0 if it does not</para>\n-    </description>\n-    <see-also>\n-      <ref type=\"application\">Queue</ref>\n-      <ref type=\"application\">QueueLog</ref>\n-      <ref type=\"application\">AddQueueMember</ref>\n-      <ref type=\"application\">RemoveQueueMember</ref>\n-      <ref type=\"application\">PauseQueueMember</ref>\n-      <ref type=\"application\">UnpauseQueueMember</ref>\n-      <ref type=\"function\">QUEUE_VARIABLES</ref>\n-      <ref type=\"function\">QUEUE_MEMBER</ref>\n-      <ref type=\"function\">QUEUE_MEMBER_COUNT</ref>\n-      <ref type=\"function\">QUEUE_EXISTS</ref>\n-      <ref type=\"function\">QUEUE_GET_CHANNEL</ref>\n-      <ref type=\"function\">QUEUE_WAITING_COUNT</ref>\n-      <ref type=\"function\">QUEUE_MEMBER_LIST</ref>\n-      <ref type=\"function\">QUEUE_MEMBER_PENALTY</ref>\n-    </see-also>\n-  </function>\n-  <function name=\"QUEUE_GET_CHANNEL\" language=\"en_US\">\n-    <synopsis>Return caller at the specified position in a queue.</synopsis>\n-    <syntax>\n-      <parameter name=\"queuename\" required=\"true\"/>\n-      <parameter name=\"position\"/>\n-    </syntax>\n-    <description>\n-      <para>\n-        Returns the caller channel at\n-        <replaceable>position</replaceable>\n-        in the specified\n-        <replaceable>queuename</replaceable>\n-        .\n+        Returns the caller channel at\n+        <replaceable>position</replaceable>\n+        in the specified\n+        <replaceable>queuename</replaceable>\n+        .\n       </para>\n       <para>\n         If\n         <replaceable>position</replaceable>\n         is unspecified the first channel is returned.\n       </para>\n     </description>\n@@ -6933,15 +8798,147 @@\n       <see-also>\n         <ref type=\"managerEvent\">AgentCalled</ref>\n         <ref type=\"managerEvent\">AgentComplete</ref>\n         <ref type=\"managerEvent\">AgentDump</ref>\n       </see-also>\n     </managerEventInstance>\n   </managerEvent>\n-  <module language=\"en_US\" name=\"app_voicemail\">\n+  <module language=\"en_US\" name=\"app_playtones\">\n+    <support_level>core</support_level>\n+  </module>\n+  <application name=\"PlayTones\" language=\"en_US\">\n+    <synopsis>Play a tone list.</synopsis>\n+    <syntax>\n+      <parameter name=\"arg\" required=\"true\">\n+        <para>\n+          Arg is either the tone name defined in the\n+          <filename>indications.conf</filename>\n+          configuration file, or a directly specified list of frequencies and durations.\n+        </para>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>Plays a tone list. Execution will continue with the next step in the dialplan\n+\t\t\timmediately while the tones continue to play.</para>\n+      <para>\n+        See the sample\n+        <filename>indications.conf</filename>\n+        for a description of the\n+\t\t\tspecification of a tonelist.\n+      </para>\n+    </description>\n+    <see-also>\n+      <ref type=\"application\">StopPlayTones</ref>\n+    </see-also>\n+  </application>\n+  <application name=\"StopPlayTones\" language=\"en_US\">\n+    <synopsis>Stop playing a tone list.</synopsis>\n+    <syntax/>\n+    <description>\n+      <para>Stop playing a tone list, initiated by PlayTones().</para>\n+    </description>\n+    <see-also>\n+      <ref type=\"application\">PlayTones</ref>\n+    </see-also>\n+  </application>\n+  <module language=\"en_US\" name=\"app_dahdiras\">\n+    <depend>dahdi</depend>\n+    <support_level>deprecated</support_level>\n+    <deprecated_in>16</deprecated_in>\n+    <removed_in>19</removed_in>\n+  </module>\n+  <application name=\"DAHDIRAS\" language=\"en_US\">\n+    <synopsis>Executes DAHDI ISDN RAS application.</synopsis>\n+    <syntax>\n+      <parameter name=\"args\" required=\"true\">\n+        <para>\n+          A list of parameters to pass to the pppd daemon,\n+\t\t\t\tseparated by\n+          <literal>,</literal>\n+          characters.\n+        </para>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>Executes a RAS server using pppd on the given channel.\n+\t\t\tThe channel must be a clear channel (i.e. PRI source) and a DAHDI\n+\t\t\tchannel to be able to use this function (No modem emulation is included).</para>\n+      <para>Your pppd must be patched to be DAHDI aware.</para>\n+    </description>\n+  </application>\n+  <module language=\"en_US\" name=\"app_attended_transfer\">\n+    <support_level>extended</support_level>\n+  </module>\n+  <application name=\"AttendedTransfer\" language=\"en_US\">\n+    <synopsis>Attended transfer to the extension provided and TRANSFER_CONTEXT</synopsis>\n+    <syntax>\n+      <parameter name=\"exten\" required=\"true\">\n+        <para>Specify extension.</para>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>\n+        Queue up attended transfer to the specified extension in the\n+        <literal>TRANSFER_CONTEXT</literal>\n+        .\n+      </para>\n+      <para>Note that the attended transfer only work when two channels have answered and are bridged together.</para>\n+      <para>\n+        Make sure to set Attended Transfer DTMF feature\n+        <literal>atxfer</literal>\n+        and attended transfer is permitted.\n+      </para>\n+      <para>\n+        The result of the application will be reported in the\n+        <variable>ATTENDEDTRANSFERSTATUS</variable>\n+        channel variable:\n+      </para>\n+      <variablelist>\n+        <variable name=\"ATTENDEDTRANSFERSTATUS\">\n+          <value name=\"SUCCESS\">Transfer successfully queued.</value>\n+          <value name=\"FAILURE\">Transfer failed.</value>\n+          <value name=\"NOTPERMITTED\">Transfer not permitted.</value>\n+        </variable>\n+      </variablelist>\n+    </description>\n+  </application>\n+  <module language=\"en_US\" name=\"app_image\">\n+    <support_level>deprecated</support_level>\n+    <deprecated_in>16</deprecated_in>\n+    <removed_in>19</removed_in>\n+  </module>\n+  <application name=\"SendImage\" language=\"en_US\">\n+    <synopsis>Sends an image file.</synopsis>\n+    <syntax>\n+      <parameter name=\"filename\" required=\"true\">\n+        <para>Path of the filename (image) to send.</para>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>Send an image file on a channel supporting it.</para>\n+      <para>\n+        Result of transmission will be stored in\n+        <variable>SENDIMAGESTATUS</variable>\n+      </para>\n+      <variablelist>\n+        <variable name=\"SENDIMAGESTATUS\">\n+          <value name=\"SUCCESS\">Transmission succeeded.</value>\n+          <value name=\"FAILURE\">Transmission failed.</value>\n+          <value name=\"UNSUPPORTED\">Image transmission not supported by channel.</value>\n+        </variable>\n+      </variablelist>\n+    </description>\n+    <see-also>\n+      <ref type=\"application\">SendText</ref>\n+      <ref type=\"application\">SendURL</ref>\n+    </see-also>\n+  </application>\n+  <module language=\"en_US\" name=\"app_voicemail_imapstorage\">\n+    <depend>openssl</depend>\n+    <depend>imap_tk</depend>\n     <use type=\"module\">res_adsi</use>\n     <use type=\"module\">res_smdi</use>\n     <defaultenabled>yes</defaultenabled>\n     <support_level>core</support_level>\n   </module>\n   <application name=\"VoiceMail\" language=\"en_US\">\n     <synopsis>Leave a Voicemail message.</synopsis>\n@@ -7455,715 +9452,669 @@\n \t\t\twithin\n         <replaceable>Context</replaceable>\n         will be polled.\n \t\t\tOtherwise, only a single mailbox will be polled for changes.\n       </para>\n     </description>\n   </manager>\n-  <module language=\"en_US\" name=\"app_echo\">\n-    <support_level>core</support_level>\n-  </module>\n-  <application name=\"Echo\" language=\"en_US\">\n-    <synopsis>Echo media, DTMF back to the calling party</synopsis>\n-    <syntax/>\n-    <description>\n-      <para>Echos back any media or DTMF frames read from the calling\n-\t\t\tchannel back to itself. This will not echo CONTROL, MODEM, or NULL\n-\t\t\tframes. Note: If '#' detected application exits.</para>\n-      <para>This application does not automatically answer and should be\n-\t\t\tpreceeded by an application such as Answer() or Progress().</para>\n-    </description>\n-  </application>\n-  <module language=\"en_US\" name=\"app_disa\">\n-    <use type=\"module\">app_cdr</use>\n+  <module language=\"en_US\" name=\"app_voicemail_odbcstorage\">\n+    <depend>unixodbc</depend>\n+    <use type=\"module\">res_adsi</use>\n+    <use type=\"module\">res_smdi</use>\n+    <defaultenabled>yes</defaultenabled>\n     <support_level>core</support_level>\n   </module>\n-  <application name=\"DISA\" language=\"en_US\">\n-    <synopsis>Direct Inward System Access.</synopsis>\n+  <application name=\"VoiceMail\" language=\"en_US\">\n+    <synopsis>Leave a Voicemail message.</synopsis>\n     <syntax>\n-      <parameter name=\"passcode|filename\" required=\"true\">\n-        <para>\n-          If you need to present a DISA dialtone without entering a password,\n-\t\t\t\tsimply set\n-          <replaceable>passcode</replaceable>\n-          to\n-          <literal>no-password</literal>\n-        </para>\n-        <para>\n-          You may specified a\n-          <replaceable>filename</replaceable>\n-          instead of a\n-          <replaceable>passcode</replaceable>\n-          , this filename must contain individual passcodes\n-        </para>\n-      </parameter>\n-      <parameter name=\"context\">\n-        <para>\n-          Specifies the dialplan context in which the user-entered extension\n-\t\t\t\twill be matched. If no context is specified, the DISA application defaults\n-\t\t\t\tto the\n-          <literal>disa</literal>\n-          context. Presumably a normal system will have a special\n-\t\t\t\tcontext set up for DISA use with some or a lot of restrictions.\n-        </para>\n-      </parameter>\n-      <parameter name=\"cid\">\n-        <para>Specifies a new (different) callerid to be used for this call.</para>\n-      </parameter>\n-      <parameter name=\"mailbox\" argsep=\"@\">\n-        <para>\n-          Will cause a stutter-dialtone (indication\n-          <emphasis>dialrecall</emphasis>\n-          )\n-\t\t\t\tto be used, if the specified mailbox contains any new messages.\n-        </para>\n-        <argument name=\"mailbox\" required=\"true\"/>\n-        <argument name=\"context\" required=\"false\"/>\n+      <parameter name=\"mailboxs\" argsep=\"&amp;\" required=\"true\">\n+        <argument name=\"mailbox1\" argsep=\"@\" required=\"true\">\n+          <argument name=\"mailbox\" required=\"true\"/>\n+          <argument name=\"context\"/>\n+        </argument>\n+        <argument name=\"mailbox2\" argsep=\"@\" multiple=\"true\">\n+          <argument name=\"mailbox\" required=\"true\"/>\n+          <argument name=\"context\"/>\n+        </argument>\n       </parameter>\n       <parameter name=\"options\">\n         <optionlist>\n-          <option name=\"n\">\n-            <para>The DISA application will not answer initially.</para>\n+          <option name=\"b\">\n+            <para>\n+              Play the\n+              <literal>busy</literal>\n+              greeting to the calling party.\n+            </para>\n           </option>\n-          <option name=\"p\">\n+          <option name=\"d\">\n+            <argument name=\"c\"/>\n             <para>\n-              The extension entered will be considered complete when a\n-              <literal>#</literal>\n-              is entered.\n+              Accept digits for a new extension in context\n+              <replaceable>c</replaceable>\n+              ,\n+\t\t\t\t\t\tif played during the greeting. Context defaults to the current context.\n+            </para>\n+          </option>\n+          <option name=\"e\">\n+            <para>Play greetings as early media -- only answer the channel just\n+\t\t\t\t\t\tbefore accepting the voice message.</para>\n+          </option>\n+          <option name=\"g\">\n+            <argument name=\"#\" required=\"true\"/>\n+            <para>Use the specified amount of gain when recording the voicemail\n+\t\t\t\t\t\tmessage. The units are whole-number decibels (dB). Only works on supported\n+\t\t\t\t\t\ttechnologies, which is DAHDI only.</para>\n+          </option>\n+          <option name=\"s\">\n+            <para>Skip the playback of instructions for leaving a message to the\n+\t\t\t\t\t\tcalling party.</para>\n+          </option>\n+          <option name=\"S\">\n+            <para>Skip the playback of instructions for leaving a message to the\n+\t\t\t\t\t\tcalling party, but only if a greeting has been recorded by the\n+\t\t\t\t\t\tmailbox user.</para>\n+          </option>\n+          <option name=\"t\">\n+            <argument name=\"x\" required=\"false\"/>\n+            <para>Play a custom beep tone to the caller instead of the default one.\n+\t\t\t\t\t\tIf this option is used but no file is specified, the beep is suppressed.</para>\n+          </option>\n+          <option name=\"u\">\n+            <para>\n+              Play the\n+              <literal>unavailable</literal>\n+              greeting.\n+            </para>\n+          </option>\n+          <option name=\"U\">\n+            <para>\n+              Mark message as\n+              <literal>URGENT</literal>\n+              .\n+            </para>\n+          </option>\n+          <option name=\"P\">\n+            <para>\n+              Mark message as\n+              <literal>PRIORITY</literal>\n+              .\n             </para>\n           </option>\n         </optionlist>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>\n-        The DISA, Direct Inward System Access, application allows someone from\n-\t\t\toutside the telephone switch (PBX) to obtain an\n-        <emphasis>internal</emphasis>\n-        system\n-\t\t\tdialtone and to place calls from it as if they were placing a call from\n-\t\t\twithin the switch.\n-\t\t\tDISA plays a dialtone. The user enters their numeric passcode, followed by\n-\t\t\tthe pound sign\n-        <literal>#</literal>\n-        . If the passcode is correct, the user is then given\n-\t\t\tsystem dialtone within\n-        <replaceable>context</replaceable>\n-        on which a call may be placed.\n-\t\t\tIf the user enters an invalid extension and extension\n-        <literal>i</literal>\n-        exists in the specified\n-        <replaceable>context</replaceable>\n-        , it will be used.\n-      </para>\n-      <para>Be aware that using this may compromise the security of your PBX.</para>\n-      <para>\n-        The arguments to this application (in\n-        <filename>extensions.conf</filename>\n-        ) allow either\n-\t\t\tspecification of a single global\n-        <replaceable>passcode</replaceable>\n-        (that everyone uses), or\n-\t\t\tindividual passcodes contained in a file (\n-        <replaceable>filename</replaceable>\n-        ).\n-      </para>\n-      <para>\n-        The file that contains the passcodes (if used) allows a complete\n-\t\t\tspecification of all of the same arguments available on the command\n-\t\t\tline, with the sole exception of the options. The file may contain blank\n-\t\t\tlines, or comments starting with\n-        <literal>#</literal>\n-        or\n-        <literal>;</literal>\n-        .\n-      </para>\n+      <para>This application allows the calling party to leave a message for the specified\n+\t\t\tlist of mailboxes. When multiple mailboxes are specified, the greeting will be taken from\n+\t\t\tthe first mailbox specified. Dialplan execution will stop if the specified mailbox does not\n+\t\t\texist.</para>\n+      <para>The Voicemail application will exit if any of the following DTMF digits are received:</para>\n+      <enumlist>\n+        <enum name=\"0\">\n+          <para>\n+            Jump to the\n+            <literal>o</literal>\n+            extension in the current dialplan context.\n+          </para>\n+        </enum>\n+        <enum name=\"*\">\n+          <para>\n+            Jump to the\n+            <literal>a</literal>\n+            extension in the current dialplan context.\n+          </para>\n+        </enum>\n+      </enumlist>\n+      <para>This application will set the following channel variable upon completion:</para>\n+      <variablelist>\n+        <variable name=\"VMSTATUS\">\n+          <para>This indicates the status of the execution of the VoiceMail application.</para>\n+          <value name=\"SUCCESS\"/>\n+          <value name=\"USEREXIT\"/>\n+          <value name=\"FAILED\"/>\n+        </variable>\n+      </variablelist>\n     </description>\n     <see-also>\n-      <ref type=\"application\">Authenticate</ref>\n-      <ref type=\"application\">VMAuthenticate</ref>\n+      <ref type=\"application\">VoiceMailMain</ref>\n     </see-also>\n   </application>\n-  <module language=\"en_US\" name=\"app_agent_pool\">\n-    <support_level>core</support_level>\n-  </module>\n-  <application name=\"AgentLogin\" language=\"en_US\">\n-    <synopsis>Login an agent.</synopsis>\n-    <syntax argsep=\",\">\n-      <parameter name=\"AgentId\" required=\"true\"/>\n+  <application name=\"VoiceMailMain\" language=\"en_US\">\n+    <synopsis>Check Voicemail messages.</synopsis>\n+    <syntax>\n+      <parameter name=\"mailbox\" required=\"true\" argsep=\"@\">\n+        <argument name=\"mailbox\"/>\n+        <argument name=\"context\"/>\n+      </parameter>\n       <parameter name=\"options\">\n         <optionlist>\n+          <option name=\"p\">\n+            <para>\n+              Consider the\n+              <replaceable>mailbox</replaceable>\n+              parameter as a prefix to\n+\t\t\t\t\t\tthe mailbox that is entered by the caller.\n+            </para>\n+          </option>\n+          <option name=\"g\">\n+            <argument name=\"#\" required=\"true\"/>\n+            <para>Use the specified amount of gain when recording a voicemail message.\n+\t\t\t\t\t\tThe units are whole-number decibels (dB).</para>\n+          </option>\n+          <option name=\"r\">\n+            <para>&quot;Read only&quot;. Prevent user from deleting any messages.</para>\n+            <para>This applies only to specific executions of VoiceMailMain, NOT the mailbox itself.</para>\n+          </option>\n           <option name=\"s\">\n-            <para>silent login - do not announce the login ok segment after\n-\t\t\t\t\t\tagent logged on.</para>\n+            <para>Skip checking the passcode for the mailbox.</para>\n+          </option>\n+          <option name=\"a\">\n+            <argument name=\"folder\" required=\"true\"/>\n+            <para>\n+              Skip folder prompt and go directly to\n+              <replaceable>folder</replaceable>\n+              specified.\n+\t\t\t\t\t\tDefaults to\n+              <literal>INBOX</literal>\n+              (or\n+              <literal>0</literal>\n+              ).\n+            </para>\n+            <enumlist>\n+              <enum name=\"0\">\n+                <para>INBOX</para>\n+              </enum>\n+              <enum name=\"1\">\n+                <para>Old</para>\n+              </enum>\n+              <enum name=\"2\">\n+                <para>Work</para>\n+              </enum>\n+              <enum name=\"3\">\n+                <para>Family</para>\n+              </enum>\n+              <enum name=\"4\">\n+                <para>Friends</para>\n+              </enum>\n+              <enum name=\"5\">\n+                <para>Cust1</para>\n+              </enum>\n+              <enum name=\"6\">\n+                <para>Cust2</para>\n+              </enum>\n+              <enum name=\"7\">\n+                <para>Cust3</para>\n+              </enum>\n+              <enum name=\"8\">\n+                <para>Cust4</para>\n+              </enum>\n+              <enum name=\"9\">\n+                <para>Cust5</para>\n+              </enum>\n+            </enumlist>\n           </option>\n         </optionlist>\n       </parameter>\n     </syntax>\n     <description>\n       <para>\n-        Login an agent to the system.  Any agent authentication is assumed to\n-\t\t\talready be done by dialplan.  While logged in, the agent can receive calls\n-\t\t\tand will hear the sound file specified by the config option custom_beep\n-\t\t\twhen a new call comes in for the agent.  Login failures will continue in\n-\t\t\tthe dialplan with\n-        <variable>AGENT_STATUS</variable>\n-        set.\n-      </para>\n-      <para>Before logging in, you can setup on the real agent channel the\n-\t\t\tCHANNEL(dtmf_features) an agent will have when talking to a caller\n-\t\t\tand you can setup on the channel running this application the\n-\t\t\tCONNECTEDLINE() information the agent will see while waiting for a\n-\t\t\tcaller.</para>\n-      <para>\n-        <variable>AGENT_STATUS</variable>\n-        enumeration values:\n+        This application allows the calling party to check voicemail messages. A specific\n+        <replaceable>mailbox</replaceable>\n+        , and optional corresponding\n+        <replaceable>context</replaceable>\n+        ,\n+\t\t\tmay be specified. If a\n+        <replaceable>mailbox</replaceable>\n+        is not provided, the calling party will\n+\t\t\tbe prompted to enter one. If a\n+        <replaceable>context</replaceable>\n+        is not specified, the\n+        <literal>default</literal>\n+        context will be used.\n       </para>\n+      <para>The VoiceMailMain application will exit if the following DTMF digit is entered as Mailbox\n+\t\t\tor Password, and the extension exists:</para>\n       <enumlist>\n-        <enum name=\"INVALID\">\n-          <para>The specified agent is invalid.</para>\n-        </enum>\n-        <enum name=\"ALREADY_LOGGED_IN\">\n-          <para>The agent is already logged in.</para>\n+        <enum name=\"*\">\n+          <para>\n+            Jump to the\n+            <literal>a</literal>\n+            extension in the current dialplan context.\n+          </para>\n         </enum>\n       </enumlist>\n-      <note>\n-        <para>\n-          The Agent:\n-          <replaceable>AgentId</replaceable>\n-          device state is\n-\t\t\tavailable to monitor the status of the agent.\n-        </para>\n-      </note>\n     </description>\n     <see-also>\n-      <ref type=\"application\">Authenticate</ref>\n-      <ref type=\"application\">Queue</ref>\n-      <ref type=\"application\">AddQueueMember</ref>\n-      <ref type=\"application\">RemoveQueueMember</ref>\n-      <ref type=\"application\">PauseQueueMember</ref>\n-      <ref type=\"application\">UnpauseQueueMember</ref>\n-      <ref type=\"function\">AGENT</ref>\n-      <ref type=\"function\">CHANNEL</ref>\n-      <ref type=\"function\">CONNECTEDLINE</ref>\n-      <ref type=\"filename\">agents.conf</ref>\n-      <ref type=\"filename\">queues.conf</ref>\n+      <ref type=\"application\">VoiceMail</ref>\n     </see-also>\n   </application>\n-  <application name=\"AgentRequest\" language=\"en_US\">\n-    <synopsis>Request an agent to connect with the channel.</synopsis>\n-    <syntax argsep=\",\">\n-      <parameter name=\"AgentId\" required=\"true\"/>\n+  <application name=\"MailboxExists\" language=\"en_US\">\n+    <synopsis>Check to see if Voicemail mailbox exists.</synopsis>\n+    <syntax>\n+      <parameter name=\"mailbox\" required=\"true\" argsep=\"@\">\n+        <argument name=\"mailbox\" required=\"true\"/>\n+        <argument name=\"context\"/>\n+      </parameter>\n+      <parameter name=\"options\">\n+        <para>None options.</para>\n+      </parameter>\n     </syntax>\n     <description>\n+      <note>\n+        <para>DEPRECATED. Use VM_INFO(mailbox[@context],exists) instead.</para>\n+      </note>\n       <para>\n-        Request an agent to connect with the channel.  Failure to find,\n-\t\t\talert the agent, or acknowledge the call will continue in the dialplan\n-\t\t\twith\n-        <variable>AGENT_STATUS</variable>\n-        set.\n+        Check to see if the specified\n+        <replaceable>mailbox</replaceable>\n+        exists. If no voicemail\n+        <replaceable>context</replaceable>\n+        is specified, the\n+        <literal>default</literal>\n+        context\n+\t\t\twill be used.\n       </para>\n+      <para>This application will set the following channel variable upon completion:</para>\n+      <variablelist>\n+        <variable name=\"VMBOXEXISTSSTATUS\">\n+          <para>This will contain the status of the execution of the MailboxExists application.\n+\t\t\t\t\tPossible values include:</para>\n+          <value name=\"SUCCESS\"/>\n+          <value name=\"FAILED\"/>\n+        </variable>\n+      </variablelist>\n+    </description>\n+    <see-also>\n+      <ref type=\"function\">VM_INFO</ref>\n+    </see-also>\n+  </application>\n+  <application name=\"VMAuthenticate\" language=\"en_US\">\n+    <synopsis>Authenticate with Voicemail passwords.</synopsis>\n+    <syntax>\n+      <parameter name=\"mailbox\" required=\"true\" argsep=\"@\">\n+        <argument name=\"mailbox\"/>\n+        <argument name=\"context\"/>\n+      </parameter>\n+      <parameter name=\"options\">\n+        <optionlist>\n+          <option name=\"s\">\n+            <para>Skip playing the initial prompts.</para>\n+          </option>\n+        </optionlist>\n+      </parameter>\n+    </syntax>\n+    <description>\n       <para>\n-        <variable>AGENT_STATUS</variable>\n-        enumeration values:\n+        This application behaves the same way as the Authenticate application, but the passwords\n+\t\t\tare taken from\n+        <filename>voicemail.conf</filename>\n+        . If the\n+        <replaceable>mailbox</replaceable>\n+        is\n+\t\t\tspecified, only that mailbox's password will be considered valid. If the\n+        <replaceable>mailbox</replaceable>\n+        is not specified, the channel variable\n+        <variable>AUTH_MAILBOX</variable>\n+        will be set with the authenticated\n+\t\t\tmailbox.\n       </para>\n+      <para>The VMAuthenticate application will exit if the following DTMF digit is entered as Mailbox\n+\t\t\tor Password, and the extension exists:</para>\n       <enumlist>\n-        <enum name=\"INVALID\">\n-          <para>The specified agent is invalid.</para>\n-        </enum>\n-        <enum name=\"NOT_LOGGED_IN\">\n-          <para>The agent is not available.</para>\n-        </enum>\n-        <enum name=\"BUSY\">\n-          <para>The agent is on another call.</para>\n-        </enum>\n-        <enum name=\"NOT_CONNECTED\">\n-          <para>The agent did not connect with the\n-\t\t\t\tcall.  The agent most likely did not acknowledge the call.</para>\n-        </enum>\n-        <enum name=\"ERROR\">\n-          <para>Alerting the agent failed.</para>\n+        <enum name=\"*\">\n+          <para>\n+            Jump to the\n+            <literal>a</literal>\n+            extension in the current dialplan context.\n+          </para>\n         </enum>\n       </enumlist>\n     </description>\n-    <see-also>\n-      <ref type=\"application\">AgentLogin</ref>\n-    </see-also>\n   </application>\n-  <function name=\"AGENT\" language=\"en_US\">\n-    <synopsis>Gets information about an Agent</synopsis>\n-    <syntax argsep=\":\">\n-      <parameter name=\"AgentId\" required=\"true\"/>\n-      <parameter name=\"item\">\n-        <para>The valid items to retrieve are:</para>\n-        <enumlist>\n-          <enum name=\"status\">\n-            <para>(default) The status of the agent (LOGGEDIN | LOGGEDOUT)</para>\n-          </enum>\n-          <enum name=\"password\">\n-            <para>Deprecated.  The dialplan handles any agent authentication.</para>\n-          </enum>\n-          <enum name=\"name\">\n-            <para>The name of the agent</para>\n-          </enum>\n-          <enum name=\"mohclass\">\n-            <para>MusicOnHold class</para>\n-          </enum>\n-          <enum name=\"channel\">\n-            <para>The name of the active channel for the Agent (AgentLogin)</para>\n-          </enum>\n-          <enum name=\"fullchannel\">\n-            <para>The untruncated name of the active channel for the Agent (AgentLogin)</para>\n-          </enum>\n-        </enumlist>\n-      </parameter>\n-    </syntax>\n-    <description/>\n-  </function>\n-  <manager name=\"Agents\" language=\"en_US\">\n-    <synopsis>Lists agents and their status.</synopsis>\n+  <application name=\"VoiceMailPlayMsg\" language=\"en_US\">\n+    <synopsis>Play a single voice mail msg from a mailbox by msg id.</synopsis>\n     <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      <parameter name=\"mailbox\" required=\"true\" argsep=\"@\">\n+        <argument name=\"mailbox\"/>\n+        <argument name=\"context\"/>\n+      </parameter>\n+      <parameter name=\"msg_id\" required=\"true\">\n+        <para>The msg id of the msg to play back.</para>\n+      </parameter>\n     </syntax>\n     <description>\n-      <para>Will list info about all defined agents.</para>\n+      <para>This application sets the following channel variable upon completion:</para>\n+      <variablelist>\n+        <variable name=\"VOICEMAIL_PLAYBACKSTATUS\">\n+          <para>The status of the playback attempt as a text string.</para>\n+          <value name=\"SUCCESS\"/>\n+          <value name=\"FAILED\"/>\n+        </variable>\n+      </variablelist>\n     </description>\n-    <see-also>\n-      <ref type=\"managerEvent\">Agents</ref>\n-      <ref type=\"managerEvent\">AgentsComplete</ref>\n-    </see-also>\n-  </manager>\n-  <managerEvent language=\"en_US\" name=\"Agents\">\n-    <managerEventInstance class=\"EVENT_FLAG_AGENT\">\n-      <synopsis>Response event in a series to the Agents AMI action containing\n-\t\t\t\tinformation about a defined agent.</synopsis>\n-      <syntax>\n-        <parameter name=\"Agent\">\n-          <para>Agent ID of the agent.</para>\n-        </parameter>\n-        <parameter name=\"Name\">\n-          <para>User friendly name of the agent.</para>\n-        </parameter>\n-        <parameter name=\"Status\">\n-          <para>Current status of the agent.</para>\n-          <para>The valid values are:</para>\n-          <enumlist>\n-            <enum name=\"AGENT_LOGGEDOFF\"/>\n-            <enum name=\"AGENT_IDLE\"/>\n-            <enum name=\"AGENT_ONCALL\"/>\n-          </enumlist>\n-        </parameter>\n-        <parameter name=\"TalkingToChan\">\n-          <para>\n-            <variable>BRIDGEPEER</variable>\n-            value on agent channel.\n-          </para>\n-          <para>\n-            Present if Status value is\n-            <literal>AGENT_ONCALL</literal>\n-            .\n-          </para>\n-        </parameter>\n-        <parameter name=\"CallStarted\">\n-          <para>Epoche time when the agent started talking with the caller.</para>\n-          <para>\n-            Present if Status value is\n-            <literal>AGENT_ONCALL</literal>\n-            .\n-          </para>\n-        </parameter>\n-        <parameter name=\"LoggedInTime\">\n-          <para>Epoche time when the agent logged in.</para>\n-          <para>\n-            Present if Status value is\n-            <literal>AGENT_IDLE</literal>\n-            or\n-            <literal>AGENT_ONCALL</literal>\n-            .\n-          </para>\n-        </parameter>\n-        <channel_snapshot/>\n-        <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      </syntax>\n-      <description>\n-        <para>\n-          The channel snapshot is present if the Status value is\n-          <literal>AGENT_IDLE</literal>\n-          or\n-          <literal>AGENT_ONCALL</literal>\n-          .\n-        </para>\n-      </description>\n-      <see-also>\n-        <ref type=\"manager\">Agents</ref>\n-      </see-also>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <managerEvent language=\"en_US\" name=\"AgentsComplete\">\n-    <managerEventInstance class=\"EVENT_FLAG_AGENT\">\n-      <synopsis>Final response event in a series of events to the Agents AMI action.</synopsis>\n-      <syntax>\n-        <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      </syntax>\n-      <see-also>\n-        <ref type=\"manager\">Agents</ref>\n-      </see-also>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <manager name=\"AgentLogoff\" language=\"en_US\">\n-    <synopsis>Sets an agent as no longer logged in.</synopsis>\n+  </application>\n+  <application name=\"VMSayName\" language=\"en_US\">\n+    <synopsis>Play the name of a voicemail user</synopsis>\n     <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"Agent\" required=\"true\">\n-        <para>Agent ID of the agent to log off.</para>\n-      </parameter>\n-      <parameter name=\"Soft\">\n-        <para>\n-          Set to\n-          <literal>true</literal>\n-          to not hangup existing calls.\n-        </para>\n+      <parameter name=\"mailbox\" required=\"true\" argsep=\"@\">\n+        <argument name=\"mailbox\"/>\n+        <argument name=\"context\"/>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>Sets an agent as no longer logged in.</para>\n+      <para>\n+        This application will say the recorded name of the voicemail user specified as the\n+\t\t\targument to this application. If no context is provided,\n+        <literal>default</literal>\n+        is assumed.\n+      </para>\n+      <para>Similar to the Background() application, playback of the recorded\n+\t\t\tname can be interrupted by entering an extension, which will be searched\n+\t\t\tfor in the current context.</para>\n     </description>\n-  </manager>\n-  <configInfo name=\"app_agent_pool\" language=\"en_US\">\n-    <synopsis>Agent pool applications</synopsis>\n+  </application>\n+  <function name=\"MAILBOX_EXISTS\" language=\"en_US\">\n+    <synopsis>Tell if a mailbox is configured.</synopsis>\n+    <syntax argsep=\"@\">\n+      <parameter name=\"mailbox\" required=\"true\"/>\n+      <parameter name=\"context\"/>\n+    </syntax>\n     <description>\n       <note>\n-        <para>Option changes take effect on agent login or after an agent\n-\t\t\tdisconnects from a call.</para>\n+        <para>DEPRECATED. Use VM_INFO(mailbox[@context],exists) instead.</para>\n       </note>\n+      <para>\n+        Returns a boolean of whether the corresponding\n+        <replaceable>mailbox</replaceable>\n+        exists.\n+\t\t\tIf\n+        <replaceable>context</replaceable>\n+        is not specified, defaults to the\n+        <literal>default</literal>\n+        context.\n+      </para>\n     </description>\n-    <configFile name=\"agents.conf\">\n-      <configObject name=\"global\">\n-        <synopsis>Unused, but reserved.</synopsis>\n-      </configObject>\n-      <configObject name=\"agent-id\">\n-        <synopsis>Configure an agent for the pool.</synopsis>\n-        <description>\n-          <xi:include xpointer=\"xpointer(/docs/configInfo[@name='app_agent_pool']/description/note)\"/>\n-        </description>\n-        <configOption name=\"ackcall\">\n-          <synopsis>Enable to require the agent to acknowledge a call.</synopsis>\n-          <description>\n-            <para>Enable to require the agent to give a DTMF acknowledgement\n-\t\t\t\t\t\twhen the agent receives a call.</para>\n-            <note>\n-              <para>\n-                The option is overridden by\n-                <variable>AGENTACKCALL</variable>\n-                on agent login.\n-              </para>\n-            </note>\n-            <xi:include xpointer=\"xpointer(/docs/configInfo[@name='app_agent_pool']/description/note)\"/>\n-          </description>\n-        </configOption>\n-        <configOption name=\"acceptdtmf\">\n-          <synopsis>DTMF key sequence the agent uses to acknowledge a call.</synopsis>\n-          <description>\n-            <note>\n-              <para>\n-                The option is overridden by\n-                <variable>AGENTACCEPTDTMF</variable>\n-                on agent login.\n-              </para>\n-            </note>\n-            <note>\n-              <para>The option is ignored unless the ackcall option is enabled.</para>\n-            </note>\n-            <xi:include xpointer=\"xpointer(/docs/configInfo[@name='app_agent_pool']/description/note)\"/>\n-          </description>\n-        </configOption>\n-        <configOption name=\"autologoff\">\n-          <synopsis>Time the agent has to acknowledge a call before being logged off.</synopsis>\n-          <description>\n-            <para>Set how many seconds a call for the agent has to wait for the\n-\t\t\t\t\t\tagent to acknowledge the call before the agent is automatically\n-\t\t\t\t\t\tlogged off.  If set to zero then the call will wait forever for\n-\t\t\t\t\t\tthe agent to acknowledge.</para>\n-            <note>\n-              <para>\n-                The option is overridden by\n-                <variable>AGENTAUTOLOGOFF</variable>\n-                on agent login.\n-              </para>\n-            </note>\n-            <note>\n-              <para>The option is ignored unless the ackcall option is enabled.</para>\n-            </note>\n-            <xi:include xpointer=\"xpointer(/docs/configInfo[@name='app_agent_pool']/description/note)\"/>\n-          </description>\n-        </configOption>\n-        <configOption name=\"wrapuptime\">\n-          <synopsis>Minimum time the agent has between calls.</synopsis>\n-          <description>\n-            <para>Set the minimum amount of time in milliseconds after\n-\t\t\t\t\t\tdisconnecting a call before the agent can receive a new call.</para>\n-            <note>\n-              <para>\n-                The option is overridden by\n-                <variable>AGENTWRAPUPTIME</variable>\n-                on agent login.\n-              </para>\n-            </note>\n-            <xi:include xpointer=\"xpointer(/docs/configInfo[@name='app_agent_pool']/description/note)\"/>\n-          </description>\n-        </configOption>\n-        <configOption name=\"musiconhold\">\n-          <synopsis>Music on hold class the agent listens to between calls.</synopsis>\n-          <description>\n-            <xi:include xpointer=\"xpointer(/docs/configInfo[@name='app_agent_pool']/description/note)\"/>\n-          </description>\n-        </configOption>\n-        <configOption name=\"recordagentcalls\">\n-          <synopsis>Enable to automatically record calls the agent takes.</synopsis>\n-          <description>\n+    <see-also>\n+      <ref type=\"function\">VM_INFO</ref>\n+    </see-also>\n+  </function>\n+  <function name=\"VM_INFO\" language=\"en_US\">\n+    <synopsis>Returns the selected attribute from a mailbox.</synopsis>\n+    <syntax argsep=\",\">\n+      <parameter name=\"mailbox\" argsep=\"@\" required=\"true\">\n+        <argument name=\"mailbox\" required=\"true\"/>\n+        <argument name=\"context\"/>\n+      </parameter>\n+      <parameter name=\"attribute\" required=\"true\">\n+        <optionlist>\n+          <option name=\"count\">\n             <para>\n-              Enable recording calls the agent takes automatically by\n-\t\t\t\t\t\tinvoking the automixmon DTMF feature when the agent connects\n-\t\t\t\t\t\tto a caller.  See\n-              <filename>features.conf.sample</filename>\n-              for information about\n-\t\t\t\t\t\tthe automixmon feature.\n+              Count of messages in specified\n+              <replaceable>folder</replaceable>\n+              .\n+\t\t\t\t\t\tIf\n+              <replaceable>folder</replaceable>\n+              is not specified, defaults to\n+              <literal>INBOX</literal>\n+              .\n             </para>\n-            <xi:include xpointer=\"xpointer(/docs/configInfo[@name='app_agent_pool']/description/note)\"/>\n-          </description>\n-        </configOption>\n-        <configOption name=\"custom_beep\">\n-          <synopsis>Sound file played to alert the agent when a call is present.</synopsis>\n-          <description>\n-            <xi:include xpointer=\"xpointer(/docs/configInfo[@name='app_agent_pool']/description/note)\"/>\n-          </description>\n-        </configOption>\n-        <configOption name=\"fullname\">\n-          <synopsis>A friendly name for the agent used in log messages.</synopsis>\n-          <description>\n-            <xi:include xpointer=\"xpointer(/docs/configInfo[@name='app_agent_pool']/description/note)\"/>\n-          </description>\n-        </configOption>\n-      </configObject>\n-    </configFile>\n-  </configInfo>\n-  <module language=\"en_US\" name=\"app_jack\">\n-    <depend>jack</depend>\n-    <depend>resample</depend>\n-    <support_level>extended</support_level>\n-  </module>\n-  <application name=\"JACK\" language=\"en_US\">\n-    <synopsis>Jack Audio Connection Kit</synopsis>\n-    <syntax>\n-      <parameter name=\"options\" required=\"false\">\n-        <optionlist>\n-          <option name=\"s\">\n-            <argument name=\"name\" required=\"true\">\n-              <para>Connect to the specified jack server name</para>\n-            </argument>\n           </option>\n-          <option name=\"i\">\n-            <argument name=\"name\" required=\"true\">\n-              <para>Connect the output port that gets created to the specified jack input port</para>\n-            </argument>\n+          <option name=\"email\">\n+            <para>E-mail address associated with the mailbox.</para>\n           </option>\n-          <option name=\"o\">\n-            <argument name=\"name\" required=\"true\">\n-              <para>Connect the input port that gets created to the specified jack output port</para>\n-            </argument>\n+          <option name=\"exists\">\n+            <para>\n+              Returns a boolean of whether the corresponding\n+              <replaceable>mailbox</replaceable>\n+              exists.\n+            </para>\n           </option>\n-          <option name=\"c\">\n-            <argument name=\"name\" required=\"true\">\n-              <para>By default, Asterisk will use the channel name for the jack client name.</para>\n-              <para>Use this option to specify a custom client name.</para>\n-            </argument>\n+          <option name=\"fullname\">\n+            <para>Full name associated with the mailbox.</para>\n+          </option>\n+          <option name=\"language\">\n+            <para>Mailbox language if overridden, otherwise the language of the channel.</para>\n+          </option>\n+          <option name=\"locale\">\n+            <para>Mailbox locale if overridden, otherwise global locale.</para>\n+          </option>\n+          <option name=\"pager\">\n+            <para>Pager e-mail address associated with the mailbox.</para>\n+          </option>\n+          <option name=\"password\">\n+            <para>Mailbox access password.</para>\n+          </option>\n+          <option name=\"tz\">\n+            <para>Mailbox timezone if overridden, otherwise global timezone</para>\n           </option>\n         </optionlist>\n       </parameter>\n+      <parameter name=\"folder\" required=\"false\">\n+        <para>\n+          If not specified,\n+          <literal>INBOX</literal>\n+          is assumed.\n+        </para>\n+      </parameter>\n     </syntax>\n     <description>\n-      <para>When executing this application, two jack ports will be created;\n-\t\t\tone input and one output. Other applications can be hooked up to\n-\t\t\tthese ports to access audio coming from, or being send to the channel.</para>\n+      <para>\n+        Returns the selected attribute from the specified\n+        <replaceable>mailbox</replaceable>\n+        .\n+\t\t\tIf\n+        <replaceable>context</replaceable>\n+        is not specified, defaults to the\n+        <literal>default</literal>\n+        context. Where the\n+        <replaceable>folder</replaceable>\n+        can be specified, common folders\n+\t\t\tinclude\n+        <literal>INBOX</literal>\n+        ,\n+        <literal>Old</literal>\n+        ,\n+        <literal>Work</literal>\n+        ,\n+        <literal>Family</literal>\n+        and\n+        <literal>Friends</literal>\n+        .\n+      </para>\n     </description>\n-  </application>\n-  <module language=\"en_US\" name=\"app_fax\">\n-    <depend>spandsp</depend>\n-    <conflict>res_fax</conflict>\n-    <defaultenabled>no</defaultenabled>\n-    <support_level>deprecated</support_level>\n-    <replacement>res_fax</replacement>\n-    <deprecated_in>16</deprecated_in>\n-    <removed_in>19</removed_in>\n-  </module>\n-  <application name=\"SendFAX\" language=\"en_US\" module=\"app_fax\">\n-    <synopsis>Send a Fax</synopsis>\n+  </function>\n+  <manager name=\"VoicemailUsersList\" language=\"en_US\">\n+    <synopsis>List All Voicemail User Information.</synopsis>\n     <syntax>\n-      <parameter name=\"filename\" required=\"true\">\n-        <para>Filename of TIFF file to fax</para>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+    </syntax>\n+    <description/>\n+  </manager>\n+  <manager name=\"VoicemailUserStatus\" language=\"en_US\">\n+    <synopsis>Show the status of given voicemail user's info.</synopsis>\n+    <syntax>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      <parameter name=\"Context\" required=\"true\">\n+        <para>The context you want to check.</para>\n       </parameter>\n-      <parameter name=\"a\" required=\"false\">\n-        <para>Makes the application behave as the answering machine</para>\n-        <para>(Default behavior is as calling machine)</para>\n+      <parameter name=\"Mailbox\" required=\"true\">\n+        <para>The mailbox you want to check.</para>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>Send a given TIFF file to the channel as a FAX.</para>\n-      <para>This application sets the following channel variables:</para>\n-      <variablelist>\n-        <variable name=\"LOCALSTATIONID\">\n-          <para>To identify itself to the remote end</para>\n-        </variable>\n-        <variable name=\"LOCALHEADERINFO\">\n-          <para>To generate a header line on each page</para>\n-        </variable>\n-        <variable name=\"FAXSTATUS\">\n-          <value name=\"SUCCESS\"/>\n-          <value name=\"FAILED\"/>\n-        </variable>\n-        <variable name=\"FAXERROR\">\n-          <para>Cause of failure</para>\n-        </variable>\n-        <variable name=\"REMOTESTATIONID\">\n-          <para>The CSID of the remote side</para>\n-        </variable>\n-        <variable name=\"FAXPAGES\">\n-          <para>Number of pages sent</para>\n-        </variable>\n-        <variable name=\"FAXBITRATE\">\n-          <para>Transmission rate</para>\n-        </variable>\n-        <variable name=\"FAXRESOLUTION\">\n-          <para>Resolution of sent fax</para>\n-        </variable>\n-      </variablelist>\n+      <para>Retrieves the status of the given voicemail user.</para>\n     </description>\n-  </application>\n-  <application name=\"ReceiveFAX\" language=\"en_US\" module=\"app_fax\">\n-    <synopsis>Receive a Fax</synopsis>\n+  </manager>\n+  <manager name=\"VoicemailRefresh\" language=\"en_US\">\n+    <synopsis>Tell Asterisk to poll mailboxes for a change</synopsis>\n     <syntax>\n-      <parameter name=\"filename\" required=\"true\">\n-        <para>Filename of TIFF file save incoming fax</para>\n-      </parameter>\n-      <parameter name=\"c\" required=\"false\">\n-        <para>Makes the application behave as the calling machine</para>\n-        <para>(Default behavior is as answering machine)</para>\n-      </parameter>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      <parameter name=\"Context\"/>\n+      <parameter name=\"Mailbox\"/>\n     </syntax>\n     <description>\n-      <para>Receives a FAX from the channel into the given filename\n-\t\t\toverwriting the file if it already exists.</para>\n-      <para>File created will be in TIFF format.</para>\n-      <para>This application sets the following channel variables:</para>\n-      <variablelist>\n-        <variable name=\"LOCALSTATIONID\">\n-          <para>To identify itself to the remote end</para>\n-        </variable>\n-        <variable name=\"LOCALHEADERINFO\">\n-          <para>To generate a header line on each page</para>\n-        </variable>\n-        <variable name=\"FAXSTATUS\">\n-          <value name=\"SUCCESS\"/>\n-          <value name=\"FAILED\"/>\n-        </variable>\n-        <variable name=\"FAXERROR\">\n-          <para>Cause of failure</para>\n-        </variable>\n-        <variable name=\"REMOTESTATIONID\">\n-          <para>The CSID of the remote side</para>\n-        </variable>\n-        <variable name=\"FAXPAGES\">\n-          <para>Number of pages sent</para>\n-        </variable>\n-        <variable name=\"FAXBITRATE\">\n-          <para>Transmission rate</para>\n-        </variable>\n-        <variable name=\"FAXRESOLUTION\">\n-          <para>Resolution of sent fax</para>\n-        </variable>\n-      </variablelist>\n+      <para>\n+        Normally, MWI indicators are only sent when Asterisk itself\n+\t\t\tchanges a mailbox.  With external programs that modify the content\n+\t\t\tof a mailbox from outside the application, an option exists called\n+        <literal>pollmailboxes</literal>\n+        that will cause voicemail to\n+\t\t\tcontinually scan all mailboxes on a system for changes.  This can\n+\t\t\tcause a large amount of load on a system.  This command allows\n+\t\t\texternal applications to signal when a particular mailbox has\n+\t\t\tchanged, thus permitting external applications to modify mailboxes\n+\t\t\tand MWI to work without introducing considerable CPU load.\n+      </para>\n+      <para>\n+        If\n+        <replaceable>Context</replaceable>\n+        is not specified, all\n+\t\t\tmailboxes on the system will be polled for changes.  If\n+        <replaceable>Context</replaceable>\n+        is specified, but\n+        <replaceable>Mailbox</replaceable>\n+        is omitted, then all mailboxes\n+\t\t\twithin\n+        <replaceable>Context</replaceable>\n+        will be polled.\n+\t\t\tOtherwise, only a single mailbox will be polled for changes.\n+      </para>\n     </description>\n-  </application>\n-  <module language=\"en_US\" name=\"app_zapateller\">\n-    <support_level>extended</support_level>\n+  </manager>\n+  <module language=\"en_US\" name=\"app_flash\">\n+    <depend>dahdi</depend>\n+    <support_level>core</support_level>\n   </module>\n-  <application name=\"Zapateller\" language=\"en_US\">\n-    <synopsis>Block telemarketers with SIT.</synopsis>\n-    <syntax>\n-      <parameter name=\"options\" required=\"true\">\n-        <para>Comma delimited list of options.</para>\n-        <optionlist>\n-          <option name=\"answer\">\n-            <para>Causes the line to be answered before playing the tone.</para>\n-          </option>\n-          <option name=\"nocallerid\">\n-            <para>Causes Zapateller to only play the tone if there is no\n-\t\t\t\t\t\tcallerid information available.</para>\n-          </option>\n-        </optionlist>\n-      </parameter>\n-    </syntax>\n+  <application name=\"Flash\" language=\"en_US\">\n+    <synopsis>Flashes a DAHDI Trunk.</synopsis>\n+    <syntax/>\n     <description>\n-      <para>Generates special information tone to block telemarketers from calling you.</para>\n-      <para>This application will set the following channel variable upon completion:</para>\n-      <variablelist>\n-        <variable name=\"ZAPATELLERSTATUS\">\n-          <para>This will contain the last action accomplished by the\n-\t\t\t\t\tZapateller application. Possible values include:</para>\n-          <value name=\"NOTHING\"/>\n-          <value name=\"ANSWERED\"/>\n-          <value name=\"ZAPPED\"/>\n-        </variable>\n-      </variablelist>\n+      <para>Performs a flash on a DAHDI trunk. This can be used to access features\n+\t\t\tprovided on an incoming analogue circuit such as conference and call waiting.\n+\t\t\tUse with SendDTMF() to perform external transfers.</para>\n     </description>\n+    <see-also>\n+      <ref type=\"application\">SendDTMF</ref>\n+    </see-also>\n   </application>\n-  <module language=\"en_US\" name=\"app_url\">\n-    <support_level>deprecated</support_level>\n-    <deprecated_in>16</deprecated_in>\n-    <removed_in>19</removed_in>\n+  <module language=\"en_US\" name=\"app_read\">\n+    <support_level>core</support_level>\n   </module>\n-  <application name=\"SendURL\" language=\"en_US\">\n-    <synopsis>Send a URL.</synopsis>\n+  <application name=\"Read\" language=\"en_US\">\n+    <synopsis>Read a variable.</synopsis>\n     <syntax>\n-      <parameter name=\"URL\" required=\"true\"/>\n-      <parameter name=\"option\">\n+      <parameter name=\"variable\" required=\"true\">\n+        <para>\n+          The input digits will be stored in the given\n+          <replaceable>variable</replaceable>\n+          name.\n+        </para>\n+      </parameter>\n+      <parameter name=\"filenames\" argsep=\"&amp;\">\n+        <argument name=\"filename\" required=\"true\">\n+          <para>file(s) to play before reading digits or tone with option i</para>\n+        </argument>\n+        <argument name=\"filename2\" multiple=\"true\"/>\n+      </parameter>\n+      <parameter name=\"maxdigits\">\n+        <para>\n+          Maximum acceptable number of digits. Stops reading after\n+          <replaceable>maxdigits</replaceable>\n+          have been entered (without\n+\t\t\t\trequiring the user to press the\n+          <literal>#</literal>\n+          key).\n+        </para>\n+        <para>\n+          Defaults to\n+          <literal>0</literal>\n+          - no limit - wait for the\n+\t\t\t\tuser press the\n+          <literal>#</literal>\n+          key. Any value below\n+          <literal>0</literal>\n+          means the same. Max accepted value is\n+          <literal>255</literal>\n+          .\n+        </para>\n+      </parameter>\n+      <parameter name=\"options\">\n         <optionlist>\n-          <option name=\"w\">\n-            <para>Execution will wait for an acknowledgement that the\n-\t\t\t\t\t\tURL has been loaded before continuing.</para>\n+          <option name=\"s\">\n+            <para>to return immediately if the line is not up.</para>\n+          </option>\n+          <option name=\"i\">\n+            <para>\n+              to play  filename as an indication tone from your\n+              <filename>indications.conf</filename>\n+              .\n+            </para>\n+          </option>\n+          <option name=\"n\">\n+            <para>to read digits even if the line is not up.</para>\n+          </option>\n+          <option name=\"t\">\n+            <para>\n+              Terminator digit(s) to use for ending input.\n+\t\t\t\t\t\tDefault is\n+              <literal>#</literal>\n+              . If you need to read\n+\t\t\t\t\t\tthe digit\n+              <literal>#</literal>\n+              literally, you should\n+\t\t\t\t\t\tremove or change the terminator character. Multiple\n+\t\t\t\t\t\tterminator characters may be specified. If no terminator\n+\t\t\t\t\t\tdigit is present, input cannot be ended using digits\n+\t\t\t\t\t\tand you will need to rely on duration and max digits\n+\t\t\t\t\t\tfor ending input.\n+            </para>\n           </option>\n         </optionlist>\n       </parameter>\n+      <parameter name=\"attempts\">\n+        <para>\n+          If greater than\n+          <literal>1</literal>\n+          , that many\n+          <replaceable>attempts</replaceable>\n+          will be made in the\n+\t\t\t\tevent no data is entered.\n+        </para>\n+      </parameter>\n+      <parameter name=\"timeout\">\n+        <para>\n+          The number of seconds to wait for a digit response. If greater\n+\t\t\t\tthan\n+          <literal>0</literal>\n+          , that value will override the default timeout.\n+\t\t\t\tCan be floating point.\n+        </para>\n+      </parameter>\n     </syntax>\n     <description>\n       <para>\n-        Requests client go to\n-        <replaceable>URL</replaceable>\n-        (IAX2) or sends the\n-\t\t\tURL to the client (other channels).\n-      </para>\n-      <para>\n-        Result is returned in the\n-        <variable>SENDURLSTATUS</variable>\n-        channel variable:\n+        Reads a #-terminated string of digits a certain number of times from the\n+\t\t\tuser in to the given\n+        <replaceable>variable</replaceable>\n+        .\n       </para>\n+      <para>This application sets the following channel variable upon completion:</para>\n       <variablelist>\n-        <variable name=\"SENDURLSTATUS\">\n-          <value name=\"SUCCESS\">URL successfully sent to client.</value>\n-          <value name=\"FAILURE\">Failed to send URL.</value>\n-          <value name=\"NOLOAD\">Client failed to load URL (wait enabled).</value>\n-          <value name=\"UNSUPPORTED\">Channel does not support URL transport.</value>\n+        <variable name=\"READSTATUS\">\n+          <para>This is the status of the read operation.</para>\n+          <value name=\"OK\"/>\n+          <value name=\"ERROR\"/>\n+          <value name=\"HANGUP\"/>\n+          <value name=\"INTERRUPTED\"/>\n+          <value name=\"SKIPPED\"/>\n+          <value name=\"TIMEOUT\"/>\n         </variable>\n       </variablelist>\n-      <para>SendURL continues normally if the URL was sent correctly or if the channel\n-\t\t\tdoes not support HTML transport.  Otherwise, the channel is hung up.</para>\n     </description>\n     <see-also>\n-      <ref type=\"application\">SendImage</ref>\n-      <ref type=\"application\">SendText</ref>\n+      <ref type=\"application\">SendDTMF</ref>\n     </see-also>\n   </application>\n   <module language=\"en_US\" name=\"app_amd\">\n     <support_level>extended</support_level>\n   </module>\n   <application name=\"AMD\" language=\"en_US\">\n     <synopsis>Attempt to detect answering machines.</synopsis>\n@@ -8231,1118 +10182,56 @@\n       </variablelist>\n     </description>\n     <see-also>\n       <ref type=\"application\">WaitForSilence</ref>\n       <ref type=\"application\">WaitForNoise</ref>\n     </see-also>\n   </application>\n-  <module language=\"en_US\" name=\"app_getcpeid\">\n-    <depend>res_adsi</depend>\n-    <support_level>deprecated</support_level>\n-  </module>\n-  <application name=\"GetCPEID\" language=\"en_US\">\n-    <synopsis>Get ADSI CPE ID.</synopsis>\n-    <syntax/>\n-    <description>\n-      <para>\n-        Obtains and displays ADSI CPE ID and other information in order\n-\t\t\tto properly setup\n-        <filename>dahdi.conf</filename>\n-        for on-hook operations.\n-      </para>\n-    </description>\n-  </application>\n-  <module language=\"en_US\" name=\"app_dumpchan\">\n-    <support_level>core</support_level>\n-  </module>\n-  <application name=\"DumpChan\" language=\"en_US\">\n-    <synopsis>Dump Info About The Calling Channel.</synopsis>\n-    <syntax>\n-      <parameter name=\"level\">\n-        <para>Minimum verbose level</para>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>\n-        Displays information on channel and listing of all channel\n-\t\t\tvariables. If\n-        <replaceable>level</replaceable>\n-        is specified, output is only\n-\t\t\tdisplayed when the verbose level is currently set to that number\n-\t\t\tor greater.\n-      </para>\n-    </description>\n-    <see-also>\n-      <ref type=\"application\">NoOp</ref>\n-      <ref type=\"application\">Verbose</ref>\n-    </see-also>\n-  </application>\n-  <module language=\"en_US\" name=\"app_saycounted\">\n+  <module language=\"en_US\" name=\"app_statsd\">\n+    <depend>res_statsd</depend>\n     <defaultenabled>no</defaultenabled>\n     <support_level>extended</support_level>\n   </module>\n-  <application name=\"SayCountedNoun\" language=\"en_US\">\n-    <synopsis>Say a noun in declined form in order to count things</synopsis>\n-    <syntax>\n-      <parameter name=\"number\" required=\"true\">\n-        <para>The number of things</para>\n-      </parameter>\n-      <parameter name=\"filename\" required=\"true\">\n-        <para>File name stem for the noun that is the name of the things</para>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>Selects and plays the proper singular or plural form of a noun\n-\t\t\twhen saying things such as &quot;five calls&quot;.  English has simple rules\n-\t\t\tfor deciding when to say &quot;call&quot; and when to say &quot;calls&quot;, but other\n-\t\t\tlanguages have complicated rules which would be extremely difficult\n-\t\t\tto implement in the Asterisk dialplan language.</para>\n-      <para>\n-        The correct sound file is selected by examining the\n-        <replaceable>number</replaceable>\n-        and adding the appropriate suffix\n-\t\t\tto\n-        <replaceable>filename</replaceable>\n-        . If the channel language is\n-\t\t\tEnglish, then the suffix will be either empty or &quot;s&quot;. If the channel\n-\t\t\tlanguage is Russian or some other Slavic language, then the suffix\n-\t\t\twill be empty for nominative, &quot;x1&quot; for genative singular, and &quot;x2&quot;\n-\t\t\tfor genative plural.\n-      </para>\n-      <para>\n-        Note that combining\n-        <replaceable>filename</replaceable>\n-        with\n-\t\t\ta suffix will not necessarily produce a correctly spelled plural\n-\t\t\tform. For example, SayCountedNoun(2,man) will play the sound file\n-\t\t\t&quot;mans&quot; rather than &quot;men&quot;. This behavior is intentional. Since the\n-\t\t\tfile name is never seen by the end user, there is no need to\n-\t\t\timplement complicated spelling rules.  We simply record the word\n-\t\t\t&quot;men&quot; in the sound file named &quot;mans&quot;.\n-      </para>\n-      <para>This application does not automatically answer and should be\n-\t\t\tpreceeded by an application such as Answer() or Progress.</para>\n-    </description>\n-    <see-also>\n-      <ref type=\"application\">SayCountedAdj</ref>\n-      <ref type=\"application\">SayNumber</ref>\n-    </see-also>\n-  </application>\n-  <application name=\"SayCountedAdj\" language=\"en_US\">\n-    <synopsis>Say a adjective in declined form in order to count things</synopsis>\n-    <syntax>\n-      <parameter name=\"number\" required=\"true\">\n-        <para>The number of things</para>\n-      </parameter>\n-      <parameter name=\"filename\" required=\"true\">\n-        <para>File name stem for the adjective</para>\n-      </parameter>\n-      <parameter name=\"gender\">\n-        <para>The gender of the noun modified, one of 'm', 'f', 'n', or 'c'</para>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>\n-        Selects and plays the proper form of an adjective according to\n-\t\t\tthe gender and of the noun which it modifies and the number of\n-\t\t\tobjects named by the noun-verb combination which have been counted.\n-\t\t\tUsed when saying things such as &quot;5 new messages&quot;.  The various\n-\t\t\tsingular and plural forms of the adjective are selected by adding\n-\t\t\tsuffixes to\n-        <replaceable>filename</replaceable>\n-        .\n-      </para>\n-      <para>\n-        If the channel language is English, then no suffix will ever\n-\t\t\tbe added (since, in English, adjectives are not declined). If the\n-\t\t\tchannel language is Russian or some other slavic language, then the\n-\t\t\tsuffix will the specified\n-        <replaceable>gender</replaceable>\n-        for\n-\t\t\tnominative, and &quot;x&quot; for genative plural. (The genative singular is\n-\t\t\tnot used when counting things.) For example, SayCountedAdj(1,new,f)\n-\t\t\twill play sound file &quot;newa&quot; (containing the word &quot;novaya&quot;), but\n-\t\t\tSayCountedAdj(5,new,f) will play sound file &quot;newx&quot; (containing the\n-\t\t\tword &quot;novikh&quot;).\n-      </para>\n-      <para>This application does not automatically answer and should be\n-\t\t\tpreceeded by an application such as Answer(), Progress(), or\n-\t\t\tProceeding().</para>\n-    </description>\n-    <see-also>\n-      <ref type=\"application\">SayCountedNoun</ref>\n-      <ref type=\"application\">SayNumber</ref>\n-    </see-also>\n-  </application>\n-  <module language=\"en_US\" name=\"app_osplookup\">\n-    <depend>osptk</depend>\n-    <depend>openssl</depend>\n-    <support_level>extended</support_level>\n-    <deprecated_in>19</deprecated_in>\n-    <removed_in>21</removed_in>\n-  </module>\n-  <application name=\"OSPAuth\" language=\"en_US\">\n-    <synopsis>OSP Authentication.</synopsis>\n-    <syntax>\n-      <parameter name=\"provider\">\n-        <para>The name of the provider that authenticates the call.</para>\n-      </parameter>\n-      <parameter name=\"options\">\n-        <para>Reserverd.</para>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>Authenticate a call by OSP.</para>\n-      <para>Input variables:</para>\n-      <variablelist>\n-        <variable name=\"OSPINPEERIP\">\n-          <para>The last hop IP address.</para>\n-        </variable>\n-        <variable name=\"OSPINTOKEN\">\n-          <para>The inbound OSP token.</para>\n-        </variable>\n-      </variablelist>\n-      <para>Output variables:</para>\n-      <variablelist>\n-        <variable name=\"OSPINHANDLE\">\n-          <para>The inbound call OSP transaction handle.</para>\n-        </variable>\n-        <variable name=\"OSPINTIMELIMIT\">\n-          <para>The inbound call duration limit in seconds.</para>\n-        </variable>\n-      </variablelist>\n-      <para>This application sets the following channel variable upon completion:</para>\n-      <variablelist>\n-        <variable name=\"OSPAUTHSTATUS\">\n-          <para>The status of OSPAuth attempt as a text string, one of</para>\n-          <value name=\"SUCCESS\"/>\n-          <value name=\"FAILED\"/>\n-          <value name=\"ERROR\"/>\n-        </variable>\n-      </variablelist>\n-    </description>\n-    <see-also>\n-      <ref type=\"application\">OSPLookup</ref>\n-      <ref type=\"application\">OSPNext</ref>\n-      <ref type=\"application\">OSPFinish</ref>\n-    </see-also>\n-  </application>\n-  <application name=\"OSPLookup\" language=\"en_US\">\n-    <synopsis>Lookup destination by OSP.</synopsis>\n-    <syntax>\n-      <parameter name=\"exten\" required=\"true\">\n-        <para>The exten of the call.</para>\n-      </parameter>\n-      <parameter name=\"provider\">\n-        <para>The name of the provider that is used to route the call.</para>\n-      </parameter>\n-      <parameter name=\"options\">\n-        <enumlist>\n-          <enum name=\"h\">\n-            <para>generate H323 call id for the outbound call</para>\n-          </enum>\n-          <enum name=\"s\">\n-            <para>generate SIP call id for the outbound call. Have not been implemented</para>\n-          </enum>\n-          <enum name=\"i\">\n-            <para>generate IAX call id for the outbound call. Have not been implemented</para>\n-          </enum>\n-        </enumlist>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>Looks up destination via OSP.</para>\n-      <para>Input variables:</para>\n-      <variablelist>\n-        <variable name=\"OSPINACTUALSRC\">\n-          <para>The actual source device IP address in indirect mode.</para>\n-        </variable>\n-        <variable name=\"OSPINPEERIP\">\n-          <para>The last hop IP address.</para>\n-        </variable>\n-        <variable name=\"OSPINTECH\">\n-          <para>The inbound channel technology for the call.</para>\n-        </variable>\n-        <variable name=\"OSPINHANDLE\">\n-          <para>The inbound call OSP transaction handle.</para>\n-        </variable>\n-        <variable name=\"OSPINTIMELIMIT\">\n-          <para>The inbound call duration limit in seconds.</para>\n-        </variable>\n-        <variable name=\"OSPINNETWORKID\">\n-          <para>The inbound source network ID.</para>\n-        </variable>\n-        <variable name=\"OSPINNPRN\">\n-          <para>The inbound routing number.</para>\n-        </variable>\n-        <variable name=\"OSPINNPCIC\">\n-          <para>The inbound carrier identification code.</para>\n-        </variable>\n-        <variable name=\"OSPINNPDI\">\n-          <para>The inbound number portability database dip indicator.</para>\n-        </variable>\n-        <variable name=\"OSPINSPID\">\n-          <para>The inbound service provider identity.</para>\n-        </variable>\n-        <variable name=\"OSPINOCN\">\n-          <para>The inbound operator company number.</para>\n-        </variable>\n-        <variable name=\"OSPINSPN\">\n-          <para>The inbound service provider name.</para>\n-        </variable>\n-        <variable name=\"OSPINALTSPN\">\n-          <para>The inbound alternate service provider name.</para>\n-        </variable>\n-        <variable name=\"OSPINMCC\">\n-          <para>The inbound mobile country code.</para>\n-        </variable>\n-        <variable name=\"OSPINMNC\">\n-          <para>The inbound mobile network code.</para>\n-        </variable>\n-        <variable name=\"OSPINTOHOST\">\n-          <para>The inbound To header host part.</para>\n-        </variable>\n-        <variable name=\"OSPINRPIDUSER\">\n-          <para>The inbound Remote-Party-ID header user part.</para>\n-        </variable>\n-        <variable name=\"OSPINPAIUSER\">\n-          <para>The inbound P-Asserted-Identify header user part.</para>\n-        </variable>\n-        <variable name=\"OSPINDIVUSER\">\n-          <para>The inbound Diversion header user part.</para>\n-        </variable>\n-        <variable name=\"OSPINDIVHOST\">\n-          <para>The inbound Diversion header host part.</para>\n-        </variable>\n-        <variable name=\"OSPINPCIUSER\">\n-          <para>The inbound P-Charge-Info header user part.</para>\n-        </variable>\n-        <variable name=\"OSPINCUSTOMINFOn\">\n-          <para>\n-            The inbound custom information, where\n-            <literal>n</literal>\n-            is the index beginning with\n-            <literal>1</literal>\n-            upto\n-            <literal>8</literal>\n-            .\n-          </para>\n-        </variable>\n-      </variablelist>\n-      <para>Output variables:</para>\n-      <variablelist>\n-        <variable name=\"OSPOUTHANDLE\">\n-          <para>The outbound call OSP transaction handle.</para>\n-        </variable>\n-        <variable name=\"OSPOUTTECH\">\n-          <para>The outbound channel technology for the call.</para>\n-        </variable>\n-        <variable name=\"OSPDESTINATION\">\n-          <para>The outbound destination IP address.</para>\n-        </variable>\n-        <variable name=\"OSPOUTCALLING\">\n-          <para>The outbound calling number.</para>\n-        </variable>\n-        <variable name=\"OSPOUTCALLED\">\n-          <para>The outbound called number.</para>\n-        </variable>\n-        <variable name=\"OSPOUTNETWORKID\">\n-          <para>The outbound destination network ID.</para>\n-        </variable>\n-        <variable name=\"OSPOUTNPRN\">\n-          <para>The outbound routing number.</para>\n-        </variable>\n-        <variable name=\"OSPOUTNPCIC\">\n-          <para>The outbound carrier identification code.</para>\n-        </variable>\n-        <variable name=\"OSPOUTNPDI\">\n-          <para>The outbound number portability database dip indicator.</para>\n-        </variable>\n-        <variable name=\"OSPOUTSPID\">\n-          <para>The outbound service provider identity.</para>\n-        </variable>\n-        <variable name=\"OSPOUTOCN\">\n-          <para>The outbound operator company number.</para>\n-        </variable>\n-        <variable name=\"OSPOUTSPN\">\n-          <para>The outbound service provider name.</para>\n-        </variable>\n-        <variable name=\"OSPOUTALTSPN\">\n-          <para>The outbound alternate service provider name.</para>\n-        </variable>\n-        <variable name=\"OSPOUTMCC\">\n-          <para>The outbound mobile country code.</para>\n-        </variable>\n-        <variable name=\"OSPOUTMNC\">\n-          <para>The outbound mobile network code.</para>\n-        </variable>\n-        <variable name=\"OSPOUTTOKEN\">\n-          <para>The outbound OSP token.</para>\n-        </variable>\n-        <variable name=\"OSPDESTREMAILS\">\n-          <para>The number of remained destinations.</para>\n-        </variable>\n-        <variable name=\"OSPOUTTIMELIMIT\">\n-          <para>The outbound call duration limit in seconds.</para>\n-        </variable>\n-        <variable name=\"OSPOUTCALLIDTYPES\">\n-          <para>The outbound Call-ID types.</para>\n-        </variable>\n-        <variable name=\"OSPOUTCALLID\">\n-          <para>The outbound Call-ID. Only for H.323.</para>\n-        </variable>\n-        <variable name=\"OSPDIALSTR\">\n-          <para>The outbound Dial command string.</para>\n-        </variable>\n-      </variablelist>\n-      <para>This application sets the following channel variable upon completion:</para>\n-      <variablelist>\n-        <variable name=\"OSPLOOKUPSTATUS\">\n-          <para>The status of OSPLookup attempt as a text string, one of</para>\n-          <value name=\"SUCCESS\"/>\n-          <value name=\"FAILED\"/>\n-          <value name=\"ERROR\"/>\n-        </variable>\n-      </variablelist>\n-    </description>\n-    <see-also>\n-      <ref type=\"application\">OSPAuth</ref>\n-      <ref type=\"application\">OSPNext</ref>\n-      <ref type=\"application\">OSPFinish</ref>\n-    </see-also>\n-  </application>\n-  <application name=\"OSPNext\" language=\"en_US\">\n-    <synopsis>Lookup next destination by OSP.</synopsis>\n-    <description>\n-      <para>Looks up the next destination via OSP.</para>\n-      <para>Input variables:</para>\n-      <variablelist>\n-        <variable name=\"OSPINHANDLE\">\n-          <para>The inbound call OSP transaction handle.</para>\n-        </variable>\n-        <variable name=\"OSPOUTHANDLE\">\n-          <para>The outbound call OSP transaction handle.</para>\n-        </variable>\n-        <variable name=\"OSPINTIMELIMIT\">\n-          <para>The inbound call duration limit in seconds.</para>\n-        </variable>\n-        <variable name=\"OSPOUTCALLIDTYPES\">\n-          <para>The outbound Call-ID types.</para>\n-        </variable>\n-        <variable name=\"OSPDESTREMAILS\">\n-          <para>The number of remained destinations.</para>\n-        </variable>\n-      </variablelist>\n-      <para>Output variables:</para>\n-      <variablelist>\n-        <variable name=\"OSPOUTTECH\">\n-          <para>The outbound channel technology.</para>\n-        </variable>\n-        <variable name=\"OSPDESTINATION\">\n-          <para>The destination IP address.</para>\n-        </variable>\n-        <variable name=\"OSPOUTCALLING\">\n-          <para>The outbound calling number.</para>\n-        </variable>\n-        <variable name=\"OSPOUTCALLED\">\n-          <para>The outbound called number.</para>\n-        </variable>\n-        <variable name=\"OSPOUTNETWORKID\">\n-          <para>The outbound destination network ID.</para>\n-        </variable>\n-        <variable name=\"OSPOUTNPRN\">\n-          <para>The outbound routing number.</para>\n-        </variable>\n-        <variable name=\"OSPOUTNPCIC\">\n-          <para>The outbound carrier identification code.</para>\n-        </variable>\n-        <variable name=\"OSPOUTNPDI\">\n-          <para>The outbound number portability database dip indicator.</para>\n-        </variable>\n-        <variable name=\"OSPOUTSPID\">\n-          <para>The outbound service provider identity.</para>\n-        </variable>\n-        <variable name=\"OSPOUTOCN\">\n-          <para>The outbound operator company number.</para>\n-        </variable>\n-        <variable name=\"OSPOUTSPN\">\n-          <para>The outbound service provider name.</para>\n-        </variable>\n-        <variable name=\"OSPOUTALTSPN\">\n-          <para>The outbound alternate service provider name.</para>\n-        </variable>\n-        <variable name=\"OSPOUTMCC\">\n-          <para>The outbound mobile country code.</para>\n-        </variable>\n-        <variable name=\"OSPOUTMNC\">\n-          <para>The outbound mobile network code.</para>\n-        </variable>\n-        <variable name=\"OSPOUTTOKEN\">\n-          <para>The outbound OSP token.</para>\n-        </variable>\n-        <variable name=\"OSPDESTREMAILS\">\n-          <para>The number of remained destinations.</para>\n-        </variable>\n-        <variable name=\"OSPOUTTIMELIMIT\">\n-          <para>The outbound call duration limit in seconds.</para>\n-        </variable>\n-        <variable name=\"OSPOUTCALLID\">\n-          <para>The outbound Call-ID. Only for H.323.</para>\n-        </variable>\n-        <variable name=\"OSPDIALSTR\">\n-          <para>The outbound Dial command string.</para>\n-        </variable>\n-      </variablelist>\n-      <para>This application sets the following channel variable upon completion:</para>\n-      <variablelist>\n-        <variable name=\"OSPNEXTSTATUS\">\n-          <para>The status of the OSPNext attempt as a text string, one of</para>\n-          <value name=\"SUCCESS\"/>\n-          <value name=\"FAILED\"/>\n-          <value name=\"ERROR\"/>\n-        </variable>\n-      </variablelist>\n-    </description>\n-    <see-also>\n-      <ref type=\"application\">OSPAuth</ref>\n-      <ref type=\"application\">OSPLookup</ref>\n-      <ref type=\"application\">OSPFinish</ref>\n-    </see-also>\n-  </application>\n-  <application name=\"OSPFinish\" language=\"en_US\">\n-    <synopsis>Report OSP entry.</synopsis>\n-    <syntax>\n-      <parameter name=\"cause\">\n-        <para>Hangup cause.</para>\n-      </parameter>\n-      <parameter name=\"options\">\n-        <para>Reserved.</para>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>Report call state.</para>\n-      <para>Input variables:</para>\n-      <variablelist>\n-        <variable name=\"OSPINHANDLE\">\n-          <para>The inbound call OSP transaction handle.</para>\n-        </variable>\n-        <variable name=\"OSPOUTHANDLE\">\n-          <para>The outbound call OSP transaction handle.</para>\n-        </variable>\n-        <variable name=\"OSPAUTHSTATUS\">\n-          <para>The OSPAuth status.</para>\n-        </variable>\n-        <variable name=\"OSPLOOKUPSTATUS\">\n-          <para>The OSPLookup status.</para>\n-        </variable>\n-        <variable name=\"OSPNEXTSTATUS\">\n-          <para>The OSPNext status.</para>\n-        </variable>\n-        <variable name=\"OSPINAUDIOQOS\">\n-          <para>The inbound call leg audio QoS string.</para>\n-        </variable>\n-        <variable name=\"OSPOUTAUDIOQOS\">\n-          <para>The outbound call leg audio QoS string.</para>\n-        </variable>\n-      </variablelist>\n-      <para>This application sets the following channel variable upon completion:</para>\n-      <variablelist>\n-        <variable name=\"OSPFINISHSTATUS\">\n-          <para>The status of the OSPFinish attempt as a text string, one of</para>\n-          <value name=\"SUCCESS\"/>\n-          <value name=\"FAILED\"/>\n-          <value name=\"ERROR\"/>\n-        </variable>\n-      </variablelist>\n-    </description>\n-    <see-also>\n-      <ref type=\"application\">OSPAuth</ref>\n-      <ref type=\"application\">OSPLookup</ref>\n-      <ref type=\"application\">OSPNext</ref>\n-    </see-also>\n-  </application>\n-  <module language=\"en_US\" name=\"app_controlplayback\">\n-    <support_level>core</support_level>\n-  </module>\n-  <application name=\"ControlPlayback\" language=\"en_US\">\n-    <synopsis>Play a file with fast forward and rewind.</synopsis>\n+  <application name=\"StatsD\" language=\"en_US\">\n+    <synopsis>Allow statistics to be passed to the StatsD server from the dialplan.</synopsis>\n     <syntax>\n-      <parameter name=\"filename\" required=\"true\"/>\n-      <parameter name=\"skipms\">\n-        <para>This is number of milliseconds to skip when rewinding or\n-\t\t\t\tfast-forwarding.</para>\n-      </parameter>\n-      <parameter name=\"ff\">\n-        <para>\n-          Fast-forward when this DTMF digit is received. (defaults to\n-          <literal>#</literal>\n-          )\n-        </para>\n-      </parameter>\n-      <parameter name=\"rew\">\n-        <para>\n-          Rewind when this DTMF digit is received. (defaults to\n-          <literal>*</literal>\n-          )\n-        </para>\n-      </parameter>\n-      <parameter name=\"stop\">\n-        <para>Stop playback when this DTMF digit is received.</para>\n+      <parameter name=\"metric_type\" required=\"true\">\n+        <para>The metric type to be sent to StatsD. Valid metric types\n+\t\t\t\tare 'g' for gauge, 'c' for counter, 'ms' for timer, and 's' for\n+\t\t\t\tsets.</para>\n       </parameter>\n-      <parameter name=\"pause\">\n-        <para>Pause playback when this DTMF digit is received.</para>\n+      <parameter name=\"statistic_name\" required=\"true\">\n+        <para>The name of the variable to be sent to StatsD. Statistic\n+\t\t\t\tnames cannot contain the pipe (|) character.</para>\n       </parameter>\n-      <parameter name=\"restart\">\n-        <para>Restart playback when this DTMF digit is received.</para>\n+      <parameter name=\"value\" required=\"true\">\n+        <para>The value of the variable to be sent to StatsD. Values\n+\t\t\t\tmust be numeric. Values for gauge and counter metrics can be\n+\t\t\t\tsent with a '+' or '-' to update a value after the value has\n+\t\t\t\tbeen initialized. Only counters can be initialized as negative.\n+\t\t\t\tSets can send a string as the value parameter, but the string\n+\t\t\t\tcannot contain the pipe character.</para>\n       </parameter>\n-      <parameter name=\"options\">\n-        <optionlist>\n-          <option name=\"o\">\n-            <argument name=\"time\" required=\"true\">\n-              <para>\n-                Start at\n-                <replaceable>time</replaceable>\n-                ms from the\n-\t\t\t\t\t\t\tbeginning of the file.\n-              </para>\n-            </argument>\n-          </option>\n-        </optionlist>\n+      <parameter name=\"sample_rate\">\n+        <para>The value of the sample rate to be sent to StatsD. Sample\n+\t\t\t\trates less than or equal to 0 will never be sent and sample rates\n+\t\t\t\tgreater than or equal to 1 will always be sent. Any rate\n+\t\t\t\tbetween 1 and 0 will be compared to a randomly generated value,\n+\t\t\t\tand if it is greater than the random value, it will be sent.</para>\n       </parameter>\n     </syntax>\n     <description>\n       <para>\n-        This application will play back the given\n-        <replaceable>filename</replaceable>\n+        This dialplan application sends statistics to the StatsD\n+\t\t\tserver specified inside of\n+        <literal>statsd.conf</literal>\n         .\n       </para>\n-      <para>It sets the following channel variables upon completion:</para>\n-      <variablelist>\n-        <variable name=\"CPLAYBACKSTATUS\">\n-          <para>Contains the status of the attempt as a text string</para>\n-          <value name=\"SUCCESS\"/>\n-          <value name=\"USERSTOPPED\"/>\n-          <value name=\"REMOTESTOPPED\"/>\n-          <value name=\"ERROR\"/>\n-        </variable>\n-        <variable name=\"CPLAYBACKOFFSET\">\n-          <para>\n-            Contains the offset in ms into the file where playback\n-\t\t\t\t\twas at when it stopped.\n-            <literal>-1</literal>\n-            is end of file.\n-          </para>\n-        </variable>\n-        <variable name=\"CPLAYBACKSTOPKEY\">\n-          <para>If the playback is stopped by the user this variable contains\n-\t\t\t\t\tthe key that was pressed.</para>\n-        </variable>\n-      </variablelist>\n-    </description>\n-  </application>\n-  <manager name=\"ControlPlayback\" language=\"en_US\">\n-    <synopsis>Control the playback of a file being played to a channel.</synopsis>\n-    <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"Channel\" required=\"true\">\n-        <para>The name of the channel that currently has a file being played back to it.</para>\n-      </parameter>\n-      <parameter name=\"Control\" required=\"true\">\n-        <enumlist>\n-          <enum name=\"stop\">\n-            <para>Stop the playback operation.</para>\n-          </enum>\n-          <enum name=\"forward\">\n-            <para>\n-              Move the current position in the media forward. The amount\n-\t\t\t\t\t\tof time that the stream moves forward is determined by the\n-              <replaceable>skipms</replaceable>\n-              value passed to the application\n-\t\t\t\t\t\tthat initiated the playback.\n-            </para>\n-            <note>\n-              <para>\n-                The default skipms value is\n-                <literal>3000</literal>\n-                ms.\n-              </para>\n-            </note>\n-          </enum>\n-          <enum name=\"reverse\">\n-            <para>\n-              Move the current position in the media backward. The amount\n-\t\t\t\t\t\tof time that the stream moves backward is determined by the\n-              <replaceable>skipms</replaceable>\n-              value passed to the application\n-\t\t\t\t\t\tthat initiated the playback.\n-            </para>\n-            <note>\n-              <para>\n-                The default skipms value is\n-                <literal>3000</literal>\n-                ms.\n-              </para>\n-            </note>\n-          </enum>\n-          <enum name=\"pause\">\n-            <para>Pause/unpause the playback operation, if supported.\n-\t\t\t\t\t\tIf not supported, stop the playback.</para>\n-          </enum>\n-          <enum name=\"restart\">\n-            <para>Restart the playback operation, if supported.\n-\t\t\t\t\t\tIf not supported, stop the playback.</para>\n-          </enum>\n-        </enumlist>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>Control the operation of a media file being played back to a channel.\n-\t\t\tNote that this AMI action does not initiate playback of media to channel, but\n-\t\t\trather controls the operation of a media operation that was already initiated\n-\t\t\ton the channel.</para>\n-      <note>\n-        <para>\n-          The\n-          <literal>pause</literal>\n-          and\n-          <literal>restart</literal>\n-          <replaceable>Control</replaceable>\n-          options will stop a playback\n-\t\t\t\toperation if that operation was not initiated from the\n-          <replaceable>ControlPlayback</replaceable>\n-          application or the\n-          <replaceable>control stream file</replaceable>\n-          AGI command.\n-        </para>\n-      </note>\n-    </description>\n-    <see-also>\n-      <ref type=\"application\">Playback</ref>\n-      <ref type=\"application\">ControlPlayback</ref>\n-      <ref type=\"agi\">stream file</ref>\n-      <ref type=\"agi\">control stream file</ref>\n-    </see-also>\n-  </manager>\n-  <module language=\"en_US\" name=\"app_confbridge\">\n-    <support_level>core</support_level>\n-  </module>\n-  <application name=\"ConfBridge\" language=\"en_US\">\n-    <synopsis>Conference bridge application.</synopsis>\n-    <syntax>\n-      <parameter name=\"conference\" required=\"true\">\n-        <para>Name of the conference bridge.  You are not limited to just\n-\t\t\t\tnumbers.</para>\n-      </parameter>\n-      <parameter name=\"bridge_profile\">\n-        <para>The bridge profile name from confbridge.conf.  When left blank,\n-\t\t\t\ta dynamically built bridge profile created by the CONFBRIDGE dialplan\n-\t\t\t\tfunction is searched for on the channel and used.  If no dynamic\n-\t\t\t\tprofile is present, the 'default_bridge' profile found in\n-\t\t\t\tconfbridge.conf is used.</para>\n-        <para>It is important to note that while user profiles may be unique\n-\t\t\t\tfor each participant, mixing bridge profiles on a single conference\n-\t\t\t\tis _NOT_ recommended and will produce undefined results.</para>\n-      </parameter>\n-      <parameter name=\"user_profile\">\n-        <para>The user profile name from confbridge.conf.  When left blank,\n-\t\t\t\ta dynamically built user profile created by the CONFBRIDGE dialplan\n-\t\t\t\tfunction is searched for on the channel and used.  If no dynamic\n-\t\t\t\tprofile is present, the 'default_user' profile found in\n-\t\t\t\tconfbridge.conf is used.</para>\n-      </parameter>\n-      <parameter name=\"menu\">\n-        <para>The name of the DTMF menu in confbridge.conf to be applied to\n-\t\t\t\tthis channel.  When left blank, a dynamically built menu profile\n-\t\t\t\tcreated by the CONFBRIDGE dialplan function is searched for on\n-\t\t\t\tthe channel and used. If no dynamic profile is present, the\n-\t\t\t\t'default_menu' profile found in confbridge.conf is used.</para>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>Enters the user into a specified conference bridge.  The user can\n-\t\t\texit the conference by hangup or DTMF menu option.</para>\n-      <para>This application sets the following channel variable upon completion:</para>\n-      <variablelist>\n-        <variable name=\"CONFBRIDGE_RESULT\">\n-          <value name=\"FAILED\">The channel encountered an error and could not enter the conference.</value>\n-          <value name=\"HANGUP\">The channel exited the conference by hanging up.</value>\n-          <value name=\"KICKED\">The channel was kicked from the conference.</value>\n-          <value name=\"ENDMARKED\">The channel left the conference as a result of the last marked user leaving.</value>\n-          <value name=\"DTMF\">The channel pressed a DTMF sequence to exit the conference.</value>\n-          <value name=\"TIMEOUT\">The channel reached its configured timeout.</value>\n-        </variable>\n-      </variablelist>\n-    </description>\n-    <see-also>\n-      <ref type=\"application\">ConfKick</ref>\n-      <ref type=\"function\">CONFBRIDGE</ref>\n-      <ref type=\"function\">CONFBRIDGE_INFO</ref>\n-      <ref type=\"function\">CONFBRIDGE_CHANNELS</ref>\n-    </see-also>\n-  </application>\n-  <application name=\"ConfKick\" language=\"en_US\">\n-    <since>\n-      <version>16.19.0</version>\n-      <version>18.5.0</version>\n-      <version>19.0.0</version>\n-    </since>\n-    <synopsis>Kicks channel(s) from the requested ConfBridge.</synopsis>\n-    <syntax>\n-      <parameter name=\"conference\" required=\"true\"/>\n-      <parameter name=\"channel\">\n-        <para>\n-          The channel to kick,\n-          <literal>all</literal>\n-          to kick all users, or\n-          <literal>participants</literal>\n-          to kick all non-admin participants. Default is all.\n-        </para>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>Kicks the requested channel(s) from a conference bridge.</para>\n-      <variablelist>\n-        <variable name=\"CONFKICKSTATUS\">\n-          <value name=\"FAILURE\">Could not kick any users with the provided arguments.</value>\n-          <value name=\"SUCCESS\">Successfully kicked users from specified conference bridge.</value>\n-        </variable>\n-      </variablelist>\n     </description>\n-    <see-also>\n-      <ref type=\"application\">ConfBridge</ref>\n-      <ref type=\"function\">CONFBRIDGE</ref>\n-      <ref type=\"function\">CONFBRIDGE_INFO</ref>\n-      <ref type=\"function\">CONFBRIDGE_CHANNELS</ref>\n-    </see-also>\n   </application>\n-  <function name=\"CONFBRIDGE\" language=\"en_US\">\n-    <synopsis>Set a custom dynamic bridge, user, or menu profile on a channel for the\n-\t\t\tConfBridge application using the same options available in confbridge.conf.</synopsis>\n-    <syntax>\n-      <parameter name=\"type\" required=\"true\">\n-        <para>To what type of conference profile the option applies.</para>\n-        <enumlist>\n-          <enum name=\"bridge\"/>\n-          <enum name=\"menu\"/>\n-          <enum name=\"user\"/>\n-        </enumlist>\n-      </parameter>\n-      <parameter name=\"option\" required=\"true\">\n-        <para>\n-          Option refers to a\n-          <filename>confbridge.conf</filename>\n-          option\n-\t\t\t\tthat is being set dynamically on this channel, or\n-          <literal>clear</literal>\n-          to remove already applied profile options from the channel.\n-        </para>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>\n-        A custom profile uses the default profile type settings defined in\n-        <filename>confbridge.conf</filename>\n-        as defaults if the profile template\n-\t\t\tis not explicitly specified first.\n-      </para>\n-      <para>\n-        For\n-        <literal>bridge</literal>\n-        profiles the default template is\n-        <literal>default_bridge</literal>\n-        .\n-      </para>\n-      <para>\n-        For\n-        <literal>menu</literal>\n-        profiles the default template is\n-        <literal>default_menu</literal>\n-        .\n-      </para>\n-      <para>\n-        For\n-        <literal>user</literal>\n-        profiles the default template is\n-        <literal>default_user</literal>\n-        .\n-      </para>\n-      <para>---- Example 1 ----</para>\n-      <para>In this example the custom user profile set on the channel will\n-\t\t\tautomatically be used by the ConfBridge application.</para>\n-      <example title=\"Example 1\">exten =&gt; 1,1,Answer()</example>\n-      <para>; In this example the effect of the following line is</para>\n-      <para>; implied:</para>\n-      <example title=\"Example 1b\">same =&gt; n,Set(CONFBRIDGE(user,template)=default_user)\n-\t\t\tsame =&gt; n,Set(CONFBRIDGE(user,announce_join_leave)=yes)\n-\t\t\tsame =&gt; n,Set(CONFBRIDGE(user,startmuted)=yes)\n-\t\t\tsame =&gt; n,ConfBridge(1)</example>\n-      <para>---- Example 2 ----</para>\n-      <para>\n-        This example shows how to use a predefined user profile in\n-        <filename>confbridge.conf</filename>\n-        as a template for a dynamic profile.\n-\t\t\tHere we make an admin/marked user out of the\n-        <literal>my_user</literal>\n-        profile that you define in\n-        <filename>confbridge.conf</filename>\n-        .\n-      </para>\n-      <example title=\"Example 2\">exten =&gt; 1,1,Answer()\n-\t\t\tsame =&gt; n,Set(CONFBRIDGE(user,template)=my_user)\n-\t\t\tsame =&gt; n,Set(CONFBRIDGE(user,admin)=yes)\n-\t\t\tsame =&gt; n,Set(CONFBRIDGE(user,marked)=yes)\n-\t\t\tsame =&gt; n,ConfBridge(1)</example>\n-    </description>\n-  </function>\n-  <function name=\"CONFBRIDGE_INFO\" language=\"en_US\">\n-    <synopsis>Get information about a ConfBridge conference.</synopsis>\n-    <syntax>\n-      <parameter name=\"type\" required=\"true\">\n-        <para>What conference information is requested.</para>\n-        <enumlist>\n-          <enum name=\"admins\">\n-            <para>Get the number of admin users in the conference.</para>\n-          </enum>\n-          <enum name=\"locked\">\n-            <para>Determine if the conference is locked. (0 or 1)</para>\n-          </enum>\n-          <enum name=\"marked\">\n-            <para>Get the number of marked users in the conference.</para>\n-          </enum>\n-          <enum name=\"muted\">\n-            <para>Determine if the conference is muted. (0 or 1)</para>\n-          </enum>\n-          <enum name=\"parties\">\n-            <para>Get the number of users in the conference.</para>\n-          </enum>\n-        </enumlist>\n-      </parameter>\n-      <parameter name=\"conf\" required=\"true\">\n-        <para>The name of the conference being referenced.</para>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>This function returns a non-negative integer for valid conference\n-\t\t\tnames and an empty string for invalid conference names.</para>\n-    </description>\n-    <see-also>\n-      <ref type=\"function\">CONFBRIDGE_CHANNELS</ref>\n-    </see-also>\n-  </function>\n-  <function name=\"CONFBRIDGE_CHANNELS\" language=\"en_US\">\n-    <since>\n-      <version>16.26.0</version>\n-      <version>18.12.0</version>\n-      <version>19.4.0</version>\n-    </since>\n-    <synopsis>Get a list of channels in a ConfBridge conference.</synopsis>\n-    <syntax>\n-      <parameter name=\"type\" required=\"true\">\n-        <para>What conference information is requested.</para>\n-        <enumlist>\n-          <enum name=\"admins\">\n-            <para>Get the number of admin users in the conference.</para>\n-          </enum>\n-          <enum name=\"marked\">\n-            <para>Get the number of marked users in the conference.</para>\n-          </enum>\n-          <enum name=\"parties\">\n-            <para>Get the number of total users in the conference.</para>\n-          </enum>\n-          <enum name=\"active\">\n-            <para>Get the number of active users in the conference.</para>\n-          </enum>\n-          <enum name=\"waiting\">\n-            <para>Get the number of waiting users in the conference.</para>\n-          </enum>\n-        </enumlist>\n-      </parameter>\n-      <parameter name=\"conf\" required=\"true\">\n-        <para>The name of the conference being referenced.</para>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>This function returns a comma-separated list of channels in a ConfBridge conference, optionally filtered by a type of participant.</para>\n-    </description>\n-    <see-also>\n-      <ref type=\"function\">CONFBRIDGE_INFO</ref>\n-    </see-also>\n-  </function>\n-  <manager name=\"ConfbridgeList\" language=\"en_US\">\n-    <synopsis>List participants in a conference.</synopsis>\n-    <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"Conference\" required=\"true\">\n-        <para>Conference number.</para>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>Lists all users in a particular ConfBridge conference.\n-\t\t\tConfbridgeList will follow as separate events, followed by a final event called\n-\t\t\tConfbridgeListComplete.</para>\n-    </description>\n-  </manager>\n-  <managerEvent language=\"en_US\" name=\"ConfbridgeList\">\n-    <managerEventInstance class=\"EVENT_FLAG_REPORTING\">\n-      <synopsis>Raised as part of the ConfbridgeList action response list.</synopsis>\n-      <syntax>\n-        <parameter name=\"Conference\">\n-          <para>The name of the Confbridge conference.</para>\n-        </parameter>\n-        <parameter name=\"Admin\">\n-          <para>Identifies this user as an admin user.</para>\n-          <enumlist>\n-            <enum name=\"Yes\"/>\n-            <enum name=\"No\"/>\n-          </enumlist>\n-        </parameter>\n-        <parameter name=\"MarkedUser\">\n-          <para>Identifies this user as a marked user.</para>\n-          <enumlist>\n-            <enum name=\"Yes\"/>\n-            <enum name=\"No\"/>\n-          </enumlist>\n-        </parameter>\n-        <parameter name=\"WaitMarked\">\n-          <para>Must this user wait for a marked user to join?</para>\n-          <enumlist>\n-            <enum name=\"Yes\"/>\n-            <enum name=\"No\"/>\n-          </enumlist>\n-        </parameter>\n-        <parameter name=\"EndMarked\">\n-          <para>Does this user get kicked after the last marked user leaves?</para>\n-          <enumlist>\n-            <enum name=\"Yes\"/>\n-            <enum name=\"No\"/>\n-          </enumlist>\n-        </parameter>\n-        <parameter name=\"Waiting\">\n-          <para>Is this user waiting for a marked user to join?</para>\n-          <enumlist>\n-            <enum name=\"Yes\"/>\n-            <enum name=\"No\"/>\n-          </enumlist>\n-        </parameter>\n-        <parameter name=\"Muted\">\n-          <para>The current mute status.</para>\n-          <enumlist>\n-            <enum name=\"Yes\"/>\n-            <enum name=\"No\"/>\n-          </enumlist>\n-        </parameter>\n-        <parameter name=\"Talking\">\n-          <para>Is this user talking?</para>\n-          <enumlist>\n-            <enum name=\"Yes\"/>\n-            <enum name=\"No\"/>\n-          </enumlist>\n-        </parameter>\n-        <parameter name=\"AnsweredTime\">\n-          <para>The number of seconds the channel has been up.</para>\n-        </parameter>\n-        <channel_snapshot/>\n-      </syntax>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <manager name=\"ConfbridgeListRooms\" language=\"en_US\">\n-    <synopsis>List active conferences.</synopsis>\n-    <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-    </syntax>\n-    <description>\n-      <para>Lists data about all active conferences.\n-\t\t\t\tConfbridgeListRooms will follow as separate events, followed by a final event called\n-\t\t\t\tConfbridgeListRoomsComplete.</para>\n-    </description>\n-  </manager>\n-  <manager name=\"ConfbridgeMute\" language=\"en_US\">\n-    <synopsis>Mute a Confbridge user.</synopsis>\n-    <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"Conference\" required=\"true\"/>\n-      <parameter name=\"Channel\" required=\"true\">\n-        <para>If this parameter is not a complete channel name, the first channel with this prefix will be used.</para>\n-        <para>If this parameter is &quot;all&quot;, all channels will be muted.</para>\n-        <para>If this parameter is &quot;participants&quot;, all non-admin channels will be muted.</para>\n-      </parameter>\n-    </syntax>\n-    <description/>\n-  </manager>\n-  <manager name=\"ConfbridgeUnmute\" language=\"en_US\">\n-    <synopsis>Unmute a Confbridge user.</synopsis>\n-    <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"Conference\" required=\"true\"/>\n-      <parameter name=\"Channel\" required=\"true\">\n-        <para>If this parameter is not a complete channel name, the first channel with this prefix will be used.</para>\n-        <para>If this parameter is &quot;all&quot;, all channels will be unmuted.</para>\n-        <para>If this parameter is &quot;participants&quot;, all non-admin channels will be unmuted.</para>\n-      </parameter>\n-    </syntax>\n-    <description/>\n-  </manager>\n-  <manager name=\"ConfbridgeKick\" language=\"en_US\">\n-    <synopsis>Kick a Confbridge user.</synopsis>\n-    <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"Conference\" required=\"true\"/>\n-      <parameter name=\"Channel\" required=\"true\">\n-        <para>If this parameter is &quot;all&quot;, all channels will be kicked from the conference.</para>\n-        <para>If this parameter is &quot;participants&quot;, all non-admin channels will be kicked from the conference.</para>\n-      </parameter>\n-    </syntax>\n-    <description/>\n-  </manager>\n-  <manager name=\"ConfbridgeLock\" language=\"en_US\">\n-    <synopsis>Lock a Confbridge conference.</synopsis>\n-    <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"Conference\" required=\"true\"/>\n-    </syntax>\n-    <description/>\n-  </manager>\n-  <manager name=\"ConfbridgeUnlock\" language=\"en_US\">\n-    <synopsis>Unlock a Confbridge conference.</synopsis>\n-    <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"Conference\" required=\"true\"/>\n-    </syntax>\n-    <description/>\n-  </manager>\n-  <manager name=\"ConfbridgeStartRecord\" language=\"en_US\">\n-    <synopsis>Start recording a Confbridge conference.</synopsis>\n-    <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"Conference\" required=\"true\"/>\n-      <parameter name=\"RecordFile\" required=\"false\"/>\n-    </syntax>\n-    <description>\n-      <para>Start recording a conference. If recording is already present an error will be returned. If RecordFile is not provided, the default record file specified in the conference's bridge profile will be used, if that is not present either a file will automatically be generated in the monitor directory.</para>\n-    </description>\n-  </manager>\n-  <manager name=\"ConfbridgeStopRecord\" language=\"en_US\">\n-    <synopsis>Stop recording a Confbridge conference.</synopsis>\n-    <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"Conference\" required=\"true\"/>\n-    </syntax>\n-    <description/>\n-  </manager>\n-  <manager name=\"ConfbridgeSetSingleVideoSrc\" language=\"en_US\">\n-    <synopsis>Set a conference user as the single video source distributed to all other participants.</synopsis>\n-    <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"Conference\" required=\"true\"/>\n-      <parameter name=\"Channel\" required=\"true\">\n-        <para>If this parameter is not a complete channel name, the first channel with this prefix will be used.</para>\n-      </parameter>\n-    </syntax>\n-    <description/>\n-  </manager>\n   <module language=\"en_US\" name=\"app_sf\">\n     <support_level>extended</support_level>\n   </module>\n   <application name=\"ReceiveSF\" language=\"en_US\">\n     <since>\n       <version>16.24.0</version>\n       <version>18.10.0</version>\n@@ -9452,2819 +10341,1016 @@\n     <see-also>\n       <ref type=\"application\">SendDTMF</ref>\n       <ref type=\"application\">SendMF</ref>\n       <ref type=\"application\">ReceiveMF</ref>\n       <ref type=\"application\">ReceiveSF</ref>\n     </see-also>\n   </application>\n-  <module language=\"en_US\" name=\"app_senddtmf\">\n-    <support_level>core</support_level>\n-  </module>\n-  <application name=\"SendDTMF\" language=\"en_US\">\n-    <synopsis>Sends arbitrary DTMF digits</synopsis>\n-    <syntax>\n-      <parameter name=\"digits\" required=\"true\">\n-        <para>List of digits 0-9,*#,a-d,A-D to send also w for a half second pause,\n-\t\t\t\tW for a one second pause, and f or F for a flash-hook if the channel supports\n-\t\t\t\tflash-hook.</para>\n-      </parameter>\n-      <parameter name=\"timeout_ms\" required=\"false\">\n-        <para>Amount of time to wait in ms between tones. (defaults to .25s)</para>\n-      </parameter>\n-      <parameter name=\"duration_ms\" required=\"false\">\n-        <para>Duration of each digit</para>\n-      </parameter>\n-      <parameter name=\"channel\" required=\"false\">\n-        <para>Channel where digits will be played</para>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>It will send all digits or terminate if it encounters an error.</para>\n-    </description>\n-    <see-also>\n-      <ref type=\"application\">Read</ref>\n-    </see-also>\n-  </application>\n-  <manager name=\"PlayDTMF\" language=\"en_US\">\n-    <synopsis>Play DTMF signal on a specific channel.</synopsis>\n-    <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"Channel\" required=\"true\">\n-        <para>Channel name to send digit to.</para>\n-      </parameter>\n-      <parameter name=\"Digit\" required=\"true\">\n-        <para>The DTMF digit to play.</para>\n-      </parameter>\n-      <parameter name=\"Duration\" required=\"false\">\n-        <para>The duration, in milliseconds, of the digit to be played.</para>\n-      </parameter>\n-      <parameter name=\"Receive\" required=\"false\">\n-        <para>Emulate receiving DTMF on this channel instead of sending it out.</para>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>Plays a dtmf digit on the specified channel.</para>\n-    </description>\n-  </manager>\n-  <module language=\"en_US\" name=\"app_milliwatt\">\n+  <module language=\"en_US\" name=\"app_chanspy\">\n     <support_level>core</support_level>\n   </module>\n-  <application name=\"Milliwatt\" language=\"en_US\">\n-    <synopsis>Generates a 1004 Hz test tone at 0dbm (mu-law).</synopsis>\n+  <application name=\"ChanSpy\" language=\"en_US\">\n+    <synopsis>Listen to a channel, and optionally whisper into it.</synopsis>\n     <syntax>\n+      <parameter name=\"chanprefix\"/>\n       <parameter name=\"options\">\n         <optionlist>\n-          <option name=\"m\">\n-            <para>Generate a 1004 Hz Milliwatt test tone at 0dbm, with a\n-\t\t\t\t\t\t1 second silent interval. This option must be specified\n-\t\t\t\t\t\tif you are using this for a milliwatt test line.</para>\n-          </option>\n-          <option name=\"o\">\n-            <para>Generate a constant tone at 1000 Hz like previous version.</para>\n+          <option name=\"b\">\n+            <para>Only spy on channels involved in a bridged call.</para>\n           </option>\n-        </optionlist>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>Generates a 1004 Hz test tone.</para>\n-      <para>\n-        By default, this application does not provide a Milliwatt test tone. It simply\n-\t\t\tplays a 1004 Hz tone, which is not suitable for performing a milliwatt test.\n-\t\t\tThe\n-        <literal>m</literal>\n-        option should be used so that a real Milliwatt test tone\n-\t\t\tis provided. This will include a 1 second silent interval every 10 seconds.\n-      </para>\n-      <para>\n-        Previous versions of this application generated a constant tone at 1000 Hz. If for\n-\t\t\tsome reason you would prefer that behavior, supply the\n-        <literal>o</literal>\n-        option to get the\n-\t\t\told behavior.\n-      </para>\n-    </description>\n-  </application>\n-  <module language=\"en_US\" name=\"app_dtmfstore\">\n-    <support_level>extended</support_level>\n-  </module>\n-  <application name=\"StoreDTMF\" language=\"en_US\">\n-    <since>\n-      <version>16.20.0</version>\n-      <version>18.6.0</version>\n-      <version>19.0.0</version>\n-    </since>\n-    <synopsis>Stores DTMF digits transmitted or received on a channel.</synopsis>\n-    <syntax>\n-      <parameter name=\"direction\" required=\"true\">\n-        <para>\n-          Must be\n-          <literal>TX</literal>\n-          or\n-          <literal>RX</literal>\n-          to\n-\t\t\t\tstore digits, or\n-          <literal>remove</literal>\n-          to disable.\n-        </para>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>\n-        The StoreDTMF function can be used to obtain digits sent in the\n-        <literal>TX</literal>\n-        or\n-        <literal>RX</literal>\n-        direction of any channel.\n-      </para>\n-      <para>The arguments are:</para>\n-      <para>\n-        <replaceable>var_name</replaceable>\n-        : Name of variable to which to append\n-\t\t\tdigits.\n-      </para>\n-      <para>\n-        <replaceable>max_digits</replaceable>\n-        : The maximum number of digits to\n-\t\t\tstore in the variable. Defaults to 0 (no maximum). After reading\n-        <literal>maximum</literal>\n-        digits, no more digits will be stored.\n-      </para>\n-      <example title=\"Store digits in CDR variable\">same =&gt; n,StoreDTMF(TX,CDR(digits))</example>\n-      <example title=\"Store up to 24 digits\">same =&gt; n,StoreDTMF(RX,testvar,24)</example>\n-      <example title=\"Disable digit collection\">same =&gt; n,StoreDTMF(remove)</example>\n-    </description>\n-  </application>\n-  <module language=\"en_US\" name=\"app_sms\">\n-    <support_level>extended</support_level>\n-  </module>\n-  <application name=\"SMS\" language=\"en_US\">\n-    <synopsis>Communicates with SMS service centres and SMS capable analogue phones.</synopsis>\n-    <syntax>\n-      <parameter name=\"name\" required=\"true\">\n-        <para>\n-          The name of the queue used in\n-          <filename>/var/spool/asterisk/sms</filename>\n-        </para>\n-      </parameter>\n-      <parameter name=\"options\">\n-        <optionlist>\n-          <option name=\"a\">\n-            <para>Answer, i.e. send initial FSK packet.</para>\n+          <option name=\"B\">\n+            <para>Instead of whispering on a single channel barge in on both\n+\t\t\t\t\t\tchannels involved in the call.</para>\n           </option>\n-          <option name=\"s\">\n-            <para>Act as service centre talking to a phone.</para>\n+          <option name=\"c\">\n+            <argument name=\"digit\" required=\"true\">\n+              <para>Specify a DTMF digit that can be used to spy on the next available channel.</para>\n+            </argument>\n           </option>\n-          <option name=\"t\">\n-            <para>Use protocol 2 (default used is protocol 1).</para>\n+          <option name=\"d\">\n+            <para>Override the typical numeric DTMF functionality and instead\n+\t\t\t\t\t\tuse DTMF to switch between spy modes.</para>\n+            <enumlist>\n+              <enum name=\"4\">\n+                <para>spy mode</para>\n+              </enum>\n+              <enum name=\"5\">\n+                <para>whisper mode</para>\n+              </enum>\n+              <enum name=\"6\">\n+                <para>barge mode</para>\n+              </enum>\n+            </enumlist>\n           </option>\n-          <option name=\"p\">\n+          <option name=\"e\">\n+            <argument name=\"ext\" required=\"true\"/>\n             <para>\n-              Set the initial delay to N ms (default is\n-              <literal>300</literal>\n-              ).\n-\t\t\t\t\t\taddr and body are a deprecated format to send messages out.\n+              Enable\n+              <emphasis>enforced</emphasis>\n+              mode, so the spying channel can\n+\t\t\t\t\t\tonly monitor extensions whose name is in the\n+              <replaceable>ext</replaceable>\n+              : delimited\n+\t\t\t\t\t\tlist.\n             </para>\n           </option>\n-          <option name=\"r\">\n-            <para>Set the Status Report Request (SRR) bit.</para>\n+          <option name=\"E\">\n+            <para>Exit when the spied-on channel hangs up.</para>\n+          </option>\n+          <option name=\"g\">\n+            <argument name=\"grp\" required=\"true\">\n+              <para>\n+                Only spy on channels in which one or more of the groups\n+\t\t\t\t\t\t\tlisted in\n+                <replaceable>grp</replaceable>\n+                matches one or more groups from the\n+                <variable>SPYGROUP</variable>\n+                variable set on the channel to be spied upon.\n+              </para>\n+            </argument>\n+            <note>\n+              <para>\n+                both\n+                <replaceable>grp</replaceable>\n+                and\n+                <variable>SPYGROUP</variable>\n+                can contain\n+\t\t\t\t\t\teither a single group or a colon-delimited list of groups, such\n+\t\t\t\t\t\tas\n+                <literal>sales:support:accounting</literal>\n+                .\n+              </para>\n+            </note>\n+          </option>\n+          <option name=\"l\">\n+            <para>Allow usage of a long queue to store audio frames.</para>\n+            <note>\n+              <para>This may introduce some delay in the received audio feed, but will improve the audio quality.</para>\n+            </note>\n+          </option>\n+          <option name=\"n\" argsep=\"@\">\n+            <para>\n+              Say the name of the person being spied on if that person has recorded\n+\t\t\t\t\t\this/her name. If a context is specified, then that voicemail context will\n+\t\t\t\t\t\tbe searched when retrieving the name, otherwise the\n+              <literal>default</literal>\n+              context\n+\t\t\t\t\t\tbe used when searching for the name (i.e. if SIP/1000 is the channel being\n+\t\t\t\t\t\tspied on and no mailbox is specified, then\n+              <literal>1000</literal>\n+              will be used when searching\n+\t\t\t\t\t\tfor the name).\n+            </para>\n+            <argument name=\"mailbox\"/>\n+            <argument name=\"context\"/>\n           </option>\n           <option name=\"o\">\n-            <para>The body should be coded as octets not 7-bit symbols.</para>\n+            <para>Only listen to audio coming from this channel.</para>\n           </option>\n-          <option name=\"n\">\n-            <para>Do not log any SMS content to log file (privacy).</para>\n+          <option name=\"q\">\n+            <para>Don't play a beep when beginning to spy on a channel, or speak the\n+\t\t\t\t\t\tselected channel name.</para>\n           </option>\n-        </optionlist>\n+          <option name=\"r\">\n+            <para>\n+              Record the session to the monitor spool directory. An optional base for the filename\n+\t\t\t\t\t\tmay be specified. The default is\n+              <literal>chanspy</literal>\n+              .\n+            </para>\n+            <argument name=\"basename\"/>\n+          </option>\n+          <option name=\"s\">\n+            <para>Skip the playback of the channel type (i.e. SIP, IAX, etc) when\n+\t\t\t\t\t\tspeaking the selected channel name.</para>\n+          </option>\n+          <option name=\"S\">\n+            <para>Stop when no more channels are left to spy on.</para>\n+          </option>\n+          <option name=\"u\">\n+            <para>\n+              The\n+              <literal>chanprefix</literal>\n+              parameter is a channel uniqueid\n+\t\t\t\t\t\tor fully specified channel name.\n+            </para>\n+          </option>\n+          <option name=\"v\">\n+            <argument name=\"value\"/>\n+            <para>\n+              Adjust the initial volume in the range from\n+              <literal>-4</literal>\n+              to\n+              <literal>4</literal>\n+              . A negative value refers to a quieter setting.\n+            </para>\n+          </option>\n+          <option name=\"w\">\n+            <para>\n+              Enable\n+              <literal>whisper</literal>\n+              mode, so the spying channel can talk to\n+\t\t\t\t\t\tthe spied-on channel.\n+            </para>\n+          </option>\n+          <option name=\"W\">\n+            <para>\n+              Enable\n+              <literal>private whisper</literal>\n+              mode, so the spying channel can\n+\t\t\t\t\t\ttalk to the spied-on channel but cannot listen to that channel.\n+            </para>\n+          </option>\n+          <option name=\"x\">\n+            <argument name=\"digit\" required=\"true\">\n+              <para>Specify a DTMF digit that can be used to exit the application while actively\n+\t\t\t\t\t\t\tspying on a channel. If there is no channel being spied on, the DTMF digit will be\n+\t\t\t\t\t\t\tignored.</para>\n+            </argument>\n+          </option>\n+          <option name=\"X\">\n+            <para>\n+              Allow the user to exit ChanSpy to a valid single digit\n+\t\t\t\t\t\tnumeric extension in the current context or the context\n+\t\t\t\t\t\tspecified by the\n+              <variable>SPY_EXIT_CONTEXT</variable>\n+              channel variable. The\n+\t\t\t\t\t\tname of the last channel that was spied on will be stored\n+\t\t\t\t\t\tin the\n+              <variable>SPY_CHANNEL</variable>\n+              variable.\n+            </para>\n+          </option>\n+        </optionlist>\n       </parameter>\n-      <parameter name=\"addr\"/>\n-      <parameter name=\"body\"/>\n     </syntax>\n     <description>\n-      <para>SMS handles exchange of SMS data with a call to/from SMS capable phone or SMS PSTN service center.\n-\t\t\tCan send and/or receive SMS messages. Works to ETSI ES 201 912; compatible with BT SMS PSTN service in\n-\t\t\tUK and Telecom Italia in Italy.</para>\n       <para>\n-        Typical usage is to use to handle calls from the SMS service centre CLI, or to set up a call using\n-        <literal>outgoing</literal>\n-        or manager interface to connect service centre to SMS().\n+        This application is used to listen to the audio from an Asterisk channel. This includes the audio\n+\t\t\tcoming in and out of the channel being spied on. If the\n+        <literal>chanprefix</literal>\n+        parameter is specified,\n+\t\t\tonly channels beginning with this string will be spied upon.\n       </para>\n-      <para>&quot;Messages are processed as per text file message queues. smsq (a separate software) is a command to\n-\t\t\tgenerate message queues and send messages.</para>\n-      <note>\n-        <para>The protocol has tight delay bounds. Please use short frames and disable/keep short the\n-\t\t\tjitter buffer on the ATA to make sure that respones (ACK etc.) are received in time.</para>\n-      </note>\n-    </description>\n-  </application>\n-  <module language=\"en_US\" name=\"app_while\">\n-    <support_level>core</support_level>\n-  </module>\n-  <application name=\"While\" language=\"en_US\">\n-    <synopsis>Start a while loop.</synopsis>\n-    <syntax>\n-      <parameter name=\"expr\" required=\"true\"/>\n-    </syntax>\n-    <description>\n+      <para>While spying, the following actions may be performed:</para>\n       <para>\n-        Start a While Loop.  Execution will return to this point when\n-        <literal>EndWhile()</literal>\n-        is called until expr is no longer true.\n+        - Dialing\n+        <literal>#</literal>\n+        cycles the volume level.\n       </para>\n-    </description>\n-    <see-also>\n-      <ref type=\"application\">EndWhile</ref>\n-      <ref type=\"application\">ExitWhile</ref>\n-      <ref type=\"application\">ContinueWhile</ref>\n-    </see-also>\n-  </application>\n-  <application name=\"EndWhile\" language=\"en_US\">\n-    <synopsis>End a while loop.</synopsis>\n-    <syntax/>\n-    <description>\n       <para>\n-        Return to the previous called\n-        <literal>While()</literal>\n-        .\n+        - Dialing\n+        <literal>*</literal>\n+        will stop spying and look for another channel to spy on.\n       </para>\n-    </description>\n-    <see-also>\n-      <ref type=\"application\">While</ref>\n-      <ref type=\"application\">ExitWhile</ref>\n-      <ref type=\"application\">ContinueWhile</ref>\n-    </see-also>\n-  </application>\n-  <application name=\"ExitWhile\" language=\"en_US\">\n-    <synopsis>End a While loop.</synopsis>\n-    <syntax/>\n-    <description>\n       <para>\n-        Exits a\n-        <literal>While()</literal>\n-        loop, whether or not the conditional has been satisfied.\n+        - Dialing a series of digits followed by\n+        <literal>#</literal>\n+        builds a channel name to append\n+\t\t\tto\n+        <literal>chanprefix</literal>\n+        . For example, executing ChanSpy(Agent) and then dialing the digits '1234#'\n+\t\t\twhile spying will begin spying on the channel 'Agent/1234'. Note that this feature will be overridden\n+\t\t\tif the 'd' or 'u' options are used.\n       </para>\n-    </description>\n-    <see-also>\n-      <ref type=\"application\">While</ref>\n-      <ref type=\"application\">EndWhile</ref>\n-      <ref type=\"application\">ContinueWhile</ref>\n-    </see-also>\n-  </application>\n-  <application name=\"ContinueWhile\" language=\"en_US\">\n-    <synopsis>Restart a While loop.</synopsis>\n-    <syntax/>\n-    <description>\n-      <para>Returns to the top of the while loop and re-evaluates the conditional.</para>\n-    </description>\n-    <see-also>\n-      <ref type=\"application\">While</ref>\n-      <ref type=\"application\">EndWhile</ref>\n-      <ref type=\"application\">ExitWhile</ref>\n-    </see-also>\n-  </application>\n-  <module language=\"en_US\" name=\"app_privacy\">\n-    <support_level>core</support_level>\n-  </module>\n-  <application name=\"PrivacyManager\" language=\"en_US\">\n-    <synopsis>Require phone number to be entered, if no CallerID sent</synopsis>\n-    <syntax>\n-      <parameter name=\"maxretries\">\n-        <para>\n-          Total tries caller is allowed to input a callerid. Defaults to\n-          <literal>3</literal>\n-          .\n-        </para>\n-      </parameter>\n-      <parameter name=\"minlength\">\n+      <note>\n         <para>\n-          Minimum allowable digits in the input callerid number. Defaults to\n-          <literal>10</literal>\n-          .\n+          The\n+          <replaceable>X</replaceable>\n+          option supersedes the three features above in that if a valid\n+\t\t\tsingle digit extension exists in the correct context ChanSpy will exit to it.\n+\t\t\tThis also disables choosing a channel based on\n+          <literal>chanprefix</literal>\n+          and a digit sequence.\n         </para>\n-      </parameter>\n-      <parameter name=\"options\">\n-        <para>Position reserved for options.</para>\n-      </parameter>\n-      <parameter name=\"context\">\n-        <para>Context to check the given callerid against patterns.</para>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>\n-        If no Caller*ID is sent, PrivacyManager answers the channel and asks\n-\t\t\tthe caller to enter their phone number. The caller is given\n-        <replaceable>maxretries</replaceable>\n-        attempts to do so. The application does\n-        <emphasis>nothing</emphasis>\n-        if Caller*ID was received on the channel.\n-      </para>\n-      <para>The application sets the following channel variable upon completion:</para>\n-      <variablelist>\n-        <variable name=\"PRIVACYMGRSTATUS\">\n-          <para>The status of the privacy manager's attempt to collect a phone number from the user.</para>\n-          <value name=\"SUCCESS\"/>\n-          <value name=\"FAILED\"/>\n-        </variable>\n-      </variablelist>\n+      </note>\n     </description>\n     <see-also>\n-      <ref type=\"application\">Zapateller</ref>\n+      <ref type=\"application\">ExtenSpy</ref>\n+      <ref type=\"managerEvent\">ChanSpyStart</ref>\n+      <ref type=\"managerEvent\">ChanSpyStop</ref>\n     </see-also>\n   </application>\n-  <module language=\"en_US\" name=\"app_system\">\n-    <support_level>core</support_level>\n-  </module>\n-  <application name=\"System\" language=\"en_US\">\n-    <synopsis>Execute a system command.</synopsis>\n-    <syntax>\n-      <parameter name=\"command\" required=\"true\">\n-        <para>Command to execute</para>\n-        <warning>\n-          <para>\n-            Do not use untrusted strings such as\n-            <variable>CALLERID(num)</variable>\n-            or\n-            <variable>CALLERID(name)</variable>\n-            as part of the command parameters.  You\n-\t\t\t\trisk a command injection attack executing arbitrary commands if the untrusted\n-\t\t\t\tstrings aren't filtered to remove dangerous characters.  See function\n-            <variable>FILTER()</variable>\n-            .\n-          </para>\n-        </warning>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>Executes a command  by  using  system(). If the command\n-\t\t\tfails, the console should report a fallthrough.</para>\n-      <para>\n-        Result of execution is returned in the\n-        <variable>SYSTEMSTATUS</variable>\n-        channel variable:\n-      </para>\n-      <variablelist>\n-        <variable name=\"SYSTEMSTATUS\">\n-          <value name=\"FAILURE\">Could not execute the specified command.</value>\n-          <value name=\"SUCCESS\">Specified command successfully executed.</value>\n-        </variable>\n-      </variablelist>\n-    </description>\n-  </application>\n-  <application name=\"TrySystem\" language=\"en_US\">\n-    <synopsis>Try executing a system command.</synopsis>\n+  <application name=\"ExtenSpy\" language=\"en_US\">\n+    <synopsis>Listen to a channel, and optionally whisper into it.</synopsis>\n     <syntax>\n-      <parameter name=\"command\" required=\"true\">\n-        <para>Command to execute</para>\n-        <warning>\n+      <parameter name=\"exten\" required=\"true\" argsep=\"@\">\n+        <argument name=\"exten\" required=\"true\">\n+          <para>Specify extension.</para>\n+        </argument>\n+        <argument name=\"context\">\n           <para>\n-            Do not use untrusted strings such as\n-            <variable>CALLERID(num)</variable>\n-            or\n-            <variable>CALLERID(name)</variable>\n-            as part of the command parameters.  You\n-\t\t\t\trisk a command injection attack executing arbitrary commands if the untrusted\n-\t\t\t\tstrings aren't filtered to remove dangerous characters.  See function\n-            <variable>FILTER()</variable>\n+            Optionally specify a context, defaults to\n+            <literal>default</literal>\n             .\n           </para>\n-        </warning>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>Executes a command  by  using  system().</para>\n-      <para>\n-        Result of execution is returned in the\n-        <variable>SYSTEMSTATUS</variable>\n-        channel variable:\n-      </para>\n-      <variablelist>\n-        <variable name=\"SYSTEMSTATUS\">\n-          <value name=\"FAILURE\">Could not execute the specified command.</value>\n-          <value name=\"SUCCESS\">Specified command successfully executed.</value>\n-          <value name=\"APPERROR\">Specified command successfully executed, but returned error code.</value>\n-        </variable>\n-      </variablelist>\n-    </description>\n-  </application>\n-  <module language=\"en_US\" name=\"app_mixmonitor\">\n-    <use type=\"module\">func_periodic_hook</use>\n-    <support_level>core</support_level>\n-  </module>\n-  <application name=\"MixMonitor\" language=\"en_US\">\n-    <synopsis>Record a call and mix the audio during the recording.  Use of StopMixMonitor is required\n-\t\t\tto guarantee the audio file is available for processing during dialplan execution.</synopsis>\n-    <syntax>\n-      <parameter name=\"file\" required=\"true\" argsep=\".\">\n-        <argument name=\"filename\" required=\"true\">\n-          <para>\n-            If\n-            <replaceable>filename</replaceable>\n-            is an absolute path, uses that path, otherwise\n-\t\t\t\t\tcreates the file in the configured monitoring directory from\n-            <filename>asterisk.conf.</filename>\n-          </para>\n         </argument>\n-        <argument name=\"extension\" required=\"true\"/>\n       </parameter>\n       <parameter name=\"options\">\n         <optionlist>\n-          <option name=\"a\">\n-            <para>Append to the file instead of overwriting it.</para>\n-          </option>\n           <option name=\"b\">\n-            <para>Only save audio to the file while the channel is bridged.</para>\n+            <para>Only spy on channels involved in a bridged call.</para>\n+          </option>\n+          <option name=\"B\">\n+            <para>Instead of whispering on a single channel barge in on both\n+\t\t\t\t\t\tchannels involved in the call.</para>\n+          </option>\n+          <option name=\"c\">\n+            <argument name=\"digit\" required=\"true\">\n+              <para>Specify a DTMF digit that can be used to spy on the next available channel.</para>\n+            </argument>\n+          </option>\n+          <option name=\"d\">\n+            <para>Override the typical numeric DTMF functionality and instead\n+\t\t\t\t\t\tuse DTMF to switch between spy modes.</para>\n+            <enumlist>\n+              <enum name=\"4\">\n+                <para>spy mode</para>\n+              </enum>\n+              <enum name=\"5\">\n+                <para>whisper mode</para>\n+              </enum>\n+              <enum name=\"6\">\n+                <para>barge mode</para>\n+              </enum>\n+            </enumlist>\n+          </option>\n+          <option name=\"e\">\n+            <argument name=\"ext\" required=\"true\"/>\n+            <para>\n+              Enable\n+              <emphasis>enforced</emphasis>\n+              mode, so the spying channel can\n+\t\t\t\t\t\tonly monitor extensions whose name is in the\n+              <replaceable>ext</replaceable>\n+              : delimited\n+\t\t\t\t\t\tlist.\n+            </para>\n+          </option>\n+          <option name=\"E\">\n+            <para>Exit when the spied-on channel hangs up.</para>\n+          </option>\n+          <option name=\"g\">\n+            <argument name=\"grp\" required=\"true\">\n+              <para>\n+                Only spy on channels in which one or more of the groups\n+\t\t\t\t\t\t\tlisted in\n+                <replaceable>grp</replaceable>\n+                matches one or more groups from the\n+                <variable>SPYGROUP</variable>\n+                variable set on the channel to be spied upon.\n+              </para>\n+            </argument>\n             <note>\n               <para>\n-                If you utilize this option inside a Local channel, you must make sure the Local\n-\t\t\t\t\t\tchannel is not optimized away. To do this, be sure to call your Local channel with the\n-                <literal>/n</literal>\n-                option. For example: Dial(Local/start@mycontext/n)\n+                both\n+                <replaceable>grp</replaceable>\n+                and\n+                <variable>SPYGROUP</variable>\n+                can contain\n+\t\t\t\t\t\teither a single group or a colon-delimited list of groups, such\n+\t\t\t\t\t\tas\n+                <literal>sales:support:accounting</literal>\n+                .\n               </para>\n             </note>\n           </option>\n-          <option name=\"B\">\n-            <para>Play a periodic beep while this call is being recorded.</para>\n-            <argument name=\"interval\">\n-              <para>Interval, in seconds. Default is 15.</para>\n-            </argument>\n+          <option name=\"l\">\n+            <para>Allow usage of a long queue to store audio frames.</para>\n+            <note>\n+              <para>This may introduce some delay in the received audio feed, but will improve the audio quality.</para>\n+            </note>\n           </option>\n-          <option name=\"v\">\n+          <option name=\"n\" argsep=\"@\">\n             <para>\n-              Adjust the\n-              <emphasis>heard</emphasis>\n-              volume by a factor of\n-              <replaceable>x</replaceable>\n-              (range\n-              <literal>-4</literal>\n-              to\n-              <literal>4</literal>\n-              )\n+              Say the name of the person being spied on if that person has recorded\n+\t\t\t\t\t\this/her name. If a context is specified, then that voicemail context will\n+\t\t\t\t\t\tbe searched when retrieving the name, otherwise the\n+              <literal>default</literal>\n+              context\n+\t\t\t\t\t\tbe used when searching for the name (i.e. if SIP/1000 is the channel being\n+\t\t\t\t\t\tspied on and no mailbox is specified, then\n+              <literal>1000</literal>\n+              will be used when searching\n+\t\t\t\t\t\tfor the name).\n             </para>\n-            <argument name=\"x\" required=\"true\"/>\n+            <argument name=\"mailbox\"/>\n+            <argument name=\"context\"/>\n           </option>\n-          <option name=\"V\">\n+          <option name=\"o\">\n+            <para>Only listen to audio coming from this channel.</para>\n+          </option>\n+          <option name=\"q\">\n+            <para>Don't play a beep when beginning to spy on a channel, or speak the\n+\t\t\t\t\t\tselected channel name.</para>\n+          </option>\n+          <option name=\"r\">\n             <para>\n-              Adjust the\n-              <emphasis>spoken</emphasis>\n-              volume by a factor\n-\t\t\t\t\t\tof\n-              <replaceable>x</replaceable>\n-              (range\n-              <literal>-4</literal>\n-              to\n-              <literal>4</literal>\n-              )\n+              Record the session to the monitor spool directory. An optional base for the filename\n+\t\t\t\t\t\tmay be specified. The default is\n+              <literal>chanspy</literal>\n+              .\n             </para>\n-            <argument name=\"x\" required=\"true\"/>\n+            <argument name=\"basename\"/>\n           </option>\n-          <option name=\"W\">\n+          <option name=\"s\">\n+            <para>Skip the playback of the channel type (i.e. SIP, IAX, etc) when\n+\t\t\t\t\t\tspeaking the selected channel name.</para>\n+          </option>\n+          <option name=\"S\">\n+            <para>Stop when there are no more extensions left to spy on.</para>\n+          </option>\n+          <option name=\"v\">\n+            <argument name=\"value\"/>\n             <para>\n-              Adjust both,\n-              <emphasis>heard and spoken</emphasis>\n-              volumes by a factor\n-\t\t\t\t\t\tof\n-              <replaceable>x</replaceable>\n-              (range\n+              Adjust the initial volume in the range from\n               <literal>-4</literal>\n               to\n               <literal>4</literal>\n-              )\n-            </para>\n-            <argument name=\"x\" required=\"true\"/>\n-          </option>\n-          <option name=\"r\">\n-            <argument name=\"file\" required=\"true\"/>\n-            <para>\n-              Use the specified file to record the\n-              <emphasis>receive</emphasis>\n-              audio feed.\n-\t\t\t\t\t\tLike with the basic filename argument, if an absolute path isn't given, it will create\n-\t\t\t\t\t\tthe file in the configured monitoring directory.\n+              . A negative value refers to a quieter setting.\n             </para>\n           </option>\n-          <option name=\"t\">\n-            <argument name=\"file\" required=\"true\"/>\n+          <option name=\"w\">\n             <para>\n-              Use the specified file to record the\n-              <emphasis>transmit</emphasis>\n-              audio feed.\n-\t\t\t\t\t\tLike with the basic filename argument, if an absolute path isn't given, it will create\n-\t\t\t\t\t\tthe file in the configured monitoring directory.\n+              Enable\n+              <literal>whisper</literal>\n+              mode, so the spying channel can talk to\n+\t\t\t\t\t\tthe spied-on channel.\n             </para>\n           </option>\n-          <option name=\"S\">\n+          <option name=\"W\">\n             <para>\n-              When combined with the\n-              <replaceable>r</replaceable>\n-              or\n-              <replaceable>t</replaceable>\n-              option, inserts silence when necessary to maintain synchronization between the receive\n-\t\t\t\t\t\tand transmit audio streams.\n+              Enable\n+              <literal>private whisper</literal>\n+              mode, so the spying channel can\n+\t\t\t\t\t\ttalk to the spied-on channel but cannot listen to that channel.\n             </para>\n           </option>\n-          <option name=\"i\">\n-            <argument name=\"chanvar\" required=\"true\"/>\n-            <para>Stores the MixMonitor's ID on this channel variable.</para>\n-          </option>\n-          <option name=\"p\">\n-            <para>Play a beep on the channel that starts the recording.</para>\n-          </option>\n-          <option name=\"P\">\n-            <para>Play a beep on the channel that stops the recording.</para>\n+          <option name=\"x\">\n+            <argument name=\"digit\" required=\"true\">\n+              <para>Specify a DTMF digit that can be used to exit the application while actively\n+\t\t\t\t\t\t\tspying on a channel. If there is no channel being spied on, the DTMF digit will be\n+\t\t\t\t\t\t\tignored.</para>\n+            </argument>\n           </option>\n-          <option name=\"m\">\n-            <argument name=\"mailbox\" required=\"true\"/>\n+          <option name=\"X\">\n             <para>\n-              Create a copy of the recording as a voicemail in the indicated\n-              <emphasis>mailbox</emphasis>\n-              (es)\n-\t\t\t\t\t\tseparated by commas eg. m(1111@default,2222@default,...).  Folders can be optionally specified using\n-\t\t\t\t\t\tthe syntax: mailbox@context/folder\n+              Allow the user to exit ChanSpy to a valid single digit\n+\t\t\t\t\t\tnumeric extension in the current context or the context\n+\t\t\t\t\t\tspecified by the\n+              <variable>SPY_EXIT_CONTEXT</variable>\n+              channel variable. The\n+\t\t\t\t\t\tname of the last channel that was spied on will be stored\n+\t\t\t\t\t\tin the\n+              <variable>SPY_CHANNEL</variable>\n+              variable.\n             </para>\n           </option>\n         </optionlist>\n       </parameter>\n-      <parameter name=\"command\">\n-        <para>Will be executed when the recording is over.</para>\n-        <para>\n-          Any strings matching\n-          <literal>^{X}</literal>\n-          will be unescaped to\n-          <variable>X</variable>\n-          .\n-        </para>\n-        <para>All variables will be evaluated at the time MixMonitor is called.</para>\n-        <warning>\n-          <para>\n-            Do not use untrusted strings such as\n-            <variable>CALLERID(num)</variable>\n-            or\n-            <variable>CALLERID(name)</variable>\n-            as part of the command parameters.  You\n-\t\t\t\trisk a command injection attack executing arbitrary commands if the untrusted\n-\t\t\t\tstrings aren't filtered to remove dangerous characters.  See function\n-            <variable>FILTER()</variable>\n-            .\n-          </para>\n-        </warning>\n-      </parameter>\n     </syntax>\n     <description>\n-      <para>Records the audio on the current channel to the specified file.</para>\n-      <para>This application does not automatically answer and should be preceeded by\n-\t\t\tan application such as Answer or Progress().</para>\n-      <note>\n-        <para>MixMonitor runs as an audiohook.</para>\n-      </note>\n+      <para>This application is used to listen to the audio from an Asterisk channel. This includes\n+\t\t\tthe audio coming in and out of the channel being spied on. Only channels created by outgoing calls for the\n+\t\t\tspecified extension will be selected for spying. If the optional context is not supplied,\n+\t\t\tthe current channel's context will be used.</para>\n+      <para>While spying, the following actions may be performed:</para>\n+      <para>\n+        - Dialing\n+        <literal>#</literal>\n+        cycles the volume level.\n+      </para>\n+      <para>\n+        - Dialing\n+        <literal>*</literal>\n+        will stop spying and look for another channel to spy on.\n+      </para>\n       <note>\n         <para>\n-          If a filename passed to MixMonitor ends with\n-          <literal>.wav49</literal>\n-          , Asterisk will silently convert the extension to\n-          <literal>.WAV</literal>\n-          for legacy reasons.\n-          <variable>MIXMONITOR_FILENAME</variable>\n-          will contain the actual filename that Asterisk is writing to, not necessarily the\n-\t\t\tvalue that was passed in.\n+          The\n+          <replaceable>X</replaceable>\n+          option supersedes the three features above in that if a valid\n+\t\t\tsingle digit extension exists in the correct context ChanSpy will exit to it.\n+\t\t\tThis also disables choosing a channel based on\n+          <literal>chanprefix</literal>\n+          and a digit sequence.\n         </para>\n       </note>\n-      <variablelist>\n-        <variable name=\"MIXMONITOR_FILENAME\">\n-          <para>Will contain the filename used to record.</para>\n-        </variable>\n-      </variablelist>\n-      <warning>\n-        <para>\n-          Do not use untrusted strings such as\n-          <variable>CALLERID(num)</variable>\n-          or\n-          <variable>CALLERID(name)</variable>\n-          as part of ANY of the application's\n-\t\t\tparameters.  You risk a command injection attack executing arbitrary commands\n-\t\t\tif the untrusted strings aren't filtered to remove dangerous characters.  See\n-\t\t\tfunction\n-          <variable>FILTER()</variable>\n-          .\n-        </para>\n-      </warning>\n     </description>\n     <see-also>\n-      <ref type=\"application\">Monitor</ref>\n-      <ref type=\"application\">StopMixMonitor</ref>\n-      <ref type=\"application\">PauseMonitor</ref>\n-      <ref type=\"application\">UnpauseMonitor</ref>\n-      <ref type=\"function\">AUDIOHOOK_INHERIT</ref>\n+      <ref type=\"application\">ChanSpy</ref>\n+      <ref type=\"managerEvent\">ChanSpyStart</ref>\n+      <ref type=\"managerEvent\">ChanSpyStop</ref>\n     </see-also>\n   </application>\n-  <application name=\"StopMixMonitor\" language=\"en_US\">\n-    <synopsis>Stop recording a call through MixMonitor, and free the recording's file handle.</synopsis>\n+  <application name=\"DAHDIScan\" language=\"en_US\">\n+    <synopsis>Scan DAHDI channels to monitor calls.</synopsis>\n     <syntax>\n-      <parameter name=\"MixMonitorID\" required=\"false\">\n-        <para>If a valid ID is provided, then this command will stop only that specific\n-\t\t\t\tMixMonitor.</para>\n+      <parameter name=\"group\">\n+        <para>\n+          Limit scanning to a channel\n+          <replaceable>group</replaceable>\n+          by setting this option.\n+        </para>\n       </parameter>\n     </syntax>\n     <description>\n       <para>\n-        Stops the audio recording that was started with a call to\n-        <literal>MixMonitor()</literal>\n-        on the current channel.\n+        Allows a call center manager to monitor DAHDI channels in a\n+\t\t\tconvenient way.  Use\n+        <literal>#</literal>\n+        to select the next channel and use\n+        <literal>*</literal>\n+        to exit.\n       </para>\n     </description>\n     <see-also>\n-      <ref type=\"application\">MixMonitor</ref>\n+      <ref type=\"managerEvent\">ChanSpyStart</ref>\n+      <ref type=\"managerEvent\">ChanSpyStop</ref>\n     </see-also>\n   </application>\n-  <manager name=\"MixMonitorMute\" language=\"en_US\">\n-    <synopsis>Mute / unMute a Mixmonitor recording.</synopsis>\n-    <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"Channel\" required=\"true\">\n-        <para>Used to specify the channel to mute.</para>\n-      </parameter>\n-      <parameter name=\"Direction\">\n-        <para>Which part of the recording to mute:  read, write or both (from channel, to channel or both channels).</para>\n-      </parameter>\n-      <parameter name=\"State\">\n-        <para>Turn mute on or off : 1 to turn on, 0 to turn off.</para>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>This action may be used to mute a MixMonitor recording.</para>\n-    </description>\n-  </manager>\n-  <manager name=\"MixMonitor\" language=\"en_US\">\n-    <synopsis>Record a call and mix the audio during the recording.  Use of StopMixMonitor is required\n-\t\t\tto guarantee the audio file is available for processing during dialplan execution.</synopsis>\n+  <module language=\"en_US\" name=\"app_readexten\">\n+    <support_level>core</support_level>\n+  </module>\n+  <application name=\"ReadExten\" language=\"en_US\">\n+    <synopsis>Read an extension into a variable.</synopsis>\n     <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"Channel\" required=\"true\">\n-        <para>Used to specify the channel to record.</para>\n+      <parameter name=\"variable\" required=\"true\"/>\n+      <parameter name=\"filename\">\n+        <para>\n+          File to play before reading digits or tone with option\n+          <literal>i</literal>\n+        </para>\n       </parameter>\n-      <parameter name=\"File\">\n-        <para>Is the name of the file created in the monitor spool directory.\n-\t\t\t\tDefaults to the same name as the channel (with slashes replaced with dashes).\n-\t\t\t\tThis argument is optional if you specify to record unidirectional audio with\n-\t\t\t\teither the r(filename) or t(filename) options in the options field. If\n-\t\t\t\tneither MIXMONITOR_FILENAME or this parameter is set, the mixed stream won't\n-\t\t\t\tbe recorded.</para>\n+      <parameter name=\"context\">\n+        <para>Context in which to match extensions.</para>\n       </parameter>\n-      <parameter name=\"options\">\n-        <para>Options that apply to the MixMonitor in the same way as they\n-\t\t\t\twould apply if invoked from the MixMonitor application. For a list of\n-\t\t\t\tavailable options, see the documentation for the mixmonitor application.</para>\n+      <parameter name=\"option\">\n+        <optionlist>\n+          <option name=\"s\">\n+            <para>Return immediately if the channel is not answered.</para>\n+          </option>\n+          <option name=\"i\">\n+            <para>\n+              Play\n+              <replaceable>filename</replaceable>\n+              as an indication tone from your\n+              <filename>indications.conf</filename>\n+              or a directly specified list of\n+\t\t\t\t\t\tfrequencies and durations.\n+            </para>\n+          </option>\n+          <option name=\"n\">\n+            <para>Read digits even if the channel is not answered.</para>\n+          </option>\n+          <option name=\"p\">\n+            <para>\n+              The extension entered will be considered complete when a\n+              <literal>#</literal>\n+              is entered.\n+            </para>\n+          </option>\n+        </optionlist>\n       </parameter>\n-      <parameter name=\"Command\">\n+      <parameter name=\"timeout\">\n         <para>\n-          Will be executed when the recording is over.\n-\t\t\t\tAny strings matching\n-          <literal>^{X}</literal>\n-          will be unescaped to\n-          <variable>X</variable>\n-          .\n-\t\t\t\tAll variables will be evaluated at the time MixMonitor is called.\n+          An integer number of seconds to wait for a digit response. If\n+\t\t\t\tgreater than\n+          <literal>0</literal>\n+          , that value will override the default timeout.\n         </para>\n-        <warning>\n-          <para>\n-            Do not use untrusted strings such as\n-            <variable>CALLERID(num)</variable>\n-            or\n-            <variable>CALLERID(name)</variable>\n-            as part of the command parameters.  You\n-\t\t\t\trisk a command injection attack executing arbitrary commands if the untrusted\n-\t\t\t\tstrings aren't filtered to remove dangerous characters.  See function\n-            <variable>FILTER()</variable>\n-            .\n-          </para>\n-        </warning>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>This action records the audio on the current channel to the specified file.</para>\n+      <para>\n+        Reads a\n+        <literal>#</literal>\n+        terminated string of digits from the user into the given variable.\n+      </para>\n+      <para>Will set READEXTENSTATUS on exit with one of the following statuses:</para>\n       <variablelist>\n-        <variable name=\"MIXMONITOR_FILENAME\">\n-          <para>Will contain the filename used to record the mixed stream.</para>\n+        <variable name=\"READEXTENSTATUS\">\n+          <value name=\"OK\">A valid extension exists in ${variable}.</value>\n+          <value name=\"TIMEOUT\">No extension was entered in the specified time.  Also sets ${variable} to &quot;t&quot;.</value>\n+          <value name=\"INVALID\">An invalid extension, ${INVALID_EXTEN}, was entered.  Also sets ${variable} to &quot;i&quot;.</value>\n+          <value name=\"SKIP\">Line was not up and the option 's' was specified.</value>\n+          <value name=\"ERROR\">Invalid arguments were passed.</value>\n         </variable>\n       </variablelist>\n     </description>\n-  </manager>\n-  <manager name=\"StopMixMonitor\" language=\"en_US\">\n-    <synopsis>Stop recording a call through MixMonitor, and free the recording's file handle.</synopsis>\n+  </application>\n+  <module language=\"en_US\" name=\"app_channelredirect\">\n+    <support_level>core</support_level>\n+  </module>\n+  <application name=\"ChannelRedirect\" language=\"en_US\">\n+    <synopsis>Redirects given channel to a dialplan target</synopsis>\n     <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"Channel\" required=\"true\">\n-        <para>The name of the channel monitored.</para>\n-      </parameter>\n-      <parameter name=\"MixMonitorID\" required=\"false\">\n-        <para>If a valid ID is provided, then this command will stop only that specific\n-\t\t\t\tMixMonitor.</para>\n-      </parameter>\n+      <parameter name=\"channel\" required=\"true\"/>\n+      <parameter name=\"context\" required=\"false\"/>\n+      <parameter name=\"extension\" required=\"false\"/>\n+      <parameter name=\"priority\" required=\"true\"/>\n     </syntax>\n     <description>\n-      <para>\n-        This action stops the audio recording that was started with the\n-        <literal>MixMonitor</literal>\n-        action on the current channel.\n-      </para>\n+      <para>Sends the specified channel to the specified extension priority</para>\n+      <para>This application sets the following channel variables upon completion</para>\n+      <variablelist>\n+        <variable name=\"CHANNELREDIRECT_STATUS\">\n+          <value name=\"NOCHANNEL\"/>\n+          <value name=\"SUCCESS\"/>\n+          <para>Are set to the result of the redirection</para>\n+        </variable>\n+      </variablelist>\n     </description>\n-  </manager>\n-  <function name=\"MIXMONITOR\" language=\"en_US\">\n-    <synopsis>Retrieve data pertaining to specific instances of MixMonitor on a channel.</synopsis>\n+  </application>\n+  <module language=\"en_US\" name=\"app_disa\">\n+    <use type=\"module\">app_cdr</use>\n+    <support_level>core</support_level>\n+  </module>\n+  <application name=\"DISA\" language=\"en_US\">\n+    <synopsis>Direct Inward System Access.</synopsis>\n     <syntax>\n-      <parameter name=\"id\" required=\"true\">\n+      <parameter name=\"passcode|filename\" required=\"true\">\n         <para>\n-          The unique ID of the MixMonitor instance. The unique ID can be retrieved through the channel\n-\t\t\t\tvariable used as an argument to the\n-          <replaceable>i</replaceable>\n-          option to MixMonitor.\n+          If you need to present a DISA dialtone without entering a password,\n+\t\t\t\tsimply set\n+          <replaceable>passcode</replaceable>\n+          to\n+          <literal>no-password</literal>\n+        </para>\n+        <para>\n+          You may specified a\n+          <replaceable>filename</replaceable>\n+          instead of a\n+          <replaceable>passcode</replaceable>\n+          , this filename must contain individual passcodes\n         </para>\n       </parameter>\n-      <parameter name=\"key\" required=\"true\">\n-        <para>The piece of data to retrieve from the MixMonitor.</para>\n-        <enumlist>\n-          <enum name=\"filename\"/>\n-        </enumlist>\n-      </parameter>\n-    </syntax>\n-  </function>\n-  <managerEvent language=\"en_US\" name=\"MixMonitorStart\">\n-    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n-      <synopsis>Raised when monitoring has started on a channel.</synopsis>\n-      <syntax>\n-        <channel_snapshot/>\n-      </syntax>\n-      <see-also>\n-        <ref type=\"managerEvent\">MixMonitorStop</ref>\n-        <ref type=\"application\">MixMonitor</ref>\n-        <ref type=\"manager\">MixMonitor</ref>\n-      </see-also>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <managerEvent language=\"en_US\" name=\"MixMonitorStop\">\n-    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n-      <synopsis>Raised when monitoring has stopped on a channel.</synopsis>\n-      <syntax>\n-        <channel_snapshot/>\n-      </syntax>\n-      <see-also>\n-        <ref type=\"managerEvent\">MixMonitorStart</ref>\n-        <ref type=\"application\">StopMixMonitor</ref>\n-        <ref type=\"manager\">StopMixMonitor</ref>\n-      </see-also>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <managerEvent language=\"en_US\" name=\"MixMonitorMute\">\n-    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n-      <synopsis>Raised when monitoring is muted or unmuted on a channel.</synopsis>\n-      <syntax>\n-        <channel_snapshot/>\n-        <parameter name=\"Direction\">\n-          <para>Which part of the recording was muted or unmuted: read, write or both\n-\t\t\t\t(from channel, to channel or both directions).</para>\n-        </parameter>\n-        <parameter name=\"State\">\n-          <para>If the monitoring was muted or unmuted: 1 when muted, 0 when unmuted.</para>\n-        </parameter>\n-      </syntax>\n-      <see-also>\n-        <ref type=\"manager\">MixMonitorMute</ref>\n-      </see-also>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <module language=\"en_US\" name=\"app_dahdiras\">\n-    <depend>dahdi</depend>\n-    <support_level>deprecated</support_level>\n-    <deprecated_in>16</deprecated_in>\n-    <removed_in>19</removed_in>\n-  </module>\n-  <application name=\"DAHDIRAS\" language=\"en_US\">\n-    <synopsis>Executes DAHDI ISDN RAS application.</synopsis>\n-    <syntax>\n-      <parameter name=\"args\" required=\"true\">\n+      <parameter name=\"context\">\n         <para>\n-          A list of parameters to pass to the pppd daemon,\n-\t\t\t\tseparated by\n-          <literal>,</literal>\n-          characters.\n+          Specifies the dialplan context in which the user-entered extension\n+\t\t\t\twill be matched. If no context is specified, the DISA application defaults\n+\t\t\t\tto the\n+          <literal>disa</literal>\n+          context. Presumably a normal system will have a special\n+\t\t\t\tcontext set up for DISA use with some or a lot of restrictions.\n         </para>\n       </parameter>\n-    </syntax>\n-    <description>\n-      <para>Executes a RAS server using pppd on the given channel.\n-\t\t\tThe channel must be a clear channel (i.e. PRI source) and a DAHDI\n-\t\t\tchannel to be able to use this function (No modem emulation is included).</para>\n-      <para>Your pppd must be patched to be DAHDI aware.</para>\n-    </description>\n-  </application>\n-  <module language=\"en_US\" name=\"app_ivrdemo\">\n-    <defaultenabled>no</defaultenabled>\n-    <support_level>extended</support_level>\n-  </module>\n-  <application name=\"IVRDemo\" language=\"en_US\">\n-    <synopsis>IVR Demo Application.</synopsis>\n-    <syntax>\n-      <parameter name=\"filename\" required=\"true\"/>\n-    </syntax>\n-    <description>\n-      <para>This is a skeleton application that shows you the basic structure to create your\n-\t\t\town asterisk applications and demonstrates the IVR demo.</para>\n-    </description>\n-  </application>\n-  <module language=\"en_US\" name=\"app_externalivr\">\n-    <support_level>extended</support_level>\n-  </module>\n-  <application name=\"ExternalIVR\" language=\"en_US\">\n-    <synopsis>Interfaces with an external IVR application.</synopsis>\n-    <syntax>\n-      <parameter name=\"command|ivr://host\" required=\"true\" hasparams=\"true\">\n-        <argument name=\"arg1\"/>\n-        <argument name=\"arg2\" multiple=\"yes\"/>\n+      <parameter name=\"cid\">\n+        <para>Specifies a new (different) callerid to be used for this call.</para>\n+      </parameter>\n+      <parameter name=\"mailbox\" argsep=\"@\">\n+        <para>\n+          Will cause a stutter-dialtone (indication\n+          <emphasis>dialrecall</emphasis>\n+          )\n+\t\t\t\tto be used, if the specified mailbox contains any new messages.\n+        </para>\n+        <argument name=\"mailbox\" required=\"true\"/>\n+        <argument name=\"context\" required=\"false\"/>\n       </parameter>\n       <parameter name=\"options\">\n         <optionlist>\n           <option name=\"n\">\n-            <para>Tells ExternalIVR() not to answer the channel.</para>\n-          </option>\n-          <option name=\"i\">\n-            <para>\n-              Tells ExternalIVR() not to send a hangup and exit when the\n-\t\t\t\t\t\tchannel receives a hangup, instead it sends an\n-              <literal>I</literal>\n-              informative message meaning that the external application MUST hang\n-\t\t\t\t\t\tup the call with an\n-              <literal>H</literal>\n-              command.\n-            </para>\n+            <para>The DISA application will not answer initially.</para>\n           </option>\n-          <option name=\"d\">\n+          <option name=\"p\">\n             <para>\n-              Tells ExternalIVR() to run on a channel that has been hung up\n-\t\t\t\t\t\tand will not look for hangups. The external application must exit with\n-\t\t\t\t\t\tan\n-              <literal>E</literal>\n-              command.\n+              The extension entered will be considered complete when a\n+              <literal>#</literal>\n+              is entered.\n             </para>\n           </option>\n         </optionlist>\n       </parameter>\n     </syntax>\n     <description>\n       <para>\n-        Either forks a process to run given command or makes a socket to connect\n-\t\t\tto given host and starts a generator on the channel. The generator's play list\n-\t\t\tis controlled by the external application, which can add and clear entries via\n-\t\t\tsimple commands issued over its stdout. The external application will receive\n-\t\t\tall DTMF events received on the channel, and notification if the channel is\n-\t\t\thung up. The received on the channel, and notification if the channel is hung\n-\t\t\tup. The application will not be forcibly terminated when the channel is hung up.\n-\t\t\tFor more information see\n-        <filename>doc/AST.pdf</filename>\n-        .\n+        The DISA, Direct Inward System Access, application allows someone from\n+\t\t\toutside the telephone switch (PBX) to obtain an\n+        <emphasis>internal</emphasis>\n+        system\n+\t\t\tdialtone and to place calls from it as if they were placing a call from\n+\t\t\twithin the switch.\n+\t\t\tDISA plays a dialtone. The user enters their numeric passcode, followed by\n+\t\t\tthe pound sign\n+        <literal>#</literal>\n+        . If the passcode is correct, the user is then given\n+\t\t\tsystem dialtone within\n+        <replaceable>context</replaceable>\n+        on which a call may be placed.\n+\t\t\tIf the user enters an invalid extension and extension\n+        <literal>i</literal>\n+        exists in the specified\n+        <replaceable>context</replaceable>\n+        , it will be used.\n       </para>\n-    </description>\n-  </application>\n-  <module language=\"en_US\" name=\"app_dictate\">\n-    <support_level>extended</support_level>\n-  </module>\n-  <application name=\"Dictate\" language=\"en_US\">\n-    <synopsis>Virtual Dictation Machine.</synopsis>\n-    <syntax>\n-      <parameter name=\"base_dir\"/>\n-      <parameter name=\"filename\"/>\n-    </syntax>\n-    <description>\n+      <para>Be aware that using this may compromise the security of your PBX.</para>\n       <para>\n-        Start dictation machine using optional\n-        <replaceable>base_dir</replaceable>\n-        for files.\n+        The arguments to this application (in\n+        <filename>extensions.conf</filename>\n+        ) allow either\n+\t\t\tspecification of a single global\n+        <replaceable>passcode</replaceable>\n+        (that everyone uses), or\n+\t\t\tindividual passcodes contained in a file (\n+        <replaceable>filename</replaceable>\n+        ).\n+      </para>\n+      <para>\n+        The file that contains the passcodes (if used) allows a complete\n+\t\t\tspecification of all of the same arguments available on the command\n+\t\t\tline, with the sole exception of the options. The file may contain blank\n+\t\t\tlines, or comments starting with\n+        <literal>#</literal>\n+        or\n+        <literal>;</literal>\n+        .\n       </para>\n     </description>\n+    <see-also>\n+      <ref type=\"application\">Authenticate</ref>\n+      <ref type=\"application\">VMAuthenticate</ref>\n+    </see-also>\n   </application>\n-  <module language=\"en_US\" name=\"app_userevent\">\n-    <support_level>core</support_level>\n+  <module language=\"en_US\" name=\"app_url\">\n+    <support_level>deprecated</support_level>\n+    <deprecated_in>16</deprecated_in>\n+    <removed_in>19</removed_in>\n   </module>\n-  <application name=\"UserEvent\" language=\"en_US\">\n-    <synopsis>Send an arbitrary user-defined event to parties interested in a channel (AMI users and relevant res_stasis applications).</synopsis>\n+  <application name=\"SendURL\" language=\"en_US\">\n+    <synopsis>Send a URL.</synopsis>\n     <syntax>\n-      <parameter name=\"eventname\" required=\"true\"/>\n-      <parameter name=\"body\"/>\n+      <parameter name=\"URL\" required=\"true\"/>\n+      <parameter name=\"option\">\n+        <optionlist>\n+          <option name=\"w\">\n+            <para>Execution will wait for an acknowledgement that the\n+\t\t\t\t\t\tURL has been loaded before continuing.</para>\n+          </option>\n+        </optionlist>\n+      </parameter>\n     </syntax>\n     <description>\n       <para>\n-        Sends an arbitrary event to interested parties, with an optional\n-        <replaceable>body</replaceable>\n-        representing additional arguments. The\n-        <replaceable>body</replaceable>\n-        may be specified as\n-\t\t\ta\n-        <literal>,</literal>\n-        delimited list of key:value pairs.\n-      </para>\n-      <para>For AMI, each additional argument will be placed on a new line in\n-\t\t\tthe event and the format of the event will be:</para>\n-      <para>Event: UserEvent</para>\n-      <para>UserEvent: &lt;specified event name&gt;</para>\n-      <para>[body]</para>\n-      <para>\n-        If no\n-        <replaceable>body</replaceable>\n-        is specified, only Event and\n-\t\t\tUserEvent headers will be present.\n+        Requests client go to\n+        <replaceable>URL</replaceable>\n+        (IAX2) or sends the\n+\t\t\tURL to the client (other channels).\n       </para>\n       <para>\n-        For res_stasis applications, the event will be provided as a JSON\n-\t\t\tblob with additional arguments appearing as keys in the object and the\n-        <replaceable>eventname</replaceable>\n-        under the\n-        <literal>eventname</literal>\n-        key.\n+        Result is returned in the\n+        <variable>SENDURLSTATUS</variable>\n+        channel variable:\n       </para>\n+      <variablelist>\n+        <variable name=\"SENDURLSTATUS\">\n+          <value name=\"SUCCESS\">URL successfully sent to client.</value>\n+          <value name=\"FAILURE\">Failed to send URL.</value>\n+          <value name=\"NOLOAD\">Client failed to load URL (wait enabled).</value>\n+          <value name=\"UNSUPPORTED\">Channel does not support URL transport.</value>\n+        </variable>\n+      </variablelist>\n+      <para>SendURL continues normally if the URL was sent correctly or if the channel\n+\t\t\tdoes not support HTML transport.  Otherwise, the channel is hung up.</para>\n     </description>\n     <see-also>\n-      <ref type=\"manager\">UserEvent</ref>\n-      <ref type=\"managerEvent\">UserEvent</ref>\n+      <ref type=\"application\">SendImage</ref>\n+      <ref type=\"application\">SendText</ref>\n     </see-also>\n   </application>\n-  <module language=\"en_US\" name=\"app_blind_transfer\">\n+  <module language=\"en_US\" name=\"app_mp3\">\n     <support_level>extended</support_level>\n   </module>\n-  <application name=\"BlindTransfer\" language=\"en_US\">\n-    <synopsis>Blind transfer channel(s) to the extension and context provided</synopsis>\n+  <application name=\"MP3Player\" language=\"en_US\">\n+    <synopsis>Play an MP3 file or M3U playlist file or stream.</synopsis>\n     <syntax>\n-      <parameter name=\"exten\" required=\"true\">\n-        <para>Specify extension.</para>\n-      </parameter>\n-      <parameter name=\"context\">\n-        <para>Optionally specify a context.\n-\t\t\t\tBy default, Asterisk will use the caller channel context.</para>\n+      <parameter name=\"Location\" required=\"true\">\n+        <para>Location of the file to be played.\n+\t\t\t\t(argument passed to mpg123)</para>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>Redirect all channels currently bridged to the caller channel to the\n-\t\t\tspecified destination.</para>\n-      <para>\n-        The result of the application will be reported in the\n-        <variable>BLINDTRANSFERSTATUS</variable>\n-        channel variable:\n-      </para>\n-      <variablelist>\n-        <variable name=\"BLINDTRANSFERSTATUS\">\n-          <value name=\"SUCCESS\">Transfer succeeded.</value>\n-          <value name=\"FAILURE\">Transfer failed.</value>\n-          <value name=\"INVALID\">Transfer invalid.</value>\n-          <value name=\"NOTPERMITTED\">Transfer not permitted.</value>\n-        </variable>\n-      </variablelist>\n+      <para>Executes mpg123 to play the given location, which typically would be a mp3 filename\n+\t\t\tor m3u playlist filename or a URL. Please read https://en.wikipedia.org/wiki/M3U\n+\t\t\tto see what the M3U playlist file format is like.</para>\n+      <para>Note that mpg123 does not support HTTPS, so use HTTP for web streams.</para>\n+      <para>User can exit by pressing any key on the dialpad, or by hanging up.</para>\n+      <example title=\"Play an MP3 playlist\">exten =&gt; 1234,1,MP3Player(/var/lib/asterisk/playlist.m3u)</example>\n+      <para>This application does not automatically answer and should be preceeded by an\n+\t\t\tapplication such as Answer() or Progress().</para>\n     </description>\n   </application>\n-  <module language=\"en_US\" name=\"conf_state\">\n-    <support_level>core</support_level>\n-  </module>\n-  <managerEvent language=\"en_US\" name=\"ConfbridgeStart\">\n-    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n-      <synopsis>Raised when a conference starts.</synopsis>\n-      <syntax>\n-        <parameter name=\"Conference\">\n-          <para>The name of the Confbridge conference.</para>\n-        </parameter>\n-        <bridge_snapshot/>\n-      </syntax>\n-      <see-also>\n-        <ref type=\"managerEvent\">ConfbridgeEnd</ref>\n-        <ref type=\"application\">ConfBridge</ref>\n-      </see-also>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <managerEvent language=\"en_US\" name=\"ConfbridgeEnd\">\n-    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n-      <synopsis>Raised when a conference ends.</synopsis>\n-      <syntax>\n-        <parameter name=\"Conference\">\n-          <para>The name of the Confbridge conference.</para>\n-        </parameter>\n-        <bridge_snapshot/>\n-      </syntax>\n-      <see-also>\n-        <ref type=\"managerEvent\">ConfbridgeStart</ref>\n-        <ref type=\"application\">ConfBridge</ref>\n-      </see-also>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <managerEvent language=\"en_US\" name=\"ConfbridgeJoin\">\n-    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n-      <synopsis>Raised when a channel joins a Confbridge conference.</synopsis>\n-      <syntax>\n-        <parameter name=\"Conference\">\n-          <para>The name of the Confbridge conference.</para>\n-        </parameter>\n-        <bridge_snapshot/>\n-        <channel_snapshot/>\n-        <parameter name=\"Admin\">\n-          <para>Identifies this user as an admin user.</para>\n-          <enumlist>\n-            <enum name=\"Yes\"/>\n-            <enum name=\"No\"/>\n-          </enumlist>\n-        </parameter>\n-        <parameter name=\"Muted\">\n-          <para>The joining mute status.</para>\n-          <enumlist>\n-            <enum name=\"Yes\"/>\n-            <enum name=\"No\"/>\n-          </enumlist>\n-        </parameter>\n-      </syntax>\n-      <see-also>\n-        <ref type=\"managerEvent\">ConfbridgeLeave</ref>\n-        <ref type=\"application\">ConfBridge</ref>\n-      </see-also>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <managerEvent language=\"en_US\" name=\"ConfbridgeLeave\">\n-    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n-      <synopsis>Raised when a channel leaves a Confbridge conference.</synopsis>\n-      <syntax>\n-        <parameter name=\"Conference\">\n-          <para>The name of the Confbridge conference.</para>\n-        </parameter>\n-        <bridge_snapshot/>\n-        <channel_snapshot/>\n-        <parameter name=\"Admin\">\n-          <para>Identifies this user as an admin user.</para>\n-          <enumlist>\n-            <enum name=\"Yes\"/>\n-            <enum name=\"No\"/>\n-          </enumlist>\n-        </parameter>\n-      </syntax>\n-      <see-also>\n-        <ref type=\"managerEvent\">ConfbridgeJoin</ref>\n-        <ref type=\"application\">ConfBridge</ref>\n-      </see-also>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <managerEvent language=\"en_US\" name=\"ConfbridgeRecord\">\n-    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n-      <synopsis>Raised when a conference starts recording.</synopsis>\n-      <syntax>\n-        <parameter name=\"Conference\">\n-          <para>The name of the Confbridge conference.</para>\n-        </parameter>\n-        <bridge_snapshot/>\n-      </syntax>\n-      <see-also>\n-        <ref type=\"managerEvent\">ConfbridgeStopRecord</ref>\n-        <ref type=\"application\">ConfBridge</ref>\n-      </see-also>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <managerEvent language=\"en_US\" name=\"ConfbridgeStopRecord\">\n-    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n-      <synopsis>Raised when a conference that was recording stops recording.</synopsis>\n-      <syntax>\n-        <parameter name=\"Conference\">\n-          <para>The name of the Confbridge conference.</para>\n-        </parameter>\n-        <bridge_snapshot/>\n-      </syntax>\n-      <see-also>\n-        <ref type=\"managerEvent\">ConfbridgeRecord</ref>\n-        <ref type=\"application\">ConfBridge</ref>\n-      </see-also>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <managerEvent language=\"en_US\" name=\"ConfbridgeMute\">\n-    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n-      <synopsis>Raised when a Confbridge participant mutes.</synopsis>\n-      <syntax>\n-        <parameter name=\"Conference\">\n-          <para>The name of the Confbridge conference.</para>\n-        </parameter>\n-        <bridge_snapshot/>\n-        <channel_snapshot/>\n-        <parameter name=\"Admin\">\n-          <para>Identifies this user as an admin user.</para>\n-          <enumlist>\n-            <enum name=\"Yes\"/>\n-            <enum name=\"No\"/>\n-          </enumlist>\n-        </parameter>\n-      </syntax>\n-      <see-also>\n-        <ref type=\"managerEvent\">ConfbridgeUnmute</ref>\n-        <ref type=\"application\">ConfBridge</ref>\n-      </see-also>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <managerEvent language=\"en_US\" name=\"ConfbridgeUnmute\">\n-    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n-      <synopsis>Raised when a confbridge participant unmutes.</synopsis>\n-      <syntax>\n-        <parameter name=\"Conference\">\n-          <para>The name of the Confbridge conference.</para>\n-        </parameter>\n-        <bridge_snapshot/>\n-        <channel_snapshot/>\n-        <parameter name=\"Admin\">\n-          <para>Identifies this user as an admin user.</para>\n-          <enumlist>\n-            <enum name=\"Yes\"/>\n-            <enum name=\"No\"/>\n-          </enumlist>\n-        </parameter>\n-      </syntax>\n-      <see-also>\n-        <ref type=\"managerEvent\">ConfbridgeMute</ref>\n-        <ref type=\"application\">ConfBridge</ref>\n-      </see-also>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <managerEvent language=\"en_US\" name=\"ConfbridgeTalking\">\n-    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n-      <synopsis>Raised when a confbridge participant begins or ends talking.</synopsis>\n-      <syntax>\n-        <parameter name=\"Conference\">\n-          <para>The name of the Confbridge conference.</para>\n-        </parameter>\n-        <bridge_snapshot/>\n-        <channel_snapshot/>\n-        <parameter name=\"TalkingStatus\">\n-          <enumlist>\n-            <enum name=\"on\"/>\n-            <enum name=\"off\"/>\n-          </enumlist>\n-        </parameter>\n-        <parameter name=\"Admin\">\n-          <para>Identifies this user as an admin user.</para>\n-          <enumlist>\n-            <enum name=\"Yes\"/>\n-            <enum name=\"No\"/>\n-          </enumlist>\n-        </parameter>\n-      </syntax>\n-      <see-also>\n-        <ref type=\"application\">ConfBridge</ref>\n-      </see-also>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <module language=\"en_US\" name=\"conf_state_multi_marked\">\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"conf_state_multi\">\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"conf_state_single_marked\">\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"conf_config_parser\">\n-    <support_level>core</support_level>\n-  </module>\n-  <configInfo name=\"app_confbridge\" language=\"en_US\">\n-    <synopsis>Conference Bridge Application</synopsis>\n-    <configFile name=\"confbridge.conf\">\n-      <configObject name=\"global\">\n-        <synopsis>Unused, but reserved.</synopsis>\n-      </configObject>\n-      <configObject name=\"user_profile\">\n-        <synopsis>A named profile to apply to specific callers.</synopsis>\n-        <description>\n-          <para>\n-            Callers in a ConfBridge have a profile associated with them\n-\t\t\t\tthat determine their options. A configuration section is determined to be a\n-\t\t\t\tuser_profile when the\n-            <literal>type</literal>\n-            parameter has a value\n-\t\t\t\tof\n-            <literal>user</literal>\n-            .\n-          </para>\n-        </description>\n-        <configOption name=\"type\">\n-          <synopsis>Define this configuration category as a user profile.</synopsis>\n-          <description>\n-            <para>The type parameter determines how a context in the\n-\t\t\t\t\tconfiguration file is interpreted.</para>\n-            <enumlist>\n-              <enum name=\"user\">\n-                <para>\n-                  Configure the context as a\n-                  <replaceable>user_profile</replaceable>\n-                </para>\n-              </enum>\n-              <enum name=\"bridge\">\n-                <para>\n-                  Configure the context as a\n-                  <replaceable>bridge_profile</replaceable>\n-                </para>\n-              </enum>\n-              <enum name=\"menu\">\n-                <para>\n-                  Configure the context as a\n-                  <replaceable>menu</replaceable>\n-                </para>\n-              </enum>\n-            </enumlist>\n-          </description>\n-        </configOption>\n-        <configOption name=\"admin\">\n-          <synopsis>Sets if the user is an admin or not</synopsis>\n-        </configOption>\n-        <configOption name=\"send_events\" default=\"no\">\n-          <synopsis>Sets if events are send to the user</synopsis>\n-          <description>\n-            <para>If events are enabled for this bridge and this option is\n-\t\t\t\t\tset, users will receive events like join, leave, talking, etc. via text\n-\t\t\t\t\tmessages.  For users accessing the bridge via chan_pjsip, this means\n-\t\t\t\t\tin-dialog MESSAGE messages.  This is most useful for WebRTC participants\n-\t\t\t\t\twhere the browser application can use the messages to alter the user\n-\t\t\t\t\tinterface.</para>\n-          </description>\n-        </configOption>\n-        <configOption name=\"echo_events\" default=\"yes\">\n-          <synopsis>Sets if events are echoed back to the user that\n-\t\t\t\t\ttriggered them</synopsis>\n-          <description>\n-            <para>If events are enabled for this user and this option\n-\t\t\t\t\tis set, the user will receive events they trigger, talking, mute, etc.\n-\t\t\t\t\tIf not set, they will not receive their own events.</para>\n-          </description>\n-        </configOption>\n-        <configOption name=\"marked\">\n-          <synopsis>Sets if this is a marked user or not</synopsis>\n-        </configOption>\n-        <configOption name=\"startmuted\">\n-          <synopsis>Sets if all users should start out muted</synopsis>\n-        </configOption>\n-        <configOption name=\"music_on_hold_when_empty\">\n-          <synopsis>Play MOH when user is alone or waiting on a marked user</synopsis>\n-        </configOption>\n-        <configOption name=\"quiet\">\n-          <synopsis>Silence enter/leave prompts and user intros for this user</synopsis>\n-        </configOption>\n-        <configOption name=\"hear_own_join_sound\">\n-          <synopsis>Determines if the user also hears the join sound when they enter a conference</synopsis>\n-        </configOption>\n-        <configOption name=\"announce_user_count\">\n-          <synopsis>Sets if the number of users should be announced to the user</synopsis>\n-        </configOption>\n-        <configOption name=\"announce_user_count_all\">\n-          <synopsis>Announce user count to all the other users when this user joins</synopsis>\n-          <description>\n-            <para>Sets if the number of users should be announced to all the other users\n-\t\t\t\t\tin the conference when this user joins. This option can be either set to 'yes' or\n-\t\t\t\t\ta number. When set to a number, the announcement will only occur once the user\n-\t\t\t\t\tcount is above the specified number.</para>\n-          </description>\n-        </configOption>\n-        <configOption name=\"announce_only_user\">\n-          <synopsis>Announce to a user when they join an empty conference</synopsis>\n-        </configOption>\n-        <configOption name=\"wait_marked\">\n-          <synopsis>Sets if the user must wait for a marked user to enter before joining a conference</synopsis>\n-        </configOption>\n-        <configOption name=\"end_marked\">\n-          <synopsis>Kick the user from the conference when the last marked user leaves</synopsis>\n-        </configOption>\n-        <configOption name=\"talk_detection_events\">\n-          <synopsis>Set whether or not notifications of when a user begins and ends talking should be sent out as events over AMI</synopsis>\n-        </configOption>\n-        <configOption name=\"dtmf_passthrough\">\n-          <synopsis>Sets whether or not DTMF should pass through the conference</synopsis>\n-        </configOption>\n-        <configOption name=\"announce_join_leave\">\n-          <synopsis>Prompt user for their name when joining a conference and play it to the conference when they enter</synopsis>\n-        </configOption>\n-        <configOption name=\"announce_join_leave_review\">\n-          <synopsis>Prompt user for their name when joining a conference and play it to the conference when they enter.\n-\t\t\t\t\tThe user will be asked to review the recording of their name before entering the conference.</synopsis>\n-        </configOption>\n-        <configOption name=\"pin\">\n-          <synopsis>Sets a PIN the user must enter before joining the conference</synopsis>\n-        </configOption>\n-        <configOption name=\"music_on_hold_class\">\n-          <synopsis>The MOH class to use for this user</synopsis>\n-        </configOption>\n-        <configOption name=\"announcement\">\n-          <synopsis>Sound file to play to the user when they join a conference</synopsis>\n-        </configOption>\n-        <configOption name=\"denoise\">\n-          <synopsis>Apply a denoise filter to the audio before mixing</synopsis>\n-          <description>\n-            <para>\n-              Sets whether or not a denoise filter should be applied\n-\t\t\t\t\tto the audio before mixing or not.  Off by default. Requires\n-              <literal>codec_speex</literal>\n-              to be built and installed.  Do not confuse this option\n-\t\t\t\t\twith\n-              <replaceable>drop_silence</replaceable>\n-              .  Denoise is useful if there is a lot of background\n-\t\t\t\t\tnoise for a user as it attempts to remove the noise while preserving\n-\t\t\t\t\tthe speech.  This option does NOT remove silence from being mixed into\n-\t\t\t\t\tthe conference and does come at the cost of a slight performance hit.\n-            </para>\n-          </description>\n-        </configOption>\n-        <configOption name=\"dsp_drop_silence\">\n-          <synopsis>Drop what Asterisk detects as silence from audio sent to the bridge</synopsis>\n-          <description>\n-            <para>This option drops what Asterisk detects as silence from\n-\t\t\t\t\tentering into the bridge.  Enabling this option will drastically\n-\t\t\t\t\timprove performance and help remove the buildup of background\n-\t\t\t\t\tnoise from the conference. Highly recommended for large conferences\n-\t\t\t\t\tdue to its performance enhancements.</para>\n-          </description>\n-        </configOption>\n-        <configOption name=\"dsp_silence_threshold\">\n-          <synopsis>The number of milliseconds of silence necessary to declare talking stopped.</synopsis>\n-          <description>\n-            <para>\n-              The time in milliseconds of sound falling below the\n-              <replaceable>dsp_talking_threshold</replaceable>\n-              option when\n-\t\t\t\t\t\ta user is considered to stop talking.  This value affects several\n-\t\t\t\t\t\toperations and should not be changed unless the impact on call\n-\t\t\t\t\t\tquality is fully understood.\n-            </para>\n-            <para>What this value affects internally:</para>\n-            <para>1. When talk detection AMI events are enabled, this value\n-\t\t\t\t\t\tdetermines when the user has stopped talking after a\n-\t\t\t\t\t\tperiod of talking.  If this value is set too low\n-\t\t\t\t\t\tAMI events indicating the user has stopped talking\n-\t\t\t\t\t\tmay get falsely sent out when the user briefly pauses\n-\t\t\t\t\t\tduring mid sentence.</para>\n-            <para>\n-              2. The\n-              <replaceable>drop_silence</replaceable>\n-              option\n-\t\t\t\t\t\tdepends on this value to determine when the user's audio should\n-\t\t\t\t\t\tbegin to be dropped from the conference bridge after the user\n-\t\t\t\t\t\tstops talking.  If this value is set too low the user's\n-\t\t\t\t\t\taudio stream may sound choppy to the other participants.  This\n-\t\t\t\t\t\tis caused by the user transitioning constantly from silence to\n-\t\t\t\t\t\ttalking during mid sentence.\n-            </para>\n-            <para>The best way to approach this option is to set it slightly\n-\t\t\t\t\t\tabove the maximum amount of milliseconds of silence a user may\n-\t\t\t\t\t\tgenerate during natural speech.</para>\n-            <para>Valid values are 1 through 2^31.</para>\n-          </description>\n-        </configOption>\n-        <configOption name=\"dsp_talking_threshold\">\n-          <synopsis>Average magnitude threshold to determine talking.</synopsis>\n-          <description>\n-            <para>The minimum average magnitude per sample in a frame\n-\t\t\t\t\t\tfor the DSP to consider talking/noise present.  A value below\n-\t\t\t\t\t\tthis level is considered silence.  This value affects several\n-\t\t\t\t\t\toperations and should not be changed unless the impact on call\n-\t\t\t\t\t\tquality is fully understood.</para>\n-            <para>What this value affects internally:</para>\n-            <para>1. Audio is only mixed out of a user's incoming audio\n-\t\t\t\t\t\tstream if talking is detected.  If this value is set too\n-\t\t\t\t\t\thigh the user will hear himself talking.</para>\n-            <para>2. When talk detection AMI events are enabled, this value\n-\t\t\t\t\t\tdetermines when talking has begun which results in\n-\t\t\t\t\t\tan AMI event to fire.  If this value is set too low\n-\t\t\t\t\t\tAMI events may be falsely triggered by variants in\n-\t\t\t\t\t\troom noise.</para>\n-            <para>\n-              3. The\n-              <replaceable>drop_silence</replaceable>\n-              option\n-\t\t\t\t\t\tdepends on this value to determine when the user's audio should\n-\t\t\t\t\t\tbe mixed into the bridge after periods of silence.  If this value\n-\t\t\t\t\t\tis too high the user's speech will get discarded as they will\n-\t\t\t\t\t\tbe considered silent.\n-            </para>\n-            <para>Valid values are 1 through 2^15.</para>\n-          </description>\n-        </configOption>\n-        <configOption name=\"jitterbuffer\">\n-          <synopsis>Place a jitter buffer on the user's audio stream before audio mixing is performed</synopsis>\n-          <description>\n-            <para>\n-              Enabling this option places a jitterbuffer on the user's audio stream\n-\t\t\t\t\t\tbefore audio mixing is performed.  This is highly recommended but will\n-\t\t\t\t\t\tadd a slight delay to the audio.  This option is using the\n-              <literal>JITTERBUFFER</literal>\n-              dialplan function's default adaptive jitterbuffer.  For a more fine tuned\n-\t\t\t\t\t\tjitterbuffer, disable this option and use the\n-              <literal>JITTERBUFFER</literal>\n-              dialplan function\n-\t\t\t\t\t\ton the user before entering the ConfBridge application.\n-            </para>\n-          </description>\n-        </configOption>\n-        <configOption name=\"template\">\n-          <synopsis>When using the CONFBRIDGE dialplan function, use a user profile as a template for creating a new temporary profile</synopsis>\n-        </configOption>\n-        <configOption name=\"timeout\">\n-          <synopsis>Kick the user out of the conference after this many seconds. 0 means there is no timeout for the user.</synopsis>\n-        </configOption>\n-        <configOption name=\"text_messaging\" default=\"yes\">\n-          <synopsis>Sets if text messages are sent to the user.</synopsis>\n-          <description>\n-            <para>If text messaging is enabled for this user then\n-\t\t\t\t\ttext messages will be sent to it. These may be events or from other\n-\t\t\t\t\tparticipants in the conference bridge. If disabled then no text\n-\t\t\t\t\tmessages are sent to the user.</para>\n-          </description>\n-        </configOption>\n-        <configOption name=\"answer_channel\" default=\"yes\">\n-          <synopsis>Sets if a user's channel should be answered if currently unanswered.</synopsis>\n-        </configOption>\n-      </configObject>\n-      <configObject name=\"bridge_profile\">\n-        <synopsis>A named profile to apply to specific bridges.</synopsis>\n-        <description>\n-          <para>\n-            ConfBridge bridges have a profile associated with them\n-\t\t\t\tthat determine their options. A configuration section is determined to be a\n-            <literal>bridge_profile</literal>\n-            when the\n-            <literal>type</literal>\n-            parameter has a value\n-\t\t\t\tof\n-            <literal>bridge</literal>\n-            .\n-          </para>\n-        </description>\n-        <configOption name=\"type\">\n-          <synopsis>Define this configuration category as a bridge profile</synopsis>\n-          <description>\n-            <para>The type parameter determines how a context in the\n-\t\t\t\t\tconfiguration file is interpreted.</para>\n-            <enumlist>\n-              <enum name=\"user\">\n-                <para>\n-                  Configure the context as a\n-                  <replaceable>user_profile</replaceable>\n-                </para>\n-              </enum>\n-              <enum name=\"bridge\">\n-                <para>\n-                  Configure the context as a\n-                  <replaceable>bridge_profile</replaceable>\n-                </para>\n-              </enum>\n-              <enum name=\"menu\">\n-                <para>\n-                  Configure the context as a\n-                  <replaceable>menu</replaceable>\n-                </para>\n-              </enum>\n-            </enumlist>\n-          </description>\n-        </configOption>\n-        <configOption name=\"jitterbuffer\">\n-          <synopsis>Place a jitter buffer on the conference's audio stream</synopsis>\n-        </configOption>\n-        <configOption name=\"internal_sample_rate\">\n-          <synopsis>Set the internal native sample rate for mixing the conference</synopsis>\n-          <description>\n-            <para>Sets the internal native sample rate the\n-\t\t\t\t\t\tconference is mixed at.  This is set to automatically\n-\t\t\t\t\t\tadjust the sample rate to the best quality by default.\n-\t\t\t\t\t\tOther values can be anything from 8000-192000.  If a\n-\t\t\t\t\t\tsample rate is set that Asterisk does not support, the\n-\t\t\t\t\t\tclosest sample rate Asterisk does support to the one requested\n-\t\t\t\t\t\twill be used.</para>\n-          </description>\n-        </configOption>\n-        <configOption name=\"maximum_sample_rate\">\n-          <synopsis>Set the maximum native sample rate for mixing the conference</synopsis>\n-          <description>\n-            <para>Sets the maximum native sample rate the\n-\t\t\t\t\t\tconference is mixed at. This is set to not have a\n-\t\t\t\t\t\tmaximum by default. If a sample rate is specified,\n-\t\t\t\t\t\tthough, the native sample rate will never exceed it.</para>\n-          </description>\n-        </configOption>\n-        <configOption name=\"language\" default=\"en\">\n-          <synopsis>The language used for announcements to the conference.</synopsis>\n-          <description>\n-            <para>By default, announcements to a conference use English.  Which means\n-\t\t\t\t\t\tthe prompts played to all users within the conference will be\n-\t\t\t\t\t\tEnglish.  By changing the language of a bridge, this will change\n-\t\t\t\t\t\tthe language of the prompts played to all users.</para>\n-          </description>\n-        </configOption>\n-        <configOption name=\"mixing_interval\">\n-          <synopsis>Sets the internal mixing interval in milliseconds for the bridge</synopsis>\n-          <description>\n-            <para>Sets the internal mixing interval in milliseconds for the bridge.  This\n-\t\t\t\t\t\tnumber reflects how tight or loose the mixing will be for the conference.\n-\t\t\t\t\t\tIn order to improve performance a larger mixing interval such as 40ms may\n-\t\t\t\t\t\tbe chosen.  Using a larger mixing interval comes at the cost of introducing\n-\t\t\t\t\t\tlarger amounts of delay into the bridge.  Valid values here are 10, 20, 40,\n-\t\t\t\t\t\tor 80.</para>\n-          </description>\n-        </configOption>\n-        <configOption name=\"binaural_active\">\n-          <synopsis>If true binaural conferencing with stereo audio is active</synopsis>\n-          <description>\n-            <para>Activates binaural mixing for a conference bridge.\n-\t\t\t\t\t\tBinaural features are disabled by default.</para>\n-          </description>\n-        </configOption>\n-        <configOption name=\"record_conference\">\n-          <synopsis>Record the conference starting with the first active user's entrance and ending with the last active user's exit</synopsis>\n-          <description>\n-            <para>\n-              Records the conference call starting when the first user\n-\t\t\t\t\t\tenters the room, and ending when the last user exits the room.\n-\t\t\t\t\t\tThe default recorded filename is\n-              <filename>'confbridge-${name of conference bridge}-${start time}.wav'</filename>\n-              and the default format is 8khz slinear.  This file will be\n-\t\t\t\t\t\tlocated in the configured monitoring directory in\n-              <filename>asterisk.conf</filename>\n-              .\n-            </para>\n-          </description>\n-        </configOption>\n-        <configOption name=\"record_file\" default=\"confbridge-${name of conference bridge}-${start time}.wav\">\n-          <synopsis>The filename of the conference recording</synopsis>\n-          <description>\n-            <para>\n-              When\n-              <replaceable>record_conference</replaceable>\n-              is set to yes, the specific name of the\n-\t\t\t\t\t\trecord file can be set using this option.  Note that since multiple\n-\t\t\t\t\t\tconferences may use the same bridge profile, this may cause issues\n-\t\t\t\t\t\tdepending on the configuration.  It is recommended to only use this\n-\t\t\t\t\t\toption dynamically with the\n-              <literal>CONFBRIDGE()</literal>\n-              dialplan function. This\n-\t\t\t\t\t\tallows the record name to be specified and a unique name to be chosen.\n-\t\t\t\t\t\tBy default, the record_file is stored in Asterisk's spool/monitor directory\n-\t\t\t\t\t\twith a unique filename starting with the 'confbridge' prefix.\n-            </para>\n-          </description>\n-        </configOption>\n-        <configOption name=\"record_file_append\" default=\"yes\">\n-          <synopsis>Append to record file when starting/stopping on same conference recording</synopsis>\n-          <description>\n-            <para>\n-              When\n-              <replaceable>record_file_append</replaceable>\n-              is set to yes, stopping and starting recording on a\n-\t\t\t\t\t\tconference adds the new portion to end of current record_file. When this is\n-\t\t\t\t\t\tset to no, a new\n-              <replaceable>record_file</replaceable>\n-              is generated every time you start then stop recording\n-\t\t\t\t\t\ton a conference.\n-            </para>\n-          </description>\n-        </configOption>\n-        <configOption name=\"record_file_timestamp\" default=\"yes\">\n-          <synopsis>Append the start time to the record_file name so that it is unique.</synopsis>\n-          <description>\n-            <para>\n-              When\n-              <replaceable>record_file_timestamp</replaceable>\n-              is set to yes, the start time is appended to\n-              <replaceable>record_file</replaceable>\n-              so that the filename is unique. This allows you to specify\n-\t\t\t\t\t\ta\n-              <replaceable>record_file</replaceable>\n-              but not overwrite existing recordings.\n-            </para>\n-          </description>\n-        </configOption>\n-        <configOption name=\"record_options\" default=\"\">\n-          <synopsis>Pass additional options to MixMonitor when recording</synopsis>\n-          <description>\n-            <para>\n-              Pass additional options to MixMonitor when\n-              <replaceable>record_conference</replaceable>\n-              is set to yes.\n-\t\t\t\t\t\tSee\n-              <literal>MixMonitor</literal>\n-              for available options.\n-            </para>\n-          </description>\n-        </configOption>\n-        <configOption name=\"record_command\" default=\"\">\n-          <synopsis>Execute a command after recording ends</synopsis>\n-          <description>\n-            <para>\n-              Executes the specified command when recording ends. Any strings matching\n-              <literal>^{X}</literal>\n-              will be\n-\t\t\t\t\t\tunescaped to\n-              <variable>X</variable>\n-              . All variables will be evaluated at the time ConfBridge is called.\n-            </para>\n-          </description>\n-        </configOption>\n-        <configOption name=\"regcontext\">\n-          <synopsis>The name of the context into which to register the name of the conference bridge as NoOP() at priority 1</synopsis>\n-          <description>\n-            <para>When set this will cause the name of the created conference to be registered\n-\t\t\t\t\t\tinto the named context at priority 1 with an operation of NoOP().  This can\n-\t\t\t\t\t\tthen be used in other parts of the dialplan to test for the existence of a\n-\t\t\t\t\t\tspecific conference bridge.\n-\t\t\t\t\t\tYou should be aware that there are potential races between testing for the\n-\t\t\t\t\t\texistence of a bridge, and taking action upon that information, consider\n-\t\t\t\t\t\tfor example two callers executing the check simultaneously, and then taking\n-\t\t\t\t\t\tspecial action as &quot;first caller&quot; into the bridge.  The same for exiting,\n-\t\t\t\t\t\tdirectly after the check the bridge can be destroyed before the new caller\n-\t\t\t\t\t\tenters (creating a new bridge), for example, and the &quot;first member&quot; actions\n-\t\t\t\t\t\tcould thus be missed.</para>\n-          </description>\n-        </configOption>\n-        <configOption name=\"video_mode\">\n-          <synopsis>Sets how confbridge handles video distribution to the conference participants</synopsis>\n-          <description>\n-            <para>\n-              Sets how confbridge handles video distribution to the conference participants.\n-\t\t\t\t\t\tNote that participants wanting to view and be the source of a video feed\n-              <emphasis>MUST</emphasis>\n-              be sharing the same video codec.  Also, using video in conjunction with\n-\t\t\t\t\t\twith the jitterbuffer currently results in the audio being slightly out of sync\n-\t\t\t\t\t\twith the video.  This is a result of the jitterbuffer only working on the audio\n-\t\t\t\t\t\tstream.  It is recommended to disable the jitterbuffer when video is used.\n-            </para>\n-            <enumlist>\n-              <enum name=\"none\">\n-                <para>No video sources are set by default in the conference. It is still\n-\t\t\t\t\t\t\t\tpossible for a user to be set as a video source via AMI or DTMF action\n-\t\t\t\t\t\t\t\tat any time.</para>\n-              </enum>\n-              <enum name=\"follow_talker\">\n-                <para>The video feed will follow whoever is talking and providing video.</para>\n-              </enum>\n-              <enum name=\"last_marked\">\n-                <para>The last marked user to join the conference with video capabilities\n-\t\t\t\t\t\t\t\twill be the single source of video distributed to all participants.\n-\t\t\t\t\t\t\t\tIf multiple marked users are capable of video, the last one to join\n-\t\t\t\t\t\t\t\tis always the source, when that user leaves it goes to the one who\n-\t\t\t\t\t\t\t\tjoined before them.</para>\n-              </enum>\n-              <enum name=\"first_marked\">\n-                <para>The first marked user to join the conference with video capabilities\n-\t\t\t\t\t\t\t\tis the single source of video distribution among all participants. If\n-\t\t\t\t\t\t\t\tthat user leaves, the marked user to join after them becomes the source.</para>\n-              </enum>\n-              <enum name=\"sfu\">\n-                <para>Selective Forwarding Unit - Sets multi-stream\n-\t\t\t\t\t\t\t\toperation for a multi-party video conference.</para>\n-              </enum>\n-            </enumlist>\n-          </description>\n-        </configOption>\n-        <configOption name=\"max_members\">\n-          <synopsis>Limit the maximum number of participants for a single conference</synopsis>\n-          <description>\n-            <para>This option limits the number of participants for a single\n-\t\t\t\t\t\tconference to a specific number.  By default conferences\n-\t\t\t\t\t\thave no participant limit. After the limit is reached, the\n-\t\t\t\t\t\tconference will be locked until someone leaves.  Note however\n-\t\t\t\t\t\tthat an Admin user will always be alowed to join the conference\n-\t\t\t\t\t\tregardless if this limit is reached or not.</para>\n-          </description>\n-        </configOption>\n-        <configOption name=\"sound_\">\n-          <synopsis>Override the various conference bridge sound files</synopsis>\n-          <description>\n-            <para>\n-              All sounds in the conference are customizable using the bridge profile options below.\n-\t\t\t\t\t\tSimply state the option followed by the filename or full path of the filename after\n-\t\t\t\t\t\tthe option.  Example:\n-              <literal>sound_had_joined=conf-hasjoin</literal>\n-              This will play the\n-              <literal>conf-hasjoin</literal>\n-              sound file found in the sounds directory when announcing someone's name is joining the\n-\t\t\t\t\t\tconference.\n-            </para>\n-            <enumlist>\n-              <enum name=\"sound_join\">\n-                <para>The sound played to everyone when someone enters the conference.</para>\n-              </enum>\n-              <enum name=\"sound_leave\">\n-                <para>The sound played to everyone when someone leaves the conference.</para>\n-              </enum>\n-              <enum name=\"sound_has_joined\">\n-                <para>\n-                  The sound played before announcing someone's name has\n-\t\t\t\t\t\t\t\t\t\tjoined the conference. This is used for user intros.\n-\t\t\t\t\t\t\t\t\t\tExample\n-                  <literal>&quot;_____ has joined the conference&quot;</literal>\n-                </para>\n-              </enum>\n-              <enum name=\"sound_has_left\">\n-                <para>\n-                  The sound played when announcing someone's name has\n-\t\t\t\t\t\t\t\t\t\tleft the conference. This is used for user intros.\n-\t\t\t\t\t\t\t\t\t\tExample\n-                  <literal>&quot;_____ has left the conference&quot;</literal>\n-                </para>\n-              </enum>\n-              <enum name=\"sound_kicked\">\n-                <para>The sound played to a user who has been kicked from the conference.</para>\n-              </enum>\n-              <enum name=\"sound_muted\">\n-                <para>The sound played when the mute option it toggled on.</para>\n-              </enum>\n-              <enum name=\"sound_unmuted\">\n-                <para>The sound played when the mute option it toggled off.</para>\n-              </enum>\n-              <enum name=\"sound_binaural_on\">\n-                <para>The sound played when binaural audio is turned on.</para>\n-              </enum>\n-              <enum name=\"sound_binaural_off\">\n-                <para>The sound played when the binaural audio is turned off.</para>\n-              </enum>\n-              <enum name=\"sound_only_person\">\n-                <para>The sound played when the user is the only person in the conference.</para>\n-              </enum>\n-              <enum name=\"sound_only_one\">\n-                <para>The sound played to a user when there is only one other\n-\t\t\t\t\t\t\t\t\t\tperson is in the conference.</para>\n-              </enum>\n-              <enum name=\"sound_there_are\">\n-                <para>The sound played when announcing how many users there\n-\t\t\t\t\t\t\t\t\t\tare in a conference.</para>\n-              </enum>\n-              <enum name=\"sound_other_in_party\">\n-                <para>\n-                  This file is used in conjunction with\n-                  <literal>sound_there_are</literal>\n-                  when announcing how many users there are in the conference.\n-\t\t\t\t\t\t\t\t\t\tThe sounds are stringed together like this.\n-                  <literal>&quot;sound_there_are&quot; ${number of participants} &quot;sound_other_in_party&quot;</literal>\n-                </para>\n-              </enum>\n-              <enum name=\"sound_place_into_conference\">\n-                <para>The sound played when someone is placed into the conference\n-\t\t\t\t\t\t\t\t\t\tafter waiting for a marked user.</para>\n-              </enum>\n-              <enum name=\"sound_wait_for_leader\">\n-                <para>The sound played when a user is placed into a conference that\n-\t\t\t\t\t\t\t\t\t\tcan not start until a marked user enters.</para>\n-              </enum>\n-              <enum name=\"sound_leader_has_left\">\n-                <para>The sound played when the last marked user leaves the conference.</para>\n-              </enum>\n-              <enum name=\"sound_get_pin\">\n-                <para>The sound played when prompting for a conference pin number.</para>\n-              </enum>\n-              <enum name=\"sound_invalid_pin\">\n-                <para>The sound played when an invalid pin is entered too many times.</para>\n-              </enum>\n-              <enum name=\"sound_locked\">\n-                <para>The sound played to a user trying to join a locked conference.</para>\n-              </enum>\n-              <enum name=\"sound_locked_now\">\n-                <para>The sound played to an admin after toggling the conference to locked mode.</para>\n-              </enum>\n-              <enum name=\"sound_unlocked_now\">\n-                <para>The sound played to an admin after toggling the conference to unlocked mode.</para>\n-              </enum>\n-              <enum name=\"sound_error_menu\">\n-                <para>The sound played when an invalid menu option is entered.</para>\n-              </enum>\n-            </enumlist>\n-          </description>\n-        </configOption>\n-        <configOption name=\"video_update_discard\" default=\"2000\">\n-          <synopsis>Sets the amount of time in milliseconds after sending a video update to discard subsequent video updates</synopsis>\n-          <description>\n-            <para>Sets the amount of time in milliseconds after sending a video update request\n-\t\t\t\t\t\tthat subsequent video updates should be discarded. This means that if we\n-\t\t\t\t\t\tsend a video update we will discard any other video update requests until\n-\t\t\t\t\t\tafter the configured amount of time has elapsed. This prevents flooding of\n-\t\t\t\t\t\tvideo update requests from clients.</para>\n-          </description>\n-        </configOption>\n-        <configOption name=\"remb_send_interval\" default=\"0\">\n-          <synopsis>Sets the interval in milliseconds that a combined REMB frame will be sent to video sources</synopsis>\n-          <description>\n-            <para>Sets the interval in milliseconds that a combined REMB frame will be sent\n-\t\t\t\t\t\tto video sources. This is done by taking all REMB frames that have been\n-\t\t\t\t\t\treceived since the last REMB frame was sent, making a combined value,\n-\t\t\t\t\t\tand sending it to the source. A REMB frame contains receiver estimated\n-\t\t\t\t\t\tmaximum bitrate information. By creating a combined REMB frame the\n-\t\t\t\t\t\tsender of video can be influenced on the bitrate they choose, allowing\n-\t\t\t\t\t\tbetter quality for all receivers.</para>\n-          </description>\n-        </configOption>\n-        <configOption name=\"remb_behavior\" default=\"average\">\n-          <synopsis>Sets how REMB reports are generated from multiple sources</synopsis>\n-          <description>\n-            <para>Sets how REMB reports are combined from multiple sources to form one. A REMB report\n-\t\t\t\t\t\tconsists of information about the receiver estimated maximum bitrate. As a source\n-\t\t\t\t\t\tstream may be forwarded to multiple receivers the reports must be combined into\n-\t\t\t\t\t\ta single one which is sent to the sender.</para>\n-            <enumlist>\n-              <enum name=\"average\">\n-                <para>The average of all estimated maximum bitrates is taken and sent\n-\t\t\t\t\t\t\t\tto the sender.</para>\n-              </enum>\n-              <enum name=\"lowest\">\n-                <para>The lowest estimated maximum bitrate is forwarded to the sender.</para>\n-              </enum>\n-              <enum name=\"highest\">\n-                <para>The highest estimated maximum bitrate is forwarded to the sender.</para>\n-              </enum>\n-              <enum name=\"average_all\">\n-                <para>The average of all estimated maximum bitrates is taken from all\n-\t\t\t\t\t\t\t\treceivers in the bridge and a single value is sent to each sender.</para>\n-              </enum>\n-              <enum name=\"lowest_all\">\n-                <para>The lowest estimated maximum bitrate of all receivers in the bridge\n-\t\t\t\t\t\t\t\tis taken and sent to each sender.</para>\n-              </enum>\n-              <enum name=\"highest_all\">\n-                <para>The highest estimated maximum bitrate of all receivers in the bridge\n-\t\t\t\t\t\t\t\tis taken and sent to each sender.</para>\n-              </enum>\n-              <enum name=\"force\">\n-                <para>\n-                  The bitrate configured in\n-                  <literal>remb_estimated_bitrate</literal>\n-                  is sent to each sender.\n-                </para>\n-              </enum>\n-            </enumlist>\n-          </description>\n-          <see-also>\n-            <ref type=\"configOption\">remb_estimated_bitrate</ref>\n-          </see-also>\n-        </configOption>\n-        <configOption name=\"remb_estimated_bitrate\">\n-          <synopsis>Sets the estimated bitrate sent to each participant in REMB reports</synopsis>\n-          <description>\n-            <para>\n-              When\n-              <literal>remb_behavior</literal>\n-              is set to\n-              <literal>force</literal>\n-              ,\n-\t\t\t\t\t    this options sets the estimated bitrate (in bits per second) sent to each participant\n-\t\t\t\t\t    in REMB reports.\n-            </para>\n-          </description>\n-          <see-also>\n-            <ref type=\"configOption\">remb_behavior</ref>\n-          </see-also>\n-        </configOption>\n-        <configOption name=\"enable_events\" default=\"no\">\n-          <synopsis>Enables events for this bridge</synopsis>\n-          <description>\n-            <para>\n-              If enabled, recipients who joined the bridge via a channel driver\n-\t\t\t\t\t\tthat supports Enhanced Messaging (currently only chan_pjsip) will\n-\t\t\t\t\t\treceive in-dialog messages containing a JSON body describing the\n-\t\t\t\t\t\tevent.  The Content-Type header will be\n-              <literal>text/x-ast-confbridge-event</literal>\n-              .\n-\t\t\t\t\t\tThis feature must also be enabled in user profiles.\n-            </para>\n-          </description>\n-        </configOption>\n-        <configOption name=\"template\">\n-          <synopsis>When using the CONFBRIDGE dialplan function, use a bridge profile as a template for creating a new temporary profile</synopsis>\n-        </configOption>\n-      </configObject>\n-      <configObject name=\"menu\">\n-        <synopsis>A conference user menu</synopsis>\n-        <description>\n-          <para>\n-            Conference users, as defined by a\n-            <replaceable>conf_user</replaceable>\n-            ,\n-\t\t\t\t\tcan have a DTMF menu assigned to their profile when they enter the\n-            <literal>ConfBridge</literal>\n-            application.\n-          </para>\n-        </description>\n-        <configOption name=\"type\">\n-          <synopsis>Define this configuration category as a menu</synopsis>\n-          <description>\n-            <para>The type parameter determines how a context in the\n-\t\t\t\t\tconfiguration file is interpreted.</para>\n-            <enumlist>\n-              <enum name=\"user\">\n-                <para>\n-                  Configure the context as a\n-                  <replaceable>user_profile</replaceable>\n-                </para>\n-              </enum>\n-              <enum name=\"bridge\">\n-                <para>\n-                  Configure the context as a\n-                  <replaceable>bridge_profile</replaceable>\n-                </para>\n-              </enum>\n-              <enum name=\"menu\">\n-                <para>\n-                  Configure the context as a\n-                  <replaceable>menu</replaceable>\n-                </para>\n-              </enum>\n-            </enumlist>\n-          </description>\n-        </configOption>\n-        <configOption name=\"template\">\n-          <synopsis>When using the CONFBRIDGE dialplan function, use a menu profile as a template for creating a new temporary profile</synopsis>\n-        </configOption>\n-        <configOption name=\"^[0-9A-D*#]+$\">\n-          <synopsis>DTMF sequences to assign various confbridge actions to</synopsis>\n-          <description>\n-            <para>The ConfBridge application also has the ability to apply custom DTMF menus to\n-\t\t\t\t\teach channel using the application.  Like the User and Bridge profiles a menu\n-\t\t\t\t\tis passed in to ConfBridge as an argument in the dialplan.</para>\n-            <para>Below is a list of menu actions that can be assigned to a DTMF sequence.</para>\n-            <note>\n-              <para>\n-                To have the first DTMF digit in a sequence be the '#' character, you need to\n-\t\t\t\t\t\tescape it.  If it is not escaped then normal config file processing will\n-\t\t\t\t\t\tthink it is a directive like #include.  For example: The mute setting is\n-\t\t\t\t\t\ttoggled when\n-                <literal>#1</literal>\n-                is pressed.\n-              </para>\n-              <para>\n-                <literal>\\#1=toggle_mute</literal>\n-              </para>\n-            </note>\n-            <note>\n-              <para>\n-                A single DTMF sequence can have multiple actions associated with it. This is\n-\t\t\t\t\taccomplished by stringing the actions together and using a\n-                <literal>,</literal>\n-                as the\n-\t\t\t\t\tdelimiter.  Example:  Both listening and talking volume is reset when\n-                <literal>5</literal>\n-                is\n-\t\t\t\t\tpressed.\n-                <literal>5=reset_talking_volume, reset_listening_volume</literal>\n-              </para>\n-            </note>\n-            <enumlist>\n-              <enum name=\"playback(filename&amp;filename2&amp;...)\">\n-                <para>\n-                  <literal>playback</literal>\n-                  will play back an audio file to a channel\n-\t\t\t\t\t\t\tand then immediately return to the conference.\n-\t\t\t\t\t\t\tThis file can not be interupted by DTMF.\n-\t\t\t\t\t\t\tMultiple files can be chained together using the\n-                  <literal>&amp;</literal>\n-                  character.\n-                </para>\n-              </enum>\n-              <enum name=\"playback_and_continue(filename&amp;filename2&amp;...)\">\n-                <para>\n-                  <literal>playback_and_continue</literal>\n-                  will\n-\t\t\t\t\t\t\tplay back a prompt while continuing to\n-\t\t\t\t\t\t\tcollect the dtmf sequence.  This is useful\n-\t\t\t\t\t\t\twhen using a menu prompt that describes all\n-\t\t\t\t\t\t\tthe menu options.  Note however that any DTMF\n-\t\t\t\t\t\t\tduring this action will terminate the prompts\n-\t\t\t\t\t\t\tplayback.  Prompt files can be chained together\n-\t\t\t\t\t\t\tusing the\n-                  <literal>&amp;</literal>\n-                  character as a delimiter.\n-                </para>\n-              </enum>\n-              <enum name=\"toggle_mute\">\n-                <para>Toggle turning on and off mute.  Mute will make the user silent\n-\t\t\t\t\t\t\tto everyone else, but the user will still be able to listen in.</para>\n-              </enum>\n-              <enum name=\"toggle_binaural\">\n-                <para>Toggle turning on and off binaural audio processing.</para>\n-              </enum>\n-              <enum name=\"no_op\">\n-                <para>This action does nothing (No Operation). Its only real purpose exists for\n-\t\t\t\t\t\t\tbeing able to reserve a sequence in the config as a menu exit sequence.</para>\n-              </enum>\n-              <enum name=\"decrease_listening_volume\">\n-                <para>Decreases the channel's listening volume.</para>\n-              </enum>\n-              <enum name=\"increase_listening_volume\">\n-                <para>Increases the channel's listening volume.</para>\n-              </enum>\n-              <enum name=\"reset_listening_volume\">\n-                <para>Reset channel's listening volume to default level.</para>\n-              </enum>\n-              <enum name=\"decrease_talking_volume\">\n-                <para>Decreases the channel's talking volume.</para>\n-              </enum>\n-              <enum name=\"increase_talking_volume\">\n-                <para>Increases the channel's talking volume.</para>\n-              </enum>\n-              <enum name=\"reset_talking_volume\">\n-                <para>Reset channel's talking volume to default level.</para>\n-              </enum>\n-              <enum name=\"dialplan_exec(context,exten,priority)\">\n-                <para>\n-                  The\n-                  <literal>dialplan_exec</literal>\n-                  action allows a user\n-\t\t\t\t\t\t\tto escape from the conference and execute\n-\t\t\t\t\t\t\tcommands in the dialplan.  Once the dialplan\n-\t\t\t\t\t\t\texits the user will be put back into the\n-\t\t\t\t\t\t\tconference.  The possibilities are endless!\n-                </para>\n-              </enum>\n-              <enum name=\"leave_conference\">\n-                <para>This action allows a user to exit the conference and continue\n-\t\t\t\t\t\t\texecution in the dialplan.</para>\n-              </enum>\n-              <enum name=\"admin_kick_last\">\n-                <para>This action allows an Admin to kick the last participant from the\n-\t\t\t\t\t\t\tconference. This action will only work for admins which allows\n-\t\t\t\t\t\t\ta single menu to be used for both users and admins.</para>\n-              </enum>\n-              <enum name=\"admin_toggle_conference_lock\">\n-                <para>This action allows an Admin to toggle locking and\n-\t\t\t\t\t\t\tunlocking the conference.  Non admins can not use\n-\t\t\t\t\t\t\tthis action even if it is in their menu.</para>\n-              </enum>\n-              <enum name=\"set_as_single_video_src\">\n-                <para>\n-                  This action allows any user to set themselves as the\n-\t\t\t\t\t\t\tsingle video source distributed to all participants.\n-\t\t\t\t\t\t\tThis will make the video feed stick to them regardless\n-\t\t\t\t\t\t\tof what the\n-                  <literal>video_mode</literal>\n-                  is set to.\n-                </para>\n-              </enum>\n-              <enum name=\"release_as_single_video_src\">\n-                <para>\n-                  This action allows a user to release themselves as\n-\t\t\t\t\t\t\tthe video source.  If\n-                  <literal>video_mode</literal>\n-                  is not set to\n-                  <literal>none</literal>\n-                  this action will result in the conference returning to\n-\t\t\t\t\t\t\twhatever video mode the bridge profile is using.\n-                </para>\n-                <para>\n-                  Note that this action will have no effect if the user\n-\t\t\t\t\t\t\tis not currently the video source.  Also, the user is\n-\t\t\t\t\t\t\tnot guaranteed by using this action that they will not\n-\t\t\t\t\t\t\tbecome the video source again.  The bridge will return\n-\t\t\t\t\t\t\tto whatever operation the\n-                  <literal>video_mode</literal>\n-                  option is set to\n-\t\t\t\t\t\t\tupon release of the video src.\n-                </para>\n-              </enum>\n-              <enum name=\"admin_toggle_mute_participants\">\n-                <para>This action allows an administrator to toggle the mute\n-\t\t\t\t\t\t\tstate for all non-admins within a conference.  All\n-\t\t\t\t\t\t\tadmin users are unaffected by this option.  Note that all\n-\t\t\t\t\t\t\tusers, regardless of their admin status, are notified\n-\t\t\t\t\t\t\tthat the conference is muted.</para>\n-              </enum>\n-              <enum name=\"participant_count\">\n-                <para>This action plays back the number of participants currently\n-\t\t\t\t\t\t\tin a conference</para>\n-              </enum>\n-            </enumlist>\n-          </description>\n-        </configOption>\n-      </configObject>\n-    </configFile>\n-  </configInfo>\n-  <module language=\"en_US\" name=\"conf_state_inactive\">\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"conf_state_empty\">\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"conf_state_single\">\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"app_page\">\n-    <depend>app_confbridge</depend>\n+  <module language=\"en_US\" name=\"app_originate\">\n     <support_level>core</support_level>\n   </module>\n-  <application name=\"Page\" language=\"en_US\">\n-    <synopsis>Page series of phones</synopsis>\n+  <application name=\"Originate\" language=\"en_US\">\n+    <synopsis>Originate a call.</synopsis>\n     <syntax>\n-      <parameter name=\"Technology/Resource\" required=\"false\" argsep=\"&amp;\">\n-        <argument name=\"Technology/Resource\" required=\"true\">\n-          <para>\n-            Specification of the device(s) to dial. These must be in the format of\n-            <literal>Technology/Resource</literal>\n-            , where\n-            <replaceable>Technology</replaceable>\n-            represents a particular channel driver, and\n-            <replaceable>Resource</replaceable>\n-            represents a resource\n-\t\t\t\t\tavailable to that particular channel driver.\n-          </para>\n-        </argument>\n-        <argument name=\"Technology2/Resource2\" multiple=\"true\">\n-          <para>Optional extra devices to dial in parallel</para>\n-          <para>If you need more than one, enter them as Technology2/Resource2&amp;\n-\t\t\t\t\tTechnology3/Resource3&amp;.....</para>\n-        </argument>\n+      <parameter name=\"tech_data\" required=\"true\">\n+        <para>Channel technology and data for creating the outbound channel.\n+                      For example, SIP/1234.</para>\n       </parameter>\n-      <parameter name=\"options\">\n+      <parameter name=\"type\" required=\"true\">\n+        <para>\n+          This should be\n+          <literal>app</literal>\n+          or\n+          <literal>exten</literal>\n+          , depending on whether the outbound channel should be connected to an application or extension.\n+        </para>\n+      </parameter>\n+      <parameter name=\"arg1\" required=\"true\">\n+        <para>\n+          If the type is\n+          <literal>app</literal>\n+          , then this is the application name.  If the type is\n+          <literal>exten</literal>\n+          , then this is the context that the channel will be sent to.\n+        </para>\n+      </parameter>\n+      <parameter name=\"arg2\" required=\"false\">\n+        <para>\n+          If the type is\n+          <literal>app</literal>\n+          , then this is the data passed as arguments to the application.  If the type is\n+          <literal>exten</literal>\n+          , then this is the extension that the channel will be sent to.\n+        </para>\n+      </parameter>\n+      <parameter name=\"arg3\" required=\"false\">\n+        <para>\n+          If the type is\n+          <literal>exten</literal>\n+          , then this is the priority that the channel is sent to.  If the type is\n+          <literal>app</literal>\n+          , then this parameter is ignored.\n+        </para>\n+      </parameter>\n+      <parameter name=\"timeout\" required=\"false\">\n+        <para>Timeout in seconds. Default is 30 seconds.</para>\n+      </parameter>\n+      <parameter name=\"options\" required=\"false\">\n         <optionlist>\n+          <option name=\"a\">\n+            <para>Originate asynchronously.  In other words, continue in the dialplan\n+\t\t\t\t\twithout waiting for the originated channel to answer.</para>\n+          </option>\n           <option name=\"b\" argsep=\"^\">\n-            <para>Before initiating an outgoing call, Gosub to the specified\n-\t\t\t\t\tlocation using the newly created channel.  The Gosub will be\n-\t\t\t\t\texecuted for each destination channel.</para>\n+            <para>Before originating the outgoing call, Gosub to the specified\n+\t\t\t\t\tlocation using the newly created channel.</para>\n             <argument name=\"context\" required=\"false\"/>\n             <argument name=\"exten\" required=\"false\"/>\n             <argument name=\"priority\" required=\"true\" hasparams=\"optional\" argsep=\"^\">\n               <argument name=\"arg1\" multiple=\"true\" required=\"true\"/>\n               <argument name=\"argN\"/>\n             </argument>\n           </option>\n           <option name=\"B\" argsep=\"^\">\n-            <para>Before initiating the outgoing call(s), Gosub to the specified\n+            <para>Before originating the outgoing call, Gosub to the specified\n \t\t\t\t\tlocation using the current channel.</para>\n             <argument name=\"context\" required=\"false\"/>\n             <argument name=\"exten\" required=\"false\"/>\n             <argument name=\"priority\" required=\"true\" hasparams=\"optional\" argsep=\"^\">\n               <argument name=\"arg1\" multiple=\"true\" required=\"true\"/>\n               <argument name=\"argN\"/>\n             </argument>\n           </option>\n-          <option name=\"d\">\n-            <para>Full duplex audio</para>\n-          </option>\n-          <option name=\"i\">\n-            <para>Ignore attempts to forward the call</para>\n-          </option>\n-          <option name=\"q\">\n-            <para>Quiet, do not play beep to caller</para>\n-          </option>\n-          <option name=\"r\">\n-            <para>\n-              Record the page into a file (\n-              <literal>CONFBRIDGE(bridge,record_conference)</literal>\n-              )\n-            </para>\n-          </option>\n-          <option name=\"s\">\n+          <option name=\"C\">\n             <para>\n-              Only dial a channel if its device state says that it is\n-              <literal>NOT_INUSE</literal>\n+              Comma-separated list of codecs to use for this call.\n+\t\t\t\t\tDefault is\n+              <literal>slin</literal>\n+              .\n             </para>\n           </option>\n-          <option name=\"A\">\n-            <argument name=\"x\" required=\"true\">\n-              <para>The announcement to playback to all devices</para>\n-            </argument>\n-            <para>Play an announcement to all paged participants</para>\n+          <option name=\"c\">\n+            <para>The caller ID number to use for the called channel. Default is\n+\t\t\t\t\tthe current channel's Caller ID number.</para>\n           </option>\n           <option name=\"n\">\n-            <para>\n-              Do not play announcement to caller (alters\n-              <literal>A(x)</literal>\n-              behavior)\n-            </para>\n+            <para>The caller ID name to use for the called channel. Default is\n+\t\t\t\t\tthe current channel's Caller ID name.</para>\n+          </option>\n+          <option name=\"v\" argsep=\"^\">\n+            <para>A series of channel variables to set on the destination channel.</para>\n+            <argument name=\"var1\" multiple=\"true\" argsep=\"=\">\n+              <argument name=\"name\" required=\"true\"/>\n+              <argument name=\"value\" required=\"true\"/>\n+            </argument>\n           </option>\n         </optionlist>\n       </parameter>\n-      <parameter name=\"timeout\">\n-        <para>Specify the length of time that the system will attempt to connect a call.\n-\t\t\t\tAfter this duration, any page calls that have not been answered will be hung up by the\n-\t\t\t\tsystem.</para>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>\n-        Places outbound calls to the given\n-        <replaceable>technology</replaceable>\n-        /\n-        <replaceable>resource</replaceable>\n-        and dumps them into a conference bridge as muted participants. The original\n-\t\t\tcaller is dumped into the conference as a speaker and the room is\n-\t\t\tdestroyed when the original caller leaves.\n-      </para>\n-    </description>\n-    <see-also>\n-      <ref type=\"application\">ConfBridge</ref>\n-    </see-also>\n-  </application>\n-  <module language=\"en_US\" name=\"app_waitforsilence\">\n-    <support_level>extended</support_level>\n-  </module>\n-  <application name=\"WaitForSilence\" language=\"en_US\">\n-    <synopsis>Waits for a specified amount of silence.</synopsis>\n-    <syntax>\n-      <parameter name=\"silencerequired\">\n-        <para>\n-          If not specified, defaults to\n-          <literal>1000</literal>\n-          milliseconds.\n-        </para>\n-      </parameter>\n-      <parameter name=\"iterations\">\n-        <para>\n-          If not specified, defaults to\n-          <literal>1</literal>\n-          .\n-        </para>\n-      </parameter>\n-      <parameter name=\"timeout\">\n-        <para>Is specified only to avoid an infinite loop in cases where silence is never achieved.</para>\n-      </parameter>\n     </syntax>\n     <description>\n-      <para>\n-        Waits for up to\n-        <replaceable>silencerequired</replaceable>\n-        milliseconds of silence,\n-        <replaceable>iterations</replaceable>\n-        times. An optional\n-        <replaceable>timeout</replaceable>\n-        specified the number of seconds to return after, even if we do not receive the specified amount of silence.\n-\t\t\tUse\n-        <replaceable>timeout</replaceable>\n-        with caution, as it may defeat the purpose of this application, which\n-\t\t\tis to wait indefinitely until silence is detected on the line. This is particularly useful for reverse-911-type\n-\t\t\tcall broadcast applications where you need to wait for an answering machine to complete its spiel before\n-\t\t\tplaying a message.\n-      </para>\n-      <para>Typically you will want to include two or more calls to WaitForSilence when dealing with an answering\n-\t\t\tmachine; first waiting for the spiel to finish, then waiting for the beep, etc.</para>\n-      <example title=\"Wait for half a second of silence, twice\">same =&gt; n,WaitForSilence(500,2)</example>\n-      <example title=\"Wait for one second of silence, once\">same =&gt; n,WaitForSilence(1000)</example>\n-      <example title=\"Wait for 300 ms of silence, 3 times, and returns after 10 seconds, even if no silence detected\">same =&gt; n,WaitForSilence(300,3,10)</example>\n-      <para>\n-        Sets the channel variable\n-        <variable>WAITSTATUS</variable>\n-        to one of these values:\n-      </para>\n+      <para>This application originates an outbound call and connects it to a specified extension or application.  This application will block until the outgoing call fails or gets answered, unless the async option is used.  At that point, this application will exit with the status variable set and dialplan processing will continue.</para>\n+      <para>This application sets the following channel variable before exiting:</para>\n       <variablelist>\n-        <variable name=\"WAITSTATUS\">\n-          <value name=\"SILENCE\">if exited with silence detected.</value>\n-          <value name=\"TIMEOUT\">if exited without silence detected after timeout.</value>\n+        <variable name=\"ORIGINATE_STATUS\">\n+          <para>This indicates the result of the call origination.</para>\n+          <value name=\"FAILED\"/>\n+          <value name=\"SUCCESS\"/>\n+          <value name=\"BUSY\"/>\n+          <value name=\"CONGESTION\"/>\n+          <value name=\"HANGUP\"/>\n+          <value name=\"RINGING\"/>\n+          <value name=\"UNKNOWN\">In practice, you should never see this value.  Please report it to the issue tracker if you ever see it.</value>\n         </variable>\n       </variablelist>\n     </description>\n-    <see-also>\n-      <ref type=\"application\">WaitForNoise</ref>\n-    </see-also>\n-  </application>\n-  <application name=\"WaitForNoise\" language=\"en_US\">\n-    <synopsis>Waits for a specified amount of noise.</synopsis>\n-    <syntax>\n-      <parameter name=\"noiserequired\">\n-        <para>\n-          If not specified, defaults to\n-          <literal>1000</literal>\n-          milliseconds.\n-        </para>\n-      </parameter>\n-      <parameter name=\"iterations\">\n-        <para>\n-          If not specified, defaults to\n-          <literal>1</literal>\n-          .\n-        </para>\n-      </parameter>\n-      <parameter name=\"timeout\">\n-        <para>Is specified only to avoid an infinite loop in cases where silence is never achieved.</para>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>\n-        Waits for up to\n-        <replaceable>noiserequired</replaceable>\n-        milliseconds of noise,\n-        <replaceable>iterations</replaceable>\n-        times. An optional\n-        <replaceable>timeout</replaceable>\n-        specified the number of seconds to return after, even if we do not receive the specified amount of noise.\n-\t\t\tUse\n-        <replaceable>timeout</replaceable>\n-        with caution, as it may defeat the purpose of this application, which\n-\t\t\tis to wait indefinitely until noise is detected on the line.\n-      </para>\n-    </description>\n-    <see-also>\n-      <ref type=\"application\">WaitForSilence</ref>\n-    </see-also>\n   </application>\n-  <module language=\"en_US\" name=\"app_adsiprog\">\n-    <depend>res_adsi</depend>\n-    <support_level>deprecated</support_level>\n+  <module language=\"en_US\" name=\"app_reload\">\n+    <support_level>extended</support_level>\n   </module>\n-  <application name=\"ADSIProg\" language=\"en_US\">\n-    <synopsis>Load Asterisk ADSI Scripts into phone</synopsis>\n+  <application name=\"Reload\" language=\"en_US\">\n+    <since>\n+      <version>16.20.0</version>\n+      <version>18.6.0</version>\n+      <version>19.0.0</version>\n+    </since>\n+    <synopsis>Reloads an Asterisk module, blocking the channel until the reload has completed.</synopsis>\n     <syntax>\n-      <parameter name=\"script\" required=\"false\">\n+      <parameter name=\"module\" required=\"false\">\n+        <para>The full name(s) of the target module(s) or resource(s) to reload.\n+\t\t\t\tIf omitted, everything will be reloaded.</para>\n         <para>\n-          adsi script to use. If not given uses the default script\n-          <filename>asterisk.adsi</filename>\n+          The full names MUST be specified (e.g.\n+          <literal>chan_iax2</literal>\n+          to reload IAX2 or\n+          <literal>pbx_config</literal>\n+          to reload the dialplan.\n         </para>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>This application programs an ADSI Phone with the given script</para>\n-    </description>\n-    <see-also>\n-      <ref type=\"application\">GetCPEID</ref>\n-      <ref type=\"filename\">adsi.conf</ref>\n-    </see-also>\n-  </application>\n-  <module language=\"en_US\" name=\"app_attended_transfer\">\n-    <support_level>extended</support_level>\n-  </module>\n-  <application name=\"AttendedTransfer\" language=\"en_US\">\n-    <synopsis>Attended transfer to the extension provided and TRANSFER_CONTEXT</synopsis>\n-    <syntax>\n-      <parameter name=\"exten\" required=\"true\">\n-        <para>Specify extension.</para>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>\n-        Queue up attended transfer to the specified extension in the\n-        <literal>TRANSFER_CONTEXT</literal>\n-        .\n-      </para>\n-      <para>Note that the attended transfer only work when two channels have answered and are bridged together.</para>\n-      <para>\n-        Make sure to set Attended Transfer DTMF feature\n-        <literal>atxfer</literal>\n-        and attended transfer is permitted.\n-      </para>\n+      <para>Reloads the specified (or all) Asterisk modules and reports success or failure.\n+\t\t\tSuccess is determined by each individual module, and if all reloads are successful,\n+\t\t\tthat is considered an aggregate success. If multiple modules are specified and any\n+\t\t\tmodule fails, then FAILURE will be returned. It is still possible that other modules\n+\t\t\tdid successfully reload, however.</para>\n       <para>\n-        The result of the application will be reported in the\n-        <variable>ATTENDEDTRANSFERSTATUS</variable>\n-        channel variable:\n+        Sets\n+        <variable>RELOADSTATUS</variable>\n+        to one of the following values:\n       </para>\n       <variablelist>\n-        <variable name=\"ATTENDEDTRANSFERSTATUS\">\n-          <value name=\"SUCCESS\">Transfer successfully queued.</value>\n-          <value name=\"FAILURE\">Transfer failed.</value>\n-          <value name=\"NOTPERMITTED\">Transfer not permitted.</value>\n+        <variable name=\"RELOADSTATUS\">\n+          <value name=\"SUCCESS\">Specified module(s) reloaded successfully.</value>\n+          <value name=\"FAILURE\">Some or all of the specified modules failed to reload.</value>\n         </variable>\n       </variablelist>\n     </description>\n   </application>\n-  <module language=\"en_US\" name=\"app_authenticate\">\n+  <module language=\"en_US\" name=\"app_db\">\n     <support_level>core</support_level>\n   </module>\n-  <application name=\"Authenticate\" language=\"en_US\">\n-    <synopsis>Authenticate a user</synopsis>\n-    <syntax>\n-      <parameter name=\"password\" required=\"true\">\n-        <para>Password the user should know</para>\n-      </parameter>\n-      <parameter name=\"options\" required=\"false\">\n-        <optionlist>\n-          <option name=\"a\">\n-            <para>Set the channels' account code to the password that is entered</para>\n-          </option>\n-          <option name=\"d\">\n-            <para>Interpret the given path as database key, not a literal file.</para>\n-            <note>\n-              <para>\n-                The value is not used at all in the authentication when using this option.\n-\t\t\t\t\t\t\tIf the family/key is set to\n-                <literal>/pin/100</literal>\n-                (value does not matter)\n-\t\t\t\t\t\t\tthen the password field needs to be set to\n-                <literal>/pin</literal>\n-                and the pin entered\n-\t\t\t\t\t\t\tby the user would be authenticated against\n-                <literal>100</literal>\n-                .\n-              </para>\n-            </note>\n-          </option>\n-          <option name=\"m\">\n-            <para>\n-              Interpret the given path as a file which contains a list of account\n-\t\t\t\t\t\tcodes and password hashes delimited with\n-              <literal>:</literal>\n-              , listed one per line in\n-\t\t\t\t\t\tthe file. When one of the passwords is matched, the channel will have\n-\t\t\t\t\t\tits account code set to the corresponding account code in the file.\n-            </para>\n-          </option>\n-          <option name=\"r\">\n-            <para>\n-              Remove the database key upon successful entry (valid with\n-              <literal>d</literal>\n-              only)\n-            </para>\n-          </option>\n-        </optionlist>\n-      </parameter>\n-      <parameter name=\"maxdigits\" required=\"false\">\n-        <para>\n-          maximum acceptable number of digits. Stops reading after\n-\t\t\t\tmaxdigits have been entered (without requiring the user to press the\n-          <literal>#</literal>\n-          key).\n-\t\t\t\tDefaults to 0 - no limit - wait for the user press the\n-          <literal>#</literal>\n-          key.\n-        </para>\n-      </parameter>\n-      <parameter name=\"prompt\" required=\"false\">\n-        <para>Override the agent-pass prompt file.</para>\n-      </parameter>\n+  <application name=\"DBdeltree\" language=\"en_US\">\n+    <synopsis>Delete a family or keytree from the asterisk database.</synopsis>\n+    <syntax argsep=\"/\">\n+      <parameter name=\"family\" required=\"true\"/>\n+      <parameter name=\"keytree\"/>\n     </syntax>\n     <description>\n-      <para>This application asks the caller to enter a given password in order to continue dialplan execution.</para>\n       <para>\n-        If the password begins with the\n-        <literal>/</literal>\n-        character,\n-\t\t\tit is interpreted as a file which contains a list of valid passwords, listed 1 password per line in the file.\n+        This application will delete a\n+        <replaceable>family</replaceable>\n+        or\n+        <replaceable>keytree</replaceable>\n+        from the Asterisk database.\n       </para>\n-      <para>When using a database key, the value associated with the key can be anything.</para>\n-      <para>Users have three attempts to authenticate before the channel is hung up.</para>\n     </description>\n     <see-also>\n-      <ref type=\"application\">VMAuthenticate</ref>\n-      <ref type=\"application\">DISA</ref>\n+      <ref type=\"function\">DB_DELETE</ref>\n+      <ref type=\"function\">DB</ref>\n     </see-also>\n   </application>\n-  <module language=\"en_US\" name=\"app_ices\">\n-    <support_level>deprecated</support_level>\n-    <deprecated_in>16</deprecated_in>\n-    <removed_in>19</removed_in>\n-  </module>\n-  <application name=\"ICES\" language=\"en_US\">\n-    <synopsis>Encode and stream using 'ices'.</synopsis>\n-    <syntax>\n-      <parameter name=\"config\" required=\"true\">\n-        <para>ICES configuration file.</para>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>Streams to an icecast server using ices (available separately).\n-\t\t\tA configuration file must be supplied for ices (see contrib/asterisk-ices.xml).</para>\n-      <note>\n-        <para>ICES version 2 client and server required.</para>\n-      </note>\n-    </description>\n-  </application>\n-  <module language=\"en_US\" name=\"app_transfer\">\n+  <module language=\"en_US\" name=\"app_cdr\">\n     <support_level>core</support_level>\n   </module>\n-  <application name=\"Transfer\" language=\"en_US\">\n-    <synopsis>Transfer caller to remote extension.</synopsis>\n-    <syntax>\n-      <parameter name=\"dest\" required=\"true\" argsep=\"\">\n-        <argument name=\"Tech/\"/>\n-        <argument name=\"destination\" required=\"true\"/>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>Requests the remote caller be transferred\n-\t\t\tto a given destination. If TECH (SIP, IAX2, etc) is used, only\n-\t\t\tan incoming call with the same channel technology will be transferred.\n-\t\t\tNote that for SIP, if you transfer before call is setup, a 302 redirect\n-\t\t\tSIP message will be returned to the caller.</para>\n-      <para>\n-        The result of the application will be reported in the\n-        <variable>TRANSFERSTATUS</variable>\n-        channel variable:\n-      </para>\n-      <variablelist>\n-        <variable name=\"TRANSFERSTATUS\">\n-          <value name=\"SUCCESS\">Transfer succeeded.</value>\n-          <value name=\"FAILURE\">Transfer failed.</value>\n-          <value name=\"UNSUPPORTED\">Transfer unsupported by channel driver.</value>\n-        </variable>\n-        <variable name=\"TRANSFERSTATUSPROTOCOL\">\n-          <value name=\"0\">No error.</value>\n-          <value name=\"3xx-6xx\">SIP example - Error result code.</value>\n-        </variable>\n-      </variablelist>\n-    </description>\n-  </application>\n-  <module language=\"en_US\" name=\"app_festival\">\n-    <support_level>extended</support_level>\n-  </module>\n-  <application name=\"Festival\" language=\"en_US\">\n-    <synopsis>Say text to the user.</synopsis>\n-    <syntax>\n-      <parameter name=\"text\" required=\"true\"/>\n-      <parameter name=\"intkeys\"/>\n-    </syntax>\n+  <application name=\"NoCDR\" language=\"en_US\">\n+    <synopsis>Tell Asterisk to not maintain a CDR for this channel.</synopsis>\n+    <syntax/>\n     <description>\n       <para>\n-        Connect to Festival, send the argument, get back the waveform, play it to the user,\n-\t\t\tallowing any given interrupt keys to immediately terminate and return the value, or\n-        <literal>any</literal>\n-        to allow any number back (useful in dialplan).\n+        This application will tell Asterisk not to maintain a CDR for\n+\t\t\tthe current channel. This does\n+        <emphasis>NOT</emphasis>\n+        mean that\n+\t\t\tinformation is not tracked; rather, if the channel is hung up no\n+\t\t\tCDRs will be created for that channel.\n       </para>\n-    </description>\n-  </application>\n-  <module language=\"en_US\" name=\"app_verbose\">\n-    <support_level>core</support_level>\n-  </module>\n-  <application name=\"Verbose\" language=\"en_US\">\n-    <synopsis>Send arbitrary text to verbose output.</synopsis>\n-    <syntax>\n-      <parameter name=\"level\">\n-        <para>Must be an integer value.  If not specified, defaults to 0.</para>\n-      </parameter>\n-      <parameter name=\"message\" required=\"true\">\n-        <para>Output text message.</para>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>Sends an arbitrary text message to verbose output.</para>\n-    </description>\n-  </application>\n-  <application name=\"Log\" language=\"en_US\">\n-    <synopsis>Send arbitrary text to a selected log level.</synopsis>\n-    <syntax>\n-      <parameter name=\"level\" required=\"true\">\n-        <para>\n-          Level must be one of\n-          <literal>ERROR</literal>\n-          ,\n-          <literal>WARNING</literal>\n-          ,\n-          <literal>NOTICE</literal>\n-          ,\n-          <literal>DEBUG</literal>\n-          ,\n-          <literal>VERBOSE</literal>\n-          ,\n-          <literal>DTMF</literal>\n-          , or\n-\t\t\t\tthe name of a custom dynamic logging level.\n-        </para>\n-      </parameter>\n-      <parameter name=\"message\" required=\"true\">\n-        <para>Output text message.</para>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>Sends an arbitrary text message to a selected log level.</para>\n-    </description>\n-  </application>\n-  <module language=\"en_US\" name=\"app_flash\">\n-    <depend>dahdi</depend>\n-    <support_level>core</support_level>\n-  </module>\n-  <application name=\"Flash\" language=\"en_US\">\n-    <synopsis>Flashes a DAHDI Trunk.</synopsis>\n-    <syntax/>\n-    <description>\n-      <para>Performs a flash on a DAHDI trunk. This can be used to access features\n-\t\t\tprovided on an incoming analogue circuit such as conference and call waiting.\n-\t\t\tUse with SendDTMF() to perform external transfers.</para>\n+      <para>If a subsequent call to ResetCDR occurs, all non-finalized\n+\t\t\tCDRs created for the channel will be enabled.</para>\n+      <note>\n+        <para>This application is deprecated. Please use the CDR_PROP\n+\t\t\tfunction to disable CDRs on a channel.</para>\n+      </note>\n     </description>\n     <see-also>\n-      <ref type=\"application\">SendDTMF</ref>\n+      <ref type=\"application\">ResetCDR</ref>\n+      <ref type=\"function\">CDR_PROP</ref>\n     </see-also>\n   </application>\n-  <module language=\"en_US\" name=\"app_macro\">\n-    <defaultenabled>no</defaultenabled>\n-    <support_level>deprecated</support_level>\n-    <replacement>app_stack (GoSub)</replacement>\n-    <deprecated_in>16</deprecated_in>\n-    <removed_in>21</removed_in>\n-  </module>\n-  <application name=\"Macro\" language=\"en_US\">\n-    <synopsis>Macro Implementation.</synopsis>\n+  <application name=\"ResetCDR\" language=\"en_US\">\n+    <synopsis>Resets the Call Data Record.</synopsis>\n     <syntax>\n-      <parameter name=\"name\" required=\"true\">\n-        <para>The name of the macro</para>\n-      </parameter>\n-      <parameter name=\"args\">\n-        <argument name=\"arg1\" required=\"true\"/>\n-        <argument name=\"arg2\" multiple=\"true\"/>\n+      <parameter name=\"options\">\n+        <optionlist>\n+          <option name=\"v\">\n+            <para>Save the CDR variables during the reset.</para>\n+          </option>\n+          <option name=\"e\">\n+            <para>Enable the CDRs for this channel only (negate\n+\t\t\t\t\t\teffects of NoCDR).</para>\n+          </option>\n+        </optionlist>\n       </parameter>\n     </syntax>\n     <description>\n+      <para>This application causes the Call Data Record to be reset.\n+\t\t\tDepending on the flags passed in, this can have several effects.\n+\t\t\tWith no options, a reset does the following:</para>\n       <para>\n-        Executes a macro using the context macro-\n-        <replaceable>name</replaceable>\n-        ,\n-\t\t\tjumping to the\n-        <literal>s</literal>\n-        extension of that context and executing each step,\n-\t\t\tthen returning when the steps end.\n-      </para>\n-      <para>\n-        The calling extension, context, and priority are stored in\n-        <variable>MACRO_EXTEN</variable>\n-        ,\n-        <variable>MACRO_CONTEXT</variable>\n-        and\n-        <variable>MACRO_PRIORITY</variable>\n-        respectively. Arguments\n-\t\t\tbecome\n-        <variable>ARG1</variable>\n-        ,\n-        <variable>ARG2</variable>\n-        , etc in the macro context.\n+        1. The\n+        <literal>start</literal>\n+        time is set to the current time.\n       </para>\n-      <para>If you Goto out of the Macro context, the Macro will terminate and control will be returned\n-\t\t\tat the location of the Goto.</para>\n       <para>\n-        If\n-        <variable>MACRO_OFFSET</variable>\n-        is set at termination, Macro will attempt to continue\n-\t\t\tat priority MACRO_OFFSET + N + 1 if such a step exists, and N + 1 otherwise.\n+        2. If the channel is answered, the\n+        <literal>answer</literal>\n+        time is set to the\n+\t\t\tcurrent time.\n       </para>\n-      <warning>\n-        <para>Because of the way Macro is implemented (it executes the priorities contained within\n-\t\t\tit via sub-engine), and a fixed per-thread memory stack allowance, macros are limited to 7 levels\n-\t\t\tof nesting (macro calling macro calling macro, etc.); It may be possible that stack-intensive\n-\t\t\tapplications in deeply nested macros could cause asterisk to crash earlier than this limit.\n-\t\t\tIt is advised that if you need to deeply nest macro calls, that you use the Gosub application\n-\t\t\t(now allows arguments like a Macro) with explicit Return() calls instead.</para>\n-      </warning>\n-      <warning>\n-        <para>\n-          Use of the application\n-          <literal>WaitExten</literal>\n-          within a macro will not function\n-\t\t\tas expected. Please use the\n-          <literal>Read</literal>\n-          application in order to read DTMF from a channel\n-\t\t\tcurrently executing a macro.\n-        </para>\n-      </warning>\n-    </description>\n-    <see-also>\n-      <ref type=\"application\">MacroExit</ref>\n-      <ref type=\"application\">Goto</ref>\n-      <ref type=\"application\">Gosub</ref>\n-    </see-also>\n-  </application>\n-  <application name=\"MacroIf\" language=\"en_US\">\n-    <synopsis>Conditional Macro implementation.</synopsis>\n-    <syntax argsep=\"?\">\n-      <parameter name=\"expr\" required=\"true\"/>\n-      <parameter name=\"destination\" required=\"true\" argsep=\":\">\n-        <argument name=\"macroiftrue\" required=\"true\">\n-          <argument name=\"macroiftrue\" required=\"true\"/>\n-          <argument name=\"arg1\" multiple=\"true\"/>\n-        </argument>\n-        <argument name=\"macroiffalse\">\n-          <argument name=\"macroiffalse\" required=\"true\"/>\n-          <argument name=\"arg1\" multiple=\"true\"/>\n-        </argument>\n-      </parameter>\n-    </syntax>\n-    <description>\n       <para>\n-        Executes macro defined in\n-        <replaceable>macroiftrue</replaceable>\n-        if\n-        <replaceable>expr</replaceable>\n-        is true (otherwise\n-        <replaceable>macroiffalse</replaceable>\n-        if provided)\n+        3. All variables are wiped from the CDR. Note that this step\n+\t\t\tcan be prevented with the\n+        <literal>v</literal>\n+        option.\n       </para>\n-      <para>Arguments and return values as in application Macro()</para>\n-      <xi:include xpointer=\"xpointer(/docs/application[@name='Macro']/description/warning[2])\"/>\n-    </description>\n-    <see-also>\n-      <ref type=\"application\">GotoIf</ref>\n-      <ref type=\"application\">GosubIf</ref>\n-      <ref type=\"function\">IF</ref>\n-    </see-also>\n-  </application>\n-  <application name=\"MacroExclusive\" language=\"en_US\">\n-    <synopsis>Exclusive Macro Implementation.</synopsis>\n-    <syntax>\n-      <parameter name=\"name\" required=\"true\">\n-        <para>The name of the macro</para>\n-      </parameter>\n-      <parameter name=\"arg1\"/>\n-      <parameter name=\"arg2\" multiple=\"true\"/>\n-    </syntax>\n-    <description>\n       <para>\n-        Executes macro defined in the context macro-\n-        <replaceable>name</replaceable>\n-        .\n-\t\t\tOnly one call at a time may run the macro. (we'll wait if another call is busy\n-\t\t\texecuting in the Macro)\n+        On the other hand, if the\n+        <literal>e</literal>\n+        option is\n+\t\t\tspecified, the effects of the NoCDR application will be lifted. CDRs\n+\t\t\twill be re-enabled for this channel.\n       </para>\n-      <para>Arguments and return values as in application Macro()</para>\n-      <xi:include xpointer=\"xpointer(/docs/application[@name='Macro']/description/warning[2])\"/>\n-    </description>\n-    <see-also>\n-      <ref type=\"application\">Macro</ref>\n-    </see-also>\n-  </application>\n-  <application name=\"MacroExit\" language=\"en_US\">\n-    <synopsis>Exit from Macro.</synopsis>\n-    <syntax/>\n-    <description>\n-      <para>Causes the currently running macro to exit as if it had\n-\t\t\tended normally by running out of priorities to execute.\n-\t\t\tIf used outside a macro, will likely cause unexpected behavior.</para>\n+      <note>\n+        <para>\n+          The\n+          <literal>e</literal>\n+          option is deprecated. Please\n+\t\t\tuse the CDR_PROP function instead.\n+        </para>\n+      </note>\n     </description>\n     <see-also>\n-      <ref type=\"application\">Macro</ref>\n+      <ref type=\"application\">ForkCDR</ref>\n+      <ref type=\"application\">NoCDR</ref>\n+      <ref type=\"function\">CDR_PROP</ref>\n     </see-also>\n   </application>\n-  <module language=\"en_US\" name=\"app_exec\">\n-    <support_level>core</support_level>\n-  </module>\n-  <application name=\"Exec\" language=\"en_US\">\n-    <synopsis>Executes dialplan application.</synopsis>\n-    <syntax>\n-      <parameter name=\"appname\" required=\"true\" hasparams=\"true\">\n-        <para>Application name and arguments of the dialplan application to execute.</para>\n-        <argument name=\"arguments\" required=\"true\"/>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>Allows an arbitrary application to be invoked even when not\n-\t\t\thard coded into the dialplan.  If the underlying application\n-\t\t\tterminates the dialplan, or if the application cannot be found,\n-\t\t\tExec will terminate the dialplan.</para>\n-      <para>To invoke external applications, see the application System.\n-\t\t\tIf you would like to catch any error instead, see TryExec.</para>\n-    </description>\n-  </application>\n-  <application name=\"TryExec\" language=\"en_US\">\n-    <synopsis>Executes dialplan application, always returning.</synopsis>\n-    <syntax>\n-      <parameter name=\"appname\" required=\"true\" hasparams=\"true\">\n-        <argument name=\"arguments\" required=\"true\"/>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>Allows an arbitrary application to be invoked even when not\n-\t\t\thard coded into the dialplan. To invoke external applications\n-\t\t\tsee the application System.  Always returns to the dialplan.\n-\t\t\tThe channel variable TRYSTATUS will be set to one of:</para>\n-      <variablelist>\n-        <variable name=\"TRYSTATUS\">\n-          <value name=\"SUCCESS\">If the application returned zero.</value>\n-          <value name=\"FAILED\">If the application returned non-zero.</value>\n-          <value name=\"NOAPP\">If the application was not found or was not specified.</value>\n-        </variable>\n-      </variablelist>\n-    </description>\n-  </application>\n-  <application name=\"ExecIf\" language=\"en_US\">\n-    <synopsis>Executes dialplan application, conditionally.</synopsis>\n-    <syntax argsep=\"?\">\n-      <parameter name=\"expression\" required=\"true\"/>\n-      <parameter name=\"execapp\" required=\"true\" argsep=\":\">\n-        <argument name=\"appiftrue\" required=\"true\" hasparams=\"true\">\n-          <argument name=\"args\" required=\"true\"/>\n-        </argument>\n-        <argument name=\"appiffalse\" required=\"false\" hasparams=\"true\">\n-          <argument name=\"args\" required=\"true\"/>\n-        </argument>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>\n-        If\n-        <replaceable>expr</replaceable>\n-        is true, execute and return the\n-\t\t\tresult of\n-        <replaceable>appiftrue(args)</replaceable>\n-        .\n-      </para>\n-      <para>\n-        If\n-        <replaceable>expr</replaceable>\n-        is true, but\n-        <replaceable>appiftrue</replaceable>\n-        is not found,\n-\t\t\tthen the application will return a non-zero value.\n-      </para>\n-    </description>\n-  </application>\n-  <module language=\"en_US\" name=\"app_waitforring\">\n-    <support_level>extended</support_level>\n-  </module>\n-  <application name=\"WaitForRing\" language=\"en_US\">\n-    <synopsis>Wait for Ring Application.</synopsis>\n-    <syntax>\n-      <parameter name=\"timeout\" required=\"true\"/>\n-    </syntax>\n-    <description>\n-      <para>\n-        Returns\n-        <literal>0</literal>\n-        after waiting at least\n-        <replaceable>timeout</replaceable>\n-        seconds,\n-\t\t\tand only after the next ring has completed. Returns\n-        <literal>0</literal>\n-        on success or\n-        <literal>-1</literal>\n-        on hangup.\n-      </para>\n-    </description>\n-  </application>\n   <module language=\"en_US\" name=\"app_meetme\">\n     <depend>dahdi</depend>\n     <defaultenabled>no</defaultenabled>\n     <support_level>extended</support_level>\n     <replacement>app_confbridge</replacement>\n     <deprecated_in>19</deprecated_in>\n     <removed_in>21</removed_in>\n@@ -12909,746 +11995,755 @@\n       <syntax>\n         <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='MeetmeJoin']/managerEventInstance/syntax/parameter)\"/>\n         <channel_snapshot/>\n         <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='MeetmeTalkRequest']/managerEventInstance/syntax/parameter)\"/>\n       </syntax>\n     </managerEventInstance>\n   </managerEvent>\n-  <module language=\"en_US\" name=\"app_nbscat\">\n+  <module language=\"en_US\" name=\"app_getcpeid\">\n+    <depend>res_adsi</depend>\n     <support_level>deprecated</support_level>\n-    <deprecated_in>16</deprecated_in>\n-    <removed_in>19</removed_in>\n   </module>\n-  <application name=\"NBScat\" language=\"en_US\">\n-    <synopsis>Play an NBS local stream.</synopsis>\n+  <application name=\"GetCPEID\" language=\"en_US\">\n+    <synopsis>Get ADSI CPE ID.</synopsis>\n     <syntax/>\n     <description>\n-      <para>Executes nbscat to listen to the local NBS stream.\n-\t\t\tUser can exit by pressing any key.</para>\n+      <para>\n+        Obtains and displays ADSI CPE ID and other information in order\n+\t\t\tto properly setup\n+        <filename>dahdi.conf</filename>\n+        for on-hook operations.\n+      </para>\n     </description>\n   </application>\n-  <module language=\"en_US\" name=\"app_sendtext\">\n-    <support_level>core</support_level>\n+  <module language=\"en_US\" name=\"app_saycounted\">\n+    <defaultenabled>no</defaultenabled>\n+    <support_level>extended</support_level>\n   </module>\n-  <application name=\"SendText\" language=\"en_US\">\n-    <synopsis>Send a Text Message on a channel.</synopsis>\n+  <application name=\"SayCountedNoun\" language=\"en_US\">\n+    <synopsis>Say a noun in declined form in order to count things</synopsis>\n     <syntax>\n-      <parameter name=\"text\" required=\"false\"/>\n+      <parameter name=\"number\" required=\"true\">\n+        <para>The number of things</para>\n+      </parameter>\n+      <parameter name=\"filename\" required=\"true\">\n+        <para>File name stem for the noun that is the name of the things</para>\n+      </parameter>\n     </syntax>\n     <description>\n+      <para>Selects and plays the proper singular or plural form of a noun\n+\t\t\twhen saying things such as &quot;five calls&quot;.  English has simple rules\n+\t\t\tfor deciding when to say &quot;call&quot; and when to say &quot;calls&quot;, but other\n+\t\t\tlanguages have complicated rules which would be extremely difficult\n+\t\t\tto implement in the Asterisk dialplan language.</para>\n       <para>\n-        Sends\n-        <replaceable>text</replaceable>\n-        to the current channel.\n+        The correct sound file is selected by examining the\n+        <replaceable>number</replaceable>\n+        and adding the appropriate suffix\n+\t\t\tto\n+        <replaceable>filename</replaceable>\n+        . If the channel language is\n+\t\t\tEnglish, then the suffix will be either empty or &quot;s&quot;. If the channel\n+\t\t\tlanguage is Russian or some other Slavic language, then the suffix\n+\t\t\twill be empty for nominative, &quot;x1&quot; for genative singular, and &quot;x2&quot;\n+\t\t\tfor genative plural.\n       </para>\n-      <note>\n-        <para>\n-          <literal>current channel</literal>\n-          could be the caller or callee depending\n-\t\t\ton the context in which this application is called.\n-        </para>\n-      </note>\n-      <para/>\n-      <para>The following variables can be set:</para>\n-      <variablelist>\n-        <variable name=\"SENDTEXT_FROM_DISPLAYNAME\">\n-          <para>\n-            If set and this channel supports enhanced messaging, this value will be\n-\t\t\t\t\tused as the\n-            <literal>From</literal>\n-            display name.\n-          </para>\n-        </variable>\n-        <variable name=\"SENDTEXT_TO_DISPLAYNAME\">\n-          <para>\n-            If set and this channel supports enhanced messaging, this value will be\n-\t\t\t\t\tused as the\n-            <literal>To</literal>\n-            display name.\n-          </para>\n-        </variable>\n-        <variable name=\"SENDTEXT_CONTENT_TYPE\">\n-          <para>\n-            If set and this channel supports enhanced messaging, this value will be\n-\t\t\t\t\tused as the message\n-            <literal>Content-Type</literal>\n-            .  If not specified, the\n-\t\t\t\t\tdefault of\n-            <literal>text/plain</literal>\n-            will be used.\n-          </para>\n-          <para>\n-            <emphasis>Warning:</emphasis>\n-            Messages of types other than\n-            <literal>text/*</literal>\n-            cannot be sent via channel drivers that do not\n-\t\t\t\t\tsupport Enhanced Messaging. An attempt to do so will be ignored and will result\n-\t\t\t\t\tin the\n-            <literal>SENDTEXTSTATUS</literal>\n-            variable being set to\n-            <literal>UNSUPPORTED</literal>\n-            .\n-          </para>\n-        </variable>\n-        <variable name=\"SENDTEXT_BODY\">\n-          <para>If set this value will be used as the message body and any text supplied\n-\t\t\t\t\tas a function parameter will be ignored.</para>\n-        </variable>\n-      </variablelist>\n-      <para/>\n-      <para>Result of transmission will be stored in the following variables:</para>\n-      <variablelist>\n-        <variable name=\"SENDTEXTTYPE\">\n-          <value name=\"NONE\">No message sent.</value>\n-          <value name=\"BASIC\">Message body sent without attributes because the channel driver\n-\t\t\t\t\t\tdoesn't support enhanced messaging.</value>\n-          <value name=\"ENHANCED\">The message was sent using enhanced messaging.</value>\n-        </variable>\n-        <variable name=\"SENDTEXTSTATUS\">\n-          <value name=\"SUCCESS\">Transmission succeeded.</value>\n-          <value name=\"FAILURE\">Transmission failed.</value>\n-          <value name=\"UNSUPPORTED\">Text transmission not supported by channel.</value>\n-        </variable>\n-      </variablelist>\n-      <para/>\n-      <note>\n-        <para>The text encoding and transmission method is completely at the\n-\t\t\tdiscretion of the channel driver.  chan_pjsip will use in-dialog SIP MESSAGE\n-\t\t\tmessages always.  chan_sip will use T.140 via RTP if a text media type was\n-\t\t\tnegotiated and in-dialog SIP MESSAGE messages otherwise.</para>\n-      </note>\n-      <para/>\n-      <para>Examples:</para>\n-      <example title=\"Send a simple message\">same =&gt; n,SendText(Your Text Here)</example>\n-      <para>If the channel driver supports enhanced messaging (currently only chan_pjsip),\n-\t\t\tyou can set additional variables:</para>\n-      <example title=\"Alter the From display name\">same =&gt; n,Set(SENDTEXT_FROM_DISPLAYNAME=Really From Bob)\n-\t\t\t same =&gt; n,SendText(Your Text Here)</example>\n-      <example title=\"Send a JSON String\">same =&gt; n,Set(SENDTEXT_CONTENT_TYPE=text/json)\n-\t\t\t same =&gt; n,SendText({&quot;foo&quot;:a, &quot;bar&quot;:23})</example>\n-      <example title=\"Send a JSON String (alternate)\">same =&gt; n,Set(SENDTEXT_CONTENT_TYPE=text/json)\n-\t\t\t same =&gt; n,Set(SENDTEXT_BODY={&quot;foo&quot;:a, &quot;bar&quot;:23})\n-\t\t\t same =&gt; n,SendText()</example>\n+      <para>\n+        Note that combining\n+        <replaceable>filename</replaceable>\n+        with\n+\t\t\ta suffix will not necessarily produce a correctly spelled plural\n+\t\t\tform. For example, SayCountedNoun(2,man) will play the sound file\n+\t\t\t&quot;mans&quot; rather than &quot;men&quot;. This behavior is intentional. Since the\n+\t\t\tfile name is never seen by the end user, there is no need to\n+\t\t\timplement complicated spelling rules.  We simply record the word\n+\t\t\t&quot;men&quot; in the sound file named &quot;mans&quot;.\n+      </para>\n+      <para>This application does not automatically answer and should be\n+\t\t\tpreceeded by an application such as Answer() or Progress.</para>\n     </description>\n     <see-also>\n-      <ref type=\"application\">SendImage</ref>\n-      <ref type=\"application\">SendURL</ref>\n-      <ref type=\"application\">ReceiveText</ref>\n+      <ref type=\"application\">SayCountedAdj</ref>\n+      <ref type=\"application\">SayNumber</ref>\n     </see-also>\n   </application>\n-  <application name=\"ReceiveText\" language=\"en_US\">\n-    <since>\n-      <version>16.24.0</version>\n-      <version>18.10.0</version>\n-      <version>19.2.0</version>\n-    </since>\n-    <synopsis>Receive a Text Message on a channel.</synopsis>\n+  <application name=\"SayCountedAdj\" language=\"en_US\">\n+    <synopsis>Say a adjective in declined form in order to count things</synopsis>\n     <syntax>\n-      <parameter name=\"timeout\" required=\"false\">\n-        <para>Time in seconds to wait for text. Default is 0 (forever).</para>\n+      <parameter name=\"number\" required=\"true\">\n+        <para>The number of things</para>\n+      </parameter>\n+      <parameter name=\"filename\" required=\"true\">\n+        <para>File name stem for the adjective</para>\n+      </parameter>\n+      <parameter name=\"gender\">\n+        <para>The gender of the noun modified, one of 'm', 'f', 'n', or 'c'</para>\n       </parameter>\n     </syntax>\n     <description>\n       <para>\n-        Waits for\n-        <replaceable>timeout</replaceable>\n-        seconds on the current channel\n-\t\t\tto receive text.\n+        Selects and plays the proper form of an adjective according to\n+\t\t\tthe gender and of the noun which it modifies and the number of\n+\t\t\tobjects named by the noun-verb combination which have been counted.\n+\t\t\tUsed when saying things such as &quot;5 new messages&quot;.  The various\n+\t\t\tsingular and plural forms of the adjective are selected by adding\n+\t\t\tsuffixes to\n+        <replaceable>filename</replaceable>\n+        .\n       </para>\n-      <para>Result of transmission will be stored in the following variables:</para>\n-      <variablelist>\n-        <variable name=\"RECEIVETEXTMESSAGE\">\n-          <para>The received text message.</para>\n-        </variable>\n-        <variable name=\"RECEIVETEXTSTATUS\">\n-          <value name=\"SUCCESS\">Transmission succeeded.</value>\n-          <value name=\"FAILURE\">Transmission failed or timed out.</value>\n-        </variable>\n-      </variablelist>\n-      <example title=\"Receive message on channel\">same =&gt; n,ReceiveText()\n-\t\t\t same =&gt; n,NoOp(${RECEIVETEXTMESSAGE})</example>\n+      <para>\n+        If the channel language is English, then no suffix will ever\n+\t\t\tbe added (since, in English, adjectives are not declined). If the\n+\t\t\tchannel language is Russian or some other slavic language, then the\n+\t\t\tsuffix will the specified\n+        <replaceable>gender</replaceable>\n+        for\n+\t\t\tnominative, and &quot;x&quot; for genative plural. (The genative singular is\n+\t\t\tnot used when counting things.) For example, SayCountedAdj(1,new,f)\n+\t\t\twill play sound file &quot;newa&quot; (containing the word &quot;novaya&quot;), but\n+\t\t\tSayCountedAdj(5,new,f) will play sound file &quot;newx&quot; (containing the\n+\t\t\tword &quot;novikh&quot;).\n+      </para>\n+      <para>This application does not automatically answer and should be\n+\t\t\tpreceeded by an application such as Answer(), Progress(), or\n+\t\t\tProceeding().</para>\n     </description>\n     <see-also>\n-      <ref type=\"application\">SendText</ref>\n-      <ref type=\"application\">SendImage</ref>\n-      <ref type=\"application\">SendURL</ref>\n+      <ref type=\"application\">SayCountedNoun</ref>\n+      <ref type=\"application\">SayNumber</ref>\n     </see-also>\n   </application>\n-  <module language=\"en_US\" name=\"app_mf\">\n-    <support_level>extended</support_level>\n+  <module language=\"en_US\" name=\"app_forkcdr\">\n+    <support_level>core</support_level>\n   </module>\n-  <application name=\"ReceiveMF\" language=\"en_US\">\n-    <since>\n-      <version>16.21.0</version>\n-      <version>18.7.0</version>\n-      <version>19.0.0</version>\n-    </since>\n-    <synopsis>Detects MF digits on a channel and saves them to a variable.</synopsis>\n+  <application name=\"ForkCDR\" language=\"en_US\">\n+    <synopsis>Forks the current Call Data Record for this channel.</synopsis>\n     <syntax>\n-      <parameter name=\"variable\" required=\"true\">\n-        <para>\n-          The input digits will be stored in the given\n-          <replaceable>variable</replaceable>\n-          name.\n-        </para>\n-      </parameter>\n-      <parameter name=\"timeout\">\n-        <para>\n-          The number of seconds to wait for all digits, if greater\n-\t\t\t\tthan\n-          <literal>0</literal>\n-          . Can be floating point. Default\n-\t\t\t\tis no timeout.\n-        </para>\n-      </parameter>\n       <parameter name=\"options\">\n         <optionlist>\n-          <option name=\"d\">\n-            <para>Delay audio by a frame to try to extra quelch.</para>\n+          <option name=\"a\">\n+            <para>If the channel is answered, set the answer time on\n+\t\t\t\t\t\tthe forked CDR to the current time. If this option is\n+\t\t\t\t\t\tnot used, the answer time on the forked CDR will be the\n+\t\t\t\t\t\tanswer time on the original CDR. If the channel is not\n+\t\t\t\t\t\tanswered, this option has no effect.</para>\n+            <para>\n+              Note that this option is implicitly assumed if the\n+              <literal>r</literal>\n+              option is used.\n+            </para>\n           </option>\n-          <option name=\"l\">\n-            <para>Receive digits even if a key pulse (KP) has not yet\n-\t\t\t\t\t\tbeen received. By default, this application will ignore\n-\t\t\t\t\t\tall other digits until a KP has been received.</para>\n+          <option name=\"e\">\n+            <para>End (finalize) the original CDR.</para>\n           </option>\n-          <option name=\"k\">\n-            <para>Do not return a character for the KP digit.</para>\n+          <option name=\"r\">\n+            <para>Reset the start and answer times on the forked CDR.\n+\t\t\t\t\t\tThis will set the start and answer times (if the channel\n+\t\t\t\t\t\tis answered) to be set to the current time.</para>\n+            <para>\n+              Note that this option implicitly assumes the\n+              <literal>a</literal>\n+              option.\n+            </para>\n           </option>\n-          <option name=\"m\">\n-            <para>Mute conference.</para>\n+          <option name=\"v\">\n+            <para>Do not copy CDR variables and attributes from the\n+\t\t\t\t\t\toriginal CDR to the forked CDR.</para>\n+            <warning>\n+              <para>This option has changed. Previously, the\n+\t\t\t\t\t\tvariables were removed from the original CDR. This no\n+\t\t\t\t\t\tlonger occurs - this option now controls whether or not\n+\t\t\t\t\t\ta forked CDR inherits the variables from the original\n+\t\t\t\t\t\tCDR.</para>\n+            </warning>\n+          </option>\n+        </optionlist>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>Causes the Call Data Record engine to fork a new CDR starting\n+\t\t\tfrom the time the application is executed. The forked CDR will be\n+\t\t\tlinked to the end of the CDRs associated with the channel.</para>\n+    </description>\n+    <see-also>\n+      <ref type=\"function\">CDR</ref>\n+      <ref type=\"application\">NoCDR</ref>\n+      <ref type=\"application\">ResetCDR</ref>\n+    </see-also>\n+  </application>\n+  <module language=\"en_US\" name=\"app_record\">\n+    <support_level>core</support_level>\n+  </module>\n+  <application name=\"Record\" language=\"en_US\">\n+    <synopsis>Record to a file.</synopsis>\n+    <syntax>\n+      <parameter name=\"filename\" required=\"true\" argsep=\".\">\n+        <argument name=\"filename\" required=\"true\"/>\n+        <argument name=\"format\" required=\"true\">\n+          <para>Is the format of the file type to be recorded (wav, gsm, etc).</para>\n+        </argument>\n+      </parameter>\n+      <parameter name=\"silence\">\n+        <para>Is the number of seconds of silence to allow before returning.</para>\n+      </parameter>\n+      <parameter name=\"maxduration\">\n+        <para>Is the maximum recording duration in seconds. If missing\n+\t\t\t\tor 0 there is no maximum.</para>\n+      </parameter>\n+      <parameter name=\"options\">\n+        <optionlist>\n+          <option name=\"a\">\n+            <para>Append to existing recording rather than replacing.</para>\n           </option>\n           <option name=\"n\">\n-            <para>Maximum number of digits, regardless of the sequence.</para>\n+            <para>Do not answer, but record anyway if line not yet answered.</para>\n           </option>\n           <option name=\"o\">\n-            <para>Enable override. Repeated KPs will clear all previous digits.</para>\n+            <para>\n+              Exit when 0 is pressed, setting the variable\n+              <variable>RECORD_STATUS</variable>\n+              to\n+              <literal>OPERATOR</literal>\n+              instead of\n+              <literal>DTMF</literal>\n+            </para>\n           </option>\n           <option name=\"q\">\n-            <para>Quelch MF from in-band.</para>\n-          </option>\n-          <option name=\"r\">\n-            <para>&quot;Radio&quot; mode (relaxed MF).</para>\n+            <para>quiet (do not play a beep tone).</para>\n           </option>\n           <option name=\"s\">\n-            <para>Do not return a character for ST digits.</para>\n+            <para>skip recording if the line is not yet answered.</para>\n+          </option>\n+          <option name=\"t\">\n+            <para>use alternate '*' terminator key (DTMF) instead of default '#'</para>\n+          </option>\n+          <option name=\"u\">\n+            <para>Don't truncate recorded silence.</para>\n+          </option>\n+          <option name=\"x\">\n+            <para>Ignore all terminator keys (DTMF) and keep recording until hangup.</para>\n+          </option>\n+          <option name=\"k\">\n+            <para>Keep recorded file upon hangup.</para>\n+          </option>\n+          <option name=\"y\">\n+            <para>Terminate recording if *any* DTMF digit is received.</para>\n           </option>\n         </optionlist>\n       </parameter>\n     </syntax>\n     <description>\n       <para>\n-        Reads a ST, STP, ST2P, or ST3P-terminated string of MF digits from\n-\t\t\tthe user in to the given\n-        <replaceable>variable</replaceable>\n-        .\n-      </para>\n-      <para>\n-        This application does not automatically answer the channel and\n-\t\t\tshould be preceded with\n-        <literal>Answer</literal>\n-        or\n-        <literal>Progress</literal>\n-        as needed.\n+        If filename contains\n+        <literal>%d</literal>\n+        , these characters will be replaced with a number\n+\t\t\tincremented by one each time the file is recorded.\n+\t\t\tUse\n+        <astcli>core show file formats</astcli>\n+        to see the available formats on your system\n+\t\t\tUser can press\n+        <literal>#</literal>\n+        to terminate the recording and continue to the next priority.\n+\t\t\tIf the user hangs up during a recording, all data will be lost and the application will terminate.\n       </para>\n       <variablelist>\n-        <variable name=\"RECEIVEMFSTATUS\">\n-          <para>This is the status of the read operation.</para>\n-          <value name=\"START\"/>\n-          <value name=\"ERROR\"/>\n-          <value name=\"HANGUP\"/>\n-          <value name=\"MAXDIGITS\"/>\n-          <value name=\"TIMEOUT\"/>\n+        <variable name=\"RECORDED_FILE\">\n+          <para>Will be set to the final filename of the recording, without an extension.</para>\n+        </variable>\n+        <variable name=\"RECORD_STATUS\">\n+          <para>This is the final status of the command</para>\n+          <value name=\"DTMF\">A terminating DTMF was received ('#' or '*', depending upon option 't')</value>\n+          <value name=\"SILENCE\">The maximum silence occurred in the recording.</value>\n+          <value name=\"SKIP\">The line was not yet answered and the 's' option was specified.</value>\n+          <value name=\"TIMEOUT\">The maximum length was reached.</value>\n+          <value name=\"HANGUP\">The channel was hung up.</value>\n+          <value name=\"ERROR\">An unrecoverable error occurred, which resulted in a WARNING to the logs.</value>\n         </variable>\n       </variablelist>\n     </description>\n-    <see-also>\n-      <ref type=\"application\">Read</ref>\n-      <ref type=\"application\">SendMF</ref>\n-      <ref type=\"application\">ReceiveSF</ref>\n-    </see-also>\n   </application>\n-  <application name=\"SendMF\" language=\"en_US\">\n-    <since>\n-      <version>16.21.0</version>\n-      <version>18.7.0</version>\n-      <version>19.0.0</version>\n-    </since>\n-    <synopsis>Sends arbitrary MF digits on the current or specified channel.</synopsis>\n+  <module language=\"en_US\" name=\"app_userevent\">\n+    <support_level>core</support_level>\n+  </module>\n+  <application name=\"UserEvent\" language=\"en_US\">\n+    <synopsis>Send an arbitrary user-defined event to parties interested in a channel (AMI users and relevant res_stasis applications).</synopsis>\n     <syntax>\n-      <parameter name=\"digits\" required=\"true\">\n-        <para>List of digits 0-9,*#ABC to send; w for a half-second pause,\n-\t\t\t\talso f or F for a flash-hook if the channel supports flash-hook,\n-\t\t\t\th or H for 250 ms of 2600 Hz,\n-\t\t\t\tand W for a wink if the channel supports wink.</para>\n-        <para>Key pulse and start digits are not included automatically.\n-\t\t\t\t* is used for KP, # for ST, A for STP, B for ST2P, and C for ST3P.</para>\n-      </parameter>\n-      <parameter name=\"timeout_ms\" required=\"false\">\n-        <para>Amount of time to wait in ms between tones. (defaults to 50ms).</para>\n-      </parameter>\n-      <parameter name=\"duration_ms\" required=\"false\">\n-        <para>Duration of each numeric digit (defaults to 55ms).</para>\n-      </parameter>\n-      <parameter name=\"duration_ms_kp\" required=\"false\">\n-        <para>Duration of KP digits (defaults to 120ms).</para>\n-      </parameter>\n-      <parameter name=\"duration_ms_st\" required=\"false\">\n-        <para>Duration of ST, STP, ST2P, and ST3P digits (defaults to 65ms).</para>\n-      </parameter>\n-      <parameter name=\"channel\" required=\"false\">\n-        <para>Channel where digits will be played</para>\n-      </parameter>\n+      <parameter name=\"eventname\" required=\"true\"/>\n+      <parameter name=\"body\"/>\n     </syntax>\n     <description>\n-      <para>It will send all digits or terminate if it encounters an error.</para>\n+      <para>\n+        Sends an arbitrary event to interested parties, with an optional\n+        <replaceable>body</replaceable>\n+        representing additional arguments. The\n+        <replaceable>body</replaceable>\n+        may be specified as\n+\t\t\ta\n+        <literal>,</literal>\n+        delimited list of key:value pairs.\n+      </para>\n+      <para>For AMI, each additional argument will be placed on a new line in\n+\t\t\tthe event and the format of the event will be:</para>\n+      <para>Event: UserEvent</para>\n+      <para>UserEvent: &lt;specified event name&gt;</para>\n+      <para>[body]</para>\n+      <para>\n+        If no\n+        <replaceable>body</replaceable>\n+        is specified, only Event and\n+\t\t\tUserEvent headers will be present.\n+      </para>\n+      <para>\n+        For res_stasis applications, the event will be provided as a JSON\n+\t\t\tblob with additional arguments appearing as keys in the object and the\n+        <replaceable>eventname</replaceable>\n+        under the\n+        <literal>eventname</literal>\n+        key.\n+      </para>\n     </description>\n     <see-also>\n-      <ref type=\"application\">ReceiveMF</ref>\n-      <ref type=\"application\">SendSF</ref>\n-      <ref type=\"application\">SendDTMF</ref>\n+      <ref type=\"manager\">UserEvent</ref>\n+      <ref type=\"managerEvent\">UserEvent</ref>\n     </see-also>\n   </application>\n-  <manager name=\"PlayMF\" language=\"en_US\">\n-    <since>\n-      <version>16.21.0</version>\n-      <version>18.7.0</version>\n-      <version>19.0.0</version>\n-    </since>\n-    <synopsis>Play MF digit on a specific channel.</synopsis>\n-    <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"Channel\" required=\"true\">\n-        <para>Channel name to send digit to.</para>\n-      </parameter>\n-      <parameter name=\"Digit\" required=\"true\">\n-        <para>The MF digit to play.</para>\n-      </parameter>\n-      <parameter name=\"Duration\" required=\"false\">\n-        <para>The duration, in milliseconds, of the digit to be played.</para>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>Plays an MF digit on the specified channel.</para>\n-    </description>\n-  </manager>\n-  <module language=\"en_US\" name=\"app_image\">\n-    <support_level>deprecated</support_level>\n-    <deprecated_in>16</deprecated_in>\n-    <removed_in>19</removed_in>\n+  <module language=\"en_US\" name=\"app_externalivr\">\n+    <support_level>extended</support_level>\n   </module>\n-  <application name=\"SendImage\" language=\"en_US\">\n-    <synopsis>Sends an image file.</synopsis>\n+  <application name=\"ExternalIVR\" language=\"en_US\">\n+    <synopsis>Interfaces with an external IVR application.</synopsis>\n     <syntax>\n-      <parameter name=\"filename\" required=\"true\">\n-        <para>Path of the filename (image) to send.</para>\n+      <parameter name=\"command|ivr://host\" required=\"true\" hasparams=\"true\">\n+        <argument name=\"arg1\"/>\n+        <argument name=\"arg2\" multiple=\"yes\"/>\n+      </parameter>\n+      <parameter name=\"options\">\n+        <optionlist>\n+          <option name=\"n\">\n+            <para>Tells ExternalIVR() not to answer the channel.</para>\n+          </option>\n+          <option name=\"i\">\n+            <para>\n+              Tells ExternalIVR() not to send a hangup and exit when the\n+\t\t\t\t\t\tchannel receives a hangup, instead it sends an\n+              <literal>I</literal>\n+              informative message meaning that the external application MUST hang\n+\t\t\t\t\t\tup the call with an\n+              <literal>H</literal>\n+              command.\n+            </para>\n+          </option>\n+          <option name=\"d\">\n+            <para>\n+              Tells ExternalIVR() to run on a channel that has been hung up\n+\t\t\t\t\t\tand will not look for hangups. The external application must exit with\n+\t\t\t\t\t\tan\n+              <literal>E</literal>\n+              command.\n+            </para>\n+          </option>\n+        </optionlist>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>Send an image file on a channel supporting it.</para>\n       <para>\n-        Result of transmission will be stored in\n-        <variable>SENDIMAGESTATUS</variable>\n+        Either forks a process to run given command or makes a socket to connect\n+\t\t\tto given host and starts a generator on the channel. The generator's play list\n+\t\t\tis controlled by the external application, which can add and clear entries via\n+\t\t\tsimple commands issued over its stdout. The external application will receive\n+\t\t\tall DTMF events received on the channel, and notification if the channel is\n+\t\t\thung up. The received on the channel, and notification if the channel is hung\n+\t\t\tup. The application will not be forcibly terminated when the channel is hung up.\n+\t\t\tFor more information see\n+        <filename>doc/AST.pdf</filename>\n+        .\n       </para>\n-      <variablelist>\n-        <variable name=\"SENDIMAGESTATUS\">\n-          <value name=\"SUCCESS\">Transmission succeeded.</value>\n-          <value name=\"FAILURE\">Transmission failed.</value>\n-          <value name=\"UNSUPPORTED\">Image transmission not supported by channel.</value>\n-        </variable>\n-      </variablelist>\n     </description>\n-    <see-also>\n-      <ref type=\"application\">SendText</ref>\n-      <ref type=\"application\">SendURL</ref>\n-    </see-also>\n   </application>\n-  <module language=\"en_US\" name=\"app_celgenuserevent\">\n+  <module language=\"en_US\" name=\"app_sayunixtime\">\n     <support_level>core</support_level>\n   </module>\n-  <application name=\"CELGenUserEvent\" language=\"en_US\">\n-    <synopsis>Generates a CEL User Defined Event.</synopsis>\n+  <application name=\"SayUnixTime\" language=\"en_US\">\n+    <synopsis>Says a specified time in a custom format.</synopsis>\n     <syntax>\n-      <parameter name=\"event-name\" required=\"true\">\n-        <argument name=\"event-name\" required=\"true\"/>\n-        <argument name=\"extra\" required=\"false\">\n-          <para>Extra text to be included with the event.</para>\n-        </argument>\n+      <parameter name=\"unixtime\" required=\"false\">\n+        <para>time, in seconds since Jan 1, 1970.  May be negative. Defaults to now.</para>\n+      </parameter>\n+      <parameter name=\"timezone\" required=\"false\">\n+        <para>\n+          timezone, see\n+          <directory>/usr/share/zoneinfo</directory>\n+          for a list. Defaults to machine default.\n+        </para>\n+      </parameter>\n+      <parameter name=\"format\" required=\"false\">\n+        <para>\n+          a format the time is to be said in.  See\n+          <filename>voicemail.conf</filename>\n+          .\n+\t\t\t\tDefaults to\n+          <literal>ABdY &quot;digits/at&quot; IMp</literal>\n+        </para>\n+      </parameter>\n+      <parameter name=\"options\" required=\"false\">\n+        <optionlist>\n+          <option name=\"j\">\n+            <para>\n+              Allow the calling user to dial digits to jump to that extension.\n+\t\t\t\t\t\tThis option is automatically enabled if\n+              <variable>SAY_DTMF_INTERRUPT</variable>\n+              is present on the channel and\n+\t\t\t\t\t\tset to 'true' (case insensitive)\n+            </para>\n+          </option>\n+        </optionlist>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>A CEL event will be immediately generated by this channel, with the supplied name for a type.</para>\n+      <para>\n+        Uses some of the sound files stored in\n+        <directory>/var/lib/asterisk/sounds</directory>\n+        to construct a phrase\n+\t\t\tsaying the specified date and/or time in the specified format.\n+      </para>\n     </description>\n+    <see-also>\n+      <ref type=\"function\">STRFTIME</ref>\n+      <ref type=\"function\">STRPTIME</ref>\n+      <ref type=\"function\">IFTIME</ref>\n+    </see-also>\n   </application>\n-  <module language=\"en_US\" name=\"app_originate\">\n-    <support_level>core</support_level>\n-  </module>\n-  <application name=\"Originate\" language=\"en_US\">\n-    <synopsis>Originate a call.</synopsis>\n+  <application name=\"DateTime\" language=\"en_US\">\n+    <synopsis>Says a specified time in a custom format.</synopsis>\n     <syntax>\n-      <parameter name=\"tech_data\" required=\"true\">\n-        <para>Channel technology and data for creating the outbound channel.\n-                      For example, SIP/1234.</para>\n+      <parameter name=\"unixtime\">\n+        <para>time, in seconds since Jan 1, 1970.  May be negative. Defaults to now.</para>\n       </parameter>\n-      <parameter name=\"type\" required=\"true\">\n+      <parameter name=\"timezone\">\n         <para>\n-          This should be\n-          <literal>app</literal>\n-          or\n-          <literal>exten</literal>\n-          , depending on whether the outbound channel should be connected to an application or extension.\n+          timezone, see\n+          <filename>/usr/share/zoneinfo</filename>\n+          for a list. Defaults to machine default.\n         </para>\n       </parameter>\n-      <parameter name=\"arg1\" required=\"true\">\n+      <parameter name=\"format\">\n         <para>\n-          If the type is\n-          <literal>app</literal>\n-          , then this is the application name.  If the type is\n-          <literal>exten</literal>\n-          , then this is the context that the channel will be sent to.\n+          a format the time is to be said in.  See\n+          <filename>voicemail.conf</filename>\n+          .\n+\t\t\t\tDefaults to\n+          <literal>ABdY &quot;digits/at&quot; IMp</literal>\n         </para>\n       </parameter>\n-      <parameter name=\"arg2\" required=\"false\">\n+    </syntax>\n+    <description>\n+      <para>Say the date and time in a specified format.</para>\n+    </description>\n+  </application>\n+  <module language=\"en_US\" name=\"app_waitforcond\">\n+    <support_level>extended</support_level>\n+  </module>\n+  <application name=\"WaitForCondition\" language=\"en_US\">\n+    <since>\n+      <version>16.20.0</version>\n+      <version>18.6.0</version>\n+      <version>19.0.0</version>\n+    </since>\n+    <synopsis>Wait (sleep) until the given condition is true.</synopsis>\n+    <syntax>\n+      <parameter name=\"replacementchar\" required=\"true\">\n         <para>\n-          If the type is\n-          <literal>app</literal>\n-          , then this is the data passed as arguments to the application.  If the type is\n-          <literal>exten</literal>\n-          , then this is the extension that the channel will be sent to.\n+          Specifies the character in the expression used to replace the\n+          <literal>$</literal>\n+          character. This character should not be used anywhere in the expression itself.\n         </para>\n       </parameter>\n-      <parameter name=\"arg3\" required=\"false\">\n+      <parameter name=\"expression\" required=\"true\">\n         <para>\n-          If the type is\n-          <literal>exten</literal>\n-          , then this is the priority that the channel is sent to.  If the type is\n-          <literal>app</literal>\n-          , then this parameter is ignored.\n+          A modified logical expression with the\n+          <literal>$</literal>\n+          characters replaced by\n+          <replaceable>replacementchar</replaceable>\n+          . This is necessary to pass the expression itself\n+\t\t\t\tinto the application, rather than its initial evaluation.\n         </para>\n       </parameter>\n-      <parameter name=\"timeout\" required=\"false\">\n-        <para>Timeout in seconds. Default is 30 seconds.</para>\n+      <parameter name=\"timeout\">\n+        <para>The maximum amount of time, in seconds, this application should wait for a condition\n+\t\t\t\tto become true before dialplan execution continues automatically to the next priority.\n+\t\t\t\tBy default, there is no timeout.</para>\n       </parameter>\n-      <parameter name=\"options\" required=\"false\">\n-        <optionlist>\n-          <option name=\"a\">\n-            <para>Originate asynchronously.  In other words, continue in the dialplan\n-\t\t\t\t\twithout waiting for the originated channel to answer.</para>\n-          </option>\n-          <option name=\"b\" argsep=\"^\">\n-            <para>Before originating the outgoing call, Gosub to the specified\n-\t\t\t\t\tlocation using the newly created channel.</para>\n-            <argument name=\"context\" required=\"false\"/>\n-            <argument name=\"exten\" required=\"false\"/>\n-            <argument name=\"priority\" required=\"true\" hasparams=\"optional\" argsep=\"^\">\n-              <argument name=\"arg1\" multiple=\"true\" required=\"true\"/>\n-              <argument name=\"argN\"/>\n-            </argument>\n-          </option>\n-          <option name=\"B\" argsep=\"^\">\n-            <para>Before originating the outgoing call, Gosub to the specified\n-\t\t\t\t\tlocation using the current channel.</para>\n-            <argument name=\"context\" required=\"false\"/>\n-            <argument name=\"exten\" required=\"false\"/>\n-            <argument name=\"priority\" required=\"true\" hasparams=\"optional\" argsep=\"^\">\n-              <argument name=\"arg1\" multiple=\"true\" required=\"true\"/>\n-              <argument name=\"argN\"/>\n-            </argument>\n-          </option>\n-          <option name=\"C\">\n-            <para>\n-              Comma-separated list of codecs to use for this call.\n-\t\t\t\t\tDefault is\n-              <literal>slin</literal>\n-              .\n-            </para>\n-          </option>\n-          <option name=\"c\">\n-            <para>The caller ID number to use for the called channel. Default is\n-\t\t\t\t\tthe current channel's Caller ID number.</para>\n-          </option>\n-          <option name=\"n\">\n-            <para>The caller ID name to use for the called channel. Default is\n-\t\t\t\t\tthe current channel's Caller ID name.</para>\n-          </option>\n-          <option name=\"v\" argsep=\"^\">\n-            <para>A series of channel variables to set on the destination channel.</para>\n-            <argument name=\"var1\" multiple=\"true\" argsep=\"=\">\n-              <argument name=\"name\" required=\"true\"/>\n-              <argument name=\"value\" required=\"true\"/>\n-            </argument>\n-          </option>\n-        </optionlist>\n+      <parameter name=\"interval\">\n+        <para>The frequency, in seconds, of polling the condition, which can be adjusted depending\n+\t\t\t\ton how time-sensitive execution needs to be. By default, this is 0.05.</para>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>This application originates an outbound call and connects it to a specified extension or application.  This application will block until the outgoing call fails or gets answered, unless the async option is used.  At that point, this application will exit with the status variable set and dialplan processing will continue.</para>\n-      <para>This application sets the following channel variable before exiting:</para>\n+      <para>\n+        Waits until\n+        <replaceable>expression</replaceable>\n+        evaluates to true, checking every\n+        <replaceable>interval</replaceable>\n+        seconds for up to\n+        <replaceable>timeout</replaceable>\n+        . Default\n+\t\t\tis evaluate\n+        <replaceable>expression</replaceable>\n+        every 50 milliseconds with no timeout.\n+      </para>\n+      <example title=\"Wait for condition dialplan variable/function to become 1 for up to 40 seconds, checking every 500ms\">same =&gt; n,WaitForCondition(#,#[&quot;#{condition}&quot;=&quot;1&quot;],40,0.5)</example>\n+      <para>\n+        Sets\n+        <variable>WAITFORCONDITIONSTATUS</variable>\n+        to one of the following values:\n+      </para>\n       <variablelist>\n-        <variable name=\"ORIGINATE_STATUS\">\n-          <para>This indicates the result of the call origination.</para>\n-          <value name=\"FAILED\"/>\n-          <value name=\"SUCCESS\"/>\n-          <value name=\"BUSY\"/>\n-          <value name=\"CONGESTION\"/>\n-          <value name=\"HANGUP\"/>\n-          <value name=\"RINGING\"/>\n-          <value name=\"UNKNOWN\">In practice, you should never see this value.  Please report it to the issue tracker if you ever see it.</value>\n+        <variable name=\"WAITFORCONDITIONSTATUS\">\n+          <value name=\"TRUE\">Condition evaluated to true before timeout expired.</value>\n+          <value name=\"FAILURE\">Invalid argument.</value>\n+          <value name=\"TIMEOUT\">Timeout elapsed without condition evaluating to true.</value>\n+          <value name=\"HANGUP\">Channel hung up before condition became true.</value>\n         </variable>\n       </variablelist>\n     </description>\n   </application>\n-  <module language=\"en_US\" name=\"app_stack\">\n-    <use type=\"module\">res_agi</use>\n+  <module language=\"en_US\" name=\"app_while\">\n     <support_level>core</support_level>\n   </module>\n-  <application name=\"Gosub\" language=\"en_US\">\n-    <synopsis>Jump to label, saving return address.</synopsis>\n+  <application name=\"While\" language=\"en_US\">\n+    <synopsis>Start a while loop.</synopsis>\n     <syntax>\n-      <parameter name=\"context\"/>\n-      <parameter name=\"exten\"/>\n-      <parameter name=\"priority\" required=\"true\" hasparams=\"optional\">\n-        <argument name=\"arg1\" multiple=\"true\" required=\"true\"/>\n-        <argument name=\"argN\"/>\n-      </parameter>\n+      <parameter name=\"expr\" required=\"true\"/>\n     </syntax>\n     <description>\n-      <para>Jumps to the label specified, saving the return address.</para>\n+      <para>\n+        Start a While Loop.  Execution will return to this point when\n+        <literal>EndWhile()</literal>\n+        is called until expr is no longer true.\n+      </para>\n     </description>\n     <see-also>\n-      <ref type=\"application\">GosubIf</ref>\n-      <ref type=\"application\">Macro</ref>\n-      <ref type=\"application\">Goto</ref>\n-      <ref type=\"application\">Return</ref>\n-      <ref type=\"application\">StackPop</ref>\n+      <ref type=\"application\">EndWhile</ref>\n+      <ref type=\"application\">ExitWhile</ref>\n+      <ref type=\"application\">ContinueWhile</ref>\n     </see-also>\n   </application>\n-  <application name=\"GosubIf\" language=\"en_US\">\n-    <synopsis>Conditionally jump to label, saving return address.</synopsis>\n-    <syntax argsep=\"?\">\n-      <parameter name=\"condition\" required=\"true\"/>\n-      <parameter name=\"destination\" required=\"true\" argsep=\":\">\n-        <argument name=\"labeliftrue\" hasparams=\"optional\">\n-          <para>\n-            Continue at\n-            <replaceable>labeliftrue</replaceable>\n-            if the condition is true.\n-\t\t\t\t\tTakes the form similar to Goto() of [[context,]extension,]priority.\n-          </para>\n-          <argument name=\"arg1\" required=\"true\" multiple=\"true\"/>\n-          <argument name=\"argN\"/>\n-        </argument>\n-        <argument name=\"labeliffalse\" hasparams=\"optional\">\n-          <para>\n-            Continue at\n-            <replaceable>labeliffalse</replaceable>\n-            if the condition is false.\n-\t\t\t\t\tTakes the form similar to Goto() of [[context,]extension,]priority.\n-          </para>\n-          <argument name=\"arg1\" required=\"true\" multiple=\"true\"/>\n-          <argument name=\"argN\"/>\n-        </argument>\n-      </parameter>\n-    </syntax>\n+  <application name=\"EndWhile\" language=\"en_US\">\n+    <synopsis>End a while loop.</synopsis>\n+    <syntax/>\n     <description>\n-      <para>If the condition is true, then jump to labeliftrue.  If false, jumps to\n-\t\t\tlabeliffalse, if specified.  In either case, a jump saves the return point\n-\t\t\tin the dialplan, to be returned to with a Return.</para>\n+      <para>\n+        Return to the previous called\n+        <literal>While()</literal>\n+        .\n+      </para>\n     </description>\n     <see-also>\n-      <ref type=\"application\">Gosub</ref>\n-      <ref type=\"application\">Return</ref>\n-      <ref type=\"application\">MacroIf</ref>\n-      <ref type=\"function\">IF</ref>\n-      <ref type=\"application\">GotoIf</ref>\n-      <ref type=\"application\">Goto</ref>\n+      <ref type=\"application\">While</ref>\n+      <ref type=\"application\">ExitWhile</ref>\n+      <ref type=\"application\">ContinueWhile</ref>\n     </see-also>\n   </application>\n-  <application name=\"Return\" language=\"en_US\">\n-    <synopsis>Return from gosub routine.</synopsis>\n-    <syntax>\n-      <parameter name=\"value\">\n-        <para>Return value.</para>\n-      </parameter>\n-    </syntax>\n+  <application name=\"ExitWhile\" language=\"en_US\">\n+    <synopsis>End a While loop.</synopsis>\n+    <syntax/>\n     <description>\n       <para>\n-        Jumps to the last label on the stack, removing it. The return\n-        <replaceable>value</replaceable>\n-        , if\n-\t\t\tany, is saved in the channel variable\n-        <variable>GOSUB_RETVAL</variable>\n-        .\n+        Exits a\n+        <literal>While()</literal>\n+        loop, whether or not the conditional has been satisfied.\n       </para>\n     </description>\n     <see-also>\n-      <ref type=\"application\">Gosub</ref>\n-      <ref type=\"application\">StackPop</ref>\n+      <ref type=\"application\">While</ref>\n+      <ref type=\"application\">EndWhile</ref>\n+      <ref type=\"application\">ContinueWhile</ref>\n     </see-also>\n   </application>\n-  <application name=\"StackPop\" language=\"en_US\">\n-    <synopsis>Remove one address from gosub stack.</synopsis>\n+  <application name=\"ContinueWhile\" language=\"en_US\">\n+    <synopsis>Restart a While loop.</synopsis>\n     <syntax/>\n     <description>\n-      <para>Removes last label on the stack, discarding it.</para>\n+      <para>Returns to the top of the while loop and re-evaluates the conditional.</para>\n     </description>\n     <see-also>\n-      <ref type=\"application\">Return</ref>\n-      <ref type=\"application\">Gosub</ref>\n+      <ref type=\"application\">While</ref>\n+      <ref type=\"application\">EndWhile</ref>\n+      <ref type=\"application\">ExitWhile</ref>\n     </see-also>\n   </application>\n-  <function name=\"LOCAL\" language=\"en_US\">\n-    <synopsis>Manage variables local to the gosub stack frame.</synopsis>\n+  <module language=\"en_US\" name=\"app_celgenuserevent\">\n+    <support_level>core</support_level>\n+  </module>\n+  <application name=\"CELGenUserEvent\" language=\"en_US\">\n+    <synopsis>Generates a CEL User Defined Event.</synopsis>\n     <syntax>\n-      <parameter name=\"varname\" required=\"true\"/>\n+      <parameter name=\"event-name\" required=\"true\">\n+        <argument name=\"event-name\" required=\"true\"/>\n+        <argument name=\"extra\" required=\"false\">\n+          <para>Extra text to be included with the event.</para>\n+        </argument>\n+      </parameter>\n     </syntax>\n     <description>\n-      <para>Read and write a variable local to the gosub stack frame, once we Return() it will be lost\n-\t\t\t(or it will go back to whatever value it had before the Gosub()).</para>\n+      <para>A CEL event will be immediately generated by this channel, with the supplied name for a type.</para>\n     </description>\n-    <see-also>\n-      <ref type=\"application\">Gosub</ref>\n-      <ref type=\"application\">GosubIf</ref>\n-      <ref type=\"application\">Return</ref>\n-    </see-also>\n-  </function>\n-  <function name=\"LOCAL_PEEK\" language=\"en_US\">\n-    <synopsis>Retrieve variables hidden by the local gosub stack frame.</synopsis>\n+  </application>\n+  <module language=\"en_US\" name=\"app_milliwatt\">\n+    <support_level>core</support_level>\n+  </module>\n+  <application name=\"Milliwatt\" language=\"en_US\">\n+    <synopsis>Generates a 1004 Hz test tone at 0dbm (mu-law).</synopsis>\n     <syntax>\n-      <parameter name=\"n\" required=\"true\"/>\n-      <parameter name=\"varname\" required=\"true\"/>\n+      <parameter name=\"options\">\n+        <optionlist>\n+          <option name=\"m\">\n+            <para>Generate a 1004 Hz Milliwatt test tone at 0dbm, with a\n+\t\t\t\t\t\t1 second silent interval. This option must be specified\n+\t\t\t\t\t\tif you are using this for a milliwatt test line.</para>\n+          </option>\n+          <option name=\"o\">\n+            <para>Generate a constant tone at 1000 Hz like previous version.</para>\n+          </option>\n+        </optionlist>\n+      </parameter>\n     </syntax>\n     <description>\n+      <para>Generates a 1004 Hz test tone.</para>\n       <para>\n-        Read a variable\n-        <replaceable>varname</replaceable>\n-        hidden by\n-        <replaceable>n</replaceable>\n-        levels of gosub stack frames.  Note that ${LOCAL_PEEK(0,foo)}\n-\t\t\tis the same as\n-        <variable>foo</variable>\n-        , since the value of\n-        <replaceable>n</replaceable>\n-        peeks under 0 levels of stack frames; in other words, 0 is the current level.  If\n-        <replaceable>n</replaceable>\n-        exceeds the available number of stack frames, then an empty\n-\t\t\tstring is returned.\n+        By default, this application does not provide a Milliwatt test tone. It simply\n+\t\t\tplays a 1004 Hz tone, which is not suitable for performing a milliwatt test.\n+\t\t\tThe\n+        <literal>m</literal>\n+        option should be used so that a real Milliwatt test tone\n+\t\t\tis provided. This will include a 1 second silent interval every 10 seconds.\n+      </para>\n+      <para>\n+        Previous versions of this application generated a constant tone at 1000 Hz. If for\n+\t\t\tsome reason you would prefer that behavior, supply the\n+        <literal>o</literal>\n+        option to get the\n+\t\t\told behavior.\n       </para>\n     </description>\n-    <see-also>\n-      <ref type=\"application\">Gosub</ref>\n-      <ref type=\"application\">GosubIf</ref>\n-      <ref type=\"application\">Return</ref>\n-    </see-also>\n-  </function>\n-  <function name=\"STACK_PEEK\" language=\"en_US\">\n-    <synopsis>View info about the location which called Gosub</synopsis>\n+  </application>\n+  <module language=\"en_US\" name=\"app_directed_pickup\">\n+    <support_level>core</support_level>\n+  </module>\n+  <application name=\"Pickup\" language=\"en_US\">\n+    <synopsis>Directed extension call pickup.</synopsis>\n     <syntax>\n-      <parameter name=\"n\" required=\"true\"/>\n-      <parameter name=\"which\" required=\"true\"/>\n-      <parameter name=\"suppress\" required=\"false\"/>\n+      <parameter name=\"targets\" argsep=\"&amp;\">\n+        <argument name=\"extension\" argsep=\"@\" required=\"true\">\n+          <para>Specification of the pickup target.</para>\n+          <argument name=\"extension\" required=\"true\"/>\n+          <argument name=\"context\"/>\n+        </argument>\n+        <argument name=\"extension2\" argsep=\"@\" multiple=\"true\">\n+          <para>Additional specifications of pickup targets.</para>\n+          <argument name=\"extension2\" required=\"true\"/>\n+          <argument name=\"context2\"/>\n+        </argument>\n+      </parameter>\n     </syntax>\n     <description>\n+      <para>This application can pickup a specified ringing channel.  The channel\n+\t\t\tto pickup can be specified in the following ways.</para>\n       <para>\n-        Read the calling\n-        <literal>c</literal>\n-        ontext,\n-        <literal>e</literal>\n-        xtension,\n-        <literal>p</literal>\n-        riority, or\n-        <literal>l</literal>\n-        abel, as specified by\n-        <replaceable>which</replaceable>\n-        , by going up\n-        <replaceable>n</replaceable>\n-        frames\n-\t\t\tin the Gosub stack.  If\n-        <replaceable>suppress</replaceable>\n-        is true, then if the\n-\t\t\tnumber of available stack frames is exceeded, then no error message will be\n-\t\t\tprinted.\n+        1) If no\n+        <replaceable>extension</replaceable>\n+        targets are specified,\n+\t\t\tthe application will pickup a channel matching the pickup group of the\n+\t\t\trequesting channel.\n       </para>\n-    </description>\n-  </function>\n-  <agi name=\"gosub\" language=\"en_US\">\n-    <synopsis>Cause the channel to execute the specified dialplan subroutine.</synopsis>\n-    <syntax>\n-      <parameter name=\"context\" required=\"true\"/>\n-      <parameter name=\"extension\" required=\"true\"/>\n-      <parameter name=\"priority\" required=\"true\"/>\n-      <parameter name=\"optional-argument\"/>\n-    </syntax>\n-    <description>\n-      <para>Cause the channel to execute the specified dialplan subroutine,\n-\t\t\treturning to the dialplan with execution of a Return().</para>\n-    </description>\n-    <see-also>\n-      <ref type=\"application\">GoSub</ref>\n-    </see-also>\n-  </agi>\n-  <managerEvent language=\"en_US\" name=\"VarSet\">\n-    <managerEventInstance class=\"EVENT_FLAG_DIALPLAN\">\n-      <synopsis>Raised when a variable local to the gosub stack frame is set due to a subroutine call.</synopsis>\n-      <syntax>\n-        <channel_snapshot/>\n-        <parameter name=\"Variable\">\n-          <para>The LOCAL variable being set.</para>\n-          <note>\n-            <para>\n-              The variable name will always be enclosed with\n-              <literal>LOCAL()</literal>\n-            </para>\n-          </note>\n-        </parameter>\n-        <parameter name=\"Value\">\n-          <para>The new value of the variable.</para>\n-        </parameter>\n-      </syntax>\n-      <see-also>\n-        <ref type=\"application\">GoSub</ref>\n-        <ref type=\"agi\">gosub</ref>\n-        <ref type=\"function\">LOCAL</ref>\n-        <ref type=\"function\">LOCAL_PEEK</ref>\n-      </see-also>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <module language=\"en_US\" name=\"app_test\">\n-    <support_level>extended</support_level>\n-  </module>\n-  <application name=\"TestServer\" language=\"en_US\">\n-    <synopsis>Execute Interface Test Server.</synopsis>\n-    <syntax/>\n-    <description>\n       <para>\n-        Perform test server function and write call report. Results stored in\n-        <filename>/var/log/asterisk/testreports/&lt;testid&gt;-server.txt</filename>\n+        2) If the\n+        <replaceable>extension</replaceable>\n+        is specified with a\n+        <replaceable>context</replaceable>\n+        of the special string\n+        <literal>PICKUPMARK</literal>\n+        (for example 10@PICKUPMARK), the application\n+\t\t\twill pickup a channel which has defined the channel variable\n+        <variable>PICKUPMARK</variable>\n+        with the same value as\n+        <replaceable>extension</replaceable>\n+        (in this example,\n+        <literal>10</literal>\n+        ).\n+      </para>\n+      <para>\n+        3) If the\n+        <replaceable>extension</replaceable>\n+        is specified\n+\t\t\twith or without a\n+        <replaceable>context</replaceable>\n+        , the channel with a\n+\t\t\tmatching\n+        <replaceable>extension</replaceable>\n+        and\n+        <replaceable>context</replaceable>\n+        will be picked up.  If no\n+        <replaceable>context</replaceable>\n+        is specified,\n+\t\t\tthe current context will be used.\n       </para>\n+      <note>\n+        <para>\n+          The\n+          <replaceable>extension</replaceable>\n+          is typically set on\n+\t\t\tmatching channels by the dial application that created the channel.  The\n+          <replaceable>context</replaceable>\n+          is set on matching channels by the\n+\t\t\tchannel driver for the device.\n+        </para>\n+      </note>\n     </description>\n-    <see-also>\n-      <ref type=\"application\">TestClient</ref>\n-    </see-also>\n   </application>\n-  <application name=\"TestClient\" language=\"en_US\">\n-    <synopsis>Execute Interface Test Client.</synopsis>\n+  <application name=\"PickupChan\" language=\"en_US\">\n+    <synopsis>Pickup a ringing channel.</synopsis>\n     <syntax>\n-      <parameter name=\"testid\" required=\"true\">\n-        <para>An ID to identify this test.</para>\n+      <parameter name=\"channel\" argsep=\"&amp;\" required=\"true\">\n+        <argument name=\"channel\" required=\"true\"/>\n+        <argument name=\"channel2\" required=\"false\" multiple=\"true\"/>\n+        <para>\n+          List of channel names or channel uniqueids to pickup if ringing.\n+\t\t\t\t\tFor example, a channel name could be\n+          <literal>SIP/bob</literal>\n+          or\n+          <literal>SIP/bob-00000000</literal>\n+          to find\n+          <literal>SIP/bob-00000000</literal>\n+          .\n+        </para>\n+      </parameter>\n+      <parameter name=\"options\" required=\"false\">\n+        <optionlist>\n+          <option name=\"p\">\n+            <para>\n+              Supplied channel names are prefixes.  For example,\n+              <literal>SIP/bob</literal>\n+              will match\n+              <literal>SIP/bob-00000000</literal>\n+              and\n+              <literal>SIP/bobby-00000000</literal>\n+              .\n+            </para>\n+          </option>\n+        </optionlist>\n       </parameter>\n     </syntax>\n     <description>\n       <para>\n-        Executes test client with given\n-        <replaceable>testid</replaceable>\n-        . Results stored in\n-        <filename>/var/log/asterisk/testreports/&lt;testid&gt;-client.txt</filename>\n+        Pickup a specified\n+        <replaceable>channel</replaceable>\n+        if ringing.\n       </para>\n     </description>\n-    <see-also>\n-      <ref type=\"application\">TestServer</ref>\n-    </see-also>\n   </application>\n   <module language=\"en_US\" name=\"app_chanisavail\">\n     <support_level>extended</support_level>\n   </module>\n   <application name=\"ChanIsAvail\" language=\"en_US\">\n     <synopsis>Check channel availability</synopsis>\n     <syntax>\n@@ -13699,207 +12794,554 @@\n         </variable>\n         <variable name=\"AVAILCAUSECODE\">\n           <para>The cause code returned when requesting the channel</para>\n         </variable>\n       </variablelist>\n     </description>\n   </application>\n-  <module language=\"en_US\" name=\"app_playtones\">\n+  <module language=\"en_US\" name=\"app_talkdetect\">\n     <support_level>core</support_level>\n   </module>\n-  <application name=\"PlayTones\" language=\"en_US\">\n-    <synopsis>Play a tone list.</synopsis>\n+  <application name=\"BackgroundDetect\" language=\"en_US\">\n+    <synopsis>Background a file with talk detect.</synopsis>\n     <syntax>\n-      <parameter name=\"arg\" required=\"true\">\n+      <parameter name=\"filename\" required=\"true\"/>\n+      <parameter name=\"sil\">\n         <para>\n-          Arg is either the tone name defined in the\n-          <filename>indications.conf</filename>\n-          configuration file, or a directly specified list of frequencies and durations.\n+          If not specified, defaults to\n+          <literal>1000</literal>\n+          .\n+        </para>\n+      </parameter>\n+      <parameter name=\"min\">\n+        <para>\n+          If not specified, defaults to\n+          <literal>100</literal>\n+          .\n+        </para>\n+      </parameter>\n+      <parameter name=\"max\">\n+        <para>\n+          If not specified, defaults to\n+          <literal>infinity</literal>\n+          .\n+        </para>\n+      </parameter>\n+      <parameter name=\"analysistime\">\n+        <para>\n+          If not specified, defaults to\n+          <literal>infinity</literal>\n+          .\n         </para>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>Plays a tone list. Execution will continue with the next step in the dialplan\n-\t\t\timmediately while the tones continue to play.</para>\n       <para>\n-        See the sample\n-        <filename>indications.conf</filename>\n-        for a description of the\n-\t\t\tspecification of a tonelist.\n+        Plays back\n+        <replaceable>filename</replaceable>\n+        , waiting for interruption from a given digit (the digit\n+\t\t\tmust start the beginning of a valid extension, or it will be ignored). During\n+\t\t\tthe playback of the file, audio is monitored in the receive direction, and if\n+\t\t\ta period of non-silence which is greater than\n+        <replaceable>min</replaceable>\n+        ms yet less than\n+        <replaceable>max</replaceable>\n+        ms is followed by silence for at least\n+        <replaceable>sil</replaceable>\n+        ms,\n+\t\t\twhich occurs during the first\n+        <replaceable>analysistime</replaceable>\n+        ms, then the audio playback is\n+\t\t\taborted and processing jumps to the\n+        <replaceable>talk</replaceable>\n+        extension, if available.\n       </para>\n     </description>\n-    <see-also>\n-      <ref type=\"application\">StopPlayTones</ref>\n-    </see-also>\n-  </application>\n-  <application name=\"StopPlayTones\" language=\"en_US\">\n-    <synopsis>Stop playing a tone list.</synopsis>\n-    <syntax/>\n-    <description>\n-      <para>Stop playing a tone list, initiated by PlayTones().</para>\n-    </description>\n-    <see-also>\n-      <ref type=\"application\">PlayTones</ref>\n-    </see-also>\n   </application>\n-  <module language=\"en_US\" name=\"app_read\">\n+  <module language=\"en_US\" name=\"app_mixmonitor\">\n+    <use type=\"module\">func_periodic_hook</use>\n     <support_level>core</support_level>\n   </module>\n-  <application name=\"Read\" language=\"en_US\">\n-    <synopsis>Read a variable.</synopsis>\n+  <application name=\"MixMonitor\" language=\"en_US\">\n+    <synopsis>Record a call and mix the audio during the recording.  Use of StopMixMonitor is required\n+\t\t\tto guarantee the audio file is available for processing during dialplan execution.</synopsis>\n     <syntax>\n-      <parameter name=\"variable\" required=\"true\">\n-        <para>\n-          The input digits will be stored in the given\n-          <replaceable>variable</replaceable>\n-          name.\n-        </para>\n-      </parameter>\n-      <parameter name=\"filenames\" argsep=\"&amp;\">\n+      <parameter name=\"file\" required=\"true\" argsep=\".\">\n         <argument name=\"filename\" required=\"true\">\n-          <para>file(s) to play before reading digits or tone with option i</para>\n+          <para>\n+            If\n+            <replaceable>filename</replaceable>\n+            is an absolute path, uses that path, otherwise\n+\t\t\t\t\tcreates the file in the configured monitoring directory from\n+            <filename>asterisk.conf.</filename>\n+          </para>\n         </argument>\n-        <argument name=\"filename2\" multiple=\"true\"/>\n-      </parameter>\n-      <parameter name=\"maxdigits\">\n-        <para>\n-          Maximum acceptable number of digits. Stops reading after\n-          <replaceable>maxdigits</replaceable>\n-          have been entered (without\n-\t\t\t\trequiring the user to press the\n-          <literal>#</literal>\n-          key).\n-        </para>\n-        <para>\n-          Defaults to\n-          <literal>0</literal>\n-          - no limit - wait for the\n-\t\t\t\tuser press the\n-          <literal>#</literal>\n-          key. Any value below\n-          <literal>0</literal>\n-          means the same. Max accepted value is\n-          <literal>255</literal>\n-          .\n-        </para>\n+        <argument name=\"extension\" required=\"true\"/>\n       </parameter>\n       <parameter name=\"options\">\n         <optionlist>\n-          <option name=\"s\">\n-            <para>to return immediately if the line is not up.</para>\n+          <option name=\"a\">\n+            <para>Append to the file instead of overwriting it.</para>\n           </option>\n-          <option name=\"i\">\n+          <option name=\"b\">\n+            <para>Only save audio to the file while the channel is bridged.</para>\n+            <note>\n+              <para>\n+                If you utilize this option inside a Local channel, you must make sure the Local\n+\t\t\t\t\t\tchannel is not optimized away. To do this, be sure to call your Local channel with the\n+                <literal>/n</literal>\n+                option. For example: Dial(Local/start@mycontext/n)\n+              </para>\n+            </note>\n+          </option>\n+          <option name=\"B\">\n+            <para>Play a periodic beep while this call is being recorded.</para>\n+            <argument name=\"interval\">\n+              <para>Interval, in seconds. Default is 15.</para>\n+            </argument>\n+          </option>\n+          <option name=\"v\">\n             <para>\n-              to play  filename as an indication tone from your\n-              <filename>indications.conf</filename>\n-              .\n+              Adjust the\n+              <emphasis>heard</emphasis>\n+              volume by a factor of\n+              <replaceable>x</replaceable>\n+              (range\n+              <literal>-4</literal>\n+              to\n+              <literal>4</literal>\n+              )\n             </para>\n+            <argument name=\"x\" required=\"true\"/>\n           </option>\n-          <option name=\"n\">\n-            <para>to read digits even if the line is not up.</para>\n+          <option name=\"V\">\n+            <para>\n+              Adjust the\n+              <emphasis>spoken</emphasis>\n+              volume by a factor\n+\t\t\t\t\t\tof\n+              <replaceable>x</replaceable>\n+              (range\n+              <literal>-4</literal>\n+              to\n+              <literal>4</literal>\n+              )\n+            </para>\n+            <argument name=\"x\" required=\"true\"/>\n+          </option>\n+          <option name=\"W\">\n+            <para>\n+              Adjust both,\n+              <emphasis>heard and spoken</emphasis>\n+              volumes by a factor\n+\t\t\t\t\t\tof\n+              <replaceable>x</replaceable>\n+              (range\n+              <literal>-4</literal>\n+              to\n+              <literal>4</literal>\n+              )\n+            </para>\n+            <argument name=\"x\" required=\"true\"/>\n+          </option>\n+          <option name=\"r\">\n+            <argument name=\"file\" required=\"true\"/>\n+            <para>\n+              Use the specified file to record the\n+              <emphasis>receive</emphasis>\n+              audio feed.\n+\t\t\t\t\t\tLike with the basic filename argument, if an absolute path isn't given, it will create\n+\t\t\t\t\t\tthe file in the configured monitoring directory.\n+            </para>\n           </option>\n           <option name=\"t\">\n+            <argument name=\"file\" required=\"true\"/>\n             <para>\n-              Terminator digit(s) to use for ending input.\n-\t\t\t\t\t\tDefault is\n-              <literal>#</literal>\n-              . If you need to read\n-\t\t\t\t\t\tthe digit\n-              <literal>#</literal>\n-              literally, you should\n-\t\t\t\t\t\tremove or change the terminator character. Multiple\n-\t\t\t\t\t\tterminator characters may be specified. If no terminator\n-\t\t\t\t\t\tdigit is present, input cannot be ended using digits\n-\t\t\t\t\t\tand you will need to rely on duration and max digits\n-\t\t\t\t\t\tfor ending input.\n+              Use the specified file to record the\n+              <emphasis>transmit</emphasis>\n+              audio feed.\n+\t\t\t\t\t\tLike with the basic filename argument, if an absolute path isn't given, it will create\n+\t\t\t\t\t\tthe file in the configured monitoring directory.\n+            </para>\n+          </option>\n+          <option name=\"S\">\n+            <para>\n+              When combined with the\n+              <replaceable>r</replaceable>\n+              or\n+              <replaceable>t</replaceable>\n+              option, inserts silence when necessary to maintain synchronization between the receive\n+\t\t\t\t\t\tand transmit audio streams.\n+            </para>\n+          </option>\n+          <option name=\"i\">\n+            <argument name=\"chanvar\" required=\"true\"/>\n+            <para>Stores the MixMonitor's ID on this channel variable.</para>\n+          </option>\n+          <option name=\"p\">\n+            <para>Play a beep on the channel that starts the recording.</para>\n+          </option>\n+          <option name=\"P\">\n+            <para>Play a beep on the channel that stops the recording.</para>\n+          </option>\n+          <option name=\"m\">\n+            <argument name=\"mailbox\" required=\"true\"/>\n+            <para>\n+              Create a copy of the recording as a voicemail in the indicated\n+              <emphasis>mailbox</emphasis>\n+              (es)\n+\t\t\t\t\t\tseparated by commas eg. m(1111@default,2222@default,...).  Folders can be optionally specified using\n+\t\t\t\t\t\tthe syntax: mailbox@context/folder\n             </para>\n           </option>\n         </optionlist>\n       </parameter>\n-      <parameter name=\"attempts\">\n+      <parameter name=\"command\">\n+        <para>Will be executed when the recording is over.</para>\n         <para>\n-          If greater than\n-          <literal>1</literal>\n-          , that many\n-          <replaceable>attempts</replaceable>\n-          will be made in the\n-\t\t\t\tevent no data is entered.\n+          Any strings matching\n+          <literal>^{X}</literal>\n+          will be unescaped to\n+          <variable>X</variable>\n+          .\n         </para>\n+        <para>All variables will be evaluated at the time MixMonitor is called.</para>\n+        <warning>\n+          <para>\n+            Do not use untrusted strings such as\n+            <variable>CALLERID(num)</variable>\n+            or\n+            <variable>CALLERID(name)</variable>\n+            as part of the command parameters.  You\n+\t\t\t\trisk a command injection attack executing arbitrary commands if the untrusted\n+\t\t\t\tstrings aren't filtered to remove dangerous characters.  See function\n+            <variable>FILTER()</variable>\n+            .\n+          </para>\n+        </warning>\n       </parameter>\n-      <parameter name=\"timeout\">\n+    </syntax>\n+    <description>\n+      <para>Records the audio on the current channel to the specified file.</para>\n+      <para>This application does not automatically answer and should be preceeded by\n+\t\t\tan application such as Answer or Progress().</para>\n+      <note>\n+        <para>MixMonitor runs as an audiohook.</para>\n+      </note>\n+      <note>\n         <para>\n-          The number of seconds to wait for a digit response. If greater\n-\t\t\t\tthan\n-          <literal>0</literal>\n-          , that value will override the default timeout.\n-\t\t\t\tCan be floating point.\n+          If a filename passed to MixMonitor ends with\n+          <literal>.wav49</literal>\n+          , Asterisk will silently convert the extension to\n+          <literal>.WAV</literal>\n+          for legacy reasons.\n+          <variable>MIXMONITOR_FILENAME</variable>\n+          will contain the actual filename that Asterisk is writing to, not necessarily the\n+\t\t\tvalue that was passed in.\n+        </para>\n+      </note>\n+      <variablelist>\n+        <variable name=\"MIXMONITOR_FILENAME\">\n+          <para>Will contain the filename used to record.</para>\n+        </variable>\n+      </variablelist>\n+      <warning>\n+        <para>\n+          Do not use untrusted strings such as\n+          <variable>CALLERID(num)</variable>\n+          or\n+          <variable>CALLERID(name)</variable>\n+          as part of ANY of the application's\n+\t\t\tparameters.  You risk a command injection attack executing arbitrary commands\n+\t\t\tif the untrusted strings aren't filtered to remove dangerous characters.  See\n+\t\t\tfunction\n+          <variable>FILTER()</variable>\n+          .\n         </para>\n+      </warning>\n+    </description>\n+    <see-also>\n+      <ref type=\"application\">Monitor</ref>\n+      <ref type=\"application\">StopMixMonitor</ref>\n+      <ref type=\"application\">PauseMonitor</ref>\n+      <ref type=\"application\">UnpauseMonitor</ref>\n+      <ref type=\"function\">AUDIOHOOK_INHERIT</ref>\n+    </see-also>\n+  </application>\n+  <application name=\"StopMixMonitor\" language=\"en_US\">\n+    <synopsis>Stop recording a call through MixMonitor, and free the recording's file handle.</synopsis>\n+    <syntax>\n+      <parameter name=\"MixMonitorID\" required=\"false\">\n+        <para>If a valid ID is provided, then this command will stop only that specific\n+\t\t\t\tMixMonitor.</para>\n       </parameter>\n     </syntax>\n     <description>\n       <para>\n-        Reads a #-terminated string of digits a certain number of times from the\n-\t\t\tuser in to the given\n-        <replaceable>variable</replaceable>\n-        .\n+        Stops the audio recording that was started with a call to\n+        <literal>MixMonitor()</literal>\n+        on the current channel.\n       </para>\n-      <para>This application sets the following channel variable upon completion:</para>\n-      <variablelist>\n-        <variable name=\"READSTATUS\">\n-          <para>This is the status of the read operation.</para>\n-          <value name=\"OK\"/>\n-          <value name=\"ERROR\"/>\n-          <value name=\"HANGUP\"/>\n-          <value name=\"INTERRUPTED\"/>\n-          <value name=\"SKIPPED\"/>\n-          <value name=\"TIMEOUT\"/>\n-        </variable>\n-      </variablelist>\n     </description>\n     <see-also>\n-      <ref type=\"application\">SendDTMF</ref>\n+      <ref type=\"application\">MixMonitor</ref>\n     </see-also>\n   </application>\n-  <module language=\"en_US\" name=\"app_alarmreceiver\">\n-    <support_level>extended</support_level>\n-  </module>\n-  <application name=\"AlarmReceiver\" language=\"en_US\">\n-    <synopsis>Provide support for receiving alarm reports from a burglar or fire alarm panel.</synopsis>\n-    <syntax/>\n+  <manager name=\"MixMonitorMute\" language=\"en_US\">\n+    <synopsis>Mute / unMute a Mixmonitor recording.</synopsis>\n+    <syntax>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      <parameter name=\"Channel\" required=\"true\">\n+        <para>Used to specify the channel to mute.</para>\n+      </parameter>\n+      <parameter name=\"Direction\">\n+        <para>Which part of the recording to mute:  read, write or both (from channel, to channel or both channels).</para>\n+      </parameter>\n+      <parameter name=\"State\">\n+        <para>Turn mute on or off : 1 to turn on, 0 to turn off.</para>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>This action may be used to mute a MixMonitor recording.</para>\n+    </description>\n+  </manager>\n+  <manager name=\"MixMonitor\" language=\"en_US\">\n+    <synopsis>Record a call and mix the audio during the recording.  Use of StopMixMonitor is required\n+\t\t\tto guarantee the audio file is available for processing during dialplan execution.</synopsis>\n+    <syntax>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      <parameter name=\"Channel\" required=\"true\">\n+        <para>Used to specify the channel to record.</para>\n+      </parameter>\n+      <parameter name=\"File\">\n+        <para>Is the name of the file created in the monitor spool directory.\n+\t\t\t\tDefaults to the same name as the channel (with slashes replaced with dashes).\n+\t\t\t\tThis argument is optional if you specify to record unidirectional audio with\n+\t\t\t\teither the r(filename) or t(filename) options in the options field. If\n+\t\t\t\tneither MIXMONITOR_FILENAME or this parameter is set, the mixed stream won't\n+\t\t\t\tbe recorded.</para>\n+      </parameter>\n+      <parameter name=\"options\">\n+        <para>Options that apply to the MixMonitor in the same way as they\n+\t\t\t\twould apply if invoked from the MixMonitor application. For a list of\n+\t\t\t\tavailable options, see the documentation for the mixmonitor application.</para>\n+      </parameter>\n+      <parameter name=\"Command\">\n+        <para>\n+          Will be executed when the recording is over.\n+\t\t\t\tAny strings matching\n+          <literal>^{X}</literal>\n+          will be unescaped to\n+          <variable>X</variable>\n+          .\n+\t\t\t\tAll variables will be evaluated at the time MixMonitor is called.\n+        </para>\n+        <warning>\n+          <para>\n+            Do not use untrusted strings such as\n+            <variable>CALLERID(num)</variable>\n+            or\n+            <variable>CALLERID(name)</variable>\n+            as part of the command parameters.  You\n+\t\t\t\trisk a command injection attack executing arbitrary commands if the untrusted\n+\t\t\t\tstrings aren't filtered to remove dangerous characters.  See function\n+            <variable>FILTER()</variable>\n+            .\n+          </para>\n+        </warning>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>This action records the audio on the current channel to the specified file.</para>\n+      <variablelist>\n+        <variable name=\"MIXMONITOR_FILENAME\">\n+          <para>Will contain the filename used to record the mixed stream.</para>\n+        </variable>\n+      </variablelist>\n+    </description>\n+  </manager>\n+  <manager name=\"StopMixMonitor\" language=\"en_US\">\n+    <synopsis>Stop recording a call through MixMonitor, and free the recording's file handle.</synopsis>\n+    <syntax>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      <parameter name=\"Channel\" required=\"true\">\n+        <para>The name of the channel monitored.</para>\n+      </parameter>\n+      <parameter name=\"MixMonitorID\" required=\"false\">\n+        <para>If a valid ID is provided, then this command will stop only that specific\n+\t\t\t\tMixMonitor.</para>\n+      </parameter>\n+    </syntax>\n     <description>\n       <para>\n-        This application should be called whenever there is an alarm panel calling in to dump its events.\n-\t\t\tThe application will handshake with the alarm panel, and receive events, validate them, handshake them,\n-\t\t\tand store them until the panel hangs up. Once the panel hangs up, the application will run the system\n-\t\t\tcommand specified by the eventcmd setting in\n-        <filename>alarmreceiver.conf</filename>\n-        and pipe the\n-\t\t\tevents to the standard input of the application.\n-\t\t\tThe configuration file also contains settings for DTMF timing, and for the loudness of the\n-\t\t\tacknowledgement tones.\n+        This action stops the audio recording that was started with the\n+        <literal>MixMonitor</literal>\n+        action on the current channel.\n       </para>\n-      <note>\n-        <para>Few Ademco DTMF signalling formats are detected automatically: Contact ID, Express 4+1,\n-\t\t\tExpress 4+2, High Speed and Super Fast.</para>\n-      </note>\n-      <para>The application is affected by the following variables:</para>\n+    </description>\n+  </manager>\n+  <function name=\"MIXMONITOR\" language=\"en_US\">\n+    <synopsis>Retrieve data pertaining to specific instances of MixMonitor on a channel.</synopsis>\n+    <syntax>\n+      <parameter name=\"id\" required=\"true\">\n+        <para>\n+          The unique ID of the MixMonitor instance. The unique ID can be retrieved through the channel\n+\t\t\t\tvariable used as an argument to the\n+          <replaceable>i</replaceable>\n+          option to MixMonitor.\n+        </para>\n+      </parameter>\n+      <parameter name=\"key\" required=\"true\">\n+        <para>The piece of data to retrieve from the MixMonitor.</para>\n+        <enumlist>\n+          <enum name=\"filename\"/>\n+        </enumlist>\n+      </parameter>\n+    </syntax>\n+  </function>\n+  <managerEvent language=\"en_US\" name=\"MixMonitorStart\">\n+    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n+      <synopsis>Raised when monitoring has started on a channel.</synopsis>\n+      <syntax>\n+        <channel_snapshot/>\n+      </syntax>\n+      <see-also>\n+        <ref type=\"managerEvent\">MixMonitorStop</ref>\n+        <ref type=\"application\">MixMonitor</ref>\n+        <ref type=\"manager\">MixMonitor</ref>\n+      </see-also>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <managerEvent language=\"en_US\" name=\"MixMonitorStop\">\n+    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n+      <synopsis>Raised when monitoring has stopped on a channel.</synopsis>\n+      <syntax>\n+        <channel_snapshot/>\n+      </syntax>\n+      <see-also>\n+        <ref type=\"managerEvent\">MixMonitorStart</ref>\n+        <ref type=\"application\">StopMixMonitor</ref>\n+        <ref type=\"manager\">StopMixMonitor</ref>\n+      </see-also>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <managerEvent language=\"en_US\" name=\"MixMonitorMute\">\n+    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n+      <synopsis>Raised when monitoring is muted or unmuted on a channel.</synopsis>\n+      <syntax>\n+        <channel_snapshot/>\n+        <parameter name=\"Direction\">\n+          <para>Which part of the recording was muted or unmuted: read, write or both\n+\t\t\t\t(from channel, to channel or both directions).</para>\n+        </parameter>\n+        <parameter name=\"State\">\n+          <para>If the monitoring was muted or unmuted: 1 when muted, 0 when unmuted.</para>\n+        </parameter>\n+      </syntax>\n+      <see-also>\n+        <ref type=\"manager\">MixMonitorMute</ref>\n+      </see-also>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <module language=\"en_US\" name=\"app_fax\">\n+    <depend>spandsp</depend>\n+    <conflict>res_fax</conflict>\n+    <defaultenabled>no</defaultenabled>\n+    <support_level>deprecated</support_level>\n+    <replacement>res_fax</replacement>\n+    <deprecated_in>16</deprecated_in>\n+    <removed_in>19</removed_in>\n+  </module>\n+  <application name=\"SendFAX\" language=\"en_US\" module=\"app_fax\">\n+    <synopsis>Send a Fax</synopsis>\n+    <syntax>\n+      <parameter name=\"filename\" required=\"true\">\n+        <para>Filename of TIFF file to fax</para>\n+      </parameter>\n+      <parameter name=\"a\" required=\"false\">\n+        <para>Makes the application behave as the answering machine</para>\n+        <para>(Default behavior is as calling machine)</para>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>Send a given TIFF file to the channel as a FAX.</para>\n+      <para>This application sets the following channel variables:</para>\n       <variablelist>\n-        <variable name=\"ALARMRECEIVER_CALL_LIMIT\">\n-          <para>Maximum call time, in milliseconds.</para>\n-          <para>If set, this variable causes application to exit after the specified time.</para>\n+        <variable name=\"LOCALSTATIONID\">\n+          <para>To identify itself to the remote end</para>\n         </variable>\n-        <variable name=\"ALARMRECEIVER_RETRIES_LIMIT\">\n-          <para>Maximum number of retries per call.</para>\n-          <para>If set, this variable causes application to exit after the specified number of messages.</para>\n+        <variable name=\"LOCALHEADERINFO\">\n+          <para>To generate a header line on each page</para>\n+        </variable>\n+        <variable name=\"FAXSTATUS\">\n+          <value name=\"SUCCESS\"/>\n+          <value name=\"FAILED\"/>\n+        </variable>\n+        <variable name=\"FAXERROR\">\n+          <para>Cause of failure</para>\n+        </variable>\n+        <variable name=\"REMOTESTATIONID\">\n+          <para>The CSID of the remote side</para>\n+        </variable>\n+        <variable name=\"FAXPAGES\">\n+          <para>Number of pages sent</para>\n+        </variable>\n+        <variable name=\"FAXBITRATE\">\n+          <para>Transmission rate</para>\n+        </variable>\n+        <variable name=\"FAXRESOLUTION\">\n+          <para>Resolution of sent fax</para>\n+        </variable>\n+      </variablelist>\n+    </description>\n+  </application>\n+  <application name=\"ReceiveFAX\" language=\"en_US\" module=\"app_fax\">\n+    <synopsis>Receive a Fax</synopsis>\n+    <syntax>\n+      <parameter name=\"filename\" required=\"true\">\n+        <para>Filename of TIFF file save incoming fax</para>\n+      </parameter>\n+      <parameter name=\"c\" required=\"false\">\n+        <para>Makes the application behave as the calling machine</para>\n+        <para>(Default behavior is as answering machine)</para>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>Receives a FAX from the channel into the given filename\n+\t\t\toverwriting the file if it already exists.</para>\n+      <para>File created will be in TIFF format.</para>\n+      <para>This application sets the following channel variables:</para>\n+      <variablelist>\n+        <variable name=\"LOCALSTATIONID\">\n+          <para>To identify itself to the remote end</para>\n+        </variable>\n+        <variable name=\"LOCALHEADERINFO\">\n+          <para>To generate a header line on each page</para>\n+        </variable>\n+        <variable name=\"FAXSTATUS\">\n+          <value name=\"SUCCESS\"/>\n+          <value name=\"FAILED\"/>\n+        </variable>\n+        <variable name=\"FAXERROR\">\n+          <para>Cause of failure</para>\n+        </variable>\n+        <variable name=\"REMOTESTATIONID\">\n+          <para>The CSID of the remote side</para>\n+        </variable>\n+        <variable name=\"FAXPAGES\">\n+          <para>Number of pages sent</para>\n+        </variable>\n+        <variable name=\"FAXBITRATE\">\n+          <para>Transmission rate</para>\n+        </variable>\n+        <variable name=\"FAXRESOLUTION\">\n+          <para>Resolution of sent fax</para>\n         </variable>\n       </variablelist>\n     </description>\n-    <see-also>\n-      <ref type=\"filename\">alarmreceiver.conf</ref>\n-    </see-also>\n   </application>\n   <module language=\"en_US\" name=\"app_directory\">\n     <support_level>core</support_level>\n   </module>\n   <application name=\"Directory\" language=\"en_US\">\n     <synopsis>Provide directory of voicemail extensions.</synopsis>\n     <syntax>\n@@ -14028,14 +13470,446 @@\n           <value name=\"SELECTED\">User selected a user to call from the directory</value>\n           <value name=\"USEREXIT\">User exited with '#' during selection</value>\n           <value name=\"FAILED\">The application failed</value>\n         </variable>\n       </variablelist>\n     </description>\n   </application>\n+  <module language=\"en_US\" name=\"app_agent_pool\">\n+    <support_level>core</support_level>\n+  </module>\n+  <application name=\"AgentLogin\" language=\"en_US\">\n+    <synopsis>Login an agent.</synopsis>\n+    <syntax argsep=\",\">\n+      <parameter name=\"AgentId\" required=\"true\"/>\n+      <parameter name=\"options\">\n+        <optionlist>\n+          <option name=\"s\">\n+            <para>silent login - do not announce the login ok segment after\n+\t\t\t\t\t\tagent logged on.</para>\n+          </option>\n+        </optionlist>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>\n+        Login an agent to the system.  Any agent authentication is assumed to\n+\t\t\talready be done by dialplan.  While logged in, the agent can receive calls\n+\t\t\tand will hear the sound file specified by the config option custom_beep\n+\t\t\twhen a new call comes in for the agent.  Login failures will continue in\n+\t\t\tthe dialplan with\n+        <variable>AGENT_STATUS</variable>\n+        set.\n+      </para>\n+      <para>Before logging in, you can setup on the real agent channel the\n+\t\t\tCHANNEL(dtmf_features) an agent will have when talking to a caller\n+\t\t\tand you can setup on the channel running this application the\n+\t\t\tCONNECTEDLINE() information the agent will see while waiting for a\n+\t\t\tcaller.</para>\n+      <para>\n+        <variable>AGENT_STATUS</variable>\n+        enumeration values:\n+      </para>\n+      <enumlist>\n+        <enum name=\"INVALID\">\n+          <para>The specified agent is invalid.</para>\n+        </enum>\n+        <enum name=\"ALREADY_LOGGED_IN\">\n+          <para>The agent is already logged in.</para>\n+        </enum>\n+      </enumlist>\n+      <note>\n+        <para>\n+          The Agent:\n+          <replaceable>AgentId</replaceable>\n+          device state is\n+\t\t\tavailable to monitor the status of the agent.\n+        </para>\n+      </note>\n+    </description>\n+    <see-also>\n+      <ref type=\"application\">Authenticate</ref>\n+      <ref type=\"application\">Queue</ref>\n+      <ref type=\"application\">AddQueueMember</ref>\n+      <ref type=\"application\">RemoveQueueMember</ref>\n+      <ref type=\"application\">PauseQueueMember</ref>\n+      <ref type=\"application\">UnpauseQueueMember</ref>\n+      <ref type=\"function\">AGENT</ref>\n+      <ref type=\"function\">CHANNEL</ref>\n+      <ref type=\"function\">CONNECTEDLINE</ref>\n+      <ref type=\"filename\">agents.conf</ref>\n+      <ref type=\"filename\">queues.conf</ref>\n+    </see-also>\n+  </application>\n+  <application name=\"AgentRequest\" language=\"en_US\">\n+    <synopsis>Request an agent to connect with the channel.</synopsis>\n+    <syntax argsep=\",\">\n+      <parameter name=\"AgentId\" required=\"true\"/>\n+    </syntax>\n+    <description>\n+      <para>\n+        Request an agent to connect with the channel.  Failure to find,\n+\t\t\talert the agent, or acknowledge the call will continue in the dialplan\n+\t\t\twith\n+        <variable>AGENT_STATUS</variable>\n+        set.\n+      </para>\n+      <para>\n+        <variable>AGENT_STATUS</variable>\n+        enumeration values:\n+      </para>\n+      <enumlist>\n+        <enum name=\"INVALID\">\n+          <para>The specified agent is invalid.</para>\n+        </enum>\n+        <enum name=\"NOT_LOGGED_IN\">\n+          <para>The agent is not available.</para>\n+        </enum>\n+        <enum name=\"BUSY\">\n+          <para>The agent is on another call.</para>\n+        </enum>\n+        <enum name=\"NOT_CONNECTED\">\n+          <para>The agent did not connect with the\n+\t\t\t\tcall.  The agent most likely did not acknowledge the call.</para>\n+        </enum>\n+        <enum name=\"ERROR\">\n+          <para>Alerting the agent failed.</para>\n+        </enum>\n+      </enumlist>\n+    </description>\n+    <see-also>\n+      <ref type=\"application\">AgentLogin</ref>\n+    </see-also>\n+  </application>\n+  <function name=\"AGENT\" language=\"en_US\">\n+    <synopsis>Gets information about an Agent</synopsis>\n+    <syntax argsep=\":\">\n+      <parameter name=\"AgentId\" required=\"true\"/>\n+      <parameter name=\"item\">\n+        <para>The valid items to retrieve are:</para>\n+        <enumlist>\n+          <enum name=\"status\">\n+            <para>(default) The status of the agent (LOGGEDIN | LOGGEDOUT)</para>\n+          </enum>\n+          <enum name=\"password\">\n+            <para>Deprecated.  The dialplan handles any agent authentication.</para>\n+          </enum>\n+          <enum name=\"name\">\n+            <para>The name of the agent</para>\n+          </enum>\n+          <enum name=\"mohclass\">\n+            <para>MusicOnHold class</para>\n+          </enum>\n+          <enum name=\"channel\">\n+            <para>The name of the active channel for the Agent (AgentLogin)</para>\n+          </enum>\n+          <enum name=\"fullchannel\">\n+            <para>The untruncated name of the active channel for the Agent (AgentLogin)</para>\n+          </enum>\n+        </enumlist>\n+      </parameter>\n+    </syntax>\n+    <description/>\n+  </function>\n+  <manager name=\"Agents\" language=\"en_US\">\n+    <synopsis>Lists agents and their status.</synopsis>\n+    <syntax>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+    </syntax>\n+    <description>\n+      <para>Will list info about all defined agents.</para>\n+    </description>\n+    <see-also>\n+      <ref type=\"managerEvent\">Agents</ref>\n+      <ref type=\"managerEvent\">AgentsComplete</ref>\n+    </see-also>\n+  </manager>\n+  <managerEvent language=\"en_US\" name=\"Agents\">\n+    <managerEventInstance class=\"EVENT_FLAG_AGENT\">\n+      <synopsis>Response event in a series to the Agents AMI action containing\n+\t\t\t\tinformation about a defined agent.</synopsis>\n+      <syntax>\n+        <parameter name=\"Agent\">\n+          <para>Agent ID of the agent.</para>\n+        </parameter>\n+        <parameter name=\"Name\">\n+          <para>User friendly name of the agent.</para>\n+        </parameter>\n+        <parameter name=\"Status\">\n+          <para>Current status of the agent.</para>\n+          <para>The valid values are:</para>\n+          <enumlist>\n+            <enum name=\"AGENT_LOGGEDOFF\"/>\n+            <enum name=\"AGENT_IDLE\"/>\n+            <enum name=\"AGENT_ONCALL\"/>\n+          </enumlist>\n+        </parameter>\n+        <parameter name=\"TalkingToChan\">\n+          <para>\n+            <variable>BRIDGEPEER</variable>\n+            value on agent channel.\n+          </para>\n+          <para>\n+            Present if Status value is\n+            <literal>AGENT_ONCALL</literal>\n+            .\n+          </para>\n+        </parameter>\n+        <parameter name=\"CallStarted\">\n+          <para>Epoche time when the agent started talking with the caller.</para>\n+          <para>\n+            Present if Status value is\n+            <literal>AGENT_ONCALL</literal>\n+            .\n+          </para>\n+        </parameter>\n+        <parameter name=\"LoggedInTime\">\n+          <para>Epoche time when the agent logged in.</para>\n+          <para>\n+            Present if Status value is\n+            <literal>AGENT_IDLE</literal>\n+            or\n+            <literal>AGENT_ONCALL</literal>\n+            .\n+          </para>\n+        </parameter>\n+        <channel_snapshot/>\n+        <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      </syntax>\n+      <description>\n+        <para>\n+          The channel snapshot is present if the Status value is\n+          <literal>AGENT_IDLE</literal>\n+          or\n+          <literal>AGENT_ONCALL</literal>\n+          .\n+        </para>\n+      </description>\n+      <see-also>\n+        <ref type=\"manager\">Agents</ref>\n+      </see-also>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <managerEvent language=\"en_US\" name=\"AgentsComplete\">\n+    <managerEventInstance class=\"EVENT_FLAG_AGENT\">\n+      <synopsis>Final response event in a series of events to the Agents AMI action.</synopsis>\n+      <syntax>\n+        <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      </syntax>\n+      <see-also>\n+        <ref type=\"manager\">Agents</ref>\n+      </see-also>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <manager name=\"AgentLogoff\" language=\"en_US\">\n+    <synopsis>Sets an agent as no longer logged in.</synopsis>\n+    <syntax>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      <parameter name=\"Agent\" required=\"true\">\n+        <para>Agent ID of the agent to log off.</para>\n+      </parameter>\n+      <parameter name=\"Soft\">\n+        <para>\n+          Set to\n+          <literal>true</literal>\n+          to not hangup existing calls.\n+        </para>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>Sets an agent as no longer logged in.</para>\n+    </description>\n+  </manager>\n+  <configInfo name=\"app_agent_pool\" language=\"en_US\">\n+    <synopsis>Agent pool applications</synopsis>\n+    <description>\n+      <note>\n+        <para>Option changes take effect on agent login or after an agent\n+\t\t\tdisconnects from a call.</para>\n+      </note>\n+    </description>\n+    <configFile name=\"agents.conf\">\n+      <configObject name=\"global\">\n+        <synopsis>Unused, but reserved.</synopsis>\n+      </configObject>\n+      <configObject name=\"agent-id\">\n+        <synopsis>Configure an agent for the pool.</synopsis>\n+        <description>\n+          <xi:include xpointer=\"xpointer(/docs/configInfo[@name='app_agent_pool']/description/note)\"/>\n+        </description>\n+        <configOption name=\"ackcall\">\n+          <synopsis>Enable to require the agent to acknowledge a call.</synopsis>\n+          <description>\n+            <para>Enable to require the agent to give a DTMF acknowledgement\n+\t\t\t\t\t\twhen the agent receives a call.</para>\n+            <note>\n+              <para>\n+                The option is overridden by\n+                <variable>AGENTACKCALL</variable>\n+                on agent login.\n+              </para>\n+            </note>\n+            <xi:include xpointer=\"xpointer(/docs/configInfo[@name='app_agent_pool']/description/note)\"/>\n+          </description>\n+        </configOption>\n+        <configOption name=\"acceptdtmf\">\n+          <synopsis>DTMF key sequence the agent uses to acknowledge a call.</synopsis>\n+          <description>\n+            <note>\n+              <para>\n+                The option is overridden by\n+                <variable>AGENTACCEPTDTMF</variable>\n+                on agent login.\n+              </para>\n+            </note>\n+            <note>\n+              <para>The option is ignored unless the ackcall option is enabled.</para>\n+            </note>\n+            <xi:include xpointer=\"xpointer(/docs/configInfo[@name='app_agent_pool']/description/note)\"/>\n+          </description>\n+        </configOption>\n+        <configOption name=\"autologoff\">\n+          <synopsis>Time the agent has to acknowledge a call before being logged off.</synopsis>\n+          <description>\n+            <para>Set how many seconds a call for the agent has to wait for the\n+\t\t\t\t\t\tagent to acknowledge the call before the agent is automatically\n+\t\t\t\t\t\tlogged off.  If set to zero then the call will wait forever for\n+\t\t\t\t\t\tthe agent to acknowledge.</para>\n+            <note>\n+              <para>\n+                The option is overridden by\n+                <variable>AGENTAUTOLOGOFF</variable>\n+                on agent login.\n+              </para>\n+            </note>\n+            <note>\n+              <para>The option is ignored unless the ackcall option is enabled.</para>\n+            </note>\n+            <xi:include xpointer=\"xpointer(/docs/configInfo[@name='app_agent_pool']/description/note)\"/>\n+          </description>\n+        </configOption>\n+        <configOption name=\"wrapuptime\">\n+          <synopsis>Minimum time the agent has between calls.</synopsis>\n+          <description>\n+            <para>Set the minimum amount of time in milliseconds after\n+\t\t\t\t\t\tdisconnecting a call before the agent can receive a new call.</para>\n+            <note>\n+              <para>\n+                The option is overridden by\n+                <variable>AGENTWRAPUPTIME</variable>\n+                on agent login.\n+              </para>\n+            </note>\n+            <xi:include xpointer=\"xpointer(/docs/configInfo[@name='app_agent_pool']/description/note)\"/>\n+          </description>\n+        </configOption>\n+        <configOption name=\"musiconhold\">\n+          <synopsis>Music on hold class the agent listens to between calls.</synopsis>\n+          <description>\n+            <xi:include xpointer=\"xpointer(/docs/configInfo[@name='app_agent_pool']/description/note)\"/>\n+          </description>\n+        </configOption>\n+        <configOption name=\"recordagentcalls\">\n+          <synopsis>Enable to automatically record calls the agent takes.</synopsis>\n+          <description>\n+            <para>\n+              Enable recording calls the agent takes automatically by\n+\t\t\t\t\t\tinvoking the automixmon DTMF feature when the agent connects\n+\t\t\t\t\t\tto a caller.  See\n+              <filename>features.conf.sample</filename>\n+              for information about\n+\t\t\t\t\t\tthe automixmon feature.\n+            </para>\n+            <xi:include xpointer=\"xpointer(/docs/configInfo[@name='app_agent_pool']/description/note)\"/>\n+          </description>\n+        </configOption>\n+        <configOption name=\"custom_beep\">\n+          <synopsis>Sound file played to alert the agent when a call is present.</synopsis>\n+          <description>\n+            <xi:include xpointer=\"xpointer(/docs/configInfo[@name='app_agent_pool']/description/note)\"/>\n+          </description>\n+        </configOption>\n+        <configOption name=\"fullname\">\n+          <synopsis>A friendly name for the agent used in log messages.</synopsis>\n+          <description>\n+            <xi:include xpointer=\"xpointer(/docs/configInfo[@name='app_agent_pool']/description/note)\"/>\n+          </description>\n+        </configOption>\n+      </configObject>\n+    </configFile>\n+  </configInfo>\n+  <module language=\"en_US\" name=\"app_transfer\">\n+    <support_level>core</support_level>\n+  </module>\n+  <application name=\"Transfer\" language=\"en_US\">\n+    <synopsis>Transfer caller to remote extension.</synopsis>\n+    <syntax>\n+      <parameter name=\"dest\" required=\"true\" argsep=\"\">\n+        <argument name=\"Tech/\"/>\n+        <argument name=\"destination\" required=\"true\"/>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>Requests the remote caller be transferred\n+\t\t\tto a given destination. If TECH (SIP, IAX2, etc) is used, only\n+\t\t\tan incoming call with the same channel technology will be transferred.\n+\t\t\tNote that for SIP, if you transfer before call is setup, a 302 redirect\n+\t\t\tSIP message will be returned to the caller.</para>\n+      <para>\n+        The result of the application will be reported in the\n+        <variable>TRANSFERSTATUS</variable>\n+        channel variable:\n+      </para>\n+      <variablelist>\n+        <variable name=\"TRANSFERSTATUS\">\n+          <value name=\"SUCCESS\">Transfer succeeded.</value>\n+          <value name=\"FAILURE\">Transfer failed.</value>\n+          <value name=\"UNSUPPORTED\">Transfer unsupported by channel driver.</value>\n+        </variable>\n+        <variable name=\"TRANSFERSTATUSPROTOCOL\">\n+          <value name=\"0\">No error.</value>\n+          <value name=\"3xx-6xx\">SIP example - Error result code.</value>\n+        </variable>\n+      </variablelist>\n+    </description>\n+  </application>\n+  <module language=\"en_US\" name=\"app_echo\">\n+    <support_level>core</support_level>\n+  </module>\n+  <application name=\"Echo\" language=\"en_US\">\n+    <synopsis>Echo media, DTMF back to the calling party</synopsis>\n+    <syntax/>\n+    <description>\n+      <para>Echos back any media or DTMF frames read from the calling\n+\t\t\tchannel back to itself. This will not echo CONTROL, MODEM, or NULL\n+\t\t\tframes. Note: If '#' detected application exits.</para>\n+      <para>This application does not automatically answer and should be\n+\t\t\tpreceeded by an application such as Answer() or Progress().</para>\n+    </description>\n+  </application>\n+  <module language=\"en_US\" name=\"app_ices\">\n+    <support_level>deprecated</support_level>\n+    <deprecated_in>16</deprecated_in>\n+    <removed_in>19</removed_in>\n+  </module>\n+  <application name=\"ICES\" language=\"en_US\">\n+    <synopsis>Encode and stream using 'ices'.</synopsis>\n+    <syntax>\n+      <parameter name=\"config\" required=\"true\">\n+        <para>ICES configuration file.</para>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>Streams to an icecast server using ices (available separately).\n+\t\t\tA configuration file must be supplied for ices (see contrib/asterisk-ices.xml).</para>\n+      <note>\n+        <para>ICES version 2 client and server required.</para>\n+      </note>\n+    </description>\n+  </application>\n   <module language=\"en_US\" name=\"app_followme\">\n     <support_level>core</support_level>\n   </module>\n   <application name=\"FollowMe\" language=\"en_US\">\n     <synopsis>Find-Me/Follow-Me application.</synopsis>\n     <syntax>\n       <parameter name=\"followmeid\" required=\"true\"/>\n@@ -14113,1310 +13987,1432 @@\n         <filename>followme.conf</filename>\n         , execution will be returned\n \t\t\tto the dialplan and call execution will continue at the next priority.\n       </para>\n       <para>Returns -1 on hangup.</para>\n     </description>\n   </application>\n-  <module language=\"en_US\" name=\"app_softhangup\">\n-    <support_level>core</support_level>\n-  </module>\n-  <application name=\"SoftHangup\" language=\"en_US\">\n-    <synopsis>Hangs up the requested channel.</synopsis>\n-    <syntax>\n-      <parameter name=\"Technology/Resource\" required=\"true\"/>\n-      <parameter name=\"options\">\n-        <optionlist>\n-          <option name=\"a\">\n-            <para>Hang up all channels on a specified device instead of a single resource</para>\n-          </option>\n-        </optionlist>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>Hangs up the requested channel.  If there are no channels to\n-\t\t\thangup, the application will report it.</para>\n-    </description>\n-  </application>\n-  <module language=\"en_US\" name=\"app_bridgewait\">\n-    <depend>bridge_holding</depend>\n-    <support_level>core</support_level>\n+  <module language=\"en_US\" name=\"app_sms\">\n+    <support_level>extended</support_level>\n   </module>\n-  <application name=\"BridgeWait\" language=\"en_US\">\n-    <synopsis>Put a call into the holding bridge.</synopsis>\n+  <application name=\"SMS\" language=\"en_US\">\n+    <synopsis>Communicates with SMS service centres and SMS capable analogue phones.</synopsis>\n     <syntax>\n-      <parameter name=\"name\">\n+      <parameter name=\"name\" required=\"true\">\n         <para>\n-          Name of the holding bridge to join. This is a handle for\n-          <literal>BridgeWait</literal>\n-          only and does not affect the actual bridges that are created. If not provided,\n-\t\t\t\tthe reserved name\n-          <literal>default</literal>\n-          will be used.\n+          The name of the queue used in\n+          <filename>/var/spool/asterisk/sms</filename>\n         </para>\n       </parameter>\n-      <parameter name=\"role\" required=\"false\">\n-        <para>Defines the channel's purpose for entering the holding bridge. Values are case sensitive.</para>\n-        <enumlist>\n-          <enum name=\"participant\">\n-            <para>The channel will enter the holding bridge to be placed on hold\n-\t\t\t\t\t\tuntil it is removed from the bridge for some reason. (default)</para>\n-          </enum>\n-          <enum name=\"announcer\">\n-            <para>The channel will enter the holding bridge to make announcements\n-\t\t\t\t\t\tto channels that are currently in the holding bridge. While an\n-\t\t\t\t\t\tannouncer is present, holding for the participants will be\n-\t\t\t\t\t\tsuspended.</para>\n-          </enum>\n-        </enumlist>\n-      </parameter>\n       <parameter name=\"options\">\n         <optionlist>\n-          <option name=\"m\">\n-            <argument name=\"class\" required=\"true\"/>\n-            <para>The specified MOH class will be used/suggested for\n-\t\t\t\t\t\tmusic on hold operations. This option will only be useful for\n-\t\t\t\t\t\tentertainment modes that use it (m and h).</para>\n+          <option name=\"a\">\n+            <para>Answer, i.e. send initial FSK packet.</para>\n           </option>\n-          <option name=\"e\">\n-            <para>Which entertainment mechanism should be used while on hold\n-\t\t\t\t\t\tin the holding bridge. Only the first letter is read.</para>\n-            <enumlist>\n-              <enum name=\"m\">\n-                <para>Play music on hold (default)</para>\n-              </enum>\n-              <enum name=\"r\">\n-                <para>Ring without pause</para>\n-              </enum>\n-              <enum name=\"s\">\n-                <para>Generate silent audio</para>\n-              </enum>\n-              <enum name=\"h\">\n-                <para>Put the channel on hold</para>\n-              </enum>\n-              <enum name=\"n\">\n-                <para>No entertainment</para>\n-              </enum>\n-            </enumlist>\n+          <option name=\"s\">\n+            <para>Act as service centre talking to a phone.</para>\n           </option>\n-          <option name=\"S\">\n-            <argument name=\"duration\" required=\"true\"/>\n+          <option name=\"t\">\n+            <para>Use protocol 2 (default used is protocol 1).</para>\n+          </option>\n+          <option name=\"p\">\n             <para>\n-              Automatically exit the bridge and return to the PBX after\n-              <emphasis>duration</emphasis>\n-              seconds.\n+              Set the initial delay to N ms (default is\n+              <literal>300</literal>\n+              ).\n+\t\t\t\t\t\taddr and body are a deprecated format to send messages out.\n             </para>\n           </option>\n+          <option name=\"r\">\n+            <para>Set the Status Report Request (SRR) bit.</para>\n+          </option>\n+          <option name=\"o\">\n+            <para>The body should be coded as octets not 7-bit symbols.</para>\n+          </option>\n+          <option name=\"n\">\n+            <para>Do not log any SMS content to log file (privacy).</para>\n+          </option>\n         </optionlist>\n       </parameter>\n+      <parameter name=\"addr\"/>\n+      <parameter name=\"body\"/>\n     </syntax>\n     <description>\n-      <para>This application places the incoming channel into a holding bridge.\n-\t\t\tThe channel will then wait in the holding bridge until some event occurs\n-\t\t\twhich removes it from the holding bridge.</para>\n+      <para>SMS handles exchange of SMS data with a call to/from SMS capable phone or SMS PSTN service center.\n+\t\t\tCan send and/or receive SMS messages. Works to ETSI ES 201 912; compatible with BT SMS PSTN service in\n+\t\t\tUK and Telecom Italia in Italy.</para>\n+      <para>\n+        Typical usage is to use to handle calls from the SMS service centre CLI, or to set up a call using\n+        <literal>outgoing</literal>\n+        or manager interface to connect service centre to SMS().\n+      </para>\n+      <para>&quot;Messages are processed as per text file message queues. smsq (a separate software) is a command to\n+\t\t\tgenerate message queues and send messages.</para>\n       <note>\n-        <para>This application will answer calls which haven't already\n-\t\t\tbeen answered.</para>\n+        <para>The protocol has tight delay bounds. Please use short frames and disable/keep short the\n+\t\t\tjitter buffer on the ATA to make sure that respones (ACK etc.) are received in time.</para>\n       </note>\n     </description>\n   </application>\n-  <module language=\"en_US\" name=\"app_playback\">\n+  <module language=\"en_US\" name=\"app_nbscat\">\n+    <support_level>deprecated</support_level>\n+    <deprecated_in>16</deprecated_in>\n+    <removed_in>19</removed_in>\n+  </module>\n+  <application name=\"NBScat\" language=\"en_US\">\n+    <synopsis>Play an NBS local stream.</synopsis>\n+    <syntax/>\n+    <description>\n+      <para>Executes nbscat to listen to the local NBS stream.\n+\t\t\tUser can exit by pressing any key.</para>\n+    </description>\n+  </application>\n+  <module language=\"en_US\" name=\"app_privacy\">\n     <support_level>core</support_level>\n   </module>\n-  <application name=\"Playback\" language=\"en_US\">\n-    <synopsis>Play a file.</synopsis>\n+  <application name=\"PrivacyManager\" language=\"en_US\">\n+    <synopsis>Require phone number to be entered, if no CallerID sent</synopsis>\n     <syntax>\n-      <parameter name=\"filenames\" required=\"true\" argsep=\"&amp;\">\n-        <argument name=\"filename\" required=\"true\"/>\n-        <argument name=\"filename2\" multiple=\"true\"/>\n+      <parameter name=\"maxretries\">\n+        <para>\n+          Total tries caller is allowed to input a callerid. Defaults to\n+          <literal>3</literal>\n+          .\n+        </para>\n+      </parameter>\n+      <parameter name=\"minlength\">\n+        <para>\n+          Minimum allowable digits in the input callerid number. Defaults to\n+          <literal>10</literal>\n+          .\n+        </para>\n       </parameter>\n       <parameter name=\"options\">\n-        <para>Comma separated list of options</para>\n-        <optionlist>\n-          <option name=\"skip\">\n-            <para>Do not play if not answered</para>\n-          </option>\n-          <option name=\"noanswer\">\n-            <para>Playback without answering, otherwise the channel will\n-\t\t\t\t\t\tbe answered before the sound is played.</para>\n-            <note>\n-              <para>Not all channel types support playing messages while still on hook.</para>\n-            </note>\n-          </option>\n-          <option name=\"say\">\n-            <para>Play using the say.conf file.</para>\n-          </option>\n-          <option name=\"mix\">\n-            <para>Play using a mix of filename and the say.conf file.</para>\n-          </option>\n-        </optionlist>\n+        <para>Position reserved for options.</para>\n+      </parameter>\n+      <parameter name=\"context\">\n+        <para>Context to check the given callerid against patterns.</para>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>Plays back given filenames (do not put extension of wav/alaw etc).\n-\t\t\tThe Playback application answers the channel if no options are specified.\n-\t\t\tIf the file is non-existent it will fail.</para>\n-      <para>This application sets the following channel variable upon completion:</para>\n+      <para>\n+        If no Caller*ID is sent, PrivacyManager answers the channel and asks\n+\t\t\tthe caller to enter their phone number. The caller is given\n+        <replaceable>maxretries</replaceable>\n+        attempts to do so. The application does\n+        <emphasis>nothing</emphasis>\n+        if Caller*ID was received on the channel.\n+      </para>\n+      <para>The application sets the following channel variable upon completion:</para>\n       <variablelist>\n-        <variable name=\"PLAYBACKSTATUS\">\n-          <para>The status of the playback attempt as a text string.</para>\n+        <variable name=\"PRIVACYMGRSTATUS\">\n+          <para>The status of the privacy manager's attempt to collect a phone number from the user.</para>\n           <value name=\"SUCCESS\"/>\n           <value name=\"FAILED\"/>\n         </variable>\n       </variablelist>\n-      <para>See Also: Background (application) -- for playing sound files that are interruptible</para>\n-      <para>WaitExten (application) -- wait for digits from caller, optionally play music on hold</para>\n     </description>\n     <see-also>\n-      <ref type=\"application\">Background</ref>\n-      <ref type=\"application\">WaitExten</ref>\n-      <ref type=\"application\">ControlPlayback</ref>\n-      <ref type=\"agi\">stream file</ref>\n-      <ref type=\"agi\">control stream file</ref>\n-      <ref type=\"manager\">ControlPlayback</ref>\n+      <ref type=\"application\">Zapateller</ref>\n     </see-also>\n   </application>\n-  <module language=\"en_US\" name=\"app_stream_echo\">\n+  <module language=\"en_US\" name=\"app_stack\">\n+    <use type=\"module\">res_agi</use>\n     <support_level>core</support_level>\n   </module>\n-  <application name=\"StreamEcho\" language=\"en_US\">\n-    <synopsis>Echo media, up to 'N' streams of a type, and DTMF back to the calling party</synopsis>\n+  <application name=\"Gosub\" language=\"en_US\">\n+    <synopsis>Jump to label, saving return address.</synopsis>\n     <syntax>\n-      <parameter name=\"num\" required=\"false\">\n-        <para>The number of streams of a type to echo back. If '0' is specified then\n-\t\t\tall streams of a type are removed.</para>\n-      </parameter>\n-      <parameter name=\"type\" required=\"false\">\n-        <para>The media type of the stream(s) to add or remove (in the case of &quot;num&quot;\n-\t\t\tbeing '0'). This can be set to either &quot;audio&quot; or &quot;video&quot; (default). If &quot;num&quot;\n-\t\t\tis empty (i.e. not specified) then this parameter is ignored.</para>\n+      <parameter name=\"context\"/>\n+      <parameter name=\"exten\"/>\n+      <parameter name=\"priority\" required=\"true\" hasparams=\"optional\">\n+        <argument name=\"arg1\" multiple=\"true\" required=\"true\"/>\n+        <argument name=\"argN\"/>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>If a &quot;num&quot; (the number of streams) is not given then this simply echos\n-\t\t\tback any media or DTMF frames (note, however if '#' is detected then the\n-\t\t\tapplication exits) read from the calling channel back to itself. This means\n-\t\t\tfor any relevant frame read from a particular stream it is written back out\n-\t\t\tto the associated write stream in a one to one fashion.</para>\n-      <para>However if a &quot;num&quot; is specified, and if the calling channel allows it\n-\t\t\t(a new offer is made requesting the allowance of additional streams) then any\n-\t\t\tany media received, like before, is echoed back onto each stream. However, in\n-\t\t\tthis case a relevant frame received on a stream of the given &quot;type&quot; is also\n-\t\t\techoed back out to the other streams of that same type. It should be noted that\n-\t\t\twhen operating in this mode only the first stream found of the given &quot;type&quot; is\n-\t\t\tallowed from the original offer. And this first stream found is also the only\n-\t\t\tstream of that &quot;type&quot; granted read (send/receive) capabilities in the new offer\n-\t\t\twhereas the additional ones are set to receive only.</para>\n-      <note>\n-        <para>This does not echo CONTROL, MODEM, or NULL frames.</para>\n-      </note>\n+      <para>Jumps to the label specified, saving the return address.</para>\n     </description>\n+    <see-also>\n+      <ref type=\"application\">GosubIf</ref>\n+      <ref type=\"application\">Macro</ref>\n+      <ref type=\"application\">Goto</ref>\n+      <ref type=\"application\">Return</ref>\n+      <ref type=\"application\">StackPop</ref>\n+    </see-also>\n   </application>\n-  <module language=\"en_US\" name=\"app_dial\">\n-    <support_level>core</support_level>\n-  </module>\n-  <application name=\"Dial\" language=\"en_US\">\n-    <synopsis>Attempt to connect to another device or endpoint and bridge the call.</synopsis>\n-    <syntax>\n-      <parameter name=\"Technology/Resource\" required=\"false\" argsep=\"&amp;\">\n-        <argument name=\"Technology/Resource\" required=\"true\">\n+  <application name=\"GosubIf\" language=\"en_US\">\n+    <synopsis>Conditionally jump to label, saving return address.</synopsis>\n+    <syntax argsep=\"?\">\n+      <parameter name=\"condition\" required=\"true\"/>\n+      <parameter name=\"destination\" required=\"true\" argsep=\":\">\n+        <argument name=\"labeliftrue\" hasparams=\"optional\">\n           <para>\n-            Specification of the device(s) to dial.  These must be in the format of\n-            <literal>Technology/Resource</literal>\n-            , where\n-            <replaceable>Technology</replaceable>\n-            represents a particular channel driver, and\n-            <replaceable>Resource</replaceable>\n-            represents a resource available to that particular channel driver.\n+            Continue at\n+            <replaceable>labeliftrue</replaceable>\n+            if the condition is true.\n+\t\t\t\t\tTakes the form similar to Goto() of [[context,]extension,]priority.\n           </para>\n+          <argument name=\"arg1\" required=\"true\" multiple=\"true\"/>\n+          <argument name=\"argN\"/>\n         </argument>\n-        <argument name=\"Technology2/Resource2\" required=\"false\" multiple=\"true\">\n-          <para>Optional extra devices to dial in parallel</para>\n-          <para>If you need more than one enter them as\n-\t\t\t\t\tTechnology2/Resource2&amp;Technology3/Resource3&amp;.....</para>\n+        <argument name=\"labeliffalse\" hasparams=\"optional\">\n+          <para>\n+            Continue at\n+            <replaceable>labeliffalse</replaceable>\n+            if the condition is false.\n+\t\t\t\t\tTakes the form similar to Goto() of [[context,]extension,]priority.\n+          </para>\n+          <argument name=\"arg1\" required=\"true\" multiple=\"true\"/>\n+          <argument name=\"argN\"/>\n         </argument>\n-        <xi:include xpointer=\"xpointer(/docs/info[@name='Dial_Resource'])\"/>\n       </parameter>\n-      <parameter name=\"timeout\" required=\"false\">\n-        <para>Specifies the number of seconds we attempt to dial the specified devices.</para>\n-        <para>If not specified, this defaults to 136 years.</para>\n+    </syntax>\n+    <description>\n+      <para>If the condition is true, then jump to labeliftrue.  If false, jumps to\n+\t\t\tlabeliffalse, if specified.  In either case, a jump saves the return point\n+\t\t\tin the dialplan, to be returned to with a Return.</para>\n+    </description>\n+    <see-also>\n+      <ref type=\"application\">Gosub</ref>\n+      <ref type=\"application\">Return</ref>\n+      <ref type=\"application\">MacroIf</ref>\n+      <ref type=\"function\">IF</ref>\n+      <ref type=\"application\">GotoIf</ref>\n+      <ref type=\"application\">Goto</ref>\n+    </see-also>\n+  </application>\n+  <application name=\"Return\" language=\"en_US\">\n+    <synopsis>Return from gosub routine.</synopsis>\n+    <syntax>\n+      <parameter name=\"value\">\n+        <para>Return value.</para>\n       </parameter>\n-      <parameter name=\"options\" required=\"false\">\n-        <optionlist>\n-          <option name=\"A\" argsep=\":\">\n-            <argument name=\"x\">\n-              <para>The file to play to the called party</para>\n-            </argument>\n-            <argument name=\"y\">\n-              <para>The file to play to the calling party</para>\n-            </argument>\n-            <para>\n-              Play an announcement to the called and/or calling parties, where\n-              <replaceable>x</replaceable>\n-              is the prompt to be played to the called party and\n-              <replaceable>y</replaceable>\n-              is the prompt\n-\t\t\t\t\tto be played to the caller. The files may be different and will be played to each party\n-\t\t\t\t\tsimultaneously.\n-            </para>\n-          </option>\n-          <option name=\"a\">\n-            <para>\n-              Immediately answer the calling channel when the called channel answers in\n-\t\t\t\t\tall cases. Normally, the calling channel is answered when the called channel\n-\t\t\t\t\tanswers, but when options such as\n-              <literal>A()</literal>\n-              and\n-              <literal>M()</literal>\n-              are used, the calling channel is\n-\t\t\t\t\tnot answered until all actions on the called channel (such as playing an\n-\t\t\t\t\tannouncement) are completed.  This option can be used to answer the calling\n-\t\t\t\t\tchannel before doing anything on the called channel. You will rarely need to use\n-\t\t\t\t\tthis option, the default behavior is adequate in most cases.\n-            </para>\n-          </option>\n-          <option name=\"b\" argsep=\"^\">\n-            <para>\n-              Before initiating an outgoing call,\n-              <literal>Gosub</literal>\n-              to the specified\n-\t\t\t\t\tlocation using the newly created channel.  The\n-              <literal>Gosub</literal>\n-              will be\n-\t\t\t\t\texecuted for each destination channel.\n-            </para>\n-            <argument name=\"context\" required=\"false\"/>\n-            <argument name=\"exten\" required=\"false\"/>\n-            <argument name=\"priority\" required=\"true\" hasparams=\"optional\" argsep=\"^\">\n-              <argument name=\"arg1\" multiple=\"true\" required=\"true\"/>\n-              <argument name=\"argN\"/>\n-            </argument>\n-          </option>\n-          <option name=\"B\" argsep=\"^\">\n-            <para>\n-              Before initiating the outgoing call(s),\n-              <literal>Gosub</literal>\n-              to the\n-\t\t\t\t\tspecified location using the current channel.\n-            </para>\n-            <argument name=\"context\" required=\"false\"/>\n-            <argument name=\"exten\" required=\"false\"/>\n-            <argument name=\"priority\" required=\"true\" hasparams=\"optional\" argsep=\"^\">\n-              <argument name=\"arg1\" multiple=\"true\" required=\"true\"/>\n-              <argument name=\"argN\"/>\n-            </argument>\n-          </option>\n-          <option name=\"C\">\n-            <para>Reset the call detail record (CDR) for this call.</para>\n-          </option>\n-          <option name=\"c\">\n-            <para>\n-              If the Dial() application cancels this call, always set\n-              <variable>HANGUPCAUSE</variable>\n-              to 'answered elsewhere'\n-            </para>\n-          </option>\n-          <option name=\"d\">\n-            <para>\n-              Allow the calling user to dial a 1 digit extension while waiting for\n-\t\t\t\t\ta call to be answered. Exit to that extension if it exists in the\n-\t\t\t\t\tcurrent context, or the context defined in the\n-              <variable>EXITCONTEXT</variable>\n-              variable,\n-\t\t\t\t\tif it exists.\n-            </para>\n-            <para>\n-              NOTE: Many SIP and ISDN phones cannot send DTMF digits until the call is\n-\t\t\t\t\tconnected.  If you wish to use this option with these phones, you\n-\t\t\t\t\tcan use the\n-              <literal>Answer</literal>\n-              application before dialing.\n-            </para>\n-          </option>\n-          <option name=\"D\" argsep=\":\">\n-            <argument name=\"called\"/>\n-            <argument name=\"calling\"/>\n-            <argument name=\"progress\"/>\n-            <argument name=\"mfprogress\"/>\n-            <argument name=\"mfwink\"/>\n-            <argument name=\"sfprogress\"/>\n-            <argument name=\"sfwink\"/>\n-            <para>\n-              Send the specified DTMF strings\n-              <emphasis>after</emphasis>\n-              the called\n-\t\t\t\t\tparty has answered, but before the call gets bridged.  The\n-              <replaceable>called</replaceable>\n-              DTMF string is sent to the called party, and the\n-              <replaceable>calling</replaceable>\n-              DTMF string is sent to the calling party.  Both arguments\n-\t\t\t\t\tcan be used alone.  If\n-              <replaceable>progress</replaceable>\n-              is specified, its DTMF is sent\n-\t\t\t\t\tto the called party immediately after receiving a\n-              <literal>PROGRESS</literal>\n-              message.\n-            </para>\n-            <para>\n-              See\n-              <literal>SendDTMF</literal>\n-              for valid digits.\n-            </para>\n-            <para>\n-              If\n-              <replaceable>mfprogress</replaceable>\n-              is specified, its MF is sent\n-\t\t\t\t\tto the called party immediately after receiving a\n-              <literal>PROGRESS</literal>\n-              message.\n-\t\t\t\t\tIf\n-              <replaceable>mfwink</replaceable>\n-              is specified, its MF is sent\n-\t\t\t\t\tto the called party immediately after receiving a\n-              <literal>WINK</literal>\n-              message.\n-            </para>\n-            <para>\n-              See\n-              <literal>SendMF</literal>\n-              for valid digits.\n-            </para>\n-            <para>\n-              If\n-              <replaceable>sfprogress</replaceable>\n-              is specified, its SF is sent\n-\t\t\t\t\tto the called party immediately after receiving a\n-              <literal>PROGRESS</literal>\n-              message.\n-\t\t\t\t\tIf\n-              <replaceable>sfwink</replaceable>\n-              is specified, its SF is sent\n-\t\t\t\t\tto the called party immediately after receiving a\n-              <literal>WINK</literal>\n-              message.\n-            </para>\n-            <para>\n-              See\n-              <literal>SendSF</literal>\n-              for valid digits.\n-            </para>\n-          </option>\n-          <option name=\"E\">\n-            <para>Enable echoing of sent MF or SF digits back to caller (e.g. &quot;hearpulsing&quot;).\n-\t\t\t\t\tUsed in conjunction with the D option.</para>\n-          </option>\n-          <option name=\"e\">\n-            <para>\n-              Execute the\n-              <literal>h</literal>\n-              extension for peer after the call ends\n-            </para>\n-          </option>\n-          <option name=\"f\">\n-            <argument name=\"x\" required=\"false\"/>\n+    </syntax>\n+    <description>\n+      <para>\n+        Jumps to the last label on the stack, removing it. The return\n+        <replaceable>value</replaceable>\n+        , if\n+\t\t\tany, is saved in the channel variable\n+        <variable>GOSUB_RETVAL</variable>\n+        .\n+      </para>\n+    </description>\n+    <see-also>\n+      <ref type=\"application\">Gosub</ref>\n+      <ref type=\"application\">StackPop</ref>\n+    </see-also>\n+  </application>\n+  <application name=\"StackPop\" language=\"en_US\">\n+    <synopsis>Remove one address from gosub stack.</synopsis>\n+    <syntax/>\n+    <description>\n+      <para>Removes last label on the stack, discarding it.</para>\n+    </description>\n+    <see-also>\n+      <ref type=\"application\">Return</ref>\n+      <ref type=\"application\">Gosub</ref>\n+    </see-also>\n+  </application>\n+  <function name=\"LOCAL\" language=\"en_US\">\n+    <synopsis>Manage variables local to the gosub stack frame.</synopsis>\n+    <syntax>\n+      <parameter name=\"varname\" required=\"true\"/>\n+    </syntax>\n+    <description>\n+      <para>Read and write a variable local to the gosub stack frame, once we Return() it will be lost\n+\t\t\t(or it will go back to whatever value it had before the Gosub()).</para>\n+    </description>\n+    <see-also>\n+      <ref type=\"application\">Gosub</ref>\n+      <ref type=\"application\">GosubIf</ref>\n+      <ref type=\"application\">Return</ref>\n+    </see-also>\n+  </function>\n+  <function name=\"LOCAL_PEEK\" language=\"en_US\">\n+    <synopsis>Retrieve variables hidden by the local gosub stack frame.</synopsis>\n+    <syntax>\n+      <parameter name=\"n\" required=\"true\"/>\n+      <parameter name=\"varname\" required=\"true\"/>\n+    </syntax>\n+    <description>\n+      <para>\n+        Read a variable\n+        <replaceable>varname</replaceable>\n+        hidden by\n+        <replaceable>n</replaceable>\n+        levels of gosub stack frames.  Note that ${LOCAL_PEEK(0,foo)}\n+\t\t\tis the same as\n+        <variable>foo</variable>\n+        , since the value of\n+        <replaceable>n</replaceable>\n+        peeks under 0 levels of stack frames; in other words, 0 is the current level.  If\n+        <replaceable>n</replaceable>\n+        exceeds the available number of stack frames, then an empty\n+\t\t\tstring is returned.\n+      </para>\n+    </description>\n+    <see-also>\n+      <ref type=\"application\">Gosub</ref>\n+      <ref type=\"application\">GosubIf</ref>\n+      <ref type=\"application\">Return</ref>\n+    </see-also>\n+  </function>\n+  <function name=\"STACK_PEEK\" language=\"en_US\">\n+    <synopsis>View info about the location which called Gosub</synopsis>\n+    <syntax>\n+      <parameter name=\"n\" required=\"true\"/>\n+      <parameter name=\"which\" required=\"true\"/>\n+      <parameter name=\"suppress\" required=\"false\"/>\n+    </syntax>\n+    <description>\n+      <para>\n+        Read the calling\n+        <literal>c</literal>\n+        ontext,\n+        <literal>e</literal>\n+        xtension,\n+        <literal>p</literal>\n+        riority, or\n+        <literal>l</literal>\n+        abel, as specified by\n+        <replaceable>which</replaceable>\n+        , by going up\n+        <replaceable>n</replaceable>\n+        frames\n+\t\t\tin the Gosub stack.  If\n+        <replaceable>suppress</replaceable>\n+        is true, then if the\n+\t\t\tnumber of available stack frames is exceeded, then no error message will be\n+\t\t\tprinted.\n+      </para>\n+    </description>\n+  </function>\n+  <agi name=\"gosub\" language=\"en_US\">\n+    <synopsis>Cause the channel to execute the specified dialplan subroutine.</synopsis>\n+    <syntax>\n+      <parameter name=\"context\" required=\"true\"/>\n+      <parameter name=\"extension\" required=\"true\"/>\n+      <parameter name=\"priority\" required=\"true\"/>\n+      <parameter name=\"optional-argument\"/>\n+    </syntax>\n+    <description>\n+      <para>Cause the channel to execute the specified dialplan subroutine,\n+\t\t\treturning to the dialplan with execution of a Return().</para>\n+    </description>\n+    <see-also>\n+      <ref type=\"application\">GoSub</ref>\n+    </see-also>\n+  </agi>\n+  <managerEvent language=\"en_US\" name=\"VarSet\">\n+    <managerEventInstance class=\"EVENT_FLAG_DIALPLAN\">\n+      <synopsis>Raised when a variable local to the gosub stack frame is set due to a subroutine call.</synopsis>\n+      <syntax>\n+        <channel_snapshot/>\n+        <parameter name=\"Variable\">\n+          <para>The LOCAL variable being set.</para>\n+          <note>\n             <para>\n-              If\n-              <replaceable>x</replaceable>\n-              is not provided, force the CallerID sent on a call-forward or\n-\t\t\t\t\tdeflection to the dialplan extension of this\n-              <literal>Dial()</literal>\n-              using a dialplan\n-              <literal>hint</literal>\n-              .\n-\t\t\t\t\tFor example, some PSTNs do not allow CallerID to be set to anything\n-\t\t\t\t\tother than the numbers assigned to you.\n-\t\t\t\t\tIf\n-              <replaceable>x</replaceable>\n-              is provided, force the CallerID sent to\n-              <replaceable>x</replaceable>\n-              .\n+              The variable name will always be enclosed with\n+              <literal>LOCAL()</literal>\n             </para>\n-          </option>\n-          <option name=\"F\" argsep=\"^\">\n-            <argument name=\"context\" required=\"false\"/>\n-            <argument name=\"exten\" required=\"false\"/>\n-            <argument name=\"priority\" required=\"true\"/>\n+          </note>\n+        </parameter>\n+        <parameter name=\"Value\">\n+          <para>The new value of the variable.</para>\n+        </parameter>\n+      </syntax>\n+      <see-also>\n+        <ref type=\"application\">GoSub</ref>\n+        <ref type=\"agi\">gosub</ref>\n+        <ref type=\"function\">LOCAL</ref>\n+        <ref type=\"function\">LOCAL_PEEK</ref>\n+      </see-also>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <module language=\"en_US\" name=\"app_dictate\">\n+    <support_level>extended</support_level>\n+  </module>\n+  <application name=\"Dictate\" language=\"en_US\">\n+    <synopsis>Virtual Dictation Machine.</synopsis>\n+    <syntax>\n+      <parameter name=\"base_dir\"/>\n+      <parameter name=\"filename\"/>\n+    </syntax>\n+    <description>\n+      <para>\n+        Start dictation machine using optional\n+        <replaceable>base_dir</replaceable>\n+        for files.\n+      </para>\n+    </description>\n+  </application>\n+  <module language=\"en_US\" name=\"app_waitforring\">\n+    <support_level>extended</support_level>\n+  </module>\n+  <application name=\"WaitForRing\" language=\"en_US\">\n+    <synopsis>Wait for Ring Application.</synopsis>\n+    <syntax>\n+      <parameter name=\"timeout\" required=\"true\"/>\n+    </syntax>\n+    <description>\n+      <para>\n+        Returns\n+        <literal>0</literal>\n+        after waiting at least\n+        <replaceable>timeout</replaceable>\n+        seconds,\n+\t\t\tand only after the next ring has completed. Returns\n+        <literal>0</literal>\n+        on success or\n+        <literal>-1</literal>\n+        on hangup.\n+      </para>\n+    </description>\n+  </application>\n+  <module language=\"en_US\" name=\"app_blind_transfer\">\n+    <support_level>extended</support_level>\n+  </module>\n+  <application name=\"BlindTransfer\" language=\"en_US\">\n+    <synopsis>Blind transfer channel(s) to the extension and context provided</synopsis>\n+    <syntax>\n+      <parameter name=\"exten\" required=\"true\">\n+        <para>Specify extension.</para>\n+      </parameter>\n+      <parameter name=\"context\">\n+        <para>Optionally specify a context.\n+\t\t\t\tBy default, Asterisk will use the caller channel context.</para>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>Redirect all channels currently bridged to the caller channel to the\n+\t\t\tspecified destination.</para>\n+      <para>\n+        The result of the application will be reported in the\n+        <variable>BLINDTRANSFERSTATUS</variable>\n+        channel variable:\n+      </para>\n+      <variablelist>\n+        <variable name=\"BLINDTRANSFERSTATUS\">\n+          <value name=\"SUCCESS\">Transfer succeeded.</value>\n+          <value name=\"FAILURE\">Transfer failed.</value>\n+          <value name=\"INVALID\">Transfer invalid.</value>\n+          <value name=\"NOTPERMITTED\">Transfer not permitted.</value>\n+        </variable>\n+      </variablelist>\n+    </description>\n+  </application>\n+  <module language=\"en_US\" name=\"app_minivm\">\n+    <support_level>extended</support_level>\n+  </module>\n+  <application name=\"MinivmRecord\" language=\"en_US\">\n+    <synopsis>Receive Mini-Voicemail and forward via e-mail.</synopsis>\n+    <syntax>\n+      <parameter name=\"mailbox\" required=\"true\" argsep=\"@\">\n+        <argument name=\"username\" required=\"true\">\n+          <para>Voicemail username</para>\n+        </argument>\n+        <argument name=\"domain\" required=\"true\">\n+          <para>Voicemail domain</para>\n+        </argument>\n+      </parameter>\n+      <parameter name=\"options\" required=\"false\">\n+        <optionlist>\n+          <option name=\"0\">\n             <para>\n-              When the caller hangs up, transfer the\n-              <emphasis>called</emphasis>\n-              party\n-\t\t\t\t\tto the specified destination and\n-              <emphasis>start</emphasis>\n-              execution at that location.\n+              Jump to the\n+              <literal>o</literal>\n+              extension in the current dialplan context.\n             </para>\n-            <para>NOTE: Any channel variables you want the called channel to inherit from the caller channel must be\n-\t\t\t\t\tprefixed with one or two underbars ('_').</para>\n           </option>\n-          <option name=\"F\">\n+          <option name=\"*\">\n             <para>\n-              When the caller hangs up, transfer the\n-              <emphasis>called</emphasis>\n-              party to the next priority of the current extension\n-\t\t\t\t\tand\n-              <emphasis>start</emphasis>\n-              execution at that location.\n+              Jump to the\n+              <literal>a</literal>\n+              extension in the current dialplan context.\n             </para>\n-            <para>NOTE: Any channel variables you want the called channel to inherit from the caller channel must be\n-\t\t\t\t\tprefixed with one or two underbars ('_').</para>\n-            <para>NOTE: Using this option from a Macro() or GoSub() might not make sense as there would be no return points.</para>\n           </option>\n           <option name=\"g\">\n-            <para>Proceed with dialplan execution at the next priority in the current extension if the\n-\t\t\t\t\tdestination channel hangs up.</para>\n-          </option>\n-          <option name=\"G\" argsep=\"^\">\n-            <argument name=\"context\" required=\"false\"/>\n-            <argument name=\"exten\" required=\"false\"/>\n-            <argument name=\"priority\" required=\"true\"/>\n-            <para>\n-              If the call is answered, transfer the calling party to\n-\t\t\t\t\tthe specified\n-              <replaceable>priority</replaceable>\n-              and the called party to the specified\n-              <replaceable>priority</replaceable>\n-              plus one.\n-            </para>\n-            <para>NOTE: You cannot use any additional action post answer options in conjunction with this option.</para>\n-          </option>\n-          <option name=\"h\">\n-            <para>\n-              Allow the called party to hang up by sending the DTMF sequence\n-\t\t\t\t\tdefined for disconnect in\n-              <filename>features.conf</filename>\n-              .\n-            </para>\n-          </option>\n-          <option name=\"H\">\n-            <para>\n-              Allow the calling party to hang up by sending the DTMF sequence\n-\t\t\t\t\tdefined for disconnect in\n-              <filename>features.conf</filename>\n-              .\n-            </para>\n-            <para>\n-              NOTE: Many SIP and ISDN phones cannot send DTMF digits until the call is\n-\t\t\t\t\tconnected.  If you wish to allow DTMF disconnect before the dialed\n-\t\t\t\t\tparty answers with these phones, you can use the\n-              <literal>Answer</literal>\n-              application before dialing.\n-            </para>\n-          </option>\n-          <option name=\"i\">\n-            <para>Asterisk will ignore any forwarding requests it may receive on this dial attempt.</para>\n-          </option>\n-          <option name=\"I\">\n-            <para>Asterisk will ignore any connected line update requests or any redirecting party\n-\t\t\t\t\tupdate requests it may receive on this dial attempt.</para>\n-          </option>\n-          <option name=\"k\">\n-            <para>\n-              Allow the called party to enable parking of the call by sending\n-\t\t\t\t\tthe DTMF sequence defined for call parking in\n-              <filename>features.conf</filename>\n-              .\n-            </para>\n-          </option>\n-          <option name=\"K\">\n-            <para>\n-              Allow the calling party to enable parking of the call by sending\n-\t\t\t\t\tthe DTMF sequence defined for call parking in\n-              <filename>features.conf</filename>\n-              .\n-            </para>\n-          </option>\n-          <option name=\"L\" argsep=\":\">\n-            <argument name=\"x\" required=\"true\">\n-              <para>Maximum call time, in milliseconds</para>\n-            </argument>\n-            <argument name=\"y\">\n-              <para>Warning time, in milliseconds</para>\n-            </argument>\n-            <argument name=\"z\">\n-              <para>Repeat time, in milliseconds</para>\n-            </argument>\n-            <para>\n-              Limit the call to\n-              <replaceable>x</replaceable>\n-              milliseconds. Play a warning when\n-              <replaceable>y</replaceable>\n-              milliseconds are\n-\t\t\t\t\tleft. Repeat the warning every\n-              <replaceable>z</replaceable>\n-              milliseconds until time expires.\n-            </para>\n-            <para>This option is affected by the following variables:</para>\n-            <variablelist>\n-              <variable name=\"LIMIT_PLAYAUDIO_CALLER\">\n-                <value name=\"yes\" default=\"true\"/>\n-                <value name=\"no\"/>\n-                <para>If set, this variable causes Asterisk to play the prompts to the caller.</para>\n-              </variable>\n-              <variable name=\"LIMIT_PLAYAUDIO_CALLEE\">\n-                <value name=\"yes\"/>\n-                <value name=\"no\" default=\"true\"/>\n-                <para>If set, this variable causes Asterisk to play the prompts to the callee.</para>\n-              </variable>\n-              <variable name=\"LIMIT_TIMEOUT_FILE\">\n-                <value name=\"filename\"/>\n-                <para>\n-                  If specified,\n-                  <replaceable>filename</replaceable>\n-                  specifies the sound prompt to play when the timeout is reached.\n-\t\t\t\t\t\t\tIf not set, the time remaining will be announced.\n-                </para>\n-              </variable>\n-              <variable name=\"LIMIT_CONNECT_FILE\">\n-                <value name=\"filename\"/>\n-                <para>\n-                  If specified,\n-                  <replaceable>filename</replaceable>\n-                  specifies the sound prompt to play when the call begins.\n-\t\t\t\t\t\t\tIf not set, the time remaining will be announced.\n-                </para>\n-              </variable>\n-              <variable name=\"LIMIT_WARNING_FILE\">\n-                <value name=\"filename\"/>\n-                <para>\n-                  If specified,\n-                  <replaceable>filename</replaceable>\n-                  specifies the sound prompt to play as\n-\t\t\t\t\t\t\ta warning when time\n-                  <replaceable>x</replaceable>\n-                  is reached. If not set, the time remaining will be announced.\n-                </para>\n-              </variable>\n-            </variablelist>\n-          </option>\n-          <option name=\"m\">\n-            <argument name=\"class\" required=\"false\"/>\n-            <para>\n-              Provide hold music to the calling party until a requested\n-\t\t\t\t\tchannel answers. A specific music on hold\n-              <replaceable>class</replaceable>\n-              (as defined in\n-              <filename>musiconhold.conf</filename>\n-              ) can be specified.\n-            </para>\n-          </option>\n-          <option name=\"M\" argsep=\"^\">\n-            <argument name=\"macro\" required=\"true\">\n-              <para>Name of the macro that should be executed.</para>\n-            </argument>\n-            <argument name=\"arg\" multiple=\"true\">\n-              <para>Macro arguments</para>\n-            </argument>\n-            <para>\n-              Execute the specified\n-              <replaceable>macro</replaceable>\n-              for the\n-              <emphasis>called</emphasis>\n-              channel\n-\t\t\t\t\tbefore connecting to the calling channel. Arguments can be specified to the Macro\n-\t\t\t\t\tusing\n-              <literal>^</literal>\n-              as a delimiter. The macro can set the variable\n-              <variable>MACRO_RESULT</variable>\n-              to specify the following actions after the macro is\n-\t\t\t\t\tfinished executing:\n-            </para>\n-            <variablelist>\n-              <variable name=\"MACRO_RESULT\">\n-                <para>If set, this action will be taken after the macro finished executing.</para>\n-                <value name=\"ABORT\">Hangup both legs of the call</value>\n-                <value name=\"CONGESTION\">Behave as if line congestion was encountered</value>\n-                <value name=\"BUSY\">Behave as if a busy signal was encountered</value>\n-                <value name=\"CONTINUE\">Hangup the called party and allow the calling party to continue dialplan execution at the next priority</value>\n-                <value name=\"GOTO:[[&lt;context&gt;^]&lt;exten&gt;^]&lt;priority&gt;\">Transfer the call to the specified destination.</value>\n-              </variable>\n-            </variablelist>\n-            <para>\n-              NOTE: You cannot use any additional action post answer options in conjunction\n-\t\t\t\t\twith this option. Also, pbx services are run on the peer (called) channel,\n-\t\t\t\t\tso you will not be able to set timeouts via the\n-              <literal>TIMEOUT()</literal>\n-              function in this macro.\n-            </para>\n-            <para>\n-              WARNING: Be aware of the limitations that macros have, specifically with regards to use of\n-\t\t\t\t\tthe\n-              <literal>WaitExten</literal>\n-              application. For more information, see the documentation for\n-              <literal>Macro()</literal>\n-              .\n-            </para>\n-            <para>\n-              NOTE: Macros are deprecated, GoSub should be used instead,\n-\t\t\t\t\tsee the\n-              <literal>U</literal>\n-              option.\n-            </para>\n-          </option>\n-          <option name=\"n\">\n-            <argument name=\"delete\">\n-              <para>\n-                With\n-                <replaceable>delete</replaceable>\n-                either not specified or set to\n-                <literal>0</literal>\n-                ,\n-\t\t\t\t\t\tthe recorded introduction will not be deleted if the caller hangs up while the remote party has not\n-\t\t\t\t\t\tyet answered.\n-              </para>\n-              <para>\n-                With\n-                <replaceable>delete</replaceable>\n-                set to\n-                <literal>1</literal>\n-                , the introduction will\n-\t\t\t\t\t\talways be deleted.\n-              </para>\n+            <argument name=\"gain\">\n+              <para>Amount of gain to use</para>\n             </argument>\n-            <para>\n-              This option is a modifier for the call screening/privacy mode. (See the\n-              <literal>p</literal>\n-              and\n-              <literal>P</literal>\n-              options.) It specifies\n-\t\t\t\t\tthat no introductions are to be saved in the\n-              <directory>priv-callerintros</directory>\n-              directory.\n-            </para>\n-          </option>\n-          <option name=\"N\">\n-            <para>This option is a modifier for the call screening/privacy mode. It specifies\n-\t\t\t\t\tthat if CallerID is present, do not screen the call.</para>\n-          </option>\n-          <option name=\"o\">\n-            <argument name=\"x\" required=\"false\"/>\n-            <para>\n-              If\n-              <replaceable>x</replaceable>\n-              is not provided, specify that the CallerID that was present on the\n-              <emphasis>calling</emphasis>\n-              channel be stored as the CallerID on the\n-              <emphasis>called</emphasis>\n-              channel.\n-\t\t\t\t\tThis was the behavior of Asterisk 1.0 and earlier.\n-\t\t\t\t\tIf\n-              <replaceable>x</replaceable>\n-              is provided, specify the CallerID stored on the\n-              <emphasis>called</emphasis>\n-              channel.\n-\t\t\t\t\tNote that\n-              <literal>o(${CALLERID(all)})</literal>\n-              is similar to option\n-              <literal>o</literal>\n-              without the parameter.\n-            </para>\n+            <para>Use the specified amount of gain when recording the voicemail message.\n+\t\t\t\t\tThe units are whole-number decibels (dB).</para>\n           </option>\n-          <option name=\"O\">\n-            <argument name=\"mode\">\n-              <para>\n-                With\n-                <replaceable>mode</replaceable>\n-                either not specified or set to\n-                <literal>1</literal>\n-                ,\n-\t\t\t\t\t\tthe originator hanging up will cause the phone to ring back immediately.\n-              </para>\n-              <para>\n-                With\n-                <replaceable>mode</replaceable>\n-                set to\n-                <literal>2</literal>\n-                , when the operator\n-\t\t\t\t\t\tflashes the trunk, it will ring their phone back.\n-              </para>\n-            </argument>\n+        </optionlist>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>\n+        This application is part of the Mini-Voicemail system, configured in\n+        <filename>minivm.conf</filename>\n+      </para>\n+      <para>MiniVM records audio file in configured format and forwards message to e-mail and pager.</para>\n+      <para>If there's no user account for that address, a temporary account will be used with default options.</para>\n+      <para>\n+        The recorded file name and path will be stored in\n+        <variable>MVM_FILENAME</variable>\n+        and the duration\n+\t\tof the message will be stored in\n+        <variable>MVM_DURATION</variable>\n+      </para>\n+      <note>\n+        <para>\n+          If the caller hangs up after the recording, the only way to send the message and clean up is to\n+\t\texecute in the\n+          <literal>h</literal>\n+          extension. The application will exit if any of the following DTMF digits\n+\t\tare received and the requested extension exist in the current context.\n+        </para>\n+      </note>\n+      <variablelist>\n+        <variable name=\"MVM_RECORD_STATUS\">\n+          <para>This is the status of the record operation</para>\n+          <value name=\"SUCCESS\"/>\n+          <value name=\"USEREXIT\"/>\n+          <value name=\"FAILED\"/>\n+        </variable>\n+      </variablelist>\n+    </description>\n+  </application>\n+  <application name=\"MinivmGreet\" language=\"en_US\">\n+    <synopsis>Play Mini-Voicemail prompts.</synopsis>\n+    <syntax>\n+      <parameter name=\"mailbox\" required=\"true\" argsep=\"@\">\n+        <argument name=\"username\" required=\"true\">\n+          <para>Voicemail username</para>\n+        </argument>\n+        <argument name=\"domain\" required=\"true\">\n+          <para>Voicemail domain</para>\n+        </argument>\n+      </parameter>\n+      <parameter name=\"options\" required=\"false\">\n+        <optionlist>\n+          <option name=\"b\">\n             <para>\n-              Enables\n-              <emphasis>operator services</emphasis>\n-              mode.  This option only\n-\t\t\t\t\tworks when bridging a DAHDI channel to another DAHDI channel\n-\t\t\t\t\tonly. If specified on non-DAHDI interfaces, it will be ignored.\n-\t\t\t\t\tWhen the destination answers (presumably an operator services\n-\t\t\t\t\tstation), the originator no longer has control of their line.\n-\t\t\t\t\tThey may hang up, but the switch will not release their line\n-\t\t\t\t\tuntil the destination party (the operator) hangs up.\n+              Play the\n+              <literal>busy</literal>\n+              greeting to the calling party.\n             </para>\n           </option>\n-          <option name=\"p\">\n-            <para>This option enables screening mode. This is basically Privacy mode\n-\t\t\t\t\twithout memory.</para>\n-          </option>\n-          <option name=\"P\">\n-            <argument name=\"x\"/>\n-            <para>\n-              Enable privacy mode. Use\n-              <replaceable>x</replaceable>\n-              as the family/key in the AstDB database if\n-\t\t\t\t\tit is provided. The current extension is used if a database family/key is not specified.\n-            </para>\n+          <option name=\"s\">\n+            <para>Skip the playback of instructions for leaving a message to the calling party.</para>\n           </option>\n-          <option name=\"Q\">\n-            <argument name=\"cause\" required=\"true\"/>\n+          <option name=\"u\">\n             <para>\n-              Specify the Q.850/Q.931\n-              <replaceable>cause</replaceable>\n-              to send on\n-\t\t\t\t\tunanswered channels when another channel answers the call.\n-\t\t\t\t\tAs with\n-              <literal>Hangup()</literal>\n-              ,\n-              <replaceable>cause</replaceable>\n-              can be a numeric cause code or a name such as\n-              <literal>NO_ANSWER</literal>\n-              ,\n-              <literal>USER_BUSY</literal>\n-              ,\n-              <literal>CALL_REJECTED</literal>\n-              or\n-              <literal>ANSWERED_ELSEWHERE</literal>\n-              (the default if Q isn't specified).\n-\t\t\t\t\t\tYou can also specify\n-              <literal>0</literal>\n-              or\n-              <literal>NONE</literal>\n-              to send no cause.  See the\n-              <filename>causes.h</filename>\n-              file for the\n-\t\t\t\t\t\tfull list of valid causes and names.\n+              Play the\n+              <literal>unavailable</literal>\n+              greeting.\n             </para>\n-            <para>NOTE: chan_sip does not support setting the cause on a CANCEL to anything\n-\t\t\t\t\tother than ANSWERED_ELSEWHERE.</para>\n-          </option>\n-          <option name=\"r\">\n-            <para>Default: Indicate ringing to the calling party, even if the called party isn't actually ringing. Pass no audio to the calling\n-\t\t\t\t\tparty until the called channel has answered.</para>\n-            <argument name=\"tone\" required=\"false\">\n-              <para>\n-                Indicate progress to calling party. Send audio 'tone' from the\n-                <filename>indications.conf</filename>\n-                tonezone currently in use.\n-              </para>\n-            </argument>\n           </option>\n-          <option name=\"R\">\n-            <para>Default: Indicate ringing to the calling party, even if the called party isn't actually ringing.\n-\t\t\t\t\tAllow interruption of the ringback if early media is received on the channel.</para>\n+        </optionlist>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>This application is part of the Mini-Voicemail system, configured in minivm.conf.</para>\n+      <para>MinivmGreet() plays default prompts or user specific prompts for an account.</para>\n+      <para>Busy and unavailable messages can be choosen, but will be overridden if a temporary\n+\t\tmessage exists for the account.</para>\n+      <variablelist>\n+        <variable name=\"MVM_GREET_STATUS\">\n+          <para>This is the status of the greeting playback.</para>\n+          <value name=\"SUCCESS\"/>\n+          <value name=\"USEREXIT\"/>\n+          <value name=\"FAILED\"/>\n+        </variable>\n+      </variablelist>\n+    </description>\n+  </application>\n+  <application name=\"MinivmNotify\" language=\"en_US\">\n+    <synopsis>Notify voicemail owner about new messages.</synopsis>\n+    <syntax>\n+      <parameter name=\"mailbox\" required=\"true\" argsep=\"@\">\n+        <argument name=\"username\" required=\"true\">\n+          <para>Voicemail username</para>\n+        </argument>\n+        <argument name=\"domain\" required=\"true\">\n+          <para>Voicemail domain</para>\n+        </argument>\n+      </parameter>\n+      <parameter name=\"options\" required=\"false\">\n+        <optionlist>\n+          <option name=\"template\">\n+            <para>E-mail template to use for voicemail notification</para>\n           </option>\n-          <option name=\"S\">\n-            <argument name=\"x\" required=\"true\"/>\n+        </optionlist>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>This application is part of the Mini-Voicemail system, configured in minivm.conf.</para>\n+      <para>\n+        MiniVMnotify forwards messages about new voicemail to e-mail and pager. If there's no user\n+\t\taccount for that address, a temporary account will be used with default options (set in\n+        <filename>minivm.conf</filename>\n+        ).\n+      </para>\n+      <para>\n+        If the channel variable\n+        <variable>MVM_COUNTER</variable>\n+        is set, this will be used in the message\n+\t\tfile name and available in the template for the message.\n+      </para>\n+      <para>If no template is given, the default email template will be used to send email and default pager\n+\t\ttemplate to send paging message (if the user account is configured with a paging address.</para>\n+      <variablelist>\n+        <variable name=\"MVM_NOTIFY_STATUS\">\n+          <para>This is the status of the notification attempt</para>\n+          <value name=\"SUCCESS\"/>\n+          <value name=\"FAILED\"/>\n+        </variable>\n+      </variablelist>\n+    </description>\n+  </application>\n+  <application name=\"MinivmDelete\" language=\"en_US\">\n+    <synopsis>Delete Mini-Voicemail voicemail messages.</synopsis>\n+    <syntax>\n+      <parameter name=\"filename\" required=\"true\">\n+        <para>File to delete</para>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>\n+        This application is part of the Mini-Voicemail system, configured in\n+        <filename>minivm.conf</filename>\n+        .\n+      </para>\n+      <para>It deletes voicemail file set in MVM_FILENAME or given filename.</para>\n+      <variablelist>\n+        <variable name=\"MVM_DELETE_STATUS\">\n+          <para>This is the status of the delete operation.</para>\n+          <value name=\"SUCCESS\"/>\n+          <value name=\"FAILED\"/>\n+        </variable>\n+      </variablelist>\n+    </description>\n+  </application>\n+  <application name=\"MinivmAccMess\" language=\"en_US\">\n+    <synopsis>Record account specific messages.</synopsis>\n+    <syntax>\n+      <parameter name=\"mailbox\" required=\"true\" argsep=\"@\">\n+        <argument name=\"username\" required=\"true\">\n+          <para>Voicemail username</para>\n+        </argument>\n+        <argument name=\"domain\" required=\"true\">\n+          <para>Voicemail domain</para>\n+        </argument>\n+      </parameter>\n+      <parameter name=\"options\" required=\"false\">\n+        <optionlist>\n+          <option name=\"u\">\n             <para>\n-              Hang up the call\n-              <replaceable>x</replaceable>\n-              seconds\n-              <emphasis>after</emphasis>\n-              the called party has\n-\t\t\t\t\tanswered the call.\n+              Record the\n+              <literal>unavailable</literal>\n+              greeting.\n             </para>\n           </option>\n-          <option name=\"s\">\n-            <argument name=\"x\" required=\"true\"/>\n-            <para>\n-              Force the outgoing CallerID tag parameter to be set to the string\n-              <replaceable>x</replaceable>\n-              .\n-            </para>\n+          <option name=\"b\">\n             <para>\n-              Works with the\n-              <literal>f</literal>\n-              option.\n+              Record the\n+              <literal>busy</literal>\n+              greeting.\n             </para>\n           </option>\n           <option name=\"t\">\n-            <para>\n-              Allow the called party to transfer the calling party by sending the\n-\t\t\t\t\tDTMF sequence defined in\n-              <filename>features.conf</filename>\n-              . This setting does not perform policy enforcement on\n-\t\t\t\t\ttransfers initiated by other methods.\n-            </para>\n+            <para>Record the temporary greeting.</para>\n           </option>\n-          <option name=\"T\">\n-            <para>\n-              Allow the calling party to transfer the called party by sending the\n-\t\t\t\t\tDTMF sequence defined in\n-              <filename>features.conf</filename>\n-              . This setting does not perform policy enforcement on\n-\t\t\t\t\ttransfers initiated by other methods.\n-            </para>\n+          <option name=\"n\">\n+            <para>Account name.</para>\n           </option>\n-          <option name=\"U\" argsep=\"^\">\n-            <argument name=\"x\" required=\"true\">\n-              <para>\n-                Name of the subroutine context to execute via\n-                <literal>Gosub</literal>\n-                .\n-\t\t\t\t\t\tThe subroutine execution starts in the named context at the s exten and priority 1.\n-              </para>\n-            </argument>\n-            <argument name=\"arg\" multiple=\"true\" required=\"false\">\n-              <para>\n-                Arguments for the\n-                <literal>Gosub</literal>\n-                routine\n-              </para>\n-            </argument>\n-            <para>\n-              Execute via\n-              <literal>Gosub</literal>\n-              the routine\n-              <replaceable>x</replaceable>\n-              for the\n-              <emphasis>called</emphasis>\n-              channel before connecting\n-\t\t\t\t\tto the calling channel. Arguments can be specified to the\n-              <literal>Gosub</literal>\n-              using\n-              <literal>^</literal>\n-              as a delimiter. The\n-              <literal>Gosub</literal>\n-              routine can set the variable\n-              <variable>GOSUB_RESULT</variable>\n-              to specify the following actions after the\n-              <literal>Gosub</literal>\n-              returns.\n-            </para>\n-            <variablelist>\n-              <variable name=\"GOSUB_RESULT\">\n-                <value name=\"ABORT\">Hangup both legs of the call.</value>\n-                <value name=\"CONGESTION\">Behave as if line congestion was encountered.</value>\n-                <value name=\"BUSY\">Behave as if a busy signal was encountered.</value>\n-                <value name=\"CONTINUE\">Hangup the called party and allow the calling party\n-\t\t\t\t\t\t\t\tto continue dialplan execution at the next priority.</value>\n-                <value name=\"GOTO:[[&lt;context&gt;^]&lt;exten&gt;^]&lt;priority&gt;\">Transfer the call to the specified destination.</value>\n-              </variable>\n-            </variablelist>\n-            <para>\n-              NOTE: You cannot use any additional action post answer options in conjunction\n-\t\t\t\t\twith this option. Also, pbx services are run on the\n-              <emphasis>called</emphasis>\n-              channel,\n-\t\t\t\t\tso you will not be able to set timeouts via the\n-              <literal>TIMEOUT()</literal>\n-              function in this routine.\n-            </para>\n+        </optionlist>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>\n+        This application is part of the Mini-Voicemail system, configured in\n+        <filename>minivm.conf</filename>\n+        .\n+      </para>\n+      <para>Use this application to record account specific audio/video messages for busy, unavailable\n+\t\tand temporary messages.</para>\n+      <para>Account specific directories will be created if they do not exist.</para>\n+      <variablelist>\n+        <variable name=\"MVM_ACCMESS_STATUS\">\n+          <para>This is the result of the attempt to record the specified greeting.</para>\n+          <para>\n+            <literal>FAILED</literal>\n+            is set if the file can't be created.\n+          </para>\n+          <value name=\"SUCCESS\"/>\n+          <value name=\"FAILED\"/>\n+        </variable>\n+      </variablelist>\n+    </description>\n+  </application>\n+  <application name=\"MinivmMWI\" language=\"en_US\">\n+    <synopsis>Send Message Waiting Notification to subscriber(s) of mailbox.</synopsis>\n+    <syntax>\n+      <parameter name=\"mailbox\" required=\"true\" argsep=\"@\">\n+        <argument name=\"username\" required=\"true\">\n+          <para>Voicemail username</para>\n+        </argument>\n+        <argument name=\"domain\" required=\"true\">\n+          <para>Voicemail domain</para>\n+        </argument>\n+      </parameter>\n+      <parameter name=\"urgent\" required=\"true\">\n+        <para>Number of urgent messages in mailbox.</para>\n+      </parameter>\n+      <parameter name=\"new\" required=\"true\">\n+        <para>Number of new messages in mailbox.</para>\n+      </parameter>\n+      <parameter name=\"old\" required=\"true\">\n+        <para>Number of old messages in mailbox.</para>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>\n+        This application is part of the Mini-Voicemail system, configured in\n+        <filename>minivm.conf</filename>\n+        .\n+      </para>\n+      <para>MinivmMWI is used to send message waiting indication to any devices whose channels have\n+\t\tsubscribed to the mailbox passed in the first parameter.</para>\n+    </description>\n+  </application>\n+  <function name=\"MINIVMCOUNTER\" language=\"en_US\">\n+    <synopsis>Reads or sets counters for MiniVoicemail message.</synopsis>\n+    <syntax argsep=\":\">\n+      <parameter name=\"account\" required=\"true\">\n+        <para>If account is given and it exists, the counter is specific for the account.</para>\n+        <para>If account is a domain and the domain directory exists, counters are specific for a domain.</para>\n+      </parameter>\n+      <parameter name=\"name\" required=\"true\">\n+        <para>The name of the counter is a string, up to 10 characters.</para>\n+      </parameter>\n+      <parameter name=\"operand\">\n+        <para>The counters never goes below zero. Valid operands for changing the value of a counter when assigning a value are:</para>\n+        <enumlist>\n+          <enum name=\"i\">\n+            <para>Increment by value.</para>\n+          </enum>\n+          <enum name=\"d\">\n+            <para>Decrement by value.</para>\n+          </enum>\n+          <enum name=\"s\">\n+            <para>Set to value.</para>\n+          </enum>\n+        </enumlist>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>The operation is atomic and the counter is locked while changing the value. The counters are stored as text files in the minivm account directories. It might be better to use realtime functions if you are using a database to operate your Asterisk.</para>\n+    </description>\n+    <see-also>\n+      <ref type=\"application\">MinivmRecord</ref>\n+      <ref type=\"application\">MinivmGreet</ref>\n+      <ref type=\"application\">MinivmNotify</ref>\n+      <ref type=\"application\">MinivmDelete</ref>\n+      <ref type=\"application\">MinivmAccMess</ref>\n+      <ref type=\"application\">MinivmMWI</ref>\n+      <ref type=\"function\">MINIVMACCOUNT</ref>\n+    </see-also>\n+  </function>\n+  <function name=\"MINIVMACCOUNT\" language=\"en_US\">\n+    <synopsis>Gets MiniVoicemail account information.</synopsis>\n+    <syntax argsep=\":\">\n+      <parameter name=\"account\" required=\"true\"/>\n+      <parameter name=\"item\" required=\"true\">\n+        <para>Valid items are:</para>\n+        <enumlist>\n+          <enum name=\"path\">\n+            <para>Path to account mailbox (if account exists, otherwise temporary mailbox).</para>\n+          </enum>\n+          <enum name=\"hasaccount\">\n+            <para>1 is static Minivm account exists, 0 otherwise.</para>\n+          </enum>\n+          <enum name=\"fullname\">\n+            <para>Full name of account owner.</para>\n+          </enum>\n+          <enum name=\"email\">\n+            <para>Email address used for account.</para>\n+          </enum>\n+          <enum name=\"etemplate\">\n+            <para>Email template for account (default template if none is configured).</para>\n+          </enum>\n+          <enum name=\"ptemplate\">\n+            <para>Pager template for account (default template if none is configured).</para>\n+          </enum>\n+          <enum name=\"accountcode\">\n+            <para>Account code for the voicemail account.</para>\n+          </enum>\n+          <enum name=\"pincode\">\n+            <para>Pin code for voicemail account.</para>\n+          </enum>\n+          <enum name=\"timezone\">\n+            <para>Time zone for voicemail account.</para>\n+          </enum>\n+          <enum name=\"language\">\n+            <para>Language for voicemail account.</para>\n+          </enum>\n+          <enum name=\"&lt;channel variable name&gt;\">\n+            <para>Channel variable value (set in configuration for account).</para>\n+          </enum>\n+        </enumlist>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para/>\n+    </description>\n+    <see-also>\n+      <ref type=\"application\">MinivmRecord</ref>\n+      <ref type=\"application\">MinivmGreet</ref>\n+      <ref type=\"application\">MinivmNotify</ref>\n+      <ref type=\"application\">MinivmDelete</ref>\n+      <ref type=\"application\">MinivmAccMess</ref>\n+      <ref type=\"application\">MinivmMWI</ref>\n+      <ref type=\"function\">MINIVMCOUNTER</ref>\n+    </see-also>\n+  </function>\n+  <managerEvent language=\"en_US\" name=\"MiniVoiceMail\">\n+    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n+      <synopsis>Raised when a notification is sent out by a MiniVoiceMail application</synopsis>\n+      <syntax>\n+        <channel_snapshot/>\n+        <parameter name=\"Action\">\n+          <para>\n+            What action was taken. Currently, this will always be\n+            <literal>SentNotification</literal>\n+          </para>\n+        </parameter>\n+        <parameter name=\"Mailbox\">\n+          <para>\n+            The mailbox that the notification was about, specified as\n+            <literal>mailbox</literal>\n+            @\n+            <literal>context</literal>\n+          </para>\n+        </parameter>\n+        <parameter name=\"Counter\">\n+          <para>\n+            A message counter derived from the\n+            <literal>MVM_COUNTER</literal>\n+            channel variable.\n+          </para>\n+        </parameter>\n+      </syntax>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <module language=\"en_US\" name=\"app_authenticate\">\n+    <support_level>core</support_level>\n+  </module>\n+  <application name=\"Authenticate\" language=\"en_US\">\n+    <synopsis>Authenticate a user</synopsis>\n+    <syntax>\n+      <parameter name=\"password\" required=\"true\">\n+        <para>Password the user should know</para>\n+      </parameter>\n+      <parameter name=\"options\" required=\"false\">\n+        <optionlist>\n+          <option name=\"a\">\n+            <para>Set the channels' account code to the password that is entered</para>\n           </option>\n-          <option name=\"u\">\n-            <argument name=\"x\" required=\"true\">\n+          <option name=\"d\">\n+            <para>Interpret the given path as database key, not a literal file.</para>\n+            <note>\n               <para>\n-                Force the outgoing callerid presentation indicator parameter to be set\n-\t\t\t\t\t\tto one of the values passed in\n-                <replaceable>x</replaceable>\n-                :\n-                <literal>allowed_not_screened</literal>\n-                <literal>allowed_passed_screen</literal>\n-                <literal>allowed_failed_screen</literal>\n-                <literal>allowed</literal>\n-                <literal>prohib_not_screened</literal>\n-                <literal>prohib_passed_screen</literal>\n-                <literal>prohib_failed_screen</literal>\n-                <literal>prohib</literal>\n-                <literal>unavailable</literal>\n+                The value is not used at all in the authentication when using this option.\n+\t\t\t\t\t\t\tIf the family/key is set to\n+                <literal>/pin/100</literal>\n+                (value does not matter)\n+\t\t\t\t\t\t\tthen the password field needs to be set to\n+                <literal>/pin</literal>\n+                and the pin entered\n+\t\t\t\t\t\t\tby the user would be authenticated against\n+                <literal>100</literal>\n+                .\n               </para>\n-            </argument>\n-            <para>\n-              Works with the\n-              <literal>f</literal>\n-              option.\n-            </para>\n-          </option>\n-          <option name=\"w\">\n-            <para>\n-              Allow the called party to enable recording of the call by sending\n-\t\t\t\t\tthe DTMF sequence defined for one-touch recording in\n-              <filename>features.conf</filename>\n-              .\n-            </para>\n-          </option>\n-          <option name=\"W\">\n-            <para>\n-              Allow the calling party to enable recording of the call by sending\n-\t\t\t\t\tthe DTMF sequence defined for one-touch recording in\n-              <filename>features.conf</filename>\n-              .\n-            </para>\n+            </note>\n           </option>\n-          <option name=\"x\">\n+          <option name=\"m\">\n             <para>\n-              Allow the called party to enable recording of the call by sending\n-\t\t\t\t\tthe DTMF sequence defined for one-touch automixmonitor in\n-              <filename>features.conf</filename>\n-              .\n+              Interpret the given path as a file which contains a list of account\n+\t\t\t\t\t\tcodes and password hashes delimited with\n+              <literal>:</literal>\n+              , listed one per line in\n+\t\t\t\t\t\tthe file. When one of the passwords is matched, the channel will have\n+\t\t\t\t\t\tits account code set to the corresponding account code in the file.\n             </para>\n           </option>\n-          <option name=\"X\">\n+          <option name=\"r\">\n             <para>\n-              Allow the calling party to enable recording of the call by sending\n-\t\t\t\t\tthe DTMF sequence defined for one-touch automixmonitor in\n-              <filename>features.conf</filename>\n-              .\n+              Remove the database key upon successful entry (valid with\n+              <literal>d</literal>\n+              only)\n             </para>\n           </option>\n-          <option name=\"z\">\n-            <para>On a call forward, cancel any dial timeout which has been set for this call.</para>\n-          </option>\n         </optionlist>\n       </parameter>\n-      <parameter name=\"URL\">\n-        <para>The optional URL will be sent to the called party if the channel driver supports it.</para>\n+      <parameter name=\"maxdigits\" required=\"false\">\n+        <para>\n+          maximum acceptable number of digits. Stops reading after\n+\t\t\t\tmaxdigits have been entered (without requiring the user to press the\n+          <literal>#</literal>\n+          key).\n+\t\t\t\tDefaults to 0 - no limit - wait for the user press the\n+          <literal>#</literal>\n+          key.\n+        </para>\n+      </parameter>\n+      <parameter name=\"prompt\" required=\"false\">\n+        <para>Override the agent-pass prompt file.</para>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>This application will place calls to one or more specified channels. As soon\n-\t\t\tas one of the requested channels answers, the originating channel will be\n-\t\t\tanswered, if it has not already been answered. These two channels will then\n-\t\t\tbe active in a bridged call. All other channels that were requested will then\n-\t\t\tbe hung up.</para>\n-      <para>Unless there is a timeout specified, the Dial application will wait\n-\t\t\tindefinitely until one of the called channels answers, the user hangs up, or\n-\t\t\tif all of the called channels are busy or unavailable. Dialplan execution will\n-\t\t\tcontinue if no requested channels can be called, or if the timeout expires.\n-\t\t\tThis application will report normal termination if the originating channel\n-\t\t\thangs up, or if the call is bridged and either of the parties in the bridge\n-\t\t\tends the call.</para>\n+      <para>This application asks the caller to enter a given password in order to continue dialplan execution.</para>\n       <para>\n-        If the\n-        <variable>OUTBOUND_GROUP</variable>\n-        variable is set, all peer channels created by this\n-\t\t\tapplication will be put into that group (as in\n-        <literal>Set(GROUP()=...</literal>\n-        ).\n-\t\t\tIf the\n-        <variable>OUTBOUND_GROUP_ONCE</variable>\n-        variable is set, all peer channels created by this\n-\t\t\tapplication will be put into that group (as in\n-        <literal>Set(GROUP()=...</literal>\n-        ). Unlike\n-        <variable>OUTBOUND_GROUP</variable>\n-        ,\n-\t\t\thowever, the variable will be unset after use.\n+        If the password begins with the\n+        <literal>/</literal>\n+        character,\n+\t\t\tit is interpreted as a file which contains a list of valid passwords, listed 1 password per line in the file.\n       </para>\n-      <example title=\"Dial with 30 second timeout\">same =&gt; n,Dial(PJSIP/alice,30)</example>\n-      <example title=\"Parallel dial with 45 second timeout\">same =&gt; n,Dial(PJSIP/alice&amp;PJIP/bob,45)</example>\n-      <example title=\"Dial with 'g' continuation option\">same =&gt; n,Dial(PJSIP/alice,,g)\n-\t\t\t same =&gt; n,Log(NOTICE, Alice call result: ${DIALSTATUS})</example>\n-      <example title=\"Dial with transfer/recording features for calling party\">same =&gt; n,Dial(PJSIP/alice,,TX)</example>\n-      <example title=\"Dial with call length limit\">same =&gt; n,Dial(PJSIP/alice,,L(60000:30000:10000))</example>\n-      <example title=\"Dial alice and bob and send NO_ANSWER to bob instead of ANSWERED_ELSEWHERE when alice answers\">same =&gt; n,Dial(PJSIP/alice&amp;PJSIP/bob,,Q(NO_ANSWER))</example>\n-      <example title=\"Dial with pre-dial subroutines\">[default]\n-\t\t\texten =&gt; callee_channel,1,NoOp(ARG1=${ARG1} ARG2=${ARG2})\n-\t\t\t same =&gt; n,Log(NOTICE, I'm called on channel ${CHANNEL} prior to it starting the dial attempt)\n-\t\t\t same =&gt; n,Return()\n-\t\t\texten =&gt; called_channel,1,NoOp(ARG1=${ARG1} ARG2=${ARG2})\n-\t\t\t same =&gt; n,Log(NOTICE, I'm called on outbound channel ${CHANNEL} prior to it being used to dial someone)\n-\t\t\t same =&gt; n,Return()\n-\t\t\texten =&gt; _X.,1,NoOp()\n-\t\t\t same =&gt; n,Dial(PJSIP/alice,,b(default^called_channel^1(my_gosub_arg1^my_gosub_arg2))B(default^callee_channel^1(my_gosub_arg1^my_gosub_arg2)))\n-\t\t\t same =&gt; n,Hangup()</example>\n-      <example title=\"Dial with post-answer subroutine executed on outbound channel\">[my_gosub_routine]\n-\t\t\texten =&gt; s,1,NoOp(ARG1=${ARG1} ARG2=${ARG2})\n-\t\t\t same =&gt; n,Playback(hello)\n-\t\t\t same =&gt; n,Return()\n-\t\t\t[default]\n-\t\t\texten =&gt; _X.,1,NoOp()\n-\t\t\t same =&gt; n,Dial(PJSIP/alice,,U(my_gosub_routine^my_gosub_arg1^my_gosub_arg2))\n-\t\t\t same =&gt; n,Hangup()</example>\n-      <example title=\"Dial into ConfBridge using 'G' option\">same =&gt; n,Dial(PJSIP/alice,,G(jump_to_here))\n-\t\t\t same =&gt; n(jump_to_here),Goto(confbridge)\n-\t\t\t same =&gt; n,Goto(confbridge)\n-\t\t\t same =&gt; n(confbridge),ConfBridge(${EXTEN})</example>\n-      <para>This application sets the following channel variables:</para>\n+      <para>When using a database key, the value associated with the key can be anything.</para>\n+      <para>Users have three attempts to authenticate before the channel is hung up.</para>\n+    </description>\n+    <see-also>\n+      <ref type=\"application\">VMAuthenticate</ref>\n+      <ref type=\"application\">DISA</ref>\n+    </see-also>\n+  </application>\n+  <module language=\"en_US\" name=\"app_osplookup\">\n+    <depend>osptk</depend>\n+    <depend>openssl</depend>\n+    <support_level>extended</support_level>\n+    <deprecated_in>19</deprecated_in>\n+    <removed_in>21</removed_in>\n+  </module>\n+  <application name=\"OSPAuth\" language=\"en_US\">\n+    <synopsis>OSP Authentication.</synopsis>\n+    <syntax>\n+      <parameter name=\"provider\">\n+        <para>The name of the provider that authenticates the call.</para>\n+      </parameter>\n+      <parameter name=\"options\">\n+        <para>Reserverd.</para>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>Authenticate a call by OSP.</para>\n+      <para>Input variables:</para>\n       <variablelist>\n-        <variable name=\"DIALEDTIME\">\n-          <para>This is the time from dialing a channel until when it is disconnected.</para>\n+        <variable name=\"OSPINPEERIP\">\n+          <para>The last hop IP address.</para>\n         </variable>\n-        <variable name=\"DIALEDTIME_MS\">\n-          <para>This is the milliseconds version of the DIALEDTIME variable.</para>\n+        <variable name=\"OSPINTOKEN\">\n+          <para>The inbound OSP token.</para>\n         </variable>\n-        <variable name=\"ANSWEREDTIME\">\n-          <para>This is the amount of time for actual call.</para>\n+      </variablelist>\n+      <para>Output variables:</para>\n+      <variablelist>\n+        <variable name=\"OSPINHANDLE\">\n+          <para>The inbound call OSP transaction handle.</para>\n         </variable>\n-        <variable name=\"ANSWEREDTIME_MS\">\n-          <para>This is the milliseconds version of the ANSWEREDTIME variable.</para>\n+        <variable name=\"OSPINTIMELIMIT\">\n+          <para>The inbound call duration limit in seconds.</para>\n         </variable>\n-        <variable name=\"RINGTIME\">\n-          <para>This is the time from creating the channel to the first RINGING event received. Empty if there was no ring.</para>\n+      </variablelist>\n+      <para>This application sets the following channel variable upon completion:</para>\n+      <variablelist>\n+        <variable name=\"OSPAUTHSTATUS\">\n+          <para>The status of OSPAuth attempt as a text string, one of</para>\n+          <value name=\"SUCCESS\"/>\n+          <value name=\"FAILED\"/>\n+          <value name=\"ERROR\"/>\n         </variable>\n-        <variable name=\"RINGTIME_MS\">\n-          <para>This is the milliseconds version of the RINGTIME variable.</para>\n+      </variablelist>\n+    </description>\n+    <see-also>\n+      <ref type=\"application\">OSPLookup</ref>\n+      <ref type=\"application\">OSPNext</ref>\n+      <ref type=\"application\">OSPFinish</ref>\n+    </see-also>\n+  </application>\n+  <application name=\"OSPLookup\" language=\"en_US\">\n+    <synopsis>Lookup destination by OSP.</synopsis>\n+    <syntax>\n+      <parameter name=\"exten\" required=\"true\">\n+        <para>The exten of the call.</para>\n+      </parameter>\n+      <parameter name=\"provider\">\n+        <para>The name of the provider that is used to route the call.</para>\n+      </parameter>\n+      <parameter name=\"options\">\n+        <enumlist>\n+          <enum name=\"h\">\n+            <para>generate H323 call id for the outbound call</para>\n+          </enum>\n+          <enum name=\"s\">\n+            <para>generate SIP call id for the outbound call. Have not been implemented</para>\n+          </enum>\n+          <enum name=\"i\">\n+            <para>generate IAX call id for the outbound call. Have not been implemented</para>\n+          </enum>\n+        </enumlist>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>Looks up destination via OSP.</para>\n+      <para>Input variables:</para>\n+      <variablelist>\n+        <variable name=\"OSPINACTUALSRC\">\n+          <para>The actual source device IP address in indirect mode.</para>\n         </variable>\n-        <variable name=\"PROGRESSTIME\">\n-          <para>This is the time from creating the channel to the first PROGRESS event received. Empty if there was no such event.</para>\n+        <variable name=\"OSPINPEERIP\">\n+          <para>The last hop IP address.</para>\n         </variable>\n-        <variable name=\"PROGRESSTIME_MS\">\n-          <para>This is the milliseconds version of the PROGRESSTIME variable.</para>\n+        <variable name=\"OSPINTECH\">\n+          <para>The inbound channel technology for the call.</para>\n         </variable>\n-        <variable name=\"DIALEDPEERNAME\">\n-          <para>The name of the outbound channel that answered the call.</para>\n+        <variable name=\"OSPINHANDLE\">\n+          <para>The inbound call OSP transaction handle.</para>\n         </variable>\n-        <variable name=\"DIALEDPEERNUMBER\">\n-          <para>The number that was dialed for the answered outbound channel.</para>\n+        <variable name=\"OSPINTIMELIMIT\">\n+          <para>The inbound call duration limit in seconds.</para>\n         </variable>\n-        <variable name=\"FORWARDERNAME\">\n-          <para>If a call forward occurred, the name of the forwarded channel.</para>\n+        <variable name=\"OSPINNETWORKID\">\n+          <para>The inbound source network ID.</para>\n         </variable>\n-        <variable name=\"DIALSTATUS\">\n-          <para>This is the status of the call</para>\n-          <value name=\"CHANUNAVAIL\">Either the dialed peer exists but is not currently reachable, e.g.\n-\t\t\t\t\t\tendpoint is not registered, or an attempt was made to call a\n-\t\t\t\t\t\tnonexistent location, e.g. nonexistent DNS hostname.</value>\n-          <value name=\"CONGESTION\">Channel or switching congestion occured when routing the call.\n-\t\t\t\t\t\tThis can occur if there is a slow or no response from the remote end.</value>\n-          <value name=\"NOANSWER\">Called party did not answer.</value>\n-          <value name=\"BUSY\">The called party was busy or indicated a busy status.\n-\t\t\t\t\t\tNote that some SIP devices will respond with 486 Busy if their Do Not Disturb\n-\t\t\t\t\t\tmodes are active. In this case, you can use DEVICE_STATUS to check if the\n-\t\t\t\t\t\tendpoint is actually in use, if needed.</value>\n-          <value name=\"ANSWER\">The call was answered.\n-\t\t\t\t\t\tAny other result implicitly indicates the call was not answered.</value>\n-          <value name=\"CANCEL\">Dial was cancelled before call was answered or reached some other terminating event.</value>\n-          <value name=\"DONTCALL\">For the Privacy and Screening Modes.\n-\t\t\t\t\t\tWill be set if the called party chooses to send the calling party to the 'Go Away' script.</value>\n-          <value name=\"TORTURE\">For the Privacy and Screening Modes.\n-\t\t\t\t\t\tWill be set if the called party chooses to send the calling party to the 'torture' script.</value>\n-          <value name=\"INVALIDARGS\">Dial failed due to invalid syntax.</value>\n+        <variable name=\"OSPINNPRN\">\n+          <para>The inbound routing number.</para>\n+        </variable>\n+        <variable name=\"OSPINNPCIC\">\n+          <para>The inbound carrier identification code.</para>\n+        </variable>\n+        <variable name=\"OSPINNPDI\">\n+          <para>The inbound number portability database dip indicator.</para>\n+        </variable>\n+        <variable name=\"OSPINSPID\">\n+          <para>The inbound service provider identity.</para>\n+        </variable>\n+        <variable name=\"OSPINOCN\">\n+          <para>The inbound operator company number.</para>\n+        </variable>\n+        <variable name=\"OSPINSPN\">\n+          <para>The inbound service provider name.</para>\n+        </variable>\n+        <variable name=\"OSPINALTSPN\">\n+          <para>The inbound alternate service provider name.</para>\n+        </variable>\n+        <variable name=\"OSPINMCC\">\n+          <para>The inbound mobile country code.</para>\n+        </variable>\n+        <variable name=\"OSPINMNC\">\n+          <para>The inbound mobile network code.</para>\n+        </variable>\n+        <variable name=\"OSPINTOHOST\">\n+          <para>The inbound To header host part.</para>\n+        </variable>\n+        <variable name=\"OSPINRPIDUSER\">\n+          <para>The inbound Remote-Party-ID header user part.</para>\n+        </variable>\n+        <variable name=\"OSPINPAIUSER\">\n+          <para>The inbound P-Asserted-Identify header user part.</para>\n+        </variable>\n+        <variable name=\"OSPINDIVUSER\">\n+          <para>The inbound Diversion header user part.</para>\n+        </variable>\n+        <variable name=\"OSPINDIVHOST\">\n+          <para>The inbound Diversion header host part.</para>\n+        </variable>\n+        <variable name=\"OSPINPCIUSER\">\n+          <para>The inbound P-Charge-Info header user part.</para>\n+        </variable>\n+        <variable name=\"OSPINCUSTOMINFOn\">\n+          <para>\n+            The inbound custom information, where\n+            <literal>n</literal>\n+            is the index beginning with\n+            <literal>1</literal>\n+            upto\n+            <literal>8</literal>\n+            .\n+          </para>\n+        </variable>\n+      </variablelist>\n+      <para>Output variables:</para>\n+      <variablelist>\n+        <variable name=\"OSPOUTHANDLE\">\n+          <para>The outbound call OSP transaction handle.</para>\n+        </variable>\n+        <variable name=\"OSPOUTTECH\">\n+          <para>The outbound channel technology for the call.</para>\n+        </variable>\n+        <variable name=\"OSPDESTINATION\">\n+          <para>The outbound destination IP address.</para>\n+        </variable>\n+        <variable name=\"OSPOUTCALLING\">\n+          <para>The outbound calling number.</para>\n+        </variable>\n+        <variable name=\"OSPOUTCALLED\">\n+          <para>The outbound called number.</para>\n+        </variable>\n+        <variable name=\"OSPOUTNETWORKID\">\n+          <para>The outbound destination network ID.</para>\n+        </variable>\n+        <variable name=\"OSPOUTNPRN\">\n+          <para>The outbound routing number.</para>\n+        </variable>\n+        <variable name=\"OSPOUTNPCIC\">\n+          <para>The outbound carrier identification code.</para>\n+        </variable>\n+        <variable name=\"OSPOUTNPDI\">\n+          <para>The outbound number portability database dip indicator.</para>\n+        </variable>\n+        <variable name=\"OSPOUTSPID\">\n+          <para>The outbound service provider identity.</para>\n+        </variable>\n+        <variable name=\"OSPOUTOCN\">\n+          <para>The outbound operator company number.</para>\n+        </variable>\n+        <variable name=\"OSPOUTSPN\">\n+          <para>The outbound service provider name.</para>\n+        </variable>\n+        <variable name=\"OSPOUTALTSPN\">\n+          <para>The outbound alternate service provider name.</para>\n+        </variable>\n+        <variable name=\"OSPOUTMCC\">\n+          <para>The outbound mobile country code.</para>\n+        </variable>\n+        <variable name=\"OSPOUTMNC\">\n+          <para>The outbound mobile network code.</para>\n+        </variable>\n+        <variable name=\"OSPOUTTOKEN\">\n+          <para>The outbound OSP token.</para>\n+        </variable>\n+        <variable name=\"OSPDESTREMAILS\">\n+          <para>The number of remained destinations.</para>\n+        </variable>\n+        <variable name=\"OSPOUTTIMELIMIT\">\n+          <para>The outbound call duration limit in seconds.</para>\n+        </variable>\n+        <variable name=\"OSPOUTCALLIDTYPES\">\n+          <para>The outbound Call-ID types.</para>\n+        </variable>\n+        <variable name=\"OSPOUTCALLID\">\n+          <para>The outbound Call-ID. Only for H.323.</para>\n+        </variable>\n+        <variable name=\"OSPDIALSTR\">\n+          <para>The outbound Dial command string.</para>\n+        </variable>\n+      </variablelist>\n+      <para>This application sets the following channel variable upon completion:</para>\n+      <variablelist>\n+        <variable name=\"OSPLOOKUPSTATUS\">\n+          <para>The status of OSPLookup attempt as a text string, one of</para>\n+          <value name=\"SUCCESS\"/>\n+          <value name=\"FAILED\"/>\n+          <value name=\"ERROR\"/>\n         </variable>\n       </variablelist>\n     </description>\n     <see-also>\n-      <ref type=\"application\">RetryDial</ref>\n-      <ref type=\"application\">SendDTMF</ref>\n-      <ref type=\"application\">Gosub</ref>\n-      <ref type=\"application\">Macro</ref>\n+      <ref type=\"application\">OSPAuth</ref>\n+      <ref type=\"application\">OSPNext</ref>\n+      <ref type=\"application\">OSPFinish</ref>\n     </see-also>\n   </application>\n-  <application name=\"RetryDial\" language=\"en_US\">\n-    <synopsis>Place a call, retrying on failure allowing an optional exit extension.</synopsis>\n+  <application name=\"OSPNext\" language=\"en_US\">\n+    <synopsis>Lookup next destination by OSP.</synopsis>\n+    <description>\n+      <para>Looks up the next destination via OSP.</para>\n+      <para>Input variables:</para>\n+      <variablelist>\n+        <variable name=\"OSPINHANDLE\">\n+          <para>The inbound call OSP transaction handle.</para>\n+        </variable>\n+        <variable name=\"OSPOUTHANDLE\">\n+          <para>The outbound call OSP transaction handle.</para>\n+        </variable>\n+        <variable name=\"OSPINTIMELIMIT\">\n+          <para>The inbound call duration limit in seconds.</para>\n+        </variable>\n+        <variable name=\"OSPOUTCALLIDTYPES\">\n+          <para>The outbound Call-ID types.</para>\n+        </variable>\n+        <variable name=\"OSPDESTREMAILS\">\n+          <para>The number of remained destinations.</para>\n+        </variable>\n+      </variablelist>\n+      <para>Output variables:</para>\n+      <variablelist>\n+        <variable name=\"OSPOUTTECH\">\n+          <para>The outbound channel technology.</para>\n+        </variable>\n+        <variable name=\"OSPDESTINATION\">\n+          <para>The destination IP address.</para>\n+        </variable>\n+        <variable name=\"OSPOUTCALLING\">\n+          <para>The outbound calling number.</para>\n+        </variable>\n+        <variable name=\"OSPOUTCALLED\">\n+          <para>The outbound called number.</para>\n+        </variable>\n+        <variable name=\"OSPOUTNETWORKID\">\n+          <para>The outbound destination network ID.</para>\n+        </variable>\n+        <variable name=\"OSPOUTNPRN\">\n+          <para>The outbound routing number.</para>\n+        </variable>\n+        <variable name=\"OSPOUTNPCIC\">\n+          <para>The outbound carrier identification code.</para>\n+        </variable>\n+        <variable name=\"OSPOUTNPDI\">\n+          <para>The outbound number portability database dip indicator.</para>\n+        </variable>\n+        <variable name=\"OSPOUTSPID\">\n+          <para>The outbound service provider identity.</para>\n+        </variable>\n+        <variable name=\"OSPOUTOCN\">\n+          <para>The outbound operator company number.</para>\n+        </variable>\n+        <variable name=\"OSPOUTSPN\">\n+          <para>The outbound service provider name.</para>\n+        </variable>\n+        <variable name=\"OSPOUTALTSPN\">\n+          <para>The outbound alternate service provider name.</para>\n+        </variable>\n+        <variable name=\"OSPOUTMCC\">\n+          <para>The outbound mobile country code.</para>\n+        </variable>\n+        <variable name=\"OSPOUTMNC\">\n+          <para>The outbound mobile network code.</para>\n+        </variable>\n+        <variable name=\"OSPOUTTOKEN\">\n+          <para>The outbound OSP token.</para>\n+        </variable>\n+        <variable name=\"OSPDESTREMAILS\">\n+          <para>The number of remained destinations.</para>\n+        </variable>\n+        <variable name=\"OSPOUTTIMELIMIT\">\n+          <para>The outbound call duration limit in seconds.</para>\n+        </variable>\n+        <variable name=\"OSPOUTCALLID\">\n+          <para>The outbound Call-ID. Only for H.323.</para>\n+        </variable>\n+        <variable name=\"OSPDIALSTR\">\n+          <para>The outbound Dial command string.</para>\n+        </variable>\n+      </variablelist>\n+      <para>This application sets the following channel variable upon completion:</para>\n+      <variablelist>\n+        <variable name=\"OSPNEXTSTATUS\">\n+          <para>The status of the OSPNext attempt as a text string, one of</para>\n+          <value name=\"SUCCESS\"/>\n+          <value name=\"FAILED\"/>\n+          <value name=\"ERROR\"/>\n+        </variable>\n+      </variablelist>\n+    </description>\n+    <see-also>\n+      <ref type=\"application\">OSPAuth</ref>\n+      <ref type=\"application\">OSPLookup</ref>\n+      <ref type=\"application\">OSPFinish</ref>\n+    </see-also>\n+  </application>\n+  <application name=\"OSPFinish\" language=\"en_US\">\n+    <synopsis>Report OSP entry.</synopsis>\n     <syntax>\n-      <parameter name=\"announce\" required=\"true\">\n-        <para>Filename of sound that will be played when no channel can be reached</para>\n-      </parameter>\n-      <parameter name=\"sleep\" required=\"true\">\n-        <para>Number of seconds to wait after a dial attempt failed before a new attempt is made</para>\n-      </parameter>\n-      <parameter name=\"retries\" required=\"true\">\n-        <para>Number of retries</para>\n-        <para>When this is reached flow will continue at the next priority in the dialplan</para>\n+      <parameter name=\"cause\">\n+        <para>Hangup cause.</para>\n       </parameter>\n-      <parameter name=\"dialargs\" required=\"true\">\n-        <para>Same format as arguments provided to the Dial application</para>\n+      <parameter name=\"options\">\n+        <para>Reserved.</para>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>\n-        This application will attempt to place a call using the normal Dial application.\n-\t\t\tIf no channel can be reached, the\n-        <replaceable>announce</replaceable>\n-        file will be played.\n-\t\t\tThen, it will wait\n-        <replaceable>sleep</replaceable>\n-        number of seconds before retrying the call.\n-\t\t\tAfter\n-        <replaceable>retries</replaceable>\n-        number of attempts, the calling channel will continue at the next priority in the dialplan.\n-\t\t\tIf the\n-        <replaceable>retries</replaceable>\n-        setting is set to 0, this application will retry endlessly.\n-\t\t\tWhile waiting to retry a call, a 1 digit extension may be dialed. If that\n-\t\t\textension exists in either the context defined in\n-        <variable>EXITCONTEXT</variable>\n-        or the current\n-\t\t\tone, The call will jump to that extension immediately.\n-\t\t\tThe\n-        <replaceable>dialargs</replaceable>\n-        are specified in the same format that arguments are provided\n-\t\t\tto the Dial application.\n-      </para>\n+      <para>Report call state.</para>\n+      <para>Input variables:</para>\n+      <variablelist>\n+        <variable name=\"OSPINHANDLE\">\n+          <para>The inbound call OSP transaction handle.</para>\n+        </variable>\n+        <variable name=\"OSPOUTHANDLE\">\n+          <para>The outbound call OSP transaction handle.</para>\n+        </variable>\n+        <variable name=\"OSPAUTHSTATUS\">\n+          <para>The OSPAuth status.</para>\n+        </variable>\n+        <variable name=\"OSPLOOKUPSTATUS\">\n+          <para>The OSPLookup status.</para>\n+        </variable>\n+        <variable name=\"OSPNEXTSTATUS\">\n+          <para>The OSPNext status.</para>\n+        </variable>\n+        <variable name=\"OSPINAUDIOQOS\">\n+          <para>The inbound call leg audio QoS string.</para>\n+        </variable>\n+        <variable name=\"OSPOUTAUDIOQOS\">\n+          <para>The outbound call leg audio QoS string.</para>\n+        </variable>\n+      </variablelist>\n+      <para>This application sets the following channel variable upon completion:</para>\n+      <variablelist>\n+        <variable name=\"OSPFINISHSTATUS\">\n+          <para>The status of the OSPFinish attempt as a text string, one of</para>\n+          <value name=\"SUCCESS\"/>\n+          <value name=\"FAILED\"/>\n+          <value name=\"ERROR\"/>\n+        </variable>\n+      </variablelist>\n     </description>\n     <see-also>\n-      <ref type=\"application\">Dial</ref>\n+      <ref type=\"application\">OSPAuth</ref>\n+      <ref type=\"application\">OSPLookup</ref>\n+      <ref type=\"application\">OSPNext</ref>\n     </see-also>\n   </application>\n-  <module language=\"en_US\" name=\"app_talkdetect\">\n-    <support_level>core</support_level>\n+  <module language=\"en_US\" name=\"app_adsiprog\">\n+    <depend>res_adsi</depend>\n+    <support_level>deprecated</support_level>\n   </module>\n-  <application name=\"BackgroundDetect\" language=\"en_US\">\n-    <synopsis>Background a file with talk detect.</synopsis>\n+  <application name=\"ADSIProg\" language=\"en_US\">\n+    <synopsis>Load Asterisk ADSI Scripts into phone</synopsis>\n     <syntax>\n-      <parameter name=\"filename\" required=\"true\"/>\n-      <parameter name=\"sil\">\n-        <para>\n-          If not specified, defaults to\n-          <literal>1000</literal>\n-          .\n-        </para>\n-      </parameter>\n-      <parameter name=\"min\">\n-        <para>\n-          If not specified, defaults to\n-          <literal>100</literal>\n-          .\n-        </para>\n-      </parameter>\n-      <parameter name=\"max\">\n-        <para>\n-          If not specified, defaults to\n-          <literal>infinity</literal>\n-          .\n-        </para>\n-      </parameter>\n-      <parameter name=\"analysistime\">\n+      <parameter name=\"script\" required=\"false\">\n         <para>\n-          If not specified, defaults to\n-          <literal>infinity</literal>\n-          .\n+          adsi script to use. If not given uses the default script\n+          <filename>asterisk.adsi</filename>\n         </para>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>\n-        Plays back\n-        <replaceable>filename</replaceable>\n-        , waiting for interruption from a given digit (the digit\n-\t\t\tmust start the beginning of a valid extension, or it will be ignored). During\n-\t\t\tthe playback of the file, audio is monitored in the receive direction, and if\n-\t\t\ta period of non-silence which is greater than\n-        <replaceable>min</replaceable>\n-        ms yet less than\n-        <replaceable>max</replaceable>\n-        ms is followed by silence for at least\n-        <replaceable>sil</replaceable>\n-        ms,\n-\t\t\twhich occurs during the first\n-        <replaceable>analysistime</replaceable>\n-        ms, then the audio playback is\n-\t\t\taborted and processing jumps to the\n-        <replaceable>talk</replaceable>\n-        extension, if available.\n-      </para>\n+      <para>This application programs an ADSI Phone with the given script</para>\n     </description>\n+    <see-also>\n+      <ref type=\"application\">GetCPEID</ref>\n+      <ref type=\"filename\">adsi.conf</ref>\n+    </see-also>\n   </application>\n-  <module language=\"en_US\" name=\"codec_gsm\">\n-    <depend>gsm</depend>\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"codec_codec2\">\n-    <depend>codec2</depend>\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"codec_dahdi\">\n-    <depend>dahdi</depend>\n+  <module language=\"en_US\" name=\"codec_g722\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"codec_g722\">\n+  <module language=\"en_US\" name=\"codec_a_mu\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"codec_ulaw\">\n+  <module language=\"en_US\" name=\"codec_resample\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"codec_adpcm\">\n+  <module language=\"en_US\" name=\"codec_lpc10\">\n     <support_level>core</support_level>\n   </module>\n   <module language=\"en_US\" name=\"codec_ilbc\">\n     <use>ilbc</use>\n     <defaultenabled>no</defaultenabled>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"codec_g726\">\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"codec_a_mu\">\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"codec_alaw\">\n-    <support_level>core</support_level>\n-  </module>\n   <module language=\"en_US\" name=\"codec_amr\">\n     <depend>amr_nb</depend>\n     <depend>amr_wb_decoder</depend>\n     <depend>amr_wb_encoder</depend>\n   </module>\n-  <module language=\"en_US\" name=\"codec_resample\">\n+  <module language=\"en_US\" name=\"codec_gsm\">\n+    <depend>gsm</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"codec_lpc10\">\n+  <module language=\"en_US\" name=\"codec_ulaw\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"codec_dahdi\">\n+    <depend>dahdi</depend>\n     <support_level>core</support_level>\n   </module>\n   <module language=\"en_US\" name=\"codec_speex\">\n     <depend>speex</depend>\n     <depend>speex_preprocess</depend>\n     <use type=\"external\">speexdsp</use>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"format_ilbc\">\n+  <module language=\"en_US\" name=\"codec_g726\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"format_wav_gsm\">\n+  <module language=\"en_US\" name=\"codec_alaw\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"format_gsm\">\n+  <module language=\"en_US\" name=\"codec_adpcm\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"format_ogg_speex\">\n-    <depend>speex</depend>\n-    <depend>ogg</depend>\n-    <support_level>extended</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"format_h263\">\n+  <module language=\"en_US\" name=\"codec_codec2\">\n+    <depend>codec2</depend>\n     <support_level>core</support_level>\n   </module>\n   <module language=\"en_US\" name=\"format_h264\">\n     <support_level>core</support_level>\n   </module>\n   <module language=\"en_US\" name=\"format_wav\">\n     <support_level>core</support_level>\n   </module>\n   <module language=\"en_US\" name=\"format_sln\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"format_pcm\">\n+  <module language=\"en_US\" name=\"format_siren14\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"format_g729\">\n     <support_level>core</support_level>\n   </module>\n   <module language=\"en_US\" name=\"format_vox\">\n     <support_level>extended</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"format_g729\">\n+  <module language=\"en_US\" name=\"format_ilbc\">\n     <support_level>core</support_level>\n   </module>\n   <module language=\"en_US\" name=\"format_g726\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"format_ogg_vorbis\">\n-    <depend>vorbis</depend>\n-    <depend>ogg</depend>\n+  <module language=\"en_US\" name=\"format_h263\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"format_siren14\">\n+  <module language=\"en_US\" name=\"format_wav_gsm\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"format_g723\">\n     <support_level>core</support_level>\n   </module>\n   <module language=\"en_US\" name=\"format_siren7\">\n     <support_level>core</support_level>\n   </module>\n+  <module language=\"en_US\" name=\"format_gsm\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"format_ogg_speex\">\n+    <depend>speex</depend>\n+    <depend>ogg</depend>\n+    <support_level>extended</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"format_pcm\">\n+    <support_level>core</support_level>\n+  </module>\n   <module language=\"en_US\" name=\"format_g719\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"format_g723\">\n+  <module language=\"en_US\" name=\"format_ogg_vorbis\">\n+    <depend>vorbis</depend>\n+    <depend>ogg</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"cdr_sqlite3_custom\">\n-    <depend>sqlite3</depend>\n+  <module language=\"en_US\" name=\"cdr_tds\">\n+    <depend>freetds</depend>\n     <support_level>extended</support_level>\n   </module>\n   <module language=\"en_US\" name=\"cdr_radius\">\n     <depend>radius</depend>\n     <support_level>extended</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"cdr_csv\">\n-    <support_level>extended</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"cdr_beanstalkd\">\n-    <depend>beanstalk</depend>\n-    <support_level>extended</support_level>\n+  <module language=\"en_US\" name=\"cdr_custom\">\n+    <support_level>core</support_level>\n   </module>\n   <module language=\"en_US\" name=\"cdr_manager\">\n     <support_level>core</support_level>\n   </module>\n   <managerEvent language=\"en_US\" name=\"Cdr\">\n     <managerEventInstance class=\"EVENT_FLAG_CDR\">\n       <synopsis>Raised when a CDR is generated.</synopsis>\n@@ -15566,54 +15562,55 @@\n   <module language=\"en_US\" name=\"cdr_syslog\">\n     <depend>syslog</depend>\n     <defaultenabled>no</defaultenabled>\n     <support_level>deprecated</support_level>\n     <deprecated_in>16</deprecated_in>\n     <removed_in>19</removed_in>\n   </module>\n-  <module language=\"en_US\" name=\"cdr_custom\">\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"cdr_odbc\">\n-    <depend>res_odbc</depend>\n-    <depend>generic_odbc</depend>\n+  <module language=\"en_US\" name=\"cdr_csv\">\n     <support_level>extended</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"cdr_tds\">\n-    <depend>freetds</depend>\n+  <module language=\"en_US\" name=\"cdr_beanstalkd\">\n+    <depend>beanstalk</depend>\n     <support_level>extended</support_level>\n   </module>\n   <module language=\"en_US\" name=\"cdr_adaptive_odbc\">\n     <depend>res_odbc</depend>\n     <depend>generic_odbc</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"cel_beanstalkd\">\n-    <depend>beanstalk</depend>\n+  <module language=\"en_US\" name=\"cdr_odbc\">\n+    <depend>res_odbc</depend>\n+    <depend>generic_odbc</depend>\n     <support_level>extended</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"cel_radius\">\n-    <depend>radius</depend>\n+  <module language=\"en_US\" name=\"cdr_sqlite3_custom\">\n+    <depend>sqlite3</depend>\n     <support_level>extended</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"cel_sqlite3_custom\">\n-    <depend>sqlite3</depend>\n+  <module language=\"en_US\" name=\"cel_beanstalkd\">\n+    <depend>beanstalk</depend>\n     <support_level>extended</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"cel_pgsql\">\n-    <depend>pgsql</depend>\n+  <module language=\"en_US\" name=\"cel_tds\">\n+    <depend>freetds</depend>\n     <support_level>extended</support_level>\n   </module>\n   <module language=\"en_US\" name=\"cel_odbc\">\n     <depend>res_odbc</depend>\n     <depend>generic_odbc</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"cel_custom\">\n-    <support_level>core</support_level>\n+  <module language=\"en_US\" name=\"cel_sqlite3_custom\">\n+    <depend>sqlite3</depend>\n+    <support_level>extended</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"cel_pgsql\">\n+    <depend>pgsql</depend>\n+    <support_level>extended</support_level>\n   </module>\n   <module language=\"en_US\" name=\"cel_manager\">\n     <support_level>core</support_level>\n   </module>\n   <managerEvent language=\"en_US\" name=\"CEL\">\n     <managerEventInstance class=\"EVENT_FLAG_CEL\">\n       <synopsis>Raised when a Channel Event Log is generated for a channel.</synopsis>\n@@ -15771,786 +15768,1989 @@\n           <para>Some events will have event specific data that accompanies the CEL record.\n \t\t\t\t\t\tThis extra data is JSON encoded, and is dependent on the event in\n \t\t\t\t\t\tquestion.</para>\n         </parameter>\n       </syntax>\n     </managerEventInstance>\n   </managerEvent>\n-  <module language=\"en_US\" name=\"cel_tds\">\n-    <depend>freetds</depend>\n+  <module language=\"en_US\" name=\"cel_radius\">\n+    <depend>radius</depend>\n     <support_level>extended</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"bridge_builtin_interval_features\">\n+  <module language=\"en_US\" name=\"cel_custom\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"bridge_simple\">\n     <support_level>core</support_level>\n   </module>\n   <module language=\"en_US\" name=\"bridge_native_rtp\">\n     <support_level>core</support_level>\n   </module>\n   <module language=\"en_US\" name=\"bridge_builtin_features\">\n     <use type=\"module\">res_monitor</use>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"bridge_softmix\">\n+  <module language=\"en_US\" name=\"bridge_builtin_interval_features\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"bridge_simple\">\n+  <module language=\"en_US\" name=\"bridge_softmix\">\n     <support_level>core</support_level>\n   </module>\n   <module language=\"en_US\" name=\"bridge_holding\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"func_logic\">\n+  <module language=\"en_US\" name=\"func_talkdetect\">\n     <support_level>core</support_level>\n   </module>\n-  <function name=\"ISNULL\" language=\"en_US\">\n-    <synopsis>Check if a value is NULL.</synopsis>\n+  <function name=\"TALK_DETECT\" language=\"en_US\">\n+    <since>\n+      <version>12.4.0</version>\n+    </since>\n+    <synopsis>Raises notifications when Asterisk detects silence or talking on a channel.</synopsis>\n     <syntax>\n-      <parameter name=\"data\" required=\"true\"/>\n+      <parameter name=\"action\" required=\"true\">\n+        <optionlist>\n+          <option name=\"remove\">\n+            <para>W/O. Remove talk detection from the channel.</para>\n+          </option>\n+          <option name=\"set\">\n+            <para>W/O. Enable TALK_DETECT and/or configure talk detection\n+\t\t\t\t\t\tparameters. Can be called multiple times to change parameters\n+\t\t\t\t\t\ton a channel with talk detection already enabled.</para>\n+            <argument name=\"dsp_silence_threshold\" required=\"false\">\n+              <para>\n+                The time in milliseconds of sound falling below the\n+                <replaceable>dsp_talking_threshold</replaceable>\n+                option when\n+\t\t\t\t\t\t\ta user is considered to stop talking. The default value is\n+\t\t\t\t\t\t\t2500.\n+              </para>\n+            </argument>\n+            <argument name=\"dsp_talking_threshold\" required=\"false\">\n+              <para>\n+                The minimum average magnitude per sample in a frame\n+\t\t\t\t\t\t\tfor the DSP to consider talking/noise present. A value below\n+\t\t\t\t\t\t\tthis level is considered silence. If not specified, the\n+\t\t\t\t\t\t\tvalue comes from the\n+                <filename>dsp.conf</filename>\n+                <replaceable>silencethreshold</replaceable>\n+                option or 256\n+\t\t\t\t\t\t\tif\n+                <filename>dsp.conf</filename>\n+                doesn't exist or the\n+                <replaceable>silencethreshold</replaceable>\n+                option is not\n+\t\t\t\t\t\t\tset.\n+              </para>\n+            </argument>\n+          </option>\n+        </optionlist>\n+      </parameter>\n     </syntax>\n     <description>\n+      <para>The TALK_DETECT function enables events on the channel\n+\t\t\tit is applied to. These events can be emitted over AMI, ARI, and\n+\t\t\tpotentially other Asterisk modules that listen for the internal\n+\t\t\tnotification.</para>\n       <para>\n-        Returns\n-        <literal>1</literal>\n-        if NULL or\n-        <literal>0</literal>\n-        otherwise.\n+        The function has two parameters that can optionally be passed\n+\t\t\twhen\n+        <literal>set</literal>\n+        on a channel:\n+        <replaceable>dsp_talking_threshold</replaceable>\n+        and\n+        <replaceable>dsp_silence_threshold</replaceable>\n+        .\n+      </para>\n+      <para>\n+        <replaceable>dsp_talking_threshold</replaceable>\n+        is the time in milliseconds of sound\n+\t\t\tabove what the dsp has established as base line silence for a user\n+\t\t\tbefore a user is considered to be talking. By default, the value of\n+        <replaceable>silencethreshold</replaceable>\n+        from\n+        <filename>dsp.conf</filename>\n+        is used. If this value is set too tight events may be\n+\t\t\tfalsely triggered by variants in room noise.\n+      </para>\n+      <para>Valid values are 1 through 2^31.</para>\n+      <para>\n+        <replaceable>dsp_silence_threshold</replaceable>\n+        is the time in milliseconds of sound\n+\t\t\tfalling within what the dsp has established as baseline silence before\n+\t\t\ta user is considered be silent. If this value is set too low events\n+\t\t\tindicating the user has stopped talking may get falsely sent out when\n+\t\t\tthe user briefly pauses during mid sentence.\n       </para>\n+      <para>The best way to approach this option is to set it slightly above\n+\t\t\tthe maximum amount of ms of silence a user may generate during\n+\t\t\tnatural speech.</para>\n+      <para>By default this value is 2500ms. Valid values are 1\n+\t\t\tthrough 2^31.</para>\n+      <example title=\"Enable talk detection\">same =&gt; n,Set(TALK_DETECT(set)=)</example>\n+      <example title=\"Update existing talk detection's silence threshold to 1200 ms\">same =&gt; n,Set(TALK_DETECT(set)=1200)</example>\n+      <example title=\"Remove talk detection\">same =&gt; n,Set(TALK_DETECT(remove)=)</example>\n+      <example title=\"Enable and set talk threshold to 128\">same =&gt; n,Set(TALK_DETECT(set)=,128)</example>\n+      <para>This function will set the following variables:</para>\n+      <note>\n+        <para>The TALK_DETECT function uses an audiohook to inspect the\n+\t\t\t\tvoice media frames on a channel. Other functions, such as JITTERBUFFER,\n+\t\t\t\tDENOISE, and AGC use a similar mechanism. Audiohooks are processed\n+\t\t\t\tin the order in which they are placed on the channel. As such,\n+\t\t\t\tit typically makes sense to place functions that modify the voice\n+\t\t\t\tmedia data prior to placing the TALK_DETECT function, as this will\n+\t\t\t\tyield better results.</para>\n+      </note>\n+      <example title=\"Denoise and then perform talk detection\">same =&gt; n,Set(DENOISE(rx)=on)    ; Denoise received audio\n+\t\t\tsame =&gt; n,Set(TALK_DETECT(set)=) ; Perform talk detection on the denoised received audio</example>\n     </description>\n   </function>\n-  <function name=\"SET\" language=\"en_US\">\n-    <synopsis>SET assigns a value to a channel variable.</synopsis>\n-    <syntax argsep=\"=\">\n-      <parameter name=\"varname\" required=\"true\"/>\n-      <parameter name=\"value\"/>\n-    </syntax>\n-    <description/>\n-  </function>\n-  <function name=\"EXISTS\" language=\"en_US\">\n-    <synopsis>Test the existence of a value.</synopsis>\n+  <module language=\"en_US\" name=\"func_jitterbuffer\">\n+    <support_level>core</support_level>\n+  </module>\n+  <function name=\"JITTERBUFFER\" language=\"en_US\">\n+    <synopsis>Add a Jitterbuffer to the Read side of the channel. This dejitters the audio stream before it reaches the Asterisk core. This is a write only function.</synopsis>\n     <syntax>\n-      <parameter name=\"data\" required=\"true\"/>\n+      <parameter name=\"jitterbuffer type\" required=\"true\">\n+        <optionlist>\n+          <option name=\"fixed\">\n+            <para>Set a fixed jitterbuffer on the channel.</para>\n+          </option>\n+          <option name=\"adaptive\">\n+            <para>Set an adaptive jitterbuffer on the channel.</para>\n+          </option>\n+          <option name=\"disabled\">\n+            <para>Remove a previously set jitterbuffer from the channel.</para>\n+          </option>\n+        </optionlist>\n+      </parameter>\n     </syntax>\n     <description>\n       <para>\n-        Returns\n-        <literal>1</literal>\n-        if exists,\n-        <literal>0</literal>\n-        otherwise.\n+        Jitterbuffers are constructed in two different ways.\n+\t\t\tThe first always take four arguments:\n+        <replaceable>max_size</replaceable>\n+        ,\n+        <replaceable>resync_threshold</replaceable>\n+        ,\n+        <replaceable>target_extra</replaceable>\n+        ,\n+\t\t\tand\n+        <replaceable>sync_video</replaceable>\n+        .\n+\t\t\tAlternatively, a single argument of\n+        <literal>default</literal>\n+        can be provided,\n+\t\t\twhich will construct the default jitterbuffer for the given\n+        <replaceable>jitterbuffer type</replaceable>\n+        .\n+      </para>\n+      <para>The arguments are:</para>\n+      <para>\n+        <replaceable>max_size</replaceable>\n+        : Length in milliseconds of the buffer.\n+\t\t\tDefaults to 200 ms.\n+      </para>\n+      <para>\n+        <replaceable>resync_threshold</replaceable>\n+        : The length in milliseconds over\n+\t\t\twhich a timestamp difference will result in resyncing the jitterbuffer.\n+\t\t\tDefaults to 1000ms.\n       </para>\n+      <para>target_extra: This option only affects the adaptive jitterbuffer. It represents\n+\t\t\tthe amount time in milliseconds by which the new jitter buffer will pad its size.\n+\t\t\tDefaults to 40ms.</para>\n+      <para>sync_video: This option enables video synchronization with the audio stream. It can be\n+\t\t\tturned on and off. Defaults to off.</para>\n+      <example title=\"Fixed with defaults\" language=\"text\">exten =&gt; 1,1,Set(JITTERBUFFER(fixed)=default)</example>\n+      <example title=\"Fixed with 200ms max size\" language=\"text\">exten =&gt; 1,1,Set(JITTERBUFFER(fixed)=200)</example>\n+      <example title=\"Fixed with 200ms max size and video sync support\" language=\"text\">exten =&gt; 1,1,Set(JITTERBUFFER(fixed)=200,,,yes)</example>\n+      <example title=\"Fixed with 200ms max size, resync threshold 1500\" language=\"text\">exten =&gt; 1,1,Set(JITTERBUFFER(fixed)=200,1500)</example>\n+      <example title=\"Adaptive with defaults\" language=\"text\">exten =&gt; 1,1,Set(JITTERBUFFER(adaptive)=default)</example>\n+      <example title=\"Adaptive with 200ms max size, 60ms target extra\" language=\"text\">exten =&gt; 1,1,Set(JITTERBUFFER(adaptive)=200,,60)</example>\n+      <example title=\"Adaptive with 200ms max size and video sync support\" language=\"text\">exten =&gt; 1,1,Set(JITTERBUFFER(adaptive)=200,,,yes)</example>\n+      <example title=\"Set a fixed jitterbuffer with defaults; then remove it\" language=\"text\">exten =&gt; 1,1,Set(JITTERBUFFER(fixed)=default)\n+\t\t\texten =&gt; 1,n,Set(JITTERBUFFER(disabled)=)</example>\n+      <note>\n+        <para>If a channel specifies a jitterbuffer due to channel driver configuration and\n+\t\t\tthe JITTERBUFFER function has set a jitterbuffer for that channel, the jitterbuffer set by\n+\t\t\tthe JITTERBUFFER function will take priority and the jitterbuffer set by the channel\n+\t\t\tconfiguration will not be applied.</para>\n+      </note>\n     </description>\n   </function>\n-  <function name=\"IF\" language=\"en_US\">\n-    <synopsis>Check for an expression.</synopsis>\n-    <syntax argsep=\"?\">\n-      <parameter name=\"expression\" required=\"true\"/>\n-      <parameter name=\"retvalue\" argsep=\":\" required=\"true\">\n-        <argument name=\"true\"/>\n-        <argument name=\"false\"/>\n-      </parameter>\n+  <module language=\"en_US\" name=\"func_odbc\">\n+    <depend>res_odbc</depend>\n+    <depend>generic_odbc</depend>\n+    <support_level>core</support_level>\n+  </module>\n+  <function name=\"ODBC_FETCH\" language=\"en_US\">\n+    <synopsis>Fetch a row from a multirow query.</synopsis>\n+    <syntax>\n+      <parameter name=\"result-id\" required=\"true\"/>\n     </syntax>\n     <description>\n       <para>\n-        Returns the data following\n-        <literal>?</literal>\n-        if true, else the data following\n-        <literal>:</literal>\n+        For queries which are marked as mode=multirow, the original\n+\t\t\tquery returns a\n+        <replaceable>result-id</replaceable>\n+        from which results\n+\t\t\tmay be fetched.  This function implements the actual fetch of the results.\n+      </para>\n+      <para>\n+        This also sets\n+        <variable>ODBC_FETCH_STATUS</variable>\n+        .\n       </para>\n+      <variablelist>\n+        <variable name=\"ODBC_FETCH_STATUS\">\n+          <value name=\"SUCESS\">If rows are available.</value>\n+          <value name=\"FAILURE\">If no rows are available.</value>\n+        </variable>\n+      </variablelist>\n     </description>\n   </function>\n-  <function name=\"IFTIME\" language=\"en_US\">\n-    <synopsis>Temporal Conditional.</synopsis>\n-    <syntax argsep=\"?\">\n-      <parameter name=\"timespec\" required=\"true\"/>\n-      <parameter name=\"retvalue\" required=\"true\" argsep=\":\">\n-        <argument name=\"true\"/>\n-        <argument name=\"false\"/>\n-      </parameter>\n+  <application name=\"ODBCFinish\" language=\"en_US\">\n+    <synopsis>Clear the resultset of a sucessful multirow query.</synopsis>\n+    <syntax>\n+      <parameter name=\"result-id\" required=\"true\"/>\n+    </syntax>\n+    <description>\n+      <para>For queries which are marked as mode=multirow, this will clear\n+\t\t\tany remaining rows of the specified resultset.</para>\n+    </description>\n+  </application>\n+  <function name=\"SQL_ESC\" language=\"en_US\">\n+    <synopsis>Escapes single ticks for use in SQL statements.</synopsis>\n+    <syntax>\n+      <parameter name=\"string\" required=\"true\"/>\n     </syntax>\n     <description>\n       <para>\n-        Returns the data following\n-        <literal>?</literal>\n-        if true, else the data following\n-        <literal>:</literal>\n+        Used in SQL templates to escape data which may contain single ticks\n+        <literal>'</literal>\n+        which are otherwise used to delimit data.\n       </para>\n+      <example title=\"Escape example\">SELECT foo FROM bar WHERE baz='${SQL_ESC(${ARG1})}'</example>\n     </description>\n   </function>\n-  <function name=\"IMPORT\" language=\"en_US\">\n-    <synopsis>Retrieve the value of a variable from another channel.</synopsis>\n+  <function name=\"SQL_ESC_BACKSLASHES\" language=\"en_US\">\n+    <synopsis>Escapes backslashes for use in SQL statements.</synopsis>\n     <syntax>\n-      <parameter name=\"channel\" required=\"true\"/>\n-      <parameter name=\"variable\" required=\"true\"/>\n+      <parameter name=\"string\" required=\"true\"/>\n     </syntax>\n-    <description/>\n+    <description>\n+      <para>\n+        Used in SQL templates to escape data which may contain backslashes\n+        <literal>\\</literal>\n+        which are otherwise used to escape data.\n+      </para>\n+      <example title=\"Escape with backslashes example\">SELECT foo FROM bar WHERE baz='${SQL_ESC(${SQL_ESC_BACKSLASHES(${ARG1})})}'</example>\n+    </description>\n   </function>\n-  <module language=\"en_US\" name=\"func_pjsip_endpoint\">\n-    <depend>pjproject</depend>\n-    <depend>res_pjsip</depend>\n+  <module language=\"en_US\" name=\"func_presencestate\">\n     <support_level>core</support_level>\n   </module>\n-  <function name=\"PJSIP_ENDPOINT\" language=\"en_US\">\n-    <synopsis>Get information about a PJSIP endpoint</synopsis>\n+  <function name=\"PRESENCE_STATE\" language=\"en_US\">\n+    <synopsis>Get or Set a presence state.</synopsis>\n     <syntax>\n-      <parameter name=\"name\" required=\"true\">\n-        <para>The name of the endpoint to query.</para>\n-      </parameter>\n-      <parameter name=\"field\" required=\"true\">\n+      <parameter name=\"provider\" required=\"true\">\n         <para>\n-          The configuration option for the endpoint to query for.\n-\t\t\t\tSupported options are those fields on the\n-          <replaceable>endpoint</replaceable>\n-          object in\n-          <filename>pjsip.conf</filename>\n-          .\n+          The provider of the presence, such as\n+          <literal>CustomPresence</literal>\n         </para>\n-        <enumlist>\n-          <configOptionToEnum>\n-            <xi:include xpointer=\"xpointer(/docs/configInfo[@name='res_pjsip']/configFile[@name='pjsip.conf']/configObject[@name='endpoint']/configOption)\"/>\n-          </configOptionToEnum>\n-        </enumlist>\n+      </parameter>\n+      <parameter name=\"field\" required=\"true\">\n+        <para>Which field of the presence state information is wanted.</para>\n+        <optionlist>\n+          <option name=\"value\">\n+            <para>\n+              The current presence, such as\n+              <literal>away</literal>\n+            </para>\n+          </option>\n+          <option name=\"subtype\">\n+            <para>Further information about the current presence</para>\n+          </option>\n+          <option name=\"message\">\n+            <para>A custom message that may indicate further details about the presence</para>\n+          </option>\n+        </optionlist>\n+      </parameter>\n+      <parameter name=\"options\" required=\"false\">\n+        <optionlist>\n+          <option name=\"e\">\n+            <para>On Write - Use this option when the subtype and message provided are Base64\n+\t\t\t\t\tencoded. The values will be stored encoded within Asterisk, but all consumers of\n+\t\t\t\t\tthe presence state (e.g. the SIP presence event package) will receive decoded values.</para>\n+            <para>On Read - Retrieves unencoded message/subtype in Base64 encoded form.</para>\n+          </option>\n+        </optionlist>\n       </parameter>\n     </syntax>\n+    <description>\n+      <para>The PRESENCE_STATE function can be used to retrieve the presence from any\n+\t\t\tpresence provider. For example:</para>\n+      <para>NoOp(SIP/mypeer has presence ${PRESENCE_STATE(SIP/mypeer,value)})</para>\n+      <para>NoOp(Conference number 1234 has presence message ${PRESENCE_STATE(MeetMe:1234,message)})</para>\n+      <para>\n+        The PRESENCE_STATE function can also be used to set custom presence state from\n+\t\t\tthe dialplan.  The\n+        <literal>CustomPresence:</literal>\n+        prefix must be used. For example:\n+      </para>\n+      <para>Set(PRESENCE_STATE(CustomPresence:lamp1)=away,temporary,Out to lunch)</para>\n+      <para>Set(PRESENCE_STATE(CustomPresence:lamp2)=dnd,,Trying to get work done)</para>\n+      <para>Set(PRESENCE_STATE(CustomPresence:lamp3)=xa,T24gdmFjYXRpb24=,,e)</para>\n+      <para>Set(BASE64_LAMP3_PRESENCE=${PRESENCE_STATE(CustomPresence:lamp3,subtype,e)})</para>\n+      <para>You can subscribe to the status of a custom presence state using a hint in\n+\t\t\tthe dialplan:</para>\n+      <para>exten =&gt; 1234,hint,,CustomPresence:lamp1</para>\n+      <para>The possible values for both uses of this function are:</para>\n+      <para>not_set | unavailable | available | away | xa | chat | dnd</para>\n+    </description>\n   </function>\n-  <module language=\"en_US\" name=\"func_sayfiles\">\n-    <support_level>extended</support_level>\n+  <module language=\"en_US\" name=\"func_sysinfo\">\n+    <support_level>core</support_level>\n   </module>\n-  <function name=\"SAYFILES\" language=\"en_US\">\n-    <since>\n-      <version>16.21.0</version>\n-      <version>18.7.0</version>\n-      <version>19.0.0</version>\n-    </since>\n-    <synopsis>Returns the ampersand-delimited file names that would be played by the Say applications (e.g. SayAlpha, SayDigits).</synopsis>\n+  <function name=\"SYSINFO\" language=\"en_US\">\n+    <synopsis>Returns system information specified by parameter.</synopsis>\n     <syntax>\n-      <parameter name=\"value\" required=\"true\">\n-        <para>The value to be translated to filenames.</para>\n-      </parameter>\n-      <parameter name=\"type\">\n-        <para>Say application type.</para>\n+      <parameter name=\"parameter\" required=\"true\">\n         <enumlist>\n-          <enum name=\"alpha\">\n-            <para>Files played by SayAlpha(). Default if none is specified.</para>\n+          <enum name=\"loadavg\">\n+            <para>System load average from past minute.</para>\n           </enum>\n-          <enum name=\"digits\">\n-            <para>Files played by SayDigits().</para>\n+          <enum name=\"numcalls\">\n+            <para>Number of active calls currently in progress.</para>\n           </enum>\n-          <enum name=\"money\">\n-            <para>Files played by SayMoney(). Currently supported for English and US dollars only.</para>\n+          <enum name=\"uptime\">\n+            <para>System uptime in hours.</para>\n+            <note>\n+              <para>This parameter is dependant upon operating system.</para>\n+            </note>\n           </enum>\n-          <enum name=\"number\">\n-            <para>Files played by SayNumber(). Currently supported for English only.</para>\n+          <enum name=\"totalram\">\n+            <para>Total usable main memory size in KiB.</para>\n+            <note>\n+              <para>This parameter is dependant upon operating system.</para>\n+            </note>\n           </enum>\n-          <enum name=\"ordinal\">\n-            <para>Files played by SayOrdinal(). Currently supported for English only.</para>\n+          <enum name=\"freeram\">\n+            <para>Available memory size in KiB.</para>\n+            <note>\n+              <para>This parameter is dependant upon operating system.</para>\n+            </note>\n           </enum>\n-          <enum name=\"phonetic\">\n-            <para>Files played by SayPhonetic().</para>\n+          <enum name=\"bufferram\">\n+            <para>Memory used by buffers in KiB.</para>\n+            <note>\n+              <para>This parameter is dependant upon operating system.</para>\n+            </note>\n+          </enum>\n+          <enum name=\"totalswap\">\n+            <para>Total swap space still available in KiB.</para>\n+            <note>\n+              <para>This parameter is dependant upon operating system.</para>\n+            </note>\n+          </enum>\n+          <enum name=\"freeswap\">\n+            <para>Free swap space still available in KiB.</para>\n+            <note>\n+              <para>This parameter is dependant upon operating system.</para>\n+            </note>\n+          </enum>\n+          <enum name=\"numprocs\">\n+            <para>Number of current processes.</para>\n+            <note>\n+              <para>This parameter is dependant upon operating system.</para>\n+            </note>\n           </enum>\n         </enumlist>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>Returns the files that would be played by a Say application. These filenames could then be\n-\t\t\tpassed directly into Playback, BackGround, Read, Queue, or any application which supports\n-\t\t\tplayback of multiple ampersand-delimited files.</para>\n-      <example title=\"Read using the number 123\">same =&gt; n,Read(response,${SAYFILES(123,number)})</example>\n+      <para>Returns information from a given parameter.</para>\n     </description>\n-    <see-also>\n-      <ref type=\"application\">SayAlpha</ref>\n-      <ref type=\"application\">SayDigits</ref>\n-      <ref type=\"application\">SayMoney</ref>\n-      <ref type=\"application\">SayNumber</ref>\n-      <ref type=\"application\">SayOrdinal</ref>\n-      <ref type=\"application\">SayPhonetic</ref>\n-    </see-also>\n   </function>\n-  <module language=\"en_US\" name=\"func_dialgroup\">\n+  <module language=\"en_US\" name=\"func_vmcount\">\n     <support_level>core</support_level>\n   </module>\n-  <function name=\"DIALGROUP\" language=\"en_US\">\n-    <synopsis>Manages a group of users for dialing.</synopsis>\n+  <function name=\"VMCOUNT\" language=\"en_US\">\n+    <synopsis>Count the voicemails in a specified mailbox or mailboxes.</synopsis>\n     <syntax>\n-      <parameter name=\"group\" required=\"true\"/>\n-      <parameter name=\"op\">\n-        <para>The operation name, possible values are:</para>\n-        <para>\n-          <literal>add</literal>\n-          - add a channel name or interface (write-only)\n-        </para>\n+      <parameter name=\"vmbox\" required=\"true\" argsep=\"&amp;\">\n+        <para>A mailbox or list of mailboxes</para>\n+      </parameter>\n+      <parameter name=\"folder\" required=\"false\">\n         <para>\n-          <literal>del</literal>\n-          - remove a channel name or interface (write-only)\n+          If not specified, defaults to\n+          <literal>INBOX</literal>\n         </para>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>Presents an interface meant to be used in concert with the Dial\n-\t\t\tapplication, by presenting a list of channels which should be dialled when\n-\t\t\treferenced.</para>\n       <para>\n-        When DIALGROUP is read from, the argument is interpreted as the particular\n-        <replaceable>group</replaceable>\n-        for which a dial should be attempted.  When DIALGROUP is written to\n-\t\t\twith no arguments, the entire list is replaced with the argument specified.\n+        Count the number of voicemails in a specified mailbox, you could also specify\n+\t\t\tthe mailbox\n+        <replaceable>folder</replaceable>\n+        .\n       </para>\n-      <para>Functionality is similar to a queue, except that when no interfaces are\n-\t\t\tavailable, execution may continue in the dialplan.  This is useful when\n-\t\t\tyou want certain people to be the first to answer any calls, with immediate\n-\t\t\tfallback to a queue when the front line people are busy or unavailable, but\n-\t\t\tyou still want front line people to log in and out of that group, just like\n-\t\t\ta queue.</para>\n-      <example title=\"Add 2 endpoints to a dial group\">exten =&gt; 1,1,Set(DIALGROUP(mygroup,add)=SIP/10)\n-\t\t\tsame =&gt; n,Set(DIALGROUP(mygroup,add)=SIP/20)\n-\t\t\tsame =&gt; n,Dial(${DIALGROUP(mygroup)})</example>\n+      <example title=\"Mailbox folder count\">exten =&gt; s,1,Set(foo=${VMCOUNT(125@default)})</example>\n+      <para>An ampersand-separated list of mailboxes may be specified to count voicemails in\n+\t\t\tmultiple mailboxes. If a folder is specified, this will apply to all mailboxes specified.</para>\n+      <example title=\"Multiple mailbox inbox count\">same =&gt; n,NoOp(${VMCOUNT(1234@default&amp;1235@default&amp;1236@default,INBOX)})</example>\n     </description>\n   </function>\n-  <module language=\"en_US\" name=\"func_shell\">\n+  <module language=\"en_US\" name=\"func_sha1\">\n     <support_level>core</support_level>\n   </module>\n-  <function name=\"SHELL\" language=\"en_US\">\n-    <synopsis>Executes a command using the system shell and captures its output.</synopsis>\n+  <function name=\"SHA1\" language=\"en_US\">\n+    <synopsis>Computes a SHA1 digest.</synopsis>\n     <syntax>\n-      <parameter name=\"command\" required=\"true\">\n-        <para>The command that the shell should execute.</para>\n-        <warning>\n-          <para>\n-            Do not use untrusted strings such as\n-            <variable>CALLERID(num)</variable>\n-            or\n-            <variable>CALLERID(name)</variable>\n-            as part of the command parameters.  You\n-\t\t\t\trisk a command injection attack executing arbitrary commands if the untrusted\n-\t\t\t\tstrings aren't filtered to remove dangerous characters.  See function\n-            <variable>FILTER()</variable>\n-            .\n-          </para>\n-        </warning>\n+      <parameter name=\"data\" required=\"true\">\n+        <para>Input string</para>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>Collects the output generated by a command executed by the system shell</para>\n-      <example title=\"Shell example\">exten =&gt; s,1,Set(foo=${SHELL(echo bar)})</example>\n-      <note>\n-        <para>The command supplied to this function will be executed by the\n-\t\t\t\tsystem's shell, typically specified in the SHELL environment variable. There\n-\t\t\t\tare many different system shells available with somewhat different behaviors,\n-\t\t\t\tso the output generated by this function may vary between platforms.</para>\n-        <para>\n-          If\n-          <literal>live_dangerously</literal>\n-          in\n-          <literal>asterisk.conf</literal>\n-          is set to\n-          <literal>no</literal>\n-          , this function can only be executed from the\n-\t\t\t\tdialplan, and not directly from external protocols.\n-        </para>\n-      </note>\n+      <para>Generate a SHA1 digest via the SHA1 algorythm.</para>\n+      <example title=\"Set sha1hash variable to SHA1 hash of junky\">exten =&gt; s,1,Set(sha1hash=${SHA1(junky)})</example>\n+      <para>\n+        The example above sets the asterisk variable sha1hash to the string\n+        <literal>60fa5675b9303eb62f99a9cd47f9f5837d18f9a0</literal>\n+        which is known as its hash\n+      </para>\n     </description>\n   </function>\n-  <module language=\"en_US\" name=\"func_env\">\n+  <module language=\"en_US\" name=\"func_blacklist\">\n     <support_level>core</support_level>\n   </module>\n-  <function name=\"ENV\" language=\"en_US\">\n-    <synopsis>Gets or sets the environment variable specified.</synopsis>\n-    <syntax>\n-      <parameter name=\"varname\" required=\"true\">\n-        <para>Environment variable name</para>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>\n-        Variables starting with\n-        <literal>AST_</literal>\n-        are reserved to the system and may not be set.\n+  <function name=\"BLACKLIST\" language=\"en_US\">\n+    <synopsis>Check if the callerid is on the blacklist.</synopsis>\n+    <syntax/>\n+    <description>\n+      <para>\n+        Uses astdb to check if the Caller*ID is in family\n+        <literal>blacklist</literal>\n+        .\n+\t\t\tReturns\n+        <literal>1</literal>\n+        or\n+        <literal>0</literal>\n+        .\n       </para>\n-      <para>Additionally, the following system variables are available as special built-in dialplan variables.\n-\t\t\tThese variables cannot be set or modified and are read-only.</para>\n-      <variablelist>\n-        <variable name=\"EPOCH\">\n-          <para>Current unix style epoch</para>\n-        </variable>\n-        <variable name=\"SYSTEMNAME\">\n-          <para>\n-            value of the\n-            <literal>systemname</literal>\n-            option from\n-            <literal>asterisk.conf</literal>\n-          </para>\n-        </variable>\n-        <variable name=\"ASTCACHEDIR\">\n-          <para>\n-            value of the\n-            <literal>astcachedir</literal>\n-            option from\n-            <literal>asterisk.conf</literal>\n-          </para>\n-        </variable>\n-        <variable name=\"ASTETCDIR\">\n-          <para>\n-            value of the\n-            <literal>astetcdir</literal>\n-            option from\n-            <literal>asterisk.conf</literal>\n-          </para>\n-        </variable>\n-        <variable name=\"ASTMODDIR\">\n-          <para>\n-            value of the\n-            <literal>astmoddir</literal>\n-            option from\n-            <literal>asterisk.conf</literal>\n-          </para>\n-        </variable>\n-        <variable name=\"ASTVARLIBDIR\">\n-          <para>\n-            value of the\n-            <literal>astvarlib</literal>\n-            option from\n-            <literal>asterisk.conf</literal>\n-          </para>\n-        </variable>\n-        <variable name=\"ASTDBDIR\">\n-          <para>\n-            value of the\n-            <literal>astdbdir</literal>\n-            option from\n-            <literal>asterisk.conf</literal>\n-          </para>\n-        </variable>\n-        <variable name=\"ASTKEYDIR\">\n-          <para>\n-            value of the\n-            <literal>astkeydir</literal>\n-            option from\n-            <literal>asterisk.conf</literal>\n-          </para>\n-        </variable>\n-        <variable name=\"ASTDATADIR\">\n-          <para>\n-            value of the\n-            <literal>astdatadir</literal>\n-            option from\n-            <literal>asterisk.conf</literal>\n-          </para>\n-        </variable>\n-        <variable name=\"ASTAGIDIR\">\n-          <para>\n-            value of the\n-            <literal>astagidir</literal>\n-            option from\n-            <literal>asterisk.conf</literal>\n-          </para>\n-        </variable>\n-        <variable name=\"ASTSPOOLDIR\">\n-          <para>\n-            value of the\n-            <literal>astspooldir</literal>\n-            option from\n-            <literal>asterisk.conf</literal>\n-          </para>\n-        </variable>\n-        <variable name=\"ASTRUNDIR\">\n-          <para>\n-            value of the\n-            <literal>astrundir</literal>\n-            option from\n-            <literal>asterisk.conf</literal>\n-          </para>\n-        </variable>\n-        <variable name=\"ASTLOGDIR\">\n-          <para>\n-            value of the\n-            <literal>astlogdir</literal>\n-            option from\n-            <literal>asterisk.conf</literal>\n-          </para>\n-        </variable>\n-        <variable name=\"ASTSBINDIR\">\n-          <para>\n-            value of the\n-            <literal>astsbindir</literal>\n-            option from\n-            <literal>asterisk.conf</literal>\n-          </para>\n-        </variable>\n-        <variable name=\"ENTITYID\">\n-          <para>\n-            Global Entity ID set automatically, or from\n-            <literal>asterisk.conf</literal>\n-          </para>\n-        </variable>\n-      </variablelist>\n     </description>\n+    <see-also>\n+      <ref type=\"function\">DB</ref>\n+    </see-also>\n   </function>\n-  <function name=\"STAT\" language=\"en_US\">\n-    <synopsis>Does a check on the specified file.</synopsis>\n+  <module language=\"en_US\" name=\"func_iconv\">\n+    <depend>iconv</depend>\n+    <support_level>core</support_level>\n+  </module>\n+  <function name=\"ICONV\" language=\"en_US\">\n+    <synopsis>Converts charsets of strings.</synopsis>\n     <syntax>\n-      <parameter name=\"flag\" required=\"true\">\n-        <para>Flag may be one of the following:</para>\n-        <para>d - Checks if the file is a directory.</para>\n-        <para>e - Checks if the file exists.</para>\n-        <para>f - Checks if the file is a regular file.</para>\n-        <para>m - Returns the file mode (in octal)</para>\n-        <para>s - Returns the size (in bytes) of the file</para>\n-        <para>A - Returns the epoch at which the file was last accessed.</para>\n-        <para>C - Returns the epoch at which the inode was last changed.</para>\n-        <para>M - Returns the epoch at which the file was last modified.</para>\n+      <parameter name=\"in-charset\" required=\"true\">\n+        <para>Input charset</para>\n       </parameter>\n-      <parameter name=\"filename\" required=\"true\"/>\n+      <parameter name=\"out-charset\" required=\"true\">\n+        <para>Output charset</para>\n+      </parameter>\n+      <parameter name=\"string\" required=\"true\">\n+        <para>\n+          String to convert, from\n+          <replaceable>in-charset</replaceable>\n+          to\n+          <replaceable>out-charset</replaceable>\n+        </para>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>\n+        Converts string from\n+        <replaceable>in-charset</replaceable>\n+        into\n+        <replaceable>out-charset</replaceable>\n+        .\n+\t\t\tFor available charsets, use\n+        <literal>iconv -l</literal>\n+        on your shell command line.\n+      </para>\n+      <note>\n+        <para>Due to limitations within the API, ICONV will not currently work with\n+\t\t\tcharsets with embedded NULLs. If found, the string will terminate.</para>\n+      </note>\n+    </description>\n+  </function>\n+  <module language=\"en_US\" name=\"func_realtime\">\n+    <support_level>core</support_level>\n+  </module>\n+  <function name=\"REALTIME\" language=\"en_US\">\n+    <synopsis>RealTime Read/Write Functions.</synopsis>\n+    <syntax>\n+      <parameter name=\"family\" required=\"true\"/>\n+      <parameter name=\"fieldmatch\" required=\"true\"/>\n+      <parameter name=\"matchvalue\"/>\n+      <parameter name=\"delim1|field\">\n+        <para>\n+          Use\n+          <replaceable>delim1</replaceable>\n+          with\n+          <replaceable>delim2</replaceable>\n+          on\n+\t\t\t\tread and\n+          <replaceable>field</replaceable>\n+          without\n+          <replaceable>delim2</replaceable>\n+          on\n+\t\t\t\twrite\n+        </para>\n+        <para>\n+          If we are reading and\n+          <replaceable>delim1</replaceable>\n+          is not specified, defaults\n+\t\t\t\tto\n+          <literal>,</literal>\n+        </para>\n+      </parameter>\n+      <parameter name=\"delim2\">\n+        <para>\n+          Parameter only used when reading, if not specified defaults to\n+          <literal>=</literal>\n+        </para>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>\n+        This function will read or write values from/to a RealTime repository.\n+\t\t\tREALTIME(....) will read names/values from the repository, and\n+\t\t\tREALTIME(....)= will write a new value/field to the repository. On a\n+\t\t\tread, this function returns a delimited text string. The name/value\n+\t\t\tpairs are delimited by\n+        <replaceable>delim1</replaceable>\n+        , and the name and value are delimited\n+\t\t\tbetween each other with delim2.\n+\t\t\tIf there is no match, NULL will be returned by the function.\n+\t\t\tOn a write, this function will always return NULL.\n+      </para>\n+    </description>\n+    <see-also>\n+      <ref type=\"function\">REALTIME_STORE</ref>\n+      <ref type=\"function\">REALTIME_DESTROY</ref>\n+      <ref type=\"function\">REALTIME_FIELD</ref>\n+      <ref type=\"function\">REALTIME_HASH</ref>\n+    </see-also>\n+  </function>\n+  <function name=\"REALTIME_STORE\" language=\"en_US\">\n+    <synopsis>RealTime Store Function.</synopsis>\n+    <syntax>\n+      <parameter name=\"family\" required=\"true\"/>\n+      <parameter name=\"field1\" required=\"true\"/>\n+      <parameter name=\"fieldN\" required=\"true\" multiple=\"true\"/>\n+      <parameter name=\"field30\" required=\"true\"/>\n+    </syntax>\n+    <description>\n+      <para>This function will insert a new set of values into the RealTime repository.\n+\t\t\tIf RT engine provides an unique ID of the stored record, REALTIME_STORE(...)=..\n+\t\t\tcreates channel variable named RTSTOREID, which contains value of unique ID.\n+\t\t\tCurrently, a maximum of 30 field/value pairs is supported.</para>\n+    </description>\n+    <see-also>\n+      <ref type=\"function\">REALTIME</ref>\n+      <ref type=\"function\">REALTIME_DESTROY</ref>\n+      <ref type=\"function\">REALTIME_FIELD</ref>\n+      <ref type=\"function\">REALTIME_HASH</ref>\n+    </see-also>\n+  </function>\n+  <function name=\"REALTIME_DESTROY\" language=\"en_US\">\n+    <synopsis>RealTime Destroy Function.</synopsis>\n+    <syntax>\n+      <parameter name=\"family\" required=\"true\"/>\n+      <parameter name=\"fieldmatch\" required=\"true\"/>\n+      <parameter name=\"matchvalue\"/>\n+      <parameter name=\"delim1\"/>\n+      <parameter name=\"delim2\"/>\n     </syntax>\n     <description>\n+      <para>This function acts in the same way as REALTIME(....) does, except that\n+\t\t\tit destroys the matched record in the RT engine.</para>\n       <note>\n         <para>\n           If\n           <literal>live_dangerously</literal>\n           in\n           <literal>asterisk.conf</literal>\n           is set to\n           <literal>no</literal>\n-          , this function can only be executed from the\n-\t\t\t\tdialplan, and not directly from external protocols.\n+          , this function can only be read from the\n+\t\t\t\tdialplan, and not directly from external protocols. It can, however, be\n+\t\t\t\texecuted as a write operation (\n+          <literal>REALTIME_DESTROY(family, fieldmatch)=ignored</literal>\n+          )\n         </para>\n       </note>\n     </description>\n+    <see-also>\n+      <ref type=\"function\">REALTIME</ref>\n+      <ref type=\"function\">REALTIME_STORE</ref>\n+      <ref type=\"function\">REALTIME_FIELD</ref>\n+      <ref type=\"function\">REALTIME_HASH</ref>\n+    </see-also>\n   </function>\n-  <function name=\"FILE\" language=\"en_US\">\n-    <synopsis>Read or write text file.</synopsis>\n+  <function name=\"REALTIME_FIELD\" language=\"en_US\">\n+    <synopsis>RealTime query function.</synopsis>\n     <syntax>\n-      <parameter name=\"filename\" required=\"true\"/>\n-      <parameter name=\"offset\">\n+      <parameter name=\"family\" required=\"true\"/>\n+      <parameter name=\"fieldmatch\" required=\"true\"/>\n+      <parameter name=\"matchvalue\" required=\"true\"/>\n+      <parameter name=\"fieldname\" required=\"true\"/>\n+    </syntax>\n+    <description>\n+      <para>\n+        This function retrieves a single item,\n+        <replaceable>fieldname</replaceable>\n+        from the RT engine, where\n+        <replaceable>fieldmatch</replaceable>\n+        contains the value\n+        <replaceable>matchvalue</replaceable>\n+        .  When written to, the REALTIME_FIELD() function\n+\t\t\tperforms identically to the REALTIME() function.\n+      </para>\n+    </description>\n+    <see-also>\n+      <ref type=\"function\">REALTIME</ref>\n+      <ref type=\"function\">REALTIME_STORE</ref>\n+      <ref type=\"function\">REALTIME_DESTROY</ref>\n+      <ref type=\"function\">REALTIME_HASH</ref>\n+    </see-also>\n+  </function>\n+  <function name=\"REALTIME_HASH\" language=\"en_US\">\n+    <synopsis>RealTime query function.</synopsis>\n+    <syntax>\n+      <parameter name=\"family\" required=\"true\"/>\n+      <parameter name=\"fieldmatch\" required=\"true\"/>\n+      <parameter name=\"matchvalue\" required=\"true\"/>\n+    </syntax>\n+    <description>\n+      <para>\n+        This function retrieves a single record from the RT engine, where\n+        <replaceable>fieldmatch</replaceable>\n+        contains the value\n+        <replaceable>matchvalue</replaceable>\n+        and formats the output suitably, such that\n+\t\t\tit can be assigned to the HASH() function.  The HASH() function then provides\n+\t\t\ta suitable method for retrieving each field value of the record.\n+      </para>\n+    </description>\n+    <see-also>\n+      <ref type=\"function\">REALTIME</ref>\n+      <ref type=\"function\">REALTIME_STORE</ref>\n+      <ref type=\"function\">REALTIME_DESTROY</ref>\n+      <ref type=\"function\">REALTIME_FIELD</ref>\n+    </see-also>\n+  </function>\n+  <module language=\"en_US\" name=\"func_cut\">\n+    <support_level>core</support_level>\n+  </module>\n+  <function name=\"SORT\" language=\"en_US\">\n+    <synopsis>Sorts a list of key/vals into a list of keys, based upon the vals.</synopsis>\n+    <syntax>\n+      <parameter name=\"keyval\" required=\"true\" argsep=\":\">\n+        <argument name=\"key1\" required=\"true\"/>\n+        <argument name=\"val1\" required=\"true\"/>\n+      </parameter>\n+      <parameter name=\"keyvaln\" multiple=\"true\" argsep=\":\">\n+        <argument name=\"key2\" required=\"true\"/>\n+        <argument name=\"val2\" required=\"true\"/>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>Takes a comma-separated list of keys and values, each separated by a colon, and returns a\n+\t\t\tcomma-separated list of the keys, sorted by their values.  Values will be evaluated as\n+\t\t\tfloating-point numbers.</para>\n+    </description>\n+  </function>\n+  <function name=\"CUT\" language=\"en_US\">\n+    <synopsis>Slices and dices strings, based upon a named delimiter.</synopsis>\n+    <syntax>\n+      <parameter name=\"varname\" required=\"true\">\n+        <para>Variable you want cut</para>\n+      </parameter>\n+      <parameter name=\"char-delim\" required=\"true\">\n         <para>\n-          Maybe specified as any number. If negative,\n-          <replaceable>offset</replaceable>\n-          specifies the number\n-\t\t\t\tof bytes back from the end of the file.\n+          Delimiter, defaults to\n+          <literal>-</literal>\n         </para>\n       </parameter>\n-      <parameter name=\"length\">\n+      <parameter name=\"range-spec\" required=\"true\">\n         <para>\n-          If specified, will limit the length of the data read to that size. If negative,\n-\t\t\t\ttrims\n-          <replaceable>length</replaceable>\n-          bytes from the end of the file.\n+          Number of the field you want (1-based offset), may also be specified as a range (with\n+          <literal>-</literal>\n+          )\n+\t\t\t\tor group of ranges and fields (with\n+          <literal>&amp;</literal>\n+          )\n         </para>\n       </parameter>\n-      <parameter name=\"options\">\n-        <optionlist>\n-          <option name=\"l\">\n-            <para>Line mode:  offset and length are assumed to be\n-\t\t\t\t\t\tmeasured in lines, instead of byte offsets.</para>\n-          </option>\n-          <option name=\"a\">\n-            <para>In write mode only, the append option is used to\n-\t\t\t\t\t\tappend to the end of the file, instead of overwriting\n-\t\t\t\t\t\tthe existing file.</para>\n-          </option>\n-          <option name=\"d\">\n-            <para>In write mode and line mode only, this option does\n-\t\t\t\t\t\tnot automatically append a newline string to the end of\n-\t\t\t\t\t\ta value.  This is useful for deleting lines, instead of\n-\t\t\t\t\t\tsetting them to blank.</para>\n-          </option>\n-        </optionlist>\n+    </syntax>\n+    <description>\n+      <para>\n+        Cut out information from a string (\n+        <replaceable>varname</replaceable>\n+        ), based upon a named delimiter.\n+      </para>\n+    </description>\n+  </function>\n+  <module language=\"en_US\" name=\"func_config\">\n+    <support_level>core</support_level>\n+  </module>\n+  <function name=\"AST_CONFIG\" language=\"en_US\">\n+    <synopsis>Retrieve a variable from a configuration file.</synopsis>\n+    <syntax>\n+      <parameter name=\"config_file\" required=\"true\"/>\n+      <parameter name=\"category\" required=\"true\"/>\n+      <parameter name=\"variable_name\" required=\"true\"/>\n+      <parameter name=\"index\" required=\"false\">\n+        <para>\n+          If there are multiple variables with the same name, you can specify\n+          <literal>0</literal>\n+          for the first item (default),\n+          <literal>-1</literal>\n+          for the last\n+\t\t\t\titem, or any other number for that specific item.\n+          <literal>-1</literal>\n+          is useful\n+\t\t\t\twhen the variable is derived from a template and you want the effective value (the last\n+\t\t\t\toccurrence), not the value from the template (the first occurrence).\n+        </para>\n       </parameter>\n-      <parameter name=\"format\">\n+    </syntax>\n+    <description>\n+      <para>This function reads a variable from an Asterisk configuration file.</para>\n+    </description>\n+  </function>\n+  <module language=\"en_US\" name=\"func_sorcery\">\n+    <support_level>core</support_level>\n+  </module>\n+  <function name=\"AST_SORCERY\" language=\"en_US\">\n+    <synopsis>Get a field from a sorcery object</synopsis>\n+    <syntax>\n+      <parameter name=\"module_name\" required=\"true\">\n+        <para>The name of the module owning the sorcery instance.</para>\n+      </parameter>\n+      <parameter name=\"object_type\" required=\"true\">\n+        <para>The type of object to query.</para>\n+      </parameter>\n+      <parameter name=\"object_id\" required=\"true\">\n+        <para>The id of the object to query.</para>\n+      </parameter>\n+      <parameter name=\"field_name\" required=\"true\">\n+        <para>The name of the field.</para>\n+      </parameter>\n+      <parameter name=\"retrieval_method\" required=\"false\">\n+        <para>Fields that have multiple occurrences may be retrieved in two ways.</para>\n+        <enumlist>\n+          <enum name=\"concat\">\n+            <para>\n+              Returns all matching fields concatenated\n+\t\t\t\t\tin a single string separated by\n+              <replaceable>separator</replaceable>\n+              which defaults to\n+              <literal>,</literal>\n+              .\n+            </para>\n+          </enum>\n+          <enum name=\"single\">\n+            <para>\n+              Returns the nth occurrence of the field\n+\t\t\t\t\tas specified by\n+              <replaceable>occurrence_number</replaceable>\n+              which defaults to\n+              <literal>1</literal>\n+              .\n+            </para>\n+          </enum>\n+        </enumlist>\n         <para>\n-          The\n-          <replaceable>format</replaceable>\n-          parameter may be\n-\t\t\t\tused to delimit the type of line terminators in line mode.\n+          The default is\n+          <literal>concat</literal>\n+          with separator\n+          <literal>,</literal>\n+          .\n         </para>\n+      </parameter>\n+      <parameter name=\"retrieval_details\" required=\"false\">\n+        <para>\n+          Specifies either the separator for\n+          <literal>concat</literal>\n+          or the occurrence number for\n+          <literal>single</literal>\n+          .\n+        </para>\n+      </parameter>\n+    </syntax>\n+  </function>\n+  <module language=\"en_US\" name=\"func_cdr\">\n+    <support_level>core</support_level>\n+  </module>\n+  <function name=\"CDR\" language=\"en_US\">\n+    <synopsis>Gets or sets a CDR variable.</synopsis>\n+    <syntax>\n+      <parameter name=\"name\" required=\"true\">\n+        <para>CDR field name:</para>\n+        <enumlist>\n+          <enum name=\"clid\">\n+            <para>Caller ID.</para>\n+          </enum>\n+          <enum name=\"lastdata\">\n+            <para>Last application arguments.</para>\n+          </enum>\n+          <enum name=\"disposition\">\n+            <para>The final state of the CDR.</para>\n+            <enumlist>\n+              <enum name=\"0\">\n+                <para>\n+                  <literal>NO ANSWER</literal>\n+                </para>\n+              </enum>\n+              <enum name=\"1\">\n+                <para>\n+                  <literal>NO ANSWER</literal>\n+                  (NULL record)\n+                </para>\n+              </enum>\n+              <enum name=\"2\">\n+                <para>\n+                  <literal>FAILED</literal>\n+                </para>\n+              </enum>\n+              <enum name=\"4\">\n+                <para>\n+                  <literal>BUSY</literal>\n+                </para>\n+              </enum>\n+              <enum name=\"8\">\n+                <para>\n+                  <literal>ANSWERED</literal>\n+                </para>\n+              </enum>\n+              <enum name=\"16\">\n+                <para>\n+                  <literal>CONGESTION</literal>\n+                </para>\n+              </enum>\n+            </enumlist>\n+          </enum>\n+          <enum name=\"src\">\n+            <para>Source.</para>\n+          </enum>\n+          <enum name=\"start\">\n+            <para>Time the call started.</para>\n+          </enum>\n+          <enum name=\"amaflags\">\n+            <para>R/W the Automatic Message Accounting (AMA) flags on the channel.\n+\t\t\t\t\t\tWhen read from a channel, the integer value will always be returned.\n+\t\t\t\t\t\tWhen written to a channel, both the string format or integer value\n+\t\t\t\t\t\tis accepted.</para>\n+            <enumlist>\n+              <enum name=\"1\">\n+                <para>\n+                  <literal>OMIT</literal>\n+                </para>\n+              </enum>\n+              <enum name=\"2\">\n+                <para>\n+                  <literal>BILLING</literal>\n+                </para>\n+              </enum>\n+              <enum name=\"3\">\n+                <para>\n+                  <literal>DOCUMENTATION</literal>\n+                </para>\n+              </enum>\n+            </enumlist>\n+            <warning>\n+              <para>Accessing this setting is deprecated in CDR. Please use the CHANNEL function instead.</para>\n+            </warning>\n+          </enum>\n+          <enum name=\"dst\">\n+            <para>Destination.</para>\n+          </enum>\n+          <enum name=\"answer\">\n+            <para>Time the call was answered.</para>\n+          </enum>\n+          <enum name=\"accountcode\">\n+            <para>The channel's account code.</para>\n+            <warning>\n+              <para>Accessing this setting is deprecated in CDR. Please use the CHANNEL function instead.</para>\n+            </warning>\n+          </enum>\n+          <enum name=\"dcontext\">\n+            <para>Destination context.</para>\n+          </enum>\n+          <enum name=\"end\">\n+            <para>Time the call ended.</para>\n+          </enum>\n+          <enum name=\"uniqueid\">\n+            <para>The channel's unique id.</para>\n+          </enum>\n+          <enum name=\"dstchannel\">\n+            <para>Destination channel.</para>\n+          </enum>\n+          <enum name=\"duration\">\n+            <para>Duration of the call.</para>\n+          </enum>\n+          <enum name=\"userfield\">\n+            <para>The channel's user specified field.</para>\n+          </enum>\n+          <enum name=\"lastapp\">\n+            <para>Last application.</para>\n+          </enum>\n+          <enum name=\"billsec\">\n+            <para>Duration of the call once it was answered.</para>\n+          </enum>\n+          <enum name=\"channel\">\n+            <para>Channel name.</para>\n+          </enum>\n+          <enum name=\"sequence\">\n+            <para>CDR sequence number.</para>\n+          </enum>\n+        </enumlist>\n+      </parameter>\n+      <parameter name=\"options\" required=\"false\">\n         <optionlist>\n-          <option name=\"u\">\n-            <para>Unix newline format.</para>\n-          </option>\n-          <option name=\"d\">\n-            <para>DOS newline format.</para>\n+          <option name=\"f\">\n+            <para>Returns billsec or duration fields as floating point values.</para>\n           </option>\n-          <option name=\"m\">\n-            <para>Macintosh newline format.</para>\n+          <option name=\"u\">\n+            <para>Retrieves the raw, unprocessed value.</para>\n+            <para>\n+              For example, 'start', 'answer', and 'end' will be retrieved as epoch\n+\t\t\t\t\t\tvalues, when the\n+              <literal>u</literal>\n+              option is passed, but formatted as YYYY-MM-DD HH:MM:SS\n+\t\t\t\t\t\totherwise.  Similarly, disposition and amaflags will return their raw\n+\t\t\t\t\t\tintegral values.\n+            </para>\n           </option>\n         </optionlist>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>Read and write text file in character and line mode.</para>\n-      <para>Examples:</para>\n-      <para>Read mode (byte):</para>\n-      <example title=\"Reads the entire content of the file\">same =&gt; n,Set(foo=${FILE(/tmp/test.txt)})</example>\n-      <example title=\"Reads from the 11th byte to the end of the file (i.e. skips the first 10)\">same =&gt; n,Set(foo=${FILE(/tmp/test.txt,10)})</example>\n-      <example title=\"Reads from the 11th to 20th byte in the file (i.e. skip the first 10, then read 10 bytes)\">same =&gt; n,Set(foo=${FILE(/tmp/test.txt,10,10)})</example>\n-      <para>Read mode (line):</para>\n-      <example title=\"Reads the 3rd line of the file\">same =&gt; n,Set(foo=${FILE(/tmp/test.txt,3,1,l)})</example>\n-      <example title=\"Reads the 3rd and 4th lines of the file\">same =&gt; n,Set(foo=${FILE(/tmp/test.txt,3,2,l)})</example>\n-      <example title=\"Reads from the third line to the end of the file\">same =&gt; n,Set(foo=${FILE(/tmp/test.txt,3,,l)})</example>\n-      <example title=\"Reads the last three lines of the file\">same =&gt; n,Set(foo=${FILE(/tmp/test.txt,-3,,l)})</example>\n-      <example title=\"Reads the 3rd line of a DOS-formatted file\">same =&gt; n,Set(foo=${FILE(/tmp/test.txt,3,1,l,d)})</example>\n-      <para>Write mode (byte):</para>\n-      <example title=\"Truncate the file and write bar\">same =&gt; n,Set(FILE(/tmp/test.txt)=bar)</example>\n-      <example title=\"Append bar\">same =&gt; n,Set(FILE(/tmp/test.txt,,,a)=bar)</example>\n-      <example title=\"Replace the first byte with bar (replaces 1 character with 3)\">same =&gt; n,Set(FILE(/tmp/test.txt,0,1)=bar)</example>\n-      <example title=\"Replace 10 bytes beginning at the 21st byte of the file with bar\">same =&gt; n,Set(FILE(/tmp/test.txt,20,10)=bar)</example>\n-      <example title=\"Replace all bytes from the 21st with bar\">same =&gt; n,Set(FILE(/tmp/test.txt,20)=bar)</example>\n-      <example title=\"Insert bar after the 4th character\">same =&gt; n,Set(FILE(/tmp/test.txt,4,0)=bar)</example>\n-      <para>Write mode (line):</para>\n-      <example title=\"Replace the first line of the file with bar\">same =&gt; n,Set(FILE(/tmp/foo.txt,0,1,l)=bar)</example>\n-      <example title=\"Replace the last line of the file with bar\">same =&gt; n,Set(FILE(/tmp/foo.txt,-1,,l)=bar)</example>\n-      <example title=\"Append bar to the file with a newline\">same =&gt; n,Set(FILE(/tmp/foo.txt,,,al)=bar)</example>\n+      <para>\n+        All of the CDR field names are read-only, except for\n+        <literal>accountcode</literal>\n+        ,\n+        <literal>userfield</literal>\n+        , and\n+        <literal>amaflags</literal>\n+        . You may, however, supply\n+\t\t\ta name not on the above list, and create your own variable, whose value can be changed\n+\t\t\twith this function, and this variable will be stored on the CDR.\n+      </para>\n       <note>\n         <para>\n-          If\n-          <literal>live_dangerously</literal>\n-          in\n-          <literal>asterisk.conf</literal>\n-          is set to\n-          <literal>no</literal>\n-          , this function can only be executed from the\n-\t\t\t\tdialplan, and not directly from external protocols.\n+          CDRs can only be modified before the bridge between two channels is\n+\t\t\ttorn down. For example, CDRs may not be modified after the\n+          <literal>Dial</literal>\n+          application has returned.\n         </para>\n       </note>\n+      <example title=\"Set the userfield\">exten =&gt; 1,1,Set(CDR(userfield)=test)</example>\n     </description>\n-    <see-also>\n-      <ref type=\"function\">FILE_COUNT_LINE</ref>\n-      <ref type=\"function\">FILE_FORMAT</ref>\n-    </see-also>\n   </function>\n-  <function name=\"FILE_COUNT_LINE\" language=\"en_US\">\n-    <synopsis>Obtains the number of lines of a text file.</synopsis>\n+  <function name=\"CDR_PROP\" language=\"en_US\">\n+    <synopsis>Set a property on a channel's CDR.</synopsis>\n     <syntax>\n-      <parameter name=\"filename\" required=\"true\"/>\n-      <parameter name=\"format\">\n-        <para>Format may be one of the following:</para>\n+      <parameter name=\"name\" required=\"true\">\n+        <para>The property to set on the CDR.</para>\n+        <enumlist>\n+          <enum name=\"party_a\">\n+            <para>Set this channel as the preferred Party A when\n+\t\t\t\t\t\tchannels are associated together.</para>\n+            <para>Write-Only</para>\n+          </enum>\n+          <enum name=\"disable\">\n+            <para>Setting to 1 will disable CDRs for this channel.\n+\t\t\t\t\t\tSetting to 0 will enable CDRs for this channel.</para>\n+            <para>Write-Only</para>\n+          </enum>\n+        </enumlist>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>This function sets a property on a channel's CDR. Properties\n+\t\t\talter the behavior of how the CDR operates for that channel.</para>\n+    </description>\n+  </function>\n+  <module language=\"en_US\" name=\"func_volume\">\n+    <support_level>core</support_level>\n+  </module>\n+  <function name=\"VOLUME\" language=\"en_US\">\n+    <synopsis>Set or get the TX or RX volume of a channel.</synopsis>\n+    <syntax>\n+      <parameter name=\"direction\" required=\"true\">\n+        <para>\n+          Must be\n+          <literal>TX</literal>\n+          or\n+          <literal>RX</literal>\n+          .\n+        </para>\n+      </parameter>\n+      <parameter name=\"options\">\n         <optionlist>\n-          <option name=\"u\">\n-            <para>Unix newline format.</para>\n-          </option>\n-          <option name=\"d\">\n-            <para>DOS newline format.</para>\n-          </option>\n-          <option name=\"m\">\n-            <para>Macintosh newline format.</para>\n+          <option name=\"p\">\n+            <para>Enable DTMF volume control</para>\n           </option>\n         </optionlist>\n-        <note>\n-          <para>If not specified, an attempt will be made to determine the newline format type.</para>\n-        </note>\n       </parameter>\n     </syntax>\n     <description>\n       <para>\n-        Returns the number of lines, or\n-        <literal>-1</literal>\n-        on error.\n+        The VOLUME function can be used to increase or decrease the\n+        <literal>tx</literal>\n+        or\n+        <literal>rx</literal>\n+        gain of any channel.\n       </para>\n-      <note>\n+      <example title=\"Increase volume\">same =&gt; n,Set(VOLUME(TX)=3)</example>\n+      <example title=\"Increase volume\">same =&gt; n,Set(VOLUME(RX)=2)</example>\n+      <example title=\"Increase volume with DTMF control\">same =&gt; n,Set(VOLUME(TX,p)=3)</example>\n+      <example title=\"Increase RX volume with DTMF control\">same =&gt; n,Set(VOLUME(RX,p)=3)</example>\n+      <example title=\"Decrease RX volume\">same =&gt; n,Set(VOLUME(RX)=-4)</example>\n+      <example title=\"Reset to normal\">same =&gt; n,Set(VOLUME(RX)=0)</example>\n+    </description>\n+  </function>\n+  <module language=\"en_US\" name=\"func_timeout\">\n+    <support_level>core</support_level>\n+  </module>\n+  <function name=\"TIMEOUT\" language=\"en_US\">\n+    <synopsis>Gets or sets timeouts on the channel. Timeout values are in seconds.</synopsis>\n+    <syntax>\n+      <parameter name=\"timeouttype\" required=\"true\">\n         <para>\n-          If\n-          <literal>live_dangerously</literal>\n-          in\n-          <literal>asterisk.conf</literal>\n-          is set to\n-          <literal>no</literal>\n-          , this function can only be executed from the\n-\t\t\t\tdialplan, and not directly from external protocols.\n+          The timeout that will be manipulated. The possible timeout types\n+\t\t\t\tare:\n+          <literal>absolute</literal>\n+          ,\n+          <literal>digit</literal>\n+          or\n+          <literal>response</literal>\n         </para>\n-      </note>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>The timeouts that can be manipulated are:</para>\n+      <para>\n+        <literal>absolute</literal>\n+        : The absolute maximum amount of time permitted for a call.\n+\t\t\tSetting of 0 disables the timeout.\n+      </para>\n+      <para>\n+        <literal>digit</literal>\n+        : The maximum amount of time permitted between digits when the\n+\t\t\tuser is typing in an extension.  When this timeout expires,\n+\t\t\tafter the user has started to type in an extension, the\n+\t\t\textension will be considered complete, and will be\n+\t\t\tinterpreted.  Note that if an extension typed in is valid,\n+\t\t\tit will not have to timeout to be tested, so typically at\n+\t\t\tthe expiry of this timeout, the extension will be considered\n+\t\t\tinvalid (and thus control would be passed to the\n+        <literal>i</literal>\n+        extension, or if it doesn't exist the call would be\n+\t\t\tterminated).  The default timeout is 5 seconds.\n+      </para>\n+      <para>\n+        <literal>response</literal>\n+        : The maximum amount of time permitted after falling through a\n+\t\t\tseries of priorities for a channel in which the user may\n+\t\t\tbegin typing an extension.  If the user does not type an\n+\t\t\textension in this amount of time, control will pass to the\n+        <literal>t</literal>\n+        extension if it exists, and if not the call would be\n+\t\t\tterminated.  The default timeout is 10 seconds.\n+      </para>\n     </description>\n-    <see-also>\n-      <ref type=\"function\">FILE</ref>\n-      <ref type=\"function\">FILE_FORMAT</ref>\n-    </see-also>\n   </function>\n-  <function name=\"FILE_FORMAT\" language=\"en_US\">\n-    <synopsis>Return the newline format of a text file.</synopsis>\n+  <module language=\"en_US\" name=\"func_callerid\">\n+    <support_level>core</support_level>\n+  </module>\n+  <function name=\"CALLERID\" language=\"en_US\">\n+    <synopsis>Gets or sets Caller*ID data on the channel.</synopsis>\n     <syntax>\n-      <parameter name=\"filename\" required=\"true\"/>\n+      <parameter name=\"datatype\" required=\"true\">\n+        <para>The allowable datatypes are:</para>\n+        <enumlist>\n+          <enum name=\"all\"/>\n+          <enum name=\"name\"/>\n+          <enum name=\"name-valid\"/>\n+          <enum name=\"name-charset\"/>\n+          <enum name=\"name-pres\"/>\n+          <enum name=\"num\"/>\n+          <enum name=\"num-valid\"/>\n+          <enum name=\"num-plan\"/>\n+          <enum name=\"num-pres\"/>\n+          <enum name=\"pres\"/>\n+          <enum name=\"subaddr\"/>\n+          <enum name=\"subaddr-valid\"/>\n+          <enum name=\"subaddr-type\"/>\n+          <enum name=\"subaddr-odd\"/>\n+          <enum name=\"tag\"/>\n+          <enum name=\"priv-all\"/>\n+          <enum name=\"priv-name\"/>\n+          <enum name=\"priv-name-valid\"/>\n+          <enum name=\"priv-name-charset\"/>\n+          <enum name=\"priv-name-pres\"/>\n+          <enum name=\"priv-num\"/>\n+          <enum name=\"priv-num-valid\"/>\n+          <enum name=\"priv-num-plan\"/>\n+          <enum name=\"priv-num-pres\"/>\n+          <enum name=\"priv-subaddr\"/>\n+          <enum name=\"priv-subaddr-valid\"/>\n+          <enum name=\"priv-subaddr-type\"/>\n+          <enum name=\"priv-subaddr-odd\"/>\n+          <enum name=\"priv-tag\"/>\n+          <enum name=\"ANI-all\"/>\n+          <enum name=\"ANI-name\"/>\n+          <enum name=\"ANI-name-valid\"/>\n+          <enum name=\"ANI-name-charset\"/>\n+          <enum name=\"ANI-name-pres\"/>\n+          <enum name=\"ANI-num\"/>\n+          <enum name=\"ANI-num-valid\"/>\n+          <enum name=\"ANI-num-plan\"/>\n+          <enum name=\"ANI-num-pres\"/>\n+          <enum name=\"ANI-tag\"/>\n+          <enum name=\"RDNIS\"/>\n+          <enum name=\"DNID\"/>\n+          <enum name=\"dnid-num-plan\"/>\n+          <enum name=\"dnid-subaddr\"/>\n+          <enum name=\"dnid-subaddr-valid\"/>\n+          <enum name=\"dnid-subaddr-type\"/>\n+          <enum name=\"dnid-subaddr-odd\"/>\n+        </enumlist>\n+      </parameter>\n+      <parameter name=\"CID\">\n+        <para>Optional Caller*ID to parse instead of using the Caller*ID from the\n+\t\t\t\tchannel. This parameter is only optional when reading the Caller*ID.</para>\n+      </parameter>\n     </syntax>\n     <description>\n-      <para>Return the line terminator type:</para>\n-      <para>'u' - Unix &quot;\\n&quot; format</para>\n-      <para>'d' - DOS &quot;\\r\\n&quot; format</para>\n-      <para>'m' - Macintosh &quot;\\r&quot; format</para>\n-      <para>'x' - Cannot be determined</para>\n+      <para>Gets or sets Caller*ID data on the channel. Uses channel callerid by\n+\t\t\tdefault or optional callerid, if specified.</para>\n+      <para>\n+        The\n+        <replaceable>pres</replaceable>\n+        field gets/sets a combined value\n+\t\t\tfor\n+        <replaceable>name-pres</replaceable>\n+        and\n+        <replaceable>num-pres</replaceable>\n+        .\n+      </para>\n+      <para>\n+        The allowable values for the\n+        <replaceable>name-charset</replaceable>\n+        field are the following:\n+      </para>\n+      <enumlist>\n+        <enum name=\"unknown\">\n+          <para>Unknown</para>\n+        </enum>\n+        <enum name=\"iso8859-1\">\n+          <para>ISO8859-1</para>\n+        </enum>\n+        <enum name=\"withdrawn\">\n+          <para>Withdrawn</para>\n+        </enum>\n+        <enum name=\"iso8859-2\">\n+          <para>ISO8859-2</para>\n+        </enum>\n+        <enum name=\"iso8859-3\">\n+          <para>ISO8859-3</para>\n+        </enum>\n+        <enum name=\"iso8859-4\">\n+          <para>ISO8859-4</para>\n+        </enum>\n+        <enum name=\"iso8859-5\">\n+          <para>ISO8859-5</para>\n+        </enum>\n+        <enum name=\"iso8859-7\">\n+          <para>ISO8859-7</para>\n+        </enum>\n+        <enum name=\"bmp\">\n+          <para>ISO10646 Bmp String</para>\n+        </enum>\n+        <enum name=\"utf8\">\n+          <para>ISO10646 UTF-8 String</para>\n+        </enum>\n+      </enumlist>\n+    </description>\n+  </function>\n+  <function name=\"CALLERPRES\" language=\"en_US\">\n+    <synopsis>Gets or sets Caller*ID presentation on the channel.</synopsis>\n+    <syntax/>\n+    <description>\n+      <para>Gets or sets Caller*ID presentation on the channel.\n+\t\t\tThis function is deprecated in favor of CALLERID(num-pres)\n+\t\t\tand CALLERID(name-pres) or CALLERID(pres) to get/set both\n+\t\t\tat once.\n+\t\t\tThe following values are valid:</para>\n+      <enumlist>\n+        <enum name=\"allowed_not_screened\">\n+          <para>Presentation Allowed, Not Screened.</para>\n+        </enum>\n+        <enum name=\"allowed_passed_screen\">\n+          <para>Presentation Allowed, Passed Screen.</para>\n+        </enum>\n+        <enum name=\"allowed_failed_screen\">\n+          <para>Presentation Allowed, Failed Screen.</para>\n+        </enum>\n+        <enum name=\"allowed\">\n+          <para>Presentation Allowed, Network Number.</para>\n+        </enum>\n+        <enum name=\"prohib_not_screened\">\n+          <para>Presentation Prohibited, Not Screened.</para>\n+        </enum>\n+        <enum name=\"prohib_passed_screen\">\n+          <para>Presentation Prohibited, Passed Screen.</para>\n+        </enum>\n+        <enum name=\"prohib_failed_screen\">\n+          <para>Presentation Prohibited, Failed Screen.</para>\n+        </enum>\n+        <enum name=\"prohib\">\n+          <para>Presentation Prohibited, Network Number.</para>\n+        </enum>\n+        <enum name=\"unavailable\">\n+          <para>Number Unavailable.</para>\n+        </enum>\n+      </enumlist>\n+    </description>\n+  </function>\n+  <function name=\"CONNECTEDLINE\" language=\"en_US\">\n+    <synopsis>Gets or sets Connected Line data on the channel.</synopsis>\n+    <syntax>\n+      <parameter name=\"datatype\" required=\"true\">\n+        <para>The allowable datatypes are:</para>\n+        <enumlist>\n+          <enum name=\"all\"/>\n+          <enum name=\"name\"/>\n+          <enum name=\"name-valid\"/>\n+          <enum name=\"name-charset\"/>\n+          <enum name=\"name-pres\"/>\n+          <enum name=\"num\"/>\n+          <enum name=\"num-valid\"/>\n+          <enum name=\"num-plan\"/>\n+          <enum name=\"num-pres\"/>\n+          <enum name=\"pres\"/>\n+          <enum name=\"subaddr\"/>\n+          <enum name=\"subaddr-valid\"/>\n+          <enum name=\"subaddr-type\"/>\n+          <enum name=\"subaddr-odd\"/>\n+          <enum name=\"tag\"/>\n+          <enum name=\"priv-all\"/>\n+          <enum name=\"priv-name\"/>\n+          <enum name=\"priv-name-valid\"/>\n+          <enum name=\"priv-name-charset\"/>\n+          <enum name=\"priv-name-pres\"/>\n+          <enum name=\"priv-num\"/>\n+          <enum name=\"priv-num-valid\"/>\n+          <enum name=\"priv-num-plan\"/>\n+          <enum name=\"priv-num-pres\"/>\n+          <enum name=\"priv-subaddr\"/>\n+          <enum name=\"priv-subaddr-valid\"/>\n+          <enum name=\"priv-subaddr-type\"/>\n+          <enum name=\"priv-subaddr-odd\"/>\n+          <enum name=\"priv-tag\"/>\n+        </enumlist>\n+      </parameter>\n+      <parameter name=\"i\">\n+        <para>If set, this will prevent the channel from sending out protocol\n+\t\t\t\tmessages because of the value being set</para>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>Gets or sets Connected Line data on the channel.</para>\n+      <para>\n+        The\n+        <replaceable>pres</replaceable>\n+        field gets/sets a combined value\n+\t\t\tfor\n+        <replaceable>name-pres</replaceable>\n+        and\n+        <replaceable>num-pres</replaceable>\n+        .\n+      </para>\n+      <para>\n+        The allowable values for the\n+        <replaceable>name-charset</replaceable>\n+        field are the following:\n+      </para>\n+      <enumlist>\n+        <enum name=\"unknown\">\n+          <para>Unknown</para>\n+        </enum>\n+        <enum name=\"iso8859-1\">\n+          <para>ISO8859-1</para>\n+        </enum>\n+        <enum name=\"withdrawn\">\n+          <para>Withdrawn</para>\n+        </enum>\n+        <enum name=\"iso8859-2\">\n+          <para>ISO8859-2</para>\n+        </enum>\n+        <enum name=\"iso8859-3\">\n+          <para>ISO8859-3</para>\n+        </enum>\n+        <enum name=\"iso8859-4\">\n+          <para>ISO8859-4</para>\n+        </enum>\n+        <enum name=\"iso8859-5\">\n+          <para>ISO8859-5</para>\n+        </enum>\n+        <enum name=\"iso8859-7\">\n+          <para>ISO8859-7</para>\n+        </enum>\n+        <enum name=\"bmp\">\n+          <para>ISO10646 Bmp String</para>\n+        </enum>\n+        <enum name=\"utf8\">\n+          <para>ISO10646 UTF-8 String</para>\n+        </enum>\n+      </enumlist>\n+    </description>\n+  </function>\n+  <function name=\"REDIRECTING\" language=\"en_US\">\n+    <synopsis>Gets or sets Redirecting data on the channel.</synopsis>\n+    <syntax>\n+      <parameter name=\"datatype\" required=\"true\">\n+        <para>The allowable datatypes are:</para>\n+        <enumlist>\n+          <enum name=\"orig-all\"/>\n+          <enum name=\"orig-name\"/>\n+          <enum name=\"orig-name-valid\"/>\n+          <enum name=\"orig-name-charset\"/>\n+          <enum name=\"orig-name-pres\"/>\n+          <enum name=\"orig-num\"/>\n+          <enum name=\"orig-num-valid\"/>\n+          <enum name=\"orig-num-plan\"/>\n+          <enum name=\"orig-num-pres\"/>\n+          <enum name=\"orig-pres\"/>\n+          <enum name=\"orig-subaddr\"/>\n+          <enum name=\"orig-subaddr-valid\"/>\n+          <enum name=\"orig-subaddr-type\"/>\n+          <enum name=\"orig-subaddr-odd\"/>\n+          <enum name=\"orig-tag\"/>\n+          <enum name=\"orig-reason\"/>\n+          <enum name=\"from-all\"/>\n+          <enum name=\"from-name\"/>\n+          <enum name=\"from-name-valid\"/>\n+          <enum name=\"from-name-charset\"/>\n+          <enum name=\"from-name-pres\"/>\n+          <enum name=\"from-num\"/>\n+          <enum name=\"from-num-valid\"/>\n+          <enum name=\"from-num-plan\"/>\n+          <enum name=\"from-num-pres\"/>\n+          <enum name=\"from-pres\"/>\n+          <enum name=\"from-subaddr\"/>\n+          <enum name=\"from-subaddr-valid\"/>\n+          <enum name=\"from-subaddr-type\"/>\n+          <enum name=\"from-subaddr-odd\"/>\n+          <enum name=\"from-tag\"/>\n+          <enum name=\"to-all\"/>\n+          <enum name=\"to-name\"/>\n+          <enum name=\"to-name-valid\"/>\n+          <enum name=\"to-name-charset\"/>\n+          <enum name=\"to-name-pres\"/>\n+          <enum name=\"to-num\"/>\n+          <enum name=\"to-num-valid\"/>\n+          <enum name=\"to-num-plan\"/>\n+          <enum name=\"to-num-pres\"/>\n+          <enum name=\"to-pres\"/>\n+          <enum name=\"to-subaddr\"/>\n+          <enum name=\"to-subaddr-valid\"/>\n+          <enum name=\"to-subaddr-type\"/>\n+          <enum name=\"to-subaddr-odd\"/>\n+          <enum name=\"to-tag\"/>\n+          <enum name=\"priv-orig-all\"/>\n+          <enum name=\"priv-orig-name\"/>\n+          <enum name=\"priv-orig-name-valid\"/>\n+          <enum name=\"priv-orig-name-charset\"/>\n+          <enum name=\"priv-orig-name-pres\"/>\n+          <enum name=\"priv-orig-num\"/>\n+          <enum name=\"priv-orig-num-valid\"/>\n+          <enum name=\"priv-orig-num-plan\"/>\n+          <enum name=\"priv-orig-num-pres\"/>\n+          <enum name=\"priv-orig-subaddr\"/>\n+          <enum name=\"priv-orig-subaddr-valid\"/>\n+          <enum name=\"priv-orig-subaddr-type\"/>\n+          <enum name=\"priv-orig-subaddr-odd\"/>\n+          <enum name=\"priv-orig-tag\"/>\n+          <enum name=\"priv-from-all\"/>\n+          <enum name=\"priv-from-name\"/>\n+          <enum name=\"priv-from-name-valid\"/>\n+          <enum name=\"priv-from-name-charset\"/>\n+          <enum name=\"priv-from-name-pres\"/>\n+          <enum name=\"priv-from-num\"/>\n+          <enum name=\"priv-from-num-valid\"/>\n+          <enum name=\"priv-from-num-plan\"/>\n+          <enum name=\"priv-from-num-pres\"/>\n+          <enum name=\"priv-from-subaddr\"/>\n+          <enum name=\"priv-from-subaddr-valid\"/>\n+          <enum name=\"priv-from-subaddr-type\"/>\n+          <enum name=\"priv-from-subaddr-odd\"/>\n+          <enum name=\"priv-from-tag\"/>\n+          <enum name=\"priv-to-all\"/>\n+          <enum name=\"priv-to-name\"/>\n+          <enum name=\"priv-to-name-valid\"/>\n+          <enum name=\"priv-to-name-charset\"/>\n+          <enum name=\"priv-to-name-pres\"/>\n+          <enum name=\"priv-to-num\"/>\n+          <enum name=\"priv-to-num-valid\"/>\n+          <enum name=\"priv-to-num-plan\"/>\n+          <enum name=\"priv-to-num-pres\"/>\n+          <enum name=\"priv-to-subaddr\"/>\n+          <enum name=\"priv-to-subaddr-valid\"/>\n+          <enum name=\"priv-to-subaddr-type\"/>\n+          <enum name=\"priv-to-subaddr-odd\"/>\n+          <enum name=\"priv-to-tag\"/>\n+          <enum name=\"reason\"/>\n+          <enum name=\"count\"/>\n+        </enumlist>\n+      </parameter>\n+      <parameter name=\"i\">\n+        <para>If set, this will prevent the channel from sending out protocol\n+\t\t\t\tmessages because of the value being set</para>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>Gets or sets Redirecting data on the channel.</para>\n+      <para>\n+        The\n+        <replaceable>orig-pres</replaceable>\n+        ,\n+        <replaceable>from-pres</replaceable>\n+        and\n+        <replaceable>to-pres</replaceable>\n+        fields get/set a combined value for the corresponding\n+        <replaceable>...-name-pres</replaceable>\n+        and\n+        <replaceable>...-num-pres</replaceable>\n+        fields.\n+      </para>\n+      <para>\n+        The recognized values for the\n+        <replaceable>reason</replaceable>\n+        and\n+        <replaceable>orig-reason</replaceable>\n+        fields are the following:\n+      </para>\n+      <enumlist>\n+        <enum name=\"away\">\n+          <para>Callee is Away</para>\n+        </enum>\n+        <enum name=\"cf_dte\">\n+          <para>Call Forwarding By The Called DTE</para>\n+        </enum>\n+        <enum name=\"cfb\">\n+          <para>Call Forwarding Busy</para>\n+        </enum>\n+        <enum name=\"cfnr\">\n+          <para>Call Forwarding No Reply</para>\n+        </enum>\n+        <enum name=\"cfu\">\n+          <para>Call Forwarding Unconditional</para>\n+        </enum>\n+        <enum name=\"deflection\">\n+          <para>Call Deflection</para>\n+        </enum>\n+        <enum name=\"dnd\">\n+          <para>Do Not Disturb</para>\n+        </enum>\n+        <enum name=\"follow_me\">\n+          <para>Follow Me</para>\n+        </enum>\n+        <enum name=\"out_of_order\">\n+          <para>Called DTE Out-Of-Order</para>\n+        </enum>\n+        <enum name=\"send_to_vm\">\n+          <para>Send the call to voicemail</para>\n+        </enum>\n+        <enum name=\"time_of_day\">\n+          <para>Time of Day</para>\n+        </enum>\n+        <enum name=\"unavailable\">\n+          <para>Callee is Unavailable</para>\n+        </enum>\n+        <enum name=\"unknown\">\n+          <para>Unknown</para>\n+        </enum>\n+      </enumlist>\n       <note>\n-        <para>\n-          If\n-          <literal>live_dangerously</literal>\n-          in\n-          <literal>asterisk.conf</literal>\n-          is set to\n-          <literal>no</literal>\n-          , this function can only be executed from the\n-\t\t\t\tdialplan, and not directly from external protocols.\n-        </para>\n+        <para>You can set a user defined reason string that SIP can\n+\t\t\tsend/receive instead.  The user defined reason string my need to be\n+\t\t\tquoted depending upon SIP or the peer's requirements.  These strings\n+\t\t\tare treated as unknown by the non-SIP channel drivers.</para>\n       </note>\n+      <para>\n+        The allowable values for the\n+        <replaceable>xxx-name-charset</replaceable>\n+        field are the following:\n+      </para>\n+      <enumlist>\n+        <enum name=\"unknown\">\n+          <para>Unknown</para>\n+        </enum>\n+        <enum name=\"iso8859-1\">\n+          <para>ISO8859-1</para>\n+        </enum>\n+        <enum name=\"withdrawn\">\n+          <para>Withdrawn</para>\n+        </enum>\n+        <enum name=\"iso8859-2\">\n+          <para>ISO8859-2</para>\n+        </enum>\n+        <enum name=\"iso8859-3\">\n+          <para>ISO8859-3</para>\n+        </enum>\n+        <enum name=\"iso8859-4\">\n+          <para>ISO8859-4</para>\n+        </enum>\n+        <enum name=\"iso8859-5\">\n+          <para>ISO8859-5</para>\n+        </enum>\n+        <enum name=\"iso8859-7\">\n+          <para>ISO8859-7</para>\n+        </enum>\n+        <enum name=\"bmp\">\n+          <para>ISO10646 Bmp String</para>\n+        </enum>\n+        <enum name=\"utf8\">\n+          <para>ISO10646 UTF-8 String</para>\n+        </enum>\n+      </enumlist>\n     </description>\n-    <see-also>\n-      <ref type=\"function\">FILE</ref>\n-      <ref type=\"function\">FILE_COUNT_LINE</ref>\n-    </see-also>\n   </function>\n-  <function name=\"BASENAME\" language=\"en_US\">\n-    <since>\n-      <version>16.21.0</version>\n-      <version>18.7.0</version>\n-      <version>19.0.0</version>\n-    </since>\n-    <synopsis>Return the name of a file.</synopsis>\n+  <module language=\"en_US\" name=\"func_module\">\n+    <support_level>core</support_level>\n+  </module>\n+  <function name=\"IFMODULE\" language=\"en_US\">\n+    <synopsis>Checks if an Asterisk module is loaded in memory.</synopsis>\n     <syntax>\n-      <parameter name=\"filename\" required=\"true\"/>\n+      <parameter name=\"modulename.so\" required=\"true\">\n+        <para>\n+          Module name complete with\n+          <literal>.so</literal>\n+        </para>\n+      </parameter>\n     </syntax>\n     <description>\n-      <para>Return the base file name, given a full file path.</para>\n-      <example title=\"Directory name\">same =&gt; n,Set(basename=${BASENAME(/etc/asterisk/extensions.conf)})\n-\t\t\tsame =&gt; n,NoOp(${basename}) ; outputs extensions.conf</example>\n+      <para>\n+        Checks if a module is loaded. Use the full module name\n+\t\t\tas shown by the list in\n+        <literal>module list</literal>\n+        .\n+\t\t\tReturns\n+        <literal>1</literal>\n+        if module exists in memory, otherwise\n+        <literal>0</literal>\n+      </para>\n     </description>\n-    <see-also>\n-      <ref type=\"function\">DIRNAME</ref>\n-    </see-also>\n   </function>\n-  <function name=\"DIRNAME\" language=\"en_US\">\n-    <since>\n-      <version>16.21.0</version>\n-      <version>18.7.0</version>\n-      <version>19.0.0</version>\n-    </since>\n-    <synopsis>Return the directory of a file.</synopsis>\n+  <module language=\"en_US\" name=\"func_evalexten\">\n+    <support_level>extended</support_level>\n+  </module>\n+  <function name=\"EVAL_EXTEN\" language=\"en_US\">\n+    <synopsis>Evaluates the contents of a dialplan extension and returns it as a string.</synopsis>\n     <syntax>\n-      <parameter name=\"filename\" required=\"true\"/>\n+      <parameter name=\"context\"/>\n+      <parameter name=\"extensions\"/>\n+      <parameter name=\"priority\" required=\"true\"/>\n     </syntax>\n     <description>\n-      <para>Return the directory of a file, given a full file path.</para>\n-      <example title=\"Directory name\">same =&gt; n,Set(dirname=${DIRNAME(/etc/asterisk/extensions.conf)})\n-\t\t\tsame =&gt; n,NoOp(${dirname}) ; outputs /etc/asterisk</example>\n+      <para>The EVAL_EXTEN function looks up a dialplan entry by context,extension,priority,\n+\t\t\tevaluates the contents of a Return statement to resolve any variable or function\n+\t\t\treferences, and returns the result as a string.</para>\n+      <para>You can use this function to create simple user-defined lookup tables or\n+\t\t\tuser-defined functions.</para>\n+      <example title=\"Custom dialplan functions\">[call-types]\n+\t\t\texten =&gt; _1NNN,1,Return(internal)\n+\t\t\texten =&gt; _NXXNXXXXXX,1,Return(external)\n+\n+\t\t\t[udf]\n+\t\t\texten =&gt; calleridlen,1,Return(${LEN(${CALLERID(num)})})\n+\n+\t\t\t[default]\n+\t\t\texten =&gt; _X!,1,Verbose(Call type ${EVAL_EXTEN(call-types,${EXTEN},1)} - ${EVAL_EXTEN(udf,calleridlen,1)})</example>\n+      <para>\n+        Any variables in the evaluated data will be resolved in the context of\n+\t\t\tthat extension. For example,\n+        <literal>${EXTEN}</literal>\n+        would refer to the\n+\t\t\tEVAL_EXTEN extension, not the extension in the context invoking the function.\n+\t\t\tThis behavior is similar to other applications, e.g.\n+        <literal>Gosub</literal>\n+        .\n+      </para>\n+      <example title=\"Choosing which prompt to use\">same =&gt; n,Read(input,${EVAL_EXTEN(prompts,${CALLERID(num)},1)})\n+\n+\t\t\t[prompts]\n+\t\t\texten =&gt; _X!,1,Return(default)\n+\t\t\texten =&gt; _20X,1,Return(welcome)\n+\t\t\texten =&gt; _2XX,1,Return(${DB(promptsettings/${EXTEN})})\n+\t\t\texten =&gt; _3XX,1,Return(${ODBC_MYFUNC(${EXTEN})})</example>\n+      <para>Extensions on which EVAL_EXTEN is invoked are not different from other\n+\t\t\textensions. However, the application at that extension is not executed.\n+\t\t\tOnly the application data is parsed and evaluated.</para>\n+      <para>A limitation of this function is that the application at the specified\n+\t\t\textension isn't actually executed, and thus unlike a Gosub, you can't pass\n+\t\t\targuments in the EVAL_EXTEN function.</para>\n     </description>\n     <see-also>\n-      <ref type=\"function\">BASENAME</ref>\n+      <ref type=\"function\">EVAL</ref>\n     </see-also>\n   </function>\n-  <module language=\"en_US\" name=\"func_vmcount\">\n+  <module language=\"en_US\" name=\"func_speex\">\n+    <depend>speex</depend>\n+    <depend>speex_preprocess</depend>\n+    <use type=\"external\">speexdsp</use>\n     <support_level>core</support_level>\n   </module>\n-  <function name=\"VMCOUNT\" language=\"en_US\">\n-    <synopsis>Count the voicemails in a specified mailbox or mailboxes.</synopsis>\n+  <function name=\"AGC\" language=\"en_US\">\n+    <synopsis>Apply automatic gain control to audio on a channel.</synopsis>\n     <syntax>\n-      <parameter name=\"vmbox\" required=\"true\" argsep=\"&amp;\">\n-        <para>A mailbox or list of mailboxes</para>\n+      <parameter name=\"channeldirection\" required=\"true\">\n+        <para>\n+          This can be either\n+          <literal>rx</literal>\n+          or\n+          <literal>tx</literal>\n+        </para>\n       </parameter>\n-      <parameter name=\"folder\" required=\"false\">\n+    </syntax>\n+    <description>\n+      <para>\n+        The AGC function will apply automatic gain control to the audio on the\n+\t\t\tchannel that it is executed on. Using\n+        <literal>rx</literal>\n+        for audio received\n+\t\t\tand\n+        <literal>tx</literal>\n+        for audio transmitted to the channel. When using this\n+\t\t\tfunction you set a target audio level. It is primarily intended for use with\n+\t\t\tanalog lines, but could be useful for other channels as well. The target volume\n+\t\t\tis set with a number between\n+        <literal>1-32768</literal>\n+        . The larger the number\n+\t\t\tthe louder (more gain) the channel will receive.\n+      </para>\n+      <example title=\"Apply automatic gain control\">exten =&gt; 1,1,Set(AGC(rx)=8000)\n+\t\t\texten =&gt; 1,2,Set(AGC(tx)=off)</example>\n+    </description>\n+  </function>\n+  <function name=\"DENOISE\" language=\"en_US\">\n+    <synopsis>Apply noise reduction to audio on a channel.</synopsis>\n+    <syntax>\n+      <parameter name=\"channeldirection\" required=\"true\">\n         <para>\n-          If not specified, defaults to\n-          <literal>INBOX</literal>\n+          This can be either\n+          <literal>rx</literal>\n+          or\n+          <literal>tx</literal>\n+          the values that can be set to this are either\n+          <literal>on</literal>\n+          and\n+          <literal>off</literal>\n         </para>\n       </parameter>\n     </syntax>\n     <description>\n       <para>\n-        Count the number of voicemails in a specified mailbox, you could also specify\n-\t\t\tthe mailbox\n-        <replaceable>folder</replaceable>\n-        .\n+        The DENOISE function will apply noise reduction to audio on the channel\n+\t\t\tthat it is executed on. It is very useful for noisy analog lines, especially\n+\t\t\twhen adjusting gains or using AGC. Use\n+        <literal>rx</literal>\n+        for audio received from the channel\n+\t\t\tand\n+        <literal>tx</literal>\n+        to apply the filter to the audio being sent to the channel.\n       </para>\n-      <example title=\"Mailbox folder count\">exten =&gt; s,1,Set(foo=${VMCOUNT(125@default)})</example>\n-      <para>An ampersand-separated list of mailboxes may be specified to count voicemails in\n-\t\t\tmultiple mailboxes. If a folder is specified, this will apply to all mailboxes specified.</para>\n-      <example title=\"Multiple mailbox inbox count\">same =&gt; n,NoOp(${VMCOUNT(1234@default&amp;1235@default&amp;1236@default,INBOX)})</example>\n+      <example title=\"Apply noise reduction\">exten =&gt; 1,1,Set(DENOISE(rx)=on)\n+\t\t\texten =&gt; 1,2,Set(DENOISE(tx)=off)</example>\n     </description>\n   </function>\n-  <module language=\"en_US\" name=\"func_periodic_hook\">\n-    <depend>app_chanspy</depend>\n-    <depend>func_cut</depend>\n-    <depend>func_groupcount</depend>\n-    <depend>func_uri</depend>\n+  <module language=\"en_US\" name=\"func_holdintercept\">\n     <support_level>core</support_level>\n   </module>\n-  <function name=\"PERIODIC_HOOK\" language=\"en_US\">\n-    <synopsis>Execute a periodic dialplan hook into the audio of a call.</synopsis>\n+  <function name=\"HOLD_INTERCEPT\" language=\"en_US\">\n+    <synopsis>Intercepts hold frames on a channel and raises an event instead of passing the frame on</synopsis>\n     <syntax>\n-      <parameter name=\"context\" required=\"true\">\n-        <para>(On Read Only) Context for the hook extension.</para>\n+      <parameter name=\"action\" required=\"true\">\n+        <optionlist>\n+          <option name=\"remove\">\n+            <para>W/O. Removes the hold interception function.</para>\n+          </option>\n+          <option name=\"set\">\n+            <para>W/O. Enable hold interception on the channel. When\n+\t\t\t\t\t\tenabled, the channel will intercept any hold action that\n+\t\t\t\t\t\tis signalled from the device, and instead simply raise an\n+\t\t\t\t\t\tevent (AMI/ARI) indicating that the channel wanted to put other\n+\t\t\t\t\t\tparties on hold.</para>\n+          </option>\n+        </optionlist>\n       </parameter>\n-      <parameter name=\"extension\" required=\"true\">\n-        <para>(On Read Only) The hook extension.</para>\n+    </syntax>\n+  </function>\n+  <module language=\"en_US\" name=\"func_frame_trace\">\n+    <support_level>extended</support_level>\n+  </module>\n+  <function name=\"FRAME_TRACE\" language=\"en_US\">\n+    <synopsis>View internal ast_frames as they are read and written on a channel.</synopsis>\n+    <syntax>\n+      <parameter name=\"filter list type\" required=\"true\">\n+        <para>\n+          A filter can be applied to the trace to limit what frames are viewed.  This\n+\t\t\t\tfilter can either be a\n+          <literal>white</literal>\n+          or\n+          <literal>black</literal>\n+          list\n+\t\t\t\tof frame types.  When no filter type is present,\n+          <literal>white</literal>\n+          is\n+\t\t\t\tused.  If no arguments are provided at all, all frames will be output.\n+        </para>\n+        <para>Below are the different types of frames that can be filtered.</para>\n+        <enumlist>\n+          <enum name=\"DTMF_BEGIN\"/>\n+          <enum name=\"DTMF_END\"/>\n+          <enum name=\"VOICE\"/>\n+          <enum name=\"VIDEO\"/>\n+          <enum name=\"CONTROL\"/>\n+          <enum name=\"NULL\"/>\n+          <enum name=\"IAX\"/>\n+          <enum name=\"TEXT\"/>\n+          <enum name=\"TEXT_DATA\"/>\n+          <enum name=\"IMAGE\"/>\n+          <enum name=\"HTML\"/>\n+          <enum name=\"CNG\"/>\n+          <enum name=\"MODEM\"/>\n+        </enumlist>\n       </parameter>\n-      <parameter name=\"interval\" required=\"true\">\n-        <para>(On Read Only) Number of seconds in between hook runs.\n-\t\t\t\tWhole seconds only.</para>\n+    </syntax>\n+    <description>\n+      <para>Examples:</para>\n+      <example title=\"View only DTMF frames\">exten =&gt; 1,1,Set(FRAME_TRACE(white)=DTMF_BEGIN,DTMF_END)</example>\n+      <example title=\"View only DTMF frames\">exten =&gt; 1,1,Set(FRAME_TRACE()=DTMF_BEGIN,DTMF_END)</example>\n+      <example title=\"View everything except DTMF frames\">exten =&gt; 1,1,Set(FRAME_TRACE(black)=DTMF_BEGIN,DTMF_END)</example>\n+    </description>\n+  </function>\n+  <module language=\"en_US\" name=\"func_version\">\n+    <support_level>core</support_level>\n+  </module>\n+  <function name=\"VERSION\" language=\"en_US\">\n+    <synopsis>Return the Version info for this Asterisk.</synopsis>\n+    <syntax>\n+      <parameter name=\"info\">\n+        <para>The possible values are:</para>\n+        <enumlist>\n+          <enum name=\"ASTERISK_VERSION_NUM\">\n+            <para>A string of digits is returned, e.g. 10602 for 1.6.2 or 100300 for 10.3.0,\n+\t\t\t\t\t\tor 999999 when using a Git build.</para>\n+          </enum>\n+          <enum name=\"BUILD_USER\">\n+            <para>The string representing the user's name whose account\n+\t\t\t\t\t\twas used to configure Asterisk, is returned.</para>\n+          </enum>\n+          <enum name=\"BUILD_HOSTNAME\">\n+            <para>The string representing the name of the host on which Asterisk was configured, is returned.</para>\n+          </enum>\n+          <enum name=\"BUILD_MACHINE\">\n+            <para>The string representing the type of machine on which Asterisk was configured, is returned.</para>\n+          </enum>\n+          <enum name=\"BUILD_OS\">\n+            <para>The string representing the OS of the machine on which Asterisk was configured, is returned.</para>\n+          </enum>\n+          <enum name=\"BUILD_DATE\">\n+            <para>The string representing the date on which Asterisk was configured, is returned.</para>\n+          </enum>\n+          <enum name=\"BUILD_KERNEL\">\n+            <para>The string representing the kernel version of the machine on which Asterisk\n+\t\t\t\t\t\twas configured, is returned.</para>\n+          </enum>\n+        </enumlist>\n       </parameter>\n-      <parameter name=\"hook_id\" required=\"true\">\n-        <para>(On Write Only) The hook ID.</para>\n+    </syntax>\n+    <description>\n+      <para>If there are no arguments, return the version of Asterisk in this format: 18.12.0</para>\n+      <example title=\"Get current version\">same =&gt; n,Set(junky=${VERSION()} ; sets junky to 18.12.0, or possibly GITMasterxxxxxx</example>\n+    </description>\n+  </function>\n+  <module language=\"en_US\" name=\"func_callcompletion\">\n+    <support_level>core</support_level>\n+  </module>\n+  <function name=\"CALLCOMPLETION\" language=\"en_US\">\n+    <synopsis>Get or set a call completion configuration parameter for a channel.</synopsis>\n+    <syntax>\n+      <parameter name=\"option\" required=\"true\">\n+        <para>The allowable options are:</para>\n+        <enumlist>\n+          <enum name=\"cc_agent_policy\"/>\n+          <enum name=\"cc_monitor_policy\"/>\n+          <enum name=\"cc_offer_timer\"/>\n+          <enum name=\"ccnr_available_timer\"/>\n+          <enum name=\"ccbs_available_timer\"/>\n+          <enum name=\"cc_recall_timer\"/>\n+          <enum name=\"cc_max_agents\"/>\n+          <enum name=\"cc_max_monitors\"/>\n+          <enum name=\"cc_callback_macro\"/>\n+          <enum name=\"cc_agent_dialstring\"/>\n+        </enumlist>\n       </parameter>\n     </syntax>\n     <description>\n       <para>\n-        For example, you could use this function to enable playing\n-\t\t\ta periodic\n-        <literal>beep</literal>\n-        sound in a call.\n-      </para>\n-      <para/>\n-      <example title=\"To turn on\">same =&gt; n,Set(BEEPID=${PERIODIC_HOOK(hooks,beep,180)})</example>\n-      <example title=\"To turn off\">same =&gt; n,Set(PERIODIC_HOOK(${BEEPID})=off)</example>\n-      <example title=\"To turn back on again later\">same =&gt; n,Set(PERIODIC_HOOK(${BEEPID})=on)</example>\n-      <para>It is important to note that the hook does not actually\n-\t\t\trun on the channel itself.  It runs asynchronously on a new channel.\n-\t\t\tAny audio generated by the hook gets injected into the call for\n-\t\t\tthe channel PERIODIC_HOOK() was set on.</para>\n-      <para/>\n-      <para>\n-        The hook dialplan will have two variables available.\n-        <variable>HOOK_CHANNEL</variable>\n-        is the channel the hook is\n-\t\t\tenabled on.\n-        <variable>HOOK_ID</variable>\n-        is the hook ID for\n-\t\t\tenabling or disabling the hook.\n+        The CALLCOMPLETION function can be used to get or set a call\n+\t\t\tcompletion configuration parameter for a channel. Note that setting\n+\t\t\ta configuration parameter will only change the parameter for the\n+\t\t\tduration of the call.\n+\n+\t\t\tFor more information see\n+        <filename>doc/AST.pdf</filename>\n+        .\n+\t\t\tFor more information on call completion parameters, see\n+        <filename>configs/ccss.conf.sample</filename>\n+        .\n       </para>\n     </description>\n   </function>\n-  <module language=\"en_US\" name=\"func_iconv\">\n-    <depend>iconv</depend>\n+  <module language=\"en_US\" name=\"func_dialplan\">\n     <support_level>core</support_level>\n   </module>\n-  <function name=\"ICONV\" language=\"en_US\">\n-    <synopsis>Converts charsets of strings.</synopsis>\n+  <function name=\"DIALPLAN_EXISTS\" language=\"en_US\">\n+    <synopsis>Checks the existence of a dialplan target.</synopsis>\n     <syntax>\n-      <parameter name=\"in-charset\" required=\"true\">\n-        <para>Input charset</para>\n-      </parameter>\n-      <parameter name=\"out-charset\" required=\"true\">\n-        <para>Output charset</para>\n+      <parameter name=\"context\" required=\"true\"/>\n+      <parameter name=\"extension\"/>\n+      <parameter name=\"priority\"/>\n+    </syntax>\n+    <description>\n+      <para>\n+        This function returns\n+        <literal>1</literal>\n+        if the target exits. Otherwise, it returns\n+        <literal>0</literal>\n+        .\n+      </para>\n+    </description>\n+  </function>\n+  <function name=\"VALID_EXTEN\" language=\"en_US\">\n+    <synopsis>Determine whether an extension exists or not.</synopsis>\n+    <syntax>\n+      <parameter name=\"context\">\n+        <para>Defaults to the current context</para>\n       </parameter>\n-      <parameter name=\"string\" required=\"true\">\n+      <parameter name=\"extension\" required=\"true\"/>\n+      <parameter name=\"priority\">\n         <para>\n-          String to convert, from\n-          <replaceable>in-charset</replaceable>\n-          to\n-          <replaceable>out-charset</replaceable>\n+          Priority defaults to\n+          <literal>1</literal>\n+          .\n         </para>\n       </parameter>\n     </syntax>\n     <description>\n       <para>\n-        Converts string from\n-        <replaceable>in-charset</replaceable>\n-        into\n-        <replaceable>out-charset</replaceable>\n+        Returns a true value if the indicated\n+        <replaceable>context</replaceable>\n+        ,\n+        <replaceable>extension</replaceable>\n+        , and\n+        <replaceable>priority</replaceable>\n+        exist.\n+      </para>\n+      <warning>\n+        <para>\n+          This function has been deprecated in favor of the\n+          <literal>DIALPLAN_EXISTS()</literal>\n+          function\n+        </para>\n+      </warning>\n+    </description>\n+  </function>\n+  <module language=\"en_US\" name=\"func_rand\">\n+    <support_level>core</support_level>\n+  </module>\n+  <function name=\"RAND\" language=\"en_US\">\n+    <synopsis>Choose a random number in a range.</synopsis>\n+    <syntax>\n+      <parameter name=\"min\"/>\n+      <parameter name=\"max\"/>\n+    </syntax>\n+    <description>\n+      <para>\n+        Choose a random number between\n+        <replaceable>min</replaceable>\n+        and\n+        <replaceable>max</replaceable>\n         .\n-\t\t\tFor available charsets, use\n-        <literal>iconv -l</literal>\n-        on your shell command line.\n+        <replaceable>min</replaceable>\n+        defaults to\n+        <literal>0</literal>\n+        , if not specified, while\n+        <replaceable>max</replaceable>\n+        defaults\n+\t\t\tto\n+        <literal>RAND_MAX</literal>\n+        (2147483647 on many systems).\n       </para>\n-      <note>\n-        <para>Due to limitations within the API, ICONV will not currently work with\n-\t\t\tcharsets with embedded NULLs. If found, the string will terminate.</para>\n-      </note>\n+      <example title=\"Set random number between 1 and 8, inclusive\">exten =&gt; s,1,Set(junky=${RAND(1,8)})</example>\n+    </description>\n+  </function>\n+  <module language=\"en_US\" name=\"func_md5\">\n+    <support_level>core</support_level>\n+  </module>\n+  <function name=\"MD5\" language=\"en_US\">\n+    <synopsis>Computes an MD5 digest.</synopsis>\n+    <syntax>\n+      <parameter name=\"data\" required=\"true\"/>\n+    </syntax>\n+    <description>\n+      <para>Computes an MD5 digest.</para>\n     </description>\n   </function>\n+  <module language=\"en_US\" name=\"func_pjsip_aor\">\n+    <depend>pjproject</depend>\n+    <depend>res_pjsip</depend>\n+    <support_level>core</support_level>\n+  </module>\n+  <function name=\"PJSIP_AOR\" language=\"en_US\">\n+    <synopsis>Get information about a PJSIP AOR</synopsis>\n+    <syntax>\n+      <parameter name=\"name\" required=\"true\">\n+        <para>The name of the AOR to query.</para>\n+      </parameter>\n+      <parameter name=\"field\" required=\"true\">\n+        <para>\n+          The configuration option for the AOR to query for.\n+\t\t\t\tSupported options are those fields on the\n+          <replaceable>aor</replaceable>\n+          object in\n+          <filename>pjsip.conf</filename>\n+          .\n+        </para>\n+        <enumlist>\n+          <configOptionToEnum>\n+            <xi:include xpointer=\"xpointer(/docs/configInfo[@name='res_pjsip']/configFile[@name='pjsip.conf']/configObject[@name='aor']/configOption)\"/>\n+          </configOptionToEnum>\n+        </enumlist>\n+      </parameter>\n+    </syntax>\n+  </function>\n   <module language=\"en_US\" name=\"func_json\">\n     <support_level>extended</support_level>\n   </module>\n   <function name=\"JSON_DECODE\" language=\"en_US\">\n     <since>\n       <version>16.24.0</version>\n       <version>18.10.0</version>\n@@ -17079,289 +18279,130 @@\n     <description>\n       <example title=\"UNSHIFT example\">exten =&gt; s,1,Set(UNSHIFT(array)=one,two,three)</example>\n       <para>This would insert one,\n \t\t\t\ttwo, and three before the values stored in the variable\n \t\t\t\t&quot;array&quot;.</para>\n     </description>\n   </function>\n-  <module language=\"en_US\" name=\"func_config\">\n-    <support_level>core</support_level>\n-  </module>\n-  <function name=\"AST_CONFIG\" language=\"en_US\">\n-    <synopsis>Retrieve a variable from a configuration file.</synopsis>\n-    <syntax>\n-      <parameter name=\"config_file\" required=\"true\"/>\n-      <parameter name=\"category\" required=\"true\"/>\n-      <parameter name=\"variable_name\" required=\"true\"/>\n-      <parameter name=\"index\" required=\"false\">\n-        <para>\n-          If there are multiple variables with the same name, you can specify\n-          <literal>0</literal>\n-          for the first item (default),\n-          <literal>-1</literal>\n-          for the last\n-\t\t\t\titem, or any other number for that specific item.\n-          <literal>-1</literal>\n-          is useful\n-\t\t\t\twhen the variable is derived from a template and you want the effective value (the last\n-\t\t\t\toccurrence), not the value from the template (the first occurrence).\n-        </para>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>This function reads a variable from an Asterisk configuration file.</para>\n-    </description>\n-  </function>\n-  <module language=\"en_US\" name=\"func_sorcery\">\n+  <module language=\"en_US\" name=\"func_hangupcause\">\n     <support_level>core</support_level>\n   </module>\n-  <function name=\"AST_SORCERY\" language=\"en_US\">\n-    <synopsis>Get a field from a sorcery object</synopsis>\n+  <function name=\"HANGUPCAUSE\" language=\"en_US\">\n+    <synopsis>Gets per-channel hangupcause information from the channel.</synopsis>\n     <syntax>\n-      <parameter name=\"module_name\" required=\"true\">\n-        <para>The name of the module owning the sorcery instance.</para>\n-      </parameter>\n-      <parameter name=\"object_type\" required=\"true\">\n-        <para>The type of object to query.</para>\n-      </parameter>\n-      <parameter name=\"object_id\" required=\"true\">\n-        <para>The id of the object to query.</para>\n-      </parameter>\n-      <parameter name=\"field_name\" required=\"true\">\n-        <para>The name of the field.</para>\n+      <parameter name=\"channel\" required=\"true\">\n+        <para>The name of the channel for which to retrieve cause information.</para>\n       </parameter>\n-      <parameter name=\"retrieval_method\" required=\"false\">\n-        <para>Fields that have multiple occurrences may be retrieved in two ways.</para>\n+      <parameter name=\"type\" required=\"true\">\n+        <para>Parameter describing which type of information is requested. Types are:</para>\n         <enumlist>\n-          <enum name=\"concat\">\n-            <para>\n-              Returns all matching fields concatenated\n-\t\t\t\t\tin a single string separated by\n-              <replaceable>separator</replaceable>\n-              which defaults to\n-              <literal>,</literal>\n-              .\n-            </para>\n+          <enum name=\"tech\">\n+            <para>Technology-specific cause information</para>\n           </enum>\n-          <enum name=\"single\">\n-            <para>\n-              Returns the nth occurrence of the field\n-\t\t\t\t\tas specified by\n-              <replaceable>occurrence_number</replaceable>\n-              which defaults to\n-              <literal>1</literal>\n-              .\n-            </para>\n+          <enum name=\"ast\">\n+            <para>Translated Asterisk cause code</para>\n           </enum>\n         </enumlist>\n-        <para>\n-          The default is\n-          <literal>concat</literal>\n-          with separator\n-          <literal>,</literal>\n-          .\n-        </para>\n-      </parameter>\n-      <parameter name=\"retrieval_details\" required=\"false\">\n-        <para>\n-          Specifies either the separator for\n-          <literal>concat</literal>\n-          or the occurrence number for\n-          <literal>single</literal>\n-          .\n-        </para>\n       </parameter>\n     </syntax>\n+    <description>\n+      <para>Gets technology-specific or translated Asterisk cause code information\n+\t\t\tfrom the channel for the specified channel that resulted from a dial.</para>\n+    </description>\n+    <see-also>\n+      <ref type=\"function\">HANGUPCAUSE_KEYS</ref>\n+      <ref type=\"application\">HangupCauseClear</ref>\n+    </see-also>\n   </function>\n-  <module language=\"en_US\" name=\"func_sha1\">\n-    <support_level>core</support_level>\n-  </module>\n-  <function name=\"SHA1\" language=\"en_US\">\n-    <synopsis>Computes a SHA1 digest.</synopsis>\n-    <syntax>\n-      <parameter name=\"data\" required=\"true\">\n-        <para>Input string</para>\n-      </parameter>\n-    </syntax>\n+  <function name=\"HANGUPCAUSE_KEYS\" language=\"en_US\">\n+    <synopsis>Gets the list of channels for which hangup causes are available.</synopsis>\n     <description>\n-      <para>Generate a SHA1 digest via the SHA1 algorythm.</para>\n-      <example title=\"Set sha1hash variable to SHA1 hash of junky\">exten =&gt; s,1,Set(sha1hash=${SHA1(junky)})</example>\n-      <para>\n-        The example above sets the asterisk variable sha1hash to the string\n-        <literal>60fa5675b9303eb62f99a9cd47f9f5837d18f9a0</literal>\n-        which is known as its hash\n-      </para>\n+      <para>Returns a comma-separated list of channel names to be used with the HANGUPCAUSE function.</para>\n     </description>\n+    <see-also>\n+      <ref type=\"function\">HANGUPCAUSE</ref>\n+      <ref type=\"application\">HangupCauseClear</ref>\n+    </see-also>\n   </function>\n-  <module language=\"en_US\" name=\"func_presencestate\">\n+  <application name=\"HangupCauseClear\" language=\"en_US\">\n+    <synopsis>Clears hangup cause information from the channel that is available through HANGUPCAUSE.</synopsis>\n+    <description>\n+      <para>Clears all channel-specific hangup cause information from the channel.\n+\t\t\tThis is never done automatically (i.e. for new Dial()s).</para>\n+    </description>\n+    <see-also>\n+      <ref type=\"function\">HANGUPCAUSE</ref>\n+      <ref type=\"function\">HANGUPCAUSE_KEYS</ref>\n+    </see-also>\n+  </application>\n+  <module language=\"en_US\" name=\"func_extstate\">\n     <support_level>core</support_level>\n   </module>\n-  <function name=\"PRESENCE_STATE\" language=\"en_US\">\n-    <synopsis>Get or Set a presence state.</synopsis>\n-    <syntax>\n-      <parameter name=\"provider\" required=\"true\">\n+  <function name=\"EXTENSION_STATE\" language=\"en_US\">\n+    <synopsis>Get an extension's state.</synopsis>\n+    <syntax argsep=\"@\">\n+      <parameter name=\"extension\" required=\"true\"/>\n+      <parameter name=\"context\">\n         <para>\n-          The provider of the presence, such as\n-          <literal>CustomPresence</literal>\n+          If it is not specified defaults to\n+          <literal>default</literal>\n+          .\n         </para>\n       </parameter>\n-      <parameter name=\"field\" required=\"true\">\n-        <para>Which field of the presence state information is wanted.</para>\n-        <optionlist>\n-          <option name=\"value\">\n-            <para>\n-              The current presence, such as\n-              <literal>away</literal>\n-            </para>\n-          </option>\n-          <option name=\"subtype\">\n-            <para>Further information about the current presence</para>\n-          </option>\n-          <option name=\"message\">\n-            <para>A custom message that may indicate further details about the presence</para>\n-          </option>\n-        </optionlist>\n-      </parameter>\n-      <parameter name=\"options\" required=\"false\">\n-        <optionlist>\n-          <option name=\"e\">\n-            <para>On Write - Use this option when the subtype and message provided are Base64\n-\t\t\t\t\tencoded. The values will be stored encoded within Asterisk, but all consumers of\n-\t\t\t\t\tthe presence state (e.g. the SIP presence event package) will receive decoded values.</para>\n-            <para>On Read - Retrieves unencoded message/subtype in Base64 encoded form.</para>\n-          </option>\n-        </optionlist>\n-      </parameter>\n     </syntax>\n     <description>\n-      <para>The PRESENCE_STATE function can be used to retrieve the presence from any\n-\t\t\tpresence provider. For example:</para>\n-      <para>NoOp(SIP/mypeer has presence ${PRESENCE_STATE(SIP/mypeer,value)})</para>\n-      <para>NoOp(Conference number 1234 has presence message ${PRESENCE_STATE(MeetMe:1234,message)})</para>\n-      <para>\n-        The PRESENCE_STATE function can also be used to set custom presence state from\n-\t\t\tthe dialplan.  The\n-        <literal>CustomPresence:</literal>\n-        prefix must be used. For example:\n-      </para>\n-      <para>Set(PRESENCE_STATE(CustomPresence:lamp1)=away,temporary,Out to lunch)</para>\n-      <para>Set(PRESENCE_STATE(CustomPresence:lamp2)=dnd,,Trying to get work done)</para>\n-      <para>Set(PRESENCE_STATE(CustomPresence:lamp3)=xa,T24gdmFjYXRpb24=,,e)</para>\n-      <para>Set(BASE64_LAMP3_PRESENCE=${PRESENCE_STATE(CustomPresence:lamp3,subtype,e)})</para>\n-      <para>You can subscribe to the status of a custom presence state using a hint in\n-\t\t\tthe dialplan:</para>\n-      <para>exten =&gt; 1234,hint,,CustomPresence:lamp1</para>\n-      <para>The possible values for both uses of this function are:</para>\n-      <para>not_set | unavailable | available | away | xa | chat | dnd</para>\n+      <para>The EXTENSION_STATE function can be used to retrieve the state from any\n+\t\t\thinted extension. For example:</para>\n+      <para>NoOp(1234@default has state ${EXTENSION_STATE(1234)})</para>\n+      <para>NoOp(4567@home has state ${EXTENSION_STATE(4567@home)})</para>\n+      <para>The possible values returned by this function are:</para>\n+      <para>UNKNOWN | NOT_INUSE | INUSE | BUSY | INVALID | UNAVAILABLE | RINGING |\n+\t\t\tRINGINUSE | HOLDINUSE | ONHOLD</para>\n     </description>\n   </function>\n-  <module language=\"en_US\" name=\"func_talkdetect\">\n-    <support_level>core</support_level>\n+  <module language=\"en_US\" name=\"func_pitchshift\">\n+    <support_level>extended</support_level>\n   </module>\n-  <function name=\"TALK_DETECT\" language=\"en_US\">\n-    <since>\n-      <version>12.4.0</version>\n-    </since>\n-    <synopsis>Raises notifications when Asterisk detects silence or talking on a channel.</synopsis>\n+  <function name=\"PITCH_SHIFT\" language=\"en_US\">\n+    <synopsis>Pitch shift both tx and rx audio streams on a channel.</synopsis>\n     <syntax>\n-      <parameter name=\"action\" required=\"true\">\n-        <optionlist>\n-          <option name=\"remove\">\n-            <para>W/O. Remove talk detection from the channel.</para>\n-          </option>\n-          <option name=\"set\">\n-            <para>W/O. Enable TALK_DETECT and/or configure talk detection\n-\t\t\t\t\t\tparameters. Can be called multiple times to change parameters\n-\t\t\t\t\t\ton a channel with talk detection already enabled.</para>\n-            <argument name=\"dsp_silence_threshold\" required=\"false\">\n-              <para>\n-                The time in milliseconds of sound falling below the\n-                <replaceable>dsp_talking_threshold</replaceable>\n-                option when\n-\t\t\t\t\t\t\ta user is considered to stop talking. The default value is\n-\t\t\t\t\t\t\t2500.\n-              </para>\n-            </argument>\n-            <argument name=\"dsp_talking_threshold\" required=\"false\">\n-              <para>\n-                The minimum average magnitude per sample in a frame\n-\t\t\t\t\t\t\tfor the DSP to consider talking/noise present. A value below\n-\t\t\t\t\t\t\tthis level is considered silence. If not specified, the\n-\t\t\t\t\t\t\tvalue comes from the\n-                <filename>dsp.conf</filename>\n-                <replaceable>silencethreshold</replaceable>\n-                option or 256\n-\t\t\t\t\t\t\tif\n-                <filename>dsp.conf</filename>\n-                doesn't exist or the\n-                <replaceable>silencethreshold</replaceable>\n-                option is not\n-\t\t\t\t\t\t\tset.\n-              </para>\n-            </argument>\n-          </option>\n-        </optionlist>\n+      <parameter name=\"channel direction\" required=\"true\">\n+        <para>\n+          Direction can be either\n+          <literal>rx</literal>\n+          ,\n+          <literal>tx</literal>\n+          , or\n+          <literal>both</literal>\n+          .  The direction can either be set to a valid floating\n+\t\t\t\tpoint number between 0.1 and 4.0 or one of the enum values listed below. A value\n+\t\t\t\tof 1.0 has no effect.  Greater than 1 raises the pitch. Lower than 1 lowers\n+\t\t\t\tthe pitch.\n+        </para>\n+        <para>The pitch amount can also be set by the following values</para>\n+        <enumlist>\n+          <enum name=\"highest\"/>\n+          <enum name=\"higher\"/>\n+          <enum name=\"high\"/>\n+          <enum name=\"low\"/>\n+          <enum name=\"lower\"/>\n+          <enum name=\"lowest\"/>\n+        </enumlist>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>The TALK_DETECT function enables events on the channel\n-\t\t\tit is applied to. These events can be emitted over AMI, ARI, and\n-\t\t\tpotentially other Asterisk modules that listen for the internal\n-\t\t\tnotification.</para>\n-      <para>\n-        The function has two parameters that can optionally be passed\n-\t\t\twhen\n-        <literal>set</literal>\n-        on a channel:\n-        <replaceable>dsp_talking_threshold</replaceable>\n-        and\n-        <replaceable>dsp_silence_threshold</replaceable>\n-        .\n-      </para>\n-      <para>\n-        <replaceable>dsp_talking_threshold</replaceable>\n-        is the time in milliseconds of sound\n-\t\t\tabove what the dsp has established as base line silence for a user\n-\t\t\tbefore a user is considered to be talking. By default, the value of\n-        <replaceable>silencethreshold</replaceable>\n-        from\n-        <filename>dsp.conf</filename>\n-        is used. If this value is set too tight events may be\n-\t\t\tfalsely triggered by variants in room noise.\n-      </para>\n-      <para>Valid values are 1 through 2^31.</para>\n-      <para>\n-        <replaceable>dsp_silence_threshold</replaceable>\n-        is the time in milliseconds of sound\n-\t\t\tfalling within what the dsp has established as baseline silence before\n-\t\t\ta user is considered be silent. If this value is set too low events\n-\t\t\tindicating the user has stopped talking may get falsely sent out when\n-\t\t\tthe user briefly pauses during mid sentence.\n-      </para>\n-      <para>The best way to approach this option is to set it slightly above\n-\t\t\tthe maximum amount of ms of silence a user may generate during\n-\t\t\tnatural speech.</para>\n-      <para>By default this value is 2500ms. Valid values are 1\n-\t\t\tthrough 2^31.</para>\n-      <example title=\"Enable talk detection\">same =&gt; n,Set(TALK_DETECT(set)=)</example>\n-      <example title=\"Update existing talk detection's silence threshold to 1200 ms\">same =&gt; n,Set(TALK_DETECT(set)=1200)</example>\n-      <example title=\"Remove talk detection\">same =&gt; n,Set(TALK_DETECT(remove)=)</example>\n-      <example title=\"Enable and set talk threshold to 128\">same =&gt; n,Set(TALK_DETECT(set)=,128)</example>\n-      <para>This function will set the following variables:</para>\n-      <note>\n-        <para>The TALK_DETECT function uses an audiohook to inspect the\n-\t\t\t\tvoice media frames on a channel. Other functions, such as JITTERBUFFER,\n-\t\t\t\tDENOISE, and AGC use a similar mechanism. Audiohooks are processed\n-\t\t\t\tin the order in which they are placed on the channel. As such,\n-\t\t\t\tit typically makes sense to place functions that modify the voice\n-\t\t\t\tmedia data prior to placing the TALK_DETECT function, as this will\n-\t\t\t\tyield better results.</para>\n-      </note>\n-      <example title=\"Denoise and then perform talk detection\">same =&gt; n,Set(DENOISE(rx)=on)    ; Denoise received audio\n-\t\t\tsame =&gt; n,Set(TALK_DETECT(set)=) ; Perform talk detection on the denoised received audio</example>\n+      <para>Examples:</para>\n+      <example title=\"Raises pitch an octave\">exten =&gt; 1,1,Set(PITCH_SHIFT(tx)=highest)</example>\n+      <example title=\"Raises pitch more\">exten =&gt; 1,1,Set(PITCH_SHIFT(rx)=higher)</example>\n+      <example title=\"Raises pitch\">exten =&gt; 1,1,Set(PITCH_SHIFT(both)=high)</example>\n+      <example title=\"Lowers pitch\">exten =&gt; 1,1,Set(PITCH_SHIFT(rx)=low)</example>\n+      <example title=\"Lowers pitch more\">exten =&gt; 1,1,Set(PITCH_SHIFT(tx)=lower)</example>\n+      <example title=\"Lowers pitch an octave\">exten =&gt; 1,1,Set(PITCH_SHIFT(both)=lowest)</example>\n+      <example title=\"Lowers pitch\">exten =&gt; 1,1,Set(PITCH_SHIFT(rx)=0.8)</example>\n+      <example title=\"Raises pitch\">exten =&gt; 1,1,Set(PITCH_SHIFT(tx)=1.5)</example>\n     </description>\n   </function>\n   <module language=\"en_US\" name=\"func_curl\">\n     <depend>res_curl</depend>\n     <depend>curl</depend>\n     <support_level>core</support_level>\n   </module>\n@@ -17551,483 +18592,86 @@\n \t\t\tsettings will override global settings. Only HTTP headers are added instead of overriding</para>\n     </description>\n     <see-also>\n       <ref type=\"function\">CURL</ref>\n       <ref type=\"function\">HASH</ref>\n     </see-also>\n   </function>\n-  <module language=\"en_US\" name=\"func_jitterbuffer\">\n+  <module language=\"en_US\" name=\"func_dialgroup\">\n     <support_level>core</support_level>\n   </module>\n-  <function name=\"JITTERBUFFER\" language=\"en_US\">\n-    <synopsis>Add a Jitterbuffer to the Read side of the channel. This dejitters the audio stream before it reaches the Asterisk core. This is a write only function.</synopsis>\n-    <syntax>\n-      <parameter name=\"jitterbuffer type\" required=\"true\">\n-        <optionlist>\n-          <option name=\"fixed\">\n-            <para>Set a fixed jitterbuffer on the channel.</para>\n-          </option>\n-          <option name=\"adaptive\">\n-            <para>Set an adaptive jitterbuffer on the channel.</para>\n-          </option>\n-          <option name=\"disabled\">\n-            <para>Remove a previously set jitterbuffer from the channel.</para>\n-          </option>\n-        </optionlist>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>\n-        Jitterbuffers are constructed in two different ways.\n-\t\t\tThe first always take four arguments:\n-        <replaceable>max_size</replaceable>\n-        ,\n-        <replaceable>resync_threshold</replaceable>\n-        ,\n-        <replaceable>target_extra</replaceable>\n-        ,\n-\t\t\tand\n-        <replaceable>sync_video</replaceable>\n-        .\n-\t\t\tAlternatively, a single argument of\n-        <literal>default</literal>\n-        can be provided,\n-\t\t\twhich will construct the default jitterbuffer for the given\n-        <replaceable>jitterbuffer type</replaceable>\n-        .\n-      </para>\n-      <para>The arguments are:</para>\n-      <para>\n-        <replaceable>max_size</replaceable>\n-        : Length in milliseconds of the buffer.\n-\t\t\tDefaults to 200 ms.\n-      </para>\n-      <para>\n-        <replaceable>resync_threshold</replaceable>\n-        : The length in milliseconds over\n-\t\t\twhich a timestamp difference will result in resyncing the jitterbuffer.\n-\t\t\tDefaults to 1000ms.\n-      </para>\n-      <para>target_extra: This option only affects the adaptive jitterbuffer. It represents\n-\t\t\tthe amount time in milliseconds by which the new jitter buffer will pad its size.\n-\t\t\tDefaults to 40ms.</para>\n-      <para>sync_video: This option enables video synchronization with the audio stream. It can be\n-\t\t\tturned on and off. Defaults to off.</para>\n-      <example title=\"Fixed with defaults\" language=\"text\">exten =&gt; 1,1,Set(JITTERBUFFER(fixed)=default)</example>\n-      <example title=\"Fixed with 200ms max size\" language=\"text\">exten =&gt; 1,1,Set(JITTERBUFFER(fixed)=200)</example>\n-      <example title=\"Fixed with 200ms max size and video sync support\" language=\"text\">exten =&gt; 1,1,Set(JITTERBUFFER(fixed)=200,,,yes)</example>\n-      <example title=\"Fixed with 200ms max size, resync threshold 1500\" language=\"text\">exten =&gt; 1,1,Set(JITTERBUFFER(fixed)=200,1500)</example>\n-      <example title=\"Adaptive with defaults\" language=\"text\">exten =&gt; 1,1,Set(JITTERBUFFER(adaptive)=default)</example>\n-      <example title=\"Adaptive with 200ms max size, 60ms target extra\" language=\"text\">exten =&gt; 1,1,Set(JITTERBUFFER(adaptive)=200,,60)</example>\n-      <example title=\"Adaptive with 200ms max size and video sync support\" language=\"text\">exten =&gt; 1,1,Set(JITTERBUFFER(adaptive)=200,,,yes)</example>\n-      <example title=\"Set a fixed jitterbuffer with defaults; then remove it\" language=\"text\">exten =&gt; 1,1,Set(JITTERBUFFER(fixed)=default)\n-\t\t\texten =&gt; 1,n,Set(JITTERBUFFER(disabled)=)</example>\n-      <note>\n-        <para>If a channel specifies a jitterbuffer due to channel driver configuration and\n-\t\t\tthe JITTERBUFFER function has set a jitterbuffer for that channel, the jitterbuffer set by\n-\t\t\tthe JITTERBUFFER function will take priority and the jitterbuffer set by the channel\n-\t\t\tconfiguration will not be applied.</para>\n-      </note>\n-    </description>\n-  </function>\n-  <module language=\"en_US\" name=\"func_scramble\">\n-    <support_level>extended</support_level>\n-  </module>\n-  <function name=\"SCRAMBLE\" language=\"en_US\">\n-    <since>\n-      <version>16.21.0</version>\n-      <version>18.7.0</version>\n-      <version>19.0.0</version>\n-    </since>\n-    <synopsis>Scrambles audio on a channel.</synopsis>\n+  <function name=\"DIALGROUP\" language=\"en_US\">\n+    <synopsis>Manages a group of users for dialing.</synopsis>\n     <syntax>\n-      <parameter name=\"direction\" required=\"false\">\n+      <parameter name=\"group\" required=\"true\"/>\n+      <parameter name=\"op\">\n+        <para>The operation name, possible values are:</para>\n         <para>\n-          Must be\n-          <literal>TX</literal>\n-          or\n-          <literal>RX</literal>\n-          to limit to a specific direction, or\n-          <literal>both</literal>\n-          for both directions.\n-          <literal>remove</literal>\n-          will remove an existing scrambler.\n+          <literal>add</literal>\n+          - add a channel name or interface (write-only)\n         </para>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>Scrambles audio on a channel using whole spectrum inversion.\n-\t\t\tThis is not intended to be used for securely scrambling\n-\t\t\taudio. It merely renders obfuscates audio on a channel\n-\t\t\tto render it unintelligible, as a privacy enhancement.</para>\n-    </description>\n-    <see-also>\n-      <ref type=\"application\">ChanSpy</ref>\n-    </see-also>\n-  </function>\n-  <module language=\"en_US\" name=\"func_frame_trace\">\n-    <support_level>extended</support_level>\n-  </module>\n-  <function name=\"FRAME_TRACE\" language=\"en_US\">\n-    <synopsis>View internal ast_frames as they are read and written on a channel.</synopsis>\n-    <syntax>\n-      <parameter name=\"filter list type\" required=\"true\">\n         <para>\n-          A filter can be applied to the trace to limit what frames are viewed.  This\n-\t\t\t\tfilter can either be a\n-          <literal>white</literal>\n-          or\n-          <literal>black</literal>\n-          list\n-\t\t\t\tof frame types.  When no filter type is present,\n-          <literal>white</literal>\n-          is\n-\t\t\t\tused.  If no arguments are provided at all, all frames will be output.\n+          <literal>del</literal>\n+          - remove a channel name or interface (write-only)\n         </para>\n-        <para>Below are the different types of frames that can be filtered.</para>\n-        <enumlist>\n-          <enum name=\"DTMF_BEGIN\"/>\n-          <enum name=\"DTMF_END\"/>\n-          <enum name=\"VOICE\"/>\n-          <enum name=\"VIDEO\"/>\n-          <enum name=\"CONTROL\"/>\n-          <enum name=\"NULL\"/>\n-          <enum name=\"IAX\"/>\n-          <enum name=\"TEXT\"/>\n-          <enum name=\"TEXT_DATA\"/>\n-          <enum name=\"IMAGE\"/>\n-          <enum name=\"HTML\"/>\n-          <enum name=\"CNG\"/>\n-          <enum name=\"MODEM\"/>\n-        </enumlist>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>Examples:</para>\n-      <example title=\"View only DTMF frames\">exten =&gt; 1,1,Set(FRAME_TRACE(white)=DTMF_BEGIN,DTMF_END)</example>\n-      <example title=\"View only DTMF frames\">exten =&gt; 1,1,Set(FRAME_TRACE()=DTMF_BEGIN,DTMF_END)</example>\n-      <example title=\"View everything except DTMF frames\">exten =&gt; 1,1,Set(FRAME_TRACE(black)=DTMF_BEGIN,DTMF_END)</example>\n-    </description>\n-  </function>\n-  <module language=\"en_US\" name=\"func_evalexten\">\n-    <support_level>extended</support_level>\n-  </module>\n-  <function name=\"EVAL_EXTEN\" language=\"en_US\">\n-    <synopsis>Evaluates the contents of a dialplan extension and returns it as a string.</synopsis>\n-    <syntax>\n-      <parameter name=\"context\"/>\n-      <parameter name=\"extensions\"/>\n-      <parameter name=\"priority\" required=\"true\"/>\n-    </syntax>\n-    <description>\n-      <para>The EVAL_EXTEN function looks up a dialplan entry by context,extension,priority,\n-\t\t\tevaluates the contents of a Return statement to resolve any variable or function\n-\t\t\treferences, and returns the result as a string.</para>\n-      <para>You can use this function to create simple user-defined lookup tables or\n-\t\t\tuser-defined functions.</para>\n-      <example title=\"Custom dialplan functions\">[call-types]\n-\t\t\texten =&gt; _1NNN,1,Return(internal)\n-\t\t\texten =&gt; _NXXNXXXXXX,1,Return(external)\n-\n-\t\t\t[udf]\n-\t\t\texten =&gt; calleridlen,1,Return(${LEN(${CALLERID(num)})})\n-\n-\t\t\t[default]\n-\t\t\texten =&gt; _X!,1,Verbose(Call type ${EVAL_EXTEN(call-types,${EXTEN},1)} - ${EVAL_EXTEN(udf,calleridlen,1)})</example>\n-      <para>\n-        Any variables in the evaluated data will be resolved in the context of\n-\t\t\tthat extension. For example,\n-        <literal>${EXTEN}</literal>\n-        would refer to the\n-\t\t\tEVAL_EXTEN extension, not the extension in the context invoking the function.\n-\t\t\tThis behavior is similar to other applications, e.g.\n-        <literal>Gosub</literal>\n-        .\n-      </para>\n-      <example title=\"Choosing which prompt to use\">same =&gt; n,Read(input,${EVAL_EXTEN(prompts,${CALLERID(num)},1)})\n-\n-\t\t\t[prompts]\n-\t\t\texten =&gt; _X!,1,Return(default)\n-\t\t\texten =&gt; _20X,1,Return(welcome)\n-\t\t\texten =&gt; _2XX,1,Return(${DB(promptsettings/${EXTEN})})\n-\t\t\texten =&gt; _3XX,1,Return(${ODBC_MYFUNC(${EXTEN})})</example>\n-      <para>Extensions on which EVAL_EXTEN is invoked are not different from other\n-\t\t\textensions. However, the application at that extension is not executed.\n-\t\t\tOnly the application data is parsed and evaluated.</para>\n-      <para>A limitation of this function is that the application at the specified\n-\t\t\textension isn't actually executed, and thus unlike a Gosub, you can't pass\n-\t\t\targuments in the EVAL_EXTEN function.</para>\n-    </description>\n-    <see-also>\n-      <ref type=\"function\">EVAL</ref>\n-    </see-also>\n-  </function>\n-  <module language=\"en_US\" name=\"func_lock\">\n-    <support_level>core</support_level>\n-  </module>\n-  <function name=\"LOCK\" language=\"en_US\">\n-    <synopsis>Attempt to obtain a named mutex.</synopsis>\n-    <syntax>\n-      <parameter name=\"lockname\" required=\"true\"/>\n-    </syntax>\n-    <description>\n-      <para>\n-        Attempts to grab a named lock exclusively, and prevents other channels from\n-\t\t\tobtaining the same lock.  LOCK will wait for the lock to become available.\n-\t\t\tReturns\n-        <literal>1</literal>\n-        if the lock was obtained or\n-        <literal>0</literal>\n-        on error.\n-      </para>\n-      <note>\n-        <para>To avoid the possibility of a deadlock, LOCK will only attempt to\n-\t\t\tobtain the lock for 3 seconds if the channel already has another lock.</para>\n-      </note>\n-      <note>\n-        <para>\n-          If\n-          <literal>live_dangerously</literal>\n-          in\n-          <literal>asterisk.conf</literal>\n-          is set to\n-          <literal>no</literal>\n-          , this function can only be executed from the\n-\t\t\t\tdialplan, and not directly from external protocols.\n-        </para>\n-      </note>\n-    </description>\n-  </function>\n-  <function name=\"TRYLOCK\" language=\"en_US\">\n-    <synopsis>Attempt to obtain a named mutex.</synopsis>\n-    <syntax>\n-      <parameter name=\"lockname\" required=\"true\"/>\n-    </syntax>\n-    <description>\n-      <para>\n-        Attempts to grab a named lock exclusively, and prevents other channels\n-\t\t\tfrom obtaining the same lock.  Returns\n-        <literal>1</literal>\n-        if the lock was\n-\t\t\tavailable or\n-        <literal>0</literal>\n-        otherwise.\n-      </para>\n-      <note>\n-        <para>\n-          If\n-          <literal>live_dangerously</literal>\n-          in\n-          <literal>asterisk.conf</literal>\n-          is set to\n-          <literal>no</literal>\n-          , this function can only be executed from the\n-\t\t\t\tdialplan, and not directly from external protocols.\n-        </para>\n-      </note>\n-    </description>\n-  </function>\n-  <function name=\"UNLOCK\" language=\"en_US\">\n-    <synopsis>Unlocks a named mutex.</synopsis>\n-    <syntax>\n-      <parameter name=\"lockname\" required=\"true\"/>\n-    </syntax>\n-    <description>\n+      <para>Presents an interface meant to be used in concert with the Dial\n+\t\t\tapplication, by presenting a list of channels which should be dialled when\n+\t\t\treferenced.</para>\n       <para>\n-        Unlocks a previously locked mutex. Returns\n-        <literal>1</literal>\n-        if the channel\n-\t\t\thad a lock or\n-        <literal>0</literal>\n-        otherwise.\n+        When DIALGROUP is read from, the argument is interpreted as the particular\n+        <replaceable>group</replaceable>\n+        for which a dial should be attempted.  When DIALGROUP is written to\n+\t\t\twith no arguments, the entire list is replaced with the argument specified.\n       </para>\n-      <note>\n-        <para>It is generally unnecessary to unlock in a hangup routine, as any locks\n-\t\t\theld are automatically freed when the channel is destroyed.</para>\n-      </note>\n-      <note>\n-        <para>\n-          If\n-          <literal>live_dangerously</literal>\n-          in\n-          <literal>asterisk.conf</literal>\n-          is set to\n-          <literal>no</literal>\n-          , this function can only be executed from the\n-\t\t\t\tdialplan, and not directly from external protocols.\n-        </para>\n-      </note>\n+      <para>Functionality is similar to a queue, except that when no interfaces are\n+\t\t\tavailable, execution may continue in the dialplan.  This is useful when\n+\t\t\tyou want certain people to be the first to answer any calls, with immediate\n+\t\t\tfallback to a queue when the front line people are busy or unavailable, but\n+\t\t\tyou still want front line people to log in and out of that group, just like\n+\t\t\ta queue.</para>\n+      <example title=\"Add 2 endpoints to a dial group\">exten =&gt; 1,1,Set(DIALGROUP(mygroup,add)=SIP/10)\n+\t\t\tsame =&gt; n,Set(DIALGROUP(mygroup,add)=SIP/20)\n+\t\t\tsame =&gt; n,Dial(${DIALGROUP(mygroup)})</example>\n     </description>\n   </function>\n-  <module language=\"en_US\" name=\"func_realtime\">\n+  <module language=\"en_US\" name=\"func_uri\">\n     <support_level>core</support_level>\n   </module>\n-  <function name=\"REALTIME\" language=\"en_US\">\n-    <synopsis>RealTime Read/Write Functions.</synopsis>\n+  <function name=\"URIENCODE\" language=\"en_US\">\n+    <synopsis>Encodes a string to URI-safe encoding according to RFC 2396.</synopsis>\n     <syntax>\n-      <parameter name=\"family\" required=\"true\"/>\n-      <parameter name=\"fieldmatch\" required=\"true\"/>\n-      <parameter name=\"matchvalue\"/>\n-      <parameter name=\"delim1|field\">\n-        <para>\n-          Use\n-          <replaceable>delim1</replaceable>\n-          with\n-          <replaceable>delim2</replaceable>\n-          on\n-\t\t\t\tread and\n-          <replaceable>field</replaceable>\n-          without\n-          <replaceable>delim2</replaceable>\n-          on\n-\t\t\t\twrite\n-        </para>\n-        <para>\n-          If we are reading and\n-          <replaceable>delim1</replaceable>\n-          is not specified, defaults\n-\t\t\t\tto\n-          <literal>,</literal>\n-        </para>\n-      </parameter>\n-      <parameter name=\"delim2\">\n-        <para>\n-          Parameter only used when reading, if not specified defaults to\n-          <literal>=</literal>\n-        </para>\n+      <parameter name=\"data\" required=\"true\">\n+        <para>Input string to be encoded.</para>\n       </parameter>\n     </syntax>\n     <description>\n       <para>\n-        This function will read or write values from/to a RealTime repository.\n-\t\t\tREALTIME(....) will read names/values from the repository, and\n-\t\t\tREALTIME(....)= will write a new value/field to the repository. On a\n-\t\t\tread, this function returns a delimited text string. The name/value\n-\t\t\tpairs are delimited by\n-        <replaceable>delim1</replaceable>\n-        , and the name and value are delimited\n-\t\t\tbetween each other with delim2.\n-\t\t\tIf there is no match, NULL will be returned by the function.\n-\t\t\tOn a write, this function will always return NULL.\n-      </para>\n-    </description>\n-    <see-also>\n-      <ref type=\"function\">REALTIME_STORE</ref>\n-      <ref type=\"function\">REALTIME_DESTROY</ref>\n-      <ref type=\"function\">REALTIME_FIELD</ref>\n-      <ref type=\"function\">REALTIME_HASH</ref>\n-    </see-also>\n-  </function>\n-  <function name=\"REALTIME_STORE\" language=\"en_US\">\n-    <synopsis>RealTime Store Function.</synopsis>\n-    <syntax>\n-      <parameter name=\"family\" required=\"true\"/>\n-      <parameter name=\"field1\" required=\"true\"/>\n-      <parameter name=\"fieldN\" required=\"true\" multiple=\"true\"/>\n-      <parameter name=\"field30\" required=\"true\"/>\n-    </syntax>\n-    <description>\n-      <para>This function will insert a new set of values into the RealTime repository.\n-\t\t\tIf RT engine provides an unique ID of the stored record, REALTIME_STORE(...)=..\n-\t\t\tcreates channel variable named RTSTOREID, which contains value of unique ID.\n-\t\t\tCurrently, a maximum of 30 field/value pairs is supported.</para>\n-    </description>\n-    <see-also>\n-      <ref type=\"function\">REALTIME</ref>\n-      <ref type=\"function\">REALTIME_DESTROY</ref>\n-      <ref type=\"function\">REALTIME_FIELD</ref>\n-      <ref type=\"function\">REALTIME_HASH</ref>\n-    </see-also>\n-  </function>\n-  <function name=\"REALTIME_DESTROY\" language=\"en_US\">\n-    <synopsis>RealTime Destroy Function.</synopsis>\n-    <syntax>\n-      <parameter name=\"family\" required=\"true\"/>\n-      <parameter name=\"fieldmatch\" required=\"true\"/>\n-      <parameter name=\"matchvalue\"/>\n-      <parameter name=\"delim1\"/>\n-      <parameter name=\"delim2\"/>\n-    </syntax>\n-    <description>\n-      <para>This function acts in the same way as REALTIME(....) does, except that\n-\t\t\tit destroys the matched record in the RT engine.</para>\n-      <note>\n-        <para>\n-          If\n-          <literal>live_dangerously</literal>\n-          in\n-          <literal>asterisk.conf</literal>\n-          is set to\n-          <literal>no</literal>\n-          , this function can only be read from the\n-\t\t\t\tdialplan, and not directly from external protocols. It can, however, be\n-\t\t\t\texecuted as a write operation (\n-          <literal>REALTIME_DESTROY(family, fieldmatch)=ignored</literal>\n-          )\n-        </para>\n-      </note>\n-    </description>\n-    <see-also>\n-      <ref type=\"function\">REALTIME</ref>\n-      <ref type=\"function\">REALTIME_STORE</ref>\n-      <ref type=\"function\">REALTIME_FIELD</ref>\n-      <ref type=\"function\">REALTIME_HASH</ref>\n-    </see-also>\n-  </function>\n-  <function name=\"REALTIME_FIELD\" language=\"en_US\">\n-    <synopsis>RealTime query function.</synopsis>\n-    <syntax>\n-      <parameter name=\"family\" required=\"true\"/>\n-      <parameter name=\"fieldmatch\" required=\"true\"/>\n-      <parameter name=\"matchvalue\" required=\"true\"/>\n-      <parameter name=\"fieldname\" required=\"true\"/>\n-    </syntax>\n-    <description>\n-      <para>\n-        This function retrieves a single item,\n-        <replaceable>fieldname</replaceable>\n-        from the RT engine, where\n-        <replaceable>fieldmatch</replaceable>\n-        contains the value\n-        <replaceable>matchvalue</replaceable>\n-        .  When written to, the REALTIME_FIELD() function\n-\t\t\tperforms identically to the REALTIME() function.\n+        Returns the encoded string defined in\n+        <replaceable>data</replaceable>\n+        .\n       </para>\n     </description>\n-    <see-also>\n-      <ref type=\"function\">REALTIME</ref>\n-      <ref type=\"function\">REALTIME_STORE</ref>\n-      <ref type=\"function\">REALTIME_DESTROY</ref>\n-      <ref type=\"function\">REALTIME_HASH</ref>\n-    </see-also>\n   </function>\n-  <function name=\"REALTIME_HASH\" language=\"en_US\">\n-    <synopsis>RealTime query function.</synopsis>\n+  <function name=\"URIDECODE\" language=\"en_US\">\n+    <synopsis>Decodes a URI-encoded string according to RFC 2396.</synopsis>\n     <syntax>\n-      <parameter name=\"family\" required=\"true\"/>\n-      <parameter name=\"fieldmatch\" required=\"true\"/>\n-      <parameter name=\"matchvalue\" required=\"true\"/>\n+      <parameter name=\"data\" required=\"true\">\n+        <para>Input string to be decoded.</para>\n+      </parameter>\n     </syntax>\n     <description>\n       <para>\n-        This function retrieves a single record from the RT engine, where\n-        <replaceable>fieldmatch</replaceable>\n-        contains the value\n-        <replaceable>matchvalue</replaceable>\n-        and formats the output suitably, such that\n-\t\t\tit can be assigned to the HASH() function.  The HASH() function then provides\n-\t\t\ta suitable method for retrieving each field value of the record.\n+        Returns the decoded URI-encoded\n+        <replaceable>data</replaceable>\n+        string.\n       </para>\n     </description>\n-    <see-also>\n-      <ref type=\"function\">REALTIME</ref>\n-      <ref type=\"function\">REALTIME_STORE</ref>\n-      <ref type=\"function\">REALTIME_DESTROY</ref>\n-      <ref type=\"function\">REALTIME_FIELD</ref>\n-    </see-also>\n   </function>\n   <module language=\"en_US\" name=\"func_aes\">\n     <depend>res_crypto</depend>\n     <depend>crypto</depend>\n     <support_level>core</support_level>\n   </module>\n   <function name=\"AES_ENCRYPT\" language=\"en_US\">\n@@ -18064,65 +18708,14 @@\n     </description>\n     <see-also>\n       <ref type=\"function\">AES_ENCRYPT</ref>\n       <ref type=\"function\">BASE64_ENCODE</ref>\n       <ref type=\"function\">BASE64_DECODE</ref>\n     </see-also>\n   </function>\n-  <module language=\"en_US\" name=\"func_timeout\">\n-    <support_level>core</support_level>\n-  </module>\n-  <function name=\"TIMEOUT\" language=\"en_US\">\n-    <synopsis>Gets or sets timeouts on the channel. Timeout values are in seconds.</synopsis>\n-    <syntax>\n-      <parameter name=\"timeouttype\" required=\"true\">\n-        <para>\n-          The timeout that will be manipulated. The possible timeout types\n-\t\t\t\tare:\n-          <literal>absolute</literal>\n-          ,\n-          <literal>digit</literal>\n-          or\n-          <literal>response</literal>\n-        </para>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>The timeouts that can be manipulated are:</para>\n-      <para>\n-        <literal>absolute</literal>\n-        : The absolute maximum amount of time permitted for a call.\n-\t\t\tSetting of 0 disables the timeout.\n-      </para>\n-      <para>\n-        <literal>digit</literal>\n-        : The maximum amount of time permitted between digits when the\n-\t\t\tuser is typing in an extension.  When this timeout expires,\n-\t\t\tafter the user has started to type in an extension, the\n-\t\t\textension will be considered complete, and will be\n-\t\t\tinterpreted.  Note that if an extension typed in is valid,\n-\t\t\tit will not have to timeout to be tested, so typically at\n-\t\t\tthe expiry of this timeout, the extension will be considered\n-\t\t\tinvalid (and thus control would be passed to the\n-        <literal>i</literal>\n-        extension, or if it doesn't exist the call would be\n-\t\t\tterminated).  The default timeout is 5 seconds.\n-      </para>\n-      <para>\n-        <literal>response</literal>\n-        : The maximum amount of time permitted after falling through a\n-\t\t\tseries of priorities for a channel in which the user may\n-\t\t\tbegin typing an extension.  If the user does not type an\n-\t\t\textension in this amount of time, control will pass to the\n-        <literal>t</literal>\n-        extension if it exists, and if not the call would be\n-\t\t\tterminated.  The default timeout is 10 seconds.\n-      </para>\n-    </description>\n-  </function>\n   <module language=\"en_US\" name=\"func_groupcount\">\n     <support_level>core</support_level>\n   </module>\n   <function name=\"GROUP_COUNT\" language=\"en_US\">\n     <synopsis>Counts the number of channels in the specified group.</synopsis>\n     <syntax argsep=\"@\">\n       <parameter name=\"groupname\">\n@@ -18173,640 +18766,317 @@\n   <function name=\"GROUP_LIST\" language=\"en_US\">\n     <synopsis>Gets a list of the groups set on a channel.</synopsis>\n     <syntax/>\n     <description>\n       <para>Gets a list of the groups set on a channel.</para>\n     </description>\n   </function>\n-  <module language=\"en_US\" name=\"func_callerid\">\n+  <module language=\"en_US\" name=\"func_devstate\">\n     <support_level>core</support_level>\n   </module>\n-  <function name=\"CALLERID\" language=\"en_US\">\n-    <synopsis>Gets or sets Caller*ID data on the channel.</synopsis>\n+  <function name=\"DEVICE_STATE\" language=\"en_US\">\n+    <synopsis>Get or Set a device state.</synopsis>\n     <syntax>\n-      <parameter name=\"datatype\" required=\"true\">\n-        <para>The allowable datatypes are:</para>\n-        <enumlist>\n-          <enum name=\"all\"/>\n-          <enum name=\"name\"/>\n-          <enum name=\"name-valid\"/>\n-          <enum name=\"name-charset\"/>\n-          <enum name=\"name-pres\"/>\n-          <enum name=\"num\"/>\n-          <enum name=\"num-valid\"/>\n-          <enum name=\"num-plan\"/>\n-          <enum name=\"num-pres\"/>\n-          <enum name=\"pres\"/>\n-          <enum name=\"subaddr\"/>\n-          <enum name=\"subaddr-valid\"/>\n-          <enum name=\"subaddr-type\"/>\n-          <enum name=\"subaddr-odd\"/>\n-          <enum name=\"tag\"/>\n-          <enum name=\"priv-all\"/>\n-          <enum name=\"priv-name\"/>\n-          <enum name=\"priv-name-valid\"/>\n-          <enum name=\"priv-name-charset\"/>\n-          <enum name=\"priv-name-pres\"/>\n-          <enum name=\"priv-num\"/>\n-          <enum name=\"priv-num-valid\"/>\n-          <enum name=\"priv-num-plan\"/>\n-          <enum name=\"priv-num-pres\"/>\n-          <enum name=\"priv-subaddr\"/>\n-          <enum name=\"priv-subaddr-valid\"/>\n-          <enum name=\"priv-subaddr-type\"/>\n-          <enum name=\"priv-subaddr-odd\"/>\n-          <enum name=\"priv-tag\"/>\n-          <enum name=\"ANI-all\"/>\n-          <enum name=\"ANI-name\"/>\n-          <enum name=\"ANI-name-valid\"/>\n-          <enum name=\"ANI-name-charset\"/>\n-          <enum name=\"ANI-name-pres\"/>\n-          <enum name=\"ANI-num\"/>\n-          <enum name=\"ANI-num-valid\"/>\n-          <enum name=\"ANI-num-plan\"/>\n-          <enum name=\"ANI-num-pres\"/>\n-          <enum name=\"ANI-tag\"/>\n-          <enum name=\"RDNIS\"/>\n-          <enum name=\"DNID\"/>\n-          <enum name=\"dnid-num-plan\"/>\n-          <enum name=\"dnid-subaddr\"/>\n-          <enum name=\"dnid-subaddr-valid\"/>\n-          <enum name=\"dnid-subaddr-type\"/>\n-          <enum name=\"dnid-subaddr-odd\"/>\n-        </enumlist>\n-      </parameter>\n-      <parameter name=\"CID\">\n-        <para>Optional Caller*ID to parse instead of using the Caller*ID from the\n-\t\t\t\tchannel. This parameter is only optional when reading the Caller*ID.</para>\n-      </parameter>\n+      <parameter name=\"device\" required=\"true\"/>\n     </syntax>\n     <description>\n-      <para>Gets or sets Caller*ID data on the channel. Uses channel callerid by\n-\t\t\tdefault or optional callerid, if specified.</para>\n-      <para>\n-        The\n-        <replaceable>pres</replaceable>\n-        field gets/sets a combined value\n-\t\t\tfor\n-        <replaceable>name-pres</replaceable>\n-        and\n-        <replaceable>num-pres</replaceable>\n-        .\n-      </para>\n+      <para>The DEVICE_STATE function can be used to retrieve the device state from any\n+\t\t\tdevice state provider. For example:</para>\n+      <para>NoOp(SIP/mypeer has state ${DEVICE_STATE(SIP/mypeer)})</para>\n+      <para>NoOp(Conference number 1234 has state ${DEVICE_STATE(MeetMe:1234)})</para>\n       <para>\n-        The allowable values for the\n-        <replaceable>name-charset</replaceable>\n-        field are the following:\n+        The DEVICE_STATE function can also be used to set custom device state from\n+\t\t\tthe dialplan.  The\n+        <literal>Custom:</literal>\n+        prefix must be used. For example:\n       </para>\n-      <enumlist>\n-        <enum name=\"unknown\">\n-          <para>Unknown</para>\n-        </enum>\n-        <enum name=\"iso8859-1\">\n-          <para>ISO8859-1</para>\n-        </enum>\n-        <enum name=\"withdrawn\">\n-          <para>Withdrawn</para>\n-        </enum>\n-        <enum name=\"iso8859-2\">\n-          <para>ISO8859-2</para>\n-        </enum>\n-        <enum name=\"iso8859-3\">\n-          <para>ISO8859-3</para>\n-        </enum>\n-        <enum name=\"iso8859-4\">\n-          <para>ISO8859-4</para>\n-        </enum>\n-        <enum name=\"iso8859-5\">\n-          <para>ISO8859-5</para>\n-        </enum>\n-        <enum name=\"iso8859-7\">\n-          <para>ISO8859-7</para>\n-        </enum>\n-        <enum name=\"bmp\">\n-          <para>ISO10646 Bmp String</para>\n-        </enum>\n-        <enum name=\"utf8\">\n-          <para>ISO10646 UTF-8 String</para>\n-        </enum>\n-      </enumlist>\n-    </description>\n-  </function>\n-  <function name=\"CALLERPRES\" language=\"en_US\">\n-    <synopsis>Gets or sets Caller*ID presentation on the channel.</synopsis>\n-    <syntax/>\n-    <description>\n-      <para>Gets or sets Caller*ID presentation on the channel.\n-\t\t\tThis function is deprecated in favor of CALLERID(num-pres)\n-\t\t\tand CALLERID(name-pres) or CALLERID(pres) to get/set both\n-\t\t\tat once.\n-\t\t\tThe following values are valid:</para>\n-      <enumlist>\n-        <enum name=\"allowed_not_screened\">\n-          <para>Presentation Allowed, Not Screened.</para>\n-        </enum>\n-        <enum name=\"allowed_passed_screen\">\n-          <para>Presentation Allowed, Passed Screen.</para>\n-        </enum>\n-        <enum name=\"allowed_failed_screen\">\n-          <para>Presentation Allowed, Failed Screen.</para>\n-        </enum>\n-        <enum name=\"allowed\">\n-          <para>Presentation Allowed, Network Number.</para>\n-        </enum>\n-        <enum name=\"prohib_not_screened\">\n-          <para>Presentation Prohibited, Not Screened.</para>\n-        </enum>\n-        <enum name=\"prohib_passed_screen\">\n-          <para>Presentation Prohibited, Passed Screen.</para>\n-        </enum>\n-        <enum name=\"prohib_failed_screen\">\n-          <para>Presentation Prohibited, Failed Screen.</para>\n-        </enum>\n-        <enum name=\"prohib\">\n-          <para>Presentation Prohibited, Network Number.</para>\n-        </enum>\n-        <enum name=\"unavailable\">\n-          <para>Number Unavailable.</para>\n-        </enum>\n-      </enumlist>\n+      <para>Set(DEVICE_STATE(Custom:lamp1)=BUSY)</para>\n+      <para>Set(DEVICE_STATE(Custom:lamp2)=NOT_INUSE)</para>\n+      <para>You can subscribe to the status of a custom device state using a hint in\n+\t\t\tthe dialplan:</para>\n+      <para>exten =&gt; 1234,hint,Custom:lamp1</para>\n+      <para>The possible values for both uses of this function are:</para>\n+      <para>UNKNOWN | NOT_INUSE | INUSE | BUSY | INVALID | UNAVAILABLE | RINGING |\n+\t\t\tRINGINUSE | ONHOLD</para>\n     </description>\n   </function>\n-  <function name=\"CONNECTEDLINE\" language=\"en_US\">\n-    <synopsis>Gets or sets Connected Line data on the channel.</synopsis>\n+  <function name=\"HINT\" language=\"en_US\">\n+    <synopsis>Get the devices set for a dialplan hint.</synopsis>\n     <syntax>\n-      <parameter name=\"datatype\" required=\"true\">\n-        <para>The allowable datatypes are:</para>\n-        <enumlist>\n-          <enum name=\"all\"/>\n-          <enum name=\"name\"/>\n-          <enum name=\"name-valid\"/>\n-          <enum name=\"name-charset\"/>\n-          <enum name=\"name-pres\"/>\n-          <enum name=\"num\"/>\n-          <enum name=\"num-valid\"/>\n-          <enum name=\"num-plan\"/>\n-          <enum name=\"num-pres\"/>\n-          <enum name=\"pres\"/>\n-          <enum name=\"subaddr\"/>\n-          <enum name=\"subaddr-valid\"/>\n-          <enum name=\"subaddr-type\"/>\n-          <enum name=\"subaddr-odd\"/>\n-          <enum name=\"tag\"/>\n-          <enum name=\"priv-all\"/>\n-          <enum name=\"priv-name\"/>\n-          <enum name=\"priv-name-valid\"/>\n-          <enum name=\"priv-name-charset\"/>\n-          <enum name=\"priv-name-pres\"/>\n-          <enum name=\"priv-num\"/>\n-          <enum name=\"priv-num-valid\"/>\n-          <enum name=\"priv-num-plan\"/>\n-          <enum name=\"priv-num-pres\"/>\n-          <enum name=\"priv-subaddr\"/>\n-          <enum name=\"priv-subaddr-valid\"/>\n-          <enum name=\"priv-subaddr-type\"/>\n-          <enum name=\"priv-subaddr-odd\"/>\n-          <enum name=\"priv-tag\"/>\n-        </enumlist>\n+      <parameter name=\"extension\" required=\"true\" argsep=\"@\">\n+        <argument name=\"extension\" required=\"true\"/>\n+        <argument name=\"context\"/>\n       </parameter>\n-      <parameter name=\"i\">\n-        <para>If set, this will prevent the channel from sending out protocol\n-\t\t\t\tmessages because of the value being set</para>\n+      <parameter name=\"options\">\n+        <optionlist>\n+          <option name=\"n\">\n+            <para>Retrieve name on the hint instead of list of devices.</para>\n+          </option>\n+        </optionlist>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>Gets or sets Connected Line data on the channel.</para>\n-      <para>\n-        The\n-        <replaceable>pres</replaceable>\n-        field gets/sets a combined value\n-\t\t\tfor\n-        <replaceable>name-pres</replaceable>\n-        and\n-        <replaceable>num-pres</replaceable>\n-        .\n-      </para>\n-      <para>\n-        The allowable values for the\n-        <replaceable>name-charset</replaceable>\n-        field are the following:\n-      </para>\n-      <enumlist>\n-        <enum name=\"unknown\">\n-          <para>Unknown</para>\n-        </enum>\n-        <enum name=\"iso8859-1\">\n-          <para>ISO8859-1</para>\n-        </enum>\n-        <enum name=\"withdrawn\">\n-          <para>Withdrawn</para>\n-        </enum>\n-        <enum name=\"iso8859-2\">\n-          <para>ISO8859-2</para>\n-        </enum>\n-        <enum name=\"iso8859-3\">\n-          <para>ISO8859-3</para>\n-        </enum>\n-        <enum name=\"iso8859-4\">\n-          <para>ISO8859-4</para>\n-        </enum>\n-        <enum name=\"iso8859-5\">\n-          <para>ISO8859-5</para>\n-        </enum>\n-        <enum name=\"iso8859-7\">\n-          <para>ISO8859-7</para>\n-        </enum>\n-        <enum name=\"bmp\">\n-          <para>ISO10646 Bmp String</para>\n-        </enum>\n-        <enum name=\"utf8\">\n-          <para>ISO10646 UTF-8 String</para>\n-        </enum>\n-      </enumlist>\n+      <para>The HINT function can be used to retrieve the list of devices that are\n+\t\t\tmapped to a dialplan hint.</para>\n+      <example title=\"Hint for extension 1234\">same =&gt; n,NoOp(Hint for Extension 1234 is ${HINT(1234)})</example>\n     </description>\n   </function>\n-  <function name=\"REDIRECTING\" language=\"en_US\">\n-    <synopsis>Gets or sets Redirecting data on the channel.</synopsis>\n+  <module language=\"en_US\" name=\"func_math\">\n+    <support_level>core</support_level>\n+  </module>\n+  <function name=\"MATH\" language=\"en_US\">\n+    <synopsis>Performs Mathematical Functions.</synopsis>\n     <syntax>\n-      <parameter name=\"datatype\" required=\"true\">\n-        <para>The allowable datatypes are:</para>\n-        <enumlist>\n-          <enum name=\"orig-all\"/>\n-          <enum name=\"orig-name\"/>\n-          <enum name=\"orig-name-valid\"/>\n-          <enum name=\"orig-name-charset\"/>\n-          <enum name=\"orig-name-pres\"/>\n-          <enum name=\"orig-num\"/>\n-          <enum name=\"orig-num-valid\"/>\n-          <enum name=\"orig-num-plan\"/>\n-          <enum name=\"orig-num-pres\"/>\n-          <enum name=\"orig-pres\"/>\n-          <enum name=\"orig-subaddr\"/>\n-          <enum name=\"orig-subaddr-valid\"/>\n-          <enum name=\"orig-subaddr-type\"/>\n-          <enum name=\"orig-subaddr-odd\"/>\n-          <enum name=\"orig-tag\"/>\n-          <enum name=\"orig-reason\"/>\n-          <enum name=\"from-all\"/>\n-          <enum name=\"from-name\"/>\n-          <enum name=\"from-name-valid\"/>\n-          <enum name=\"from-name-charset\"/>\n-          <enum name=\"from-name-pres\"/>\n-          <enum name=\"from-num\"/>\n-          <enum name=\"from-num-valid\"/>\n-          <enum name=\"from-num-plan\"/>\n-          <enum name=\"from-num-pres\"/>\n-          <enum name=\"from-pres\"/>\n-          <enum name=\"from-subaddr\"/>\n-          <enum name=\"from-subaddr-valid\"/>\n-          <enum name=\"from-subaddr-type\"/>\n-          <enum name=\"from-subaddr-odd\"/>\n-          <enum name=\"from-tag\"/>\n-          <enum name=\"to-all\"/>\n-          <enum name=\"to-name\"/>\n-          <enum name=\"to-name-valid\"/>\n-          <enum name=\"to-name-charset\"/>\n-          <enum name=\"to-name-pres\"/>\n-          <enum name=\"to-num\"/>\n-          <enum name=\"to-num-valid\"/>\n-          <enum name=\"to-num-plan\"/>\n-          <enum name=\"to-num-pres\"/>\n-          <enum name=\"to-pres\"/>\n-          <enum name=\"to-subaddr\"/>\n-          <enum name=\"to-subaddr-valid\"/>\n-          <enum name=\"to-subaddr-type\"/>\n-          <enum name=\"to-subaddr-odd\"/>\n-          <enum name=\"to-tag\"/>\n-          <enum name=\"priv-orig-all\"/>\n-          <enum name=\"priv-orig-name\"/>\n-          <enum name=\"priv-orig-name-valid\"/>\n-          <enum name=\"priv-orig-name-charset\"/>\n-          <enum name=\"priv-orig-name-pres\"/>\n-          <enum name=\"priv-orig-num\"/>\n-          <enum name=\"priv-orig-num-valid\"/>\n-          <enum name=\"priv-orig-num-plan\"/>\n-          <enum name=\"priv-orig-num-pres\"/>\n-          <enum name=\"priv-orig-subaddr\"/>\n-          <enum name=\"priv-orig-subaddr-valid\"/>\n-          <enum name=\"priv-orig-subaddr-type\"/>\n-          <enum name=\"priv-orig-subaddr-odd\"/>\n-          <enum name=\"priv-orig-tag\"/>\n-          <enum name=\"priv-from-all\"/>\n-          <enum name=\"priv-from-name\"/>\n-          <enum name=\"priv-from-name-valid\"/>\n-          <enum name=\"priv-from-name-charset\"/>\n-          <enum name=\"priv-from-name-pres\"/>\n-          <enum name=\"priv-from-num\"/>\n-          <enum name=\"priv-from-num-valid\"/>\n-          <enum name=\"priv-from-num-plan\"/>\n-          <enum name=\"priv-from-num-pres\"/>\n-          <enum name=\"priv-from-subaddr\"/>\n-          <enum name=\"priv-from-subaddr-valid\"/>\n-          <enum name=\"priv-from-subaddr-type\"/>\n-          <enum name=\"priv-from-subaddr-odd\"/>\n-          <enum name=\"priv-from-tag\"/>\n-          <enum name=\"priv-to-all\"/>\n-          <enum name=\"priv-to-name\"/>\n-          <enum name=\"priv-to-name-valid\"/>\n-          <enum name=\"priv-to-name-charset\"/>\n-          <enum name=\"priv-to-name-pres\"/>\n-          <enum name=\"priv-to-num\"/>\n-          <enum name=\"priv-to-num-valid\"/>\n-          <enum name=\"priv-to-num-plan\"/>\n-          <enum name=\"priv-to-num-pres\"/>\n-          <enum name=\"priv-to-subaddr\"/>\n-          <enum name=\"priv-to-subaddr-valid\"/>\n-          <enum name=\"priv-to-subaddr-type\"/>\n-          <enum name=\"priv-to-subaddr-odd\"/>\n-          <enum name=\"priv-to-tag\"/>\n-          <enum name=\"reason\"/>\n-          <enum name=\"count\"/>\n-        </enumlist>\n+      <parameter name=\"expression\" required=\"true\">\n+        <para>\n+          Is of the form:\n+          <replaceable>number1</replaceable>\n+          <replaceable>op</replaceable>\n+          <replaceable>number2</replaceable>\n+          where the possible values for\n+          <replaceable>op</replaceable>\n+          are:\n+        </para>\n+        <para>+,-,/,*,%,&lt;&lt;,&gt;&gt;,^,AND,OR,XOR,&lt;,&gt;,&lt;=,&gt;=,== (and behave as their C equivalents)</para>\n       </parameter>\n-      <parameter name=\"i\">\n-        <para>If set, this will prevent the channel from sending out protocol\n-\t\t\t\tmessages because of the value being set</para>\n+      <parameter name=\"type\">\n+        <para>Wanted type of result:</para>\n+        <para>f, float - float(default)</para>\n+        <para>i, int - integer</para>\n+        <para>h, hex - hex</para>\n+        <para>c, char - char</para>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>Gets or sets Redirecting data on the channel.</para>\n-      <para>\n-        The\n-        <replaceable>orig-pres</replaceable>\n-        ,\n-        <replaceable>from-pres</replaceable>\n-        and\n-        <replaceable>to-pres</replaceable>\n-        fields get/set a combined value for the corresponding\n-        <replaceable>...-name-pres</replaceable>\n-        and\n-        <replaceable>...-num-pres</replaceable>\n-        fields.\n-      </para>\n-      <para>\n-        The recognized values for the\n-        <replaceable>reason</replaceable>\n-        and\n-        <replaceable>orig-reason</replaceable>\n-        fields are the following:\n-      </para>\n-      <enumlist>\n-        <enum name=\"away\">\n-          <para>Callee is Away</para>\n-        </enum>\n-        <enum name=\"cf_dte\">\n-          <para>Call Forwarding By The Called DTE</para>\n-        </enum>\n-        <enum name=\"cfb\">\n-          <para>Call Forwarding Busy</para>\n-        </enum>\n-        <enum name=\"cfnr\">\n-          <para>Call Forwarding No Reply</para>\n-        </enum>\n-        <enum name=\"cfu\">\n-          <para>Call Forwarding Unconditional</para>\n-        </enum>\n-        <enum name=\"deflection\">\n-          <para>Call Deflection</para>\n-        </enum>\n-        <enum name=\"dnd\">\n-          <para>Do Not Disturb</para>\n-        </enum>\n-        <enum name=\"follow_me\">\n-          <para>Follow Me</para>\n-        </enum>\n-        <enum name=\"out_of_order\">\n-          <para>Called DTE Out-Of-Order</para>\n-        </enum>\n-        <enum name=\"send_to_vm\">\n-          <para>Send the call to voicemail</para>\n-        </enum>\n-        <enum name=\"time_of_day\">\n-          <para>Time of Day</para>\n-        </enum>\n-        <enum name=\"unavailable\">\n-          <para>Callee is Unavailable</para>\n-        </enum>\n-        <enum name=\"unknown\">\n-          <para>Unknown</para>\n-        </enum>\n-      </enumlist>\n-      <note>\n-        <para>You can set a user defined reason string that SIP can\n-\t\t\tsend/receive instead.  The user defined reason string my need to be\n-\t\t\tquoted depending upon SIP or the peer's requirements.  These strings\n-\t\t\tare treated as unknown by the non-SIP channel drivers.</para>\n-      </note>\n       <para>\n-        The allowable values for the\n-        <replaceable>xxx-name-charset</replaceable>\n-        field are the following:\n+        Performs mathematical functions based on two parameters and an operator.  The returned\n+\t\t\tvalue type is\n+        <replaceable>type</replaceable>\n       </para>\n-      <enumlist>\n-        <enum name=\"unknown\">\n-          <para>Unknown</para>\n-        </enum>\n-        <enum name=\"iso8859-1\">\n-          <para>ISO8859-1</para>\n-        </enum>\n-        <enum name=\"withdrawn\">\n-          <para>Withdrawn</para>\n-        </enum>\n-        <enum name=\"iso8859-2\">\n-          <para>ISO8859-2</para>\n-        </enum>\n-        <enum name=\"iso8859-3\">\n-          <para>ISO8859-3</para>\n-        </enum>\n-        <enum name=\"iso8859-4\">\n-          <para>ISO8859-4</para>\n-        </enum>\n-        <enum name=\"iso8859-5\">\n-          <para>ISO8859-5</para>\n-        </enum>\n-        <enum name=\"iso8859-7\">\n-          <para>ISO8859-7</para>\n-        </enum>\n-        <enum name=\"bmp\">\n-          <para>ISO10646 Bmp String</para>\n-        </enum>\n-        <enum name=\"utf8\">\n-          <para>ISO10646 UTF-8 String</para>\n-        </enum>\n-      </enumlist>\n+      <example title=\"Sets var i to 11\">same =&gt; n,Set(i=${MATH(123%16,int)})</example>\n     </description>\n   </function>\n-  <module language=\"en_US\" name=\"func_base64\">\n-    <support_level>core</support_level>\n-  </module>\n-  <function name=\"BASE64_ENCODE\" language=\"en_US\">\n-    <synopsis>Encode a string in base64.</synopsis>\n+  <function name=\"INC\" language=\"en_US\">\n+    <synopsis>Increments the value of a variable, while returning the updated value to the dialplan</synopsis>\n     <syntax>\n-      <parameter name=\"string\" required=\"true\">\n-        <para>Input string</para>\n+      <parameter name=\"variable\" required=\"true\">\n+        <para>The variable name to be manipulated, without the braces.</para>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>Returns the base64 string.</para>\n+      <para>Increments the value of a variable, while returning the updated value to the dialplan</para>\n+      <para>Example: INC(MyVAR) - Increments MyVar</para>\n+      <para>Note: INC(${MyVAR}) - Is wrong, as INC expects the variable name, not its value</para>\n     </description>\n-    <see-also>\n-      <ref type=\"function\">BASE64_DECODE</ref>\n-      <ref type=\"function\">AES_DECRYPT</ref>\n-      <ref type=\"function\">AES_ENCRYPT</ref>\n-    </see-also>\n   </function>\n-  <function name=\"BASE64_DECODE\" language=\"en_US\">\n-    <synopsis>Decode a base64 string.</synopsis>\n+  <function name=\"DEC\" language=\"en_US\">\n+    <synopsis>Decrements the value of a variable, while returning the updated value to the dialplan</synopsis>\n     <syntax>\n-      <parameter name=\"string\" required=\"true\">\n-        <para>Input string.</para>\n+      <parameter name=\"variable\" required=\"true\">\n+        <para>The variable name to be manipulated, without the braces.</para>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>Returns the plain text string.</para>\n+      <para>Decrements the value of a variable, while returning the updated value to the dialplan</para>\n+      <example title=\"Decrements MyVAR\">same =&gt; n,NoOp(${DEC(MyVAR)})</example>\n+      <note>\n+        <para>DEC(${MyVAR}) is wrong, as DEC expects the variable name, not its value</para>\n+      </note>\n     </description>\n-    <see-also>\n-      <ref type=\"function\">BASE64_ENCODE</ref>\n-      <ref type=\"function\">AES_DECRYPT</ref>\n-      <ref type=\"function\">AES_ENCRYPT</ref>\n-    </see-also>\n   </function>\n-  <module language=\"en_US\" name=\"func_module\">\n-    <support_level>core</support_level>\n-  </module>\n-  <function name=\"IFMODULE\" language=\"en_US\">\n-    <synopsis>Checks if an Asterisk module is loaded in memory.</synopsis>\n+  <function name=\"MIN\" language=\"en_US\">\n+    <since>\n+      <version>16.19.0</version>\n+      <version>18.5.0</version>\n+      <version>19.0.0</version>\n+    </since>\n+    <synopsis>Returns the minimum of two numbers.</synopsis>\n     <syntax>\n-      <parameter name=\"modulename.so\" required=\"true\">\n-        <para>\n-          Module name complete with\n-          <literal>.so</literal>\n-        </para>\n-      </parameter>\n+      <parameter name=\"num1\"/>\n+      <parameter name=\"num2\"/>\n     </syntax>\n     <description>\n       <para>\n-        Checks if a module is loaded. Use the full module name\n-\t\t\tas shown by the list in\n-        <literal>module list</literal>\n+        Returns the minimum of two numbers\n+        <replaceable>num1</replaceable>\n+        and\n+        <replaceable>num2</replaceable>\n         .\n-\t\t\tReturns\n-        <literal>1</literal>\n-        if module exists in memory, otherwise\n-        <literal>0</literal>\n       </para>\n+      <example title=\"Sets the min variable equal to 4\">same =&gt; n,Set(min=${MIN(7,4)})</example>\n     </description>\n   </function>\n-  <module language=\"en_US\" name=\"func_db\">\n-    <support_level>core</support_level>\n-  </module>\n-  <function name=\"DB\" language=\"en_US\">\n-    <synopsis>Read from or write to the Asterisk database.</synopsis>\n-    <syntax argsep=\"/\">\n-      <parameter name=\"family\" required=\"true\"/>\n-      <parameter name=\"key\" required=\"true\"/>\n+  <function name=\"MAX\" language=\"en_US\">\n+    <since>\n+      <version>16.19.0</version>\n+      <version>18.5.0</version>\n+      <version>19.0.0</version>\n+    </since>\n+    <synopsis>Returns the maximum of two numbers.</synopsis>\n+    <syntax>\n+      <parameter name=\"num1\"/>\n+      <parameter name=\"num2\"/>\n     </syntax>\n     <description>\n-      <para>This function will read from or write a value to the Asterisk database.  On a\n-\t\t\tread, this function returns the corresponding value from the database, or blank\n-\t\t\tif it does not exist.  Reading a database value will also set the variable\n-\t\t\tDB_RESULT.  If you wish to find out if an entry exists, use the DB_EXISTS\n-\t\t\tfunction.</para>\n+      <para>\n+        Returns the maximum of two numbers\n+        <replaceable>num1</replaceable>\n+        and\n+        <replaceable>num2</replaceable>\n+        .\n+      </para>\n+      <example title=\"Sets the max variable equal to 13\">same =&gt; n,Set(max=${MAX(4,7)})</example>\n     </description>\n-    <see-also>\n-      <ref type=\"application\">DBdel</ref>\n-      <ref type=\"function\">DB_DELETE</ref>\n-      <ref type=\"application\">DBdeltree</ref>\n-      <ref type=\"function\">DB_EXISTS</ref>\n-    </see-also>\n   </function>\n-  <function name=\"DB_EXISTS\" language=\"en_US\">\n-    <synopsis>Check to see if a key exists in the Asterisk database.</synopsis>\n-    <syntax argsep=\"/\">\n-      <parameter name=\"family\" required=\"true\"/>\n-      <parameter name=\"key\" required=\"true\"/>\n+  <function name=\"ABS\" language=\"en_US\">\n+    <since>\n+      <version>16.19.0</version>\n+      <version>18.5.0</version>\n+      <version>19.0.0</version>\n+    </since>\n+    <synopsis>Returns absolute value of a number.</synopsis>\n+    <syntax>\n+      <parameter name=\"num\"/>\n     </syntax>\n     <description>\n       <para>\n-        This function will check to see if a key exists in the Asterisk\n-\t\t\tdatabase. If it exists, the function will return\n-        <literal>1</literal>\n-        . If not,\n-\t\t\tit will return\n-        <literal>0</literal>\n-        .  Checking for existence of a database key will\n-\t\t\talso set the variable DB_RESULT to the key's value if it exists.\n+        Returns the absolute value of a number\n+        <replaceable>num</replaceable>\n+        .\n       </para>\n+      <example title=\"Sets the absval variable equal to 13\">same =&gt; n,Set(absval=${ABS(-13)})</example>\n     </description>\n-    <see-also>\n-      <ref type=\"function\">DB</ref>\n-    </see-also>\n   </function>\n-  <function name=\"DB_KEYS\" language=\"en_US\">\n-    <synopsis>Obtain a list of keys within the Asterisk database.</synopsis>\n+  <module language=\"en_US\" name=\"func_sayfiles\">\n+    <support_level>extended</support_level>\n+  </module>\n+  <function name=\"SAYFILES\" language=\"en_US\">\n+    <since>\n+      <version>16.21.0</version>\n+      <version>18.7.0</version>\n+      <version>19.0.0</version>\n+    </since>\n+    <synopsis>Returns the ampersand-delimited file names that would be played by the Say applications (e.g. SayAlpha, SayDigits).</synopsis>\n     <syntax>\n-      <parameter name=\"prefix\"/>\n+      <parameter name=\"value\" required=\"true\">\n+        <para>The value to be translated to filenames.</para>\n+      </parameter>\n+      <parameter name=\"type\">\n+        <para>Say application type.</para>\n+        <enumlist>\n+          <enum name=\"alpha\">\n+            <para>Files played by SayAlpha(). Default if none is specified.</para>\n+          </enum>\n+          <enum name=\"digits\">\n+            <para>Files played by SayDigits().</para>\n+          </enum>\n+          <enum name=\"money\">\n+            <para>Files played by SayMoney(). Currently supported for English and US dollars only.</para>\n+          </enum>\n+          <enum name=\"number\">\n+            <para>Files played by SayNumber(). Currently supported for English only.</para>\n+          </enum>\n+          <enum name=\"ordinal\">\n+            <para>Files played by SayOrdinal(). Currently supported for English only.</para>\n+          </enum>\n+          <enum name=\"phonetic\">\n+            <para>Files played by SayPhonetic().</para>\n+          </enum>\n+        </enumlist>\n+      </parameter>\n     </syntax>\n     <description>\n-      <para>This function will return a comma-separated list of keys existing\n-\t\t\tat the prefix specified within the Asterisk database.  If no argument is\n-\t\t\tprovided, then a list of key families will be returned.</para>\n+      <para>Returns the files that would be played by a Say application. These filenames could then be\n+\t\t\tpassed directly into Playback, BackGround, Read, Queue, or any application which supports\n+\t\t\tplayback of multiple ampersand-delimited files.</para>\n+      <example title=\"Read using the number 123\">same =&gt; n,Read(response,${SAYFILES(123,number)})</example>\n     </description>\n     <see-also>\n-      <ref type=\"function\">DB_KEYCOUNT</ref>\n+      <ref type=\"application\">SayAlpha</ref>\n+      <ref type=\"application\">SayDigits</ref>\n+      <ref type=\"application\">SayMoney</ref>\n+      <ref type=\"application\">SayNumber</ref>\n+      <ref type=\"application\">SayOrdinal</ref>\n+      <ref type=\"application\">SayPhonetic</ref>\n     </see-also>\n   </function>\n-  <function name=\"DB_KEYCOUNT\" language=\"en_US\">\n-    <synopsis>Obtain the number of keys at a prefix within the Asterisk database.</synopsis>\n+  <module language=\"en_US\" name=\"func_sprintf\">\n+    <support_level>core</support_level>\n+  </module>\n+  <function name=\"SPRINTF\" language=\"en_US\">\n+    <synopsis>Format a variable according to a format string.</synopsis>\n     <syntax>\n-      <parameter name=\"prefix\"/>\n+      <parameter name=\"format\" required=\"true\"/>\n+      <parameter name=\"arg1\" required=\"true\"/>\n+      <parameter name=\"arg2\" multiple=\"true\"/>\n+      <parameter name=\"argN\"/>\n     </syntax>\n     <description>\n-      <para>This function will return the number of keys that exist\n-\t\t\tat the prefix specified within the Asterisk database.  If no argument is\n-\t\t\tprovided, then the number of all key families will be returned.</para>\n+      <para>\n+        Parses the format string specified and returns a string matching\n+\t\t\tthat format. Supports most options found in\n+        <emphasis>sprintf(3)</emphasis>\n+        .\n+\t\t\tReturns a shortened string if a format specifier is not recognized.\n+      </para>\n     </description>\n     <see-also>\n-      <ref type=\"function\">DB_KEYS</ref>\n+      <ref type=\"manpage\">sprintf(3)</ref>\n     </see-also>\n   </function>\n-  <function name=\"DB_DELETE\" language=\"en_US\">\n-    <synopsis>Return a value from the database and delete it.</synopsis>\n-    <syntax argsep=\"/\">\n-      <parameter name=\"family\" required=\"true\"/>\n-      <parameter name=\"key\" required=\"true\"/>\n+  <module language=\"en_US\" name=\"func_periodic_hook\">\n+    <depend>app_chanspy</depend>\n+    <depend>func_cut</depend>\n+    <depend>func_groupcount</depend>\n+    <depend>func_uri</depend>\n+    <support_level>core</support_level>\n+  </module>\n+  <function name=\"PERIODIC_HOOK\" language=\"en_US\">\n+    <synopsis>Execute a periodic dialplan hook into the audio of a call.</synopsis>\n+    <syntax>\n+      <parameter name=\"context\" required=\"true\">\n+        <para>(On Read Only) Context for the hook extension.</para>\n+      </parameter>\n+      <parameter name=\"extension\" required=\"true\">\n+        <para>(On Read Only) The hook extension.</para>\n+      </parameter>\n+      <parameter name=\"interval\" required=\"true\">\n+        <para>(On Read Only) Number of seconds in between hook runs.\n+\t\t\t\tWhole seconds only.</para>\n+      </parameter>\n+      <parameter name=\"hook_id\" required=\"true\">\n+        <para>(On Write Only) The hook ID.</para>\n+      </parameter>\n     </syntax>\n     <description>\n       <para>\n-        This function will retrieve a value from the Asterisk database\n-\t\t\tand then remove that key from the database.\n-        <variable>DB_RESULT</variable>\n-        will be set to the key's value if it exists.\n+        For example, you could use this function to enable playing\n+\t\t\ta periodic\n+        <literal>beep</literal>\n+        sound in a call.\n+      </para>\n+      <para/>\n+      <example title=\"To turn on\">same =&gt; n,Set(BEEPID=${PERIODIC_HOOK(hooks,beep,180)})</example>\n+      <example title=\"To turn off\">same =&gt; n,Set(PERIODIC_HOOK(${BEEPID})=off)</example>\n+      <example title=\"To turn back on again later\">same =&gt; n,Set(PERIODIC_HOOK(${BEEPID})=on)</example>\n+      <para>It is important to note that the hook does not actually\n+\t\t\trun on the channel itself.  It runs asynchronously on a new channel.\n+\t\t\tAny audio generated by the hook gets injected into the call for\n+\t\t\tthe channel PERIODIC_HOOK() was set on.</para>\n+      <para/>\n+      <para>\n+        The hook dialplan will have two variables available.\n+        <variable>HOOK_CHANNEL</variable>\n+        is the channel the hook is\n+\t\t\tenabled on.\n+        <variable>HOOK_ID</variable>\n+        is the hook ID for\n+\t\t\tenabling or disabling the hook.\n       </para>\n-      <note>\n-        <para>\n-          If\n-          <literal>live_dangerously</literal>\n-          in\n-          <literal>asterisk.conf</literal>\n-          is set to\n-          <literal>no</literal>\n-          , this function can only be read from the\n-\t\t\t\tdialplan, and not directly from external protocols. It can, however, be\n-\t\t\t\texecuted as a write operation (\n-          <literal>DB_DELETE(family, key)=ignored</literal>\n-          )\n-        </para>\n-      </note>\n     </description>\n-    <see-also>\n-      <ref type=\"application\">DBdel</ref>\n-      <ref type=\"function\">DB</ref>\n-      <ref type=\"application\">DBdeltree</ref>\n-    </see-also>\n   </function>\n   <module language=\"en_US\" name=\"func_global\">\n     <support_level>core</support_level>\n   </module>\n   <function name=\"GLOBAL\" language=\"en_US\">\n     <synopsis>Gets or sets the global variable specified.</synopsis>\n     <syntax>\n@@ -18877,14 +19147,42 @@\n         </parameter>\n       </syntax>\n       <see-also>\n         <ref type=\"function\">SHARED</ref>\n       </see-also>\n     </managerEventInstance>\n   </managerEvent>\n+  <module language=\"en_US\" name=\"func_pjsip_endpoint\">\n+    <depend>pjproject</depend>\n+    <depend>res_pjsip</depend>\n+    <support_level>core</support_level>\n+  </module>\n+  <function name=\"PJSIP_ENDPOINT\" language=\"en_US\">\n+    <synopsis>Get information about a PJSIP endpoint</synopsis>\n+    <syntax>\n+      <parameter name=\"name\" required=\"true\">\n+        <para>The name of the endpoint to query.</para>\n+      </parameter>\n+      <parameter name=\"field\" required=\"true\">\n+        <para>\n+          The configuration option for the endpoint to query for.\n+\t\t\t\tSupported options are those fields on the\n+          <replaceable>endpoint</replaceable>\n+          object in\n+          <filename>pjsip.conf</filename>\n+          .\n+        </para>\n+        <enumlist>\n+          <configOptionToEnum>\n+            <xi:include xpointer=\"xpointer(/docs/configInfo[@name='res_pjsip']/configFile[@name='pjsip.conf']/configObject[@name='endpoint']/configOption)\"/>\n+          </configOptionToEnum>\n+        </enumlist>\n+      </parameter>\n+    </syntax>\n+  </function>\n   <module language=\"en_US\" name=\"func_pjsip_contact\">\n     <depend>pjproject</depend>\n     <depend>res_pjsip</depend>\n     <support_level>core</support_level>\n   </module>\n   <function name=\"PJSIP_CONTACT\" language=\"en_US\">\n     <synopsis>Get information about a PJSIP contact</synopsis>\n@@ -18909,303 +19207,347 @@\n           <enum name=\"status\">\n             <para>Status of the contact</para>\n           </enum>\n         </enumlist>\n       </parameter>\n     </syntax>\n   </function>\n-  <module language=\"en_US\" name=\"func_holdintercept\">\n-    <support_level>core</support_level>\n+  <module language=\"en_US\" name=\"func_scramble\">\n+    <support_level>extended</support_level>\n   </module>\n-  <function name=\"HOLD_INTERCEPT\" language=\"en_US\">\n-    <synopsis>Intercepts hold frames on a channel and raises an event instead of passing the frame on</synopsis>\n+  <function name=\"SCRAMBLE\" language=\"en_US\">\n+    <since>\n+      <version>16.21.0</version>\n+      <version>18.7.0</version>\n+      <version>19.0.0</version>\n+    </since>\n+    <synopsis>Scrambles audio on a channel.</synopsis>\n     <syntax>\n-      <parameter name=\"action\" required=\"true\">\n-        <optionlist>\n-          <option name=\"remove\">\n-            <para>W/O. Removes the hold interception function.</para>\n-          </option>\n-          <option name=\"set\">\n-            <para>W/O. Enable hold interception on the channel. When\n-\t\t\t\t\t\tenabled, the channel will intercept any hold action that\n-\t\t\t\t\t\tis signalled from the device, and instead simply raise an\n-\t\t\t\t\t\tevent (AMI/ARI) indicating that the channel wanted to put other\n-\t\t\t\t\t\tparties on hold.</para>\n-          </option>\n-        </optionlist>\n+      <parameter name=\"direction\" required=\"false\">\n+        <para>\n+          Must be\n+          <literal>TX</literal>\n+          or\n+          <literal>RX</literal>\n+          to limit to a specific direction, or\n+          <literal>both</literal>\n+          for both directions.\n+          <literal>remove</literal>\n+          will remove an existing scrambler.\n+        </para>\n       </parameter>\n     </syntax>\n-  </function>\n-  <module language=\"en_US\" name=\"func_sprintf\">\n-    <support_level>core</support_level>\n-  </module>\n-  <function name=\"SPRINTF\" language=\"en_US\">\n-    <synopsis>Format a variable according to a format string.</synopsis>\n-    <syntax>\n-      <parameter name=\"format\" required=\"true\"/>\n-      <parameter name=\"arg1\" required=\"true\"/>\n-      <parameter name=\"arg2\" multiple=\"true\"/>\n-      <parameter name=\"argN\"/>\n-    </syntax>\n     <description>\n-      <para>\n-        Parses the format string specified and returns a string matching\n-\t\t\tthat format. Supports most options found in\n-        <emphasis>sprintf(3)</emphasis>\n-        .\n-\t\t\tReturns a shortened string if a format specifier is not recognized.\n-      </para>\n+      <para>Scrambles audio on a channel using whole spectrum inversion.\n+\t\t\tThis is not intended to be used for securely scrambling\n+\t\t\taudio. It merely renders obfuscates audio on a channel\n+\t\t\tto render it unintelligible, as a privacy enhancement.</para>\n     </description>\n     <see-also>\n-      <ref type=\"manpage\">sprintf(3)</ref>\n+      <ref type=\"application\">ChanSpy</ref>\n     </see-also>\n   </function>\n-  <module language=\"en_US\" name=\"func_srv\">\n-    <support_level>core</support_level>\n+  <module language=\"en_US\" name=\"func_frame_drop\">\n+    <support_level>extended</support_level>\n   </module>\n-  <function name=\"SRVQUERY\" language=\"en_US\">\n-    <synopsis>Initiate an SRV query.</synopsis>\n+  <function name=\"FRAME_DROP\" language=\"en_US\">\n+    <since>\n+      <version>16.21.0</version>\n+      <version>18.7.0</version>\n+      <version>19.0.0</version>\n+    </since>\n+    <synopsis>Drops specific frame types in the TX or RX direction on a channel.</synopsis>\n     <syntax>\n-      <parameter name=\"service\" required=\"true\">\n+      <parameter name=\"direction\" required=\"true\">\n         <para>\n-          The service for which to look up SRV records. An example would be something\n-\t\t\t\tlike\n-          <literal>_sip._udp.example.com</literal>\n+          List of frame types to be dropped for the specified direction. Direction can be\n+          <literal>TX</literal>\n+          or\n+          <literal>RX</literal>\n+          . The\n+          <literal>TX</literal>\n+          direction will prevent Asterisk from sending frames to a channel, and the\n+          <literal>RX</literal>\n+          direction will prevent Asterisk from receiving frames from a channel.\n         </para>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>This will do an SRV lookup of the given service.</para>\n-    </description>\n-  </function>\n-  <function name=\"SRVRESULT\" language=\"en_US\">\n-    <synopsis>Retrieve results from an SRVQUERY.</synopsis>\n-    <syntax>\n-      <parameter name=\"id\" required=\"true\">\n-        <para>The identifier returned by the SRVQUERY function.</para>\n-      </parameter>\n-      <parameter name=\"resultnum\" required=\"true\">\n-        <para>The number of the result that you want to retrieve.</para>\n+        <para>Subsequent calls to this function will replace previous settings, allowing certain frames to be dropped only temporarily, for instance.</para>\n         <para>\n-          Results start at\n-          <literal>1</literal>\n-          . If this argument is specified\n-\t\t\t\tas\n-          <literal>getnum</literal>\n-          , then it will return the total number of results\n-\t\t\t\tthat are available.\n+          Below are the different types of frames that can be dropped. Other actions may need to be taken in conjunction with use of this function:\n+\t\t\t\tfor instance, if you drop ANSWER control frames, you should explicitly use\n+          <literal>Progress()</literal>\n+          for your call or undesired behavior\n+\t\t\t\tmay occur.\n         </para>\n+        <enumlist>\n+          <enum name=\"DTMF_BEGIN\"/>\n+          <enum name=\"DTMF_END\"/>\n+          <enum name=\"VOICE\"/>\n+          <enum name=\"VIDEO\"/>\n+          <enum name=\"CONTROL\"/>\n+          <enum name=\"NULL\"/>\n+          <enum name=\"IAX\"/>\n+          <enum name=\"TEXT\"/>\n+          <enum name=\"TEXT_DATA\"/>\n+          <enum name=\"IMAGE\"/>\n+          <enum name=\"HTML\"/>\n+          <enum name=\"CNG\"/>\n+          <enum name=\"MODEM\"/>\n+        </enumlist>\n+        <para>The following CONTROL frames can also be dropped:</para>\n+        <enumlist>\n+          <enum name=\"RING\"/>\n+          <enum name=\"RINGING\"/>\n+          <enum name=\"ANSWER\"/>\n+          <enum name=\"BUSY\"/>\n+          <enum name=\"TAKEOFFHOOK\"/>\n+          <enum name=\"OFFHOOK\"/>\n+          <enum name=\"CONGESTION\"/>\n+          <enum name=\"FLASH\"/>\n+          <enum name=\"WINK\"/>\n+          <enum name=\"PROGRESS\"/>\n+          <enum name=\"PROCEEDING\"/>\n+          <enum name=\"HOLD\"/>\n+          <enum name=\"UNHOLD\"/>\n+          <enum name=\"VIDUPDATE\"/>\n+          <enum name=\"CONNECTED_LINE\"/>\n+          <enum name=\"REDIRECTING\"/>\n+        </enumlist>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>This function will retrieve results from a previous use\n-\t\t\tof the SRVQUERY function.</para>\n+      <para>Examples:</para>\n+      <example title=\"Drop only DTMF frames towards this channel\">exten =&gt; 1,1,Set(FRAME_DROP(TX)=DTMF_BEGIN,DTMF_END)</example>\n+      <example title=\"Drop only Answer control frames towards this channel\">exten =&gt; 1,1,Set(FRAME_DROP(TX)=ANSWER)</example>\n+      <example title=\"Drop only DTMF frames received on this channel\">exten =&gt; 1,1,Set(FRAME_DROP(RX)=DTMF_BEGIN,DTMF_END)</example>\n     </description>\n   </function>\n-  <module language=\"en_US\" name=\"func_speex\">\n-    <depend>speex</depend>\n-    <depend>speex_preprocess</depend>\n-    <use type=\"external\">speexdsp</use>\n+  <module language=\"en_US\" name=\"func_lock\">\n     <support_level>core</support_level>\n   </module>\n-  <function name=\"AGC\" language=\"en_US\">\n-    <synopsis>Apply automatic gain control to audio on a channel.</synopsis>\n+  <function name=\"LOCK\" language=\"en_US\">\n+    <synopsis>Attempt to obtain a named mutex.</synopsis>\n     <syntax>\n-      <parameter name=\"channeldirection\" required=\"true\">\n-        <para>\n-          This can be either\n-          <literal>rx</literal>\n-          or\n-          <literal>tx</literal>\n-        </para>\n-      </parameter>\n+      <parameter name=\"lockname\" required=\"true\"/>\n     </syntax>\n     <description>\n       <para>\n-        The AGC function will apply automatic gain control to the audio on the\n-\t\t\tchannel that it is executed on. Using\n-        <literal>rx</literal>\n-        for audio received\n-\t\t\tand\n-        <literal>tx</literal>\n-        for audio transmitted to the channel. When using this\n-\t\t\tfunction you set a target audio level. It is primarily intended for use with\n-\t\t\tanalog lines, but could be useful for other channels as well. The target volume\n-\t\t\tis set with a number between\n-        <literal>1-32768</literal>\n-        . The larger the number\n-\t\t\tthe louder (more gain) the channel will receive.\n+        Attempts to grab a named lock exclusively, and prevents other channels from\n+\t\t\tobtaining the same lock.  LOCK will wait for the lock to become available.\n+\t\t\tReturns\n+        <literal>1</literal>\n+        if the lock was obtained or\n+        <literal>0</literal>\n+        on error.\n       </para>\n-      <example title=\"Apply automatic gain control\">exten =&gt; 1,1,Set(AGC(rx)=8000)\n-\t\t\texten =&gt; 1,2,Set(AGC(tx)=off)</example>\n+      <note>\n+        <para>To avoid the possibility of a deadlock, LOCK will only attempt to\n+\t\t\tobtain the lock for 3 seconds if the channel already has another lock.</para>\n+      </note>\n+      <note>\n+        <para>\n+          If\n+          <literal>live_dangerously</literal>\n+          in\n+          <literal>asterisk.conf</literal>\n+          is set to\n+          <literal>no</literal>\n+          , this function can only be executed from the\n+\t\t\t\tdialplan, and not directly from external protocols.\n+        </para>\n+      </note>\n     </description>\n   </function>\n-  <function name=\"DENOISE\" language=\"en_US\">\n-    <synopsis>Apply noise reduction to audio on a channel.</synopsis>\n+  <function name=\"TRYLOCK\" language=\"en_US\">\n+    <synopsis>Attempt to obtain a named mutex.</synopsis>\n     <syntax>\n-      <parameter name=\"channeldirection\" required=\"true\">\n+      <parameter name=\"lockname\" required=\"true\"/>\n+    </syntax>\n+    <description>\n+      <para>\n+        Attempts to grab a named lock exclusively, and prevents other channels\n+\t\t\tfrom obtaining the same lock.  Returns\n+        <literal>1</literal>\n+        if the lock was\n+\t\t\tavailable or\n+        <literal>0</literal>\n+        otherwise.\n+      </para>\n+      <note>\n         <para>\n-          This can be either\n-          <literal>rx</literal>\n-          or\n-          <literal>tx</literal>\n-          the values that can be set to this are either\n-          <literal>on</literal>\n-          and\n-          <literal>off</literal>\n+          If\n+          <literal>live_dangerously</literal>\n+          in\n+          <literal>asterisk.conf</literal>\n+          is set to\n+          <literal>no</literal>\n+          , this function can only be executed from the\n+\t\t\t\tdialplan, and not directly from external protocols.\n         </para>\n-      </parameter>\n+      </note>\n+    </description>\n+  </function>\n+  <function name=\"UNLOCK\" language=\"en_US\">\n+    <synopsis>Unlocks a named mutex.</synopsis>\n+    <syntax>\n+      <parameter name=\"lockname\" required=\"true\"/>\n     </syntax>\n     <description>\n       <para>\n-        The DENOISE function will apply noise reduction to audio on the channel\n-\t\t\tthat it is executed on. It is very useful for noisy analog lines, especially\n-\t\t\twhen adjusting gains or using AGC. Use\n-        <literal>rx</literal>\n-        for audio received from the channel\n-\t\t\tand\n-        <literal>tx</literal>\n-        to apply the filter to the audio being sent to the channel.\n+        Unlocks a previously locked mutex. Returns\n+        <literal>1</literal>\n+        if the channel\n+\t\t\thad a lock or\n+        <literal>0</literal>\n+        otherwise.\n       </para>\n-      <example title=\"Apply noise reduction\">exten =&gt; 1,1,Set(DENOISE(rx)=on)\n-\t\t\texten =&gt; 1,2,Set(DENOISE(tx)=off)</example>\n+      <note>\n+        <para>It is generally unnecessary to unlock in a hangup routine, as any locks\n+\t\t\theld are automatically freed when the channel is destroyed.</para>\n+      </note>\n+      <note>\n+        <para>\n+          If\n+          <literal>live_dangerously</literal>\n+          in\n+          <literal>asterisk.conf</literal>\n+          is set to\n+          <literal>no</literal>\n+          , this function can only be executed from the\n+\t\t\t\tdialplan, and not directly from external protocols.\n+        </para>\n+      </note>\n     </description>\n   </function>\n-  <module language=\"en_US\" name=\"func_devstate\">\n+  <module language=\"en_US\" name=\"func_logic\">\n     <support_level>core</support_level>\n   </module>\n-  <function name=\"DEVICE_STATE\" language=\"en_US\">\n-    <synopsis>Get or Set a device state.</synopsis>\n+  <function name=\"ISNULL\" language=\"en_US\">\n+    <synopsis>Check if a value is NULL.</synopsis>\n     <syntax>\n-      <parameter name=\"device\" required=\"true\"/>\n+      <parameter name=\"data\" required=\"true\"/>\n     </syntax>\n     <description>\n-      <para>The DEVICE_STATE function can be used to retrieve the device state from any\n-\t\t\tdevice state provider. For example:</para>\n-      <para>NoOp(SIP/mypeer has state ${DEVICE_STATE(SIP/mypeer)})</para>\n-      <para>NoOp(Conference number 1234 has state ${DEVICE_STATE(MeetMe:1234)})</para>\n       <para>\n-        The DEVICE_STATE function can also be used to set custom device state from\n-\t\t\tthe dialplan.  The\n-        <literal>Custom:</literal>\n-        prefix must be used. For example:\n+        Returns\n+        <literal>1</literal>\n+        if NULL or\n+        <literal>0</literal>\n+        otherwise.\n       </para>\n-      <para>Set(DEVICE_STATE(Custom:lamp1)=BUSY)</para>\n-      <para>Set(DEVICE_STATE(Custom:lamp2)=NOT_INUSE)</para>\n-      <para>You can subscribe to the status of a custom device state using a hint in\n-\t\t\tthe dialplan:</para>\n-      <para>exten =&gt; 1234,hint,Custom:lamp1</para>\n-      <para>The possible values for both uses of this function are:</para>\n-      <para>UNKNOWN | NOT_INUSE | INUSE | BUSY | INVALID | UNAVAILABLE | RINGING |\n-\t\t\tRINGINUSE | ONHOLD</para>\n     </description>\n   </function>\n-  <function name=\"HINT\" language=\"en_US\">\n-    <synopsis>Get the devices set for a dialplan hint.</synopsis>\n-    <syntax>\n-      <parameter name=\"extension\" required=\"true\" argsep=\"@\">\n-        <argument name=\"extension\" required=\"true\"/>\n-        <argument name=\"context\"/>\n-      </parameter>\n-      <parameter name=\"options\">\n-        <optionlist>\n-          <option name=\"n\">\n-            <para>Retrieve name on the hint instead of list of devices.</para>\n-          </option>\n-        </optionlist>\n-      </parameter>\n+  <function name=\"SET\" language=\"en_US\">\n+    <synopsis>SET assigns a value to a channel variable.</synopsis>\n+    <syntax argsep=\"=\">\n+      <parameter name=\"varname\" required=\"true\"/>\n+      <parameter name=\"value\"/>\n     </syntax>\n-    <description>\n-      <para>The HINT function can be used to retrieve the list of devices that are\n-\t\t\tmapped to a dialplan hint.</para>\n-      <example title=\"Hint for extension 1234\">same =&gt; n,NoOp(Hint for Extension 1234 is ${HINT(1234)})</example>\n-    </description>\n+    <description/>\n   </function>\n-  <module language=\"en_US\" name=\"func_uri\">\n-    <support_level>core</support_level>\n-  </module>\n-  <function name=\"URIENCODE\" language=\"en_US\">\n-    <synopsis>Encodes a string to URI-safe encoding according to RFC 2396.</synopsis>\n+  <function name=\"EXISTS\" language=\"en_US\">\n+    <synopsis>Test the existence of a value.</synopsis>\n     <syntax>\n-      <parameter name=\"data\" required=\"true\">\n-        <para>Input string to be encoded.</para>\n-      </parameter>\n+      <parameter name=\"data\" required=\"true\"/>\n     </syntax>\n     <description>\n       <para>\n-        Returns the encoded string defined in\n-        <replaceable>data</replaceable>\n-        .\n+        Returns\n+        <literal>1</literal>\n+        if exists,\n+        <literal>0</literal>\n+        otherwise.\n       </para>\n     </description>\n   </function>\n-  <function name=\"URIDECODE\" language=\"en_US\">\n-    <synopsis>Decodes a URI-encoded string according to RFC 2396.</synopsis>\n-    <syntax>\n-      <parameter name=\"data\" required=\"true\">\n-        <para>Input string to be decoded.</para>\n+  <function name=\"IF\" language=\"en_US\">\n+    <synopsis>Check for an expression.</synopsis>\n+    <syntax argsep=\"?\">\n+      <parameter name=\"expression\" required=\"true\"/>\n+      <parameter name=\"retvalue\" argsep=\":\" required=\"true\">\n+        <argument name=\"true\"/>\n+        <argument name=\"false\"/>\n       </parameter>\n     </syntax>\n     <description>\n       <para>\n-        Returns the decoded URI-encoded\n-        <replaceable>data</replaceable>\n-        string.\n+        Returns the data following\n+        <literal>?</literal>\n+        if true, else the data following\n+        <literal>:</literal>\n       </para>\n     </description>\n   </function>\n-  <module language=\"en_US\" name=\"func_volume\">\n-    <support_level>core</support_level>\n-  </module>\n-  <function name=\"VOLUME\" language=\"en_US\">\n-    <synopsis>Set or get the TX or RX volume of a channel.</synopsis>\n-    <syntax>\n-      <parameter name=\"direction\" required=\"true\">\n-        <para>\n-          Must be\n-          <literal>TX</literal>\n-          or\n-          <literal>RX</literal>\n-          .\n-        </para>\n-      </parameter>\n-      <parameter name=\"options\">\n-        <optionlist>\n-          <option name=\"p\">\n-            <para>Enable DTMF volume control</para>\n-          </option>\n-        </optionlist>\n+  <function name=\"IFTIME\" language=\"en_US\">\n+    <synopsis>Temporal Conditional.</synopsis>\n+    <syntax argsep=\"?\">\n+      <parameter name=\"timespec\" required=\"true\"/>\n+      <parameter name=\"retvalue\" required=\"true\" argsep=\":\">\n+        <argument name=\"true\"/>\n+        <argument name=\"false\"/>\n       </parameter>\n     </syntax>\n     <description>\n       <para>\n-        The VOLUME function can be used to increase or decrease the\n-        <literal>tx</literal>\n-        or\n-        <literal>rx</literal>\n-        gain of any channel.\n+        Returns the data following\n+        <literal>?</literal>\n+        if true, else the data following\n+        <literal>:</literal>\n       </para>\n-      <example title=\"Increase volume\">same =&gt; n,Set(VOLUME(TX)=3)</example>\n-      <example title=\"Increase volume\">same =&gt; n,Set(VOLUME(RX)=2)</example>\n-      <example title=\"Increase volume with DTMF control\">same =&gt; n,Set(VOLUME(TX,p)=3)</example>\n-      <example title=\"Increase RX volume with DTMF control\">same =&gt; n,Set(VOLUME(RX,p)=3)</example>\n-      <example title=\"Decrease RX volume\">same =&gt; n,Set(VOLUME(RX)=-4)</example>\n-      <example title=\"Reset to normal\">same =&gt; n,Set(VOLUME(RX)=0)</example>\n     </description>\n   </function>\n-  <module language=\"en_US\" name=\"func_md5\">\n+  <function name=\"IMPORT\" language=\"en_US\">\n+    <synopsis>Retrieve the value of a variable from another channel.</synopsis>\n+    <syntax>\n+      <parameter name=\"channel\" required=\"true\"/>\n+      <parameter name=\"variable\" required=\"true\"/>\n+    </syntax>\n+    <description/>\n+  </function>\n+  <module language=\"en_US\" name=\"func_shell\">\n     <support_level>core</support_level>\n   </module>\n-  <function name=\"MD5\" language=\"en_US\">\n-    <synopsis>Computes an MD5 digest.</synopsis>\n+  <function name=\"SHELL\" language=\"en_US\">\n+    <synopsis>Executes a command using the system shell and captures its output.</synopsis>\n     <syntax>\n-      <parameter name=\"data\" required=\"true\"/>\n+      <parameter name=\"command\" required=\"true\">\n+        <para>The command that the shell should execute.</para>\n+        <warning>\n+          <para>\n+            Do not use untrusted strings such as\n+            <variable>CALLERID(num)</variable>\n+            or\n+            <variable>CALLERID(name)</variable>\n+            as part of the command parameters.  You\n+\t\t\t\trisk a command injection attack executing arbitrary commands if the untrusted\n+\t\t\t\tstrings aren't filtered to remove dangerous characters.  See function\n+            <variable>FILTER()</variable>\n+            .\n+          </para>\n+        </warning>\n+      </parameter>\n     </syntax>\n     <description>\n-      <para>Computes an MD5 digest.</para>\n+      <para>Collects the output generated by a command executed by the system shell</para>\n+      <example title=\"Shell example\">exten =&gt; s,1,Set(foo=${SHELL(echo bar)})</example>\n+      <note>\n+        <para>The command supplied to this function will be executed by the\n+\t\t\t\tsystem's shell, typically specified in the SHELL environment variable. There\n+\t\t\t\tare many different system shells available with somewhat different behaviors,\n+\t\t\t\tso the output generated by this function may vary between platforms.</para>\n+        <para>\n+          If\n+          <literal>live_dangerously</literal>\n+          in\n+          <literal>asterisk.conf</literal>\n+          is set to\n+          <literal>no</literal>\n+          , this function can only be executed from the\n+\t\t\t\tdialplan, and not directly from external protocols.\n+        </para>\n+      </note>\n     </description>\n   </function>\n   <module language=\"en_US\" name=\"func_enum\">\n     <support_level>core</support_level>\n   </module>\n   <function name=\"ENUMQUERY\" language=\"en_US\">\n     <synopsis>Initiate an ENUM query.</synopsis>\n@@ -19339,730 +19681,536 @@\n     </syntax>\n     <description>\n       <para>This function looks up the given phone number in DNS to retrieve\n \t\t\tthe caller id name.  The result will either be blank or be the value\n \t\t\tfound in the TXT record in DNS.</para>\n     </description>\n   </function>\n-  <module language=\"en_US\" name=\"func_cdr\">\n+  <module language=\"en_US\" name=\"func_db\">\n     <support_level>core</support_level>\n   </module>\n-  <function name=\"CDR\" language=\"en_US\">\n-    <synopsis>Gets or sets a CDR variable.</synopsis>\n-    <syntax>\n-      <parameter name=\"name\" required=\"true\">\n-        <para>CDR field name:</para>\n-        <enumlist>\n-          <enum name=\"clid\">\n-            <para>Caller ID.</para>\n-          </enum>\n-          <enum name=\"lastdata\">\n-            <para>Last application arguments.</para>\n-          </enum>\n-          <enum name=\"disposition\">\n-            <para>The final state of the CDR.</para>\n-            <enumlist>\n-              <enum name=\"0\">\n-                <para>\n-                  <literal>NO ANSWER</literal>\n-                </para>\n-              </enum>\n-              <enum name=\"1\">\n-                <para>\n-                  <literal>NO ANSWER</literal>\n-                  (NULL record)\n-                </para>\n-              </enum>\n-              <enum name=\"2\">\n-                <para>\n-                  <literal>FAILED</literal>\n-                </para>\n-              </enum>\n-              <enum name=\"4\">\n-                <para>\n-                  <literal>BUSY</literal>\n-                </para>\n-              </enum>\n-              <enum name=\"8\">\n-                <para>\n-                  <literal>ANSWERED</literal>\n-                </para>\n-              </enum>\n-              <enum name=\"16\">\n-                <para>\n-                  <literal>CONGESTION</literal>\n-                </para>\n-              </enum>\n-            </enumlist>\n-          </enum>\n-          <enum name=\"src\">\n-            <para>Source.</para>\n-          </enum>\n-          <enum name=\"start\">\n-            <para>Time the call started.</para>\n-          </enum>\n-          <enum name=\"amaflags\">\n-            <para>R/W the Automatic Message Accounting (AMA) flags on the channel.\n-\t\t\t\t\t\tWhen read from a channel, the integer value will always be returned.\n-\t\t\t\t\t\tWhen written to a channel, both the string format or integer value\n-\t\t\t\t\t\tis accepted.</para>\n-            <enumlist>\n-              <enum name=\"1\">\n-                <para>\n-                  <literal>OMIT</literal>\n-                </para>\n-              </enum>\n-              <enum name=\"2\">\n-                <para>\n-                  <literal>BILLING</literal>\n-                </para>\n-              </enum>\n-              <enum name=\"3\">\n-                <para>\n-                  <literal>DOCUMENTATION</literal>\n-                </para>\n-              </enum>\n-            </enumlist>\n-            <warning>\n-              <para>Accessing this setting is deprecated in CDR. Please use the CHANNEL function instead.</para>\n-            </warning>\n-          </enum>\n-          <enum name=\"dst\">\n-            <para>Destination.</para>\n-          </enum>\n-          <enum name=\"answer\">\n-            <para>Time the call was answered.</para>\n-          </enum>\n-          <enum name=\"accountcode\">\n-            <para>The channel's account code.</para>\n-            <warning>\n-              <para>Accessing this setting is deprecated in CDR. Please use the CHANNEL function instead.</para>\n-            </warning>\n-          </enum>\n-          <enum name=\"dcontext\">\n-            <para>Destination context.</para>\n-          </enum>\n-          <enum name=\"end\">\n-            <para>Time the call ended.</para>\n-          </enum>\n-          <enum name=\"uniqueid\">\n-            <para>The channel's unique id.</para>\n-          </enum>\n-          <enum name=\"dstchannel\">\n-            <para>Destination channel.</para>\n-          </enum>\n-          <enum name=\"duration\">\n-            <para>Duration of the call.</para>\n-          </enum>\n-          <enum name=\"userfield\">\n-            <para>The channel's user specified field.</para>\n-          </enum>\n-          <enum name=\"lastapp\">\n-            <para>Last application.</para>\n-          </enum>\n-          <enum name=\"billsec\">\n-            <para>Duration of the call once it was answered.</para>\n-          </enum>\n-          <enum name=\"channel\">\n-            <para>Channel name.</para>\n-          </enum>\n-          <enum name=\"sequence\">\n-            <para>CDR sequence number.</para>\n-          </enum>\n-        </enumlist>\n-      </parameter>\n-      <parameter name=\"options\" required=\"false\">\n-        <optionlist>\n-          <option name=\"f\">\n-            <para>Returns billsec or duration fields as floating point values.</para>\n-          </option>\n-          <option name=\"u\">\n-            <para>Retrieves the raw, unprocessed value.</para>\n-            <para>\n-              For example, 'start', 'answer', and 'end' will be retrieved as epoch\n-\t\t\t\t\t\tvalues, when the\n-              <literal>u</literal>\n-              option is passed, but formatted as YYYY-MM-DD HH:MM:SS\n-\t\t\t\t\t\totherwise.  Similarly, disposition and amaflags will return their raw\n-\t\t\t\t\t\tintegral values.\n-            </para>\n-          </option>\n-        </optionlist>\n-      </parameter>\n+  <function name=\"DB\" language=\"en_US\">\n+    <synopsis>Read from or write to the Asterisk database.</synopsis>\n+    <syntax argsep=\"/\">\n+      <parameter name=\"family\" required=\"true\"/>\n+      <parameter name=\"key\" required=\"true\"/>\n     </syntax>\n     <description>\n-      <para>\n-        All of the CDR field names are read-only, except for\n-        <literal>accountcode</literal>\n-        ,\n-        <literal>userfield</literal>\n-        , and\n-        <literal>amaflags</literal>\n-        . You may, however, supply\n-\t\t\ta name not on the above list, and create your own variable, whose value can be changed\n-\t\t\twith this function, and this variable will be stored on the CDR.\n-      </para>\n-      <note>\n-        <para>\n-          CDRs can only be modified before the bridge between two channels is\n-\t\t\ttorn down. For example, CDRs may not be modified after the\n-          <literal>Dial</literal>\n-          application has returned.\n-        </para>\n-      </note>\n-      <example title=\"Set the userfield\">exten =&gt; 1,1,Set(CDR(userfield)=test)</example>\n+      <para>This function will read from or write a value to the Asterisk database.  On a\n+\t\t\tread, this function returns the corresponding value from the database, or blank\n+\t\t\tif it does not exist.  Reading a database value will also set the variable\n+\t\t\tDB_RESULT.  If you wish to find out if an entry exists, use the DB_EXISTS\n+\t\t\tfunction.</para>\n     </description>\n+    <see-also>\n+      <ref type=\"application\">DBdel</ref>\n+      <ref type=\"function\">DB_DELETE</ref>\n+      <ref type=\"application\">DBdeltree</ref>\n+      <ref type=\"function\">DB_EXISTS</ref>\n+    </see-also>\n   </function>\n-  <function name=\"CDR_PROP\" language=\"en_US\">\n-    <synopsis>Set a property on a channel's CDR.</synopsis>\n-    <syntax>\n-      <parameter name=\"name\" required=\"true\">\n-        <para>The property to set on the CDR.</para>\n-        <enumlist>\n-          <enum name=\"party_a\">\n-            <para>Set this channel as the preferred Party A when\n-\t\t\t\t\t\tchannels are associated together.</para>\n-            <para>Write-Only</para>\n-          </enum>\n-          <enum name=\"disable\">\n-            <para>Setting to 1 will disable CDRs for this channel.\n-\t\t\t\t\t\tSetting to 0 will enable CDRs for this channel.</para>\n-            <para>Write-Only</para>\n-          </enum>\n-        </enumlist>\n-      </parameter>\n+  <function name=\"DB_EXISTS\" language=\"en_US\">\n+    <synopsis>Check to see if a key exists in the Asterisk database.</synopsis>\n+    <syntax argsep=\"/\">\n+      <parameter name=\"family\" required=\"true\"/>\n+      <parameter name=\"key\" required=\"true\"/>\n     </syntax>\n     <description>\n-      <para>This function sets a property on a channel's CDR. Properties\n-\t\t\talter the behavior of how the CDR operates for that channel.</para>\n+      <para>\n+        This function will check to see if a key exists in the Asterisk\n+\t\t\tdatabase. If it exists, the function will return\n+        <literal>1</literal>\n+        . If not,\n+\t\t\tit will return\n+        <literal>0</literal>\n+        .  Checking for existence of a database key will\n+\t\t\talso set the variable DB_RESULT to the key's value if it exists.\n+      </para>\n     </description>\n+    <see-also>\n+      <ref type=\"function\">DB</ref>\n+    </see-also>\n   </function>\n-  <module language=\"en_US\" name=\"func_pjsip_aor\">\n-    <depend>pjproject</depend>\n-    <depend>res_pjsip</depend>\n-    <support_level>core</support_level>\n-  </module>\n-  <function name=\"PJSIP_AOR\" language=\"en_US\">\n-    <synopsis>Get information about a PJSIP AOR</synopsis>\n-    <syntax>\n-      <parameter name=\"name\" required=\"true\">\n-        <para>The name of the AOR to query.</para>\n-      </parameter>\n-      <parameter name=\"field\" required=\"true\">\n-        <para>\n-          The configuration option for the AOR to query for.\n-\t\t\t\tSupported options are those fields on the\n-          <replaceable>aor</replaceable>\n-          object in\n-          <filename>pjsip.conf</filename>\n-          .\n-        </para>\n-        <enumlist>\n-          <configOptionToEnum>\n-            <xi:include xpointer=\"xpointer(/docs/configInfo[@name='res_pjsip']/configFile[@name='pjsip.conf']/configObject[@name='aor']/configOption)\"/>\n-          </configOptionToEnum>\n-        </enumlist>\n-      </parameter>\n-    </syntax>\n-  </function>\n-  <module language=\"en_US\" name=\"func_version\">\n-    <support_level>core</support_level>\n-  </module>\n-  <function name=\"VERSION\" language=\"en_US\">\n-    <synopsis>Return the Version info for this Asterisk.</synopsis>\n+  <function name=\"DB_KEYS\" language=\"en_US\">\n+    <synopsis>Obtain a list of keys within the Asterisk database.</synopsis>\n     <syntax>\n-      <parameter name=\"info\">\n-        <para>The possible values are:</para>\n-        <enumlist>\n-          <enum name=\"ASTERISK_VERSION_NUM\">\n-            <para>A string of digits is returned, e.g. 10602 for 1.6.2 or 100300 for 10.3.0,\n-\t\t\t\t\t\tor 999999 when using a Git build.</para>\n-          </enum>\n-          <enum name=\"BUILD_USER\">\n-            <para>The string representing the user's name whose account\n-\t\t\t\t\t\twas used to configure Asterisk, is returned.</para>\n-          </enum>\n-          <enum name=\"BUILD_HOSTNAME\">\n-            <para>The string representing the name of the host on which Asterisk was configured, is returned.</para>\n-          </enum>\n-          <enum name=\"BUILD_MACHINE\">\n-            <para>The string representing the type of machine on which Asterisk was configured, is returned.</para>\n-          </enum>\n-          <enum name=\"BUILD_OS\">\n-            <para>The string representing the OS of the machine on which Asterisk was configured, is returned.</para>\n-          </enum>\n-          <enum name=\"BUILD_DATE\">\n-            <para>The string representing the date on which Asterisk was configured, is returned.</para>\n-          </enum>\n-          <enum name=\"BUILD_KERNEL\">\n-            <para>The string representing the kernel version of the machine on which Asterisk\n-\t\t\t\t\t\twas configured, is returned.</para>\n-          </enum>\n-        </enumlist>\n-      </parameter>\n+      <parameter name=\"prefix\"/>\n     </syntax>\n     <description>\n-      <para>If there are no arguments, return the version of Asterisk in this format: 18.12.0</para>\n-      <example title=\"Get current version\">same =&gt; n,Set(junky=${VERSION()} ; sets junky to 18.12.0, or possibly GITMasterxxxxxx</example>\n+      <para>This function will return a comma-separated list of keys existing\n+\t\t\tat the prefix specified within the Asterisk database.  If no argument is\n+\t\t\tprovided, then a list of key families will be returned.</para>\n     </description>\n+    <see-also>\n+      <ref type=\"function\">DB_KEYCOUNT</ref>\n+    </see-also>\n   </function>\n-  <module language=\"en_US\" name=\"func_dialplan\">\n-    <support_level>core</support_level>\n-  </module>\n-  <function name=\"DIALPLAN_EXISTS\" language=\"en_US\">\n-    <synopsis>Checks the existence of a dialplan target.</synopsis>\n+  <function name=\"DB_KEYCOUNT\" language=\"en_US\">\n+    <synopsis>Obtain the number of keys at a prefix within the Asterisk database.</synopsis>\n     <syntax>\n-      <parameter name=\"context\" required=\"true\"/>\n-      <parameter name=\"extension\"/>\n-      <parameter name=\"priority\"/>\n+      <parameter name=\"prefix\"/>\n     </syntax>\n     <description>\n-      <para>\n-        This function returns\n-        <literal>1</literal>\n-        if the target exits. Otherwise, it returns\n-        <literal>0</literal>\n-        .\n-      </para>\n+      <para>This function will return the number of keys that exist\n+\t\t\tat the prefix specified within the Asterisk database.  If no argument is\n+\t\t\tprovided, then the number of all key families will be returned.</para>\n     </description>\n+    <see-also>\n+      <ref type=\"function\">DB_KEYS</ref>\n+    </see-also>\n   </function>\n-  <function name=\"VALID_EXTEN\" language=\"en_US\">\n-    <synopsis>Determine whether an extension exists or not.</synopsis>\n-    <syntax>\n-      <parameter name=\"context\">\n-        <para>Defaults to the current context</para>\n-      </parameter>\n-      <parameter name=\"extension\" required=\"true\"/>\n-      <parameter name=\"priority\">\n-        <para>\n-          Priority defaults to\n-          <literal>1</literal>\n-          .\n-        </para>\n-      </parameter>\n+  <function name=\"DB_DELETE\" language=\"en_US\">\n+    <synopsis>Return a value from the database and delete it.</synopsis>\n+    <syntax argsep=\"/\">\n+      <parameter name=\"family\" required=\"true\"/>\n+      <parameter name=\"key\" required=\"true\"/>\n     </syntax>\n     <description>\n       <para>\n-        Returns a true value if the indicated\n-        <replaceable>context</replaceable>\n-        ,\n-        <replaceable>extension</replaceable>\n-        , and\n-        <replaceable>priority</replaceable>\n-        exist.\n+        This function will retrieve a value from the Asterisk database\n+\t\t\tand then remove that key from the database.\n+        <variable>DB_RESULT</variable>\n+        will be set to the key's value if it exists.\n       </para>\n-      <warning>\n+      <note>\n         <para>\n-          This function has been deprecated in favor of the\n-          <literal>DIALPLAN_EXISTS()</literal>\n-          function\n+          If\n+          <literal>live_dangerously</literal>\n+          in\n+          <literal>asterisk.conf</literal>\n+          is set to\n+          <literal>no</literal>\n+          , this function can only be read from the\n+\t\t\t\tdialplan, and not directly from external protocols. It can, however, be\n+\t\t\t\texecuted as a write operation (\n+          <literal>DB_DELETE(family, key)=ignored</literal>\n+          )\n         </para>\n-      </warning>\n+      </note>\n     </description>\n+    <see-also>\n+      <ref type=\"application\">DBdel</ref>\n+      <ref type=\"function\">DB</ref>\n+      <ref type=\"application\">DBdeltree</ref>\n+    </see-also>\n   </function>\n-  <module language=\"en_US\" name=\"func_odbc\">\n-    <depend>res_odbc</depend>\n-    <depend>generic_odbc</depend>\n+  <module language=\"en_US\" name=\"func_env\">\n     <support_level>core</support_level>\n   </module>\n-  <function name=\"ODBC_FETCH\" language=\"en_US\">\n-    <synopsis>Fetch a row from a multirow query.</synopsis>\n+  <function name=\"ENV\" language=\"en_US\">\n+    <synopsis>Gets or sets the environment variable specified.</synopsis>\n     <syntax>\n-      <parameter name=\"result-id\" required=\"true\"/>\n+      <parameter name=\"varname\" required=\"true\">\n+        <para>Environment variable name</para>\n+      </parameter>\n     </syntax>\n     <description>\n       <para>\n-        For queries which are marked as mode=multirow, the original\n-\t\t\tquery returns a\n-        <replaceable>result-id</replaceable>\n-        from which results\n-\t\t\tmay be fetched.  This function implements the actual fetch of the results.\n-      </para>\n-      <para>\n-        This also sets\n-        <variable>ODBC_FETCH_STATUS</variable>\n-        .\n+        Variables starting with\n+        <literal>AST_</literal>\n+        are reserved to the system and may not be set.\n       </para>\n+      <para>Additionally, the following system variables are available as special built-in dialplan variables.\n+\t\t\tThese variables cannot be set or modified and are read-only.</para>\n       <variablelist>\n-        <variable name=\"ODBC_FETCH_STATUS\">\n-          <value name=\"SUCESS\">If rows are available.</value>\n-          <value name=\"FAILURE\">If no rows are available.</value>\n+        <variable name=\"EPOCH\">\n+          <para>Current unix style epoch</para>\n+        </variable>\n+        <variable name=\"SYSTEMNAME\">\n+          <para>\n+            value of the\n+            <literal>systemname</literal>\n+            option from\n+            <literal>asterisk.conf</literal>\n+          </para>\n+        </variable>\n+        <variable name=\"ASTCACHEDIR\">\n+          <para>\n+            value of the\n+            <literal>astcachedir</literal>\n+            option from\n+            <literal>asterisk.conf</literal>\n+          </para>\n+        </variable>\n+        <variable name=\"ASTETCDIR\">\n+          <para>\n+            value of the\n+            <literal>astetcdir</literal>\n+            option from\n+            <literal>asterisk.conf</literal>\n+          </para>\n+        </variable>\n+        <variable name=\"ASTMODDIR\">\n+          <para>\n+            value of the\n+            <literal>astmoddir</literal>\n+            option from\n+            <literal>asterisk.conf</literal>\n+          </para>\n+        </variable>\n+        <variable name=\"ASTVARLIBDIR\">\n+          <para>\n+            value of the\n+            <literal>astvarlib</literal>\n+            option from\n+            <literal>asterisk.conf</literal>\n+          </para>\n+        </variable>\n+        <variable name=\"ASTDBDIR\">\n+          <para>\n+            value of the\n+            <literal>astdbdir</literal>\n+            option from\n+            <literal>asterisk.conf</literal>\n+          </para>\n+        </variable>\n+        <variable name=\"ASTKEYDIR\">\n+          <para>\n+            value of the\n+            <literal>astkeydir</literal>\n+            option from\n+            <literal>asterisk.conf</literal>\n+          </para>\n+        </variable>\n+        <variable name=\"ASTDATADIR\">\n+          <para>\n+            value of the\n+            <literal>astdatadir</literal>\n+            option from\n+            <literal>asterisk.conf</literal>\n+          </para>\n+        </variable>\n+        <variable name=\"ASTAGIDIR\">\n+          <para>\n+            value of the\n+            <literal>astagidir</literal>\n+            option from\n+            <literal>asterisk.conf</literal>\n+          </para>\n+        </variable>\n+        <variable name=\"ASTSPOOLDIR\">\n+          <para>\n+            value of the\n+            <literal>astspooldir</literal>\n+            option from\n+            <literal>asterisk.conf</literal>\n+          </para>\n+        </variable>\n+        <variable name=\"ASTRUNDIR\">\n+          <para>\n+            value of the\n+            <literal>astrundir</literal>\n+            option from\n+            <literal>asterisk.conf</literal>\n+          </para>\n+        </variable>\n+        <variable name=\"ASTLOGDIR\">\n+          <para>\n+            value of the\n+            <literal>astlogdir</literal>\n+            option from\n+            <literal>asterisk.conf</literal>\n+          </para>\n+        </variable>\n+        <variable name=\"ASTSBINDIR\">\n+          <para>\n+            value of the\n+            <literal>astsbindir</literal>\n+            option from\n+            <literal>asterisk.conf</literal>\n+          </para>\n+        </variable>\n+        <variable name=\"ENTITYID\">\n+          <para>\n+            Global Entity ID set automatically, or from\n+            <literal>asterisk.conf</literal>\n+          </para>\n         </variable>\n       </variablelist>\n     </description>\n   </function>\n-  <application name=\"ODBCFinish\" language=\"en_US\">\n-    <synopsis>Clear the resultset of a sucessful multirow query.</synopsis>\n-    <syntax>\n-      <parameter name=\"result-id\" required=\"true\"/>\n-    </syntax>\n-    <description>\n-      <para>For queries which are marked as mode=multirow, this will clear\n-\t\t\tany remaining rows of the specified resultset.</para>\n-    </description>\n-  </application>\n-  <function name=\"SQL_ESC\" language=\"en_US\">\n-    <synopsis>Escapes single ticks for use in SQL statements.</synopsis>\n+  <function name=\"STAT\" language=\"en_US\">\n+    <synopsis>Does a check on the specified file.</synopsis>\n     <syntax>\n-      <parameter name=\"string\" required=\"true\"/>\n+      <parameter name=\"flag\" required=\"true\">\n+        <para>Flag may be one of the following:</para>\n+        <para>d - Checks if the file is a directory.</para>\n+        <para>e - Checks if the file exists.</para>\n+        <para>f - Checks if the file is a regular file.</para>\n+        <para>m - Returns the file mode (in octal)</para>\n+        <para>s - Returns the size (in bytes) of the file</para>\n+        <para>A - Returns the epoch at which the file was last accessed.</para>\n+        <para>C - Returns the epoch at which the inode was last changed.</para>\n+        <para>M - Returns the epoch at which the file was last modified.</para>\n+      </parameter>\n+      <parameter name=\"filename\" required=\"true\"/>\n     </syntax>\n     <description>\n-      <para>\n-        Used in SQL templates to escape data which may contain single ticks\n-        <literal>'</literal>\n-        which are otherwise used to delimit data.\n-      </para>\n-      <example title=\"Escape example\">SELECT foo FROM bar WHERE baz='${SQL_ESC(${ARG1})}'</example>\n+      <note>\n+        <para>\n+          If\n+          <literal>live_dangerously</literal>\n+          in\n+          <literal>asterisk.conf</literal>\n+          is set to\n+          <literal>no</literal>\n+          , this function can only be executed from the\n+\t\t\t\tdialplan, and not directly from external protocols.\n+        </para>\n+      </note>\n     </description>\n   </function>\n-  <function name=\"SQL_ESC_BACKSLASHES\" language=\"en_US\">\n-    <synopsis>Escapes backslashes for use in SQL statements.</synopsis>\n+  <function name=\"FILE\" language=\"en_US\">\n+    <synopsis>Read or write text file.</synopsis>\n     <syntax>\n-      <parameter name=\"string\" required=\"true\"/>\n-    </syntax>\n-    <description>\n-      <para>\n-        Used in SQL templates to escape data which may contain backslashes\n-        <literal>\\</literal>\n-        which are otherwise used to escape data.\n-      </para>\n-      <example title=\"Escape with backslashes example\">SELECT foo FROM bar WHERE baz='${SQL_ESC(${SQL_ESC_BACKSLASHES(${ARG1})})}'</example>\n-    </description>\n-  </function>\n-  <module language=\"en_US\" name=\"func_extstate\">\n-    <support_level>core</support_level>\n-  </module>\n-  <function name=\"EXTENSION_STATE\" language=\"en_US\">\n-    <synopsis>Get an extension's state.</synopsis>\n-    <syntax argsep=\"@\">\n-      <parameter name=\"extension\" required=\"true\"/>\n-      <parameter name=\"context\">\n+      <parameter name=\"filename\" required=\"true\"/>\n+      <parameter name=\"offset\">\n         <para>\n-          If it is not specified defaults to\n-          <literal>default</literal>\n-          .\n+          Maybe specified as any number. If negative,\n+          <replaceable>offset</replaceable>\n+          specifies the number\n+\t\t\t\tof bytes back from the end of the file.\n         </para>\n       </parameter>\n-    </syntax>\n-    <description>\n-      <para>The EXTENSION_STATE function can be used to retrieve the state from any\n-\t\t\thinted extension. For example:</para>\n-      <para>NoOp(1234@default has state ${EXTENSION_STATE(1234)})</para>\n-      <para>NoOp(4567@home has state ${EXTENSION_STATE(4567@home)})</para>\n-      <para>The possible values returned by this function are:</para>\n-      <para>UNKNOWN | NOT_INUSE | INUSE | BUSY | INVALID | UNAVAILABLE | RINGING |\n-\t\t\tRINGINUSE | HOLDINUSE | ONHOLD</para>\n-    </description>\n-  </function>\n-  <module language=\"en_US\" name=\"func_callcompletion\">\n-    <support_level>core</support_level>\n-  </module>\n-  <function name=\"CALLCOMPLETION\" language=\"en_US\">\n-    <synopsis>Get or set a call completion configuration parameter for a channel.</synopsis>\n-    <syntax>\n-      <parameter name=\"option\" required=\"true\">\n-        <para>The allowable options are:</para>\n-        <enumlist>\n-          <enum name=\"cc_agent_policy\"/>\n-          <enum name=\"cc_monitor_policy\"/>\n-          <enum name=\"cc_offer_timer\"/>\n-          <enum name=\"ccnr_available_timer\"/>\n-          <enum name=\"ccbs_available_timer\"/>\n-          <enum name=\"cc_recall_timer\"/>\n-          <enum name=\"cc_max_agents\"/>\n-          <enum name=\"cc_max_monitors\"/>\n-          <enum name=\"cc_callback_macro\"/>\n-          <enum name=\"cc_agent_dialstring\"/>\n-        </enumlist>\n+      <parameter name=\"length\">\n+        <para>\n+          If specified, will limit the length of the data read to that size. If negative,\n+\t\t\t\ttrims\n+          <replaceable>length</replaceable>\n+          bytes from the end of the file.\n+        </para>\n       </parameter>\n-    </syntax>\n-    <description>\n-      <para>\n-        The CALLCOMPLETION function can be used to get or set a call\n-\t\t\tcompletion configuration parameter for a channel. Note that setting\n-\t\t\ta configuration parameter will only change the parameter for the\n-\t\t\tduration of the call.\n-\n-\t\t\tFor more information see\n-        <filename>doc/AST.pdf</filename>\n-        .\n-\t\t\tFor more information on call completion parameters, see\n-        <filename>configs/ccss.conf.sample</filename>\n-        .\n-      </para>\n-    </description>\n-  </function>\n-  <module language=\"en_US\" name=\"func_hangupcause\">\n-    <support_level>core</support_level>\n-  </module>\n-  <function name=\"HANGUPCAUSE\" language=\"en_US\">\n-    <synopsis>Gets per-channel hangupcause information from the channel.</synopsis>\n-    <syntax>\n-      <parameter name=\"channel\" required=\"true\">\n-        <para>The name of the channel for which to retrieve cause information.</para>\n+      <parameter name=\"options\">\n+        <optionlist>\n+          <option name=\"l\">\n+            <para>Line mode:  offset and length are assumed to be\n+\t\t\t\t\t\tmeasured in lines, instead of byte offsets.</para>\n+          </option>\n+          <option name=\"a\">\n+            <para>In write mode only, the append option is used to\n+\t\t\t\t\t\tappend to the end of the file, instead of overwriting\n+\t\t\t\t\t\tthe existing file.</para>\n+          </option>\n+          <option name=\"d\">\n+            <para>In write mode and line mode only, this option does\n+\t\t\t\t\t\tnot automatically append a newline string to the end of\n+\t\t\t\t\t\ta value.  This is useful for deleting lines, instead of\n+\t\t\t\t\t\tsetting them to blank.</para>\n+          </option>\n+        </optionlist>\n       </parameter>\n-      <parameter name=\"type\" required=\"true\">\n-        <para>Parameter describing which type of information is requested. Types are:</para>\n-        <enumlist>\n-          <enum name=\"tech\">\n-            <para>Technology-specific cause information</para>\n-          </enum>\n-          <enum name=\"ast\">\n-            <para>Translated Asterisk cause code</para>\n-          </enum>\n-        </enumlist>\n+      <parameter name=\"format\">\n+        <para>\n+          The\n+          <replaceable>format</replaceable>\n+          parameter may be\n+\t\t\t\tused to delimit the type of line terminators in line mode.\n+        </para>\n+        <optionlist>\n+          <option name=\"u\">\n+            <para>Unix newline format.</para>\n+          </option>\n+          <option name=\"d\">\n+            <para>DOS newline format.</para>\n+          </option>\n+          <option name=\"m\">\n+            <para>Macintosh newline format.</para>\n+          </option>\n+        </optionlist>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>Gets technology-specific or translated Asterisk cause code information\n-\t\t\tfrom the channel for the specified channel that resulted from a dial.</para>\n-    </description>\n-    <see-also>\n-      <ref type=\"function\">HANGUPCAUSE_KEYS</ref>\n-      <ref type=\"application\">HangupCauseClear</ref>\n-    </see-also>\n-  </function>\n-  <function name=\"HANGUPCAUSE_KEYS\" language=\"en_US\">\n-    <synopsis>Gets the list of channels for which hangup causes are available.</synopsis>\n-    <description>\n-      <para>Returns a comma-separated list of channel names to be used with the HANGUPCAUSE function.</para>\n+      <para>Read and write text file in character and line mode.</para>\n+      <para>Examples:</para>\n+      <para>Read mode (byte):</para>\n+      <example title=\"Reads the entire content of the file\">same =&gt; n,Set(foo=${FILE(/tmp/test.txt)})</example>\n+      <example title=\"Reads from the 11th byte to the end of the file (i.e. skips the first 10)\">same =&gt; n,Set(foo=${FILE(/tmp/test.txt,10)})</example>\n+      <example title=\"Reads from the 11th to 20th byte in the file (i.e. skip the first 10, then read 10 bytes)\">same =&gt; n,Set(foo=${FILE(/tmp/test.txt,10,10)})</example>\n+      <para>Read mode (line):</para>\n+      <example title=\"Reads the 3rd line of the file\">same =&gt; n,Set(foo=${FILE(/tmp/test.txt,3,1,l)})</example>\n+      <example title=\"Reads the 3rd and 4th lines of the file\">same =&gt; n,Set(foo=${FILE(/tmp/test.txt,3,2,l)})</example>\n+      <example title=\"Reads from the third line to the end of the file\">same =&gt; n,Set(foo=${FILE(/tmp/test.txt,3,,l)})</example>\n+      <example title=\"Reads the last three lines of the file\">same =&gt; n,Set(foo=${FILE(/tmp/test.txt,-3,,l)})</example>\n+      <example title=\"Reads the 3rd line of a DOS-formatted file\">same =&gt; n,Set(foo=${FILE(/tmp/test.txt,3,1,l,d)})</example>\n+      <para>Write mode (byte):</para>\n+      <example title=\"Truncate the file and write bar\">same =&gt; n,Set(FILE(/tmp/test.txt)=bar)</example>\n+      <example title=\"Append bar\">same =&gt; n,Set(FILE(/tmp/test.txt,,,a)=bar)</example>\n+      <example title=\"Replace the first byte with bar (replaces 1 character with 3)\">same =&gt; n,Set(FILE(/tmp/test.txt,0,1)=bar)</example>\n+      <example title=\"Replace 10 bytes beginning at the 21st byte of the file with bar\">same =&gt; n,Set(FILE(/tmp/test.txt,20,10)=bar)</example>\n+      <example title=\"Replace all bytes from the 21st with bar\">same =&gt; n,Set(FILE(/tmp/test.txt,20)=bar)</example>\n+      <example title=\"Insert bar after the 4th character\">same =&gt; n,Set(FILE(/tmp/test.txt,4,0)=bar)</example>\n+      <para>Write mode (line):</para>\n+      <example title=\"Replace the first line of the file with bar\">same =&gt; n,Set(FILE(/tmp/foo.txt,0,1,l)=bar)</example>\n+      <example title=\"Replace the last line of the file with bar\">same =&gt; n,Set(FILE(/tmp/foo.txt,-1,,l)=bar)</example>\n+      <example title=\"Append bar to the file with a newline\">same =&gt; n,Set(FILE(/tmp/foo.txt,,,al)=bar)</example>\n+      <note>\n+        <para>\n+          If\n+          <literal>live_dangerously</literal>\n+          in\n+          <literal>asterisk.conf</literal>\n+          is set to\n+          <literal>no</literal>\n+          , this function can only be executed from the\n+\t\t\t\tdialplan, and not directly from external protocols.\n+        </para>\n+      </note>\n     </description>\n     <see-also>\n-      <ref type=\"function\">HANGUPCAUSE</ref>\n-      <ref type=\"application\">HangupCauseClear</ref>\n+      <ref type=\"function\">FILE_COUNT_LINE</ref>\n+      <ref type=\"function\">FILE_FORMAT</ref>\n     </see-also>\n   </function>\n-  <application name=\"HangupCauseClear\" language=\"en_US\">\n-    <synopsis>Clears hangup cause information from the channel that is available through HANGUPCAUSE.</synopsis>\n-    <description>\n-      <para>Clears all channel-specific hangup cause information from the channel.\n-\t\t\tThis is never done automatically (i.e. for new Dial()s).</para>\n-    </description>\n-    <see-also>\n-      <ref type=\"function\">HANGUPCAUSE</ref>\n-      <ref type=\"function\">HANGUPCAUSE_KEYS</ref>\n-    </see-also>\n-  </application>\n-  <module language=\"en_US\" name=\"func_math\">\n-    <support_level>core</support_level>\n-  </module>\n-  <function name=\"MATH\" language=\"en_US\">\n-    <synopsis>Performs Mathematical Functions.</synopsis>\n+  <function name=\"FILE_COUNT_LINE\" language=\"en_US\">\n+    <synopsis>Obtains the number of lines of a text file.</synopsis>\n     <syntax>\n-      <parameter name=\"expression\" required=\"true\">\n-        <para>\n-          Is of the form:\n-          <replaceable>number1</replaceable>\n-          <replaceable>op</replaceable>\n-          <replaceable>number2</replaceable>\n-          where the possible values for\n-          <replaceable>op</replaceable>\n-          are:\n-        </para>\n-        <para>+,-,/,*,%,&lt;&lt;,&gt;&gt;,^,AND,OR,XOR,&lt;,&gt;,&lt;=,&gt;=,== (and behave as their C equivalents)</para>\n-      </parameter>\n-      <parameter name=\"type\">\n-        <para>Wanted type of result:</para>\n-        <para>f, float - float(default)</para>\n-        <para>i, int - integer</para>\n-        <para>h, hex - hex</para>\n-        <para>c, char - char</para>\n+      <parameter name=\"filename\" required=\"true\"/>\n+      <parameter name=\"format\">\n+        <para>Format may be one of the following:</para>\n+        <optionlist>\n+          <option name=\"u\">\n+            <para>Unix newline format.</para>\n+          </option>\n+          <option name=\"d\">\n+            <para>DOS newline format.</para>\n+          </option>\n+          <option name=\"m\">\n+            <para>Macintosh newline format.</para>\n+          </option>\n+        </optionlist>\n+        <note>\n+          <para>If not specified, an attempt will be made to determine the newline format type.</para>\n+        </note>\n       </parameter>\n     </syntax>\n     <description>\n       <para>\n-        Performs mathematical functions based on two parameters and an operator.  The returned\n-\t\t\tvalue type is\n-        <replaceable>type</replaceable>\n+        Returns the number of lines, or\n+        <literal>-1</literal>\n+        on error.\n       </para>\n-      <example title=\"Sets var i to 11\">same =&gt; n,Set(i=${MATH(123%16,int)})</example>\n-    </description>\n-  </function>\n-  <function name=\"INC\" language=\"en_US\">\n-    <synopsis>Increments the value of a variable, while returning the updated value to the dialplan</synopsis>\n-    <syntax>\n-      <parameter name=\"variable\" required=\"true\">\n-        <para>The variable name to be manipulated, without the braces.</para>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>Increments the value of a variable, while returning the updated value to the dialplan</para>\n-      <para>Example: INC(MyVAR) - Increments MyVar</para>\n-      <para>Note: INC(${MyVAR}) - Is wrong, as INC expects the variable name, not its value</para>\n-    </description>\n-  </function>\n-  <function name=\"DEC\" language=\"en_US\">\n-    <synopsis>Decrements the value of a variable, while returning the updated value to the dialplan</synopsis>\n-    <syntax>\n-      <parameter name=\"variable\" required=\"true\">\n-        <para>The variable name to be manipulated, without the braces.</para>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>Decrements the value of a variable, while returning the updated value to the dialplan</para>\n-      <example title=\"Decrements MyVAR\">same =&gt; n,NoOp(${DEC(MyVAR)})</example>\n       <note>\n-        <para>DEC(${MyVAR}) is wrong, as DEC expects the variable name, not its value</para>\n+        <para>\n+          If\n+          <literal>live_dangerously</literal>\n+          in\n+          <literal>asterisk.conf</literal>\n+          is set to\n+          <literal>no</literal>\n+          , this function can only be executed from the\n+\t\t\t\tdialplan, and not directly from external protocols.\n+        </para>\n       </note>\n     </description>\n+    <see-also>\n+      <ref type=\"function\">FILE</ref>\n+      <ref type=\"function\">FILE_FORMAT</ref>\n+    </see-also>\n   </function>\n-  <function name=\"MIN\" language=\"en_US\">\n-    <since>\n-      <version>16.19.0</version>\n-      <version>18.5.0</version>\n-      <version>19.0.0</version>\n-    </since>\n-    <synopsis>Returns the minimum of two numbers.</synopsis>\n+  <function name=\"FILE_FORMAT\" language=\"en_US\">\n+    <synopsis>Return the newline format of a text file.</synopsis>\n     <syntax>\n-      <parameter name=\"num1\"/>\n-      <parameter name=\"num2\"/>\n+      <parameter name=\"filename\" required=\"true\"/>\n     </syntax>\n     <description>\n-      <para>\n-        Returns the minimum of two numbers\n-        <replaceable>num1</replaceable>\n-        and\n-        <replaceable>num2</replaceable>\n-        .\n-      </para>\n-      <example title=\"Sets the min variable equal to 4\">same =&gt; n,Set(min=${MIN(7,4)})</example>\n+      <para>Return the line terminator type:</para>\n+      <para>'u' - Unix &quot;\\n&quot; format</para>\n+      <para>'d' - DOS &quot;\\r\\n&quot; format</para>\n+      <para>'m' - Macintosh &quot;\\r&quot; format</para>\n+      <para>'x' - Cannot be determined</para>\n+      <note>\n+        <para>\n+          If\n+          <literal>live_dangerously</literal>\n+          in\n+          <literal>asterisk.conf</literal>\n+          is set to\n+          <literal>no</literal>\n+          , this function can only be executed from the\n+\t\t\t\tdialplan, and not directly from external protocols.\n+        </para>\n+      </note>\n     </description>\n+    <see-also>\n+      <ref type=\"function\">FILE</ref>\n+      <ref type=\"function\">FILE_COUNT_LINE</ref>\n+    </see-also>\n   </function>\n-  <function name=\"MAX\" language=\"en_US\">\n+  <function name=\"BASENAME\" language=\"en_US\">\n     <since>\n-      <version>16.19.0</version>\n-      <version>18.5.0</version>\n+      <version>16.21.0</version>\n+      <version>18.7.0</version>\n       <version>19.0.0</version>\n     </since>\n-    <synopsis>Returns the maximum of two numbers.</synopsis>\n+    <synopsis>Return the name of a file.</synopsis>\n     <syntax>\n-      <parameter name=\"num1\"/>\n-      <parameter name=\"num2\"/>\n+      <parameter name=\"filename\" required=\"true\"/>\n     </syntax>\n     <description>\n-      <para>\n-        Returns the maximum of two numbers\n-        <replaceable>num1</replaceable>\n-        and\n-        <replaceable>num2</replaceable>\n-        .\n-      </para>\n-      <example title=\"Sets the max variable equal to 13\">same =&gt; n,Set(max=${MAX(4,7)})</example>\n+      <para>Return the base file name, given a full file path.</para>\n+      <example title=\"Directory name\">same =&gt; n,Set(basename=${BASENAME(/etc/asterisk/extensions.conf)})\n+\t\t\tsame =&gt; n,NoOp(${basename}) ; outputs extensions.conf</example>\n     </description>\n+    <see-also>\n+      <ref type=\"function\">DIRNAME</ref>\n+    </see-also>\n   </function>\n-  <function name=\"ABS\" language=\"en_US\">\n+  <function name=\"DIRNAME\" language=\"en_US\">\n     <since>\n-      <version>16.19.0</version>\n-      <version>18.5.0</version>\n+      <version>16.21.0</version>\n+      <version>18.7.0</version>\n       <version>19.0.0</version>\n     </since>\n-    <synopsis>Returns absolute value of a number.</synopsis>\n+    <synopsis>Return the directory of a file.</synopsis>\n     <syntax>\n-      <parameter name=\"num\"/>\n+      <parameter name=\"filename\" required=\"true\"/>\n     </syntax>\n     <description>\n-      <para>\n-        Returns the absolute value of a number\n-        <replaceable>num</replaceable>\n-        .\n-      </para>\n-      <example title=\"Sets the absval variable equal to 13\">same =&gt; n,Set(absval=${ABS(-13)})</example>\n+      <para>Return the directory of a file, given a full file path.</para>\n+      <example title=\"Directory name\">same =&gt; n,Set(dirname=${DIRNAME(/etc/asterisk/extensions.conf)})\n+\t\t\tsame =&gt; n,NoOp(${dirname}) ; outputs /etc/asterisk</example>\n     </description>\n+    <see-also>\n+      <ref type=\"function\">BASENAME</ref>\n+    </see-also>\n   </function>\n-  <module language=\"en_US\" name=\"func_rand\">\n+  <module language=\"en_US\" name=\"func_base64\">\n     <support_level>core</support_level>\n   </module>\n-  <function name=\"RAND\" language=\"en_US\">\n-    <synopsis>Choose a random number in a range.</synopsis>\n+  <function name=\"BASE64_ENCODE\" language=\"en_US\">\n+    <synopsis>Encode a string in base64.</synopsis>\n     <syntax>\n-      <parameter name=\"min\"/>\n-      <parameter name=\"max\"/>\n+      <parameter name=\"string\" required=\"true\">\n+        <para>Input string</para>\n+      </parameter>\n     </syntax>\n     <description>\n-      <para>\n-        Choose a random number between\n-        <replaceable>min</replaceable>\n-        and\n-        <replaceable>max</replaceable>\n-        .\n-        <replaceable>min</replaceable>\n-        defaults to\n-        <literal>0</literal>\n-        , if not specified, while\n-        <replaceable>max</replaceable>\n-        defaults\n-\t\t\tto\n-        <literal>RAND_MAX</literal>\n-        (2147483647 on many systems).\n-      </para>\n-      <example title=\"Set random number between 1 and 8, inclusive\">exten =&gt; s,1,Set(junky=${RAND(1,8)})</example>\n+      <para>Returns the base64 string.</para>\n     </description>\n+    <see-also>\n+      <ref type=\"function\">BASE64_DECODE</ref>\n+      <ref type=\"function\">AES_DECRYPT</ref>\n+      <ref type=\"function\">AES_ENCRYPT</ref>\n+    </see-also>\n   </function>\n-  <module language=\"en_US\" name=\"func_sysinfo\">\n-    <support_level>core</support_level>\n-  </module>\n-  <function name=\"SYSINFO\" language=\"en_US\">\n-    <synopsis>Returns system information specified by parameter.</synopsis>\n+  <function name=\"BASE64_DECODE\" language=\"en_US\">\n+    <synopsis>Decode a base64 string.</synopsis>\n     <syntax>\n-      <parameter name=\"parameter\" required=\"true\">\n-        <enumlist>\n-          <enum name=\"loadavg\">\n-            <para>System load average from past minute.</para>\n-          </enum>\n-          <enum name=\"numcalls\">\n-            <para>Number of active calls currently in progress.</para>\n-          </enum>\n-          <enum name=\"uptime\">\n-            <para>System uptime in hours.</para>\n-            <note>\n-              <para>This parameter is dependant upon operating system.</para>\n-            </note>\n-          </enum>\n-          <enum name=\"totalram\">\n-            <para>Total usable main memory size in KiB.</para>\n-            <note>\n-              <para>This parameter is dependant upon operating system.</para>\n-            </note>\n-          </enum>\n-          <enum name=\"freeram\">\n-            <para>Available memory size in KiB.</para>\n-            <note>\n-              <para>This parameter is dependant upon operating system.</para>\n-            </note>\n-          </enum>\n-          <enum name=\"bufferram\">\n-            <para>Memory used by buffers in KiB.</para>\n-            <note>\n-              <para>This parameter is dependant upon operating system.</para>\n-            </note>\n-          </enum>\n-          <enum name=\"totalswap\">\n-            <para>Total swap space still available in KiB.</para>\n-            <note>\n-              <para>This parameter is dependant upon operating system.</para>\n-            </note>\n-          </enum>\n-          <enum name=\"freeswap\">\n-            <para>Free swap space still available in KiB.</para>\n-            <note>\n-              <para>This parameter is dependant upon operating system.</para>\n-            </note>\n-          </enum>\n-          <enum name=\"numprocs\">\n-            <para>Number of current processes.</para>\n-            <note>\n-              <para>This parameter is dependant upon operating system.</para>\n-            </note>\n-          </enum>\n-        </enumlist>\n+      <parameter name=\"string\" required=\"true\">\n+        <para>Input string.</para>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>Returns information from a given parameter.</para>\n+      <para>Returns the plain text string.</para>\n     </description>\n+    <see-also>\n+      <ref type=\"function\">BASE64_ENCODE</ref>\n+      <ref type=\"function\">AES_DECRYPT</ref>\n+      <ref type=\"function\">AES_ENCRYPT</ref>\n+    </see-also>\n   </function>\n   <module language=\"en_US\" name=\"func_channel\">\n     <support_level>core</support_level>\n   </module>\n   <function name=\"CHANNELS\" language=\"en_US\">\n     <synopsis>Gets the list of channels, optionally filtering by a regular expression.</synopsis>\n     <syntax>\n@@ -20367,1839 +20515,3306 @@\n         </variable>\n         <variable name=\"HANGUPCAUSE\">\n           <para>Asterisk cause of hangup (inbound/outbound)</para>\n         </variable>\n       </variablelist>\n     </description>\n   </function>\n-  <module language=\"en_US\" name=\"func_pitchshift\">\n-    <support_level>extended</support_level>\n+  <module language=\"en_US\" name=\"func_srv\">\n+    <support_level>core</support_level>\n   </module>\n-  <function name=\"PITCH_SHIFT\" language=\"en_US\">\n-    <synopsis>Pitch shift both tx and rx audio streams on a channel.</synopsis>\n+  <function name=\"SRVQUERY\" language=\"en_US\">\n+    <synopsis>Initiate an SRV query.</synopsis>\n     <syntax>\n-      <parameter name=\"channel direction\" required=\"true\">\n+      <parameter name=\"service\" required=\"true\">\n         <para>\n-          Direction can be either\n-          <literal>rx</literal>\n-          ,\n-          <literal>tx</literal>\n-          , or\n-          <literal>both</literal>\n-          .  The direction can either be set to a valid floating\n-\t\t\t\tpoint number between 0.1 and 4.0 or one of the enum values listed below. A value\n-\t\t\t\tof 1.0 has no effect.  Greater than 1 raises the pitch. Lower than 1 lowers\n-\t\t\t\tthe pitch.\n+          The service for which to look up SRV records. An example would be something\n+\t\t\t\tlike\n+          <literal>_sip._udp.example.com</literal>\n         </para>\n-        <para>The pitch amount can also be set by the following values</para>\n-        <enumlist>\n-          <enum name=\"highest\"/>\n-          <enum name=\"higher\"/>\n-          <enum name=\"high\"/>\n-          <enum name=\"low\"/>\n-          <enum name=\"lower\"/>\n-          <enum name=\"lowest\"/>\n-        </enumlist>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>Examples:</para>\n-      <example title=\"Raises pitch an octave\">exten =&gt; 1,1,Set(PITCH_SHIFT(tx)=highest)</example>\n-      <example title=\"Raises pitch more\">exten =&gt; 1,1,Set(PITCH_SHIFT(rx)=higher)</example>\n-      <example title=\"Raises pitch\">exten =&gt; 1,1,Set(PITCH_SHIFT(both)=high)</example>\n-      <example title=\"Lowers pitch\">exten =&gt; 1,1,Set(PITCH_SHIFT(rx)=low)</example>\n-      <example title=\"Lowers pitch more\">exten =&gt; 1,1,Set(PITCH_SHIFT(tx)=lower)</example>\n-      <example title=\"Lowers pitch an octave\">exten =&gt; 1,1,Set(PITCH_SHIFT(both)=lowest)</example>\n-      <example title=\"Lowers pitch\">exten =&gt; 1,1,Set(PITCH_SHIFT(rx)=0.8)</example>\n-      <example title=\"Raises pitch\">exten =&gt; 1,1,Set(PITCH_SHIFT(tx)=1.5)</example>\n+      <para>This will do an SRV lookup of the given service.</para>\n     </description>\n   </function>\n-  <module language=\"en_US\" name=\"func_frame_drop\">\n-    <support_level>extended</support_level>\n-  </module>\n-  <function name=\"FRAME_DROP\" language=\"en_US\">\n-    <since>\n-      <version>16.21.0</version>\n-      <version>18.7.0</version>\n-      <version>19.0.0</version>\n-    </since>\n-    <synopsis>Drops specific frame types in the TX or RX direction on a channel.</synopsis>\n+  <function name=\"SRVRESULT\" language=\"en_US\">\n+    <synopsis>Retrieve results from an SRVQUERY.</synopsis>\n     <syntax>\n-      <parameter name=\"direction\" required=\"true\">\n-        <para>\n-          List of frame types to be dropped for the specified direction. Direction can be\n-          <literal>TX</literal>\n-          or\n-          <literal>RX</literal>\n-          . The\n-          <literal>TX</literal>\n-          direction will prevent Asterisk from sending frames to a channel, and the\n-          <literal>RX</literal>\n-          direction will prevent Asterisk from receiving frames from a channel.\n-        </para>\n-        <para>Subsequent calls to this function will replace previous settings, allowing certain frames to be dropped only temporarily, for instance.</para>\n+      <parameter name=\"id\" required=\"true\">\n+        <para>The identifier returned by the SRVQUERY function.</para>\n+      </parameter>\n+      <parameter name=\"resultnum\" required=\"true\">\n+        <para>The number of the result that you want to retrieve.</para>\n         <para>\n-          Below are the different types of frames that can be dropped. Other actions may need to be taken in conjunction with use of this function:\n-\t\t\t\tfor instance, if you drop ANSWER control frames, you should explicitly use\n-          <literal>Progress()</literal>\n-          for your call or undesired behavior\n-\t\t\t\tmay occur.\n+          Results start at\n+          <literal>1</literal>\n+          . If this argument is specified\n+\t\t\t\tas\n+          <literal>getnum</literal>\n+          , then it will return the total number of results\n+\t\t\t\tthat are available.\n         </para>\n-        <enumlist>\n-          <enum name=\"DTMF_BEGIN\"/>\n-          <enum name=\"DTMF_END\"/>\n-          <enum name=\"VOICE\"/>\n-          <enum name=\"VIDEO\"/>\n-          <enum name=\"CONTROL\"/>\n-          <enum name=\"NULL\"/>\n-          <enum name=\"IAX\"/>\n-          <enum name=\"TEXT\"/>\n-          <enum name=\"TEXT_DATA\"/>\n-          <enum name=\"IMAGE\"/>\n-          <enum name=\"HTML\"/>\n-          <enum name=\"CNG\"/>\n-          <enum name=\"MODEM\"/>\n-        </enumlist>\n-        <para>The following CONTROL frames can also be dropped:</para>\n-        <enumlist>\n-          <enum name=\"RING\"/>\n-          <enum name=\"RINGING\"/>\n-          <enum name=\"ANSWER\"/>\n-          <enum name=\"BUSY\"/>\n-          <enum name=\"TAKEOFFHOOK\"/>\n-          <enum name=\"OFFHOOK\"/>\n-          <enum name=\"CONGESTION\"/>\n-          <enum name=\"FLASH\"/>\n-          <enum name=\"WINK\"/>\n-          <enum name=\"PROGRESS\"/>\n-          <enum name=\"PROCEEDING\"/>\n-          <enum name=\"HOLD\"/>\n-          <enum name=\"UNHOLD\"/>\n-          <enum name=\"VIDUPDATE\"/>\n-          <enum name=\"CONNECTED_LINE\"/>\n-          <enum name=\"REDIRECTING\"/>\n-        </enumlist>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>Examples:</para>\n-      <example title=\"Drop only DTMF frames towards this channel\">exten =&gt; 1,1,Set(FRAME_DROP(TX)=DTMF_BEGIN,DTMF_END)</example>\n-      <example title=\"Drop only Answer control frames towards this channel\">exten =&gt; 1,1,Set(FRAME_DROP(TX)=ANSWER)</example>\n-      <example title=\"Drop only DTMF frames received on this channel\">exten =&gt; 1,1,Set(FRAME_DROP(RX)=DTMF_BEGIN,DTMF_END)</example>\n+      <para>This function will retrieve results from a previous use\n+\t\t\tof the SRVQUERY function.</para>\n     </description>\n   </function>\n-  <module language=\"en_US\" name=\"func_blacklist\">\n+  <module language=\"en_US\" name=\"test_http_media_cache\">\n+    <depend>TEST_FRAMEWORK</depend>\n+    <depend>curl</depend>\n+    <depend>res_http_media_cache</depend>\n     <support_level>core</support_level>\n   </module>\n-  <function name=\"BLACKLIST\" language=\"en_US\">\n-    <synopsis>Check if the callerid is on the blacklist.</synopsis>\n-    <syntax/>\n-    <description>\n-      <para>\n-        Uses astdb to check if the Caller*ID is in family\n-        <literal>blacklist</literal>\n-        .\n-\t\t\tReturns\n-        <literal>1</literal>\n-        or\n-        <literal>0</literal>\n-        .\n-      </para>\n-    </description>\n-    <see-also>\n-      <ref type=\"function\">DB</ref>\n-    </see-also>\n-  </function>\n-  <module language=\"en_US\" name=\"func_cut\">\n+  <module language=\"en_US\" name=\"test_func_file\">\n+    <depend>TEST_FRAMEWORK</depend>\n     <support_level>core</support_level>\n   </module>\n-  <function name=\"SORT\" language=\"en_US\">\n-    <synopsis>Sorts a list of key/vals into a list of keys, based upon the vals.</synopsis>\n-    <syntax>\n-      <parameter name=\"keyval\" required=\"true\" argsep=\":\">\n-        <argument name=\"key1\" required=\"true\"/>\n-        <argument name=\"val1\" required=\"true\"/>\n-      </parameter>\n-      <parameter name=\"keyvaln\" multiple=\"true\" argsep=\":\">\n-        <argument name=\"key2\" required=\"true\"/>\n-        <argument name=\"val2\" required=\"true\"/>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>Takes a comma-separated list of keys and values, each separated by a colon, and returns a\n-\t\t\tcomma-separated list of the keys, sorted by their values.  Values will be evaluated as\n-\t\t\tfloating-point numbers.</para>\n-    </description>\n-  </function>\n-  <function name=\"CUT\" language=\"en_US\">\n-    <synopsis>Slices and dices strings, based upon a named delimiter.</synopsis>\n-    <syntax>\n-      <parameter name=\"varname\" required=\"true\">\n-        <para>Variable you want cut</para>\n-      </parameter>\n-      <parameter name=\"char-delim\" required=\"true\">\n-        <para>\n-          Delimiter, defaults to\n-          <literal>-</literal>\n-        </para>\n-      </parameter>\n-      <parameter name=\"range-spec\" required=\"true\">\n-        <para>\n-          Number of the field you want (1-based offset), may also be specified as a range (with\n-          <literal>-</literal>\n-          )\n-\t\t\t\tor group of ranges and fields (with\n-          <literal>&amp;</literal>\n-          )\n-        </para>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>\n-        Cut out information from a string (\n-        <replaceable>varname</replaceable>\n-        ), based upon a named delimiter.\n-      </para>\n-    </description>\n-  </function>\n-  <module language=\"en_US\" name=\"test_dlinklists\">\n+  <module language=\"en_US\" name=\"test_pbx\">\n     <depend>TEST_FRAMEWORK</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test_heap\">\n+  <module language=\"en_US\" name=\"test_message\">\n     <depend>TEST_FRAMEWORK</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test_cel\">\n+  <module language=\"en_US\" name=\"test_sorcery\">\n     <depend>TEST_FRAMEWORK</depend>\n+    <depend>func_sorcery</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test_sched\">\n+  <module language=\"en_US\" name=\"test_astobj2_thrash\">\n     <depend>TEST_FRAMEWORK</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test_stream\">\n+  <module language=\"en_US\" name=\"test_poll\">\n     <depend>TEST_FRAMEWORK</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test_threadpool\">\n+  <module language=\"en_US\" name=\"test_locale\">\n     <depend>TEST_FRAMEWORK</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test_http_media_cache\">\n+  <module language=\"en_US\" name=\"test_heap\">\n     <depend>TEST_FRAMEWORK</depend>\n-    <depend>curl</depend>\n-    <depend>res_http_media_cache</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test_aoc\">\n+  <module language=\"en_US\" name=\"test_jitterbuf\">\n     <depend>TEST_FRAMEWORK</depend>\n     <support_level>core</support_level>\n   </module>\n   <module language=\"en_US\" name=\"test_utils\">\n     <depend>TEST_FRAMEWORK</depend>\n     <depend>res_agi</depend>\n     <depend>res_crypto</depend>\n     <depend>crypto</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test_sorcery_memory_cache_thrash\">\n+  <module language=\"en_US\" name=\"test_astobj2_weaken\">\n     <depend>TEST_FRAMEWORK</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test_data_buffer\">\n+  <module language=\"en_US\" name=\"test_callerid\">\n     <depend>TEST_FRAMEWORK</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test_func_file\">\n+  <module language=\"en_US\" name=\"test_skel\">\n     <depend>TEST_FRAMEWORK</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test_optional_api\">\n+  <module language=\"en_US\" name=\"test_scope_trace\">\n     <depend>TEST_FRAMEWORK</depend>\n-    <depend>OPTIONAL_API</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test_stasis_endpoints\">\n+  <module language=\"en_US\" name=\"test_dns_query_set\">\n     <depend>TEST_FRAMEWORK</depend>\n-    <depend>res_stasis_test</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test_astobj2_thrash\">\n+  <module language=\"en_US\" name=\"test_devicestate\">\n     <depend>TEST_FRAMEWORK</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test_jitterbuf\">\n+  <module language=\"en_US\" name=\"test_taskprocessor\">\n     <depend>TEST_FRAMEWORK</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test_channel\">\n+  <module language=\"en_US\" name=\"test_uuid\">\n     <depend>TEST_FRAMEWORK</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test_json\">\n+  <module language=\"en_US\" name=\"test_dns_recurring\">\n     <depend>TEST_FRAMEWORK</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test_dns_srv\">\n+  <module language=\"en_US\" name=\"test_db\">\n     <depend>TEST_FRAMEWORK</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test_ast_format_str_reduce\">\n+  <module language=\"en_US\" name=\"test_amihooks\">\n     <depend>TEST_FRAMEWORK</depend>\n-    <depend>format_g723</depend>\n-    <depend>format_g726</depend>\n-    <depend>format_g729</depend>\n-    <depend>format_gsm</depend>\n-    <depend>format_ogg_vorbis</depend>\n-    <depend>format_pcm</depend>\n-    <depend>format_siren14</depend>\n-    <depend>format_siren7</depend>\n-    <depend>format_sln</depend>\n-    <depend>format_wav</depend>\n-    <depend>format_wav_gsm</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test_uri\">\n+  <module language=\"en_US\" name=\"test_voicemail_api\">\n     <depend>TEST_FRAMEWORK</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test_sorcery_realtime\">\n+  <module language=\"en_US\" name=\"test_scoped_lock\">\n     <depend>TEST_FRAMEWORK</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test_app\">\n+  <module language=\"en_US\" name=\"test_stringfields\">\n     <depend>TEST_FRAMEWORK</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test_dns_naptr\">\n+  <module language=\"en_US\" name=\"test_aoc\">\n     <depend>TEST_FRAMEWORK</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test_xml_escape\">\n+  <module language=\"en_US\" name=\"test_format_cap\">\n     <depend>TEST_FRAMEWORK</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test_netsock2\">\n+  <module language=\"en_US\" name=\"test_abstract_jb\">\n     <depend>TEST_FRAMEWORK</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test_hashtab_thrash\">\n+  <module language=\"en_US\" name=\"test_core_codec\">\n     <depend>TEST_FRAMEWORK</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test_dns\">\n+  <module language=\"en_US\" name=\"test_cdr\">\n     <depend>TEST_FRAMEWORK</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test_websocket_client\">\n+  <module language=\"en_US\" name=\"test_dns_naptr\">\n     <depend>TEST_FRAMEWORK</depend>\n-    <depend>res_http_websocket</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test_event\">\n+  <module language=\"en_US\" name=\"test_netsock2\">\n     <depend>TEST_FRAMEWORK</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test_file\">\n+  <module language=\"en_US\" name=\"test_json\">\n+    <depend>TEST_FRAMEWORK</depend>\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"test_hashtab_thrash\">\n     <depend>TEST_FRAMEWORK</depend>\n     <support_level>core</support_level>\n   </module>\n+  <module language=\"en_US\" name=\"test_sorcery_realtime\">\n+    <depend>TEST_FRAMEWORK</depend>\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"test_res_stasis\">\n+    <depend>TEST_FRAMEWORK</depend>\n+    <depend>res_stasis</depend>\n+    <support_level>core</support_level>\n+  </module>\n   <module language=\"en_US\" name=\"test_bucket\">\n     <depend>TEST_FRAMEWORK</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test_conversions\">\n+  <module language=\"en_US\" name=\"test_stasis_endpoints\">\n     <depend>TEST_FRAMEWORK</depend>\n+    <depend>res_stasis_test</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test_stasis_channels\">\n+  <module language=\"en_US\" name=\"test_dns_srv\">\n     <depend>TEST_FRAMEWORK</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test_voicemail_api\">\n+  <module language=\"en_US\" name=\"test_gosub\">\n     <depend>TEST_FRAMEWORK</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test_locale\">\n+  <module language=\"en_US\" name=\"test_channel\">\n     <depend>TEST_FRAMEWORK</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test_security_events\">\n+  <module language=\"en_US\" name=\"test_conversions\">\n     <depend>TEST_FRAMEWORK</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test_res_rtp\">\n+  <module language=\"en_US\" name=\"test_ari\">\n     <depend>TEST_FRAMEWORK</depend>\n+    <depend>res_ari</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test_bridging\">\n+  <module language=\"en_US\" name=\"test_acl\">\n     <depend>TEST_FRAMEWORK</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test_message\">\n+  <module language=\"en_US\" name=\"test_ari_model\">\n     <depend>TEST_FRAMEWORK</depend>\n+    <depend>res_ari_model</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test_pbx\">\n+  <module language=\"en_US\" name=\"test_time\">\n     <depend>TEST_FRAMEWORK</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test_db\">\n+  <module language=\"en_US\" name=\"test_threadpool\">\n     <depend>TEST_FRAMEWORK</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test_strings\">\n+  <module language=\"en_US\" name=\"test_astobj2\">\n     <depend>TEST_FRAMEWORK</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test_devicestate\">\n+  <module language=\"en_US\" name=\"test_uri\">\n+    <depend>TEST_FRAMEWORK</depend>\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"test_stasis_channels\">\n     <depend>TEST_FRAMEWORK</depend>\n     <support_level>core</support_level>\n   </module>\n   <module language=\"en_US\" name=\"test_linkedlists\">\n     <depend>TEST_FRAMEWORK</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test_skel\">\n+  <module language=\"en_US\" name=\"test_bridging\">\n     <depend>TEST_FRAMEWORK</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test_stringfields\">\n+  <module language=\"en_US\" name=\"test_sorcery_astdb\">\n     <depend>TEST_FRAMEWORK</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test_format_cache\">\n+  <module language=\"en_US\" name=\"test_file\">\n     <depend>TEST_FRAMEWORK</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test_channel_feature_hooks\">\n+  <module language=\"en_US\" name=\"test_stream\">\n     <depend>TEST_FRAMEWORK</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test_named_lock\">\n+  <module language=\"en_US\" name=\"test_ast_format_str_reduce\">\n     <depend>TEST_FRAMEWORK</depend>\n+    <depend>format_g723</depend>\n+    <depend>format_g726</depend>\n+    <depend>format_g729</depend>\n+    <depend>format_gsm</depend>\n+    <depend>format_ogg_vorbis</depend>\n+    <depend>format_pcm</depend>\n+    <depend>format_siren14</depend>\n+    <depend>format_siren7</depend>\n+    <depend>format_sln</depend>\n+    <depend>format_wav</depend>\n+    <depend>format_wav_gsm</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test_taskprocessor\">\n+  <module language=\"en_US\" name=\"test_stasis\">\n     <depend>TEST_FRAMEWORK</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test_ari_model\">\n+  <module language=\"en_US\" name=\"test_app\">\n     <depend>TEST_FRAMEWORK</depend>\n-    <depend>res_ari_model</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test_ari\">\n+  <module language=\"en_US\" name=\"test_xml_escape\">\n     <depend>TEST_FRAMEWORK</depend>\n-    <depend>res_ari</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test_core_codec\">\n+  <module language=\"en_US\" name=\"test_websocket_client\">\n     <depend>TEST_FRAMEWORK</depend>\n+    <depend>res_http_websocket</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test_endpoints\">\n+  <module language=\"en_US\" name=\"test_substitution\">\n     <depend>TEST_FRAMEWORK</depend>\n+    <depend>func_curl</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test_sorcery_astdb\">\n+  <module language=\"en_US\" name=\"test_sched\">\n     <depend>TEST_FRAMEWORK</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test_res_stasis\">\n+  <module language=\"en_US\" name=\"test_vector\">\n     <depend>TEST_FRAMEWORK</depend>\n-    <depend>res_stasis</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test_astobj2\">\n+  <module language=\"en_US\" name=\"test_core_format\">\n     <depend>TEST_FRAMEWORK</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test_scope_trace\">\n+  <module language=\"en_US\" name=\"test_named_lock\">\n     <depend>TEST_FRAMEWORK</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test_acl\">\n+  <module language=\"en_US\" name=\"test_dns\">\n     <depend>TEST_FRAMEWORK</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test_time\">\n+  <module language=\"en_US\" name=\"test_sorcery_memory_cache_thrash\">\n     <depend>TEST_FRAMEWORK</depend>\n     <support_level>core</support_level>\n   </module>\n   <module language=\"en_US\" name=\"test_res_pjsip_scheduler\">\n     <depend>TEST_FRAMEWORK</depend>\n     <depend>pjproject</depend>\n     <depend>res_pjsip</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test_core_format\">\n+  <module language=\"en_US\" name=\"test_optional_api\">\n     <depend>TEST_FRAMEWORK</depend>\n+    <depend>OPTIONAL_API</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test_expr\">\n+  <module language=\"en_US\" name=\"test_media_cache\">\n     <depend>TEST_FRAMEWORK</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test_dns_recurring\">\n+  <module language=\"en_US\" name=\"test_expr\">\n     <depend>TEST_FRAMEWORK</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test_poll\">\n+  <module language=\"en_US\" name=\"test_config\">\n     <depend>TEST_FRAMEWORK</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test_config\">\n+  <module language=\"en_US\" name=\"test_data_buffer\">\n     <depend>TEST_FRAMEWORK</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test_gosub\">\n+  <module language=\"en_US\" name=\"test_channel_feature_hooks\">\n     <depend>TEST_FRAMEWORK</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test_format_cap\">\n+  <module language=\"en_US\" name=\"test_cel\">\n     <depend>TEST_FRAMEWORK</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test_logger\">\n+  <module language=\"en_US\" name=\"test_strings\">\n     <depend>TEST_FRAMEWORK</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test_media_cache\">\n+  <module language=\"en_US\" name=\"test_event\">\n     <depend>TEST_FRAMEWORK</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test_substitution\">\n+  <module language=\"en_US\" name=\"test_logger\">\n     <depend>TEST_FRAMEWORK</depend>\n-    <depend>func_curl</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test_amihooks\">\n+  <module language=\"en_US\" name=\"test_format_cache\">\n     <depend>TEST_FRAMEWORK</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test_cdr\">\n+  <module language=\"en_US\" name=\"test_res_rtp\">\n     <depend>TEST_FRAMEWORK</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test_astobj2_weaken\">\n+  <module language=\"en_US\" name=\"test_security_events\">\n     <depend>TEST_FRAMEWORK</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test_sorcery\">\n+  <module language=\"en_US\" name=\"test_endpoints\">\n     <depend>TEST_FRAMEWORK</depend>\n-    <depend>func_sorcery</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test_callerid\">\n+  <module language=\"en_US\" name=\"test_dlinklists\">\n     <depend>TEST_FRAMEWORK</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test_vector\">\n-    <depend>TEST_FRAMEWORK</depend>\n+  <module language=\"en_US\" name=\"dns_txt\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test_stasis\">\n-    <depend>TEST_FRAMEWORK</depend>\n+  <module language=\"en_US\" name=\"dns_tlsa\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test_scoped_lock\">\n-    <depend>TEST_FRAMEWORK</depend>\n+  <module language=\"en_US\" name=\"sched\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test_dns_query_set\">\n-    <depend>TEST_FRAMEWORK</depend>\n+  <module language=\"en_US\" name=\"sdp_srtp\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test_abstract_jb\">\n-    <depend>TEST_FRAMEWORK</depend>\n+  <module language=\"en_US\" name=\"jitterbuf\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test_uuid\">\n-    <depend>TEST_FRAMEWORK</depend>\n+  <module language=\"en_US\" name=\"stasis_message_router\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"pbx_builtins\">\n+  <module language=\"en_US\" name=\"strings\">\n     <support_level>core</support_level>\n   </module>\n-  <application name=\"Answer\" language=\"en_US\">\n-    <synopsis>Answer a channel if ringing.</synopsis>\n-    <syntax>\n-      <parameter name=\"delay\">\n-        <para>Asterisk will wait this number of milliseconds before returning to\n-\t\t\t\tthe dialplan after answering the call.</para>\n+  <module language=\"en_US\" name=\"cli\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"taskprocessor\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"logger\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"xmldoc\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"asterisk\">\n+    <support_level>core</support_level>\n+  </module>\n+  <managerEvent language=\"en_US\" name=\"FullyBooted\">\n+    <managerEventInstance class=\"EVENT_FLAG_SYSTEM\">\n+      <synopsis>Raised when all Asterisk initialization procedures have finished.</synopsis>\n+      <syntax>\n+        <parameter name=\"Status\">\n+          <para>Informational message</para>\n+        </parameter>\n+        <parameter name=\"Uptime\">\n+          <para>Seconds since start</para>\n+        </parameter>\n+        <parameter name=\"LastReload\">\n+          <para>Seconds since last reload</para>\n+        </parameter>\n+      </syntax>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <managerEvent language=\"en_US\" name=\"Shutdown\">\n+    <managerEventInstance class=\"EVENT_FLAG_SYSTEM\">\n+      <synopsis>Raised when Asterisk is shutdown or restarted.</synopsis>\n+      <syntax>\n+        <parameter name=\"Shutdown\">\n+          <para>Whether the shutdown is proceeding cleanly (all channels\n+\t\t\t\t\twere hungup successfully) or uncleanly (channels will be\n+\t\t\t\t\tterminated)</para>\n+          <enumlist>\n+            <enum name=\"Uncleanly\"/>\n+            <enum name=\"Cleanly\"/>\n+          </enumlist>\n+        </parameter>\n+        <parameter name=\"Restart\">\n+          <para>Whether or not a restart will occur.</para>\n+          <enumlist>\n+            <enum name=\"True\"/>\n+            <enum name=\"False\"/>\n+          </enumlist>\n+        </parameter>\n+      </syntax>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <module language=\"en_US\" name=\"threadstorage\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"core_unreal\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"utf8\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"alaw\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"dial\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"sorcery\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"callerid\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"security_events\">\n+    <support_level>core</support_level>\n+  </module>\n+  <managerEvent language=\"en_US\" name=\"FailedACL\">\n+    <managerEventInstance class=\"EVENT_FLAG_SECURITY\">\n+      <synopsis>Raised when a request violates an ACL check.</synopsis>\n+      <syntax>\n+        <parameter name=\"EventTV\">\n+          <para>The time the event was detected.</para>\n+        </parameter>\n+        <parameter name=\"Severity\">\n+          <para>A relative severity of the security event.</para>\n+          <enumlist>\n+            <enum name=\"Informational\"/>\n+            <enum name=\"Error\"/>\n+          </enumlist>\n+        </parameter>\n+        <parameter name=\"Service\">\n+          <para>The Asterisk service that raised the security event.</para>\n+        </parameter>\n+        <parameter name=\"EventVersion\">\n+          <para>The version of this event.</para>\n+        </parameter>\n+        <parameter name=\"AccountID\">\n+          <para>The Service account associated with the security event\n+\t\t\t\t\tnotification.</para>\n+        </parameter>\n+        <parameter name=\"SessionID\">\n+          <para>A unique identifier for the session in the service\n+\t\t\t\t\tthat raised the event.</para>\n+        </parameter>\n+        <parameter name=\"LocalAddress\">\n+          <para>The address of the Asterisk service that raised the\n+\t\t\t\t\tsecurity event.</para>\n+        </parameter>\n+        <parameter name=\"RemoteAddress\">\n+          <para>The remote address of the entity that caused the\n+\t\t\t\t\tsecurity event to be raised.</para>\n+        </parameter>\n+        <parameter name=\"Module\" required=\"false\">\n+          <para>If available, the name of the module that raised the event.</para>\n+        </parameter>\n+        <parameter name=\"ACLName\" required=\"false\">\n+          <para>If available, the name of the ACL that failed.</para>\n+        </parameter>\n+        <parameter name=\"SessionTV\" required=\"false\">\n+          <para>The timestamp reported by the session.</para>\n+        </parameter>\n+      </syntax>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <managerEvent language=\"en_US\" name=\"InvalidAccountID\">\n+    <managerEventInstance class=\"EVENT_FLAG_SECURITY\">\n+      <synopsis>Raised when a request fails an authentication check due to an invalid account ID.</synopsis>\n+      <syntax>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='EventTV'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Severity'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Service'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='EventVersion'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='AccountID'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='SessionID'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='LocalAddress'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='RemoteAddress'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Module'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='SessionTV'])\"/>\n+      </syntax>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <managerEvent language=\"en_US\" name=\"SessionLimit\">\n+    <managerEventInstance class=\"EVENT_FLAG_SECURITY\">\n+      <synopsis>Raised when a request fails due to exceeding the number of allowed concurrent sessions for that service.</synopsis>\n+      <syntax>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='EventTV'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Severity'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Service'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='EventVersion'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='AccountID'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='SessionID'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='LocalAddress'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='RemoteAddress'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Module'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='SessionTV'])\"/>\n+      </syntax>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <managerEvent language=\"en_US\" name=\"MemoryLimit\">\n+    <managerEventInstance class=\"EVENT_FLAG_SECURITY\">\n+      <synopsis>Raised when a request fails due to an internal memory allocation failure.</synopsis>\n+      <syntax>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='EventTV'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Severity'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Service'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='EventVersion'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='AccountID'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='SessionID'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='LocalAddress'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='RemoteAddress'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Module'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='SessionTV'])\"/>\n+      </syntax>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <managerEvent language=\"en_US\" name=\"LoadAverageLimit\">\n+    <managerEventInstance class=\"EVENT_FLAG_SECURITY\">\n+      <synopsis>Raised when a request fails because a configured load average limit has been reached.</synopsis>\n+      <syntax>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='EventTV'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Severity'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Service'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='EventVersion'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='AccountID'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='SessionID'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='LocalAddress'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='RemoteAddress'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Module'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='SessionTV'])\"/>\n+      </syntax>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <managerEvent language=\"en_US\" name=\"RequestNotSupported\">\n+    <managerEventInstance class=\"EVENT_FLAG_SECURITY\">\n+      <synopsis>Raised when a request fails due to some aspect of the requested item not being supported by the service.</synopsis>\n+      <syntax>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='EventTV'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Severity'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Service'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='EventVersion'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='AccountID'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='SessionID'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='LocalAddress'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='RemoteAddress'])\"/>\n+        <parameter name=\"RequestType\">\n+          <para>The type of request attempted.</para>\n+        </parameter>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Module'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='SessionTV'])\"/>\n+      </syntax>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <managerEvent language=\"en_US\" name=\"RequestNotAllowed\">\n+    <managerEventInstance class=\"EVENT_FLAG_SECURITY\">\n+      <synopsis>Raised when a request is not allowed by the service.</synopsis>\n+      <syntax>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='EventTV'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Severity'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Service'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='EventVersion'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='AccountID'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='SessionID'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='LocalAddress'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='RemoteAddress'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='RequestNotSupported']/managerEventInstance/syntax/parameter[@name='RequestType'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Module'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='SessionTV'])\"/>\n+        <parameter name=\"RequestParams\" required=\"false\">\n+          <para>Parameters provided to the rejected request.</para>\n+        </parameter>\n+      </syntax>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <managerEvent language=\"en_US\" name=\"AuthMethodNotAllowed\">\n+    <managerEventInstance class=\"EVENT_FLAG_SECURITY\">\n+      <synopsis>Raised when a request used an authentication method not allowed by the service.</synopsis>\n+      <syntax>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='EventTV'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Severity'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Service'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='EventVersion'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='AccountID'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='SessionID'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='LocalAddress'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='RemoteAddress'])\"/>\n+        <parameter name=\"AuthMethod\">\n+          <para>The authentication method attempted.</para>\n+        </parameter>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Module'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='SessionTV'])\"/>\n+      </syntax>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <managerEvent language=\"en_US\" name=\"RequestBadFormat\">\n+    <managerEventInstance class=\"EVENT_FLAG_SECURITY\">\n+      <synopsis>Raised when a request is received with bad formatting.</synopsis>\n+      <syntax>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='EventTV'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Severity'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Service'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='EventVersion'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='AccountID'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='SessionID'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='LocalAddress'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='RemoteAddress'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='RequestNotSupported']/managerEventInstance/syntax/parameter[@name='RequestType'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Module'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='SessionTV'])\"/>\n+        <parameter name=\"AccountID\" required=\"false\">\n+          <para>The account ID associated with the rejected request.</para>\n+        </parameter>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='RequestNotAllowed']/managerEventInstance/syntax/parameter[@name='RequestParams'])\"/>\n+      </syntax>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <managerEvent language=\"en_US\" name=\"SuccessfulAuth\">\n+    <managerEventInstance class=\"EVENT_FLAG_SECURITY\">\n+      <synopsis>Raised when a request successfully authenticates with a service.</synopsis>\n+      <syntax>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='EventTV'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Severity'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Service'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='EventVersion'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='AccountID'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='SessionID'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='LocalAddress'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='RemoteAddress'])\"/>\n+        <parameter name=\"UsingPassword\">\n+          <para>Whether or not the authentication attempt included a password.</para>\n+        </parameter>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Module'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='SessionTV'])\"/>\n+      </syntax>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <managerEvent language=\"en_US\" name=\"UnexpectedAddress\">\n+    <managerEventInstance class=\"EVENT_FLAG_SECURITY\">\n+      <synopsis>Raised when a request has a different source address then what is expected for a session already in progress with a service.</synopsis>\n+      <syntax>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='EventTV'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Severity'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Service'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='EventVersion'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='AccountID'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='SessionID'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='LocalAddress'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='RemoteAddress'])\"/>\n+        <parameter name=\"ExpectedAddress\">\n+          <para>The address that the request was expected to use.</para>\n+        </parameter>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Module'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='SessionTV'])\"/>\n+      </syntax>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <managerEvent language=\"en_US\" name=\"ChallengeResponseFailed\">\n+    <managerEventInstance class=\"EVENT_FLAG_SECURITY\">\n+      <synopsis>Raised when a request's attempt to authenticate has been challenged, and the request failed the authentication challenge.</synopsis>\n+      <syntax>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='EventTV'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Severity'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Service'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='EventVersion'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='AccountID'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='SessionID'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='LocalAddress'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='RemoteAddress'])\"/>\n+        <parameter name=\"Challenge\">\n+          <para>The challenge that was sent.</para>\n+        </parameter>\n+        <parameter name=\"Response\">\n+          <para>The response that was received.</para>\n+        </parameter>\n+        <parameter name=\"ExpectedResponse\">\n+          <para>The expected response to the challenge.</para>\n+        </parameter>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Module'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='SessionTV'])\"/>\n+      </syntax>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <managerEvent language=\"en_US\" name=\"InvalidPassword\">\n+    <managerEventInstance class=\"EVENT_FLAG_SECURITY\">\n+      <synopsis>Raised when a request provides an invalid password during an authentication attempt.</synopsis>\n+      <syntax>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='EventTV'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Severity'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Service'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='EventVersion'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='AccountID'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='SessionID'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='LocalAddress'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='RemoteAddress'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Module'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='SessionTV'])\"/>\n+        <parameter name=\"Challenge\" required=\"false\">\n+          <para>The challenge that was sent.</para>\n+        </parameter>\n+        <parameter name=\"ReceivedChallenge\" required=\"false\">\n+          <para>The challenge that was received.</para>\n+        </parameter>\n+        <parameter name=\"ReceivedHash\" required=\"false\">\n+          <para>The hash that was received.</para>\n+        </parameter>\n+      </syntax>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <managerEvent language=\"en_US\" name=\"ChallengeSent\">\n+    <managerEventInstance class=\"EVENT_FLAG_SECURITY\">\n+      <synopsis>Raised when an Asterisk service sends an authentication challenge to a request.</synopsis>\n+      <syntax>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='EventTV'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Severity'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Service'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='EventVersion'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='AccountID'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='SessionID'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='LocalAddress'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='RemoteAddress'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='ChallengeResponseFailed']/managerEventInstance/syntax/parameter[@name='Challenge'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Module'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='SessionTV'])\"/>\n+      </syntax>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <managerEvent language=\"en_US\" name=\"InvalidTransport\">\n+    <managerEventInstance class=\"EVENT_FLAG_SECURITY\">\n+      <synopsis>Raised when a request attempts to use a transport not allowed by the Asterisk service.</synopsis>\n+      <syntax>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='EventTV'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Severity'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Service'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='EventVersion'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='AccountID'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='SessionID'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='LocalAddress'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='RemoteAddress'])\"/>\n+        <parameter name=\"AttemptedTransport\">\n+          <para>The transport type that the request attempted to use.</para>\n+        </parameter>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Module'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='SessionTV'])\"/>\n+      </syntax>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <module language=\"en_US\" name=\"framehook\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"channel_internal_api\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"xml\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"pbx_hangup_handler\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"json\">\n+    <depend>jansson</depend>\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"media_index\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"acl\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"message\">\n+    <support_level>core</support_level>\n+  </module>\n+  <function name=\"MESSAGE\" language=\"en_US\">\n+    <synopsis>Create a message or read fields from a message.</synopsis>\n+    <syntax argsep=\"/\">\n+      <parameter name=\"argument\" required=\"true\">\n+        <para>Field of the message to get or set.</para>\n+        <enumlist>\n+          <enum name=\"to\">\n+            <para>When processing an\n+\t\t\t\t\tincoming message, this will be set to the destination listed as\n+\t\t\t\t\tthe recipient of the message that was received by Asterisk.</para>\n+            <para/>\n+            <para>For an outgoing message, this will set the To header in the\n+\t\t\t\t\toutgoing SIP message.  This may be overridden by the &quot;to&quot; parameter\n+\t\t\t\t\tof MessageSend.</para>\n+          </enum>\n+          <enum name=\"from\">\n+            <para>When processing an\n+\t\t\t\t\tincoming message, this will be set to the source of the message.</para>\n+            <para/>\n+            <para>For an outgoing message, this will set the From header in the\n+\t\t\t\t\toutgoing SIP message. This may be overridden by the &quot;from&quot; parameter\n+\t\t\t\t\tof MessageSend.</para>\n+          </enum>\n+          <enum name=\"custom_data\">\n+            <para>Write-only.  Mark or unmark all message headers for an outgoing\n+\t\t\t\t\tmessage.  The following values can be set:</para>\n+            <enumlist>\n+              <enum name=\"mark_all_outbound\">\n+                <para>Mark all headers for an outgoing message.</para>\n+              </enum>\n+              <enum name=\"clear_all_outbound\">\n+                <para>Unmark all headers for an outgoing message.</para>\n+              </enum>\n+            </enumlist>\n+          </enum>\n+          <enum name=\"body\">\n+            <para>Read/Write.  The message body.  When processing an incoming\n+\t\t\t\t\tmessage, this includes the body of the message that Asterisk\n+\t\t\t\t\treceived.  When MessageSend() is executed, the contents of this\n+\t\t\t\t\tfield are used as the body of the outgoing message.  The body\n+\t\t\t\t\twill always be UTF-8.</para>\n+          </enum>\n+        </enumlist>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>If the call has not been answered, this application will\n-\t\t\tanswer it. Otherwise, it has no effect on the call.</para>\n+      <para>This function will read from or write a value to a text message.\n+\t\t\tIt is used both to read the data out of an incoming message, as well as\n+\t\t\tmodify or create a message that will be sent outbound.</para>\n     </description>\n     <see-also>\n-      <ref type=\"application\">Hangup</ref>\n+      <ref type=\"application\">MessageSend</ref>\n     </see-also>\n-  </application>\n-  <application name=\"BackGround\" language=\"en_US\">\n-    <synopsis>Play an audio file while waiting for digits of an extension to go to.</synopsis>\n-    <syntax>\n-      <parameter name=\"filenames\" required=\"true\" argsep=\"&amp;\">\n-        <argument name=\"filename1\" required=\"true\"/>\n-        <argument name=\"filename2\" multiple=\"true\"/>\n+  </function>\n+  <function name=\"MESSAGE_DATA\" language=\"en_US\">\n+    <synopsis>Read or write custom data attached to a message.</synopsis>\n+    <syntax argsep=\"/\">\n+      <parameter name=\"argument\" required=\"true\">\n+        <para>Field of the message to get or set.</para>\n       </parameter>\n-      <parameter name=\"options\">\n-        <optionlist>\n-          <option name=\"s\">\n-            <para>\n-              Causes the playback of the message to be skipped\n-\t\t\t\t\t\tif the channel is not in the\n-              <literal>up</literal>\n-              state (i.e. it\n-\t\t\t\t\t\thasn't been answered yet). If this happens, the\n-\t\t\t\t\t\tapplication will return immediately.\n-            </para>\n-          </option>\n-          <option name=\"n\">\n-            <para>Don't answer the channel before playing the files.</para>\n-          </option>\n-          <option name=\"m\">\n-            <para>Only break if a digit hit matches a one digit\n-\t\t\t\t\t\textension in the destination context.</para>\n-          </option>\n-          <option name=\"p\">\n-            <para>Do not allow playback to be interrupted with digits.</para>\n-          </option>\n-        </optionlist>\n+    </syntax>\n+    <description>\n+      <para>This function will read from or write a value to a text message.\n+\t\t\tIt is used both to read the data out of an incoming message, as well as\n+\t\t\tmodify a message that will be sent outbound.</para>\n+      <note>\n+        <para>\n+          If you want to set an outbound message to carry data in the\n+\t\t\t\tcurrent message, do\n+\t\t\t\tSet(MESSAGE_DATA(\n+          <replaceable>key</replaceable>\n+          )=${MESSAGE_DATA(\n+          <replaceable>key</replaceable>\n+          )}).\n+        </para>\n+      </note>\n+    </description>\n+    <see-also>\n+      <ref type=\"application\">MessageSend</ref>\n+    </see-also>\n+  </function>\n+  <application name=\"MessageSend\" language=\"en_US\">\n+    <synopsis>Send a text message.</synopsis>\n+    <syntax>\n+      <parameter name=\"destination\" required=\"true\">\n+        <para>A To URI for the message.</para>\n+        <xi:include xpointer=\"xpointer(/docs/info[@name='MessageDestinationInfo'])\"/>\n       </parameter>\n-      <parameter name=\"langoverride\">\n-        <para>Explicitly specifies which language to attempt to use for the requested sound files.</para>\n+      <parameter name=\"from\" required=\"false\">\n+        <para>\n+          A From URI for the message if needed for the\n+\t\t\t\tmessage technology being used to send this message. This can be a\n+\t\t\t\tSIP(S) URI, such as\n+          <literal>Alice &lt;sip:alice@atlanta.com&gt;</literal>\n+          ,\n+\t\t\t\tor a string in the format\n+          <literal>alice@atlanta.com</literal>\n+          .\n+\t\t\t\tThis will override a\n+          <literal>from</literal>\n+          specified using the MESSAGE dialplan function or the\n+          <literal>from</literal>\n+          that may have been on an incoming message.\n+        </para>\n+        <xi:include xpointer=\"xpointer(/docs/info[@name='MessageFromInfo'])\"/>\n       </parameter>\n-      <parameter name=\"context\">\n-        <para>This is the dialplan context that this application will use when exiting\n-\t\t\t\tto a dialed extension.</para>\n+      <parameter name=\"to\" required=\"false\">\n+        <para>\n+          A To URI for the message if needed for the\n+\t\t\t\tmessage technology being used to send this message. This can be a\n+\t\t\t\tSIP(S) URI, such as\n+          <literal>Alice &lt;sip:alice@atlanta.com&gt;</literal>\n+          ,\n+\t\t\t\tor a string in the format\n+          <literal>alice@atlanta.com</literal>\n+          .\n+\t\t\t\tThis will override a\n+          <literal>to</literal>\n+          specified using the MESSAGE dialplan function or the\n+          <literal>to</literal>\n+          that may have been on an incoming message.\n+        </para>\n+        <xi:include xpointer=\"xpointer(/docs/info[@name='MessageToInfo'])\"/>\n       </parameter>\n     </syntax>\n     <description>\n       <para>\n-        This application will play the given list of files\n-        <emphasis>(do not put extension)</emphasis>\n-        while waiting for an extension to be dialed by the calling channel. To continue waiting\n-\t\t\tfor digits after this application has finished playing files, the\n-        <literal>WaitExten</literal>\n-        application should be used.\n+        Send a text message.  The body of the message that will be\n+\t\t\tsent is what is currently set to\n+        <literal>MESSAGE(body)</literal>\n+        .\n+\t\t\tThis may he come from an incoming message.\n+\t\t\tThe technology chosen for sending the message is determined\n+\t\t\tbased on a prefix to the\n+        <literal>destination</literal>\n+        parameter.\n       </para>\n-      <para>If one of the requested sound files does not exist, call processing will be terminated.</para>\n-      <para>This application sets the following channel variable upon completion:</para>\n+      <para>This application sets the following channel variables:</para>\n       <variablelist>\n-        <variable name=\"BACKGROUNDSTATUS\">\n-          <para>The status of the background attempt as a text string.</para>\n-          <value name=\"SUCCESS\"/>\n-          <value name=\"FAILED\"/>\n+        <variable name=\"MESSAGE_SEND_STATUS\">\n+          <para>This is the message delivery status returned by this application.</para>\n+          <value name=\"INVALID_PROTOCOL\">No handler for the technology part of the URI was found.</value>\n+          <value name=\"INVALID_URI\">The protocol handler reported that the URI was not valid.</value>\n+          <value name=\"SUCCESS\">Successfully passed on to the protocol handler, but delivery has not necessarily been guaranteed.</value>\n+          <value name=\"FAILURE\">The protocol handler reported that it was unabled to deliver the message for some reason.</value>\n         </variable>\n       </variablelist>\n     </description>\n-    <see-also>\n-      <ref type=\"application\">ControlPlayback</ref>\n-      <ref type=\"application\">WaitExten</ref>\n-      <ref type=\"application\">BackgroundDetect</ref>\n-      <ref type=\"function\">TIMEOUT</ref>\n-    </see-also>\n   </application>\n-  <application name=\"Busy\" language=\"en_US\">\n-    <synopsis>Indicate the Busy condition.</synopsis>\n+  <manager name=\"MessageSend\" language=\"en_US\">\n+    <synopsis>Send an out of call message to an endpoint.</synopsis>\n     <syntax>\n-      <parameter name=\"timeout\">\n-        <para>If specified, the calling channel will be hung up after the specified number of seconds.\n-\t\t\t\tOtherwise, this application will wait until the calling channel hangs up.</para>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      <parameter name=\"Destination\" required=\"false\">\n+        <para>A To URI for the message. If Destination is provided, the To\n+\t\t\t\tparameter can also be supplied and may alter the message based on\n+\t\t\t\tthe specified message technology.</para>\n+        <para>For backwards compatibility, if Destination is not provided,\n+\t\t\t\tthe To parameter must be provided and will be used as the message\n+\t\t\t\tdestination.</para>\n+        <xi:include xpointer=\"xpointer(/docs/info[@name='MessageDestinationInfo'])\"/>\n+      </parameter>\n+      <parameter name=\"To\" required=\"false\">\n+        <para>\n+          A To URI for the message if needed for the\n+\t\t\t\tmessage technology being used to send this message. This can be a\n+\t\t\t\tSIP(S) URI, such as\n+          <literal>Alice &lt;sip:alice@atlanta.com&gt;</literal>\n+          ,\n+\t\t\t\tor a string in the format\n+          <literal>alice@atlanta.com</literal>\n+          .\n+        </para>\n+        <para>This parameter is required if the Destination parameter is not\n+\t\t\t\tprovided.</para>\n+        <xi:include xpointer=\"xpointer(/docs/info[@name='MessageToInfo'])\"/>\n+      </parameter>\n+      <parameter name=\"From\">\n+        <para>A From URI for the message if needed for the\n+\t\t\t\tmessage technology being used to send this message.</para>\n+        <xi:include xpointer=\"xpointer(/docs/info[@name='MessageFromInfo'])\"/>\n+      </parameter>\n+      <parameter name=\"Body\">\n+        <para>The message body text.  This must not contain any newlines as that\n+\t\t\t\tconflicts with the AMI protocol.</para>\n+      </parameter>\n+      <parameter name=\"Base64Body\">\n+        <para>Text bodies requiring the use of newlines have to be base64 encoded\n+\t\t\t\tin this field.  Base64Body will be decoded before being sent out.\n+\t\t\t\tBase64Body takes precedence over Body.</para>\n+      </parameter>\n+      <parameter name=\"Variable\">\n+        <para>Message variable to set, multiple Variable: headers are\n+\t\t\t\tallowed.  The header value is a comma separated list of\n+\t\t\t\tname=value pairs.</para>\n       </parameter>\n     </syntax>\n+  </manager>\n+  <module language=\"en_US\" name=\"libasteriskpj\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"stasis_system\">\n+    <support_level>core</support_level>\n+  </module>\n+  <managerEvent language=\"en_US\" name=\"Registry\">\n+    <managerEventInstance class=\"EVENT_FLAG_SYSTEM\">\n+      <synopsis>Raised when an outbound registration completes.</synopsis>\n+      <syntax>\n+        <parameter name=\"ChannelType\">\n+          <para>The type of channel that was registered (or not).</para>\n+        </parameter>\n+        <parameter name=\"Username\">\n+          <para>The username portion of the registration.</para>\n+        </parameter>\n+        <parameter name=\"Domain\">\n+          <para>The address portion of the registration.</para>\n+        </parameter>\n+        <parameter name=\"Status\">\n+          <para>The status of the registration request.</para>\n+          <enumlist>\n+            <enum name=\"Registered\"/>\n+            <enum name=\"Unregistered\"/>\n+            <enum name=\"Rejected\"/>\n+            <enum name=\"Failed\"/>\n+          </enumlist>\n+        </parameter>\n+        <parameter name=\"Cause\">\n+          <para>What caused the rejection of the request, if available.</para>\n+        </parameter>\n+      </syntax>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <module language=\"en_US\" name=\"file\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"stasis_cache\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"stasis\">\n+    <support_level>core</support_level>\n+  </module>\n+  <managerEvent language=\"en_US\" name=\"UserEvent\">\n+    <managerEventInstance class=\"EVENT_FLAG_USER\">\n+      <synopsis>A user defined event raised from the dialplan.</synopsis>\n+      <syntax>\n+        <channel_snapshot/>\n+        <parameter name=\"UserEvent\">\n+          <para>The event name, as specified in the dialplan.</para>\n+        </parameter>\n+      </syntax>\n+      <description>\n+        <para>Event may contain additional arbitrary parameters in addition to optional bridge and endpoint snapshots.  Multiple snapshots of the same type are prefixed with a numeric value.</para>\n+      </description>\n+      <see-also>\n+        <ref type=\"application\">UserEvent</ref>\n+        <ref type=\"managerEvent\">UserEvent</ref>\n+      </see-also>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <configInfo name=\"stasis\" language=\"en_US\">\n+    <configFile name=\"stasis.conf\">\n+      <configObject name=\"threadpool\">\n+        <synopsis>Settings that configure the threadpool Stasis uses to deliver some messages.</synopsis>\n+        <configOption name=\"initial_size\" default=\"5\">\n+          <synopsis>Initial number of threads in the message bus threadpool.</synopsis>\n+        </configOption>\n+        <configOption name=\"idle_timeout_sec\" default=\"20\">\n+          <synopsis>Number of seconds before an idle thread is disposed of.</synopsis>\n+        </configOption>\n+        <configOption name=\"max_size\" default=\"50\">\n+          <synopsis>Maximum number of threads in the threadpool.</synopsis>\n+        </configOption>\n+      </configObject>\n+      <configObject name=\"declined_message_types\">\n+        <synopsis>Stasis message types for which to decline creation.</synopsis>\n+        <configOption name=\"decline\">\n+          <synopsis>The message type to decline.</synopsis>\n+          <description>\n+            <para>This configuration option defines the name of the Stasis\n+\t\t\t\t\t\tmessage type that Asterisk is forbidden from creating and can be\n+\t\t\t\t\t\tspecified as many times as necessary to achieve the desired result.</para>\n+            <enumlist>\n+              <enum name=\"stasis_app_recording_snapshot_type\"/>\n+              <enum name=\"stasis_app_playback_snapshot_type\"/>\n+              <enum name=\"stasis_test_message_type\"/>\n+              <enum name=\"confbridge_start_type\"/>\n+              <enum name=\"confbridge_end_type\"/>\n+              <enum name=\"confbridge_join_type\"/>\n+              <enum name=\"confbridge_leave_type\"/>\n+              <enum name=\"confbridge_start_record_type\"/>\n+              <enum name=\"confbridge_stop_record_type\"/>\n+              <enum name=\"confbridge_mute_type\"/>\n+              <enum name=\"confbridge_unmute_type\"/>\n+              <enum name=\"confbridge_talking_type\"/>\n+              <enum name=\"cel_generic_type\"/>\n+              <enum name=\"ast_bridge_snapshot_type\"/>\n+              <enum name=\"ast_bridge_merge_message_type\"/>\n+              <enum name=\"ast_channel_entered_bridge_type\"/>\n+              <enum name=\"ast_channel_left_bridge_type\"/>\n+              <enum name=\"ast_blind_transfer_type\"/>\n+              <enum name=\"ast_attended_transfer_type\"/>\n+              <enum name=\"ast_endpoint_snapshot_type\"/>\n+              <enum name=\"ast_endpoint_state_type\"/>\n+              <enum name=\"ast_device_state_message_type\"/>\n+              <enum name=\"ast_test_suite_message_type\"/>\n+              <enum name=\"ast_mwi_state_type\"/>\n+              <enum name=\"ast_mwi_vm_app_type\"/>\n+              <enum name=\"ast_format_register_type\"/>\n+              <enum name=\"ast_format_unregister_type\"/>\n+              <enum name=\"ast_manager_get_generic_type\"/>\n+              <enum name=\"ast_parked_call_type\"/>\n+              <enum name=\"ast_channel_snapshot_type\"/>\n+              <enum name=\"ast_channel_dial_type\"/>\n+              <enum name=\"ast_channel_varset_type\"/>\n+              <enum name=\"ast_channel_hangup_request_type\"/>\n+              <enum name=\"ast_channel_dtmf_begin_type\"/>\n+              <enum name=\"ast_channel_dtmf_end_type\"/>\n+              <enum name=\"ast_channel_flash_type\"/>\n+              <enum name=\"ast_channel_wink_type\"/>\n+              <enum name=\"ast_channel_hold_type\"/>\n+              <enum name=\"ast_channel_unhold_type\"/>\n+              <enum name=\"ast_channel_chanspy_start_type\"/>\n+              <enum name=\"ast_channel_chanspy_stop_type\"/>\n+              <enum name=\"ast_channel_fax_type\"/>\n+              <enum name=\"ast_channel_hangup_handler_type\"/>\n+              <enum name=\"ast_channel_moh_start_type\"/>\n+              <enum name=\"ast_channel_moh_stop_type\"/>\n+              <enum name=\"ast_channel_monitor_start_type\"/>\n+              <enum name=\"ast_channel_monitor_stop_type\"/>\n+              <enum name=\"ast_channel_mixmonitor_start_type\"/>\n+              <enum name=\"ast_channel_mixmonitor_stop_type\"/>\n+              <enum name=\"ast_channel_mixmonitor_mute_type\"/>\n+              <enum name=\"ast_channel_agent_login_type\"/>\n+              <enum name=\"ast_channel_agent_logoff_type\"/>\n+              <enum name=\"ast_channel_talking_start\"/>\n+              <enum name=\"ast_channel_talking_stop\"/>\n+              <enum name=\"ast_security_event_type\"/>\n+              <enum name=\"ast_named_acl_change_type\"/>\n+              <enum name=\"ast_local_bridge_type\"/>\n+              <enum name=\"ast_local_optimization_begin_type\"/>\n+              <enum name=\"ast_local_optimization_end_type\"/>\n+              <enum name=\"stasis_subscription_change_type\"/>\n+              <enum name=\"ast_multi_user_event_type\"/>\n+              <enum name=\"stasis_cache_clear_type\"/>\n+              <enum name=\"stasis_cache_update_type\"/>\n+              <enum name=\"ast_network_change_type\"/>\n+              <enum name=\"ast_system_registry_type\"/>\n+              <enum name=\"ast_cc_available_type\"/>\n+              <enum name=\"ast_cc_offertimerstart_type\"/>\n+              <enum name=\"ast_cc_requested_type\"/>\n+              <enum name=\"ast_cc_requestacknowledged_type\"/>\n+              <enum name=\"ast_cc_callerstopmonitoring_type\"/>\n+              <enum name=\"ast_cc_callerstartmonitoring_type\"/>\n+              <enum name=\"ast_cc_callerrecalling_type\"/>\n+              <enum name=\"ast_cc_recallcomplete_type\"/>\n+              <enum name=\"ast_cc_failure_type\"/>\n+              <enum name=\"ast_cc_monitorfailed_type\"/>\n+              <enum name=\"ast_presence_state_message_type\"/>\n+              <enum name=\"ast_rtp_rtcp_sent_type\"/>\n+              <enum name=\"ast_rtp_rtcp_received_type\"/>\n+              <enum name=\"ast_call_pickup_type\"/>\n+              <enum name=\"aoc_s_type\"/>\n+              <enum name=\"aoc_d_type\"/>\n+              <enum name=\"aoc_e_type\"/>\n+              <enum name=\"dahdichannel_type\"/>\n+              <enum name=\"mcid_type\"/>\n+              <enum name=\"session_timeout_type\"/>\n+              <enum name=\"cdr_read_message_type\"/>\n+              <enum name=\"cdr_write_message_type\"/>\n+              <enum name=\"cdr_prop_write_message_type\"/>\n+              <enum name=\"corosync_ping_message_type\"/>\n+              <enum name=\"agi_exec_start_type\"/>\n+              <enum name=\"agi_exec_end_type\"/>\n+              <enum name=\"agi_async_start_type\"/>\n+              <enum name=\"agi_async_exec_type\"/>\n+              <enum name=\"agi_async_end_type\"/>\n+              <enum name=\"queue_caller_join_type\"/>\n+              <enum name=\"queue_caller_leave_type\"/>\n+              <enum name=\"queue_caller_abandon_type\"/>\n+              <enum name=\"queue_member_status_type\"/>\n+              <enum name=\"queue_member_added_type\"/>\n+              <enum name=\"queue_member_removed_type\"/>\n+              <enum name=\"queue_member_pause_type\"/>\n+              <enum name=\"queue_member_penalty_type\"/>\n+              <enum name=\"queue_member_ringinuse_type\"/>\n+              <enum name=\"queue_agent_called_type\"/>\n+              <enum name=\"queue_agent_connect_type\"/>\n+              <enum name=\"queue_agent_complete_type\"/>\n+              <enum name=\"queue_agent_dump_type\"/>\n+              <enum name=\"queue_agent_ringnoanswer_type\"/>\n+              <enum name=\"meetme_join_type\"/>\n+              <enum name=\"meetme_leave_type\"/>\n+              <enum name=\"meetme_end_type\"/>\n+              <enum name=\"meetme_mute_type\"/>\n+              <enum name=\"meetme_talking_type\"/>\n+              <enum name=\"meetme_talk_request_type\"/>\n+              <enum name=\"appcdr_message_type\"/>\n+              <enum name=\"forkcdr_message_type\"/>\n+              <enum name=\"cdr_sync_message_type\"/>\n+            </enumlist>\n+          </description>\n+        </configOption>\n+      </configObject>\n+    </configFile>\n+  </configInfo>\n+  <module language=\"en_US\" name=\"pbx_switch\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"fskmodem_float\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"astobj2\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"term\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"manager\">\n+    <support_level>core</support_level>\n+  </module>\n+  <manager name=\"Ping\" language=\"en_US\">\n+    <synopsis>Keepalive command.</synopsis>\n+    <syntax>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+    </syntax>\n     <description>\n-      <para>This application will indicate the busy condition to the calling channel.</para>\n+      <para>A 'Ping' action will elicit a 'Pong' response. Used to keep the\n+\t\t\tmanager connection open.</para>\n     </description>\n-    <see-also>\n-      <ref type=\"application\">Congestion</ref>\n-      <ref type=\"application\">Progress</ref>\n-      <ref type=\"application\">Playtones</ref>\n-      <ref type=\"application\">Hangup</ref>\n-    </see-also>\n-  </application>\n-  <application name=\"Congestion\" language=\"en_US\">\n-    <synopsis>Indicate the Congestion condition.</synopsis>\n+  </manager>\n+  <manager name=\"Events\" language=\"en_US\">\n+    <synopsis>Control Event Flow.</synopsis>\n     <syntax>\n-      <parameter name=\"timeout\">\n-        <para>If specified, the calling channel will be hung up after the specified number of seconds.\n-\t\t\t\tOtherwise, this application will wait until the calling channel hangs up.</para>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      <parameter name=\"EventMask\" required=\"true\">\n+        <enumlist>\n+          <enum name=\"on\">\n+            <para>If all events should be sent.</para>\n+          </enum>\n+          <enum name=\"off\">\n+            <para>If no events should be sent.</para>\n+          </enum>\n+          <enum name=\"system,call,log,...\">\n+            <para>To select which flags events should have to be sent.</para>\n+          </enum>\n+        </enumlist>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>This application will indicate the congestion condition to the calling channel.</para>\n+      <para>Enable/Disable sending of events to this manager client.</para>\n+    </description>\n+  </manager>\n+  <manager name=\"Logoff\" language=\"en_US\">\n+    <synopsis>Logoff Manager.</synopsis>\n+    <syntax>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+    </syntax>\n+    <description>\n+      <para>Logoff the current manager session.</para>\n     </description>\n     <see-also>\n-      <ref type=\"application\">Busy</ref>\n-      <ref type=\"application\">Progress</ref>\n-      <ref type=\"application\">Playtones</ref>\n-      <ref type=\"application\">Hangup</ref>\n+      <ref type=\"manager\">Login</ref>\n     </see-also>\n-  </application>\n-  <application name=\"ExecIfTime\" language=\"en_US\">\n-    <synopsis>Conditional application execution based on the current time.</synopsis>\n-    <syntax argsep=\"?\">\n-      <parameter name=\"day_condition\" required=\"true\">\n-        <argument name=\"times\" required=\"true\"/>\n-        <argument name=\"weekdays\" required=\"true\"/>\n-        <argument name=\"mdays\" required=\"true\"/>\n-        <argument name=\"months\" required=\"true\"/>\n-        <argument name=\"timezone\" required=\"false\"/>\n+  </manager>\n+  <manager name=\"Login\" language=\"en_US\">\n+    <synopsis>Login Manager.</synopsis>\n+    <syntax>\n+      <parameter name=\"ActionID\">\n+        <para>ActionID for this transaction. Will be returned.</para>\n       </parameter>\n-      <parameter name=\"appname\" required=\"true\" hasparams=\"optional\">\n-        <argument name=\"appargs\" required=\"true\"/>\n+      <parameter name=\"Username\" required=\"true\">\n+        <para>Username to login with as specified in manager.conf.</para>\n+      </parameter>\n+      <parameter name=\"Secret\">\n+        <para>Secret to login with as specified in manager.conf.</para>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>This application will execute the specified dialplan application, with optional\n-\t\t\targuments, if the current time matches the given time specification.</para>\n+      <para>Login Manager.</para>\n     </description>\n     <see-also>\n-      <ref type=\"application\">Exec</ref>\n-      <ref type=\"application\">ExecIf</ref>\n-      <ref type=\"application\">TryExec</ref>\n-      <ref type=\"application\">GotoIfTime</ref>\n+      <ref type=\"manager\">Logoff</ref>\n     </see-also>\n-  </application>\n-  <application name=\"Goto\" language=\"en_US\">\n-    <synopsis>Jump to a particular priority, extension, or context.</synopsis>\n+  </manager>\n+  <manager name=\"Challenge\" language=\"en_US\">\n+    <synopsis>Generate Challenge for MD5 Auth.</synopsis>\n     <syntax>\n-      <parameter name=\"context\"/>\n-      <parameter name=\"extensions\"/>\n-      <parameter name=\"priority\" required=\"true\"/>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      <parameter name=\"AuthType\" required=\"true\">\n+        <para>Digest algorithm to use in the challenge. Valid values are:</para>\n+        <enumlist>\n+          <enum name=\"MD5\"/>\n+        </enumlist>\n+      </parameter>\n     </syntax>\n     <description>\n-      <para>\n-        This application will set the current context, extension, and priority in the channel structure.\n-\t\t\tAfter it completes, the pbx engine will continue dialplan execution at the specified location.\n-\t\t\tIf no specific\n-        <replaceable>extension</replaceable>\n-        , or\n-        <replaceable>extension</replaceable>\n-        and\n-        <replaceable>context</replaceable>\n-        , are specified, then this application will\n-\t\t\tjust set the specified\n-        <replaceable>priority</replaceable>\n-        of the current extension.\n-      </para>\n-      <para>\n-        At least a\n-        <replaceable>priority</replaceable>\n-        is required as an argument, or the goto will\n-\t\t\treturn a\n-        <literal>-1</literal>\n-        ,\tand the channel and call will be terminated.\n-      </para>\n-      <para>\n-        If the location that is put into the channel information is bogus, and asterisk cannot\n-\t\t\tfind that location in the dialplan, then the execution engine will try to find and execute the code in\n-\t\t\tthe\n-        <literal>i</literal>\n-        (invalid) extension in the current context. If that does not exist, it will try to execute the\n-        <literal>h</literal>\n-        extension. If neither the\n-        <literal>h</literal>\n-        nor\n-        <literal>i</literal>\n-        extensions\n-\t\t\thave been defined, the channel is hung up, and the execution of instructions on the channel is terminated.\n-\t\t\tWhat this means is that, for example, you specify a context that does not exist, then\n-\t\t\tit will not be possible to find the\n-        <literal>h</literal>\n-        or\n-        <literal>i</literal>\n-        extensions,\n-\t\t\tand the call will terminate!\n-      </para>\n+      <para>Generate a challenge for MD5 authentication.</para>\n     </description>\n-    <see-also>\n-      <ref type=\"application\">GotoIf</ref>\n-      <ref type=\"application\">GotoIfTime</ref>\n-      <ref type=\"application\">Gosub</ref>\n-      <ref type=\"application\">Macro</ref>\n-    </see-also>\n-  </application>\n-  <application name=\"GotoIf\" language=\"en_US\">\n-    <synopsis>Conditional goto.</synopsis>\n-    <syntax argsep=\"?\">\n-      <parameter name=\"condition\" required=\"true\"/>\n-      <parameter name=\"destination\" required=\"true\" argsep=\":\">\n-        <argument name=\"labeliftrue\">\n-          <para>\n-            Continue at\n-            <replaceable>labeliftrue</replaceable>\n-            if the condition is true.\n-\t\t\t\t\tTakes the form similar to Goto() of [[context,]extension,]priority.\n-          </para>\n-        </argument>\n-        <argument name=\"labeliffalse\">\n-          <para>\n-            Continue at\n-            <replaceable>labeliffalse</replaceable>\n-            if the condition is false.\n-\t\t\t\t\tTakes the form similar to Goto() of [[context,]extension,]priority.\n-          </para>\n-        </argument>\n+  </manager>\n+  <manager name=\"Hangup\" language=\"en_US\">\n+    <synopsis>Hangup channel.</synopsis>\n+    <syntax>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      <parameter name=\"Channel\" required=\"true\">\n+        <para>The exact channel name to be hungup, or to use a regular expression, set this parameter to: /regex/</para>\n+        <para>Example exact channel: SIP/provider-0000012a</para>\n+        <para>Example regular expression: /^SIP/provider-.*$/</para>\n+      </parameter>\n+      <parameter name=\"Cause\">\n+        <para>Numeric hangup cause.</para>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>\n-        This application will set the current context, extension, and priority in the channel structure\n-\t\t\tbased on the evaluation of the given condition. After this application completes, the\n-\t\t\tpbx engine will continue dialplan execution at the specified location in the dialplan.\n-\t\t\tThe labels are specified with the same syntax as used within the Goto application.\n-\t\t\tIf the label chosen by the condition is omitted, no jump is performed, and the execution passes to the\n-\t\t\tnext instruction. If the target location is bogus, and does not exist, the execution engine will try\n-\t\t\tto find and execute the code in the\n-        <literal>i</literal>\n-        (invalid) extension in the current context.\n-\t\t\tIf that does not exist, it will try to execute the\n-        <literal>h</literal>\n-        extension.\n-\t\t\tIf neither the\n-        <literal>h</literal>\n-        nor\n-        <literal>i</literal>\n-        extensions have been defined,\n-\t\t\tthe channel is hung up, and the execution of instructions on the channel is terminated.\n-\t\t\tRemember that this command can set the current context, and if the context specified\n-\t\t\tdoes not exist, then it will not be able to find any 'h' or 'i' extensions there, and\n-\t\t\tthe channel and call will both be terminated!.\n-      </para>\n+      <para>Hangup a channel.</para>\n+    </description>\n+  </manager>\n+  <manager name=\"Status\" language=\"en_US\">\n+    <synopsis>List channel status.</synopsis>\n+    <syntax>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      <parameter name=\"Channel\" required=\"false\">\n+        <para>The name of the channel to query for status.</para>\n+      </parameter>\n+      <parameter name=\"Variables\">\n+        <para>\n+          Comma\n+          <literal>,</literal>\n+          separated list of variable to include.\n+        </para>\n+      </parameter>\n+      <parameter name=\"AllVariables\">\n+        <para>If set to &quot;true&quot;, the Status event will include all channel variables for\n+\t\t\t\tthe requested channel(s).</para>\n+        <enumlist>\n+          <enum name=\"true\"/>\n+          <enum name=\"false\"/>\n+        </enumlist>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>Will return the status information of each channel along with the\n+\t\t\tvalue for the specified channel variables.</para>\n+    </description>\n+    <responses>\n+      <list-elements>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='Status'])\"/>\n+      </list-elements>\n+      <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='StatusComplete'])\"/>\n+    </responses>\n+  </manager>\n+  <managerEvent language=\"en_US\" name=\"Status\">\n+    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n+      <synopsis>Raised in response to a Status command.</synopsis>\n+      <syntax>\n+        <parameter name=\"ActionID\" required=\"false\"/>\n+        <channel_snapshot/>\n+        <parameter name=\"Type\">\n+          <para>Type of channel</para>\n+        </parameter>\n+        <parameter name=\"DNID\">\n+          <para>Dialed number identifier</para>\n+        </parameter>\n+        <parameter name=\"EffectiveConnectedLineNum\"/>\n+        <parameter name=\"EffectiveConnectedLineName\"/>\n+        <parameter name=\"TimeToHangup\">\n+          <para>Absolute lifetime of the channel</para>\n+        </parameter>\n+        <parameter name=\"BridgeID\">\n+          <para>Identifier of the bridge the channel is in, may be empty if not in one</para>\n+        </parameter>\n+        <parameter name=\"Application\">\n+          <para>Application currently executing on the channel</para>\n+        </parameter>\n+        <parameter name=\"Data\">\n+          <para>Data given to the currently executing channel</para>\n+        </parameter>\n+        <parameter name=\"Nativeformats\">\n+          <para>Media formats the connected party is willing to send or receive</para>\n+        </parameter>\n+        <parameter name=\"Readformat\">\n+          <para>Media formats that frames from the channel are received in</para>\n+        </parameter>\n+        <parameter name=\"Readtrans\">\n+          <para>Translation path for media received in native formats</para>\n+        </parameter>\n+        <parameter name=\"Writeformat\">\n+          <para>Media formats that frames to the channel are accepted in</para>\n+        </parameter>\n+        <parameter name=\"Writetrans\">\n+          <para>Translation path for media sent to the connected party</para>\n+        </parameter>\n+        <parameter name=\"Callgroup\">\n+          <para>Configured call group on the channel</para>\n+        </parameter>\n+        <parameter name=\"Pickupgroup\">\n+          <para>Configured pickup group on the channel</para>\n+        </parameter>\n+        <parameter name=\"Seconds\">\n+          <para>Number of seconds the channel has been active</para>\n+        </parameter>\n+      </syntax>\n+      <see-also>\n+        <ref type=\"manager\">Status</ref>\n+      </see-also>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <managerEvent language=\"en_US\" name=\"StatusComplete\">\n+    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n+      <synopsis>Raised in response to a Status command.</synopsis>\n+      <syntax>\n+        <parameter name=\"Items\">\n+          <para>Number of Status events returned</para>\n+        </parameter>\n+      </syntax>\n+      <see-also>\n+        <ref type=\"manager\">Status</ref>\n+      </see-also>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <manager name=\"Setvar\" language=\"en_US\">\n+    <synopsis>Sets a channel variable or function value.</synopsis>\n+    <syntax>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      <parameter name=\"Channel\">\n+        <para>Channel to set variable for.</para>\n+      </parameter>\n+      <parameter name=\"Variable\" required=\"true\">\n+        <para>Variable name, function or expression.</para>\n+      </parameter>\n+      <parameter name=\"Value\" required=\"true\">\n+        <para>Variable or function value.</para>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>This command can be used to set the value of channel variables or dialplan\n+\t\t\tfunctions.</para>\n+      <note>\n+        <para>If a channel name is not provided then the variable is considered global.</para>\n+      </note>\n     </description>\n     <see-also>\n-      <ref type=\"application\">Goto</ref>\n-      <ref type=\"application\">GotoIfTime</ref>\n-      <ref type=\"application\">GosubIf</ref>\n-      <ref type=\"application\">MacroIf</ref>\n+      <ref type=\"manager\">Getvar</ref>\n     </see-also>\n-  </application>\n-  <application name=\"GotoIfTime\" language=\"en_US\">\n-    <synopsis>Conditional Goto based on the current time.</synopsis>\n-    <syntax argsep=\"?\">\n-      <parameter name=\"condition\" required=\"true\">\n-        <argument name=\"times\" required=\"true\"/>\n-        <argument name=\"weekdays\" required=\"true\"/>\n-        <argument name=\"mdays\" required=\"true\"/>\n-        <argument name=\"months\" required=\"true\"/>\n-        <argument name=\"timezone\" required=\"false\"/>\n+  </manager>\n+  <manager name=\"Getvar\" language=\"en_US\">\n+    <synopsis>Gets a channel variable or function value.</synopsis>\n+    <syntax>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      <parameter name=\"Channel\">\n+        <para>Channel to read variable from.</para>\n       </parameter>\n-      <parameter name=\"destination\" required=\"true\" argsep=\":\">\n-        <argument name=\"labeliftrue\">\n-          <para>\n-            Continue at\n-            <replaceable>labeliftrue</replaceable>\n-            if the condition is true.\n-\t\t\t\t\tTakes the form similar to Goto() of [[context,]extension,]priority.\n-          </para>\n-        </argument>\n-        <argument name=\"labeliffalse\">\n-          <para>\n-            Continue at\n-            <replaceable>labeliffalse</replaceable>\n-            if the condition is false.\n-\t\t\t\t\tTakes the form similar to Goto() of [[context,]extension,]priority.\n-          </para>\n-        </argument>\n+      <parameter name=\"Variable\" required=\"true\">\n+        <para>Variable name, function or expression.</para>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>\n-        This application will set the context, extension, and priority in the channel structure\n-\t\t\tbased on the evaluation of the given time specification. After this application completes,\n-\t\t\tthe pbx engine will continue dialplan execution at the specified location in the dialplan.\n-\t\t\tIf the current time is within the given time specification, the channel will continue at\n-        <replaceable>labeliftrue</replaceable>\n-        . Otherwise the channel will continue at\n-        <replaceable>labeliffalse</replaceable>\n-        .\n-\t\t\tIf the label chosen by the condition is omitted, no jump is performed, and execution passes to the next\n-\t\t\tinstruction. If the target jump location is bogus, the same actions would be taken as for\n-        <literal>Goto</literal>\n-        .\n-\t\t\tFurther information on the time specification can be found in examples\n-\t\t\tillustrating how to do time-based context includes in the dialplan.\n-      </para>\n+      <para>Get the value of a channel variable or function return.</para>\n+      <note>\n+        <para>If a channel name is not provided then the variable is considered global.</para>\n+      </note>\n     </description>\n     <see-also>\n-      <ref type=\"application\">GotoIf</ref>\n-      <ref type=\"application\">Goto</ref>\n-      <ref type=\"function\">IFTIME</ref>\n-      <ref type=\"function\">TESTTIME</ref>\n+      <ref type=\"manager\">Setvar</ref>\n     </see-also>\n-  </application>\n-  <application name=\"ImportVar\" language=\"en_US\">\n-    <synopsis>Import a variable from a channel into a new variable.</synopsis>\n-    <syntax argsep=\"=\">\n-      <parameter name=\"newvar\" required=\"true\"/>\n-      <parameter name=\"vardata\" required=\"true\">\n-        <argument name=\"channelname\" required=\"true\"/>\n-        <argument name=\"variable\" required=\"true\"/>\n+  </manager>\n+  <manager name=\"GetConfig\" language=\"en_US\">\n+    <synopsis>Retrieve configuration.</synopsis>\n+    <syntax>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      <parameter name=\"Filename\" required=\"true\">\n+        <para>\n+          Configuration filename (e.g.\n+          <filename>foo.conf</filename>\n+          ).\n+        </para>\n+      </parameter>\n+      <parameter name=\"Category\">\n+        <para>Category in configuration file.</para>\n+      </parameter>\n+      <parameter name=\"Filter\">\n+        <para>\n+          A comma separated list of\n+          <replaceable>name_regex</replaceable>\n+          =\n+          <replaceable>value_regex</replaceable>\n+          expressions which will cause only categories whose variables match all expressions\n+\t\t\t\tto be considered.  The special variable name\n+          <literal>TEMPLATES</literal>\n+          can be used to control whether templates are included.  Passing\n+          <literal>include</literal>\n+          as the value will include templates\n+\t\t\t\talong with normal categories. Passing\n+          <literal>restrict</literal>\n+          as the value will restrict the operation to\n+\t\t\t\tONLY templates.  Not specifying a\n+          <literal>TEMPLATES</literal>\n+          expression\n+\t\t\t\tresults in the default behavior which is to not include templates.\n+        </para>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>\n-        This application imports a\n-        <replaceable>variable</replaceable>\n-        from the specified\n-        <replaceable>channel</replaceable>\n-        (as opposed to the current one) and stores it as a variable\n-\t\t\t(\n-        <replaceable>newvar</replaceable>\n-        ) in the current channel (the channel that is calling this\n-\t\t\tapplication). Variables created by this application have the same inheritance properties as those\n-\t\t\tcreated with the\n-        <literal>Set</literal>\n-        application.\n-      </para>\n+      <para>This action will dump the contents of a configuration\n+\t\t\tfile by category and contents or optionally by specified category only.\n+\t\t\tIn the case where a category name is non-unique, a filter may be specified\n+\t\t\tto match only categories with matching variable values.</para>\n     </description>\n     <see-also>\n-      <ref type=\"application\">Set</ref>\n+      <ref type=\"manager\">GetConfigJSON</ref>\n+      <ref type=\"manager\">UpdateConfig</ref>\n+      <ref type=\"manager\">CreateConfig</ref>\n+      <ref type=\"manager\">ListCategories</ref>\n     </see-also>\n-  </application>\n-  <application name=\"Hangup\" language=\"en_US\">\n-    <synopsis>Hang up the calling channel.</synopsis>\n+  </manager>\n+  <manager name=\"GetConfigJSON\" language=\"en_US\">\n+    <synopsis>Retrieve configuration (JSON format).</synopsis>\n     <syntax>\n-      <parameter name=\"causecode\">\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      <parameter name=\"Filename\" required=\"true\">\n         <para>\n-          If a\n-          <replaceable>causecode</replaceable>\n-          is given the channel's\n-\t\t\t\thangup cause will be set to the given value.\n+          Configuration filename (e.g.\n+          <filename>foo.conf</filename>\n+          ).\n         </para>\n       </parameter>\n+      <parameter name=\"Category\">\n+        <para>Category in configuration file.</para>\n+      </parameter>\n+      <parameter name=\"Filter\">\n+        <xi:include xpointer=\"xpointer(/docs/manager[@name='GetConfig']/syntax/parameter[@name='Filter']/para[1])\"/>\n+      </parameter>\n     </syntax>\n     <description>\n-      <para>This application will hang up the calling channel.</para>\n+      <para>This action will dump the contents of a configuration file by category\n+\t\t\tand contents in JSON format or optionally by specified category only.\n+\t\t\tThis only makes sense to be used using rawman over the HTTP interface.\n+\t\t\tIn the case where a category name is non-unique, a filter may be specified\n+\t\t\tto match only categories with matching variable values.</para>\n     </description>\n     <see-also>\n-      <ref type=\"application\">Answer</ref>\n-      <ref type=\"application\">Busy</ref>\n-      <ref type=\"application\">Congestion</ref>\n+      <ref type=\"manager\">GetConfig</ref>\n+      <ref type=\"manager\">UpdateConfig</ref>\n+      <ref type=\"manager\">CreateConfig</ref>\n+      <ref type=\"manager\">ListCategories</ref>\n     </see-also>\n-  </application>\n-  <application name=\"Incomplete\" language=\"en_US\">\n-    <synopsis>Returns AST_PBX_INCOMPLETE value.</synopsis>\n+  </manager>\n+  <manager name=\"UpdateConfig\" language=\"en_US\">\n+    <synopsis>Update basic configuration.</synopsis>\n     <syntax>\n-      <parameter name=\"n\">\n-        <para>If specified, then Incomplete will not attempt to answer the channel first.</para>\n-        <note>\n-          <para>Most channel types need to be in Answer state in order to receive DTMF.</para>\n-        </note>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      <parameter name=\"SrcFilename\" required=\"true\">\n+        <para>\n+          Configuration filename to read (e.g.\n+          <filename>foo.conf</filename>\n+          ).\n+        </para>\n+      </parameter>\n+      <parameter name=\"DstFilename\" required=\"true\">\n+        <para>\n+          Configuration filename to write (e.g.\n+          <filename>foo.conf</filename>\n+          )\n+        </para>\n+      </parameter>\n+      <parameter name=\"Reload\">\n+        <para>Whether or not a reload should take place (or name of specific module).</para>\n+      </parameter>\n+      <parameter name=\"PreserveEffectiveContext\">\n+        <para>Whether the effective category contents should be preserved on template change. Default is true (pre 13.2 behavior).</para>\n+      </parameter>\n+      <parameter name=\"Action-000000\">\n+        <para>Action to take.</para>\n+        <para>0's represent 6 digit number beginning with 000000.</para>\n+        <enumlist>\n+          <enum name=\"NewCat\"/>\n+          <enum name=\"RenameCat\"/>\n+          <enum name=\"DelCat\"/>\n+          <enum name=\"EmptyCat\"/>\n+          <enum name=\"Update\"/>\n+          <enum name=\"Delete\"/>\n+          <enum name=\"Append\"/>\n+          <enum name=\"Insert\"/>\n+        </enumlist>\n+      </parameter>\n+      <parameter name=\"Cat-000000\">\n+        <para>Category to operate on.</para>\n+        <xi:include xpointer=\"xpointer(/docs/manager[@name='UpdateConfig']/syntax/parameter[@name='Action-000000']/para[2])\"/>\n+      </parameter>\n+      <parameter name=\"Var-000000\">\n+        <para>Variable to work on.</para>\n+        <xi:include xpointer=\"xpointer(/docs/manager[@name='UpdateConfig']/syntax/parameter[@name='Action-000000']/para[2])\"/>\n+      </parameter>\n+      <parameter name=\"Value-000000\">\n+        <para>Value to work on.</para>\n+        <xi:include xpointer=\"xpointer(/docs/manager[@name='UpdateConfig']/syntax/parameter[@name='Action-000000']/para[2])\"/>\n+      </parameter>\n+      <parameter name=\"Match-000000\">\n+        <para>Extra match required to match line.</para>\n+        <xi:include xpointer=\"xpointer(/docs/manager[@name='UpdateConfig']/syntax/parameter[@name='Action-000000']/para[2])\"/>\n+      </parameter>\n+      <parameter name=\"Line-000000\">\n+        <para>Line in category to operate on (used with delete and insert actions).</para>\n+        <xi:include xpointer=\"xpointer(/docs/manager[@name='UpdateConfig']/syntax/parameter[@name='Action-000000']/para[2])\"/>\n+      </parameter>\n+      <parameter name=\"Options-000000\">\n+        <para>A comma separated list of action-specific options.</para>\n+        <enumlist>\n+          <enum name=\"NewCat\">\n+            <para>One or more of the following...</para>\n+            <enumlist>\n+              <enum name=\"allowdups\">\n+                <para>Allow duplicate category names.</para>\n+              </enum>\n+              <enum name=\"template\">\n+                <para>This category is a template.</para>\n+              </enum>\n+              <enum name=\"inherit=&quot;template[,...]&quot;\">\n+                <para>Templates from which to inherit.</para>\n+              </enum>\n+            </enumlist>\n+          </enum>\n+        </enumlist>\n+        <para/>\n+        <para>The following actions share the same options...</para>\n+        <enumlist>\n+          <enum name=\"RenameCat\"/>\n+          <enum name=\"DelCat\"/>\n+          <enum name=\"EmptyCat\"/>\n+          <enum name=\"Update\"/>\n+          <enum name=\"Delete\"/>\n+          <enum name=\"Append\"/>\n+          <enum name=\"Insert\">\n+            <para/>\n+            <enumlist>\n+              <enum name=\"catfilter=&quot;&lt;expression&gt;[,...]&quot;\">\n+                <para/>\n+                <xi:include xpointer=\"xpointer(/docs/manager[@name='GetConfig']/syntax/parameter[@name='Filter']/para[1])\"/>\n+                <para>\n+                  <literal>catfilter</literal>\n+                  is most useful when a file\n+\t\t\t\t\t\t\t\t\tcontains multiple categories with the same name and you wish to\n+\t\t\t\t\t\t\t\t\toperate on specific ones instead of all of them.\n+                </para>\n+              </enum>\n+            </enumlist>\n+          </enum>\n+        </enumlist>\n+        <xi:include xpointer=\"xpointer(/docs/manager[@name='UpdateConfig']/syntax/parameter[@name='Action-000000']/para[2])\"/>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>Signals the PBX routines that the previous matched extension is incomplete\n-\t\t\tand that further input should be allowed before matching can be considered\n-\t\t\tto be complete.  Can be used within a pattern match when certain criteria warrants\n-\t\t\ta longer match.</para>\n+      <para>This action will modify, create, or delete configuration elements\n+\t\t\tin Asterisk configuration files.</para>\n     </description>\n-  </application>\n-  <application name=\"NoOp\" language=\"en_US\">\n-    <synopsis>Do Nothing (No Operation).</synopsis>\n+    <see-also>\n+      <ref type=\"manager\">GetConfig</ref>\n+      <ref type=\"manager\">GetConfigJSON</ref>\n+      <ref type=\"manager\">CreateConfig</ref>\n+      <ref type=\"manager\">ListCategories</ref>\n+    </see-also>\n+  </manager>\n+  <manager name=\"CreateConfig\" language=\"en_US\">\n+    <synopsis>Creates an empty file in the configuration directory.</synopsis>\n     <syntax>\n-      <parameter name=\"text\">\n-        <para>Any text provided can be viewed at the Asterisk CLI.</para>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      <parameter name=\"Filename\" required=\"true\">\n+        <para>\n+          The configuration filename to create (e.g.\n+          <filename>foo.conf</filename>\n+          ).\n+        </para>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>This application does nothing. However, it is useful for debugging purposes.</para>\n-      <para>This method can be used to see the evaluations of variables or functions without having any effect.</para>\n+      <para>This action will create an empty file in the configuration\n+\t\t\tdirectory. This action is intended to be used before an UpdateConfig\n+\t\t\taction.</para>\n     </description>\n     <see-also>\n-      <ref type=\"application\">Verbose</ref>\n-      <ref type=\"application\">Log</ref>\n+      <ref type=\"manager\">GetConfig</ref>\n+      <ref type=\"manager\">GetConfigJSON</ref>\n+      <ref type=\"manager\">UpdateConfig</ref>\n+      <ref type=\"manager\">ListCategories</ref>\n     </see-also>\n-  </application>\n-  <application name=\"Proceeding\" language=\"en_US\">\n-    <synopsis>Indicate proceeding.</synopsis>\n-    <syntax/>\n+  </manager>\n+  <manager name=\"ListCategories\" language=\"en_US\">\n+    <synopsis>List categories in configuration file.</synopsis>\n+    <syntax>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      <parameter name=\"Filename\" required=\"true\">\n+        <para>\n+          Configuration filename (e.g.\n+          <filename>foo.conf</filename>\n+          ).\n+        </para>\n+      </parameter>\n+    </syntax>\n     <description>\n-      <para>This application will request that a proceeding message be provided to the calling channel.</para>\n+      <para>This action will dump the categories in a given file.</para>\n     </description>\n-  </application>\n-  <application name=\"Progress\" language=\"en_US\">\n-    <synopsis>Indicate progress.</synopsis>\n-    <syntax/>\n+    <see-also>\n+      <ref type=\"manager\">GetConfig</ref>\n+      <ref type=\"manager\">GetConfigJSON</ref>\n+      <ref type=\"manager\">UpdateConfig</ref>\n+      <ref type=\"manager\">CreateConfig</ref>\n+    </see-also>\n+  </manager>\n+  <manager name=\"Redirect\" language=\"en_US\">\n+    <synopsis>Redirect (transfer) a call.</synopsis>\n+    <syntax>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      <parameter name=\"Channel\" required=\"true\">\n+        <para>Channel to redirect.</para>\n+      </parameter>\n+      <parameter name=\"ExtraChannel\">\n+        <para>Second call leg to transfer (optional).</para>\n+      </parameter>\n+      <parameter name=\"Exten\" required=\"true\">\n+        <para>Extension to transfer to.</para>\n+      </parameter>\n+      <parameter name=\"ExtraExten\">\n+        <para>Extension to transfer extrachannel to (optional).</para>\n+      </parameter>\n+      <parameter name=\"Context\" required=\"true\">\n+        <para>Context to transfer to.</para>\n+      </parameter>\n+      <parameter name=\"ExtraContext\">\n+        <para>Context to transfer extrachannel to (optional).</para>\n+      </parameter>\n+      <parameter name=\"Priority\" required=\"true\">\n+        <para>Priority to transfer to.</para>\n+      </parameter>\n+      <parameter name=\"ExtraPriority\">\n+        <para>Priority to transfer extrachannel to (optional).</para>\n+      </parameter>\n+    </syntax>\n     <description>\n-      <para>This application will request that in-band progress information be provided to the calling channel.</para>\n+      <para>Redirect (transfer) a call.</para>\n     </description>\n     <see-also>\n-      <ref type=\"application\">Busy</ref>\n-      <ref type=\"application\">Congestion</ref>\n-      <ref type=\"application\">Ringing</ref>\n-      <ref type=\"application\">Playtones</ref>\n+      <ref type=\"manager\">BlindTransfer</ref>\n     </see-also>\n-  </application>\n-  <application name=\"RaiseException\" language=\"en_US\">\n-    <synopsis>Handle an exceptional condition.</synopsis>\n+  </manager>\n+  <manager name=\"Atxfer\" language=\"en_US\">\n+    <synopsis>Attended transfer.</synopsis>\n     <syntax>\n-      <parameter name=\"reason\" required=\"true\"/>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      <parameter name=\"Channel\" required=\"true\">\n+        <para>Transferer's channel.</para>\n+      </parameter>\n+      <parameter name=\"Exten\" required=\"true\">\n+        <para>Extension to transfer to.</para>\n+      </parameter>\n+      <parameter name=\"Context\">\n+        <para>Context to transfer to.</para>\n+      </parameter>\n     </syntax>\n     <description>\n-      <para>\n-        This application will jump to the\n-        <literal>e</literal>\n-        extension in the current context, setting the\n-\t\t\tdialplan function EXCEPTION(). If the\n-        <literal>e</literal>\n-        extension does not exist, the call will hangup.\n-      </para>\n+      <para>Attended transfer.</para>\n     </description>\n     <see-also>\n-      <ref type=\"function\">Exception</ref>\n+      <ref type=\"managerEvent\">AttendedTransfer</ref>\n     </see-also>\n-  </application>\n-  <application name=\"Ringing\" language=\"en_US\">\n-    <synopsis>Indicate ringing tone.</synopsis>\n-    <syntax/>\n+  </manager>\n+  <manager name=\"CancelAtxfer\" language=\"en_US\">\n+    <since>\n+      <version>13.18.0</version>\n+      <version>14.7.0</version>\n+      <version>15.1.0</version>\n+      <version>16.0.0</version>\n+    </since>\n+    <synopsis>Cancel an attended transfer.</synopsis>\n+    <syntax>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      <parameter name=\"Channel\" required=\"true\">\n+        <para>The transferer channel.</para>\n+      </parameter>\n+    </syntax>\n     <description>\n-      <para>This application will request that the channel indicate a ringing tone to the user.</para>\n+      <para>Cancel an attended transfer. Note, this uses the configured cancel attended transfer\n+\t\t\tfeature option (atxferabort) to cancel the transfer. If not available this action will fail.</para>\n     </description>\n     <see-also>\n-      <ref type=\"application\">Busy</ref>\n-      <ref type=\"application\">Congestion</ref>\n-      <ref type=\"application\">Progress</ref>\n-      <ref type=\"application\">Playtones</ref>\n+      <ref type=\"managerEvent\">AttendedTransfer</ref>\n     </see-also>\n-  </application>\n-  <application name=\"SayAlpha\" language=\"en_US\">\n-    <synopsis>Say Alpha.</synopsis>\n+  </manager>\n+  <manager name=\"Originate\" language=\"en_US\">\n+    <synopsis>Originate a call.</synopsis>\n     <syntax>\n-      <parameter name=\"string\" required=\"true\"/>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      <parameter name=\"Channel\" required=\"true\">\n+        <para>Channel name to call.</para>\n+      </parameter>\n+      <parameter name=\"Exten\">\n+        <para>\n+          Extension to use (requires\n+          <literal>Context</literal>\n+          and\n+          <literal>Priority</literal>\n+          )\n+        </para>\n+      </parameter>\n+      <parameter name=\"Context\">\n+        <para>\n+          Context to use (requires\n+          <literal>Exten</literal>\n+          and\n+          <literal>Priority</literal>\n+          )\n+        </para>\n+      </parameter>\n+      <parameter name=\"Priority\">\n+        <para>\n+          Priority to use (requires\n+          <literal>Exten</literal>\n+          and\n+          <literal>Context</literal>\n+          )\n+        </para>\n+      </parameter>\n+      <parameter name=\"Application\">\n+        <para>Application to execute.</para>\n+      </parameter>\n+      <parameter name=\"Data\">\n+        <para>\n+          Data to use (requires\n+          <literal>Application</literal>\n+          ).\n+        </para>\n+      </parameter>\n+      <parameter name=\"Timeout\" default=\"30000\">\n+        <para>How long to wait for call to be answered (in ms.).</para>\n+      </parameter>\n+      <parameter name=\"CallerID\">\n+        <para>Caller ID to be set on the outgoing channel.</para>\n+      </parameter>\n+      <parameter name=\"Variable\">\n+        <para>Channel variable to set, multiple Variable: headers are allowed.</para>\n+      </parameter>\n+      <parameter name=\"Account\">\n+        <para>Account code.</para>\n+      </parameter>\n+      <parameter name=\"EarlyMedia\">\n+        <para>\n+          Set to\n+          <literal>true</literal>\n+          to force call bridge on early media..\n+        </para>\n+      </parameter>\n+      <parameter name=\"Async\">\n+        <para>\n+          Set to\n+          <literal>true</literal>\n+          for fast origination.\n+        </para>\n+      </parameter>\n+      <parameter name=\"Codecs\">\n+        <para>Comma-separated list of codecs to use for this call.</para>\n+      </parameter>\n+      <parameter name=\"ChannelId\">\n+        <para>Channel UniqueId to be set on the channel.</para>\n+      </parameter>\n+      <parameter name=\"OtherChannelId\">\n+        <para>Channel UniqueId to be set on the second local channel.</para>\n+      </parameter>\n     </syntax>\n     <description>\n       <para>\n-        This application will play the sounds that correspond to the letters\n-\t\t\tof the given\n-        <replaceable>string</replaceable>\n-        . If the channel variable\n-        <variable>SAY_DTMF_INTERRUPT</variable>\n-        is set to 'true' (case insensitive),\n-\t\t\tthen this application will react to DTMF in the\tsame way as\n-        <literal>Background</literal>\n-        .\n+        Generates an outgoing call to a\n+        <replaceable>Extension</replaceable>\n+        /\n+        <replaceable>Context</replaceable>\n+        /\n+        <replaceable>Priority</replaceable>\n+        or\n+        <replaceable>Application</replaceable>\n+        /\n+        <replaceable>Data</replaceable>\n       </para>\n     </description>\n     <see-also>\n-      <ref type=\"application\">SayDigits</ref>\n-      <ref type=\"application\">SayMoney</ref>\n-      <ref type=\"application\">SayNumber</ref>\n-      <ref type=\"application\">SayOrdinal</ref>\n-      <ref type=\"application\">SayPhonetic</ref>\n-      <ref type=\"function\">CHANNEL</ref>\n-      <ref type=\"function\">SAYFILES</ref>\n+      <ref type=\"managerEvent\">OriginateResponse</ref>\n     </see-also>\n-  </application>\n-  <application name=\"SayAlphaCase\" language=\"en_US\">\n-    <synopsis>Say Alpha.</synopsis>\n+  </manager>\n+  <managerEvent language=\"en_US\" name=\"OriginateResponse\">\n+    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n+      <synopsis>Raised in response to an Originate command.</synopsis>\n+      <syntax>\n+        <parameter name=\"ActionID\" required=\"false\"/>\n+        <parameter name=\"Response\">\n+          <enumlist>\n+            <enum name=\"Failure\"/>\n+            <enum name=\"Success\"/>\n+          </enumlist>\n+        </parameter>\n+        <parameter name=\"Channel\"/>\n+        <parameter name=\"Context\"/>\n+        <parameter name=\"Exten\"/>\n+        <parameter name=\"Application\"/>\n+        <parameter name=\"Data\"/>\n+        <parameter name=\"Reason\"/>\n+        <parameter name=\"Uniqueid\"/>\n+        <parameter name=\"CallerIDNum\"/>\n+        <parameter name=\"CallerIDName\"/>\n+      </syntax>\n+      <see-also>\n+        <ref type=\"manager\">Originate</ref>\n+      </see-also>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <manager name=\"Command\" language=\"en_US\">\n+    <synopsis>Execute Asterisk CLI Command.</synopsis>\n     <syntax>\n-      <parameter name=\"casetype\" required=\"true\">\n-        <enumlist>\n-          <enum name=\"a\">\n-            <para>Case sensitive (all) pronunciation.\n-\t\t\t\t\t\t(Ex: SayAlphaCase(a,aBc); - lowercase a uppercase b lowercase c).</para>\n-          </enum>\n-          <enum name=\"l\">\n-            <para>Case sensitive (lower) pronunciation.\n-\t\t\t\t\t\t(Ex: SayAlphaCase(l,aBc); - lowercase a b lowercase c).</para>\n-          </enum>\n-          <enum name=\"n\">\n-            <para>Case insensitive pronunciation. Equivalent to SayAlpha.\n-\t\t\t\t\t\t(Ex: SayAlphaCase(n,aBc) - a b c).</para>\n-          </enum>\n-          <enum name=\"u\">\n-            <para>Case sensitive (upper) pronunciation.\n-\t\t\t\t\t\t(Ex: SayAlphaCase(u,aBc); - a uppercase b c).</para>\n-          </enum>\n-        </enumlist>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      <parameter name=\"Command\" required=\"true\">\n+        <para>Asterisk CLI command to run.</para>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>Run a CLI command.</para>\n+    </description>\n+  </manager>\n+  <manager name=\"ExtensionState\" language=\"en_US\">\n+    <synopsis>Check Extension Status.</synopsis>\n+    <syntax>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      <parameter name=\"Exten\" required=\"true\">\n+        <para>Extension to check state on.</para>\n+      </parameter>\n+      <parameter name=\"Context\" required=\"true\">\n+        <para>Context for extension.</para>\n       </parameter>\n-      <parameter name=\"string\" required=\"true\"/>\n     </syntax>\n     <description>\n+      <para>Report the extension state for given extension. If the extension has a hint,\n+\t\t\twill use devicestate to check the status of the device connected to the extension.</para>\n       <para>\n-        This application will play the sounds that correspond to the letters of the\n-\t\t\tgiven\n-        <replaceable>string</replaceable>\n-        .  Optionally, a\n-        <replaceable>casetype</replaceable>\n-        may be\n-\t\t\tspecified.  This will be used for case-insensitive or case-sensitive pronunciations. If the channel\n-\t\t\tvariable\n-        <variable>SAY_DTMF_INTERRUPT</variable>\n-        is set to 'true' (case insensitive), then this\n-\t\t\tapplication will react to DTMF in the same way as\n-        <literal>Background</literal>\n-        .\n+        Will return an\n+        <literal>Extension Status</literal>\n+        message. The response will include\n+\t\t\tthe hint for the extension and the status.\n       </para>\n     </description>\n     <see-also>\n-      <ref type=\"application\">SayDigits</ref>\n-      <ref type=\"application\">SayMoney</ref>\n-      <ref type=\"application\">SayNumber</ref>\n-      <ref type=\"application\">SayOrdinal</ref>\n-      <ref type=\"application\">SayPhonetic</ref>\n-      <ref type=\"application\">SayAlpha</ref>\n-      <ref type=\"function\">CHANNEL</ref>\n+      <ref type=\"managerEvent\">ExtensionStatus</ref>\n     </see-also>\n-  </application>\n-  <application name=\"SayDigits\" language=\"en_US\">\n-    <synopsis>Say Digits.</synopsis>\n+  </manager>\n+  <manager name=\"PresenceState\" language=\"en_US\">\n+    <synopsis>Check Presence State</synopsis>\n     <syntax>\n-      <parameter name=\"digits\" required=\"true\"/>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      <parameter name=\"Provider\" required=\"true\">\n+        <para>Presence Provider to check the state of</para>\n+      </parameter>\n     </syntax>\n     <description>\n+      <para>Report the presence state for the given presence provider.</para>\n       <para>\n-        This application will play the sounds that correspond to the digits of\n-\t\t\tthe given number. This will use the language that is currently set for the channel.\n-\t\t\tIf the channel variable\n-        <variable>SAY_DTMF_INTERRUPT</variable>\n-        is set to 'true'\n-\t\t\t(case insensitive), then this application will react to DTMF in the same way as\n-        <literal>Background</literal>\n-        .\n+        Will return a\n+        <literal>Presence State</literal>\n+        message. The response will include the\n+\t\t\tpresence state and, if set, a presence subtype and custom message.\n       </para>\n     </description>\n     <see-also>\n-      <ref type=\"application\">SayAlpha</ref>\n-      <ref type=\"application\">SayMoney</ref>\n-      <ref type=\"application\">SayNumber</ref>\n-      <ref type=\"application\">SayOrdinal</ref>\n-      <ref type=\"application\">SayPhonetic</ref>\n-      <ref type=\"function\">CHANNEL</ref>\n-      <ref type=\"function\">SAYFILES</ref>\n+      <ref type=\"managerEvent\">PresenceStatus</ref>\n     </see-also>\n-  </application>\n-  <application name=\"SayMoney\" language=\"en_US\">\n-    <synopsis>Say Money.</synopsis>\n+  </manager>\n+  <manager name=\"AbsoluteTimeout\" language=\"en_US\">\n+    <synopsis>Set absolute timeout.</synopsis>\n     <syntax>\n-      <parameter name=\"dollars\" required=\"true\"/>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      <parameter name=\"Channel\" required=\"true\">\n+        <para>Channel name to hangup.</para>\n+      </parameter>\n+      <parameter name=\"Timeout\" required=\"true\">\n+        <para>Maximum duration of the call (sec).</para>\n+      </parameter>\n     </syntax>\n     <description>\n       <para>\n-        This application will play the currency sounds for the given floating point number\n-\t\t\tin the current language. Currently only English and US Dollars is supported.\n-\t\t\tIf the channel variable\n-        <variable>SAY_DTMF_INTERRUPT</variable>\n-        is set to 'true'\n-\t\t\t(case insensitive), then this application will react to DTMF in the same way as\n-        <literal>Background</literal>\n-        .\n+        Hangup a channel after a certain time. Acknowledges set time with\n+        <literal>Timeout Set</literal>\n+        message.\n       </para>\n     </description>\n-    <see-also>\n-      <ref type=\"application\">SayAlpha</ref>\n-      <ref type=\"application\">SayNumber</ref>\n-      <ref type=\"application\">SayOrdinal</ref>\n-      <ref type=\"application\">SayPhonetic</ref>\n-      <ref type=\"function\">CHANNEL</ref>\n-      <ref type=\"function\">SAYFILES</ref>\n-    </see-also>\n-  </application>\n-  <application name=\"SayNumber\" language=\"en_US\">\n-    <synopsis>Say Number.</synopsis>\n+  </manager>\n+  <manager name=\"MailboxStatus\" language=\"en_US\">\n+    <synopsis>Check mailbox.</synopsis>\n     <syntax>\n-      <parameter name=\"digits\" required=\"true\"/>\n-      <parameter name=\"gender\"/>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      <parameter name=\"Mailbox\" required=\"true\">\n+        <para>\n+          Full mailbox ID\n+          <replaceable>mailbox</replaceable>\n+          @\n+          <replaceable>vm-context</replaceable>\n+          .\n+        </para>\n+      </parameter>\n     </syntax>\n     <description>\n+      <para>Checks a voicemail account for status.</para>\n+      <para>Returns whether there are messages waiting.</para>\n+      <para>Message: Mailbox Status.</para>\n       <para>\n-        This application will play the sounds that correspond to the given\n-        <replaceable>digits</replaceable>\n-        . Optionally, a\n-        <replaceable>gender</replaceable>\n-        may be\n-\t\t\tspecified. This will use the language that is currently set for the channel. See the CHANNEL()\n-\t\t\tfunction for more information on setting the language for the channel. If the channel variable\n-        <variable>SAY_DTMF_INTERRUPT</variable>\n-        is set to 'true' (case insensitive), then this\n-\t\t\tapplication will react to DTMF in the same way as\n-        <literal>Background</literal>\n+        Mailbox:\n+        <replaceable>mailboxid</replaceable>\n         .\n       </para>\n+      <para>\n+        Waiting:\n+        <literal>0</literal>\n+        if messages waiting,\n+        <literal>1</literal>\n+        if no messages waiting.\n+      </para>\n     </description>\n     <see-also>\n-      <ref type=\"application\">SayAlpha</ref>\n-      <ref type=\"application\">SayDigits</ref>\n-      <ref type=\"application\">SayMoney</ref>\n-      <ref type=\"application\">SayPhonetic</ref>\n-      <ref type=\"function\">CHANNEL</ref>\n-      <ref type=\"function\">SAYFILES</ref>\n+      <ref type=\"manager\">MailboxCount</ref>\n     </see-also>\n-  </application>\n-  <application name=\"SayOrdinal\" language=\"en_US\">\n-    <synopsis>Say Ordinal Number.</synopsis>\n+  </manager>\n+  <manager name=\"MailboxCount\" language=\"en_US\">\n+    <synopsis>Check Mailbox Message Count.</synopsis>\n     <syntax>\n-      <parameter name=\"digits\" required=\"true\"/>\n-      <parameter name=\"gender\"/>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      <parameter name=\"Mailbox\" required=\"true\">\n+        <para>\n+          Full mailbox ID\n+          <replaceable>mailbox</replaceable>\n+          @\n+          <replaceable>vm-context</replaceable>\n+          .\n+        </para>\n+      </parameter>\n     </syntax>\n     <description>\n+      <para>Checks a voicemail account for new messages.</para>\n+      <para>Returns number of urgent, new and old messages.</para>\n+      <para>Message: Mailbox Message Count</para>\n       <para>\n-        This application will play the ordinal sounds that correspond to the given\n-        <replaceable>digits</replaceable>\n-        (e.g. 1st, 42nd). Currently only English is supported.\n+        Mailbox:\n+        <replaceable>mailboxid</replaceable>\n       </para>\n       <para>\n-        Optionally, a\n-        <replaceable>gender</replaceable>\n-        may be\n-\t\t\tspecified. This will use the language that is currently set for the channel. See the CHANNEL()\n-\t\t\tfunction for more information on setting the language for the channel. If the channel variable\n-        <variable>SAY_DTMF_INTERRUPT</variable>\n-        is set to 'true' (case insensitive), then this\n-\t\t\tapplication will react to DTMF in the same way as\n-        <literal>Background</literal>\n-        .\n+        UrgentMessages:\n+        <replaceable>count</replaceable>\n+      </para>\n+      <para>\n+        NewMessages:\n+        <replaceable>count</replaceable>\n+      </para>\n+      <para>\n+        OldMessages:\n+        <replaceable>count</replaceable>\n       </para>\n     </description>\n     <see-also>\n-      <ref type=\"application\">SayAlpha</ref>\n-      <ref type=\"application\">SayDigits</ref>\n-      <ref type=\"application\">SayMoney</ref>\n-      <ref type=\"application\">SayNumber</ref>\n-      <ref type=\"application\">SayPhonetic</ref>\n-      <ref type=\"function\">CHANNEL</ref>\n-      <ref type=\"function\">SAYFILES</ref>\n+      <ref type=\"manager\">MailboxStatus</ref>\n     </see-also>\n-  </application>\n-  <application name=\"SayPhonetic\" language=\"en_US\">\n-    <synopsis>Say Phonetic.</synopsis>\n+  </manager>\n+  <manager name=\"ListCommands\" language=\"en_US\">\n+    <synopsis>List available manager commands.</synopsis>\n     <syntax>\n-      <parameter name=\"string\" required=\"true\"/>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n     </syntax>\n     <description>\n-      <para>\n-        This application will play the sounds from the phonetic alphabet that correspond to the\n-\t\t\tletters in the given\n-        <replaceable>string</replaceable>\n-        . If the channel variable\n-        <variable>SAY_DTMF_INTERRUPT</variable>\n-        is set to 'true' (case insensitive), then this\n-\t\t\tapplication will react to DTMF in the same way as\n-        <literal>Background</literal>\n-        .\n-      </para>\n+      <para>Returns the action name and synopsis for every action that\n+\t\t\tis available to the user.</para>\n+    </description>\n+  </manager>\n+  <manager name=\"SendText\" language=\"en_US\">\n+    <synopsis>Sends a text message to channel. A content type\tcan be optionally specified. If not set\n+\t\t\tit is set to an empty string allowing a custom handler to default it as it sees fit.</synopsis>\n+    <syntax>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      <parameter name=\"Channel\" required=\"true\">\n+        <para>Channel to send message to.</para>\n+      </parameter>\n+      <parameter name=\"Message\" required=\"true\">\n+        <para>Message to send.</para>\n+      </parameter>\n+      <parameter name=\"Content-Type\" required=\"false\" default=\"\">\n+        <para>The type of content in the message</para>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>Sends A Text Message to a channel while in a call.</para>\n     </description>\n     <see-also>\n-      <ref type=\"application\">SayAlpha</ref>\n-      <ref type=\"application\">SayDigits</ref>\n-      <ref type=\"application\">SayMoney</ref>\n-      <ref type=\"application\">SayNumber</ref>\n-      <ref type=\"application\">SayOrdinal</ref>\n-      <ref type=\"function\">SAYFILES</ref>\n+      <ref type=\"application\">SendText</ref>\n     </see-also>\n-  </application>\n-  <application name=\"SetAMAFlags\" language=\"en_US\">\n-    <synopsis>Set the AMA Flags.</synopsis>\n+  </manager>\n+  <manager name=\"UserEvent\" language=\"en_US\">\n+    <synopsis>Send an arbitrary event.</synopsis>\n     <syntax>\n-      <parameter name=\"flag\"/>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      <parameter name=\"UserEvent\" required=\"true\">\n+        <para>Event string to send.</para>\n+      </parameter>\n+      <parameter name=\"Header1\">\n+        <para>Content1.</para>\n+      </parameter>\n+      <parameter name=\"HeaderN\">\n+        <para>ContentN.</para>\n+      </parameter>\n     </syntax>\n     <description>\n-      <para>This application will set the channel's AMA Flags for billing purposes.</para>\n-      <warning>\n-        <para>This application is deprecated. Please use the CHANNEL function instead.</para>\n-      </warning>\n+      <para>Send an event to manager sessions.</para>\n     </description>\n     <see-also>\n-      <ref type=\"function\">CDR</ref>\n-      <ref type=\"function\">CHANNEL</ref>\n+      <ref type=\"managerEvent\">UserEvent</ref>\n+      <ref type=\"application\">UserEvent</ref>\n     </see-also>\n-  </application>\n-  <application name=\"Wait\" language=\"en_US\">\n-    <synopsis>Waits for some time.</synopsis>\n+  </manager>\n+  <manager name=\"WaitEvent\" language=\"en_US\">\n+    <synopsis>Wait for an event to occur.</synopsis>\n     <syntax>\n-      <parameter name=\"seconds\" required=\"true\">\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      <parameter name=\"Timeout\" required=\"true\">\n         <para>\n-          Can be passed with fractions of a second. For example,\n-          <literal>1.5</literal>\n-          will ask the\n-\t\t\t\tapplication to wait for 1.5 seconds.\n+          Maximum time (in seconds) to wait for events,\n+          <literal>-1</literal>\n+          means forever.\n         </para>\n       </parameter>\n     </syntax>\n     <description>\n       <para>\n-        This application waits for a specified number of\n-        <replaceable>seconds</replaceable>\n-        .\n+        This action will elicit a\n+        <literal>Success</literal>\n+        response. Whenever\n+\t\t\ta manager event is queued. Once WaitEvent has been called on an HTTP manager\n+\t\t\tsession, events will be generated and queued.\n       </para>\n     </description>\n-  </application>\n-  <application name=\"WaitDigit\" language=\"en_US\">\n-    <synopsis>Waits for a digit to be entered.</synopsis>\n+  </manager>\n+  <manager name=\"CoreSettings\" language=\"en_US\">\n+    <synopsis>Show PBX core settings (version etc).</synopsis>\n     <syntax>\n-      <parameter name=\"seconds\">\n-        <para>\n-          Can be passed with fractions of a second. For example,\n-          <literal>1.5</literal>\n-          will ask the\n-\t\t\t\tapplication to wait for 1.5 seconds.\n-        </para>\n-      </parameter>\n-      <parameter name=\"digits\">\n-        <para>Digits to accept, all others are ignored.</para>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+    </syntax>\n+    <description>\n+      <para>Query for Core PBX settings.</para>\n+    </description>\n+  </manager>\n+  <manager name=\"CoreStatus\" language=\"en_US\">\n+    <synopsis>Show PBX core status variables.</synopsis>\n+    <syntax>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+    </syntax>\n+    <description>\n+      <para>Query for Core PBX status.</para>\n+    </description>\n+  </manager>\n+  <manager name=\"Reload\" language=\"en_US\">\n+    <synopsis>Send a reload event.</synopsis>\n+    <syntax>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      <parameter name=\"Module\">\n+        <para>Name of the module to reload.</para>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>\n-        This application waits for the user to press one of the accepted\n-        <replaceable>digits</replaceable>\n-        for a specified number of\n-        <replaceable>seconds</replaceable>\n-        .\n-      </para>\n-      <variablelist>\n-        <variable name=\"WAITDIGITSTATUS\">\n-          <para>This is the final status of the command</para>\n-          <value name=\"ERROR\">Parameters are invalid.</value>\n-          <value name=\"DTMF\">An accepted digit was received.</value>\n-          <value name=\"TIMEOUT\">The timeout passed before any acceptable digits were received.</value>\n-          <value name=\"CANCEL\">The channel has hungup or was redirected.</value>\n-        </variable>\n-        <variable name=\"WAITDIGITRESULT\">\n-          <para>\n-            The digit that was received, only set if\n-            <variable>WAITDIGITSTATUS</variable>\n-            is\n-            <literal>DTMF</literal>\n-            .\n-          </para>\n-        </variable>\n-      </variablelist>\n+      <para>Send a reload event.</para>\n     </description>\n     <see-also>\n-      <ref type=\"application\">Wait</ref>\n-      <ref type=\"application\">WaitExten</ref>\n+      <ref type=\"manager\">ModuleLoad</ref>\n     </see-also>\n-  </application>\n-  <application name=\"WaitExten\" language=\"en_US\">\n-    <synopsis>Waits for an extension to be entered.</synopsis>\n+  </manager>\n+  <managerEvent language=\"en_US\" name=\"CoreShowChannel\">\n+    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n+      <synopsis>Raised in response to a CoreShowChannels command.</synopsis>\n+      <syntax>\n+        <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+        <channel_snapshot/>\n+        <parameter name=\"BridgeId\">\n+          <para>Identifier of the bridge the channel is in, may be empty if not in one</para>\n+        </parameter>\n+        <parameter name=\"Application\">\n+          <para>Application currently executing on the channel</para>\n+        </parameter>\n+        <parameter name=\"ApplicationData\">\n+          <para>Data given to the currently executing application</para>\n+        </parameter>\n+        <parameter name=\"Duration\">\n+          <para>The amount of time the channel has existed</para>\n+        </parameter>\n+      </syntax>\n+      <see-also>\n+        <ref type=\"manager\">CoreShowChannels</ref>\n+        <ref type=\"managerEvent\">CoreShowChannelsComplete</ref>\n+      </see-also>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <managerEvent language=\"en_US\" name=\"CoreShowChannelsComplete\">\n+    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n+      <synopsis>Raised at the end of the CoreShowChannel list produced by the CoreShowChannels command.</synopsis>\n+      <syntax>\n+        <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+        <parameter name=\"EventList\">\n+          <para>Conveys the status of the command reponse list</para>\n+        </parameter>\n+        <parameter name=\"ListItems\">\n+          <para>The total number of list items produced</para>\n+        </parameter>\n+      </syntax>\n+      <see-also>\n+        <ref type=\"manager\">CoreShowChannels</ref>\n+        <ref type=\"managerEvent\">CoreShowChannel</ref>\n+      </see-also>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <manager name=\"CoreShowChannels\" language=\"en_US\">\n+    <synopsis>List currently active channels.</synopsis>\n     <syntax>\n-      <parameter name=\"seconds\">\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+    </syntax>\n+    <description>\n+      <para>List currently defined channels and some information about them.</para>\n+    </description>\n+    <responses>\n+      <list-elements>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='CoreShowChannel'])\"/>\n+      </list-elements>\n+      <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='CoreShowChannelsComplete'])\"/>\n+    </responses>\n+  </manager>\n+  <manager name=\"LoggerRotate\" language=\"en_US\">\n+    <synopsis>Reload and rotate the Asterisk logger.</synopsis>\n+    <syntax>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+    </syntax>\n+    <description>\n+      <para>Reload and rotate the logger. Analogous to the CLI command 'logger rotate'.</para>\n+    </description>\n+  </manager>\n+  <manager name=\"ModuleLoad\" language=\"en_US\">\n+    <synopsis>Module management.</synopsis>\n+    <syntax>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      <parameter name=\"Module\">\n+        <para>Asterisk module name (including .so extension) or subsystem identifier:</para>\n+        <enumlist>\n+          <enum name=\"cdr\"/>\n+          <enum name=\"dnsmgr\"/>\n+          <enum name=\"extconfig\"/>\n+          <enum name=\"enum\"/>\n+          <enum name=\"acl\"/>\n+          <enum name=\"manager\"/>\n+          <enum name=\"http\"/>\n+          <enum name=\"logger\"/>\n+          <enum name=\"features\"/>\n+          <enum name=\"dsp\"/>\n+          <enum name=\"udptl\"/>\n+          <enum name=\"indications\"/>\n+          <enum name=\"cel\"/>\n+          <enum name=\"plc\"/>\n+        </enumlist>\n+      </parameter>\n+      <parameter name=\"LoadType\" required=\"true\">\n+        <para>The operation to be done on module. Subsystem identifiers may only\n+\t\t\t\tbe reloaded.</para>\n+        <enumlist>\n+          <enum name=\"load\"/>\n+          <enum name=\"unload\"/>\n+          <enum name=\"reload\"/>\n+        </enumlist>\n         <para>\n-          Can be passed with fractions of a second. For example,\n-          <literal>1.5</literal>\n-          will ask the\n-\t\t\t\tapplication to wait for 1.5 seconds.\n+          If no module is specified for a\n+          <literal>reload</literal>\n+          loadtype,\n+\t\t\t\tall modules are reloaded.\n         </para>\n       </parameter>\n-      <parameter name=\"options\">\n-        <optionlist>\n-          <option name=\"m\">\n-            <para>Provide music on hold to the caller while waiting for an extension.</para>\n-            <argument name=\"x\">\n-              <para>\n-                Specify the class for music on hold.\n-                <emphasis>CHANNEL(musicclass) will\n-\t\t\t\t\t\t\tbe used instead if set</emphasis>\n-              </para>\n-            </argument>\n-          </option>\n-          <option name=\"d\">\n-            <para>\n-              Play\n-              <literal>dial</literal>\n-              indications tone on channel while waiting\n-\t\t\t\t\t\tfor digits.\n-            </para>\n-          </option>\n-        </optionlist>\n-      </parameter>\n     </syntax>\n     <description>\n-      <para>\n-        This application waits for the user to enter a new extension for a specified number\n-\t\t\tof\n-        <replaceable>seconds</replaceable>\n-        .\n-      </para>\n-      <xi:include xpointer=\"xpointer(/docs/application[@name='Macro']/description/warning[2])\"/>\n+      <para>Loads, unloads or reloads an Asterisk module in a running system.</para>\n     </description>\n     <see-also>\n-      <ref type=\"application\">Background</ref>\n-      <ref type=\"function\">TIMEOUT</ref>\n+      <ref type=\"manager\">Reload</ref>\n+      <ref type=\"manager\">ModuleCheck</ref>\n     </see-also>\n-  </application>\n-  <module language=\"en_US\" name=\"features\">\n-    <support_level>core</support_level>\n-  </module>\n-  <application name=\"Bridge\" language=\"en_US\">\n-    <synopsis>Bridge two channels.</synopsis>\n+  </manager>\n+  <manager name=\"ModuleCheck\" language=\"en_US\">\n+    <synopsis>Check if module is loaded.</synopsis>\n     <syntax>\n-      <parameter name=\"channel\" required=\"true\">\n-        <para>The current channel is bridged to the channel\n-\t\t\t\tidentified by the channel name, channel name prefix, or channel\n-\t\t\t\tuniqueid.</para>\n-      </parameter>\n-      <parameter name=\"options\">\n-        <optionlist>\n-          <option name=\"p\">\n-            <para>\n-              Play a courtesy tone to\n-              <replaceable>channel</replaceable>\n-              .\n-            </para>\n-          </option>\n-          <option name=\"F\" argsep=\"^\">\n-            <argument name=\"context\" required=\"false\"/>\n-            <argument name=\"exten\" required=\"false\"/>\n-            <argument name=\"priority\" required=\"true\"/>\n-            <para>\n-              When the bridger hangs up, transfer the\n-              <emphasis>bridged</emphasis>\n-              party\n-\t\t\t\t\t\tto the specified destination and\n-              <emphasis>start</emphasis>\n-              execution at that location.\n-            </para>\n-            <note>\n-              <para>Any channel variables you want the called channel to inherit from the caller channel must be\n-\t\t\t\t\t\t\tprefixed with one or two underbars ('_').</para>\n-            </note>\n-            <note>\n-              <para>This option will override the 'x' option</para>\n-            </note>\n-          </option>\n-          <option name=\"F\">\n-            <para>\n-              When the bridger hangs up, transfer the\n-              <emphasis>bridged</emphasis>\n-              party\n-\t\t\t\t\t\tto the next priority of\tthe current extension and\n-              <emphasis>start</emphasis>\n-              execution\n-\t\t\t\t\t\tat that location.\n-            </para>\n-            <note>\n-              <para>Any channel variables you want the called channel to inherit from the caller channel must be\n-\t\t\t\t\t\t\tprefixed with one or two underbars ('_').</para>\n-            </note>\n-            <note>\n-              <para>Using this option from a Macro() or GoSub() might not make sense as there would be no return points.</para>\n-            </note>\n-            <note>\n-              <para>This option will override the 'x' option</para>\n-            </note>\n-          </option>\n-          <option name=\"h\">\n-            <para>\n-              Allow the called party to hang up by sending the\n-              <replaceable>*</replaceable>\n-              DTMF digit.\n-            </para>\n-          </option>\n-          <option name=\"H\">\n-            <para>\n-              Allow the calling party to hang up by pressing the\n-              <replaceable>*</replaceable>\n-              DTMF digit.\n-            </para>\n-          </option>\n-          <option name=\"k\">\n-            <para>\n-              Allow the called party to enable parking of the call by sending\n-\t\t\t\t\t\tthe DTMF sequence defined for call parking in\n-              <filename>features.conf</filename>\n-              .\n-            </para>\n-          </option>\n-          <option name=\"K\">\n-            <para>\n-              Allow the calling party to enable parking of the call by sending\n-\t\t\t\t\t\t the DTMF sequence defined for call parking in\n-              <filename>features.conf</filename>\n-              .\n-            </para>\n-          </option>\n-          <option name=\"L(x[:y][:z])\">\n-            <para>\n-              Limit the call to\n-              <replaceable>x</replaceable>\n-              ms. Play a warning\n-\t\t\t\t\t\twhen\n-              <replaceable>y</replaceable>\n-              ms are left. Repeat the warning every\n-              <replaceable>z</replaceable>\n-              ms. The following special variables can be\n-\t\t\t\t\t\tused with this option:\n-            </para>\n-            <variablelist>\n-              <variable name=\"LIMIT_PLAYAUDIO_CALLER\">\n-                <para>Play sounds to the caller. yes|no (default yes)</para>\n-              </variable>\n-              <variable name=\"LIMIT_PLAYAUDIO_CALLEE\">\n-                <para>Play sounds to the callee. yes|no</para>\n-              </variable>\n-              <variable name=\"LIMIT_TIMEOUT_FILE\">\n-                <para>File to play when time is up.</para>\n-              </variable>\n-              <variable name=\"LIMIT_CONNECT_FILE\">\n-                <para>File to play when call begins.</para>\n-              </variable>\n-              <variable name=\"LIMIT_WARNING_FILE\">\n-                <para>\n-                  File to play as warning if\n-                  <replaceable>y</replaceable>\n-                  is\n-\t\t\t\t\t\t\t\tdefined. The default is to say the time remaining.\n-                </para>\n-              </variable>\n-            </variablelist>\n-          </option>\n-          <option name=\"S(x)\">\n-            <para>\n-              Hang up the call after\n-              <replaceable>x</replaceable>\n-              seconds *after* the called party has answered the call.\n-            </para>\n-          </option>\n-          <option name=\"t\">\n-            <para>\n-              Allow the called party to transfer the calling party by sending the\n-\t\t\t\t\t\tDTMF sequence defined in\n-              <filename>features.conf</filename>\n-              .\n-            </para>\n-          </option>\n-          <option name=\"T\">\n-            <para>\n-              Allow the calling party to transfer the called party by sending the\n-\t\t\t\t\t\tDTMF sequence defined in\n-              <filename>features.conf</filename>\n-              .\n-            </para>\n-          </option>\n-          <option name=\"w\">\n-            <para>\n-              Allow the called party to enable recording of the call by sending\n-\t\t\t\t\t\tthe DTMF sequence defined for one-touch recording in\n-              <filename>features.conf</filename>\n-              .\n-            </para>\n-          </option>\n-          <option name=\"W\">\n-            <para>\n-              Allow the calling party to enable recording of the call by sending\n-\t\t\t\t\t\tthe DTMF sequence defined for one-touch recording in\n-              <filename>features.conf</filename>\n-              .\n-            </para>\n-          </option>\n-          <option name=\"x\">\n-            <para>Cause the called party to be hung up after the bridge, instead of being\n-\t\t\t\t\t\trestarted in the dialplan.</para>\n-          </option>\n-        </optionlist>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      <parameter name=\"Module\" required=\"true\">\n+        <para>Asterisk module name (not including extension).</para>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>Allows the ability to bridge two channels via the dialplan.</para>\n-      <para>This application sets the following channel variable upon completion:</para>\n-      <variablelist>\n-        <variable name=\"BRIDGERESULT\">\n-          <para>The result of the bridge attempt as a text string.</para>\n-          <value name=\"SUCCESS\"/>\n-          <value name=\"FAILURE\"/>\n-          <value name=\"LOOP\"/>\n-          <value name=\"NONEXISTENT\"/>\n-        </variable>\n-      </variablelist>\n+      <para>Checks if Asterisk module is loaded. Will return Success/Failure.\n+\t\t\tFor success returns, the module revision number is included.</para>\n     </description>\n     <see-also>\n-      <ref type=\"manager\">Bridge</ref>\n-      <ref type=\"managerEvent\">BridgeCreate</ref>\n-      <ref type=\"managerEvent\">BridgeEnter</ref>\n+      <ref type=\"manager\">ModuleLoad</ref>\n     </see-also>\n-  </application>\n-  <manager name=\"Bridge\" language=\"en_US\">\n-    <synopsis>Bridge two channels already in the PBX.</synopsis>\n+  </manager>\n+  <manager name=\"AOCMessage\" language=\"en_US\">\n+    <synopsis>Generate an Advice of Charge message on a channel.</synopsis>\n     <syntax>\n       <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"Channel1\" required=\"true\">\n-        <para>Channel to Bridge to Channel2.</para>\n+      <parameter name=\"Channel\" required=\"true\">\n+        <para>Channel name to generate the AOC message on.</para>\n       </parameter>\n-      <parameter name=\"Channel2\" required=\"true\">\n-        <para>Channel to Bridge to Channel1.</para>\n+      <parameter name=\"ChannelPrefix\">\n+        <para>Partial channel prefix.  By using this option one can match the beginning part\n+\t\t\t\tof a channel name without having to put the entire name in.  For example\n+\t\t\t\tif a channel name is SIP/snom-00000001 and this value is set to SIP/snom, then\n+\t\t\t\tthat channel matches and the message will be sent.  Note however that only\n+\t\t\t\tthe first matched channel has the message sent on it.</para>\n       </parameter>\n-      <parameter name=\"Tone\">\n-        <para>Play courtesy tone to Channel 2.</para>\n+      <parameter name=\"MsgType\" required=\"true\">\n+        <para>Defines what type of AOC message to create, AOC-D or AOC-E</para>\n         <enumlist>\n-          <enum name=\"no\"/>\n-          <enum name=\"Channel1\"/>\n-          <enum name=\"Channel2\"/>\n-          <enum name=\"Both\"/>\n+          <enum name=\"D\"/>\n+          <enum name=\"E\"/>\n+        </enumlist>\n+      </parameter>\n+      <parameter name=\"ChargeType\" required=\"true\">\n+        <para>Defines what kind of charge this message represents.</para>\n+        <enumlist>\n+          <enum name=\"NA\"/>\n+          <enum name=\"FREE\"/>\n+          <enum name=\"Currency\"/>\n+          <enum name=\"Unit\"/>\n+        </enumlist>\n+      </parameter>\n+      <parameter name=\"UnitAmount(0)\">\n+        <para>This represents the amount of units charged. The ETSI AOC standard specifies that\n+\t\t\t\tthis value along with the optional UnitType value are entries in a list.  To accommodate this\n+\t\t\t\tthese values take an index value starting at 0 which can be used to generate this list of\n+\t\t\t\tunit entries.  For Example, If two unit entires were required this could be achieved by setting the\n+\t\t\t\tparamter UnitAmount(0)=1234 and UnitAmount(1)=5678.  Note that UnitAmount at index 0 is\n+\t\t\t\trequired when ChargeType=Unit, all other entries in the list are optional.</para>\n+      </parameter>\n+      <parameter name=\"UnitType(0)\">\n+        <para>Defines the type of unit.  ETSI AOC standard specifies this as an integer\n+\t\t\t\tvalue between 1 and 16, but this value is left open to accept any positive\n+\t\t\t\tinteger.  Like the UnitAmount parameter, this value represents a list entry\n+\t\t\t\tand has an index parameter that starts at 0.</para>\n+      </parameter>\n+      <parameter name=\"CurrencyName\">\n+        <para>Specifies the currency's name.  Note that this value is truncated after 10 characters.</para>\n+      </parameter>\n+      <parameter name=\"CurrencyAmount\">\n+        <para>Specifies the charge unit amount as a positive integer.  This value is required\n+\t\t\t\twhen ChargeType==Currency.</para>\n+      </parameter>\n+      <parameter name=\"CurrencyMultiplier\">\n+        <para>Specifies the currency multiplier.  This value is required when ChargeType==Currency.</para>\n+        <enumlist>\n+          <enum name=\"OneThousandth\"/>\n+          <enum name=\"OneHundredth\"/>\n+          <enum name=\"OneTenth\"/>\n+          <enum name=\"One\"/>\n+          <enum name=\"Ten\"/>\n+          <enum name=\"Hundred\"/>\n+          <enum name=\"Thousand\"/>\n+        </enumlist>\n+      </parameter>\n+      <parameter name=\"TotalType\" default=\"Total\">\n+        <para>Defines what kind of AOC-D total is represented.</para>\n+        <enumlist>\n+          <enum name=\"Total\"/>\n+          <enum name=\"SubTotal\"/>\n         </enumlist>\n       </parameter>\n+      <parameter name=\"AOCBillingId\">\n+        <para>Represents a billing ID associated with an AOC-D or AOC-E message. Note\n+\t\t\t\tthat only the first 3 items of the enum are valid AOC-D billing IDs</para>\n+        <enumlist>\n+          <enum name=\"Normal\"/>\n+          <enum name=\"ReverseCharge\"/>\n+          <enum name=\"CreditCard\"/>\n+          <enum name=\"CallFwdUnconditional\"/>\n+          <enum name=\"CallFwdBusy\"/>\n+          <enum name=\"CallFwdNoReply\"/>\n+          <enum name=\"CallDeflection\"/>\n+          <enum name=\"CallTransfer\"/>\n+        </enumlist>\n+      </parameter>\n+      <parameter name=\"ChargingAssociationId\">\n+        <para>Charging association identifier.  This is optional for AOC-E and can be\n+\t\t\t\tset to any value between -32768 and 32767</para>\n+      </parameter>\n+      <parameter name=\"ChargingAssociationNumber\">\n+        <para>Represents the charging association party number.  This value is optional\n+\t\t\t\tfor AOC-E.</para>\n+      </parameter>\n+      <parameter name=\"ChargingAssociationPlan\">\n+        <para>Integer representing the charging plan associated with the ChargingAssociationNumber.\n+\t\t\t\tThe value is bits 7 through 1 of the Q.931 octet containing the type-of-number and\n+\t\t\t\tnumbering-plan-identification fields.</para>\n+      </parameter>\n     </syntax>\n     <description>\n-      <para>Bridge together two channels already in the PBX.</para>\n+      <para>Generates an AOC-D or AOC-E message on a channel.</para>\n     </description>\n     <see-also>\n-      <ref type=\"application\">Bridge</ref>\n-      <ref type=\"managerEvent\">BridgeCreate</ref>\n-      <ref type=\"managerEvent\">BridgeEnter</ref>\n-      <ref type=\"manager\">BridgeDestroy</ref>\n-      <ref type=\"manager\">BridgeInfo</ref>\n-      <ref type=\"manager\">BridgeKick</ref>\n-      <ref type=\"manager\">BridgeList</ref>\n+      <ref type=\"managerEvent\">AOC-D</ref>\n+      <ref type=\"managerEvent\">AOC-E</ref>\n     </see-also>\n   </manager>\n-  <module language=\"en_US\" name=\"bridge\">\n-    <support_level>core</support_level>\n-  </module>\n-  <manager name=\"BridgeTechnologyList\" language=\"en_US\">\n-    <synopsis>List available bridging technologies and their statuses.</synopsis>\n+  <function name=\"AMI_CLIENT\" language=\"en_US\">\n+    <synopsis>Checks attributes of manager accounts</synopsis>\n     <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      <parameter name=\"loginname\" required=\"true\">\n+        <para>Login name, specified in manager.conf</para>\n+      </parameter>\n+      <parameter name=\"field\" required=\"true\">\n+        <para>The manager account attribute to return</para>\n+        <enumlist>\n+          <enum name=\"sessions\">\n+            <para>The number of sessions for this AMI account</para>\n+          </enum>\n+        </enumlist>\n+      </parameter>\n     </syntax>\n     <description>\n-      <para>Returns detailed information about the available bridging technologies.</para>\n+      <para>Currently, the only supported  parameter is &quot;sessions&quot; which will return the current number of\n+\t\t\t\tactive sessions for this AMI account.</para>\n     </description>\n-    <see-also>\n-      <ref type=\"manager\">BridgeTechnologySuspend</ref>\n-      <ref type=\"manager\">BridgeTechnologyUnsuspend</ref>\n-    </see-also>\n-  </manager>\n-  <manager name=\"BridgeTechnologySuspend\" language=\"en_US\">\n-    <synopsis>Suspend a bridging technology.</synopsis>\n+  </function>\n+  <manager name=\"Filter\" language=\"en_US\">\n+    <synopsis>Dynamically add filters for the current manager session.</synopsis>\n     <syntax>\n       <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"BridgeTechnology\" required=\"true\">\n-        <para>The name of the bridging technology to suspend.</para>\n+      <parameter name=\"Operation\">\n+        <enumlist>\n+          <enum name=\"Add\">\n+            <para>Add a filter.</para>\n+          </enum>\n+        </enumlist>\n+      </parameter>\n+      <parameter name=\"Filter\">\n+        <para>Filters can be whitelist or blacklist</para>\n+        <para>Example whitelist filter: &quot;Event: Newchannel&quot;</para>\n+        <para>Example blacklist filter: &quot;!Channel: DAHDI.*&quot;</para>\n+        <para>This filter option is used to whitelist or blacklist events per user to be\n+\t\t\t\treported with regular expressions and are allowed if both the regex matches\n+\t\t\t\tand the user has read access as defined in manager.conf. Filters are assumed to be for whitelisting\n+\t\t\t\tunless preceeded by an exclamation point, which marks it as being black.\n+\t\t\t\tEvaluation of the filters is as follows:</para>\n+        <para>- If no filters are configured all events are reported as normal.</para>\n+        <para>- If there are white filters only: implied black all filter processed first, then white filters.</para>\n+        <para>- If there are black filters only: implied white all filter processed first, then black filters.</para>\n+        <para>- If there are both white and black filters: implied black all filter processed first, then white\n+\t\t\t\tfilters, and lastly black filters.</para>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>Marks a bridging technology as suspended, which prevents subsequently created bridges from using it.</para>\n+      <para>The filters added are only used for the current session.\n+\t\t\tOnce the connection is closed the filters are removed.</para>\n+      <para>This comand requires the system permission because\n+\t\t\tthis command can be used to create filters that may bypass\n+\t\t\tfilters defined in manager.conf</para>\n     </description>\n     <see-also>\n-      <ref type=\"manager\">BridgeTechnologySuspend</ref>\n-      <ref type=\"manager\">BridgeTechnologyUnsuspend</ref>\n+      <ref type=\"manager\">FilterList</ref>\n     </see-also>\n   </manager>\n-  <manager name=\"BridgeTechnologyUnsuspend\" language=\"en_US\">\n-    <synopsis>Unsuspend a bridging technology.</synopsis>\n+  <manager name=\"FilterList\" language=\"en_US\">\n+    <synopsis>Show current event filters for this session</synopsis>\n+    <description>\n+      <para>The filters displayed are for the current session.  Only those filters defined in\n+                        manager.conf will be present upon starting a new session.</para>\n+    </description>\n+    <see-also>\n+      <ref type=\"manager\">Filter</ref>\n+    </see-also>\n+  </manager>\n+  <manager name=\"BlindTransfer\" language=\"en_US\">\n+    <synopsis>Blind transfer channel(s) to the given destination</synopsis>\n     <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"BridgeTechnology\" required=\"true\">\n-        <para>The name of the bridging technology to unsuspend.</para>\n-      </parameter>\n+      <parameter name=\"Channel\" required=\"true\"/>\n+      <parameter name=\"Context\"/>\n+      <parameter name=\"Exten\"/>\n     </syntax>\n     <description>\n-      <para>Clears a previously suspended bridging technology, which allows subsequently created bridges to use it.</para>\n+      <para>Redirect all channels currently bridged to the specified channel to the specified destination.</para>\n     </description>\n     <see-also>\n-      <ref type=\"manager\">BridgeTechnologyList</ref>\n-      <ref type=\"manager\">BridgeTechnologySuspend</ref>\n+      <ref type=\"manager\">Redirect</ref>\n+      <ref type=\"managerEvent\">BlindTransfer</ref>\n     </see-also>\n   </manager>\n-  <module language=\"en_US\" name=\"smoother\">\n+  <managerEvent name=\"ExtensionStatus\" language=\"en_US\">\n+    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n+      <synopsis>Raised when a hint changes due to a device state change.</synopsis>\n+      <syntax>\n+        <parameter name=\"Exten\">\n+          <para>Name of the extension.</para>\n+        </parameter>\n+        <parameter name=\"Context\">\n+          <para>Context that owns the extension.</para>\n+        </parameter>\n+        <parameter name=\"Hint\">\n+          <para>Hint set for the extension</para>\n+        </parameter>\n+        <parameter name=\"Status\">\n+          <para>Numerical value of the extension status. Extension\n+\t\t\t\t\tstatus is determined by the combined device state of all items\n+\t\t\t\t\tcontained in the hint.</para>\n+          <enumlist>\n+            <enum name=\"-2\">\n+              <para>The extension was removed from the dialplan.</para>\n+            </enum>\n+            <enum name=\"-1\">\n+              <para>The extension's hint was removed from the dialplan.</para>\n+            </enum>\n+            <enum name=\"0\">\n+              <para>\n+                <literal>Idle</literal>\n+                - Related device(s) are in an idle\n+\t\t\t\t\t\t\tstate.\n+              </para>\n+            </enum>\n+            <enum name=\"1\">\n+              <para>\n+                <literal>InUse</literal>\n+                - Related device(s) are in active\n+\t\t\t\t\t\t\tcalls but may take more calls.\n+              </para>\n+            </enum>\n+            <enum name=\"2\">\n+              <para>\n+                <literal>Busy</literal>\n+                - Related device(s) are in active\n+\t\t\t\t\t\t\tcalls and may not take any more calls.\n+              </para>\n+            </enum>\n+            <enum name=\"4\">\n+              <para>\n+                <literal>Unavailable</literal>\n+                - Related device(s) are\n+\t\t\t\t\t\t\tnot reachable.\n+              </para>\n+            </enum>\n+            <enum name=\"8\">\n+              <para>\n+                <literal>Ringing</literal>\n+                - Related device(s) are\n+\t\t\t\t\t\t\tcurrently ringing.\n+              </para>\n+            </enum>\n+            <enum name=\"9\">\n+              <para>\n+                <literal>InUse&amp;Ringing</literal>\n+                - Related device(s)\n+\t\t\t\t\t\t\tare currently ringing and in active calls.\n+              </para>\n+            </enum>\n+            <enum name=\"16\">\n+              <para>\n+                <literal>Hold</literal>\n+                - Related device(s) are\n+\t\t\t\t\t\t\tcurrently on hold.\n+              </para>\n+            </enum>\n+            <enum name=\"17\">\n+              <para>\n+                <literal>InUse&amp;Hold</literal>\n+                - Related device(s)\n+\t\t\t\t\t\t\tare currently on hold and in active calls.\n+              </para>\n+            </enum>\n+          </enumlist>\n+        </parameter>\n+        <parameter name=\"StatusText\">\n+          <para>\n+            Text representation of\n+            <literal>Status</literal>\n+            .\n+          </para>\n+          <enumlist>\n+            <enum name=\"Idle\"/>\n+            <enum name=\"InUse\"/>\n+            <enum name=\"Busy\"/>\n+            <enum name=\"Unavailable\"/>\n+            <enum name=\"Ringing\"/>\n+            <enum name=\"InUse&amp;Ringing\"/>\n+            <enum name=\"Hold\"/>\n+            <enum name=\"InUse&amp;Hold\"/>\n+            <enum name=\"Unknown\">\n+              <para>Status does not match any of the above values.</para>\n+            </enum>\n+          </enumlist>\n+        </parameter>\n+      </syntax>\n+      <see-also>\n+        <ref type=\"manager\">ExtensionState</ref>\n+      </see-also>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <managerEvent name=\"PresenceStatus\" language=\"en_US\">\n+    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n+      <synopsis>Raised when a hint changes due to a presence state change.</synopsis>\n+      <syntax>\n+        <parameter name=\"Exten\"/>\n+        <parameter name=\"Context\"/>\n+        <parameter name=\"Hint\"/>\n+        <parameter name=\"Status\"/>\n+        <parameter name=\"Subtype\"/>\n+        <parameter name=\"Message\"/>\n+      </syntax>\n+      <see-also>\n+        <ref type=\"manager\">PresenceState</ref>\n+      </see-also>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <module language=\"en_US\" name=\"stun\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"sounds\">\n+  <module language=\"en_US\" name=\"strcompat\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"fskmodem\">\n+  <module language=\"en_US\" name=\"lock\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"core_unreal\">\n+  <module language=\"en_US\" name=\"fskmodem_int\">\n     <support_level>core</support_level>\n   </module>\n   <module language=\"en_US\" name=\"frame\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"astobj2_global\">\n+  <module language=\"en_US\" name=\"endpoints\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"stasis\">\n+  <module language=\"en_US\" name=\"aoc\">\n     <support_level>core</support_level>\n   </module>\n-  <managerEvent language=\"en_US\" name=\"UserEvent\">\n-    <managerEventInstance class=\"EVENT_FLAG_USER\">\n-      <synopsis>A user defined event raised from the dialplan.</synopsis>\n+  <managerEvent language=\"en_US\" name=\"AOC-S\">\n+    <managerEventInstance class=\"EVENT_FLAG_AOC\">\n+      <synopsis>Raised when an Advice of Charge message is sent at the beginning of a call.</synopsis>\n       <syntax>\n         <channel_snapshot/>\n-        <parameter name=\"UserEvent\">\n-          <para>The event name, as specified in the dialplan.</para>\n+        <parameter name=\"Chargeable\"/>\n+        <parameter name=\"RateType\">\n+          <enumlist>\n+            <enum name=\"NotAvailable\"/>\n+            <enum name=\"Free\"/>\n+            <enum name=\"FreeFromBeginning\"/>\n+            <enum name=\"Duration\"/>\n+            <enum name=\"Flag\"/>\n+            <enum name=\"Volume\"/>\n+            <enum name=\"SpecialCode\"/>\n+          </enumlist>\n+        </parameter>\n+        <parameter name=\"Currency\"/>\n+        <parameter name=\"Name\"/>\n+        <parameter name=\"Cost\"/>\n+        <parameter name=\"Multiplier\">\n+          <enumlist>\n+            <enum name=\"1/1000\"/>\n+            <enum name=\"1/100\"/>\n+            <enum name=\"1/10\"/>\n+            <enum name=\"1\"/>\n+            <enum name=\"10\"/>\n+            <enum name=\"100\"/>\n+            <enum name=\"1000\"/>\n+          </enumlist>\n+        </parameter>\n+        <parameter name=\"ChargingType\"/>\n+        <parameter name=\"StepFunction\"/>\n+        <parameter name=\"Granularity\"/>\n+        <parameter name=\"Length\"/>\n+        <parameter name=\"Scale\"/>\n+        <parameter name=\"Unit\">\n+          <enumlist>\n+            <enum name=\"Octect\"/>\n+            <enum name=\"Segment\"/>\n+            <enum name=\"Message\"/>\n+          </enumlist>\n         </parameter>\n+        <parameter name=\"SpecialCode\"/>\n       </syntax>\n-      <description>\n-        <para>Event may contain additional arbitrary parameters in addition to optional bridge and endpoint snapshots.  Multiple snapshots of the same type are prefixed with a numeric value.</para>\n-      </description>\n       <see-also>\n-        <ref type=\"application\">UserEvent</ref>\n-        <ref type=\"managerEvent\">UserEvent</ref>\n+        <ref type=\"managerEvent\">AOC-D</ref>\n+        <ref type=\"managerEvent\">AOC-E</ref>\n       </see-also>\n     </managerEventInstance>\n   </managerEvent>\n-  <configInfo name=\"stasis\" language=\"en_US\">\n-    <configFile name=\"stasis.conf\">\n-      <configObject name=\"threadpool\">\n-        <synopsis>Settings that configure the threadpool Stasis uses to deliver some messages.</synopsis>\n-        <configOption name=\"initial_size\" default=\"5\">\n-          <synopsis>Initial number of threads in the message bus threadpool.</synopsis>\n-        </configOption>\n-        <configOption name=\"idle_timeout_sec\" default=\"20\">\n-          <synopsis>Number of seconds before an idle thread is disposed of.</synopsis>\n-        </configOption>\n-        <configOption name=\"max_size\" default=\"50\">\n-          <synopsis>Maximum number of threads in the threadpool.</synopsis>\n-        </configOption>\n-      </configObject>\n-      <configObject name=\"declined_message_types\">\n-        <synopsis>Stasis message types for which to decline creation.</synopsis>\n-        <configOption name=\"decline\">\n-          <synopsis>The message type to decline.</synopsis>\n-          <description>\n-            <para>This configuration option defines the name of the Stasis\n-\t\t\t\t\t\tmessage type that Asterisk is forbidden from creating and can be\n-\t\t\t\t\t\tspecified as many times as necessary to achieve the desired result.</para>\n-            <enumlist>\n-              <enum name=\"stasis_app_recording_snapshot_type\"/>\n-              <enum name=\"stasis_app_playback_snapshot_type\"/>\n-              <enum name=\"stasis_test_message_type\"/>\n-              <enum name=\"confbridge_start_type\"/>\n-              <enum name=\"confbridge_end_type\"/>\n-              <enum name=\"confbridge_join_type\"/>\n-              <enum name=\"confbridge_leave_type\"/>\n-              <enum name=\"confbridge_start_record_type\"/>\n-              <enum name=\"confbridge_stop_record_type\"/>\n-              <enum name=\"confbridge_mute_type\"/>\n-              <enum name=\"confbridge_unmute_type\"/>\n-              <enum name=\"confbridge_talking_type\"/>\n-              <enum name=\"cel_generic_type\"/>\n-              <enum name=\"ast_bridge_snapshot_type\"/>\n-              <enum name=\"ast_bridge_merge_message_type\"/>\n-              <enum name=\"ast_channel_entered_bridge_type\"/>\n-              <enum name=\"ast_channel_left_bridge_type\"/>\n-              <enum name=\"ast_blind_transfer_type\"/>\n-              <enum name=\"ast_attended_transfer_type\"/>\n-              <enum name=\"ast_endpoint_snapshot_type\"/>\n-              <enum name=\"ast_endpoint_state_type\"/>\n-              <enum name=\"ast_device_state_message_type\"/>\n-              <enum name=\"ast_test_suite_message_type\"/>\n-              <enum name=\"ast_mwi_state_type\"/>\n-              <enum name=\"ast_mwi_vm_app_type\"/>\n-              <enum name=\"ast_format_register_type\"/>\n-              <enum name=\"ast_format_unregister_type\"/>\n-              <enum name=\"ast_manager_get_generic_type\"/>\n-              <enum name=\"ast_parked_call_type\"/>\n-              <enum name=\"ast_channel_snapshot_type\"/>\n-              <enum name=\"ast_channel_dial_type\"/>\n-              <enum name=\"ast_channel_varset_type\"/>\n-              <enum name=\"ast_channel_hangup_request_type\"/>\n-              <enum name=\"ast_channel_dtmf_begin_type\"/>\n-              <enum name=\"ast_channel_dtmf_end_type\"/>\n-              <enum name=\"ast_channel_flash_type\"/>\n-              <enum name=\"ast_channel_wink_type\"/>\n-              <enum name=\"ast_channel_hold_type\"/>\n-              <enum name=\"ast_channel_unhold_type\"/>\n-              <enum name=\"ast_channel_chanspy_start_type\"/>\n-              <enum name=\"ast_channel_chanspy_stop_type\"/>\n-              <enum name=\"ast_channel_fax_type\"/>\n-              <enum name=\"ast_channel_hangup_handler_type\"/>\n-              <enum name=\"ast_channel_moh_start_type\"/>\n-              <enum name=\"ast_channel_moh_stop_type\"/>\n-              <enum name=\"ast_channel_monitor_start_type\"/>\n-              <enum name=\"ast_channel_monitor_stop_type\"/>\n-              <enum name=\"ast_channel_mixmonitor_start_type\"/>\n-              <enum name=\"ast_channel_mixmonitor_stop_type\"/>\n-              <enum name=\"ast_channel_mixmonitor_mute_type\"/>\n-              <enum name=\"ast_channel_agent_login_type\"/>\n-              <enum name=\"ast_channel_agent_logoff_type\"/>\n-              <enum name=\"ast_channel_talking_start\"/>\n-              <enum name=\"ast_channel_talking_stop\"/>\n-              <enum name=\"ast_security_event_type\"/>\n-              <enum name=\"ast_named_acl_change_type\"/>\n-              <enum name=\"ast_local_bridge_type\"/>\n-              <enum name=\"ast_local_optimization_begin_type\"/>\n-              <enum name=\"ast_local_optimization_end_type\"/>\n-              <enum name=\"stasis_subscription_change_type\"/>\n-              <enum name=\"ast_multi_user_event_type\"/>\n-              <enum name=\"stasis_cache_clear_type\"/>\n-              <enum name=\"stasis_cache_update_type\"/>\n-              <enum name=\"ast_network_change_type\"/>\n-              <enum name=\"ast_system_registry_type\"/>\n-              <enum name=\"ast_cc_available_type\"/>\n-              <enum name=\"ast_cc_offertimerstart_type\"/>\n-              <enum name=\"ast_cc_requested_type\"/>\n-              <enum name=\"ast_cc_requestacknowledged_type\"/>\n-              <enum name=\"ast_cc_callerstopmonitoring_type\"/>\n-              <enum name=\"ast_cc_callerstartmonitoring_type\"/>\n-              <enum name=\"ast_cc_callerrecalling_type\"/>\n-              <enum name=\"ast_cc_recallcomplete_type\"/>\n-              <enum name=\"ast_cc_failure_type\"/>\n-              <enum name=\"ast_cc_monitorfailed_type\"/>\n-              <enum name=\"ast_presence_state_message_type\"/>\n-              <enum name=\"ast_rtp_rtcp_sent_type\"/>\n-              <enum name=\"ast_rtp_rtcp_received_type\"/>\n-              <enum name=\"ast_call_pickup_type\"/>\n-              <enum name=\"aoc_s_type\"/>\n-              <enum name=\"aoc_d_type\"/>\n-              <enum name=\"aoc_e_type\"/>\n-              <enum name=\"dahdichannel_type\"/>\n-              <enum name=\"mcid_type\"/>\n-              <enum name=\"session_timeout_type\"/>\n-              <enum name=\"cdr_read_message_type\"/>\n-              <enum name=\"cdr_write_message_type\"/>\n-              <enum name=\"cdr_prop_write_message_type\"/>\n-              <enum name=\"corosync_ping_message_type\"/>\n-              <enum name=\"agi_exec_start_type\"/>\n-              <enum name=\"agi_exec_end_type\"/>\n-              <enum name=\"agi_async_start_type\"/>\n-              <enum name=\"agi_async_exec_type\"/>\n-              <enum name=\"agi_async_end_type\"/>\n-              <enum name=\"queue_caller_join_type\"/>\n-              <enum name=\"queue_caller_leave_type\"/>\n-              <enum name=\"queue_caller_abandon_type\"/>\n-              <enum name=\"queue_member_status_type\"/>\n-              <enum name=\"queue_member_added_type\"/>\n-              <enum name=\"queue_member_removed_type\"/>\n-              <enum name=\"queue_member_pause_type\"/>\n-              <enum name=\"queue_member_penalty_type\"/>\n-              <enum name=\"queue_member_ringinuse_type\"/>\n-              <enum name=\"queue_agent_called_type\"/>\n-              <enum name=\"queue_agent_connect_type\"/>\n-              <enum name=\"queue_agent_complete_type\"/>\n-              <enum name=\"queue_agent_dump_type\"/>\n-              <enum name=\"queue_agent_ringnoanswer_type\"/>\n-              <enum name=\"meetme_join_type\"/>\n-              <enum name=\"meetme_leave_type\"/>\n-              <enum name=\"meetme_end_type\"/>\n-              <enum name=\"meetme_mute_type\"/>\n-              <enum name=\"meetme_talking_type\"/>\n-              <enum name=\"meetme_talk_request_type\"/>\n-              <enum name=\"appcdr_message_type\"/>\n-              <enum name=\"forkcdr_message_type\"/>\n-              <enum name=\"cdr_sync_message_type\"/>\n-            </enumlist>\n-          </description>\n-        </configOption>\n-      </configObject>\n-    </configFile>\n-  </configInfo>\n-  <module language=\"en_US\" name=\"pbx_timing\">\n+  <managerEvent language=\"en_US\" name=\"AOC-D\">\n+    <managerEventInstance class=\"EVENT_FLAG_AOC\">\n+      <synopsis>Raised when an Advice of Charge message is sent during a call.</synopsis>\n+      <syntax>\n+        <channel_snapshot/>\n+        <parameter name=\"Charge\"/>\n+        <parameter name=\"Type\">\n+          <enumlist>\n+            <enum name=\"NotAvailable\"/>\n+            <enum name=\"Free\"/>\n+            <enum name=\"Currency\"/>\n+            <enum name=\"Units\"/>\n+          </enumlist>\n+        </parameter>\n+        <parameter name=\"BillingID\">\n+          <enumlist>\n+            <enum name=\"Normal\"/>\n+            <enum name=\"Reverse\"/>\n+            <enum name=\"CreditCard\"/>\n+            <enum name=\"CallForwardingUnconditional\"/>\n+            <enum name=\"CallForwardingBusy\"/>\n+            <enum name=\"CallForwardingNoReply\"/>\n+            <enum name=\"CallDeflection\"/>\n+            <enum name=\"CallTransfer\"/>\n+            <enum name=\"NotAvailable\"/>\n+          </enumlist>\n+        </parameter>\n+        <parameter name=\"TotalType\">\n+          <enumlist>\n+            <enum name=\"SubTotal\"/>\n+            <enum name=\"Total\"/>\n+          </enumlist>\n+        </parameter>\n+        <parameter name=\"Currency\"/>\n+        <parameter name=\"Name\"/>\n+        <parameter name=\"Cost\"/>\n+        <parameter name=\"Multiplier\">\n+          <enumlist>\n+            <enum name=\"1/1000\"/>\n+            <enum name=\"1/100\"/>\n+            <enum name=\"1/10\"/>\n+            <enum name=\"1\"/>\n+            <enum name=\"10\"/>\n+            <enum name=\"100\"/>\n+            <enum name=\"1000\"/>\n+          </enumlist>\n+        </parameter>\n+        <parameter name=\"Units\"/>\n+        <parameter name=\"NumberOf\"/>\n+        <parameter name=\"TypeOf\"/>\n+      </syntax>\n+      <see-also>\n+        <ref type=\"manager\">AOCMessage</ref>\n+        <ref type=\"managerEvent\">AOC-S</ref>\n+        <ref type=\"managerEvent\">AOC-E</ref>\n+      </see-also>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <managerEvent language=\"en_US\" name=\"AOC-E\">\n+    <managerEventInstance class=\"EVENT_FLAG_AOC\">\n+      <synopsis>Raised when an Advice of Charge message is sent at the end of a call.</synopsis>\n+      <syntax>\n+        <channel_snapshot/>\n+        <parameter name=\"ChargingAssociation\"/>\n+        <parameter name=\"Number\"/>\n+        <parameter name=\"Plan\"/>\n+        <parameter name=\"ID\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='AOC-D']/managerEventInstance/syntax/parameter)\"/>\n+      </syntax>\n+      <see-also>\n+        <ref type=\"manager\">AOCMessage</ref>\n+        <ref type=\"managerEvent\">AOC-S</ref>\n+        <ref type=\"managerEvent\">AOC-D</ref>\n+      </see-also>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <module language=\"en_US\" name=\"slinfactory\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"image\">\n+  <module language=\"en_US\" name=\"config\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"media_index\">\n+  <module language=\"en_US\" name=\"say\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"config_options\">\n+  <module language=\"en_US\" name=\"privacy\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"libasteriskpj\">\n+  <module language=\"en_US\" name=\"devicestate\">\n     <support_level>core</support_level>\n   </module>\n+  <managerEvent language=\"en_US\" name=\"DeviceStateChange\">\n+    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n+      <synopsis>Raised when a device state changes</synopsis>\n+      <syntax>\n+        <parameter name=\"Device\">\n+          <para>The device whose state has changed</para>\n+        </parameter>\n+        <parameter name=\"State\">\n+          <para>The new state of the device</para>\n+        </parameter>\n+      </syntax>\n+      <description>\n+        <para>\n+          This differs from the\n+          <literal>ExtensionStatus</literal>\n+          event because this event is raised for all device state changes,\n+\t\t\t\tnot only for changes that affect dialplan hints.\n+        </para>\n+      </description>\n+      <see-also>\n+        <ref type=\"managerEvent\">ExtensionStatus</ref>\n+      </see-also>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <managerEvent language=\"en_US\" name=\"Newchannel\">\n+    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n+      <synopsis>Raised when a new channel is created.</synopsis>\n+      <syntax>\n+        <channel_snapshot/>\n+      </syntax>\n+      <see-also>\n+        <ref type=\"managerEvent\">Newstate</ref>\n+        <ref type=\"managerEvent\">Hangup</ref>\n+      </see-also>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <managerEvent language=\"en_US\" name=\"Newstate\">\n+    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n+      <synopsis>Raised when a channel's state changes.</synopsis>\n+      <syntax>\n+        <channel_snapshot/>\n+      </syntax>\n+      <see-also>\n+        <ref type=\"managerEvent\">Newchannel</ref>\n+        <ref type=\"managerEvent\">Hangup</ref>\n+      </see-also>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <managerEvent language=\"en_US\" name=\"Hangup\">\n+    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n+      <synopsis>Raised when a channel is hung up.</synopsis>\n+      <syntax>\n+        <channel_snapshot/>\n+        <parameter name=\"Cause\">\n+          <para>A numeric cause code for why the channel was hung up.</para>\n+        </parameter>\n+        <parameter name=\"Cause-txt\">\n+          <para>A description of why the channel was hung up.</para>\n+        </parameter>\n+      </syntax>\n+      <see-also>\n+        <ref type=\"managerEvent\">Newchannel</ref>\n+        <ref type=\"managerEvent\">SoftHangupRequest</ref>\n+        <ref type=\"managerEvent\">HangupRequest</ref>\n+        <ref type=\"managerEvent\">Newstate</ref>\n+      </see-also>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <managerEvent language=\"en_US\" name=\"HangupRequest\">\n+    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n+      <synopsis>Raised when a hangup is requested.</synopsis>\n+      <syntax>\n+        <channel_snapshot/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='Hangup']/managerEventInstance/syntax/parameter[@name='Cause'])\"/>\n+      </syntax>\n+      <see-also>\n+        <ref type=\"managerEvent\">SoftHangupRequest</ref>\n+        <ref type=\"managerEvent\">Hangup</ref>\n+      </see-also>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <managerEvent language=\"en_US\" name=\"SoftHangupRequest\">\n+    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n+      <synopsis>Raised when a soft hangup is requested with a specific cause code.</synopsis>\n+      <syntax>\n+        <channel_snapshot/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='Hangup']/managerEventInstance/syntax/parameter[@name='Cause'])\"/>\n+      </syntax>\n+      <see-also>\n+        <ref type=\"managerEvent\">HangupRequest</ref>\n+        <ref type=\"managerEvent\">Hangup</ref>\n+      </see-also>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <managerEvent language=\"en_US\" name=\"NewExten\">\n+    <managerEventInstance class=\"EVENT_FLAG_DIALPLAN\">\n+      <synopsis>Raised when a channel enters a new context, extension, priority.</synopsis>\n+      <syntax>\n+        <channel_snapshot/>\n+        <parameter name=\"Extension\">\n+          <para>Deprecated in 12, but kept for\n+\t\t\t\t\tbackward compatability. Please use\n+\t\t\t\t\t'Exten' instead.</para>\n+        </parameter>\n+        <parameter name=\"Application\">\n+          <para>The application about to be executed.</para>\n+        </parameter>\n+        <parameter name=\"AppData\">\n+          <para>The data to be passed to the application.</para>\n+        </parameter>\n+      </syntax>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <managerEvent language=\"en_US\" name=\"NewCallerid\">\n+    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n+      <synopsis>Raised when a channel receives new Caller ID information.</synopsis>\n+      <syntax>\n+        <channel_snapshot/>\n+        <parameter name=\"CID-CallingPres\">\n+          <para>A description of the Caller ID presentation.</para>\n+        </parameter>\n+      </syntax>\n+      <see-also>\n+        <ref type=\"function\">CALLERID</ref>\n+      </see-also>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <managerEvent language=\"en_US\" name=\"NewConnectedLine\">\n+    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n+      <synopsis>Raised when a channel's connected line information is changed.</synopsis>\n+      <syntax>\n+        <channel_snapshot/>\n+      </syntax>\n+      <see-also>\n+        <ref type=\"function\">CONNECTEDLINE</ref>\n+      </see-also>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <managerEvent language=\"en_US\" name=\"NewAccountCode\">\n+    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n+      <synopsis>Raised when a Channel's AccountCode is changed.</synopsis>\n+      <syntax>\n+        <channel_snapshot/>\n+        <parameter name=\"OldAccountCode\">\n+          <para>The channel's previous account code</para>\n+        </parameter>\n+      </syntax>\n+      <see-also>\n+        <ref type=\"function\">CHANNEL</ref>\n+      </see-also>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <managerEvent language=\"en_US\" name=\"DialBegin\">\n+    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n+      <synopsis>Raised when a dial action has started.</synopsis>\n+      <syntax>\n+        <channel_snapshot/>\n+        <channel_snapshot prefix=\"Dest\"/>\n+        <parameter name=\"DialString\">\n+          <para>The non-technology specific device being dialed.</para>\n+        </parameter>\n+      </syntax>\n+      <see-also>\n+        <ref type=\"application\">Dial</ref>\n+        <ref type=\"application\">Originate</ref>\n+        <ref type=\"manager\">Originate</ref>\n+        <ref type=\"managerEvent\">DialEnd</ref>\n+      </see-also>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <managerEvent language=\"en_US\" name=\"DialState\">\n+    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n+      <synopsis>Raised when dial status has changed.</synopsis>\n+      <syntax>\n+        <channel_snapshot/>\n+        <channel_snapshot prefix=\"Dest\"/>\n+        <parameter name=\"DialStatus\">\n+          <para>The new state of the outbound dial attempt.</para>\n+          <enumlist>\n+            <enum name=\"RINGING\">\n+              <para>The outbound channel is ringing.</para>\n+            </enum>\n+            <enum name=\"PROCEEDING\">\n+              <para>The call to the outbound channel is proceeding.</para>\n+            </enum>\n+            <enum name=\"PROGRESS\">\n+              <para>Progress has been received on the outbound channel.</para>\n+            </enum>\n+          </enumlist>\n+        </parameter>\n+        <parameter name=\"Forward\" required=\"false\">\n+          <para>If the call was forwarded, where the call was\n+\t\t\t\t\tforwarded to.</para>\n+        </parameter>\n+      </syntax>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <managerEvent language=\"en_US\" name=\"DialEnd\">\n+    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n+      <synopsis>Raised when a dial action has completed.</synopsis>\n+      <syntax>\n+        <channel_snapshot/>\n+        <channel_snapshot prefix=\"Dest\"/>\n+        <parameter name=\"DialStatus\">\n+          <para>The result of the dial operation.</para>\n+          <enumlist>\n+            <enum name=\"ABORT\">\n+              <para>The call was aborted.</para>\n+            </enum>\n+            <enum name=\"ANSWER\">\n+              <para>The caller answered.</para>\n+            </enum>\n+            <enum name=\"BUSY\">\n+              <para>The caller was busy.</para>\n+            </enum>\n+            <enum name=\"CANCEL\">\n+              <para>The caller cancelled the call.</para>\n+            </enum>\n+            <enum name=\"CHANUNAVAIL\">\n+              <para>The requested channel is unavailable.</para>\n+            </enum>\n+            <enum name=\"CONGESTION\">\n+              <para>The called party is congested.</para>\n+            </enum>\n+            <enum name=\"CONTINUE\">\n+              <para>The dial completed, but the caller elected\n+\t\t\t\t\t\t\tto continue in the dialplan.</para>\n+            </enum>\n+            <enum name=\"GOTO\">\n+              <para>The dial completed, but the caller jumped to\n+\t\t\t\t\t\t\ta dialplan location.</para>\n+              <para>If known, the location the caller is jumping\n+\t\t\t\t\t\t\tto will be appended to the result following a\n+\t\t\t\t\t\t\t&quot;:&quot;.</para>\n+            </enum>\n+            <enum name=\"NOANSWER\">\n+              <para>The called party failed to answer.</para>\n+            </enum>\n+          </enumlist>\n+        </parameter>\n+        <parameter name=\"Forward\" required=\"false\">\n+          <para>If the call was forwarded, where the call was\n+\t\t\t\t\tforwarded to.</para>\n+        </parameter>\n+      </syntax>\n+      <see-also>\n+        <ref type=\"application\">Dial</ref>\n+        <ref type=\"application\">Originate</ref>\n+        <ref type=\"manager\">Originate</ref>\n+        <ref type=\"managerEvent\">DialBegin</ref>\n+      </see-also>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <managerEvent language=\"en_US\" name=\"Hold\">\n+    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n+      <synopsis>Raised when a channel goes on hold.</synopsis>\n+      <syntax>\n+        <channel_snapshot/>\n+        <parameter name=\"MusicClass\">\n+          <para>The suggested MusicClass, if provided.</para>\n+        </parameter>\n+      </syntax>\n+      <see-also>\n+        <ref type=\"managerEvent\">Unhold</ref>\n+      </see-also>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <managerEvent language=\"en_US\" name=\"Unhold\">\n+    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n+      <synopsis>Raised when a channel goes off hold.</synopsis>\n+      <syntax>\n+        <channel_snapshot/>\n+      </syntax>\n+      <see-also>\n+        <ref type=\"managerEvent\">Hold</ref>\n+      </see-also>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <managerEvent language=\"en_US\" name=\"ChanSpyStart\">\n+    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n+      <synopsis>Raised when one channel begins spying on another channel.</synopsis>\n+      <syntax>\n+        <channel_snapshot prefix=\"Spyer\"/>\n+        <channel_snapshot prefix=\"Spyee\"/>\n+      </syntax>\n+      <see-also>\n+        <ref type=\"managerEvent\">ChanSpyStop</ref>\n+        <ref type=\"application\">ChanSpy</ref>\n+      </see-also>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <managerEvent language=\"en_US\" name=\"ChanSpyStop\">\n+    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n+      <synopsis>Raised when a channel has stopped spying.</synopsis>\n+      <syntax>\n+        <channel_snapshot prefix=\"Spyer\"/>\n+        <channel_snapshot prefix=\"Spyee\"/>\n+      </syntax>\n+      <see-also>\n+        <ref type=\"managerEvent\">ChanSpyStart</ref>\n+        <ref type=\"application\">ChanSpy</ref>\n+      </see-also>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <managerEvent language=\"en_US\" name=\"HangupHandlerRun\">\n+    <managerEventInstance class=\"EVENT_FLAG_DIALPLAN\">\n+      <synopsis>Raised when a hangup handler is about to be called.</synopsis>\n+      <syntax>\n+        <channel_snapshot/>\n+        <parameter name=\"Handler\">\n+          <para>Hangup handler parameter string passed to the Gosub application.</para>\n+        </parameter>\n+      </syntax>\n+      <see-also>\n+        <ref type=\"function\">CHANNEL</ref>\n+      </see-also>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <managerEvent language=\"en_US\" name=\"HangupHandlerPop\">\n+    <managerEventInstance class=\"EVENT_FLAG_DIALPLAN\">\n+      <synopsis>Raised when a hangup handler is removed from the handler stack\n+\t\t\t\tby the CHANNEL() function.</synopsis>\n+      <syntax>\n+        <channel_snapshot/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='HangupHandlerRun']/managerEventInstance/syntax/parameter)\"/>\n+      </syntax>\n+      <see-also>\n+        <ref type=\"managerEvent\">HangupHandlerPush</ref>\n+        <ref type=\"function\">CHANNEL</ref>\n+      </see-also>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <managerEvent language=\"en_US\" name=\"HangupHandlerPush\">\n+    <managerEventInstance class=\"EVENT_FLAG_DIALPLAN\">\n+      <synopsis>Raised when a hangup handler is added to the handler stack by\n+\t\t\t\tthe CHANNEL() function.</synopsis>\n+      <syntax>\n+        <channel_snapshot/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='HangupHandlerRun']/managerEventInstance/syntax/parameter)\"/>\n+      </syntax>\n+      <see-also>\n+        <ref type=\"managerEvent\">HangupHandlerPop</ref>\n+        <ref type=\"function\">CHANNEL</ref>\n+      </see-also>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <managerEvent language=\"en_US\" name=\"FAXStatus\">\n+    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n+      <synopsis>Raised periodically during a fax transmission.</synopsis>\n+      <syntax>\n+        <channel_snapshot/>\n+        <parameter name=\"Operation\">\n+          <enumlist>\n+            <enum name=\"gateway\"/>\n+            <enum name=\"receive\"/>\n+            <enum name=\"send\"/>\n+          </enumlist>\n+        </parameter>\n+        <parameter name=\"Status\">\n+          <para>A text message describing the current status of the fax</para>\n+        </parameter>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='ReceiveFAX']/managerEventInstance/syntax/parameter[@name='LocalStationID'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='ReceiveFAX']/managerEventInstance/syntax/parameter[@name='FileName'])\"/>\n+      </syntax>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <managerEvent language=\"en_US\" name=\"ReceiveFAX\">\n+    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n+      <synopsis>Raised when a receive fax operation has completed.</synopsis>\n+      <syntax>\n+        <channel_snapshot/>\n+        <parameter name=\"LocalStationID\">\n+          <para>\n+            The value of the\n+            <variable>LOCALSTATIONID</variable>\n+            channel variable\n+          </para>\n+        </parameter>\n+        <parameter name=\"RemoteStationID\">\n+          <para>\n+            The value of the\n+            <variable>REMOTESTATIONID</variable>\n+            channel variable\n+          </para>\n+        </parameter>\n+        <parameter name=\"PagesTransferred\">\n+          <para>The number of pages that have been transferred</para>\n+        </parameter>\n+        <parameter name=\"Resolution\">\n+          <para>The negotiated resolution</para>\n+        </parameter>\n+        <parameter name=\"TransferRate\">\n+          <para>The negotiated transfer rate</para>\n+        </parameter>\n+        <parameter name=\"FileName\" multiple=\"yes\">\n+          <para>The files being affected by the fax operation</para>\n+        </parameter>\n+      </syntax>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <managerEvent language=\"en_US\" name=\"SendFAX\">\n+    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n+      <synopsis>Raised when a send fax operation has completed.</synopsis>\n+      <syntax>\n+        <channel_snapshot/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='ReceiveFAX']/managerEventInstance/syntax/parameter)\"/>\n+      </syntax>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <managerEvent language=\"en_US\" name=\"MusicOnHoldStart\">\n+    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n+      <synopsis>Raised when music on hold has started on a channel.</synopsis>\n+      <syntax>\n+        <channel_snapshot/>\n+        <parameter name=\"Class\">\n+          <para>The class of music being played on the channel</para>\n+        </parameter>\n+      </syntax>\n+      <see-also>\n+        <ref type=\"managerEvent\">MusicOnHoldStop</ref>\n+        <ref type=\"application\">StartMusicOnHold</ref>\n+        <ref type=\"application\">MusicOnHold</ref>\n+      </see-also>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <managerEvent language=\"en_US\" name=\"MusicOnHoldStop\">\n+    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n+      <synopsis>Raised when music on hold has stopped on a channel.</synopsis>\n+      <syntax>\n+        <channel_snapshot/>\n+      </syntax>\n+      <see-also>\n+        <ref type=\"managerEvent\">MusicOnHoldStart</ref>\n+        <ref type=\"application\">StopMusicOnHold</ref>\n+      </see-also>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <managerEvent language=\"en_US\" name=\"MonitorStart\">\n+    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n+      <synopsis>Raised when monitoring has started on a channel.</synopsis>\n+      <syntax>\n+        <channel_snapshot/>\n+      </syntax>\n+      <see-also>\n+        <ref type=\"managerEvent\">MonitorStop</ref>\n+        <ref type=\"application\">Monitor</ref>\n+        <ref type=\"manager\">Monitor</ref>\n+      </see-also>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <managerEvent language=\"en_US\" name=\"MonitorStop\">\n+    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n+      <synopsis>Raised when monitoring has stopped on a channel.</synopsis>\n+      <syntax>\n+        <channel_snapshot/>\n+      </syntax>\n+      <see-also>\n+        <ref type=\"managerEvent\">MonitorStart</ref>\n+        <ref type=\"application\">StopMonitor</ref>\n+        <ref type=\"manager\">StopMonitor</ref>\n+      </see-also>\n+    </managerEventInstance>\n+  </managerEvent>\n   <module language=\"en_US\" name=\"ccss\">\n     <support_level>core</support_level>\n   </module>\n   <application name=\"CallCompletionRequest\" language=\"en_US\">\n     <synopsis>Request call completion service for previous call</synopsis>\n     <syntax/>\n     <description>\n@@ -22239,93 +23854,304 @@\n           <value name=\"NO_CORE_INSTANCE\"/>\n           <value name=\"NOT_GENERIC\"/>\n           <value name=\"UNSPECIFIED\"/>\n         </variable>\n       </variablelist>\n     </description>\n   </application>\n-  <module language=\"en_US\" name=\"autochan\">\n+  <module language=\"en_US\" name=\"pbx_variables\">\n+    <support_level>core</support_level>\n+  </module>\n+  <application name=\"Set\" language=\"en_US\">\n+    <synopsis>Set channel variable or function value.</synopsis>\n+    <syntax argsep=\"=\">\n+      <parameter name=\"name\" required=\"true\"/>\n+      <parameter name=\"value\" required=\"true\"/>\n+    </syntax>\n+    <description>\n+      <para>\n+        This function can be used to set the value of channel variables or dialplan functions.\n+\t\t\tWhen setting variables, if the variable name is prefixed with\n+        <literal>_</literal>\n+        ,\n+\t\t\tthe variable will be inherited into channels created from the current channel.\n+\t\t\tIf the variable name is prefixed with\n+        <literal>__</literal>\n+        , the variable will be\n+\t\t\tinherited into channels created from the current channel and all children channels.\n+      </para>\n+      <note>\n+        <para>\n+          If (and only if), in\n+          <filename>/etc/asterisk/asterisk.conf</filename>\n+          , you have\n+\t\t\ta\n+          <literal>[compat]</literal>\n+          category, and you have\n+          <literal>app_set = 1.4</literal>\n+          under that, then\n+\t\t\tthe behavior of this app changes, and strips surrounding quotes from the right hand side as\n+\t\t\tit did previously in 1.4.\n+\t\t\tThe advantages of not stripping out quoting, and not caring about the separator characters (comma and vertical bar)\n+\t\t\twere sufficient to make these changes in 1.6. Confusion about how many backslashes would be needed to properly\n+\t\t\tprotect separators and quotes in various database access strings has been greatly\n+\t\t\treduced by these changes.\n+        </para>\n+      </note>\n+    </description>\n+    <see-also>\n+      <ref type=\"application\">MSet</ref>\n+      <ref type=\"function\">GLOBAL</ref>\n+      <ref type=\"function\">SET</ref>\n+      <ref type=\"function\">ENV</ref>\n+    </see-also>\n+  </application>\n+  <application name=\"MSet\" language=\"en_US\">\n+    <synopsis>Set channel variable(s) or function value(s).</synopsis>\n+    <syntax>\n+      <parameter name=\"set1\" required=\"true\" argsep=\"=\">\n+        <argument name=\"name1\" required=\"true\"/>\n+        <argument name=\"value1\" required=\"true\"/>\n+      </parameter>\n+      <parameter name=\"set2\" multiple=\"true\" argsep=\"=\">\n+        <argument name=\"name2\" required=\"true\"/>\n+        <argument name=\"value2\" required=\"true\"/>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>\n+        This function can be used to set the value of channel variables or dialplan functions.\n+\t\t\tWhen setting variables, if the variable name is prefixed with\n+        <literal>_</literal>\n+        ,\n+\t\t\tthe variable will be inherited into channels created from the current channel\n+\t\t\tIf the variable name is prefixed with\n+        <literal>__</literal>\n+        , the variable will be\n+\t\t\tinherited into channels created from the current channel and all children channels.\n+\t\t\tMSet behaves in a similar fashion to the way Set worked in 1.2/1.4 and is thus\n+\t\t\tprone to doing things that you may not expect. For example, it strips surrounding\n+\t\t\tdouble-quotes from the right-hand side (value). If you need to put a separator\n+\t\t\tcharacter (comma or vert-bar), you will need to escape them by inserting a backslash\n+\t\t\tbefore them. Avoid its use if possible.\n+      </para>\n+      <para>This application allows up to 99 variables to be set at once.</para>\n+    </description>\n+    <see-also>\n+      <ref type=\"application\">Set</ref>\n+    </see-also>\n+  </application>\n+  <module language=\"en_US\" name=\"data_buffer\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"callerid\">\n+  <module language=\"en_US\" name=\"backtrace\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"framehook\">\n+  <module language=\"en_US\" name=\"hashtab\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"netsock2\">\n+  <module language=\"en_US\" name=\"utils\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"enum\">\n+  <module language=\"en_US\" name=\"db\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"pbx_hangup_handler\">\n+  <manager name=\"DBGet\" language=\"en_US\">\n+    <synopsis>Get DB Entry.</synopsis>\n+    <syntax>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      <parameter name=\"Family\" required=\"true\"/>\n+      <parameter name=\"Key\" required=\"true\"/>\n+    </syntax>\n+    <description/>\n+  </manager>\n+  <manager name=\"DBGetTree\" language=\"en_US\">\n+    <synopsis>Get DB entries, optionally at a particular family/key</synopsis>\n+    <syntax>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      <parameter name=\"Family\" required=\"false\"/>\n+      <parameter name=\"Key\" required=\"false\"/>\n+    </syntax>\n+    <description/>\n+  </manager>\n+  <manager name=\"DBPut\" language=\"en_US\">\n+    <synopsis>Put DB entry.</synopsis>\n+    <syntax>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      <parameter name=\"Family\" required=\"true\"/>\n+      <parameter name=\"Key\" required=\"true\"/>\n+      <parameter name=\"Val\"/>\n+    </syntax>\n+    <description/>\n+  </manager>\n+  <manager name=\"DBDel\" language=\"en_US\">\n+    <synopsis>Delete DB entry.</synopsis>\n+    <syntax>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      <parameter name=\"Family\" required=\"true\"/>\n+      <parameter name=\"Key\" required=\"true\"/>\n+    </syntax>\n+    <description/>\n+  </manager>\n+  <manager name=\"DBDelTree\" language=\"en_US\">\n+    <synopsis>Delete DB Tree.</synopsis>\n+    <syntax>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      <parameter name=\"Family\" required=\"true\"/>\n+      <parameter name=\"Key\"/>\n+    </syntax>\n+    <description/>\n+  </manager>\n+  <module language=\"en_US\" name=\"crypt\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"alaw\">\n+  <module language=\"en_US\" name=\"pbx\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"astobj2\">\n+  <function name=\"EXCEPTION\" language=\"en_US\">\n+    <synopsis>Retrieve the details of the current dialplan exception.</synopsis>\n+    <syntax>\n+      <parameter name=\"field\" required=\"true\">\n+        <para>The following fields are available for retrieval:</para>\n+        <enumlist>\n+          <enum name=\"reason\">\n+            <para>INVALID, ERROR, RESPONSETIMEOUT, ABSOLUTETIMEOUT, or custom\n+\t\t\t\t\t\tvalue set by the RaiseException() application</para>\n+          </enum>\n+          <enum name=\"context\">\n+            <para>The context executing when the exception occurred.</para>\n+          </enum>\n+          <enum name=\"exten\">\n+            <para>The extension executing when the exception occurred.</para>\n+          </enum>\n+          <enum name=\"priority\">\n+            <para>The numeric priority executing when the exception occurred.</para>\n+          </enum>\n+        </enumlist>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>\n+        Retrieve the details (specified\n+        <replaceable>field</replaceable>\n+        ) of the current dialplan exception.\n+      </para>\n+    </description>\n+    <see-also>\n+      <ref type=\"application\">RaiseException</ref>\n+    </see-also>\n+  </function>\n+  <function name=\"TESTTIME\" language=\"en_US\">\n+    <synopsis>Sets a time to be used with the channel to test logical conditions.</synopsis>\n+    <syntax>\n+      <parameter name=\"date\" required=\"true\" argsep=\" \">\n+        <para>Date in ISO 8601 format</para>\n+      </parameter>\n+      <parameter name=\"time\" required=\"true\" argsep=\" \">\n+        <para>Time in HH:MM:SS format (24-hour time)</para>\n+      </parameter>\n+      <parameter name=\"zone\" required=\"false\">\n+        <para>Timezone name</para>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>To test dialplan timing conditions at times other than the current time, use\n+\t\t\tthis function to set an alternate date and time.  For example, you may wish to evaluate\n+\t\t\twhether a location will correctly identify to callers that the area is closed on Christmas\n+\t\t\tDay, when Christmas would otherwise fall on a day when the office is normally open.</para>\n+    </description>\n+    <see-also>\n+      <ref type=\"application\">GotoIfTime</ref>\n+    </see-also>\n+  </function>\n+  <manager name=\"ShowDialPlan\" language=\"en_US\">\n+    <synopsis>Show dialplan contexts and extensions</synopsis>\n+    <syntax>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      <parameter name=\"Extension\">\n+        <para>Show a specific extension.</para>\n+      </parameter>\n+      <parameter name=\"Context\">\n+        <para>Show a specific context.</para>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>Show dialplan contexts and extensions. Be aware that showing the full dialplan\n+\t\t\tmay take a lot of capacity.</para>\n+    </description>\n+  </manager>\n+  <manager name=\"ExtensionStateList\" language=\"en_US\">\n+    <synopsis>List the current known extension states.</synopsis>\n+    <syntax>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+    </syntax>\n+    <description>\n+      <para>\n+        This will list out all known extension states in a\n+\t\t\tsequence of\n+        <replaceable>ExtensionStatus</replaceable>\n+        events.\n+\t\t\tWhen finished, a\n+        <replaceable>ExtensionStateListComplete</replaceable>\n+        event\n+\t\t\twill be emitted.\n+      </para>\n+    </description>\n+    <see-also>\n+      <ref type=\"manager\">ExtensionState</ref>\n+      <ref type=\"function\">HINT</ref>\n+      <ref type=\"function\">EXTENSION_STATE</ref>\n+    </see-also>\n+    <responses>\n+      <list-elements>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='ExtensionStatus'])\"/>\n+      </list-elements>\n+      <managerEvent name=\"ExtensionStateListComplete\" language=\"en_US\">\n+        <managerEventInstance class=\"EVENT_FLAG_COMMAND\">\n+          <synopsis>Indicates the end of the list the current known extension states.</synopsis>\n+          <syntax>\n+            <parameter name=\"EventList\">\n+              <para>Conveys the status of the event list.</para>\n+            </parameter>\n+            <parameter name=\"ListItems\">\n+              <para>Conveys the number of statuses reported.</para>\n+            </parameter>\n+          </syntax>\n+        </managerEventInstance>\n+      </managerEvent>\n+    </responses>\n+  </manager>\n+  <module language=\"en_US\" name=\"stream\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"presencestate\">\n+  <module language=\"en_US\" name=\"format_cap\">\n     <support_level>core</support_level>\n   </module>\n-  <managerEvent language=\"en_US\" name=\"PresenceStateChange\">\n-    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n-      <synopsis>Raised when a presence state changes</synopsis>\n-      <syntax>\n-        <parameter name=\"Presentity\">\n-          <para>The entity whose presence state has changed</para>\n-        </parameter>\n-        <parameter name=\"Status\">\n-          <para>The new status of the presentity</para>\n-        </parameter>\n-        <parameter name=\"Subtype\">\n-          <para>The new subtype of the presentity</para>\n-        </parameter>\n-        <parameter name=\"Message\">\n-          <para>The new message of the presentity</para>\n-        </parameter>\n-      </syntax>\n-      <description>\n-        <para>\n-          This differs from the\n-          <literal>PresenceStatus</literal>\n-          event because this event is raised for all presence state changes,\n-\t\t\t\tnot only for changes that affect dialplan hints.\n-        </para>\n-      </description>\n-      <see-also>\n-        <ref type=\"managerEvent\">PresenceStatus</ref>\n-      </see-also>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <module language=\"en_US\" name=\"bridge_roles\">\n+  <module language=\"en_US\" name=\"ulaw\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"syslog\">\n+  <module language=\"en_US\" name=\"sounds\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"pbx_switch\">\n+  <module language=\"en_US\" name=\"pbx_app\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"backtrace\">\n+  <module language=\"en_US\" name=\"format\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"event\">\n+  <module language=\"en_US\" name=\"dns_naptr\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"autoservice\">\n+  <module language=\"en_US\" name=\"dns\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"astmm\">\n+  <module language=\"en_US\" name=\"options\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"pbx_sw\">\n+  <module language=\"en_US\" name=\"srv\">\n     <support_level>core</support_level>\n   </module>\n   <managerEvent language=\"en_US\" name=\"BridgeCreate\">\n     <managerEventInstance class=\"EVENT_FLAG_CALL\">\n       <synopsis>Raised when a bridge is created.</synopsis>\n       <syntax>\n         <bridge_snapshot/>\n@@ -22491,524 +24317,178 @@\n       <ref type=\"manager\">Bridge</ref>\n       <ref type=\"manager\">BridgeDestroy</ref>\n       <ref type=\"manager\">BridgeInfo</ref>\n       <ref type=\"manager\">BridgeList</ref>\n       <ref type=\"managerEvent\">BridgeLeave</ref>\n     </see-also>\n   </manager>\n-  <module language=\"en_US\" name=\"utils\">\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"channel\">\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"lock\">\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"format\">\n+  <module language=\"en_US\" name=\"pbx_sw\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"heap\">\n+  <module language=\"en_US\" name=\"netsock2\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"bucket\">\n-    <use type=\"external\">uriparser</use>\n+  <module language=\"en_US\" name=\"astmm\">\n     <support_level>core</support_level>\n   </module>\n-  <configInfo name=\"core\" language=\"en_US\">\n-    <synopsis>Bucket file API</synopsis>\n-    <configFile name=\"bucket\">\n-      <configObject name=\"bucket\">\n-        <configOption name=\"scheme\">\n-          <synopsis>Scheme in use for bucket</synopsis>\n-        </configOption>\n-        <configOption name=\"created\">\n-          <synopsis>Time at which the bucket was created</synopsis>\n-        </configOption>\n-        <configOption name=\"modified\">\n-          <synopsis>Time at which the bucket was last modified</synopsis>\n-        </configOption>\n-      </configObject>\n-      <configObject name=\"file\">\n-        <configOption name=\"scheme\">\n-          <synopsis>Scheme in use for file</synopsis>\n-        </configOption>\n-        <configOption name=\"created\">\n-          <synopsis>Time at which the file was created</synopsis>\n-        </configOption>\n-        <configOption name=\"modified\">\n-          <synopsis>Time at which the file was last modified</synopsis>\n-        </configOption>\n-      </configObject>\n-    </configFile>\n-  </configInfo>\n-  <module language=\"en_US\" name=\"dns_naptr\">\n+  <module language=\"en_US\" name=\"media_cache\">\n     <support_level>core</support_level>\n   </module>\n   <module language=\"en_US\" name=\"tdd\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"asterisk\">\n+  <module language=\"en_US\" name=\"stasis_channels\">\n     <support_level>core</support_level>\n   </module>\n-  <managerEvent language=\"en_US\" name=\"FullyBooted\">\n-    <managerEventInstance class=\"EVENT_FLAG_SYSTEM\">\n-      <synopsis>Raised when all Asterisk initialization procedures have finished.</synopsis>\n+  <managerEvent language=\"en_US\" name=\"VarSet\">\n+    <managerEventInstance class=\"EVENT_FLAG_DIALPLAN\">\n+      <synopsis>Raised when a variable is set to a particular value.</synopsis>\n       <syntax>\n-        <parameter name=\"Status\">\n-          <para>Informational message</para>\n+        <channel_snapshot/>\n+        <parameter name=\"Variable\">\n+          <para>The variable being set.</para>\n         </parameter>\n-        <parameter name=\"Uptime\">\n-          <para>Seconds since start</para>\n+        <parameter name=\"Value\">\n+          <para>The new value of the variable.</para>\n         </parameter>\n-        <parameter name=\"LastReload\">\n-          <para>Seconds since last reload</para>\n+      </syntax>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <managerEvent language=\"en_US\" name=\"AgentLogin\">\n+    <managerEventInstance class=\"EVENT_FLAG_AGENT\">\n+      <synopsis>Raised when an Agent has logged in.</synopsis>\n+      <syntax>\n+        <channel_snapshot/>\n+        <parameter name=\"Agent\">\n+          <para>Agent ID of the agent.</para>\n         </parameter>\n       </syntax>\n+      <see-also>\n+        <ref type=\"application\">AgentLogin</ref>\n+        <ref type=\"managerEvent\">AgentLogoff</ref>\n+      </see-also>\n     </managerEventInstance>\n   </managerEvent>\n-  <managerEvent language=\"en_US\" name=\"Shutdown\">\n-    <managerEventInstance class=\"EVENT_FLAG_SYSTEM\">\n-      <synopsis>Raised when Asterisk is shutdown or restarted.</synopsis>\n+  <managerEvent language=\"en_US\" name=\"AgentLogoff\">\n+    <managerEventInstance class=\"EVENT_FLAG_AGENT\">\n+      <synopsis>Raised when an Agent has logged off.</synopsis>\n       <syntax>\n-        <parameter name=\"Shutdown\">\n-          <para>Whether the shutdown is proceeding cleanly (all channels\n-\t\t\t\t\twere hungup successfully) or uncleanly (channels will be\n-\t\t\t\t\tterminated)</para>\n-          <enumlist>\n-            <enum name=\"Uncleanly\"/>\n-            <enum name=\"Cleanly\"/>\n-          </enumlist>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='AgentLogin']/managerEventInstance/syntax/parameter)\"/>\n+        <parameter name=\"Logintime\">\n+          <para>The number of seconds the agent was logged in.</para>\n         </parameter>\n-        <parameter name=\"Restart\">\n-          <para>Whether or not a restart will occur.</para>\n-          <enumlist>\n-            <enum name=\"True\"/>\n-            <enum name=\"False\"/>\n-          </enumlist>\n+      </syntax>\n+      <see-also>\n+        <ref type=\"managerEvent\">AgentLogin</ref>\n+      </see-also>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <managerEvent language=\"en_US\" name=\"ChannelTalkingStart\">\n+    <managerEventInstance class=\"EVENT_FLAG_CLASS\">\n+      <synopsis>Raised when talking is detected on a channel.</synopsis>\n+      <syntax>\n+        <channel_snapshot/>\n+      </syntax>\n+      <see-also>\n+        <ref type=\"function\">TALK_DETECT</ref>\n+        <ref type=\"managerEvent\">ChannelTalkingStop</ref>\n+      </see-also>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <managerEvent language=\"en_US\" name=\"ChannelTalkingStop\">\n+    <managerEventInstance class=\"EVENT_FLAG_CLASS\">\n+      <synopsis>Raised when talking is no longer detected on a channel.</synopsis>\n+      <syntax>\n+        <channel_snapshot/>\n+        <parameter name=\"Duration\">\n+          <para>The length in time, in milliseconds, that talking was\n+\t\t\t\t\tdetected on the channel.</para>\n         </parameter>\n       </syntax>\n+      <see-also>\n+        <ref type=\"function\">TALK_DETECT</ref>\n+        <ref type=\"managerEvent\">ChannelTalkingStart</ref>\n+      </see-also>\n     </managerEventInstance>\n   </managerEvent>\n-  <module language=\"en_US\" name=\"say\">\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"dns_recurring\">\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"srv\">\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"logger\">\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"mixmonitor\">\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"pbx_app\">\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"json\">\n-    <depend>jansson</depend>\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"fskmodem_int\">\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"dial\">\n+  <module language=\"en_US\" name=\"timing\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"cel\">\n+  <module language=\"en_US\" name=\"udptl\">\n     <support_level>core</support_level>\n   </module>\n-  <configInfo name=\"cel\" language=\"en_US\">\n-    <configFile name=\"cel.conf\">\n-      <configObject name=\"general\">\n-        <synopsis>Options that apply globally to Channel Event Logging (CEL)</synopsis>\n-        <configOption name=\"enable\">\n-          <synopsis>Determines whether CEL is enabled</synopsis>\n+  <configInfo name=\"udptl\" language=\"en_US\">\n+    <configFile name=\"udptl.conf\">\n+      <configObject name=\"global\">\n+        <synopsis>Global options for configuring UDPTL</synopsis>\n+        <configOption name=\"udptlstart\">\n+          <synopsis>The start of the UDPTL port range</synopsis>\n         </configOption>\n-        <configOption name=\"dateformat\">\n-          <synopsis>The format to be used for dates when logging</synopsis>\n+        <configOption name=\"udptlend\">\n+          <synopsis>The end of the UDPTL port range</synopsis>\n         </configOption>\n-        <configOption name=\"apps\">\n-          <synopsis>List of apps for CEL to track</synopsis>\n-          <description>\n-            <para>A case-insensitive, comma-separated list of applications\n-\t\t\t\t\tto track when one or both of APP_START and APP_END events are flagged for\n-\t\t\t\t\ttracking</para>\n-          </description>\n+        <configOption name=\"udptlchecksums\">\n+          <synopsis>Whether to enable or disable UDP checksums on UDPTL traffic</synopsis>\n         </configOption>\n-        <configOption name=\"events\">\n-          <synopsis>List of events for CEL to track</synopsis>\n-          <description>\n-            <para>\n-              A case-sensitive, comma-separated list of event names\n-\t\t\t\t\tto track. These event names do not include the leading\n-              <literal>AST_CEL</literal>\n-              .\n-            </para>\n-            <enumlist>\n-              <enum name=\"ALL\">\n-                <para>Special value which tracks all events.</para>\n-              </enum>\n-              <enum name=\"CHAN_START\"/>\n-              <enum name=\"CHAN_END\"/>\n-              <enum name=\"ANSWER\"/>\n-              <enum name=\"HANGUP\"/>\n-              <enum name=\"APP_START\"/>\n-              <enum name=\"APP_END\"/>\n-              <enum name=\"PARK_START\"/>\n-              <enum name=\"PARK_END\"/>\n-              <enum name=\"USER_DEFINED\"/>\n-              <enum name=\"BRIDGE_ENTER\"/>\n-              <enum name=\"BRIDGE_EXIT\"/>\n-              <enum name=\"BLINDTRANSFER\"/>\n-              <enum name=\"ATTENDEDTRANSFER\"/>\n-              <enum name=\"PICKUP\"/>\n-              <enum name=\"FORWARD\"/>\n-              <enum name=\"LINKEDID_END\"/>\n-              <enum name=\"LOCAL_OPTIMIZE\"/>\n-            </enumlist>\n-          </description>\n+        <configOption name=\"udptlfecentries\">\n+          <synopsis>The number of error correction entries in a UDPTL packet</synopsis>\n+        </configOption>\n+        <configOption name=\"udptlfecspan\">\n+          <synopsis>The span over which parity is calculated for FEC in a UDPTL packet</synopsis>\n+        </configOption>\n+        <configOption name=\"use_even_ports\">\n+          <synopsis>Whether to only use even-numbered UDPTL ports</synopsis>\n+        </configOption>\n+        <configOption name=\"t38faxudpec\">\n+          <synopsis>Removed</synopsis>\n+        </configOption>\n+        <configOption name=\"t38faxmaxdatagram\">\n+          <synopsis>Removed</synopsis>\n         </configOption>\n       </configObject>\n     </configFile>\n   </configInfo>\n-  <module language=\"en_US\" name=\"pbx_ignorepat\">\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"pbx_variables\">\n-    <support_level>core</support_level>\n-  </module>\n-  <application name=\"Set\" language=\"en_US\">\n-    <synopsis>Set channel variable or function value.</synopsis>\n-    <syntax argsep=\"=\">\n-      <parameter name=\"name\" required=\"true\"/>\n-      <parameter name=\"value\" required=\"true\"/>\n-    </syntax>\n-    <description>\n-      <para>\n-        This function can be used to set the value of channel variables or dialplan functions.\n-\t\t\tWhen setting variables, if the variable name is prefixed with\n-        <literal>_</literal>\n-        ,\n-\t\t\tthe variable will be inherited into channels created from the current channel.\n-\t\t\tIf the variable name is prefixed with\n-        <literal>__</literal>\n-        , the variable will be\n-\t\t\tinherited into channels created from the current channel and all children channels.\n-      </para>\n-      <note>\n-        <para>\n-          If (and only if), in\n-          <filename>/etc/asterisk/asterisk.conf</filename>\n-          , you have\n-\t\t\ta\n-          <literal>[compat]</literal>\n-          category, and you have\n-          <literal>app_set = 1.4</literal>\n-          under that, then\n-\t\t\tthe behavior of this app changes, and strips surrounding quotes from the right hand side as\n-\t\t\tit did previously in 1.4.\n-\t\t\tThe advantages of not stripping out quoting, and not caring about the separator characters (comma and vertical bar)\n-\t\t\twere sufficient to make these changes in 1.6. Confusion about how many backslashes would be needed to properly\n-\t\t\tprotect separators and quotes in various database access strings has been greatly\n-\t\t\treduced by these changes.\n-        </para>\n-      </note>\n-    </description>\n-    <see-also>\n-      <ref type=\"application\">MSet</ref>\n-      <ref type=\"function\">GLOBAL</ref>\n-      <ref type=\"function\">SET</ref>\n-      <ref type=\"function\">ENV</ref>\n-    </see-also>\n-  </application>\n-  <application name=\"MSet\" language=\"en_US\">\n-    <synopsis>Set channel variable(s) or function value(s).</synopsis>\n-    <syntax>\n-      <parameter name=\"set1\" required=\"true\" argsep=\"=\">\n-        <argument name=\"name1\" required=\"true\"/>\n-        <argument name=\"value1\" required=\"true\"/>\n-      </parameter>\n-      <parameter name=\"set2\" multiple=\"true\" argsep=\"=\">\n-        <argument name=\"name2\" required=\"true\"/>\n-        <argument name=\"value2\" required=\"true\"/>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>\n-        This function can be used to set the value of channel variables or dialplan functions.\n-\t\t\tWhen setting variables, if the variable name is prefixed with\n-        <literal>_</literal>\n-        ,\n-\t\t\tthe variable will be inherited into channels created from the current channel\n-\t\t\tIf the variable name is prefixed with\n-        <literal>__</literal>\n-        , the variable will be\n-\t\t\tinherited into channels created from the current channel and all children channels.\n-\t\t\tMSet behaves in a similar fashion to the way Set worked in 1.2/1.4 and is thus\n-\t\t\tprone to doing things that you may not expect. For example, it strips surrounding\n-\t\t\tdouble-quotes from the right-hand side (value). If you need to put a separator\n-\t\t\tcharacter (comma or vert-bar), you will need to escape them by inserting a backslash\n-\t\t\tbefore them. Avoid its use if possible.\n-      </para>\n-      <para>This application allows up to 99 variables to be set at once.</para>\n-    </description>\n-    <see-also>\n-      <ref type=\"application\">Set</ref>\n-    </see-also>\n-  </application>\n-  <module language=\"en_US\" name=\"media_cache\">\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"indications\">\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"cli\">\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"slinfactory\">\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"stasis_message\">\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"pbx_functions\">\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"http\">\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"hashtab\">\n+  <module language=\"en_US\" name=\"enum\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"cdr\">\n+  <module language=\"en_US\" name=\"bucket\">\n+    <use type=\"external\">uriparser</use>\n     <support_level>core</support_level>\n   </module>\n-  <configInfo name=\"cdr\" language=\"en_US\">\n-    <synopsis>Call Detail Record configuration</synopsis>\n-    <description>\n-      <para>CDR is Call Detail Record, which provides logging services via a variety of\n-\t\t\tpluggable backend modules. Detailed call information can be recorded to\n-\t\t\tdatabases, files, etc. Useful for billing, fraud prevention, compliance with\n-\t\t\tSarbanes-Oxley aka The Enron Act, QOS evaluations, and more.</para>\n-    </description>\n-    <configFile name=\"cdr.conf\">\n-      <configObject name=\"general\">\n-        <synopsis>Global settings applied to the CDR engine.</synopsis>\n-        <configOption name=\"debug\">\n-          <synopsis>Enable/disable verbose CDR debugging.</synopsis>\n-          <description>\n-            <para>\n-              When set to\n-              <literal>True</literal>\n-              , verbose updates\n-\t\t\t\t\tof changes in CDR information will be logged. Note that this is only\n-\t\t\t\t\tof use when debugging CDR behavior.\n-            </para>\n-          </description>\n-        </configOption>\n-        <configOption name=\"enable\" default=\"yes\">\n-          <synopsis>Enable/disable CDR logging.</synopsis>\n-          <description>\n-            <para>Define whether or not to use CDR logging. Setting this to &quot;no&quot; will override\n-\t\t\t\t\tany loading of backend CDR modules.</para>\n-          </description>\n-        </configOption>\n-        <configOption name=\"channeldefaultenabled\" default=\"yes\">\n-          <synopsis>Whether CDR is enabled on a channel by default</synopsis>\n-          <description>\n-            <para>Define whether or not CDR should be enabled on a channel by default.\n-\t\t\t\t\tSetting this to &quot;yes&quot; will enable CDR on every channel unless it is explicitly disabled.\n-\t\t\t\t\tSetting this to &quot;no&quot; will disable CDR on every channel unless it is explicitly enabled.</para>\n-            <para>\n-              Note that CDR must still be globally enabled (\n-              <literal>enable = yes</literal>\n-              ) for this\n-\t\t\t\t\toption to have any effect. This only applies to whether CDR is enabled or disabled on\n-\t\t\t\t\tnewly created channels, which can be changed in the dialplan during a call.\n-            </para>\n-            <para>\n-              If this is set to &quot;yes&quot;, you should use\n-              <literal>Set(CDR_PROP(disable)=1)</literal>\n-              to disable CDR for a call.\n-            </para>\n-            <para>\n-              If this is set to &quot;no&quot;, you should use\n-              <literal>Set(CDR_PROP(disable)=0)</literal>\n-              to undisable (enable) CDR for a call.\n-            </para>\n-          </description>\n-        </configOption>\n-        <configOption name=\"unanswered\">\n-          <synopsis>Log calls that are never answered and don't set an outgoing party.</synopsis>\n-          <description>\n-            <para>Define whether or not to log unanswered calls that don't involve an outgoing party. Setting\n-\t\t\t\t\tthis to &quot;yes&quot; will make calls to extensions that don't answer and don't set a side B channel\n-\t\t\t\t\t(such as by using the Dial application) receive CDR log entries. If this option is set to\n-\t\t\t\t\t&quot;no&quot;, then those log entries will not be created. Unanswered calls which get offered to an\n-\t\t\t\t\toutgoing line will always receive log entries regardless of this option, and that is the\n-\t\t\t\t\tintended behavior.</para>\n-          </description>\n-        </configOption>\n-        <configOption name=\"congestion\">\n-          <synopsis>Log congested calls.</synopsis>\n-          <description>\n-            <para>Define whether or not to log congested calls. Setting this to &quot;yes&quot; will\n-\t\t\t\t\treport each call that fails to complete due to congestion conditions.</para>\n-          </description>\n-        </configOption>\n-        <configOption name=\"endbeforehexten\">\n-          <synopsis>Don't produce CDRs while executing hangup logic</synopsis>\n-          <description>\n-            <para>\n-              As each CDR for a channel is finished, its end time is updated\n-\t\t\t\t\t\tand the CDR is finalized. When a channel is hung up and hangup\n-\t\t\t\t\t\tlogic is present (in the form of a hangup handler or the\n-              <literal>h</literal>\n-              extension), a new CDR is generated for the\n-\t\t\t\t\t\tchannel. Any statistics are gathered from this new CDR. By enabling\n-\t\t\t\t\t\tthis option, no new CDR is created for the dialplan logic that is\n-\t\t\t\t\t\texecuted in\n-              <literal>h</literal>\n-              extensions or attached hangup handler\n-\t\t\t\t\t\tsubroutines. The default value is\n-              <literal>yes</literal>\n-              , indicating\n-\t\t\t\t\t\tthat a CDR will be generated during hangup logic.\n-            </para>\n-          </description>\n-        </configOption>\n-        <configOption name=\"initiatedseconds\">\n-          <synopsis>Count microseconds for billsec purposes</synopsis>\n-          <description>\n-            <para>\n-              Normally, the\n-              <literal>billsec</literal>\n-              field logged to the CDR backends\n-\t\t\t\t\tis simply the end time (hangup time) minus the answer time in seconds. Internally,\n-\t\t\t\t\tasterisk stores the time in terms of microseconds and seconds. By setting\n-\t\t\t\t\tinitiatedseconds to\n-              <literal>yes</literal>\n-              , you can force asterisk to report any seconds\n-\t\t\t\t\tthat were initiated (a sort of round up method). Technically, this is\n-\t\t\t\t\twhen the microsecond part of the end time is greater than the microsecond\n-\t\t\t\t\tpart of the answer time, then the billsec time is incremented one second.\n-            </para>\n-          </description>\n+  <configInfo name=\"core\" language=\"en_US\">\n+    <synopsis>Bucket file API</synopsis>\n+    <configFile name=\"bucket\">\n+      <configObject name=\"bucket\">\n+        <configOption name=\"scheme\">\n+          <synopsis>Scheme in use for bucket</synopsis>\n         </configOption>\n-        <configOption name=\"batch\">\n-          <synopsis>Submit CDRs to the backends for processing in batches</synopsis>\n-          <description>\n-            <para>Define the CDR batch mode, where instead of posting the CDR at the end of\n-\t\t\t\t\tevery call, the data will be stored in a buffer to help alleviate load on the\n-\t\t\t\t\tasterisk server.</para>\n-            <warning>\n-              <para>Use of batch mode may result in data loss after unsafe asterisk termination,\n-\t\t\t\t\ti.e., software crash, power failure, kill -9, etc.</para>\n-            </warning>\n-          </description>\n+        <configOption name=\"created\">\n+          <synopsis>Time at which the bucket was created</synopsis>\n         </configOption>\n-        <configOption name=\"size\">\n-          <synopsis>The maximum number of CDRs to accumulate before triggering a batch</synopsis>\n-          <description>\n-            <para>\n-              Define the maximum number of CDRs to accumulate in the buffer before posting\n-\t\t\t\t\tthem to the backend engines. batch must be set to\n-              <literal>yes</literal>\n-              .\n-            </para>\n-          </description>\n+        <configOption name=\"modified\">\n+          <synopsis>Time at which the bucket was last modified</synopsis>\n         </configOption>\n-        <configOption name=\"time\">\n-          <synopsis>The maximum time to accumulate CDRs before triggering a batch</synopsis>\n-          <description>\n-            <para>\n-              Define the maximum time to accumulate CDRs before posting them in a batch to the\n-\t\t\t\t\tbackend engines. If this time limit is reached, then it will post the records, regardless of the value\n-\t\t\t\t\tdefined for size. batch must be set to\n-              <literal>yes</literal>\n-              .\n-            </para>\n-            <note>\n-              <para>Time is expressed in seconds.</para>\n-            </note>\n-          </description>\n+      </configObject>\n+      <configObject name=\"file\">\n+        <configOption name=\"scheme\">\n+          <synopsis>Scheme in use for file</synopsis>\n         </configOption>\n-        <configOption name=\"scheduleronly\">\n-          <synopsis>Post batched CDRs on their own thread instead of the scheduler</synopsis>\n-          <description>\n-            <para>\n-              The CDR engine uses the internal asterisk scheduler to determine when to post\n-\t\t\t\t\trecords.  Posting can either occur inside the scheduler thread, or a new\n-\t\t\t\t\tthread can be spawned for the submission of every batch.  For small batches,\n-\t\t\t\t\tit might be acceptable to just use the scheduler thread, so set this to\n-              <literal>yes</literal>\n-              .\n-\t\t\t\t\tFor large batches, say anything over size=10, a new thread is recommended, so\n-\t\t\t\t\tset this to\n-              <literal>no</literal>\n-              .\n-            </para>\n-          </description>\n+        <configOption name=\"created\">\n+          <synopsis>Time at which the file was created</synopsis>\n         </configOption>\n-        <configOption name=\"safeshutdown\">\n-          <synopsis>Block shutdown of Asterisk until CDRs are submitted</synopsis>\n-          <description>\n-            <para>\n-              When shutting down asterisk, you can block until the CDRs are submitted.  If\n-\t\t\t\t\tyou don't, then data will likely be lost.  You can always check the size of\n-\t\t\t\t\tthe CDR batch buffer with the CLI\n-              <astcli>cdr status</astcli>\n-              command.  To enable blocking on\n-\t\t\t\t\tsubmission of CDR data during asterisk shutdown, set this to\n-              <literal>yes</literal>\n-              .\n-            </para>\n-          </description>\n+        <configOption name=\"modified\">\n+          <synopsis>Time at which the file was last modified</synopsis>\n         </configOption>\n       </configObject>\n     </configFile>\n   </configInfo>\n-  <module language=\"en_US\" name=\"astfd\">\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"dns_txt\">\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"bridge_after\">\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"xml\">\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"io\">\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"ulaw\">\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"utf8\">\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"abstract_jb\">\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"datastore\">\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"localtime\">\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"global_datastores\">\n+  <module language=\"en_US\" name=\"dns_srv\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"bridge_channel\">\n+  <module language=\"en_US\" name=\"fixedjitterbuf\">\n     <support_level>core</support_level>\n   </module>\n   <configInfo name=\"features\" language=\"en_US\">\n     <synopsis>Features Configuration</synopsis>\n     <configFile name=\"features.conf\">\n       <configObject name=\"globals\">\n         <synopsis/>\n@@ -23527,991 +25007,119 @@\n \t\t\tvalue has not been set.  This function can also be used to set a channel\n \t\t\tspecific value for a feature mapping.</para>\n     </description>\n     <see-also>\n       <ref type=\"function\">FEATURE</ref>\n     </see-also>\n   </function>\n-  <module language=\"en_US\" name=\"pickup\">\n-    <support_level>core</support_level>\n-  </module>\n-  <managerEvent language=\"en_US\" name=\"Pickup\">\n-    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n-      <synopsis>Raised when a call pickup occurs.</synopsis>\n-      <syntax>\n-        <channel_snapshot/>\n-        <channel_snapshot prefix=\"Target\"/>\n-      </syntax>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <module language=\"en_US\" name=\"config\">\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"fskmodem_float\">\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"stasis_message_router\">\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"conversions\">\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"jitterbuf\">\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"dnsmgr\">\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"strings\">\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"threadstorage\">\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"stun\">\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"message\">\n-    <support_level>core</support_level>\n-  </module>\n-  <function name=\"MESSAGE\" language=\"en_US\">\n-    <synopsis>Create a message or read fields from a message.</synopsis>\n-    <syntax argsep=\"/\">\n-      <parameter name=\"argument\" required=\"true\">\n-        <para>Field of the message to get or set.</para>\n-        <enumlist>\n-          <enum name=\"to\">\n-            <para>When processing an\n-\t\t\t\t\tincoming message, this will be set to the destination listed as\n-\t\t\t\t\tthe recipient of the message that was received by Asterisk.</para>\n-            <para/>\n-            <para>For an outgoing message, this will set the To header in the\n-\t\t\t\t\toutgoing SIP message.  This may be overridden by the &quot;to&quot; parameter\n-\t\t\t\t\tof MessageSend.</para>\n-          </enum>\n-          <enum name=\"from\">\n-            <para>When processing an\n-\t\t\t\t\tincoming message, this will be set to the source of the message.</para>\n-            <para/>\n-            <para>For an outgoing message, this will set the From header in the\n-\t\t\t\t\toutgoing SIP message. This may be overridden by the &quot;from&quot; parameter\n-\t\t\t\t\tof MessageSend.</para>\n-          </enum>\n-          <enum name=\"custom_data\">\n-            <para>Write-only.  Mark or unmark all message headers for an outgoing\n-\t\t\t\t\tmessage.  The following values can be set:</para>\n-            <enumlist>\n-              <enum name=\"mark_all_outbound\">\n-                <para>Mark all headers for an outgoing message.</para>\n-              </enum>\n-              <enum name=\"clear_all_outbound\">\n-                <para>Unmark all headers for an outgoing message.</para>\n-              </enum>\n-            </enumlist>\n-          </enum>\n-          <enum name=\"body\">\n-            <para>Read/Write.  The message body.  When processing an incoming\n-\t\t\t\t\tmessage, this includes the body of the message that Asterisk\n-\t\t\t\t\treceived.  When MessageSend() is executed, the contents of this\n-\t\t\t\t\tfield are used as the body of the outgoing message.  The body\n-\t\t\t\t\twill always be UTF-8.</para>\n-          </enum>\n-        </enumlist>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>This function will read from or write a value to a text message.\n-\t\t\tIt is used both to read the data out of an incoming message, as well as\n-\t\t\tmodify or create a message that will be sent outbound.</para>\n-    </description>\n-    <see-also>\n-      <ref type=\"application\">MessageSend</ref>\n-    </see-also>\n-  </function>\n-  <function name=\"MESSAGE_DATA\" language=\"en_US\">\n-    <synopsis>Read or write custom data attached to a message.</synopsis>\n-    <syntax argsep=\"/\">\n-      <parameter name=\"argument\" required=\"true\">\n-        <para>Field of the message to get or set.</para>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>This function will read from or write a value to a text message.\n-\t\t\tIt is used both to read the data out of an incoming message, as well as\n-\t\t\tmodify a message that will be sent outbound.</para>\n-      <note>\n-        <para>\n-          If you want to set an outbound message to carry data in the\n-\t\t\t\tcurrent message, do\n-\t\t\t\tSet(MESSAGE_DATA(\n-          <replaceable>key</replaceable>\n-          )=${MESSAGE_DATA(\n-          <replaceable>key</replaceable>\n-          )}).\n-        </para>\n-      </note>\n-    </description>\n-    <see-also>\n-      <ref type=\"application\">MessageSend</ref>\n-    </see-also>\n-  </function>\n-  <application name=\"MessageSend\" language=\"en_US\">\n-    <synopsis>Send a text message.</synopsis>\n-    <syntax>\n-      <parameter name=\"destination\" required=\"true\">\n-        <para>A To URI for the message.</para>\n-        <xi:include xpointer=\"xpointer(/docs/info[@name='MessageDestinationInfo'])\"/>\n-      </parameter>\n-      <parameter name=\"from\" required=\"false\">\n-        <para>\n-          A From URI for the message if needed for the\n-\t\t\t\tmessage technology being used to send this message. This can be a\n-\t\t\t\tSIP(S) URI, such as\n-          <literal>Alice &lt;sip:alice@atlanta.com&gt;</literal>\n-          ,\n-\t\t\t\tor a string in the format\n-          <literal>alice@atlanta.com</literal>\n-          .\n-\t\t\t\tThis will override a\n-          <literal>from</literal>\n-          specified using the MESSAGE dialplan function or the\n-          <literal>from</literal>\n-          that may have been on an incoming message.\n-        </para>\n-        <xi:include xpointer=\"xpointer(/docs/info[@name='MessageFromInfo'])\"/>\n-      </parameter>\n-      <parameter name=\"to\" required=\"false\">\n-        <para>\n-          A To URI for the message if needed for the\n-\t\t\t\tmessage technology being used to send this message. This can be a\n-\t\t\t\tSIP(S) URI, such as\n-          <literal>Alice &lt;sip:alice@atlanta.com&gt;</literal>\n-          ,\n-\t\t\t\tor a string in the format\n-          <literal>alice@atlanta.com</literal>\n-          .\n-\t\t\t\tThis will override a\n-          <literal>to</literal>\n-          specified using the MESSAGE dialplan function or the\n-          <literal>to</literal>\n-          that may have been on an incoming message.\n-        </para>\n-        <xi:include xpointer=\"xpointer(/docs/info[@name='MessageToInfo'])\"/>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>\n-        Send a text message.  The body of the message that will be\n-\t\t\tsent is what is currently set to\n-        <literal>MESSAGE(body)</literal>\n-        .\n-\t\t\tThis may he come from an incoming message.\n-\t\t\tThe technology chosen for sending the message is determined\n-\t\t\tbased on a prefix to the\n-        <literal>destination</literal>\n-        parameter.\n-      </para>\n-      <para>This application sets the following channel variables:</para>\n-      <variablelist>\n-        <variable name=\"MESSAGE_SEND_STATUS\">\n-          <para>This is the message delivery status returned by this application.</para>\n-          <value name=\"INVALID_PROTOCOL\">No handler for the technology part of the URI was found.</value>\n-          <value name=\"INVALID_URI\">The protocol handler reported that the URI was not valid.</value>\n-          <value name=\"SUCCESS\">Successfully passed on to the protocol handler, but delivery has not necessarily been guaranteed.</value>\n-          <value name=\"FAILURE\">The protocol handler reported that it was unabled to deliver the message for some reason.</value>\n-        </variable>\n-      </variablelist>\n-    </description>\n-  </application>\n-  <manager name=\"MessageSend\" language=\"en_US\">\n-    <synopsis>Send an out of call message to an endpoint.</synopsis>\n-    <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"Destination\" required=\"false\">\n-        <para>A To URI for the message. If Destination is provided, the To\n-\t\t\t\tparameter can also be supplied and may alter the message based on\n-\t\t\t\tthe specified message technology.</para>\n-        <para>For backwards compatibility, if Destination is not provided,\n-\t\t\t\tthe To parameter must be provided and will be used as the message\n-\t\t\t\tdestination.</para>\n-        <xi:include xpointer=\"xpointer(/docs/info[@name='MessageDestinationInfo'])\"/>\n-      </parameter>\n-      <parameter name=\"To\" required=\"false\">\n-        <para>\n-          A To URI for the message if needed for the\n-\t\t\t\tmessage technology being used to send this message. This can be a\n-\t\t\t\tSIP(S) URI, such as\n-          <literal>Alice &lt;sip:alice@atlanta.com&gt;</literal>\n-          ,\n-\t\t\t\tor a string in the format\n-          <literal>alice@atlanta.com</literal>\n-          .\n-        </para>\n-        <para>This parameter is required if the Destination parameter is not\n-\t\t\t\tprovided.</para>\n-        <xi:include xpointer=\"xpointer(/docs/info[@name='MessageToInfo'])\"/>\n-      </parameter>\n-      <parameter name=\"From\">\n-        <para>A From URI for the message if needed for the\n-\t\t\t\tmessage technology being used to send this message.</para>\n-        <xi:include xpointer=\"xpointer(/docs/info[@name='MessageFromInfo'])\"/>\n-      </parameter>\n-      <parameter name=\"Body\">\n-        <para>The message body text.  This must not contain any newlines as that\n-\t\t\t\tconflicts with the AMI protocol.</para>\n-      </parameter>\n-      <parameter name=\"Base64Body\">\n-        <para>Text bodies requiring the use of newlines have to be base64 encoded\n-\t\t\t\tin this field.  Base64Body will be decoded before being sent out.\n-\t\t\t\tBase64Body takes precedence over Body.</para>\n-      </parameter>\n-      <parameter name=\"Variable\">\n-        <para>Message variable to set, multiple Variable: headers are\n-\t\t\t\tallowed.  The header value is a comma separated list of\n-\t\t\t\tname=value pairs.</para>\n-      </parameter>\n-    </syntax>\n-  </manager>\n-  <module language=\"en_US\" name=\"dns_test\">\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"crypt\">\n+  <module language=\"en_US\" name=\"plc\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"dns_srv\">\n+  <module language=\"en_US\" name=\"http\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"sdp_srtp\">\n+  <configInfo name=\"named_acl\" language=\"en_US\">\n+    <configFile name=\"named_acl.conf\">\n+      <configObject name=\"named_acl\">\n+        <synopsis>Options for configuring a named ACL</synopsis>\n+        <configOption name=\"permit\">\n+          <synopsis>An address/subnet from which to allow access</synopsis>\n+        </configOption>\n+        <configOption name=\"deny\">\n+          <synopsis>An address/subnet from which to disallow access</synopsis>\n+        </configOption>\n+      </configObject>\n+    </configFile>\n+  </configInfo>\n+  <module language=\"en_US\" name=\"autoservice\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"stasis_bridges\">\n+  <module language=\"en_US\" name=\"stasis_endpoints\">\n     <support_level>core</support_level>\n   </module>\n-  <managerEvent language=\"en_US\" name=\"BlindTransfer\">\n-    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n-      <synopsis>Raised when a blind transfer is complete.</synopsis>\n+  <managerEvent language=\"en_US\" name=\"PeerStatus\">\n+    <managerEventInstance class=\"EVENT_FLAG_SYSTEM\">\n+      <synopsis>Raised when the state of a peer changes.</synopsis>\n       <syntax>\n-        <parameter name=\"Result\">\n-          <para>Indicates if the transfer was successful or if it failed.</para>\n-          <enumlist>\n-            <enum name=\"Fail\">\n-              <para>An internal error occurred.</para>\n-            </enum>\n-            <enum name=\"Invalid\">\n-              <para>Invalid configuration for transfer (e.g. Not bridged)</para>\n-            </enum>\n-            <enum name=\"Not Permitted\">\n-              <para>Bridge does not permit transfers</para>\n-            </enum>\n-            <enum name=\"Success\">\n-              <para>Transfer completed successfully</para>\n-            </enum>\n-          </enumlist>\n-          <note>\n-            <para>\n-              A result of\n-              <literal>Success</literal>\n-              does not necessarily mean that a target was succesfully\n-\t\t\t\t\tcontacted. It means that a party was succesfully placed into the dialplan at the expected location.\n-            </para>\n-          </note>\n-        </parameter>\n-        <channel_snapshot prefix=\"Transferer\"/>\n-        <channel_snapshot prefix=\"Transferee\"/>\n-        <bridge_snapshot/>\n-        <parameter name=\"IsExternal\">\n-          <para>Indicates if the transfer was performed outside of Asterisk. For instance,\n-\t\t\t\t\ta channel protocol native transfer is external. A DTMF transfer is internal.</para>\n-          <enumlist>\n-            <enum name=\"Yes\"/>\n-            <enum name=\"No\"/>\n-          </enumlist>\n-        </parameter>\n-        <parameter name=\"Context\">\n-          <para>Destination context for the blind transfer.</para>\n+        <parameter name=\"ChannelType\">\n+          <para>The channel technology of the peer.</para>\n         </parameter>\n-        <parameter name=\"Extension\">\n-          <para>Destination extension for the blind transfer.</para>\n+        <parameter name=\"Peer\">\n+          <para>The name of the peer (including channel technology).</para>\n         </parameter>\n-      </syntax>\n-      <see-also>\n-        <ref type=\"manager\">BlindTransfer</ref>\n-      </see-also>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <managerEvent language=\"en_US\" name=\"AttendedTransfer\">\n-    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n-      <synopsis>Raised when an attended transfer is complete.</synopsis>\n-      <syntax>\n-        <xi:include xpointer=\"xpointer(docs/managerEvent[@name='BlindTransfer']/managerEventInstance/syntax/parameter[@name='Result'])\"/>\n-        <channel_snapshot prefix=\"OrigTransferer\"/>\n-        <bridge_snapshot prefix=\"Orig\"/>\n-        <channel_snapshot prefix=\"SecondTransferer\"/>\n-        <bridge_snapshot prefix=\"Second\"/>\n-        <parameter name=\"DestType\">\n-          <para>Indicates the method by which the attended transfer completed.</para>\n+        <parameter name=\"PeerStatus\">\n+          <para>New status of the peer.</para>\n           <enumlist>\n-            <enum name=\"Bridge\">\n-              <para>The transfer was accomplished by merging two bridges into one.</para>\n-            </enum>\n-            <enum name=\"App\">\n-              <para>The transfer was accomplished by having a channel or bridge run a dialplan application.</para>\n-            </enum>\n-            <enum name=\"Link\">\n-              <para>The transfer was accomplished by linking two bridges together using a local channel pair.</para>\n-            </enum>\n-            <enum name=\"Threeway\">\n-              <para>The transfer was accomplished by placing all parties into a threeway call.</para>\n-            </enum>\n-            <enum name=\"Fail\">\n-              <para>The transfer failed.</para>\n-            </enum>\n+            <enum name=\"Unknown\"/>\n+            <enum name=\"Registered\"/>\n+            <enum name=\"Unregistered\"/>\n+            <enum name=\"Rejected\"/>\n+            <enum name=\"Lagged\"/>\n           </enumlist>\n         </parameter>\n-        <parameter name=\"DestBridgeUniqueid\">\n-          <para>Indicates the surviving bridge when bridges were merged to complete the transfer</para>\n-          <note>\n-            <para>\n-              This header is only present when\n-              <replaceable>DestType</replaceable>\n-              is\n-              <literal>Bridge</literal>\n-              or\n-              <literal>Threeway</literal>\n-            </para>\n-          </note>\n-        </parameter>\n-        <parameter name=\"DestApp\">\n-          <para>Indicates the application that is running when the transfer completes</para>\n-          <note>\n-            <para>\n-              This header is only present when\n-              <replaceable>DestType</replaceable>\n-              is\n-              <literal>App</literal>\n-            </para>\n-          </note>\n-        </parameter>\n-        <channel_snapshot prefix=\"LocalOne\"/>\n-        <channel_snapshot prefix=\"LocalTwo\"/>\n-        <parameter name=\"DestTransfererChannel\">\n-          <para>The name of the surviving transferer channel when a transfer results in a threeway call</para>\n-          <note>\n-            <para>\n-              This header is only present when\n-              <replaceable>DestType</replaceable>\n-              is\n-              <literal>Threeway</literal>\n-            </para>\n-          </note>\n-        </parameter>\n-        <channel_snapshot prefix=\"Transferee\"/>\n-      </syntax>\n-      <description>\n-        <para>The headers in this event attempt to describe all the major details of the attended transfer. The two transferer channels\n-\t\t\t\tand the two bridges are determined based on their chronological establishment. So consider that Alice calls Bob, and then Alice\n-\t\t\t\ttransfers the call to Voicemail. The transferer and bridge headers would be arranged as follows:</para>\n-        <para>\n-          <replaceable>OrigTransfererChannel</replaceable>\n-          : Alice's channel in the bridge with Bob.\n-        </para>\n-        <para>\n-          <replaceable>OrigBridgeUniqueid</replaceable>\n-          : The bridge between Alice and Bob.\n-        </para>\n-        <para>\n-          <replaceable>SecondTransfererChannel</replaceable>\n-          : Alice's channel that called Voicemail.\n-        </para>\n-        <para>\n-          <replaceable>SecondBridgeUniqueid</replaceable>\n-          : Not present, since a call to Voicemail has no bridge.\n-        </para>\n-        <para>Now consider if the order were reversed; instead of having Alice call Bob and transfer him to Voicemail, Alice instead\n-\t\t\t\tcalls her Voicemail and transfers that to Bob. The transferer and bridge headers would be arranged as follows:</para>\n-        <para>\n-          <replaceable>OrigTransfererChannel</replaceable>\n-          : Alice's channel that called Voicemail.\n-        </para>\n-        <para>\n-          <replaceable>OrigBridgeUniqueid</replaceable>\n-          : Not present, since a call to Voicemail has no bridge.\n-        </para>\n-        <para>\n-          <replaceable>SecondTransfererChannel</replaceable>\n-          : Alice's channel in the bridge with Bob.\n-        </para>\n-        <para>\n-          <replaceable>SecondBridgeUniqueid</replaceable>\n-          : The bridge between Alice and Bob.\n-        </para>\n-      </description>\n-      <see-also>\n-        <ref type=\"manager\">AtxFer</ref>\n-      </see-also>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <module language=\"en_US\" name=\"pbx\">\n-    <support_level>core</support_level>\n-  </module>\n-  <function name=\"EXCEPTION\" language=\"en_US\">\n-    <synopsis>Retrieve the details of the current dialplan exception.</synopsis>\n-    <syntax>\n-      <parameter name=\"field\" required=\"true\">\n-        <para>The following fields are available for retrieval:</para>\n-        <enumlist>\n-          <enum name=\"reason\">\n-            <para>INVALID, ERROR, RESPONSETIMEOUT, ABSOLUTETIMEOUT, or custom\n-\t\t\t\t\t\tvalue set by the RaiseException() application</para>\n-          </enum>\n-          <enum name=\"context\">\n-            <para>The context executing when the exception occurred.</para>\n-          </enum>\n-          <enum name=\"exten\">\n-            <para>The extension executing when the exception occurred.</para>\n-          </enum>\n-          <enum name=\"priority\">\n-            <para>The numeric priority executing when the exception occurred.</para>\n-          </enum>\n-        </enumlist>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>\n-        Retrieve the details (specified\n-        <replaceable>field</replaceable>\n-        ) of the current dialplan exception.\n-      </para>\n-    </description>\n-    <see-also>\n-      <ref type=\"application\">RaiseException</ref>\n-    </see-also>\n-  </function>\n-  <function name=\"TESTTIME\" language=\"en_US\">\n-    <synopsis>Sets a time to be used with the channel to test logical conditions.</synopsis>\n-    <syntax>\n-      <parameter name=\"date\" required=\"true\" argsep=\" \">\n-        <para>Date in ISO 8601 format</para>\n-      </parameter>\n-      <parameter name=\"time\" required=\"true\" argsep=\" \">\n-        <para>Time in HH:MM:SS format (24-hour time)</para>\n-      </parameter>\n-      <parameter name=\"zone\" required=\"false\">\n-        <para>Timezone name</para>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>To test dialplan timing conditions at times other than the current time, use\n-\t\t\tthis function to set an alternate date and time.  For example, you may wish to evaluate\n-\t\t\twhether a location will correctly identify to callers that the area is closed on Christmas\n-\t\t\tDay, when Christmas would otherwise fall on a day when the office is normally open.</para>\n-    </description>\n-    <see-also>\n-      <ref type=\"application\">GotoIfTime</ref>\n-    </see-also>\n-  </function>\n-  <manager name=\"ShowDialPlan\" language=\"en_US\">\n-    <synopsis>Show dialplan contexts and extensions</synopsis>\n-    <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"Extension\">\n-        <para>Show a specific extension.</para>\n-      </parameter>\n-      <parameter name=\"Context\">\n-        <para>Show a specific context.</para>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>Show dialplan contexts and extensions. Be aware that showing the full dialplan\n-\t\t\tmay take a lot of capacity.</para>\n-    </description>\n-  </manager>\n-  <manager name=\"ExtensionStateList\" language=\"en_US\">\n-    <synopsis>List the current known extension states.</synopsis>\n-    <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-    </syntax>\n-    <description>\n-      <para>\n-        This will list out all known extension states in a\n-\t\t\tsequence of\n-        <replaceable>ExtensionStatus</replaceable>\n-        events.\n-\t\t\tWhen finished, a\n-        <replaceable>ExtensionStateListComplete</replaceable>\n-        event\n-\t\t\twill be emitted.\n-      </para>\n-    </description>\n-    <see-also>\n-      <ref type=\"manager\">ExtensionState</ref>\n-      <ref type=\"function\">HINT</ref>\n-      <ref type=\"function\">EXTENSION_STATE</ref>\n-    </see-also>\n-    <responses>\n-      <list-elements>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='ExtensionStatus'])\"/>\n-      </list-elements>\n-      <managerEvent name=\"ExtensionStateListComplete\" language=\"en_US\">\n-        <managerEventInstance class=\"EVENT_FLAG_COMMAND\">\n-          <synopsis>Indicates the end of the list the current known extension states.</synopsis>\n-          <syntax>\n-            <parameter name=\"EventList\">\n-              <para>Conveys the status of the event list.</para>\n-            </parameter>\n-            <parameter name=\"ListItems\">\n-              <para>Conveys the number of statuses reported.</para>\n-            </parameter>\n-          </syntax>\n-        </managerEventInstance>\n-      </managerEvent>\n-    </responses>\n-  </manager>\n-  <module language=\"en_US\" name=\"pbx_include\">\n-    <support_level>core</support_level>\n-  </module>\n-  <managerEvent language=\"en_US\" name=\"Newchannel\">\n-    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n-      <synopsis>Raised when a new channel is created.</synopsis>\n-      <syntax>\n-        <channel_snapshot/>\n-      </syntax>\n-      <see-also>\n-        <ref type=\"managerEvent\">Newstate</ref>\n-        <ref type=\"managerEvent\">Hangup</ref>\n-      </see-also>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <managerEvent language=\"en_US\" name=\"Newstate\">\n-    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n-      <synopsis>Raised when a channel's state changes.</synopsis>\n-      <syntax>\n-        <channel_snapshot/>\n-      </syntax>\n-      <see-also>\n-        <ref type=\"managerEvent\">Newchannel</ref>\n-        <ref type=\"managerEvent\">Hangup</ref>\n-      </see-also>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <managerEvent language=\"en_US\" name=\"Hangup\">\n-    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n-      <synopsis>Raised when a channel is hung up.</synopsis>\n-      <syntax>\n-        <channel_snapshot/>\n         <parameter name=\"Cause\">\n-          <para>A numeric cause code for why the channel was hung up.</para>\n-        </parameter>\n-        <parameter name=\"Cause-txt\">\n-          <para>A description of why the channel was hung up.</para>\n-        </parameter>\n-      </syntax>\n-      <see-also>\n-        <ref type=\"managerEvent\">Newchannel</ref>\n-        <ref type=\"managerEvent\">SoftHangupRequest</ref>\n-        <ref type=\"managerEvent\">HangupRequest</ref>\n-        <ref type=\"managerEvent\">Newstate</ref>\n-      </see-also>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <managerEvent language=\"en_US\" name=\"HangupRequest\">\n-    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n-      <synopsis>Raised when a hangup is requested.</synopsis>\n-      <syntax>\n-        <channel_snapshot/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='Hangup']/managerEventInstance/syntax/parameter[@name='Cause'])\"/>\n-      </syntax>\n-      <see-also>\n-        <ref type=\"managerEvent\">SoftHangupRequest</ref>\n-        <ref type=\"managerEvent\">Hangup</ref>\n-      </see-also>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <managerEvent language=\"en_US\" name=\"SoftHangupRequest\">\n-    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n-      <synopsis>Raised when a soft hangup is requested with a specific cause code.</synopsis>\n-      <syntax>\n-        <channel_snapshot/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='Hangup']/managerEventInstance/syntax/parameter[@name='Cause'])\"/>\n-      </syntax>\n-      <see-also>\n-        <ref type=\"managerEvent\">HangupRequest</ref>\n-        <ref type=\"managerEvent\">Hangup</ref>\n-      </see-also>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <managerEvent language=\"en_US\" name=\"NewExten\">\n-    <managerEventInstance class=\"EVENT_FLAG_DIALPLAN\">\n-      <synopsis>Raised when a channel enters a new context, extension, priority.</synopsis>\n-      <syntax>\n-        <channel_snapshot/>\n-        <parameter name=\"Extension\">\n-          <para>Deprecated in 12, but kept for\n-\t\t\t\t\tbackward compatability. Please use\n-\t\t\t\t\t'Exten' instead.</para>\n-        </parameter>\n-        <parameter name=\"Application\">\n-          <para>The application about to be executed.</para>\n-        </parameter>\n-        <parameter name=\"AppData\">\n-          <para>The data to be passed to the application.</para>\n-        </parameter>\n-      </syntax>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <managerEvent language=\"en_US\" name=\"NewCallerid\">\n-    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n-      <synopsis>Raised when a channel receives new Caller ID information.</synopsis>\n-      <syntax>\n-        <channel_snapshot/>\n-        <parameter name=\"CID-CallingPres\">\n-          <para>A description of the Caller ID presentation.</para>\n-        </parameter>\n-      </syntax>\n-      <see-also>\n-        <ref type=\"function\">CALLERID</ref>\n-      </see-also>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <managerEvent language=\"en_US\" name=\"NewConnectedLine\">\n-    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n-      <synopsis>Raised when a channel's connected line information is changed.</synopsis>\n-      <syntax>\n-        <channel_snapshot/>\n-      </syntax>\n-      <see-also>\n-        <ref type=\"function\">CONNECTEDLINE</ref>\n-      </see-also>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <managerEvent language=\"en_US\" name=\"NewAccountCode\">\n-    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n-      <synopsis>Raised when a Channel's AccountCode is changed.</synopsis>\n-      <syntax>\n-        <channel_snapshot/>\n-        <parameter name=\"OldAccountCode\">\n-          <para>The channel's previous account code</para>\n-        </parameter>\n-      </syntax>\n-      <see-also>\n-        <ref type=\"function\">CHANNEL</ref>\n-      </see-also>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <managerEvent language=\"en_US\" name=\"DialBegin\">\n-    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n-      <synopsis>Raised when a dial action has started.</synopsis>\n-      <syntax>\n-        <channel_snapshot/>\n-        <channel_snapshot prefix=\"Dest\"/>\n-        <parameter name=\"DialString\">\n-          <para>The non-technology specific device being dialed.</para>\n-        </parameter>\n-      </syntax>\n-      <see-also>\n-        <ref type=\"application\">Dial</ref>\n-        <ref type=\"application\">Originate</ref>\n-        <ref type=\"manager\">Originate</ref>\n-        <ref type=\"managerEvent\">DialEnd</ref>\n-      </see-also>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <managerEvent language=\"en_US\" name=\"DialState\">\n-    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n-      <synopsis>Raised when dial status has changed.</synopsis>\n-      <syntax>\n-        <channel_snapshot/>\n-        <channel_snapshot prefix=\"Dest\"/>\n-        <parameter name=\"DialStatus\">\n-          <para>The new state of the outbound dial attempt.</para>\n-          <enumlist>\n-            <enum name=\"RINGING\">\n-              <para>The outbound channel is ringing.</para>\n-            </enum>\n-            <enum name=\"PROCEEDING\">\n-              <para>The call to the outbound channel is proceeding.</para>\n-            </enum>\n-            <enum name=\"PROGRESS\">\n-              <para>Progress has been received on the outbound channel.</para>\n-            </enum>\n-          </enumlist>\n-        </parameter>\n-        <parameter name=\"Forward\" required=\"false\">\n-          <para>If the call was forwarded, where the call was\n-\t\t\t\t\tforwarded to.</para>\n+          <para>The reason the status has changed.</para>\n         </parameter>\n-      </syntax>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <managerEvent language=\"en_US\" name=\"DialEnd\">\n-    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n-      <synopsis>Raised when a dial action has completed.</synopsis>\n-      <syntax>\n-        <channel_snapshot/>\n-        <channel_snapshot prefix=\"Dest\"/>\n-        <parameter name=\"DialStatus\">\n-          <para>The result of the dial operation.</para>\n-          <enumlist>\n-            <enum name=\"ABORT\">\n-              <para>The call was aborted.</para>\n-            </enum>\n-            <enum name=\"ANSWER\">\n-              <para>The caller answered.</para>\n-            </enum>\n-            <enum name=\"BUSY\">\n-              <para>The caller was busy.</para>\n-            </enum>\n-            <enum name=\"CANCEL\">\n-              <para>The caller cancelled the call.</para>\n-            </enum>\n-            <enum name=\"CHANUNAVAIL\">\n-              <para>The requested channel is unavailable.</para>\n-            </enum>\n-            <enum name=\"CONGESTION\">\n-              <para>The called party is congested.</para>\n-            </enum>\n-            <enum name=\"CONTINUE\">\n-              <para>The dial completed, but the caller elected\n-\t\t\t\t\t\t\tto continue in the dialplan.</para>\n-            </enum>\n-            <enum name=\"GOTO\">\n-              <para>The dial completed, but the caller jumped to\n-\t\t\t\t\t\t\ta dialplan location.</para>\n-              <para>If known, the location the caller is jumping\n-\t\t\t\t\t\t\tto will be appended to the result following a\n-\t\t\t\t\t\t\t&quot;:&quot;.</para>\n-            </enum>\n-            <enum name=\"NOANSWER\">\n-              <para>The called party failed to answer.</para>\n-            </enum>\n-          </enumlist>\n+        <parameter name=\"Address\">\n+          <para>New address of the peer.</para>\n         </parameter>\n-        <parameter name=\"Forward\" required=\"false\">\n-          <para>If the call was forwarded, where the call was\n-\t\t\t\t\tforwarded to.</para>\n+        <parameter name=\"Port\">\n+          <para>New port for the peer.</para>\n         </parameter>\n-      </syntax>\n-      <see-also>\n-        <ref type=\"application\">Dial</ref>\n-        <ref type=\"application\">Originate</ref>\n-        <ref type=\"manager\">Originate</ref>\n-        <ref type=\"managerEvent\">DialBegin</ref>\n-      </see-also>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <managerEvent language=\"en_US\" name=\"Hold\">\n-    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n-      <synopsis>Raised when a channel goes on hold.</synopsis>\n-      <syntax>\n-        <channel_snapshot/>\n-        <parameter name=\"MusicClass\">\n-          <para>The suggested MusicClass, if provided.</para>\n+        <parameter name=\"Time\">\n+          <para>Time it takes to reach the peer and receive a response.</para>\n         </parameter>\n       </syntax>\n-      <see-also>\n-        <ref type=\"managerEvent\">Unhold</ref>\n-      </see-also>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <managerEvent language=\"en_US\" name=\"Unhold\">\n-    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n-      <synopsis>Raised when a channel goes off hold.</synopsis>\n-      <syntax>\n-        <channel_snapshot/>\n-      </syntax>\n-      <see-also>\n-        <ref type=\"managerEvent\">Hold</ref>\n-      </see-also>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <managerEvent language=\"en_US\" name=\"ChanSpyStart\">\n-    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n-      <synopsis>Raised when one channel begins spying on another channel.</synopsis>\n-      <syntax>\n-        <channel_snapshot prefix=\"Spyer\"/>\n-        <channel_snapshot prefix=\"Spyee\"/>\n-      </syntax>\n-      <see-also>\n-        <ref type=\"managerEvent\">ChanSpyStop</ref>\n-        <ref type=\"application\">ChanSpy</ref>\n-      </see-also>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <managerEvent language=\"en_US\" name=\"ChanSpyStop\">\n-    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n-      <synopsis>Raised when a channel has stopped spying.</synopsis>\n-      <syntax>\n-        <channel_snapshot prefix=\"Spyer\"/>\n-        <channel_snapshot prefix=\"Spyee\"/>\n-      </syntax>\n-      <see-also>\n-        <ref type=\"managerEvent\">ChanSpyStart</ref>\n-        <ref type=\"application\">ChanSpy</ref>\n-      </see-also>\n     </managerEventInstance>\n   </managerEvent>\n-  <managerEvent language=\"en_US\" name=\"HangupHandlerRun\">\n-    <managerEventInstance class=\"EVENT_FLAG_DIALPLAN\">\n-      <synopsis>Raised when a hangup handler is about to be called.</synopsis>\n+  <managerEvent language=\"en_US\" name=\"ContactStatus\">\n+    <managerEventInstance class=\"EVENT_FLAG_SYSTEM\">\n+      <synopsis>Raised when the state of a contact changes.</synopsis>\n       <syntax>\n-        <channel_snapshot/>\n-        <parameter name=\"Handler\">\n-          <para>Hangup handler parameter string passed to the Gosub application.</para>\n+        <parameter name=\"URI\">\n+          <para>This contact's URI.</para>\n         </parameter>\n-      </syntax>\n-      <see-also>\n-        <ref type=\"function\">CHANNEL</ref>\n-      </see-also>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <managerEvent language=\"en_US\" name=\"HangupHandlerPop\">\n-    <managerEventInstance class=\"EVENT_FLAG_DIALPLAN\">\n-      <synopsis>Raised when a hangup handler is removed from the handler stack\n-\t\t\t\tby the CHANNEL() function.</synopsis>\n-      <syntax>\n-        <channel_snapshot/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='HangupHandlerRun']/managerEventInstance/syntax/parameter)\"/>\n-      </syntax>\n-      <see-also>\n-        <ref type=\"managerEvent\">HangupHandlerPush</ref>\n-        <ref type=\"function\">CHANNEL</ref>\n-      </see-also>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <managerEvent language=\"en_US\" name=\"HangupHandlerPush\">\n-    <managerEventInstance class=\"EVENT_FLAG_DIALPLAN\">\n-      <synopsis>Raised when a hangup handler is added to the handler stack by\n-\t\t\t\tthe CHANNEL() function.</synopsis>\n-      <syntax>\n-        <channel_snapshot/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='HangupHandlerRun']/managerEventInstance/syntax/parameter)\"/>\n-      </syntax>\n-      <see-also>\n-        <ref type=\"managerEvent\">HangupHandlerPop</ref>\n-        <ref type=\"function\">CHANNEL</ref>\n-      </see-also>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <managerEvent language=\"en_US\" name=\"FAXStatus\">\n-    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n-      <synopsis>Raised periodically during a fax transmission.</synopsis>\n-      <syntax>\n-        <channel_snapshot/>\n-        <parameter name=\"Operation\">\n+        <parameter name=\"ContactStatus\">\n+          <para>New status of the contact.</para>\n           <enumlist>\n-            <enum name=\"gateway\"/>\n-            <enum name=\"receive\"/>\n-            <enum name=\"send\"/>\n+            <enum name=\"Unknown\"/>\n+            <enum name=\"Unreachable\"/>\n+            <enum name=\"Reachable\"/>\n+            <enum name=\"Unqualified\"/>\n+            <enum name=\"Removed\"/>\n+            <enum name=\"Updated\"/>\n           </enumlist>\n         </parameter>\n-        <parameter name=\"Status\">\n-          <para>A text message describing the current status of the fax</para>\n-        </parameter>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='ReceiveFAX']/managerEventInstance/syntax/parameter[@name='LocalStationID'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='ReceiveFAX']/managerEventInstance/syntax/parameter[@name='FileName'])\"/>\n-      </syntax>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <managerEvent language=\"en_US\" name=\"ReceiveFAX\">\n-    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n-      <synopsis>Raised when a receive fax operation has completed.</synopsis>\n-      <syntax>\n-        <channel_snapshot/>\n-        <parameter name=\"LocalStationID\">\n-          <para>\n-            The value of the\n-            <variable>LOCALSTATIONID</variable>\n-            channel variable\n-          </para>\n-        </parameter>\n-        <parameter name=\"RemoteStationID\">\n-          <para>\n-            The value of the\n-            <variable>REMOTESTATIONID</variable>\n-            channel variable\n-          </para>\n-        </parameter>\n-        <parameter name=\"PagesTransferred\">\n-          <para>The number of pages that have been transferred</para>\n-        </parameter>\n-        <parameter name=\"Resolution\">\n-          <para>The negotiated resolution</para>\n-        </parameter>\n-        <parameter name=\"TransferRate\">\n-          <para>The negotiated transfer rate</para>\n+        <parameter name=\"AOR\">\n+          <para>The name of the associated aor.</para>\n         </parameter>\n-        <parameter name=\"FileName\" multiple=\"yes\">\n-          <para>The files being affected by the fax operation</para>\n+        <parameter name=\"EndpointName\">\n+          <para>The name of the associated endpoint.</para>\n         </parameter>\n-      </syntax>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <managerEvent language=\"en_US\" name=\"SendFAX\">\n-    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n-      <synopsis>Raised when a send fax operation has completed.</synopsis>\n-      <syntax>\n-        <channel_snapshot/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='ReceiveFAX']/managerEventInstance/syntax/parameter)\"/>\n-      </syntax>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <managerEvent language=\"en_US\" name=\"MusicOnHoldStart\">\n-    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n-      <synopsis>Raised when music on hold has started on a channel.</synopsis>\n-      <syntax>\n-        <channel_snapshot/>\n-        <parameter name=\"Class\">\n-          <para>The class of music being played on the channel</para>\n+        <parameter name=\"RoundtripUsec\">\n+          <para>The RTT measured during the last qualify.</para>\n         </parameter>\n       </syntax>\n-      <see-also>\n-        <ref type=\"managerEvent\">MusicOnHoldStop</ref>\n-        <ref type=\"application\">StartMusicOnHold</ref>\n-        <ref type=\"application\">MusicOnHold</ref>\n-      </see-also>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <managerEvent language=\"en_US\" name=\"MusicOnHoldStop\">\n-    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n-      <synopsis>Raised when music on hold has stopped on a channel.</synopsis>\n-      <syntax>\n-        <channel_snapshot/>\n-      </syntax>\n-      <see-also>\n-        <ref type=\"managerEvent\">MusicOnHoldStart</ref>\n-        <ref type=\"application\">StopMusicOnHold</ref>\n-      </see-also>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <managerEvent language=\"en_US\" name=\"MonitorStart\">\n-    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n-      <synopsis>Raised when monitoring has started on a channel.</synopsis>\n-      <syntax>\n-        <channel_snapshot/>\n-      </syntax>\n-      <see-also>\n-        <ref type=\"managerEvent\">MonitorStop</ref>\n-        <ref type=\"application\">Monitor</ref>\n-        <ref type=\"manager\">Monitor</ref>\n-      </see-also>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <managerEvent language=\"en_US\" name=\"MonitorStop\">\n-    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n-      <synopsis>Raised when monitoring has stopped on a channel.</synopsis>\n-      <syntax>\n-        <channel_snapshot/>\n-      </syntax>\n-      <see-also>\n-        <ref type=\"managerEvent\">MonitorStart</ref>\n-        <ref type=\"application\">StopMonitor</ref>\n-        <ref type=\"manager\">StopMonitor</ref>\n-      </see-also>\n     </managerEventInstance>\n   </managerEvent>\n+  <module language=\"en_US\" name=\"channel\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"config_options\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"bridge_channel\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"bridge_after\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"app\">\n+    <support_level>core</support_level>\n+  </module>\n   <module language=\"en_US\" name=\"rtp_engine\">\n     <support_level>core</support_level>\n   </module>\n   <managerEvent language=\"en_US\" name=\"RTCPSent\">\n     <managerEventInstance class=\"EVENT_FLAG_REPORTING\">\n       <synopsis>Raised when an RTCP packet is sent.</synopsis>\n       <syntax>\n@@ -24660,210 +25268,275 @@\n         <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='RTCPSent']/managerEventInstance/syntax/parameter[contains(@name, 'ReportX')])\"/>\n       </syntax>\n       <see-also>\n         <ref type=\"managerEvent\">RTCPSent</ref>\n       </see-also>\n     </managerEventInstance>\n   </managerEvent>\n-  <module language=\"en_US\" name=\"taskprocessor\">\n+  <module language=\"en_US\" name=\"astfd\">\n     <support_level>core</support_level>\n   </module>\n-  <configInfo name=\"named_acl\" language=\"en_US\">\n-    <configFile name=\"named_acl.conf\">\n-      <configObject name=\"named_acl\">\n-        <synopsis>Options for configuring a named ACL</synopsis>\n-        <configOption name=\"permit\">\n-          <synopsis>An address/subnet from which to allow access</synopsis>\n+  <module language=\"en_US\" name=\"cdr\">\n+    <support_level>core</support_level>\n+  </module>\n+  <configInfo name=\"cdr\" language=\"en_US\">\n+    <synopsis>Call Detail Record configuration</synopsis>\n+    <description>\n+      <para>CDR is Call Detail Record, which provides logging services via a variety of\n+\t\t\tpluggable backend modules. Detailed call information can be recorded to\n+\t\t\tdatabases, files, etc. Useful for billing, fraud prevention, compliance with\n+\t\t\tSarbanes-Oxley aka The Enron Act, QOS evaluations, and more.</para>\n+    </description>\n+    <configFile name=\"cdr.conf\">\n+      <configObject name=\"general\">\n+        <synopsis>Global settings applied to the CDR engine.</synopsis>\n+        <configOption name=\"debug\">\n+          <synopsis>Enable/disable verbose CDR debugging.</synopsis>\n+          <description>\n+            <para>\n+              When set to\n+              <literal>True</literal>\n+              , verbose updates\n+\t\t\t\t\tof changes in CDR information will be logged. Note that this is only\n+\t\t\t\t\tof use when debugging CDR behavior.\n+            </para>\n+          </description>\n         </configOption>\n-        <configOption name=\"deny\">\n-          <synopsis>An address/subnet from which to disallow access</synopsis>\n+        <configOption name=\"enable\" default=\"yes\">\n+          <synopsis>Enable/disable CDR logging.</synopsis>\n+          <description>\n+            <para>Define whether or not to use CDR logging. Setting this to &quot;no&quot; will override\n+\t\t\t\t\tany loading of backend CDR modules.</para>\n+          </description>\n+        </configOption>\n+        <configOption name=\"channeldefaultenabled\" default=\"yes\">\n+          <synopsis>Whether CDR is enabled on a channel by default</synopsis>\n+          <description>\n+            <para>Define whether or not CDR should be enabled on a channel by default.\n+\t\t\t\t\tSetting this to &quot;yes&quot; will enable CDR on every channel unless it is explicitly disabled.\n+\t\t\t\t\tSetting this to &quot;no&quot; will disable CDR on every channel unless it is explicitly enabled.</para>\n+            <para>\n+              Note that CDR must still be globally enabled (\n+              <literal>enable = yes</literal>\n+              ) for this\n+\t\t\t\t\toption to have any effect. This only applies to whether CDR is enabled or disabled on\n+\t\t\t\t\tnewly created channels, which can be changed in the dialplan during a call.\n+            </para>\n+            <para>\n+              If this is set to &quot;yes&quot;, you should use\n+              <literal>Set(CDR_PROP(disable)=1)</literal>\n+              to disable CDR for a call.\n+            </para>\n+            <para>\n+              If this is set to &quot;no&quot;, you should use\n+              <literal>Set(CDR_PROP(disable)=0)</literal>\n+              to undisable (enable) CDR for a call.\n+            </para>\n+          </description>\n+        </configOption>\n+        <configOption name=\"unanswered\">\n+          <synopsis>Log calls that are never answered and don't set an outgoing party.</synopsis>\n+          <description>\n+            <para>Define whether or not to log unanswered calls that don't involve an outgoing party. Setting\n+\t\t\t\t\tthis to &quot;yes&quot; will make calls to extensions that don't answer and don't set a side B channel\n+\t\t\t\t\t(such as by using the Dial application) receive CDR log entries. If this option is set to\n+\t\t\t\t\t&quot;no&quot;, then those log entries will not be created. Unanswered calls which get offered to an\n+\t\t\t\t\toutgoing line will always receive log entries regardless of this option, and that is the\n+\t\t\t\t\tintended behavior.</para>\n+          </description>\n+        </configOption>\n+        <configOption name=\"congestion\">\n+          <synopsis>Log congested calls.</synopsis>\n+          <description>\n+            <para>Define whether or not to log congested calls. Setting this to &quot;yes&quot; will\n+\t\t\t\t\treport each call that fails to complete due to congestion conditions.</para>\n+          </description>\n+        </configOption>\n+        <configOption name=\"endbeforehexten\">\n+          <synopsis>Don't produce CDRs while executing hangup logic</synopsis>\n+          <description>\n+            <para>\n+              As each CDR for a channel is finished, its end time is updated\n+\t\t\t\t\t\tand the CDR is finalized. When a channel is hung up and hangup\n+\t\t\t\t\t\tlogic is present (in the form of a hangup handler or the\n+              <literal>h</literal>\n+              extension), a new CDR is generated for the\n+\t\t\t\t\t\tchannel. Any statistics are gathered from this new CDR. By enabling\n+\t\t\t\t\t\tthis option, no new CDR is created for the dialplan logic that is\n+\t\t\t\t\t\texecuted in\n+              <literal>h</literal>\n+              extensions or attached hangup handler\n+\t\t\t\t\t\tsubroutines. The default value is\n+              <literal>yes</literal>\n+              , indicating\n+\t\t\t\t\t\tthat a CDR will be generated during hangup logic.\n+            </para>\n+          </description>\n+        </configOption>\n+        <configOption name=\"initiatedseconds\">\n+          <synopsis>Count microseconds for billsec purposes</synopsis>\n+          <description>\n+            <para>\n+              Normally, the\n+              <literal>billsec</literal>\n+              field logged to the CDR backends\n+\t\t\t\t\tis simply the end time (hangup time) minus the answer time in seconds. Internally,\n+\t\t\t\t\tasterisk stores the time in terms of microseconds and seconds. By setting\n+\t\t\t\t\tinitiatedseconds to\n+              <literal>yes</literal>\n+              , you can force asterisk to report any seconds\n+\t\t\t\t\tthat were initiated (a sort of round up method). Technically, this is\n+\t\t\t\t\twhen the microsecond part of the end time is greater than the microsecond\n+\t\t\t\t\tpart of the answer time, then the billsec time is incremented one second.\n+            </para>\n+          </description>\n+        </configOption>\n+        <configOption name=\"batch\">\n+          <synopsis>Submit CDRs to the backends for processing in batches</synopsis>\n+          <description>\n+            <para>Define the CDR batch mode, where instead of posting the CDR at the end of\n+\t\t\t\t\tevery call, the data will be stored in a buffer to help alleviate load on the\n+\t\t\t\t\tasterisk server.</para>\n+            <warning>\n+              <para>Use of batch mode may result in data loss after unsafe asterisk termination,\n+\t\t\t\t\ti.e., software crash, power failure, kill -9, etc.</para>\n+            </warning>\n+          </description>\n+        </configOption>\n+        <configOption name=\"size\">\n+          <synopsis>The maximum number of CDRs to accumulate before triggering a batch</synopsis>\n+          <description>\n+            <para>\n+              Define the maximum number of CDRs to accumulate in the buffer before posting\n+\t\t\t\t\tthem to the backend engines. batch must be set to\n+              <literal>yes</literal>\n+              .\n+            </para>\n+          </description>\n+        </configOption>\n+        <configOption name=\"time\">\n+          <synopsis>The maximum time to accumulate CDRs before triggering a batch</synopsis>\n+          <description>\n+            <para>\n+              Define the maximum time to accumulate CDRs before posting them in a batch to the\n+\t\t\t\t\tbackend engines. If this time limit is reached, then it will post the records, regardless of the value\n+\t\t\t\t\tdefined for size. batch must be set to\n+              <literal>yes</literal>\n+              .\n+            </para>\n+            <note>\n+              <para>Time is expressed in seconds.</para>\n+            </note>\n+          </description>\n+        </configOption>\n+        <configOption name=\"scheduleronly\">\n+          <synopsis>Post batched CDRs on their own thread instead of the scheduler</synopsis>\n+          <description>\n+            <para>\n+              The CDR engine uses the internal asterisk scheduler to determine when to post\n+\t\t\t\t\trecords.  Posting can either occur inside the scheduler thread, or a new\n+\t\t\t\t\tthread can be spawned for the submission of every batch.  For small batches,\n+\t\t\t\t\tit might be acceptable to just use the scheduler thread, so set this to\n+              <literal>yes</literal>\n+              .\n+\t\t\t\t\tFor large batches, say anything over size=10, a new thread is recommended, so\n+\t\t\t\t\tset this to\n+              <literal>no</literal>\n+              .\n+            </para>\n+          </description>\n+        </configOption>\n+        <configOption name=\"safeshutdown\">\n+          <synopsis>Block shutdown of Asterisk until CDRs are submitted</synopsis>\n+          <description>\n+            <para>\n+              When shutting down asterisk, you can block until the CDRs are submitted.  If\n+\t\t\t\t\tyou don't, then data will likely be lost.  You can always check the size of\n+\t\t\t\t\tthe CDR batch buffer with the CLI\n+              <astcli>cdr status</astcli>\n+              command.  To enable blocking on\n+\t\t\t\t\tsubmission of CDR data during asterisk shutdown, set this to\n+              <literal>yes</literal>\n+              .\n+            </para>\n+          </description>\n         </configOption>\n       </configObject>\n     </configFile>\n   </configInfo>\n-  <module language=\"en_US\" name=\"format_compatibility\">\n+  <module language=\"en_US\" name=\"io\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"endpoints\">\n+  <module language=\"en_US\" name=\"localtime\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"time\">\n+  <module language=\"en_US\" name=\"autochan\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"aoc\">\n+  <module language=\"en_US\" name=\"chanvars\">\n     <support_level>core</support_level>\n   </module>\n-  <managerEvent language=\"en_US\" name=\"AOC-S\">\n-    <managerEventInstance class=\"EVENT_FLAG_AOC\">\n-      <synopsis>Raised when an Advice of Charge message is sent at the beginning of a call.</synopsis>\n-      <syntax>\n-        <channel_snapshot/>\n-        <parameter name=\"Chargeable\"/>\n-        <parameter name=\"RateType\">\n-          <enumlist>\n-            <enum name=\"NotAvailable\"/>\n-            <enum name=\"Free\"/>\n-            <enum name=\"FreeFromBeginning\"/>\n-            <enum name=\"Duration\"/>\n-            <enum name=\"Flag\"/>\n-            <enum name=\"Volume\"/>\n-            <enum name=\"SpecialCode\"/>\n-          </enumlist>\n-        </parameter>\n-        <parameter name=\"Currency\"/>\n-        <parameter name=\"Name\"/>\n-        <parameter name=\"Cost\"/>\n-        <parameter name=\"Multiplier\">\n-          <enumlist>\n-            <enum name=\"1/1000\"/>\n-            <enum name=\"1/100\"/>\n-            <enum name=\"1/10\"/>\n-            <enum name=\"1\"/>\n-            <enum name=\"10\"/>\n-            <enum name=\"100\"/>\n-            <enum name=\"1000\"/>\n-          </enumlist>\n-        </parameter>\n-        <parameter name=\"ChargingType\"/>\n-        <parameter name=\"StepFunction\"/>\n-        <parameter name=\"Granularity\"/>\n-        <parameter name=\"Length\"/>\n-        <parameter name=\"Scale\"/>\n-        <parameter name=\"Unit\">\n-          <enumlist>\n-            <enum name=\"Octect\"/>\n-            <enum name=\"Segment\"/>\n-            <enum name=\"Message\"/>\n-          </enumlist>\n-        </parameter>\n-        <parameter name=\"SpecialCode\"/>\n-      </syntax>\n-      <see-also>\n-        <ref type=\"managerEvent\">AOC-D</ref>\n-        <ref type=\"managerEvent\">AOC-E</ref>\n-      </see-also>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <managerEvent language=\"en_US\" name=\"AOC-D\">\n-    <managerEventInstance class=\"EVENT_FLAG_AOC\">\n-      <synopsis>Raised when an Advice of Charge message is sent during a call.</synopsis>\n+  <module language=\"en_US\" name=\"pbx_ignorepat\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"presencestate\">\n+    <support_level>core</support_level>\n+  </module>\n+  <managerEvent language=\"en_US\" name=\"PresenceStateChange\">\n+    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n+      <synopsis>Raised when a presence state changes</synopsis>\n       <syntax>\n-        <channel_snapshot/>\n-        <parameter name=\"Charge\"/>\n-        <parameter name=\"Type\">\n-          <enumlist>\n-            <enum name=\"NotAvailable\"/>\n-            <enum name=\"Free\"/>\n-            <enum name=\"Currency\"/>\n-            <enum name=\"Units\"/>\n-          </enumlist>\n+        <parameter name=\"Presentity\">\n+          <para>The entity whose presence state has changed</para>\n         </parameter>\n-        <parameter name=\"BillingID\">\n-          <enumlist>\n-            <enum name=\"Normal\"/>\n-            <enum name=\"Reverse\"/>\n-            <enum name=\"CreditCard\"/>\n-            <enum name=\"CallForwardingUnconditional\"/>\n-            <enum name=\"CallForwardingBusy\"/>\n-            <enum name=\"CallForwardingNoReply\"/>\n-            <enum name=\"CallDeflection\"/>\n-            <enum name=\"CallTransfer\"/>\n-            <enum name=\"NotAvailable\"/>\n-          </enumlist>\n+        <parameter name=\"Status\">\n+          <para>The new status of the presentity</para>\n         </parameter>\n-        <parameter name=\"TotalType\">\n-          <enumlist>\n-            <enum name=\"SubTotal\"/>\n-            <enum name=\"Total\"/>\n-          </enumlist>\n+        <parameter name=\"Subtype\">\n+          <para>The new subtype of the presentity</para>\n         </parameter>\n-        <parameter name=\"Currency\"/>\n-        <parameter name=\"Name\"/>\n-        <parameter name=\"Cost\"/>\n-        <parameter name=\"Multiplier\">\n-          <enumlist>\n-            <enum name=\"1/1000\"/>\n-            <enum name=\"1/100\"/>\n-            <enum name=\"1/10\"/>\n-            <enum name=\"1\"/>\n-            <enum name=\"10\"/>\n-            <enum name=\"100\"/>\n-            <enum name=\"1000\"/>\n-          </enumlist>\n+        <parameter name=\"Message\">\n+          <para>The new message of the presentity</para>\n         </parameter>\n-        <parameter name=\"Units\"/>\n-        <parameter name=\"NumberOf\"/>\n-        <parameter name=\"TypeOf\"/>\n-      </syntax>\n-      <see-also>\n-        <ref type=\"manager\">AOCMessage</ref>\n-        <ref type=\"managerEvent\">AOC-S</ref>\n-        <ref type=\"managerEvent\">AOC-E</ref>\n-      </see-also>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <managerEvent language=\"en_US\" name=\"AOC-E\">\n-    <managerEventInstance class=\"EVENT_FLAG_AOC\">\n-      <synopsis>Raised when an Advice of Charge message is sent at the end of a call.</synopsis>\n-      <syntax>\n-        <channel_snapshot/>\n-        <parameter name=\"ChargingAssociation\"/>\n-        <parameter name=\"Number\"/>\n-        <parameter name=\"Plan\"/>\n-        <parameter name=\"ID\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='AOC-D']/managerEventInstance/syntax/parameter)\"/>\n       </syntax>\n+      <description>\n+        <para>\n+          This differs from the\n+          <literal>PresenceStatus</literal>\n+          event because this event is raised for all presence state changes,\n+\t\t\t\tnot only for changes that affect dialplan hints.\n+        </para>\n+      </description>\n       <see-also>\n-        <ref type=\"manager\">AOCMessage</ref>\n-        <ref type=\"managerEvent\">AOC-S</ref>\n-        <ref type=\"managerEvent\">AOC-D</ref>\n+        <ref type=\"managerEvent\">PresenceStatus</ref>\n       </see-also>\n     </managerEventInstance>\n   </managerEvent>\n-  <module language=\"en_US\" name=\"udptl\">\n+  <module language=\"en_US\" name=\"format_compatibility\">\n     <support_level>core</support_level>\n   </module>\n-  <configInfo name=\"udptl\" language=\"en_US\">\n-    <configFile name=\"udptl.conf\">\n-      <configObject name=\"global\">\n-        <synopsis>Global options for configuring UDPTL</synopsis>\n-        <configOption name=\"udptlstart\">\n-          <synopsis>The start of the UDPTL port range</synopsis>\n-        </configOption>\n-        <configOption name=\"udptlend\">\n-          <synopsis>The end of the UDPTL port range</synopsis>\n-        </configOption>\n-        <configOption name=\"udptlchecksums\">\n-          <synopsis>Whether to enable or disable UDP checksums on UDPTL traffic</synopsis>\n-        </configOption>\n-        <configOption name=\"udptlfecentries\">\n-          <synopsis>The number of error correction entries in a UDPTL packet</synopsis>\n-        </configOption>\n-        <configOption name=\"udptlfecspan\">\n-          <synopsis>The span over which parity is calculated for FEC in a UDPTL packet</synopsis>\n-        </configOption>\n-        <configOption name=\"use_even_ports\">\n-          <synopsis>Whether to only use even-numbered UDPTL ports</synopsis>\n-        </configOption>\n-        <configOption name=\"t38faxudpec\">\n-          <synopsis>Removed</synopsis>\n-        </configOption>\n-        <configOption name=\"t38faxmaxdatagram\">\n-          <synopsis>Removed</synopsis>\n-        </configOption>\n-      </configObject>\n-    </configFile>\n-  </configInfo>\n-  <module language=\"en_US\" name=\"codec_builtin\">\n+  <module language=\"en_US\" name=\"datastore\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"format_cap\">\n+  <module language=\"en_US\" name=\"mwi\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"privacy\">\n+  <module language=\"en_US\" name=\"pbx_functions\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"translate\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"dns_query_set\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"mixmonitor\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"fskmodem\">\n     <support_level>core</support_level>\n   </module>\n   <module language=\"en_US\" name=\"core_local\">\n     <support_level>core</support_level>\n   </module>\n   <manager name=\"LocalOptimizeAway\" language=\"en_US\">\n     <synopsis>Optimize away a local channel when possible.</synopsis>\n@@ -24942,2176 +25615,1942 @@\n       </syntax>\n       <see-also>\n         <ref type=\"managerEvent\">LocalOptimizationBegin</ref>\n         <ref type=\"manager\">LocalOptimizeAway</ref>\n       </see-also>\n     </managerEventInstance>\n   </managerEvent>\n-  <module language=\"en_US\" name=\"format_cache\">\n+  <module language=\"en_US\" name=\"global_datastores\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"stream\">\n+  <module language=\"en_US\" name=\"codec_builtin\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"stasis_cache\">\n+  <module language=\"en_US\" name=\"pbx_include\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"conversions\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"pickup\">\n+    <support_level>core</support_level>\n+  </module>\n+  <managerEvent language=\"en_US\" name=\"Pickup\">\n+    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n+      <synopsis>Raised when a call pickup occurs.</synopsis>\n+      <syntax>\n+        <channel_snapshot/>\n+        <channel_snapshot prefix=\"Target\"/>\n+      </syntax>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <module language=\"en_US\" name=\"dsp\">\n     <support_level>core</support_level>\n   </module>\n   <module language=\"en_US\" name=\"audiohook\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"mwi\">\n+  <module language=\"en_US\" name=\"time\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"plc\">\n+  <module language=\"en_US\" name=\"heap\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"sorcery\">\n+  <module language=\"en_US\" name=\"stasis_message\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"security_events\">\n+  <module language=\"en_US\" name=\"stasis_bridges\">\n     <support_level>core</support_level>\n   </module>\n-  <managerEvent language=\"en_US\" name=\"FailedACL\">\n-    <managerEventInstance class=\"EVENT_FLAG_SECURITY\">\n-      <synopsis>Raised when a request violates an ACL check.</synopsis>\n+  <managerEvent language=\"en_US\" name=\"BlindTransfer\">\n+    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n+      <synopsis>Raised when a blind transfer is complete.</synopsis>\n       <syntax>\n-        <parameter name=\"EventTV\">\n-          <para>The time the event was detected.</para>\n-        </parameter>\n-        <parameter name=\"Severity\">\n-          <para>A relative severity of the security event.</para>\n+        <parameter name=\"Result\">\n+          <para>Indicates if the transfer was successful or if it failed.</para>\n           <enumlist>\n-            <enum name=\"Informational\"/>\n-            <enum name=\"Error\"/>\n+            <enum name=\"Fail\">\n+              <para>An internal error occurred.</para>\n+            </enum>\n+            <enum name=\"Invalid\">\n+              <para>Invalid configuration for transfer (e.g. Not bridged)</para>\n+            </enum>\n+            <enum name=\"Not Permitted\">\n+              <para>Bridge does not permit transfers</para>\n+            </enum>\n+            <enum name=\"Success\">\n+              <para>Transfer completed successfully</para>\n+            </enum>\n           </enumlist>\n+          <note>\n+            <para>\n+              A result of\n+              <literal>Success</literal>\n+              does not necessarily mean that a target was succesfully\n+\t\t\t\t\tcontacted. It means that a party was succesfully placed into the dialplan at the expected location.\n+            </para>\n+          </note>\n         </parameter>\n-        <parameter name=\"Service\">\n-          <para>The Asterisk service that raised the security event.</para>\n-        </parameter>\n-        <parameter name=\"EventVersion\">\n-          <para>The version of this event.</para>\n-        </parameter>\n-        <parameter name=\"AccountID\">\n-          <para>The Service account associated with the security event\n-\t\t\t\t\tnotification.</para>\n-        </parameter>\n-        <parameter name=\"SessionID\">\n-          <para>A unique identifier for the session in the service\n-\t\t\t\t\tthat raised the event.</para>\n-        </parameter>\n-        <parameter name=\"LocalAddress\">\n-          <para>The address of the Asterisk service that raised the\n-\t\t\t\t\tsecurity event.</para>\n-        </parameter>\n-        <parameter name=\"RemoteAddress\">\n-          <para>The remote address of the entity that caused the\n-\t\t\t\t\tsecurity event to be raised.</para>\n-        </parameter>\n-        <parameter name=\"Module\" required=\"false\">\n-          <para>If available, the name of the module that raised the event.</para>\n-        </parameter>\n-        <parameter name=\"ACLName\" required=\"false\">\n-          <para>If available, the name of the ACL that failed.</para>\n-        </parameter>\n-        <parameter name=\"SessionTV\" required=\"false\">\n-          <para>The timestamp reported by the session.</para>\n-        </parameter>\n-      </syntax>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <managerEvent language=\"en_US\" name=\"InvalidAccountID\">\n-    <managerEventInstance class=\"EVENT_FLAG_SECURITY\">\n-      <synopsis>Raised when a request fails an authentication check due to an invalid account ID.</synopsis>\n-      <syntax>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='EventTV'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Severity'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Service'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='EventVersion'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='AccountID'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='SessionID'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='LocalAddress'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='RemoteAddress'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Module'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='SessionTV'])\"/>\n-      </syntax>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <managerEvent language=\"en_US\" name=\"SessionLimit\">\n-    <managerEventInstance class=\"EVENT_FLAG_SECURITY\">\n-      <synopsis>Raised when a request fails due to exceeding the number of allowed concurrent sessions for that service.</synopsis>\n-      <syntax>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='EventTV'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Severity'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Service'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='EventVersion'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='AccountID'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='SessionID'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='LocalAddress'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='RemoteAddress'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Module'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='SessionTV'])\"/>\n-      </syntax>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <managerEvent language=\"en_US\" name=\"MemoryLimit\">\n-    <managerEventInstance class=\"EVENT_FLAG_SECURITY\">\n-      <synopsis>Raised when a request fails due to an internal memory allocation failure.</synopsis>\n-      <syntax>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='EventTV'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Severity'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Service'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='EventVersion'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='AccountID'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='SessionID'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='LocalAddress'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='RemoteAddress'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Module'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='SessionTV'])\"/>\n-      </syntax>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <managerEvent language=\"en_US\" name=\"LoadAverageLimit\">\n-    <managerEventInstance class=\"EVENT_FLAG_SECURITY\">\n-      <synopsis>Raised when a request fails because a configured load average limit has been reached.</synopsis>\n-      <syntax>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='EventTV'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Severity'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Service'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='EventVersion'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='AccountID'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='SessionID'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='LocalAddress'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='RemoteAddress'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Module'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='SessionTV'])\"/>\n-      </syntax>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <managerEvent language=\"en_US\" name=\"RequestNotSupported\">\n-    <managerEventInstance class=\"EVENT_FLAG_SECURITY\">\n-      <synopsis>Raised when a request fails due to some aspect of the requested item not being supported by the service.</synopsis>\n-      <syntax>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='EventTV'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Severity'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Service'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='EventVersion'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='AccountID'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='SessionID'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='LocalAddress'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='RemoteAddress'])\"/>\n-        <parameter name=\"RequestType\">\n-          <para>The type of request attempted.</para>\n-        </parameter>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Module'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='SessionTV'])\"/>\n-      </syntax>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <managerEvent language=\"en_US\" name=\"RequestNotAllowed\">\n-    <managerEventInstance class=\"EVENT_FLAG_SECURITY\">\n-      <synopsis>Raised when a request is not allowed by the service.</synopsis>\n-      <syntax>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='EventTV'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Severity'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Service'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='EventVersion'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='AccountID'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='SessionID'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='LocalAddress'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='RemoteAddress'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='RequestNotSupported']/managerEventInstance/syntax/parameter[@name='RequestType'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Module'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='SessionTV'])\"/>\n-        <parameter name=\"RequestParams\" required=\"false\">\n-          <para>Parameters provided to the rejected request.</para>\n-        </parameter>\n-      </syntax>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <managerEvent language=\"en_US\" name=\"AuthMethodNotAllowed\">\n-    <managerEventInstance class=\"EVENT_FLAG_SECURITY\">\n-      <synopsis>Raised when a request used an authentication method not allowed by the service.</synopsis>\n-      <syntax>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='EventTV'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Severity'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Service'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='EventVersion'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='AccountID'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='SessionID'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='LocalAddress'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='RemoteAddress'])\"/>\n-        <parameter name=\"AuthMethod\">\n-          <para>The authentication method attempted.</para>\n-        </parameter>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Module'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='SessionTV'])\"/>\n-      </syntax>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <managerEvent language=\"en_US\" name=\"RequestBadFormat\">\n-    <managerEventInstance class=\"EVENT_FLAG_SECURITY\">\n-      <synopsis>Raised when a request is received with bad formatting.</synopsis>\n-      <syntax>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='EventTV'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Severity'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Service'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='EventVersion'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='AccountID'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='SessionID'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='LocalAddress'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='RemoteAddress'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='RequestNotSupported']/managerEventInstance/syntax/parameter[@name='RequestType'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Module'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='SessionTV'])\"/>\n-        <parameter name=\"AccountID\" required=\"false\">\n-          <para>The account ID associated with the rejected request.</para>\n-        </parameter>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='RequestNotAllowed']/managerEventInstance/syntax/parameter[@name='RequestParams'])\"/>\n-      </syntax>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <managerEvent language=\"en_US\" name=\"SuccessfulAuth\">\n-    <managerEventInstance class=\"EVENT_FLAG_SECURITY\">\n-      <synopsis>Raised when a request successfully authenticates with a service.</synopsis>\n-      <syntax>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='EventTV'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Severity'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Service'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='EventVersion'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='AccountID'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='SessionID'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='LocalAddress'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='RemoteAddress'])\"/>\n-        <parameter name=\"UsingPassword\">\n-          <para>Whether or not the authentication attempt included a password.</para>\n-        </parameter>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Module'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='SessionTV'])\"/>\n-      </syntax>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <managerEvent language=\"en_US\" name=\"UnexpectedAddress\">\n-    <managerEventInstance class=\"EVENT_FLAG_SECURITY\">\n-      <synopsis>Raised when a request has a different source address then what is expected for a session already in progress with a service.</synopsis>\n-      <syntax>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='EventTV'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Severity'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Service'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='EventVersion'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='AccountID'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='SessionID'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='LocalAddress'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='RemoteAddress'])\"/>\n-        <parameter name=\"ExpectedAddress\">\n-          <para>The address that the request was expected to use.</para>\n-        </parameter>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Module'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='SessionTV'])\"/>\n-      </syntax>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <managerEvent language=\"en_US\" name=\"ChallengeResponseFailed\">\n-    <managerEventInstance class=\"EVENT_FLAG_SECURITY\">\n-      <synopsis>Raised when a request's attempt to authenticate has been challenged, and the request failed the authentication challenge.</synopsis>\n-      <syntax>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='EventTV'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Severity'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Service'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='EventVersion'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='AccountID'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='SessionID'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='LocalAddress'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='RemoteAddress'])\"/>\n-        <parameter name=\"Challenge\">\n-          <para>The challenge that was sent.</para>\n+        <channel_snapshot prefix=\"Transferer\"/>\n+        <channel_snapshot prefix=\"Transferee\"/>\n+        <bridge_snapshot/>\n+        <parameter name=\"IsExternal\">\n+          <para>Indicates if the transfer was performed outside of Asterisk. For instance,\n+\t\t\t\t\ta channel protocol native transfer is external. A DTMF transfer is internal.</para>\n+          <enumlist>\n+            <enum name=\"Yes\"/>\n+            <enum name=\"No\"/>\n+          </enumlist>\n         </parameter>\n-        <parameter name=\"Response\">\n-          <para>The response that was received.</para>\n+        <parameter name=\"Context\">\n+          <para>Destination context for the blind transfer.</para>\n         </parameter>\n-        <parameter name=\"ExpectedResponse\">\n-          <para>The expected response to the challenge.</para>\n+        <parameter name=\"Extension\">\n+          <para>Destination extension for the blind transfer.</para>\n         </parameter>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Module'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='SessionTV'])\"/>\n       </syntax>\n+      <see-also>\n+        <ref type=\"manager\">BlindTransfer</ref>\n+      </see-also>\n     </managerEventInstance>\n   </managerEvent>\n-  <managerEvent language=\"en_US\" name=\"InvalidPassword\">\n-    <managerEventInstance class=\"EVENT_FLAG_SECURITY\">\n-      <synopsis>Raised when a request provides an invalid password during an authentication attempt.</synopsis>\n+  <managerEvent language=\"en_US\" name=\"AttendedTransfer\">\n+    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n+      <synopsis>Raised when an attended transfer is complete.</synopsis>\n       <syntax>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='EventTV'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Severity'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Service'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='EventVersion'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='AccountID'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='SessionID'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='LocalAddress'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='RemoteAddress'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Module'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='SessionTV'])\"/>\n-        <parameter name=\"Challenge\" required=\"false\">\n-          <para>The challenge that was sent.</para>\n-        </parameter>\n-        <parameter name=\"ReceivedChallenge\" required=\"false\">\n-          <para>The challenge that was received.</para>\n-        </parameter>\n-        <parameter name=\"ReceivedHash\" required=\"false\">\n-          <para>The hash that was received.</para>\n+        <xi:include xpointer=\"xpointer(docs/managerEvent[@name='BlindTransfer']/managerEventInstance/syntax/parameter[@name='Result'])\"/>\n+        <channel_snapshot prefix=\"OrigTransferer\"/>\n+        <bridge_snapshot prefix=\"Orig\"/>\n+        <channel_snapshot prefix=\"SecondTransferer\"/>\n+        <bridge_snapshot prefix=\"Second\"/>\n+        <parameter name=\"DestType\">\n+          <para>Indicates the method by which the attended transfer completed.</para>\n+          <enumlist>\n+            <enum name=\"Bridge\">\n+              <para>The transfer was accomplished by merging two bridges into one.</para>\n+            </enum>\n+            <enum name=\"App\">\n+              <para>The transfer was accomplished by having a channel or bridge run a dialplan application.</para>\n+            </enum>\n+            <enum name=\"Link\">\n+              <para>The transfer was accomplished by linking two bridges together using a local channel pair.</para>\n+            </enum>\n+            <enum name=\"Threeway\">\n+              <para>The transfer was accomplished by placing all parties into a threeway call.</para>\n+            </enum>\n+            <enum name=\"Fail\">\n+              <para>The transfer failed.</para>\n+            </enum>\n+          </enumlist>\n         </parameter>\n-      </syntax>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <managerEvent language=\"en_US\" name=\"ChallengeSent\">\n-    <managerEventInstance class=\"EVENT_FLAG_SECURITY\">\n-      <synopsis>Raised when an Asterisk service sends an authentication challenge to a request.</synopsis>\n-      <syntax>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='EventTV'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Severity'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Service'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='EventVersion'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='AccountID'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='SessionID'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='LocalAddress'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='RemoteAddress'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='ChallengeResponseFailed']/managerEventInstance/syntax/parameter[@name='Challenge'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Module'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='SessionTV'])\"/>\n-      </syntax>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <managerEvent language=\"en_US\" name=\"InvalidTransport\">\n-    <managerEventInstance class=\"EVENT_FLAG_SECURITY\">\n-      <synopsis>Raised when a request attempts to use a transport not allowed by the Asterisk service.</synopsis>\n-      <syntax>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='EventTV'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Severity'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Service'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='EventVersion'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='AccountID'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='SessionID'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='LocalAddress'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='RemoteAddress'])\"/>\n-        <parameter name=\"AttemptedTransport\">\n-          <para>The transport type that the request attempted to use.</para>\n+        <parameter name=\"DestBridgeUniqueid\">\n+          <para>Indicates the surviving bridge when bridges were merged to complete the transfer</para>\n+          <note>\n+            <para>\n+              This header is only present when\n+              <replaceable>DestType</replaceable>\n+              is\n+              <literal>Bridge</literal>\n+              or\n+              <literal>Threeway</literal>\n+            </para>\n+          </note>\n         </parameter>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='Module'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FailedACL']/managerEventInstance/syntax/parameter[@name='SessionTV'])\"/>\n-      </syntax>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <module language=\"en_US\" name=\"devicestate\">\n-    <support_level>core</support_level>\n-  </module>\n-  <managerEvent language=\"en_US\" name=\"DeviceStateChange\">\n-    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n-      <synopsis>Raised when a device state changes</synopsis>\n-      <syntax>\n-        <parameter name=\"Device\">\n-          <para>The device whose state has changed</para>\n+        <parameter name=\"DestApp\">\n+          <para>Indicates the application that is running when the transfer completes</para>\n+          <note>\n+            <para>\n+              This header is only present when\n+              <replaceable>DestType</replaceable>\n+              is\n+              <literal>App</literal>\n+            </para>\n+          </note>\n         </parameter>\n-        <parameter name=\"State\">\n-          <para>The new state of the device</para>\n+        <channel_snapshot prefix=\"LocalOne\"/>\n+        <channel_snapshot prefix=\"LocalTwo\"/>\n+        <parameter name=\"DestTransfererChannel\">\n+          <para>The name of the surviving transferer channel when a transfer results in a threeway call</para>\n+          <note>\n+            <para>\n+              This header is only present when\n+              <replaceable>DestType</replaceable>\n+              is\n+              <literal>Threeway</literal>\n+            </para>\n+          </note>\n         </parameter>\n+        <channel_snapshot prefix=\"Transferee\"/>\n       </syntax>\n       <description>\n+        <para>The headers in this event attempt to describe all the major details of the attended transfer. The two transferer channels\n+\t\t\t\tand the two bridges are determined based on their chronological establishment. So consider that Alice calls Bob, and then Alice\n+\t\t\t\ttransfers the call to Voicemail. The transferer and bridge headers would be arranged as follows:</para>\n         <para>\n-          This differs from the\n-          <literal>ExtensionStatus</literal>\n-          event because this event is raised for all device state changes,\n-\t\t\t\tnot only for changes that affect dialplan hints.\n+          <replaceable>OrigTransfererChannel</replaceable>\n+          : Alice's channel in the bridge with Bob.\n+        </para>\n+        <para>\n+          <replaceable>OrigBridgeUniqueid</replaceable>\n+          : The bridge between Alice and Bob.\n+        </para>\n+        <para>\n+          <replaceable>SecondTransfererChannel</replaceable>\n+          : Alice's channel that called Voicemail.\n+        </para>\n+        <para>\n+          <replaceable>SecondBridgeUniqueid</replaceable>\n+          : Not present, since a call to Voicemail has no bridge.\n+        </para>\n+        <para>Now consider if the order were reversed; instead of having Alice call Bob and transfer him to Voicemail, Alice instead\n+\t\t\t\tcalls her Voicemail and transfers that to Bob. The transferer and bridge headers would be arranged as follows:</para>\n+        <para>\n+          <replaceable>OrigTransfererChannel</replaceable>\n+          : Alice's channel that called Voicemail.\n+        </para>\n+        <para>\n+          <replaceable>OrigBridgeUniqueid</replaceable>\n+          : Not present, since a call to Voicemail has no bridge.\n+        </para>\n+        <para>\n+          <replaceable>SecondTransfererChannel</replaceable>\n+          : Alice's channel in the bridge with Bob.\n+        </para>\n+        <para>\n+          <replaceable>SecondBridgeUniqueid</replaceable>\n+          : The bridge between Alice and Bob.\n         </para>\n       </description>\n       <see-also>\n-        <ref type=\"managerEvent\">ExtensionStatus</ref>\n+        <ref type=\"manager\">AtxFer</ref>\n       </see-also>\n     </managerEventInstance>\n   </managerEvent>\n-  <module language=\"en_US\" name=\"stasis_endpoints\">\n+  <module language=\"en_US\" name=\"dns_recurring\">\n     <support_level>core</support_level>\n   </module>\n-  <managerEvent language=\"en_US\" name=\"PeerStatus\">\n+  <module language=\"en_US\" name=\"smoother\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"bridge_roles\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"syslog\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"indications\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"astobj2_global\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"dns_core\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"test\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"pbx_timing\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"cel\">\n+    <support_level>core</support_level>\n+  </module>\n+  <configInfo name=\"cel\" language=\"en_US\">\n+    <configFile name=\"cel.conf\">\n+      <configObject name=\"general\">\n+        <synopsis>Options that apply globally to Channel Event Logging (CEL)</synopsis>\n+        <configOption name=\"enable\">\n+          <synopsis>Determines whether CEL is enabled</synopsis>\n+        </configOption>\n+        <configOption name=\"dateformat\">\n+          <synopsis>The format to be used for dates when logging</synopsis>\n+        </configOption>\n+        <configOption name=\"apps\">\n+          <synopsis>List of apps for CEL to track</synopsis>\n+          <description>\n+            <para>A case-insensitive, comma-separated list of applications\n+\t\t\t\t\tto track when one or both of APP_START and APP_END events are flagged for\n+\t\t\t\t\ttracking</para>\n+          </description>\n+        </configOption>\n+        <configOption name=\"events\">\n+          <synopsis>List of events for CEL to track</synopsis>\n+          <description>\n+            <para>\n+              A case-sensitive, comma-separated list of event names\n+\t\t\t\t\tto track. These event names do not include the leading\n+              <literal>AST_CEL</literal>\n+              .\n+            </para>\n+            <enumlist>\n+              <enum name=\"ALL\">\n+                <para>Special value which tracks all events.</para>\n+              </enum>\n+              <enum name=\"CHAN_START\"/>\n+              <enum name=\"CHAN_END\"/>\n+              <enum name=\"ANSWER\"/>\n+              <enum name=\"HANGUP\"/>\n+              <enum name=\"APP_START\"/>\n+              <enum name=\"APP_END\"/>\n+              <enum name=\"PARK_START\"/>\n+              <enum name=\"PARK_END\"/>\n+              <enum name=\"USER_DEFINED\"/>\n+              <enum name=\"BRIDGE_ENTER\"/>\n+              <enum name=\"BRIDGE_EXIT\"/>\n+              <enum name=\"BLINDTRANSFER\"/>\n+              <enum name=\"ATTENDEDTRANSFER\"/>\n+              <enum name=\"PICKUP\"/>\n+              <enum name=\"FORWARD\"/>\n+              <enum name=\"LINKEDID_END\"/>\n+              <enum name=\"LOCAL_OPTIMIZE\"/>\n+            </enumlist>\n+          </description>\n+        </configOption>\n+      </configObject>\n+    </configFile>\n+  </configInfo>\n+  <module language=\"en_US\" name=\"loader\">\n+    <support_level>core</support_level>\n+  </module>\n+  <managerEvent language=\"en_US\" name=\"Reload\">\n     <managerEventInstance class=\"EVENT_FLAG_SYSTEM\">\n-      <synopsis>Raised when the state of a peer changes.</synopsis>\n+      <synopsis>Raised when a module has been reloaded in Asterisk.</synopsis>\n       <syntax>\n-        <parameter name=\"ChannelType\">\n-          <para>The channel technology of the peer.</para>\n-        </parameter>\n-        <parameter name=\"Peer\">\n-          <para>The name of the peer (including channel technology).</para>\n+        <parameter name=\"Module\">\n+          <para>\n+            The name of the module that was reloaded, or\n+            <literal>All</literal>\n+            if all modules were reloaded\n+          </para>\n         </parameter>\n-        <parameter name=\"PeerStatus\">\n-          <para>New status of the peer.</para>\n+        <parameter name=\"Status\">\n+          <para>The numeric status code denoting the success or failure\n+\t\t\t\t\tof the reload request.</para>\n           <enumlist>\n-            <enum name=\"Unknown\"/>\n-            <enum name=\"Registered\"/>\n-            <enum name=\"Unregistered\"/>\n-            <enum name=\"Rejected\"/>\n-            <enum name=\"Lagged\"/>\n+            <enum name=\"0\">\n+              <para>Success</para>\n+            </enum>\n+            <enum name=\"1\">\n+              <para>Request queued</para>\n+            </enum>\n+            <enum name=\"2\">\n+              <para>Module not found</para>\n+            </enum>\n+            <enum name=\"3\">\n+              <para>Error</para>\n+            </enum>\n+            <enum name=\"4\">\n+              <para>Reload already in progress</para>\n+            </enum>\n+            <enum name=\"5\">\n+              <para>Module uninitialized</para>\n+            </enum>\n+            <enum name=\"6\">\n+              <para>Reload not supported</para>\n+            </enum>\n           </enumlist>\n         </parameter>\n-        <parameter name=\"Cause\">\n-          <para>The reason the status has changed.</para>\n-        </parameter>\n-        <parameter name=\"Address\">\n-          <para>New address of the peer.</para>\n-        </parameter>\n-        <parameter name=\"Port\">\n-          <para>New port for the peer.</para>\n-        </parameter>\n-        <parameter name=\"Time\">\n-          <para>Time it takes to reach the peer and receive a response.</para>\n-        </parameter>\n       </syntax>\n     </managerEventInstance>\n   </managerEvent>\n-  <managerEvent language=\"en_US\" name=\"ContactStatus\">\n+  <managerEvent language=\"en_US\" name=\"Load\">\n     <managerEventInstance class=\"EVENT_FLAG_SYSTEM\">\n-      <synopsis>Raised when the state of a contact changes.</synopsis>\n+      <synopsis>Raised when a module has been loaded in Asterisk.</synopsis>\n       <syntax>\n-        <parameter name=\"URI\">\n-          <para>This contact's URI.</para>\n+        <parameter name=\"Module\">\n+          <para>The name of the module that was loaded</para>\n         </parameter>\n-        <parameter name=\"ContactStatus\">\n-          <para>New status of the contact.</para>\n+        <parameter name=\"Status\">\n+          <para>The result of the load request.</para>\n           <enumlist>\n-            <enum name=\"Unknown\"/>\n-            <enum name=\"Unreachable\"/>\n-            <enum name=\"Reachable\"/>\n-            <enum name=\"Unqualified\"/>\n-            <enum name=\"Removed\"/>\n-            <enum name=\"Updated\"/>\n+            <enum name=\"Failure\">\n+              <para>Module could not be loaded properly</para>\n+            </enum>\n+            <enum name=\"Success\">\n+              <para>Module loaded and configured</para>\n+            </enum>\n+            <enum name=\"Decline\">\n+              <para>Module is not configured</para>\n+            </enum>\n           </enumlist>\n         </parameter>\n-        <parameter name=\"AOR\">\n-          <para>The name of the associated aor.</para>\n-        </parameter>\n-        <parameter name=\"EndpointName\">\n-          <para>The name of the associated endpoint.</para>\n-        </parameter>\n-        <parameter name=\"RoundtripUsec\">\n-          <para>The RTT measured during the last qualify.</para>\n-        </parameter>\n       </syntax>\n     </managerEventInstance>\n   </managerEvent>\n-  <module language=\"en_US\" name=\"acl\">\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"dns_core\">\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"stasis_system\">\n-    <support_level>core</support_level>\n-  </module>\n-  <managerEvent language=\"en_US\" name=\"Registry\">\n+  <managerEvent language=\"en_US\" name=\"Unload\">\n     <managerEventInstance class=\"EVENT_FLAG_SYSTEM\">\n-      <synopsis>Raised when an outbound registration completes.</synopsis>\n+      <synopsis>Raised when a module has been unloaded in Asterisk.</synopsis>\n       <syntax>\n-        <parameter name=\"ChannelType\">\n-          <para>The type of channel that was registered (or not).</para>\n-        </parameter>\n-        <parameter name=\"Username\">\n-          <para>The username portion of the registration.</para>\n-        </parameter>\n-        <parameter name=\"Domain\">\n-          <para>The address portion of the registration.</para>\n+        <parameter name=\"Module\">\n+          <para>The name of the module that was unloaded</para>\n         </parameter>\n         <parameter name=\"Status\">\n-          <para>The status of the registration request.</para>\n+          <para>The result of the unload request.</para>\n           <enumlist>\n-            <enum name=\"Registered\"/>\n-            <enum name=\"Unregistered\"/>\n-            <enum name=\"Rejected\"/>\n-            <enum name=\"Failed\"/>\n+            <enum name=\"Success\">\n+              <para>Module unloaded successfully</para>\n+            </enum>\n           </enumlist>\n         </parameter>\n-        <parameter name=\"Cause\">\n-          <para>What caused the rejection of the request, if available.</para>\n-        </parameter>\n       </syntax>\n     </managerEventInstance>\n   </managerEvent>\n-  <module language=\"en_US\" name=\"file\">\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"term\">\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"sched\">\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"strcompat\">\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"app\">\n+  <module language=\"en_US\" name=\"image\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"data_buffer\">\n+  <module language=\"en_US\" name=\"event\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"manager\">\n+  <module language=\"en_US\" name=\"features\">\n     <support_level>core</support_level>\n   </module>\n-  <manager name=\"Ping\" language=\"en_US\">\n-    <synopsis>Keepalive command.</synopsis>\n-    <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-    </syntax>\n-    <description>\n-      <para>A 'Ping' action will elicit a 'Pong' response. Used to keep the\n-\t\t\tmanager connection open.</para>\n-    </description>\n-  </manager>\n-  <manager name=\"Events\" language=\"en_US\">\n-    <synopsis>Control Event Flow.</synopsis>\n-    <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"EventMask\" required=\"true\">\n-        <enumlist>\n-          <enum name=\"on\">\n-            <para>If all events should be sent.</para>\n-          </enum>\n-          <enum name=\"off\">\n-            <para>If no events should be sent.</para>\n-          </enum>\n-          <enum name=\"system,call,log,...\">\n-            <para>To select which flags events should have to be sent.</para>\n-          </enum>\n-        </enumlist>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>Enable/Disable sending of events to this manager client.</para>\n-    </description>\n-  </manager>\n-  <manager name=\"Logoff\" language=\"en_US\">\n-    <synopsis>Logoff Manager.</synopsis>\n-    <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-    </syntax>\n-    <description>\n-      <para>Logoff the current manager session.</para>\n-    </description>\n-    <see-also>\n-      <ref type=\"manager\">Login</ref>\n-    </see-also>\n-  </manager>\n-  <manager name=\"Login\" language=\"en_US\">\n-    <synopsis>Login Manager.</synopsis>\n+  <application name=\"Bridge\" language=\"en_US\">\n+    <synopsis>Bridge two channels.</synopsis>\n     <syntax>\n-      <parameter name=\"ActionID\">\n-        <para>ActionID for this transaction. Will be returned.</para>\n-      </parameter>\n-      <parameter name=\"Username\" required=\"true\">\n-        <para>Username to login with as specified in manager.conf.</para>\n+      <parameter name=\"channel\" required=\"true\">\n+        <para>The current channel is bridged to the channel\n+\t\t\t\tidentified by the channel name, channel name prefix, or channel\n+\t\t\t\tuniqueid.</para>\n       </parameter>\n-      <parameter name=\"Secret\">\n-        <para>Secret to login with as specified in manager.conf.</para>\n+      <parameter name=\"options\">\n+        <optionlist>\n+          <option name=\"p\">\n+            <para>\n+              Play a courtesy tone to\n+              <replaceable>channel</replaceable>\n+              .\n+            </para>\n+          </option>\n+          <option name=\"F\" argsep=\"^\">\n+            <argument name=\"context\" required=\"false\"/>\n+            <argument name=\"exten\" required=\"false\"/>\n+            <argument name=\"priority\" required=\"true\"/>\n+            <para>\n+              When the bridger hangs up, transfer the\n+              <emphasis>bridged</emphasis>\n+              party\n+\t\t\t\t\t\tto the specified destination and\n+              <emphasis>start</emphasis>\n+              execution at that location.\n+            </para>\n+            <note>\n+              <para>Any channel variables you want the called channel to inherit from the caller channel must be\n+\t\t\t\t\t\t\tprefixed with one or two underbars ('_').</para>\n+            </note>\n+            <note>\n+              <para>This option will override the 'x' option</para>\n+            </note>\n+          </option>\n+          <option name=\"F\">\n+            <para>\n+              When the bridger hangs up, transfer the\n+              <emphasis>bridged</emphasis>\n+              party\n+\t\t\t\t\t\tto the next priority of\tthe current extension and\n+              <emphasis>start</emphasis>\n+              execution\n+\t\t\t\t\t\tat that location.\n+            </para>\n+            <note>\n+              <para>Any channel variables you want the called channel to inherit from the caller channel must be\n+\t\t\t\t\t\t\tprefixed with one or two underbars ('_').</para>\n+            </note>\n+            <note>\n+              <para>Using this option from a Macro() or GoSub() might not make sense as there would be no return points.</para>\n+            </note>\n+            <note>\n+              <para>This option will override the 'x' option</para>\n+            </note>\n+          </option>\n+          <option name=\"h\">\n+            <para>\n+              Allow the called party to hang up by sending the\n+              <replaceable>*</replaceable>\n+              DTMF digit.\n+            </para>\n+          </option>\n+          <option name=\"H\">\n+            <para>\n+              Allow the calling party to hang up by pressing the\n+              <replaceable>*</replaceable>\n+              DTMF digit.\n+            </para>\n+          </option>\n+          <option name=\"k\">\n+            <para>\n+              Allow the called party to enable parking of the call by sending\n+\t\t\t\t\t\tthe DTMF sequence defined for call parking in\n+              <filename>features.conf</filename>\n+              .\n+            </para>\n+          </option>\n+          <option name=\"K\">\n+            <para>\n+              Allow the calling party to enable parking of the call by sending\n+\t\t\t\t\t\t the DTMF sequence defined for call parking in\n+              <filename>features.conf</filename>\n+              .\n+            </para>\n+          </option>\n+          <option name=\"L(x[:y][:z])\">\n+            <para>\n+              Limit the call to\n+              <replaceable>x</replaceable>\n+              ms. Play a warning\n+\t\t\t\t\t\twhen\n+              <replaceable>y</replaceable>\n+              ms are left. Repeat the warning every\n+              <replaceable>z</replaceable>\n+              ms. The following special variables can be\n+\t\t\t\t\t\tused with this option:\n+            </para>\n+            <variablelist>\n+              <variable name=\"LIMIT_PLAYAUDIO_CALLER\">\n+                <para>Play sounds to the caller. yes|no (default yes)</para>\n+              </variable>\n+              <variable name=\"LIMIT_PLAYAUDIO_CALLEE\">\n+                <para>Play sounds to the callee. yes|no</para>\n+              </variable>\n+              <variable name=\"LIMIT_TIMEOUT_FILE\">\n+                <para>File to play when time is up.</para>\n+              </variable>\n+              <variable name=\"LIMIT_CONNECT_FILE\">\n+                <para>File to play when call begins.</para>\n+              </variable>\n+              <variable name=\"LIMIT_WARNING_FILE\">\n+                <para>\n+                  File to play as warning if\n+                  <replaceable>y</replaceable>\n+                  is\n+\t\t\t\t\t\t\t\tdefined. The default is to say the time remaining.\n+                </para>\n+              </variable>\n+            </variablelist>\n+          </option>\n+          <option name=\"S(x)\">\n+            <para>\n+              Hang up the call after\n+              <replaceable>x</replaceable>\n+              seconds *after* the called party has answered the call.\n+            </para>\n+          </option>\n+          <option name=\"t\">\n+            <para>\n+              Allow the called party to transfer the calling party by sending the\n+\t\t\t\t\t\tDTMF sequence defined in\n+              <filename>features.conf</filename>\n+              .\n+            </para>\n+          </option>\n+          <option name=\"T\">\n+            <para>\n+              Allow the calling party to transfer the called party by sending the\n+\t\t\t\t\t\tDTMF sequence defined in\n+              <filename>features.conf</filename>\n+              .\n+            </para>\n+          </option>\n+          <option name=\"w\">\n+            <para>\n+              Allow the called party to enable recording of the call by sending\n+\t\t\t\t\t\tthe DTMF sequence defined for one-touch recording in\n+              <filename>features.conf</filename>\n+              .\n+            </para>\n+          </option>\n+          <option name=\"W\">\n+            <para>\n+              Allow the calling party to enable recording of the call by sending\n+\t\t\t\t\t\tthe DTMF sequence defined for one-touch recording in\n+              <filename>features.conf</filename>\n+              .\n+            </para>\n+          </option>\n+          <option name=\"x\">\n+            <para>Cause the called party to be hung up after the bridge, instead of being\n+\t\t\t\t\t\trestarted in the dialplan.</para>\n+          </option>\n+        </optionlist>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>Login Manager.</para>\n+      <para>Allows the ability to bridge two channels via the dialplan.</para>\n+      <para>This application sets the following channel variable upon completion:</para>\n+      <variablelist>\n+        <variable name=\"BRIDGERESULT\">\n+          <para>The result of the bridge attempt as a text string.</para>\n+          <value name=\"SUCCESS\"/>\n+          <value name=\"FAILURE\"/>\n+          <value name=\"LOOP\"/>\n+          <value name=\"NONEXISTENT\"/>\n+        </variable>\n+      </variablelist>\n     </description>\n     <see-also>\n-      <ref type=\"manager\">Logoff</ref>\n+      <ref type=\"manager\">Bridge</ref>\n+      <ref type=\"managerEvent\">BridgeCreate</ref>\n+      <ref type=\"managerEvent\">BridgeEnter</ref>\n     </see-also>\n-  </manager>\n-  <manager name=\"Challenge\" language=\"en_US\">\n-    <synopsis>Generate Challenge for MD5 Auth.</synopsis>\n-    <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"AuthType\" required=\"true\">\n-        <para>Digest algorithm to use in the challenge. Valid values are:</para>\n-        <enumlist>\n-          <enum name=\"MD5\"/>\n-        </enumlist>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>Generate a challenge for MD5 authentication.</para>\n-    </description>\n-  </manager>\n-  <manager name=\"Hangup\" language=\"en_US\">\n-    <synopsis>Hangup channel.</synopsis>\n-    <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"Channel\" required=\"true\">\n-        <para>The exact channel name to be hungup, or to use a regular expression, set this parameter to: /regex/</para>\n-        <para>Example exact channel: SIP/provider-0000012a</para>\n-        <para>Example regular expression: /^SIP/provider-.*$/</para>\n-      </parameter>\n-      <parameter name=\"Cause\">\n-        <para>Numeric hangup cause.</para>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>Hangup a channel.</para>\n-    </description>\n-  </manager>\n-  <manager name=\"Status\" language=\"en_US\">\n-    <synopsis>List channel status.</synopsis>\n+  </application>\n+  <manager name=\"Bridge\" language=\"en_US\">\n+    <synopsis>Bridge two channels already in the PBX.</synopsis>\n     <syntax>\n       <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"Channel\" required=\"false\">\n-        <para>The name of the channel to query for status.</para>\n+      <parameter name=\"Channel1\" required=\"true\">\n+        <para>Channel to Bridge to Channel2.</para>\n       </parameter>\n-      <parameter name=\"Variables\">\n-        <para>\n-          Comma\n-          <literal>,</literal>\n-          separated list of variable to include.\n-        </para>\n+      <parameter name=\"Channel2\" required=\"true\">\n+        <para>Channel to Bridge to Channel1.</para>\n       </parameter>\n-      <parameter name=\"AllVariables\">\n-        <para>If set to &quot;true&quot;, the Status event will include all channel variables for\n-\t\t\t\tthe requested channel(s).</para>\n+      <parameter name=\"Tone\">\n+        <para>Play courtesy tone to Channel 2.</para>\n         <enumlist>\n-          <enum name=\"true\"/>\n-          <enum name=\"false\"/>\n+          <enum name=\"no\"/>\n+          <enum name=\"Channel1\"/>\n+          <enum name=\"Channel2\"/>\n+          <enum name=\"Both\"/>\n         </enumlist>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>Will return the status information of each channel along with the\n-\t\t\tvalue for the specified channel variables.</para>\n-    </description>\n-    <responses>\n-      <list-elements>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='Status'])\"/>\n-      </list-elements>\n-      <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='StatusComplete'])\"/>\n-    </responses>\n-  </manager>\n-  <managerEvent language=\"en_US\" name=\"Status\">\n-    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n-      <synopsis>Raised in response to a Status command.</synopsis>\n-      <syntax>\n-        <parameter name=\"ActionID\" required=\"false\"/>\n-        <channel_snapshot/>\n-        <parameter name=\"Type\">\n-          <para>Type of channel</para>\n-        </parameter>\n-        <parameter name=\"DNID\">\n-          <para>Dialed number identifier</para>\n-        </parameter>\n-        <parameter name=\"EffectiveConnectedLineNum\"/>\n-        <parameter name=\"EffectiveConnectedLineName\"/>\n-        <parameter name=\"TimeToHangup\">\n-          <para>Absolute lifetime of the channel</para>\n-        </parameter>\n-        <parameter name=\"BridgeID\">\n-          <para>Identifier of the bridge the channel is in, may be empty if not in one</para>\n-        </parameter>\n-        <parameter name=\"Application\">\n-          <para>Application currently executing on the channel</para>\n-        </parameter>\n-        <parameter name=\"Data\">\n-          <para>Data given to the currently executing channel</para>\n-        </parameter>\n-        <parameter name=\"Nativeformats\">\n-          <para>Media formats the connected party is willing to send or receive</para>\n-        </parameter>\n-        <parameter name=\"Readformat\">\n-          <para>Media formats that frames from the channel are received in</para>\n-        </parameter>\n-        <parameter name=\"Readtrans\">\n-          <para>Translation path for media received in native formats</para>\n-        </parameter>\n-        <parameter name=\"Writeformat\">\n-          <para>Media formats that frames to the channel are accepted in</para>\n-        </parameter>\n-        <parameter name=\"Writetrans\">\n-          <para>Translation path for media sent to the connected party</para>\n-        </parameter>\n-        <parameter name=\"Callgroup\">\n-          <para>Configured call group on the channel</para>\n-        </parameter>\n-        <parameter name=\"Pickupgroup\">\n-          <para>Configured pickup group on the channel</para>\n-        </parameter>\n-        <parameter name=\"Seconds\">\n-          <para>Number of seconds the channel has been active</para>\n-        </parameter>\n-      </syntax>\n-      <see-also>\n-        <ref type=\"manager\">Status</ref>\n-      </see-also>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <managerEvent language=\"en_US\" name=\"StatusComplete\">\n-    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n-      <synopsis>Raised in response to a Status command.</synopsis>\n-      <syntax>\n-        <parameter name=\"Items\">\n-          <para>Number of Status events returned</para>\n-        </parameter>\n-      </syntax>\n-      <see-also>\n-        <ref type=\"manager\">Status</ref>\n-      </see-also>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <manager name=\"Setvar\" language=\"en_US\">\n-    <synopsis>Sets a channel variable or function value.</synopsis>\n-    <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"Channel\">\n-        <para>Channel to set variable for.</para>\n-      </parameter>\n-      <parameter name=\"Variable\" required=\"true\">\n-        <para>Variable name, function or expression.</para>\n-      </parameter>\n-      <parameter name=\"Value\" required=\"true\">\n-        <para>Variable or function value.</para>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>This command can be used to set the value of channel variables or dialplan\n-\t\t\tfunctions.</para>\n-      <note>\n-        <para>If a channel name is not provided then the variable is considered global.</para>\n-      </note>\n-    </description>\n-    <see-also>\n-      <ref type=\"manager\">Getvar</ref>\n-    </see-also>\n-  </manager>\n-  <manager name=\"Getvar\" language=\"en_US\">\n-    <synopsis>Gets a channel variable or function value.</synopsis>\n-    <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"Channel\">\n-        <para>Channel to read variable from.</para>\n-      </parameter>\n-      <parameter name=\"Variable\" required=\"true\">\n-        <para>Variable name, function or expression.</para>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>Get the value of a channel variable or function return.</para>\n-      <note>\n-        <para>If a channel name is not provided then the variable is considered global.</para>\n-      </note>\n-    </description>\n-    <see-also>\n-      <ref type=\"manager\">Setvar</ref>\n-    </see-also>\n-  </manager>\n-  <manager name=\"GetConfig\" language=\"en_US\">\n-    <synopsis>Retrieve configuration.</synopsis>\n-    <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"Filename\" required=\"true\">\n-        <para>\n-          Configuration filename (e.g.\n-          <filename>foo.conf</filename>\n-          ).\n-        </para>\n-      </parameter>\n-      <parameter name=\"Category\">\n-        <para>Category in configuration file.</para>\n-      </parameter>\n-      <parameter name=\"Filter\">\n-        <para>\n-          A comma separated list of\n-          <replaceable>name_regex</replaceable>\n-          =\n-          <replaceable>value_regex</replaceable>\n-          expressions which will cause only categories whose variables match all expressions\n-\t\t\t\tto be considered.  The special variable name\n-          <literal>TEMPLATES</literal>\n-          can be used to control whether templates are included.  Passing\n-          <literal>include</literal>\n-          as the value will include templates\n-\t\t\t\talong with normal categories. Passing\n-          <literal>restrict</literal>\n-          as the value will restrict the operation to\n-\t\t\t\tONLY templates.  Not specifying a\n-          <literal>TEMPLATES</literal>\n-          expression\n-\t\t\t\tresults in the default behavior which is to not include templates.\n-        </para>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>This action will dump the contents of a configuration\n-\t\t\tfile by category and contents or optionally by specified category only.\n-\t\t\tIn the case where a category name is non-unique, a filter may be specified\n-\t\t\tto match only categories with matching variable values.</para>\n+      <para>Bridge together two channels already in the PBX.</para>\n     </description>\n     <see-also>\n-      <ref type=\"manager\">GetConfigJSON</ref>\n-      <ref type=\"manager\">UpdateConfig</ref>\n-      <ref type=\"manager\">CreateConfig</ref>\n-      <ref type=\"manager\">ListCategories</ref>\n+      <ref type=\"application\">Bridge</ref>\n+      <ref type=\"managerEvent\">BridgeCreate</ref>\n+      <ref type=\"managerEvent\">BridgeEnter</ref>\n+      <ref type=\"manager\">BridgeDestroy</ref>\n+      <ref type=\"manager\">BridgeInfo</ref>\n+      <ref type=\"manager\">BridgeKick</ref>\n+      <ref type=\"manager\">BridgeList</ref>\n     </see-also>\n   </manager>\n-  <manager name=\"GetConfigJSON\" language=\"en_US\">\n-    <synopsis>Retrieve configuration (JSON format).</synopsis>\n+  <module language=\"en_US\" name=\"bridge\">\n+    <support_level>core</support_level>\n+  </module>\n+  <manager name=\"BridgeTechnologyList\" language=\"en_US\">\n+    <synopsis>List available bridging technologies and their statuses.</synopsis>\n     <syntax>\n       <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"Filename\" required=\"true\">\n-        <para>\n-          Configuration filename (e.g.\n-          <filename>foo.conf</filename>\n-          ).\n-        </para>\n-      </parameter>\n-      <parameter name=\"Category\">\n-        <para>Category in configuration file.</para>\n-      </parameter>\n-      <parameter name=\"Filter\">\n-        <xi:include xpointer=\"xpointer(/docs/manager[@name='GetConfig']/syntax/parameter[@name='Filter']/para[1])\"/>\n-      </parameter>\n     </syntax>\n     <description>\n-      <para>This action will dump the contents of a configuration file by category\n-\t\t\tand contents in JSON format or optionally by specified category only.\n-\t\t\tThis only makes sense to be used using rawman over the HTTP interface.\n-\t\t\tIn the case where a category name is non-unique, a filter may be specified\n-\t\t\tto match only categories with matching variable values.</para>\n+      <para>Returns detailed information about the available bridging technologies.</para>\n     </description>\n     <see-also>\n-      <ref type=\"manager\">GetConfig</ref>\n-      <ref type=\"manager\">UpdateConfig</ref>\n-      <ref type=\"manager\">CreateConfig</ref>\n-      <ref type=\"manager\">ListCategories</ref>\n+      <ref type=\"manager\">BridgeTechnologySuspend</ref>\n+      <ref type=\"manager\">BridgeTechnologyUnsuspend</ref>\n     </see-also>\n   </manager>\n-  <manager name=\"UpdateConfig\" language=\"en_US\">\n-    <synopsis>Update basic configuration.</synopsis>\n+  <manager name=\"BridgeTechnologySuspend\" language=\"en_US\">\n+    <synopsis>Suspend a bridging technology.</synopsis>\n     <syntax>\n       <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"SrcFilename\" required=\"true\">\n-        <para>\n-          Configuration filename to read (e.g.\n-          <filename>foo.conf</filename>\n-          ).\n-        </para>\n-      </parameter>\n-      <parameter name=\"DstFilename\" required=\"true\">\n-        <para>\n-          Configuration filename to write (e.g.\n-          <filename>foo.conf</filename>\n-          )\n-        </para>\n-      </parameter>\n-      <parameter name=\"Reload\">\n-        <para>Whether or not a reload should take place (or name of specific module).</para>\n-      </parameter>\n-      <parameter name=\"PreserveEffectiveContext\">\n-        <para>Whether the effective category contents should be preserved on template change. Default is true (pre 13.2 behavior).</para>\n-      </parameter>\n-      <parameter name=\"Action-000000\">\n-        <para>Action to take.</para>\n-        <para>0's represent 6 digit number beginning with 000000.</para>\n-        <enumlist>\n-          <enum name=\"NewCat\"/>\n-          <enum name=\"RenameCat\"/>\n-          <enum name=\"DelCat\"/>\n-          <enum name=\"EmptyCat\"/>\n-          <enum name=\"Update\"/>\n-          <enum name=\"Delete\"/>\n-          <enum name=\"Append\"/>\n-          <enum name=\"Insert\"/>\n-        </enumlist>\n-      </parameter>\n-      <parameter name=\"Cat-000000\">\n-        <para>Category to operate on.</para>\n-        <xi:include xpointer=\"xpointer(/docs/manager[@name='UpdateConfig']/syntax/parameter[@name='Action-000000']/para[2])\"/>\n-      </parameter>\n-      <parameter name=\"Var-000000\">\n-        <para>Variable to work on.</para>\n-        <xi:include xpointer=\"xpointer(/docs/manager[@name='UpdateConfig']/syntax/parameter[@name='Action-000000']/para[2])\"/>\n-      </parameter>\n-      <parameter name=\"Value-000000\">\n-        <para>Value to work on.</para>\n-        <xi:include xpointer=\"xpointer(/docs/manager[@name='UpdateConfig']/syntax/parameter[@name='Action-000000']/para[2])\"/>\n-      </parameter>\n-      <parameter name=\"Match-000000\">\n-        <para>Extra match required to match line.</para>\n-        <xi:include xpointer=\"xpointer(/docs/manager[@name='UpdateConfig']/syntax/parameter[@name='Action-000000']/para[2])\"/>\n-      </parameter>\n-      <parameter name=\"Line-000000\">\n-        <para>Line in category to operate on (used with delete and insert actions).</para>\n-        <xi:include xpointer=\"xpointer(/docs/manager[@name='UpdateConfig']/syntax/parameter[@name='Action-000000']/para[2])\"/>\n-      </parameter>\n-      <parameter name=\"Options-000000\">\n-        <para>A comma separated list of action-specific options.</para>\n-        <enumlist>\n-          <enum name=\"NewCat\">\n-            <para>One or more of the following...</para>\n-            <enumlist>\n-              <enum name=\"allowdups\">\n-                <para>Allow duplicate category names.</para>\n-              </enum>\n-              <enum name=\"template\">\n-                <para>This category is a template.</para>\n-              </enum>\n-              <enum name=\"inherit=&quot;template[,...]&quot;\">\n-                <para>Templates from which to inherit.</para>\n-              </enum>\n-            </enumlist>\n-          </enum>\n-        </enumlist>\n-        <para/>\n-        <para>The following actions share the same options...</para>\n-        <enumlist>\n-          <enum name=\"RenameCat\"/>\n-          <enum name=\"DelCat\"/>\n-          <enum name=\"EmptyCat\"/>\n-          <enum name=\"Update\"/>\n-          <enum name=\"Delete\"/>\n-          <enum name=\"Append\"/>\n-          <enum name=\"Insert\">\n-            <para/>\n-            <enumlist>\n-              <enum name=\"catfilter=&quot;&lt;expression&gt;[,...]&quot;\">\n-                <para/>\n-                <xi:include xpointer=\"xpointer(/docs/manager[@name='GetConfig']/syntax/parameter[@name='Filter']/para[1])\"/>\n-                <para>\n-                  <literal>catfilter</literal>\n-                  is most useful when a file\n-\t\t\t\t\t\t\t\t\tcontains multiple categories with the same name and you wish to\n-\t\t\t\t\t\t\t\t\toperate on specific ones instead of all of them.\n-                </para>\n-              </enum>\n-            </enumlist>\n-          </enum>\n-        </enumlist>\n-        <xi:include xpointer=\"xpointer(/docs/manager[@name='UpdateConfig']/syntax/parameter[@name='Action-000000']/para[2])\"/>\n+      <parameter name=\"BridgeTechnology\" required=\"true\">\n+        <para>The name of the bridging technology to suspend.</para>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>This action will modify, create, or delete configuration elements\n-\t\t\tin Asterisk configuration files.</para>\n+      <para>Marks a bridging technology as suspended, which prevents subsequently created bridges from using it.</para>\n     </description>\n     <see-also>\n-      <ref type=\"manager\">GetConfig</ref>\n-      <ref type=\"manager\">GetConfigJSON</ref>\n-      <ref type=\"manager\">CreateConfig</ref>\n-      <ref type=\"manager\">ListCategories</ref>\n+      <ref type=\"manager\">BridgeTechnologySuspend</ref>\n+      <ref type=\"manager\">BridgeTechnologyUnsuspend</ref>\n     </see-also>\n   </manager>\n-  <manager name=\"CreateConfig\" language=\"en_US\">\n-    <synopsis>Creates an empty file in the configuration directory.</synopsis>\n+  <manager name=\"BridgeTechnologyUnsuspend\" language=\"en_US\">\n+    <synopsis>Unsuspend a bridging technology.</synopsis>\n     <syntax>\n       <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"Filename\" required=\"true\">\n-        <para>\n-          The configuration filename to create (e.g.\n-          <filename>foo.conf</filename>\n-          ).\n-        </para>\n+      <parameter name=\"BridgeTechnology\" required=\"true\">\n+        <para>The name of the bridging technology to unsuspend.</para>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>This action will create an empty file in the configuration\n-\t\t\tdirectory. This action is intended to be used before an UpdateConfig\n-\t\t\taction.</para>\n+      <para>Clears a previously suspended bridging technology, which allows subsequently created bridges to use it.</para>\n     </description>\n     <see-also>\n-      <ref type=\"manager\">GetConfig</ref>\n-      <ref type=\"manager\">GetConfigJSON</ref>\n-      <ref type=\"manager\">UpdateConfig</ref>\n-      <ref type=\"manager\">ListCategories</ref>\n+      <ref type=\"manager\">BridgeTechnologyList</ref>\n+      <ref type=\"manager\">BridgeTechnologySuspend</ref>\n     </see-also>\n   </manager>\n-  <manager name=\"ListCategories\" language=\"en_US\">\n-    <synopsis>List categories in configuration file.</synopsis>\n+  <module language=\"en_US\" name=\"abstract_jb\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"format_cache\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"stasis_cache_pattern\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"dns_test\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"dnsmgr\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"pbx_builtins\">\n+    <support_level>core</support_level>\n+  </module>\n+  <application name=\"Answer\" language=\"en_US\">\n+    <synopsis>Answer a channel if ringing.</synopsis>\n     <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"Filename\" required=\"true\">\n-        <para>\n-          Configuration filename (e.g.\n-          <filename>foo.conf</filename>\n-          ).\n-        </para>\n+      <parameter name=\"delay\">\n+        <para>Asterisk will wait this number of milliseconds before returning to\n+\t\t\t\tthe dialplan after answering the call.</para>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>This action will dump the categories in a given file.</para>\n+      <para>If the call has not been answered, this application will\n+\t\t\tanswer it. Otherwise, it has no effect on the call.</para>\n     </description>\n     <see-also>\n-      <ref type=\"manager\">GetConfig</ref>\n-      <ref type=\"manager\">GetConfigJSON</ref>\n-      <ref type=\"manager\">UpdateConfig</ref>\n-      <ref type=\"manager\">CreateConfig</ref>\n+      <ref type=\"application\">Hangup</ref>\n     </see-also>\n-  </manager>\n-  <manager name=\"Redirect\" language=\"en_US\">\n-    <synopsis>Redirect (transfer) a call.</synopsis>\n+  </application>\n+  <application name=\"BackGround\" language=\"en_US\">\n+    <synopsis>Play an audio file while waiting for digits of an extension to go to.</synopsis>\n     <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"Channel\" required=\"true\">\n-        <para>Channel to redirect.</para>\n-      </parameter>\n-      <parameter name=\"ExtraChannel\">\n-        <para>Second call leg to transfer (optional).</para>\n-      </parameter>\n-      <parameter name=\"Exten\" required=\"true\">\n-        <para>Extension to transfer to.</para>\n-      </parameter>\n-      <parameter name=\"ExtraExten\">\n-        <para>Extension to transfer extrachannel to (optional).</para>\n-      </parameter>\n-      <parameter name=\"Context\" required=\"true\">\n-        <para>Context to transfer to.</para>\n+      <parameter name=\"filenames\" required=\"true\" argsep=\"&amp;\">\n+        <argument name=\"filename1\" required=\"true\"/>\n+        <argument name=\"filename2\" multiple=\"true\"/>\n       </parameter>\n-      <parameter name=\"ExtraContext\">\n-        <para>Context to transfer extrachannel to (optional).</para>\n+      <parameter name=\"options\">\n+        <optionlist>\n+          <option name=\"s\">\n+            <para>\n+              Causes the playback of the message to be skipped\n+\t\t\t\t\t\tif the channel is not in the\n+              <literal>up</literal>\n+              state (i.e. it\n+\t\t\t\t\t\thasn't been answered yet). If this happens, the\n+\t\t\t\t\t\tapplication will return immediately.\n+            </para>\n+          </option>\n+          <option name=\"n\">\n+            <para>Don't answer the channel before playing the files.</para>\n+          </option>\n+          <option name=\"m\">\n+            <para>Only break if a digit hit matches a one digit\n+\t\t\t\t\t\textension in the destination context.</para>\n+          </option>\n+          <option name=\"p\">\n+            <para>Do not allow playback to be interrupted with digits.</para>\n+          </option>\n+        </optionlist>\n       </parameter>\n-      <parameter name=\"Priority\" required=\"true\">\n-        <para>Priority to transfer to.</para>\n+      <parameter name=\"langoverride\">\n+        <para>Explicitly specifies which language to attempt to use for the requested sound files.</para>\n       </parameter>\n-      <parameter name=\"ExtraPriority\">\n-        <para>Priority to transfer extrachannel to (optional).</para>\n+      <parameter name=\"context\">\n+        <para>This is the dialplan context that this application will use when exiting\n+\t\t\t\tto a dialed extension.</para>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>Redirect (transfer) a call.</para>\n+      <para>\n+        This application will play the given list of files\n+        <emphasis>(do not put extension)</emphasis>\n+        while waiting for an extension to be dialed by the calling channel. To continue waiting\n+\t\t\tfor digits after this application has finished playing files, the\n+        <literal>WaitExten</literal>\n+        application should be used.\n+      </para>\n+      <para>If one of the requested sound files does not exist, call processing will be terminated.</para>\n+      <para>This application sets the following channel variable upon completion:</para>\n+      <variablelist>\n+        <variable name=\"BACKGROUNDSTATUS\">\n+          <para>The status of the background attempt as a text string.</para>\n+          <value name=\"SUCCESS\"/>\n+          <value name=\"FAILED\"/>\n+        </variable>\n+      </variablelist>\n     </description>\n     <see-also>\n-      <ref type=\"manager\">BlindTransfer</ref>\n+      <ref type=\"application\">ControlPlayback</ref>\n+      <ref type=\"application\">WaitExten</ref>\n+      <ref type=\"application\">BackgroundDetect</ref>\n+      <ref type=\"function\">TIMEOUT</ref>\n     </see-also>\n-  </manager>\n-  <manager name=\"Atxfer\" language=\"en_US\">\n-    <synopsis>Attended transfer.</synopsis>\n+  </application>\n+  <application name=\"Busy\" language=\"en_US\">\n+    <synopsis>Indicate the Busy condition.</synopsis>\n     <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"Channel\" required=\"true\">\n-        <para>Transferer's channel.</para>\n-      </parameter>\n-      <parameter name=\"Exten\" required=\"true\">\n-        <para>Extension to transfer to.</para>\n-      </parameter>\n-      <parameter name=\"Context\">\n-        <para>Context to transfer to.</para>\n+      <parameter name=\"timeout\">\n+        <para>If specified, the calling channel will be hung up after the specified number of seconds.\n+\t\t\t\tOtherwise, this application will wait until the calling channel hangs up.</para>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>Attended transfer.</para>\n+      <para>This application will indicate the busy condition to the calling channel.</para>\n     </description>\n     <see-also>\n-      <ref type=\"managerEvent\">AttendedTransfer</ref>\n+      <ref type=\"application\">Congestion</ref>\n+      <ref type=\"application\">Progress</ref>\n+      <ref type=\"application\">Playtones</ref>\n+      <ref type=\"application\">Hangup</ref>\n     </see-also>\n-  </manager>\n-  <manager name=\"CancelAtxfer\" language=\"en_US\">\n-    <since>\n-      <version>13.18.0</version>\n-      <version>14.7.0</version>\n-      <version>15.1.0</version>\n-      <version>16.0.0</version>\n-    </since>\n-    <synopsis>Cancel an attended transfer.</synopsis>\n+  </application>\n+  <application name=\"Congestion\" language=\"en_US\">\n+    <synopsis>Indicate the Congestion condition.</synopsis>\n     <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"Channel\" required=\"true\">\n-        <para>The transferer channel.</para>\n+      <parameter name=\"timeout\">\n+        <para>If specified, the calling channel will be hung up after the specified number of seconds.\n+\t\t\t\tOtherwise, this application will wait until the calling channel hangs up.</para>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>Cancel an attended transfer. Note, this uses the configured cancel attended transfer\n-\t\t\tfeature option (atxferabort) to cancel the transfer. If not available this action will fail.</para>\n+      <para>This application will indicate the congestion condition to the calling channel.</para>\n     </description>\n     <see-also>\n-      <ref type=\"managerEvent\">AttendedTransfer</ref>\n+      <ref type=\"application\">Busy</ref>\n+      <ref type=\"application\">Progress</ref>\n+      <ref type=\"application\">Playtones</ref>\n+      <ref type=\"application\">Hangup</ref>\n     </see-also>\n-  </manager>\n-  <manager name=\"Originate\" language=\"en_US\">\n-    <synopsis>Originate a call.</synopsis>\n-    <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"Channel\" required=\"true\">\n-        <para>Channel name to call.</para>\n-      </parameter>\n-      <parameter name=\"Exten\">\n-        <para>\n-          Extension to use (requires\n-          <literal>Context</literal>\n-          and\n-          <literal>Priority</literal>\n-          )\n-        </para>\n-      </parameter>\n-      <parameter name=\"Context\">\n-        <para>\n-          Context to use (requires\n-          <literal>Exten</literal>\n-          and\n-          <literal>Priority</literal>\n-          )\n-        </para>\n-      </parameter>\n-      <parameter name=\"Priority\">\n-        <para>\n-          Priority to use (requires\n-          <literal>Exten</literal>\n-          and\n-          <literal>Context</literal>\n-          )\n-        </para>\n-      </parameter>\n-      <parameter name=\"Application\">\n-        <para>Application to execute.</para>\n-      </parameter>\n-      <parameter name=\"Data\">\n-        <para>\n-          Data to use (requires\n-          <literal>Application</literal>\n-          ).\n-        </para>\n-      </parameter>\n-      <parameter name=\"Timeout\" default=\"30000\">\n-        <para>How long to wait for call to be answered (in ms.).</para>\n-      </parameter>\n-      <parameter name=\"CallerID\">\n-        <para>Caller ID to be set on the outgoing channel.</para>\n-      </parameter>\n-      <parameter name=\"Variable\">\n-        <para>Channel variable to set, multiple Variable: headers are allowed.</para>\n-      </parameter>\n-      <parameter name=\"Account\">\n-        <para>Account code.</para>\n-      </parameter>\n-      <parameter name=\"EarlyMedia\">\n-        <para>\n-          Set to\n-          <literal>true</literal>\n-          to force call bridge on early media..\n-        </para>\n-      </parameter>\n-      <parameter name=\"Async\">\n-        <para>\n-          Set to\n-          <literal>true</literal>\n-          for fast origination.\n-        </para>\n-      </parameter>\n-      <parameter name=\"Codecs\">\n-        <para>Comma-separated list of codecs to use for this call.</para>\n-      </parameter>\n-      <parameter name=\"ChannelId\">\n-        <para>Channel UniqueId to be set on the channel.</para>\n+  </application>\n+  <application name=\"ExecIfTime\" language=\"en_US\">\n+    <synopsis>Conditional application execution based on the current time.</synopsis>\n+    <syntax argsep=\"?\">\n+      <parameter name=\"day_condition\" required=\"true\">\n+        <argument name=\"times\" required=\"true\"/>\n+        <argument name=\"weekdays\" required=\"true\"/>\n+        <argument name=\"mdays\" required=\"true\"/>\n+        <argument name=\"months\" required=\"true\"/>\n+        <argument name=\"timezone\" required=\"false\"/>\n       </parameter>\n-      <parameter name=\"OtherChannelId\">\n-        <para>Channel UniqueId to be set on the second local channel.</para>\n+      <parameter name=\"appname\" required=\"true\" hasparams=\"optional\">\n+        <argument name=\"appargs\" required=\"true\"/>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>\n-        Generates an outgoing call to a\n-        <replaceable>Extension</replaceable>\n-        /\n-        <replaceable>Context</replaceable>\n-        /\n-        <replaceable>Priority</replaceable>\n-        or\n-        <replaceable>Application</replaceable>\n-        /\n-        <replaceable>Data</replaceable>\n-      </para>\n+      <para>This application will execute the specified dialplan application, with optional\n+\t\t\targuments, if the current time matches the given time specification.</para>\n     </description>\n     <see-also>\n-      <ref type=\"managerEvent\">OriginateResponse</ref>\n+      <ref type=\"application\">Exec</ref>\n+      <ref type=\"application\">ExecIf</ref>\n+      <ref type=\"application\">TryExec</ref>\n+      <ref type=\"application\">GotoIfTime</ref>\n     </see-also>\n-  </manager>\n-  <managerEvent language=\"en_US\" name=\"OriginateResponse\">\n-    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n-      <synopsis>Raised in response to an Originate command.</synopsis>\n-      <syntax>\n-        <parameter name=\"ActionID\" required=\"false\"/>\n-        <parameter name=\"Response\">\n-          <enumlist>\n-            <enum name=\"Failure\"/>\n-            <enum name=\"Success\"/>\n-          </enumlist>\n-        </parameter>\n-        <parameter name=\"Channel\"/>\n-        <parameter name=\"Context\"/>\n-        <parameter name=\"Exten\"/>\n-        <parameter name=\"Application\"/>\n-        <parameter name=\"Data\"/>\n-        <parameter name=\"Reason\"/>\n-        <parameter name=\"Uniqueid\"/>\n-        <parameter name=\"CallerIDNum\"/>\n-        <parameter name=\"CallerIDName\"/>\n-      </syntax>\n-      <see-also>\n-        <ref type=\"manager\">Originate</ref>\n-      </see-also>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <manager name=\"Command\" language=\"en_US\">\n-    <synopsis>Execute Asterisk CLI Command.</synopsis>\n-    <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"Command\" required=\"true\">\n-        <para>Asterisk CLI command to run.</para>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>Run a CLI command.</para>\n-    </description>\n-  </manager>\n-  <manager name=\"ExtensionState\" language=\"en_US\">\n-    <synopsis>Check Extension Status.</synopsis>\n+  </application>\n+  <application name=\"Goto\" language=\"en_US\">\n+    <synopsis>Jump to a particular priority, extension, or context.</synopsis>\n     <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"Exten\" required=\"true\">\n-        <para>Extension to check state on.</para>\n-      </parameter>\n-      <parameter name=\"Context\" required=\"true\">\n-        <para>Context for extension.</para>\n-      </parameter>\n+      <parameter name=\"context\"/>\n+      <parameter name=\"extensions\"/>\n+      <parameter name=\"priority\" required=\"true\"/>\n     </syntax>\n     <description>\n-      <para>Report the extension state for given extension. If the extension has a hint,\n-\t\t\twill use devicestate to check the status of the device connected to the extension.</para>\n       <para>\n-        Will return an\n-        <literal>Extension Status</literal>\n-        message. The response will include\n-\t\t\tthe hint for the extension and the status.\n+        This application will set the current context, extension, and priority in the channel structure.\n+\t\t\tAfter it completes, the pbx engine will continue dialplan execution at the specified location.\n+\t\t\tIf no specific\n+        <replaceable>extension</replaceable>\n+        , or\n+        <replaceable>extension</replaceable>\n+        and\n+        <replaceable>context</replaceable>\n+        , are specified, then this application will\n+\t\t\tjust set the specified\n+        <replaceable>priority</replaceable>\n+        of the current extension.\n+      </para>\n+      <para>\n+        At least a\n+        <replaceable>priority</replaceable>\n+        is required as an argument, or the goto will\n+\t\t\treturn a\n+        <literal>-1</literal>\n+        ,\tand the channel and call will be terminated.\n+      </para>\n+      <para>\n+        If the location that is put into the channel information is bogus, and asterisk cannot\n+\t\t\tfind that location in the dialplan, then the execution engine will try to find and execute the code in\n+\t\t\tthe\n+        <literal>i</literal>\n+        (invalid) extension in the current context. If that does not exist, it will try to execute the\n+        <literal>h</literal>\n+        extension. If neither the\n+        <literal>h</literal>\n+        nor\n+        <literal>i</literal>\n+        extensions\n+\t\t\thave been defined, the channel is hung up, and the execution of instructions on the channel is terminated.\n+\t\t\tWhat this means is that, for example, you specify a context that does not exist, then\n+\t\t\tit will not be possible to find the\n+        <literal>h</literal>\n+        or\n+        <literal>i</literal>\n+        extensions,\n+\t\t\tand the call will terminate!\n       </para>\n     </description>\n     <see-also>\n-      <ref type=\"managerEvent\">ExtensionStatus</ref>\n+      <ref type=\"application\">GotoIf</ref>\n+      <ref type=\"application\">GotoIfTime</ref>\n+      <ref type=\"application\">Gosub</ref>\n+      <ref type=\"application\">Macro</ref>\n     </see-also>\n-  </manager>\n-  <manager name=\"PresenceState\" language=\"en_US\">\n-    <synopsis>Check Presence State</synopsis>\n-    <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"Provider\" required=\"true\">\n-        <para>Presence Provider to check the state of</para>\n+  </application>\n+  <application name=\"GotoIf\" language=\"en_US\">\n+    <synopsis>Conditional goto.</synopsis>\n+    <syntax argsep=\"?\">\n+      <parameter name=\"condition\" required=\"true\"/>\n+      <parameter name=\"destination\" required=\"true\" argsep=\":\">\n+        <argument name=\"labeliftrue\">\n+          <para>\n+            Continue at\n+            <replaceable>labeliftrue</replaceable>\n+            if the condition is true.\n+\t\t\t\t\tTakes the form similar to Goto() of [[context,]extension,]priority.\n+          </para>\n+        </argument>\n+        <argument name=\"labeliffalse\">\n+          <para>\n+            Continue at\n+            <replaceable>labeliffalse</replaceable>\n+            if the condition is false.\n+\t\t\t\t\tTakes the form similar to Goto() of [[context,]extension,]priority.\n+          </para>\n+        </argument>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>Report the presence state for the given presence provider.</para>\n       <para>\n-        Will return a\n-        <literal>Presence State</literal>\n-        message. The response will include the\n-\t\t\tpresence state and, if set, a presence subtype and custom message.\n+        This application will set the current context, extension, and priority in the channel structure\n+\t\t\tbased on the evaluation of the given condition. After this application completes, the\n+\t\t\tpbx engine will continue dialplan execution at the specified location in the dialplan.\n+\t\t\tThe labels are specified with the same syntax as used within the Goto application.\n+\t\t\tIf the label chosen by the condition is omitted, no jump is performed, and the execution passes to the\n+\t\t\tnext instruction. If the target location is bogus, and does not exist, the execution engine will try\n+\t\t\tto find and execute the code in the\n+        <literal>i</literal>\n+        (invalid) extension in the current context.\n+\t\t\tIf that does not exist, it will try to execute the\n+        <literal>h</literal>\n+        extension.\n+\t\t\tIf neither the\n+        <literal>h</literal>\n+        nor\n+        <literal>i</literal>\n+        extensions have been defined,\n+\t\t\tthe channel is hung up, and the execution of instructions on the channel is terminated.\n+\t\t\tRemember that this command can set the current context, and if the context specified\n+\t\t\tdoes not exist, then it will not be able to find any 'h' or 'i' extensions there, and\n+\t\t\tthe channel and call will both be terminated!.\n       </para>\n     </description>\n     <see-also>\n-      <ref type=\"managerEvent\">PresenceStatus</ref>\n+      <ref type=\"application\">Goto</ref>\n+      <ref type=\"application\">GotoIfTime</ref>\n+      <ref type=\"application\">GosubIf</ref>\n+      <ref type=\"application\">MacroIf</ref>\n     </see-also>\n-  </manager>\n-  <manager name=\"AbsoluteTimeout\" language=\"en_US\">\n-    <synopsis>Set absolute timeout.</synopsis>\n-    <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"Channel\" required=\"true\">\n-        <para>Channel name to hangup.</para>\n+  </application>\n+  <application name=\"GotoIfTime\" language=\"en_US\">\n+    <synopsis>Conditional Goto based on the current time.</synopsis>\n+    <syntax argsep=\"?\">\n+      <parameter name=\"condition\" required=\"true\">\n+        <argument name=\"times\" required=\"true\"/>\n+        <argument name=\"weekdays\" required=\"true\"/>\n+        <argument name=\"mdays\" required=\"true\"/>\n+        <argument name=\"months\" required=\"true\"/>\n+        <argument name=\"timezone\" required=\"false\"/>\n       </parameter>\n-      <parameter name=\"Timeout\" required=\"true\">\n-        <para>Maximum duration of the call (sec).</para>\n+      <parameter name=\"destination\" required=\"true\" argsep=\":\">\n+        <argument name=\"labeliftrue\">\n+          <para>\n+            Continue at\n+            <replaceable>labeliftrue</replaceable>\n+            if the condition is true.\n+\t\t\t\t\tTakes the form similar to Goto() of [[context,]extension,]priority.\n+          </para>\n+        </argument>\n+        <argument name=\"labeliffalse\">\n+          <para>\n+            Continue at\n+            <replaceable>labeliffalse</replaceable>\n+            if the condition is false.\n+\t\t\t\t\tTakes the form similar to Goto() of [[context,]extension,]priority.\n+          </para>\n+        </argument>\n       </parameter>\n     </syntax>\n     <description>\n       <para>\n-        Hangup a channel after a certain time. Acknowledges set time with\n-        <literal>Timeout Set</literal>\n-        message.\n+        This application will set the context, extension, and priority in the channel structure\n+\t\t\tbased on the evaluation of the given time specification. After this application completes,\n+\t\t\tthe pbx engine will continue dialplan execution at the specified location in the dialplan.\n+\t\t\tIf the current time is within the given time specification, the channel will continue at\n+        <replaceable>labeliftrue</replaceable>\n+        . Otherwise the channel will continue at\n+        <replaceable>labeliffalse</replaceable>\n+        .\n+\t\t\tIf the label chosen by the condition is omitted, no jump is performed, and execution passes to the next\n+\t\t\tinstruction. If the target jump location is bogus, the same actions would be taken as for\n+        <literal>Goto</literal>\n+        .\n+\t\t\tFurther information on the time specification can be found in examples\n+\t\t\tillustrating how to do time-based context includes in the dialplan.\n       </para>\n     </description>\n-  </manager>\n-  <manager name=\"MailboxStatus\" language=\"en_US\">\n-    <synopsis>Check mailbox.</synopsis>\n-    <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"Mailbox\" required=\"true\">\n-        <para>\n-          Full mailbox ID\n-          <replaceable>mailbox</replaceable>\n-          @\n-          <replaceable>vm-context</replaceable>\n-          .\n-        </para>\n+    <see-also>\n+      <ref type=\"application\">GotoIf</ref>\n+      <ref type=\"application\">Goto</ref>\n+      <ref type=\"function\">IFTIME</ref>\n+      <ref type=\"function\">TESTTIME</ref>\n+    </see-also>\n+  </application>\n+  <application name=\"ImportVar\" language=\"en_US\">\n+    <synopsis>Import a variable from a channel into a new variable.</synopsis>\n+    <syntax argsep=\"=\">\n+      <parameter name=\"newvar\" required=\"true\"/>\n+      <parameter name=\"vardata\" required=\"true\">\n+        <argument name=\"channelname\" required=\"true\"/>\n+        <argument name=\"variable\" required=\"true\"/>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>Checks a voicemail account for status.</para>\n-      <para>Returns whether there are messages waiting.</para>\n-      <para>Message: Mailbox Status.</para>\n-      <para>\n-        Mailbox:\n-        <replaceable>mailboxid</replaceable>\n-        .\n-      </para>\n       <para>\n-        Waiting:\n-        <literal>0</literal>\n-        if messages waiting,\n-        <literal>1</literal>\n-        if no messages waiting.\n+        This application imports a\n+        <replaceable>variable</replaceable>\n+        from the specified\n+        <replaceable>channel</replaceable>\n+        (as opposed to the current one) and stores it as a variable\n+\t\t\t(\n+        <replaceable>newvar</replaceable>\n+        ) in the current channel (the channel that is calling this\n+\t\t\tapplication). Variables created by this application have the same inheritance properties as those\n+\t\t\tcreated with the\n+        <literal>Set</literal>\n+        application.\n       </para>\n     </description>\n     <see-also>\n-      <ref type=\"manager\">MailboxCount</ref>\n+      <ref type=\"application\">Set</ref>\n     </see-also>\n-  </manager>\n-  <manager name=\"MailboxCount\" language=\"en_US\">\n-    <synopsis>Check Mailbox Message Count.</synopsis>\n+  </application>\n+  <application name=\"Hangup\" language=\"en_US\">\n+    <synopsis>Hang up the calling channel.</synopsis>\n     <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"Mailbox\" required=\"true\">\n+      <parameter name=\"causecode\">\n         <para>\n-          Full mailbox ID\n-          <replaceable>mailbox</replaceable>\n-          @\n-          <replaceable>vm-context</replaceable>\n-          .\n+          If a\n+          <replaceable>causecode</replaceable>\n+          is given the channel's\n+\t\t\t\thangup cause will be set to the given value.\n         </para>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>Checks a voicemail account for new messages.</para>\n-      <para>Returns number of urgent, new and old messages.</para>\n-      <para>Message: Mailbox Message Count</para>\n-      <para>\n-        Mailbox:\n-        <replaceable>mailboxid</replaceable>\n-      </para>\n-      <para>\n-        UrgentMessages:\n-        <replaceable>count</replaceable>\n-      </para>\n-      <para>\n-        NewMessages:\n-        <replaceable>count</replaceable>\n-      </para>\n-      <para>\n-        OldMessages:\n-        <replaceable>count</replaceable>\n-      </para>\n+      <para>This application will hang up the calling channel.</para>\n     </description>\n     <see-also>\n-      <ref type=\"manager\">MailboxStatus</ref>\n+      <ref type=\"application\">Answer</ref>\n+      <ref type=\"application\">Busy</ref>\n+      <ref type=\"application\">Congestion</ref>\n     </see-also>\n-  </manager>\n-  <manager name=\"ListCommands\" language=\"en_US\">\n-    <synopsis>List available manager commands.</synopsis>\n+  </application>\n+  <application name=\"Incomplete\" language=\"en_US\">\n+    <synopsis>Returns AST_PBX_INCOMPLETE value.</synopsis>\n     <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      <parameter name=\"n\">\n+        <para>If specified, then Incomplete will not attempt to answer the channel first.</para>\n+        <note>\n+          <para>Most channel types need to be in Answer state in order to receive DTMF.</para>\n+        </note>\n+      </parameter>\n     </syntax>\n     <description>\n-      <para>Returns the action name and synopsis for every action that\n-\t\t\tis available to the user.</para>\n+      <para>Signals the PBX routines that the previous matched extension is incomplete\n+\t\t\tand that further input should be allowed before matching can be considered\n+\t\t\tto be complete.  Can be used within a pattern match when certain criteria warrants\n+\t\t\ta longer match.</para>\n     </description>\n-  </manager>\n-  <manager name=\"SendText\" language=\"en_US\">\n-    <synopsis>Sends a text message to channel. A content type\tcan be optionally specified. If not set\n-\t\t\tit is set to an empty string allowing a custom handler to default it as it sees fit.</synopsis>\n+  </application>\n+  <application name=\"NoOp\" language=\"en_US\">\n+    <synopsis>Do Nothing (No Operation).</synopsis>\n     <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"Channel\" required=\"true\">\n-        <para>Channel to send message to.</para>\n-      </parameter>\n-      <parameter name=\"Message\" required=\"true\">\n-        <para>Message to send.</para>\n-      </parameter>\n-      <parameter name=\"Content-Type\" required=\"false\" default=\"\">\n-        <para>The type of content in the message</para>\n+      <parameter name=\"text\">\n+        <para>Any text provided can be viewed at the Asterisk CLI.</para>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>Sends A Text Message to a channel while in a call.</para>\n+      <para>This application does nothing. However, it is useful for debugging purposes.</para>\n+      <para>This method can be used to see the evaluations of variables or functions without having any effect.</para>\n     </description>\n     <see-also>\n-      <ref type=\"application\">SendText</ref>\n+      <ref type=\"application\">Verbose</ref>\n+      <ref type=\"application\">Log</ref>\n     </see-also>\n-  </manager>\n-  <manager name=\"UserEvent\" language=\"en_US\">\n-    <synopsis>Send an arbitrary event.</synopsis>\n-    <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"UserEvent\" required=\"true\">\n-        <para>Event string to send.</para>\n-      </parameter>\n-      <parameter name=\"Header1\">\n-        <para>Content1.</para>\n-      </parameter>\n-      <parameter name=\"HeaderN\">\n-        <para>ContentN.</para>\n-      </parameter>\n-    </syntax>\n+  </application>\n+  <application name=\"Proceeding\" language=\"en_US\">\n+    <synopsis>Indicate proceeding.</synopsis>\n+    <syntax/>\n     <description>\n-      <para>Send an event to manager sessions.</para>\n+      <para>This application will request that a proceeding message be provided to the calling channel.</para>\n+    </description>\n+  </application>\n+  <application name=\"Progress\" language=\"en_US\">\n+    <synopsis>Indicate progress.</synopsis>\n+    <syntax/>\n+    <description>\n+      <para>This application will request that in-band progress information be provided to the calling channel.</para>\n     </description>\n     <see-also>\n-      <ref type=\"managerEvent\">UserEvent</ref>\n-      <ref type=\"application\">UserEvent</ref>\n+      <ref type=\"application\">Busy</ref>\n+      <ref type=\"application\">Congestion</ref>\n+      <ref type=\"application\">Ringing</ref>\n+      <ref type=\"application\">Playtones</ref>\n     </see-also>\n-  </manager>\n-  <manager name=\"WaitEvent\" language=\"en_US\">\n-    <synopsis>Wait for an event to occur.</synopsis>\n+  </application>\n+  <application name=\"RaiseException\" language=\"en_US\">\n+    <synopsis>Handle an exceptional condition.</synopsis>\n     <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"Timeout\" required=\"true\">\n-        <para>\n-          Maximum time (in seconds) to wait for events,\n-          <literal>-1</literal>\n-          means forever.\n-        </para>\n-      </parameter>\n+      <parameter name=\"reason\" required=\"true\"/>\n     </syntax>\n     <description>\n       <para>\n-        This action will elicit a\n-        <literal>Success</literal>\n-        response. Whenever\n-\t\t\ta manager event is queued. Once WaitEvent has been called on an HTTP manager\n-\t\t\tsession, events will be generated and queued.\n+        This application will jump to the\n+        <literal>e</literal>\n+        extension in the current context, setting the\n+\t\t\tdialplan function EXCEPTION(). If the\n+        <literal>e</literal>\n+        extension does not exist, the call will hangup.\n       </para>\n     </description>\n-  </manager>\n-  <manager name=\"CoreSettings\" language=\"en_US\">\n-    <synopsis>Show PBX core settings (version etc).</synopsis>\n+    <see-also>\n+      <ref type=\"function\">Exception</ref>\n+    </see-also>\n+  </application>\n+  <application name=\"Ringing\" language=\"en_US\">\n+    <synopsis>Indicate ringing tone.</synopsis>\n+    <syntax/>\n+    <description>\n+      <para>This application will request that the channel indicate a ringing tone to the user.</para>\n+    </description>\n+    <see-also>\n+      <ref type=\"application\">Busy</ref>\n+      <ref type=\"application\">Congestion</ref>\n+      <ref type=\"application\">Progress</ref>\n+      <ref type=\"application\">Playtones</ref>\n+    </see-also>\n+  </application>\n+  <application name=\"SayAlpha\" language=\"en_US\">\n+    <synopsis>Say Alpha.</synopsis>\n     <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      <parameter name=\"string\" required=\"true\"/>\n     </syntax>\n     <description>\n-      <para>Query for Core PBX settings.</para>\n+      <para>\n+        This application will play the sounds that correspond to the letters\n+\t\t\tof the given\n+        <replaceable>string</replaceable>\n+        . If the channel variable\n+        <variable>SAY_DTMF_INTERRUPT</variable>\n+        is set to 'true' (case insensitive),\n+\t\t\tthen this application will react to DTMF in the\tsame way as\n+        <literal>Background</literal>\n+        .\n+      </para>\n     </description>\n-  </manager>\n-  <manager name=\"CoreStatus\" language=\"en_US\">\n-    <synopsis>Show PBX core status variables.</synopsis>\n+    <see-also>\n+      <ref type=\"application\">SayDigits</ref>\n+      <ref type=\"application\">SayMoney</ref>\n+      <ref type=\"application\">SayNumber</ref>\n+      <ref type=\"application\">SayOrdinal</ref>\n+      <ref type=\"application\">SayPhonetic</ref>\n+      <ref type=\"function\">CHANNEL</ref>\n+      <ref type=\"function\">SAYFILES</ref>\n+    </see-also>\n+  </application>\n+  <application name=\"SayAlphaCase\" language=\"en_US\">\n+    <synopsis>Say Alpha.</synopsis>\n     <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      <parameter name=\"casetype\" required=\"true\">\n+        <enumlist>\n+          <enum name=\"a\">\n+            <para>Case sensitive (all) pronunciation.\n+\t\t\t\t\t\t(Ex: SayAlphaCase(a,aBc); - lowercase a uppercase b lowercase c).</para>\n+          </enum>\n+          <enum name=\"l\">\n+            <para>Case sensitive (lower) pronunciation.\n+\t\t\t\t\t\t(Ex: SayAlphaCase(l,aBc); - lowercase a b lowercase c).</para>\n+          </enum>\n+          <enum name=\"n\">\n+            <para>Case insensitive pronunciation. Equivalent to SayAlpha.\n+\t\t\t\t\t\t(Ex: SayAlphaCase(n,aBc) - a b c).</para>\n+          </enum>\n+          <enum name=\"u\">\n+            <para>Case sensitive (upper) pronunciation.\n+\t\t\t\t\t\t(Ex: SayAlphaCase(u,aBc); - a uppercase b c).</para>\n+          </enum>\n+        </enumlist>\n+      </parameter>\n+      <parameter name=\"string\" required=\"true\"/>\n     </syntax>\n     <description>\n-      <para>Query for Core PBX status.</para>\n+      <para>\n+        This application will play the sounds that correspond to the letters of the\n+\t\t\tgiven\n+        <replaceable>string</replaceable>\n+        .  Optionally, a\n+        <replaceable>casetype</replaceable>\n+        may be\n+\t\t\tspecified.  This will be used for case-insensitive or case-sensitive pronunciations. If the channel\n+\t\t\tvariable\n+        <variable>SAY_DTMF_INTERRUPT</variable>\n+        is set to 'true' (case insensitive), then this\n+\t\t\tapplication will react to DTMF in the same way as\n+        <literal>Background</literal>\n+        .\n+      </para>\n     </description>\n-  </manager>\n-  <manager name=\"Reload\" language=\"en_US\">\n-    <synopsis>Send a reload event.</synopsis>\n+    <see-also>\n+      <ref type=\"application\">SayDigits</ref>\n+      <ref type=\"application\">SayMoney</ref>\n+      <ref type=\"application\">SayNumber</ref>\n+      <ref type=\"application\">SayOrdinal</ref>\n+      <ref type=\"application\">SayPhonetic</ref>\n+      <ref type=\"application\">SayAlpha</ref>\n+      <ref type=\"function\">CHANNEL</ref>\n+    </see-also>\n+  </application>\n+  <application name=\"SayDigits\" language=\"en_US\">\n+    <synopsis>Say Digits.</synopsis>\n     <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"Module\">\n-        <para>Name of the module to reload.</para>\n-      </parameter>\n+      <parameter name=\"digits\" required=\"true\"/>\n     </syntax>\n     <description>\n-      <para>Send a reload event.</para>\n+      <para>\n+        This application will play the sounds that correspond to the digits of\n+\t\t\tthe given number. This will use the language that is currently set for the channel.\n+\t\t\tIf the channel variable\n+        <variable>SAY_DTMF_INTERRUPT</variable>\n+        is set to 'true'\n+\t\t\t(case insensitive), then this application will react to DTMF in the same way as\n+        <literal>Background</literal>\n+        .\n+      </para>\n     </description>\n     <see-also>\n-      <ref type=\"manager\">ModuleLoad</ref>\n+      <ref type=\"application\">SayAlpha</ref>\n+      <ref type=\"application\">SayMoney</ref>\n+      <ref type=\"application\">SayNumber</ref>\n+      <ref type=\"application\">SayOrdinal</ref>\n+      <ref type=\"application\">SayPhonetic</ref>\n+      <ref type=\"function\">CHANNEL</ref>\n+      <ref type=\"function\">SAYFILES</ref>\n     </see-also>\n-  </manager>\n-  <managerEvent language=\"en_US\" name=\"CoreShowChannel\">\n-    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n-      <synopsis>Raised in response to a CoreShowChannels command.</synopsis>\n-      <syntax>\n-        <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-        <channel_snapshot/>\n-        <parameter name=\"BridgeId\">\n-          <para>Identifier of the bridge the channel is in, may be empty if not in one</para>\n-        </parameter>\n-        <parameter name=\"Application\">\n-          <para>Application currently executing on the channel</para>\n-        </parameter>\n-        <parameter name=\"ApplicationData\">\n-          <para>Data given to the currently executing application</para>\n-        </parameter>\n-        <parameter name=\"Duration\">\n-          <para>The amount of time the channel has existed</para>\n-        </parameter>\n-      </syntax>\n-      <see-also>\n-        <ref type=\"manager\">CoreShowChannels</ref>\n-        <ref type=\"managerEvent\">CoreShowChannelsComplete</ref>\n-      </see-also>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <managerEvent language=\"en_US\" name=\"CoreShowChannelsComplete\">\n-    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n-      <synopsis>Raised at the end of the CoreShowChannel list produced by the CoreShowChannels command.</synopsis>\n-      <syntax>\n-        <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-        <parameter name=\"EventList\">\n-          <para>Conveys the status of the command reponse list</para>\n-        </parameter>\n-        <parameter name=\"ListItems\">\n-          <para>The total number of list items produced</para>\n-        </parameter>\n-      </syntax>\n-      <see-also>\n-        <ref type=\"manager\">CoreShowChannels</ref>\n-        <ref type=\"managerEvent\">CoreShowChannel</ref>\n-      </see-also>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <manager name=\"CoreShowChannels\" language=\"en_US\">\n-    <synopsis>List currently active channels.</synopsis>\n+  </application>\n+  <application name=\"SayMoney\" language=\"en_US\">\n+    <synopsis>Say Money.</synopsis>\n     <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      <parameter name=\"dollars\" required=\"true\"/>\n     </syntax>\n     <description>\n-      <para>List currently defined channels and some information about them.</para>\n+      <para>\n+        This application will play the currency sounds for the given floating point number\n+\t\t\tin the current language. Currently only English and US Dollars is supported.\n+\t\t\tIf the channel variable\n+        <variable>SAY_DTMF_INTERRUPT</variable>\n+        is set to 'true'\n+\t\t\t(case insensitive), then this application will react to DTMF in the same way as\n+        <literal>Background</literal>\n+        .\n+      </para>\n     </description>\n-    <responses>\n-      <list-elements>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='CoreShowChannel'])\"/>\n-      </list-elements>\n-      <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='CoreShowChannelsComplete'])\"/>\n-    </responses>\n-  </manager>\n-  <manager name=\"LoggerRotate\" language=\"en_US\">\n-    <synopsis>Reload and rotate the Asterisk logger.</synopsis>\n+    <see-also>\n+      <ref type=\"application\">SayAlpha</ref>\n+      <ref type=\"application\">SayNumber</ref>\n+      <ref type=\"application\">SayOrdinal</ref>\n+      <ref type=\"application\">SayPhonetic</ref>\n+      <ref type=\"function\">CHANNEL</ref>\n+      <ref type=\"function\">SAYFILES</ref>\n+    </see-also>\n+  </application>\n+  <application name=\"SayNumber\" language=\"en_US\">\n+    <synopsis>Say Number.</synopsis>\n     <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      <parameter name=\"digits\" required=\"true\"/>\n+      <parameter name=\"gender\"/>\n     </syntax>\n     <description>\n-      <para>Reload and rotate the logger. Analogous to the CLI command 'logger rotate'.</para>\n+      <para>\n+        This application will play the sounds that correspond to the given\n+        <replaceable>digits</replaceable>\n+        . Optionally, a\n+        <replaceable>gender</replaceable>\n+        may be\n+\t\t\tspecified. This will use the language that is currently set for the channel. See the CHANNEL()\n+\t\t\tfunction for more information on setting the language for the channel. If the channel variable\n+        <variable>SAY_DTMF_INTERRUPT</variable>\n+        is set to 'true' (case insensitive), then this\n+\t\t\tapplication will react to DTMF in the same way as\n+        <literal>Background</literal>\n+        .\n+      </para>\n     </description>\n-  </manager>\n-  <manager name=\"ModuleLoad\" language=\"en_US\">\n-    <synopsis>Module management.</synopsis>\n+    <see-also>\n+      <ref type=\"application\">SayAlpha</ref>\n+      <ref type=\"application\">SayDigits</ref>\n+      <ref type=\"application\">SayMoney</ref>\n+      <ref type=\"application\">SayPhonetic</ref>\n+      <ref type=\"function\">CHANNEL</ref>\n+      <ref type=\"function\">SAYFILES</ref>\n+    </see-also>\n+  </application>\n+  <application name=\"SayOrdinal\" language=\"en_US\">\n+    <synopsis>Say Ordinal Number.</synopsis>\n     <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"Module\">\n-        <para>Asterisk module name (including .so extension) or subsystem identifier:</para>\n-        <enumlist>\n-          <enum name=\"cdr\"/>\n-          <enum name=\"dnsmgr\"/>\n-          <enum name=\"extconfig\"/>\n-          <enum name=\"enum\"/>\n-          <enum name=\"acl\"/>\n-          <enum name=\"manager\"/>\n-          <enum name=\"http\"/>\n-          <enum name=\"logger\"/>\n-          <enum name=\"features\"/>\n-          <enum name=\"dsp\"/>\n-          <enum name=\"udptl\"/>\n-          <enum name=\"indications\"/>\n-          <enum name=\"cel\"/>\n-          <enum name=\"plc\"/>\n-        </enumlist>\n-      </parameter>\n-      <parameter name=\"LoadType\" required=\"true\">\n-        <para>The operation to be done on module. Subsystem identifiers may only\n-\t\t\t\tbe reloaded.</para>\n-        <enumlist>\n-          <enum name=\"load\"/>\n-          <enum name=\"unload\"/>\n-          <enum name=\"reload\"/>\n-        </enumlist>\n-        <para>\n-          If no module is specified for a\n-          <literal>reload</literal>\n-          loadtype,\n-\t\t\t\tall modules are reloaded.\n-        </para>\n-      </parameter>\n+      <parameter name=\"digits\" required=\"true\"/>\n+      <parameter name=\"gender\"/>\n     </syntax>\n     <description>\n-      <para>Loads, unloads or reloads an Asterisk module in a running system.</para>\n+      <para>\n+        This application will play the ordinal sounds that correspond to the given\n+        <replaceable>digits</replaceable>\n+        (e.g. 1st, 42nd). Currently only English is supported.\n+      </para>\n+      <para>\n+        Optionally, a\n+        <replaceable>gender</replaceable>\n+        may be\n+\t\t\tspecified. This will use the language that is currently set for the channel. See the CHANNEL()\n+\t\t\tfunction for more information on setting the language for the channel. If the channel variable\n+        <variable>SAY_DTMF_INTERRUPT</variable>\n+        is set to 'true' (case insensitive), then this\n+\t\t\tapplication will react to DTMF in the same way as\n+        <literal>Background</literal>\n+        .\n+      </para>\n     </description>\n     <see-also>\n-      <ref type=\"manager\">Reload</ref>\n-      <ref type=\"manager\">ModuleCheck</ref>\n+      <ref type=\"application\">SayAlpha</ref>\n+      <ref type=\"application\">SayDigits</ref>\n+      <ref type=\"application\">SayMoney</ref>\n+      <ref type=\"application\">SayNumber</ref>\n+      <ref type=\"application\">SayPhonetic</ref>\n+      <ref type=\"function\">CHANNEL</ref>\n+      <ref type=\"function\">SAYFILES</ref>\n     </see-also>\n-  </manager>\n-  <manager name=\"ModuleCheck\" language=\"en_US\">\n-    <synopsis>Check if module is loaded.</synopsis>\n+  </application>\n+  <application name=\"SayPhonetic\" language=\"en_US\">\n+    <synopsis>Say Phonetic.</synopsis>\n     <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"Module\" required=\"true\">\n-        <para>Asterisk module name (not including extension).</para>\n-      </parameter>\n+      <parameter name=\"string\" required=\"true\"/>\n     </syntax>\n     <description>\n-      <para>Checks if Asterisk module is loaded. Will return Success/Failure.\n-\t\t\tFor success returns, the module revision number is included.</para>\n+      <para>\n+        This application will play the sounds from the phonetic alphabet that correspond to the\n+\t\t\tletters in the given\n+        <replaceable>string</replaceable>\n+        . If the channel variable\n+        <variable>SAY_DTMF_INTERRUPT</variable>\n+        is set to 'true' (case insensitive), then this\n+\t\t\tapplication will react to DTMF in the same way as\n+        <literal>Background</literal>\n+        .\n+      </para>\n     </description>\n     <see-also>\n-      <ref type=\"manager\">ModuleLoad</ref>\n+      <ref type=\"application\">SayAlpha</ref>\n+      <ref type=\"application\">SayDigits</ref>\n+      <ref type=\"application\">SayMoney</ref>\n+      <ref type=\"application\">SayNumber</ref>\n+      <ref type=\"application\">SayOrdinal</ref>\n+      <ref type=\"function\">SAYFILES</ref>\n     </see-also>\n-  </manager>\n-  <manager name=\"AOCMessage\" language=\"en_US\">\n-    <synopsis>Generate an Advice of Charge message on a channel.</synopsis>\n+  </application>\n+  <application name=\"SetAMAFlags\" language=\"en_US\">\n+    <synopsis>Set the AMA Flags.</synopsis>\n     <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"Channel\" required=\"true\">\n-        <para>Channel name to generate the AOC message on.</para>\n-      </parameter>\n-      <parameter name=\"ChannelPrefix\">\n-        <para>Partial channel prefix.  By using this option one can match the beginning part\n-\t\t\t\tof a channel name without having to put the entire name in.  For example\n-\t\t\t\tif a channel name is SIP/snom-00000001 and this value is set to SIP/snom, then\n-\t\t\t\tthat channel matches and the message will be sent.  Note however that only\n-\t\t\t\tthe first matched channel has the message sent on it.</para>\n-      </parameter>\n-      <parameter name=\"MsgType\" required=\"true\">\n-        <para>Defines what type of AOC message to create, AOC-D or AOC-E</para>\n-        <enumlist>\n-          <enum name=\"D\"/>\n-          <enum name=\"E\"/>\n-        </enumlist>\n-      </parameter>\n-      <parameter name=\"ChargeType\" required=\"true\">\n-        <para>Defines what kind of charge this message represents.</para>\n-        <enumlist>\n-          <enum name=\"NA\"/>\n-          <enum name=\"FREE\"/>\n-          <enum name=\"Currency\"/>\n-          <enum name=\"Unit\"/>\n-        </enumlist>\n-      </parameter>\n-      <parameter name=\"UnitAmount(0)\">\n-        <para>This represents the amount of units charged. The ETSI AOC standard specifies that\n-\t\t\t\tthis value along with the optional UnitType value are entries in a list.  To accommodate this\n-\t\t\t\tthese values take an index value starting at 0 which can be used to generate this list of\n-\t\t\t\tunit entries.  For Example, If two unit entires were required this could be achieved by setting the\n-\t\t\t\tparamter UnitAmount(0)=1234 and UnitAmount(1)=5678.  Note that UnitAmount at index 0 is\n-\t\t\t\trequired when ChargeType=Unit, all other entries in the list are optional.</para>\n-      </parameter>\n-      <parameter name=\"UnitType(0)\">\n-        <para>Defines the type of unit.  ETSI AOC standard specifies this as an integer\n-\t\t\t\tvalue between 1 and 16, but this value is left open to accept any positive\n-\t\t\t\tinteger.  Like the UnitAmount parameter, this value represents a list entry\n-\t\t\t\tand has an index parameter that starts at 0.</para>\n-      </parameter>\n-      <parameter name=\"CurrencyName\">\n-        <para>Specifies the currency's name.  Note that this value is truncated after 10 characters.</para>\n-      </parameter>\n-      <parameter name=\"CurrencyAmount\">\n-        <para>Specifies the charge unit amount as a positive integer.  This value is required\n-\t\t\t\twhen ChargeType==Currency.</para>\n-      </parameter>\n-      <parameter name=\"CurrencyMultiplier\">\n-        <para>Specifies the currency multiplier.  This value is required when ChargeType==Currency.</para>\n-        <enumlist>\n-          <enum name=\"OneThousandth\"/>\n-          <enum name=\"OneHundredth\"/>\n-          <enum name=\"OneTenth\"/>\n-          <enum name=\"One\"/>\n-          <enum name=\"Ten\"/>\n-          <enum name=\"Hundred\"/>\n-          <enum name=\"Thousand\"/>\n-        </enumlist>\n-      </parameter>\n-      <parameter name=\"TotalType\" default=\"Total\">\n-        <para>Defines what kind of AOC-D total is represented.</para>\n-        <enumlist>\n-          <enum name=\"Total\"/>\n-          <enum name=\"SubTotal\"/>\n-        </enumlist>\n-      </parameter>\n-      <parameter name=\"AOCBillingId\">\n-        <para>Represents a billing ID associated with an AOC-D or AOC-E message. Note\n-\t\t\t\tthat only the first 3 items of the enum are valid AOC-D billing IDs</para>\n-        <enumlist>\n-          <enum name=\"Normal\"/>\n-          <enum name=\"ReverseCharge\"/>\n-          <enum name=\"CreditCard\"/>\n-          <enum name=\"CallFwdUnconditional\"/>\n-          <enum name=\"CallFwdBusy\"/>\n-          <enum name=\"CallFwdNoReply\"/>\n-          <enum name=\"CallDeflection\"/>\n-          <enum name=\"CallTransfer\"/>\n-        </enumlist>\n-      </parameter>\n-      <parameter name=\"ChargingAssociationId\">\n-        <para>Charging association identifier.  This is optional for AOC-E and can be\n-\t\t\t\tset to any value between -32768 and 32767</para>\n-      </parameter>\n-      <parameter name=\"ChargingAssociationNumber\">\n-        <para>Represents the charging association party number.  This value is optional\n-\t\t\t\tfor AOC-E.</para>\n-      </parameter>\n-      <parameter name=\"ChargingAssociationPlan\">\n-        <para>Integer representing the charging plan associated with the ChargingAssociationNumber.\n-\t\t\t\tThe value is bits 7 through 1 of the Q.931 octet containing the type-of-number and\n-\t\t\t\tnumbering-plan-identification fields.</para>\n-      </parameter>\n+      <parameter name=\"flag\"/>\n     </syntax>\n     <description>\n-      <para>Generates an AOC-D or AOC-E message on a channel.</para>\n+      <para>This application will set the channel's AMA Flags for billing purposes.</para>\n+      <warning>\n+        <para>This application is deprecated. Please use the CHANNEL function instead.</para>\n+      </warning>\n     </description>\n     <see-also>\n-      <ref type=\"managerEvent\">AOC-D</ref>\n-      <ref type=\"managerEvent\">AOC-E</ref>\n+      <ref type=\"function\">CDR</ref>\n+      <ref type=\"function\">CHANNEL</ref>\n     </see-also>\n-  </manager>\n-  <function name=\"AMI_CLIENT\" language=\"en_US\">\n-    <synopsis>Checks attributes of manager accounts</synopsis>\n+  </application>\n+  <application name=\"Wait\" language=\"en_US\">\n+    <synopsis>Waits for some time.</synopsis>\n     <syntax>\n-      <parameter name=\"loginname\" required=\"true\">\n-        <para>Login name, specified in manager.conf</para>\n-      </parameter>\n-      <parameter name=\"field\" required=\"true\">\n-        <para>The manager account attribute to return</para>\n-        <enumlist>\n-          <enum name=\"sessions\">\n-            <para>The number of sessions for this AMI account</para>\n-          </enum>\n-        </enumlist>\n+      <parameter name=\"seconds\" required=\"true\">\n+        <para>\n+          Can be passed with fractions of a second. For example,\n+          <literal>1.5</literal>\n+          will ask the\n+\t\t\t\tapplication to wait for 1.5 seconds.\n+        </para>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>Currently, the only supported  parameter is &quot;sessions&quot; which will return the current number of\n-\t\t\t\tactive sessions for this AMI account.</para>\n+      <para>\n+        This application waits for a specified number of\n+        <replaceable>seconds</replaceable>\n+        .\n+      </para>\n     </description>\n-  </function>\n-  <manager name=\"Filter\" language=\"en_US\">\n-    <synopsis>Dynamically add filters for the current manager session.</synopsis>\n+  </application>\n+  <application name=\"WaitDigit\" language=\"en_US\">\n+    <synopsis>Waits for a digit to be entered.</synopsis>\n     <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"Operation\">\n-        <enumlist>\n-          <enum name=\"Add\">\n-            <para>Add a filter.</para>\n-          </enum>\n-        </enumlist>\n+      <parameter name=\"seconds\">\n+        <para>\n+          Can be passed with fractions of a second. For example,\n+          <literal>1.5</literal>\n+          will ask the\n+\t\t\t\tapplication to wait for 1.5 seconds.\n+        </para>\n       </parameter>\n-      <parameter name=\"Filter\">\n-        <para>Filters can be whitelist or blacklist</para>\n-        <para>Example whitelist filter: &quot;Event: Newchannel&quot;</para>\n-        <para>Example blacklist filter: &quot;!Channel: DAHDI.*&quot;</para>\n-        <para>This filter option is used to whitelist or blacklist events per user to be\n-\t\t\t\treported with regular expressions and are allowed if both the regex matches\n-\t\t\t\tand the user has read access as defined in manager.conf. Filters are assumed to be for whitelisting\n-\t\t\t\tunless preceeded by an exclamation point, which marks it as being black.\n-\t\t\t\tEvaluation of the filters is as follows:</para>\n-        <para>- If no filters are configured all events are reported as normal.</para>\n-        <para>- If there are white filters only: implied black all filter processed first, then white filters.</para>\n-        <para>- If there are black filters only: implied white all filter processed first, then black filters.</para>\n-        <para>- If there are both white and black filters: implied black all filter processed first, then white\n-\t\t\t\tfilters, and lastly black filters.</para>\n+      <parameter name=\"digits\">\n+        <para>Digits to accept, all others are ignored.</para>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>The filters added are only used for the current session.\n-\t\t\tOnce the connection is closed the filters are removed.</para>\n-      <para>This comand requires the system permission because\n-\t\t\tthis command can be used to create filters that may bypass\n-\t\t\tfilters defined in manager.conf</para>\n-    </description>\n-    <see-also>\n-      <ref type=\"manager\">FilterList</ref>\n-    </see-also>\n-  </manager>\n-  <manager name=\"FilterList\" language=\"en_US\">\n-    <synopsis>Show current event filters for this session</synopsis>\n-    <description>\n-      <para>The filters displayed are for the current session.  Only those filters defined in\n-                        manager.conf will be present upon starting a new session.</para>\n+      <para>\n+        This application waits for the user to press one of the accepted\n+        <replaceable>digits</replaceable>\n+        for a specified number of\n+        <replaceable>seconds</replaceable>\n+        .\n+      </para>\n+      <variablelist>\n+        <variable name=\"WAITDIGITSTATUS\">\n+          <para>This is the final status of the command</para>\n+          <value name=\"ERROR\">Parameters are invalid.</value>\n+          <value name=\"DTMF\">An accepted digit was received.</value>\n+          <value name=\"TIMEOUT\">The timeout passed before any acceptable digits were received.</value>\n+          <value name=\"CANCEL\">The channel has hungup or was redirected.</value>\n+        </variable>\n+        <variable name=\"WAITDIGITRESULT\">\n+          <para>\n+            The digit that was received, only set if\n+            <variable>WAITDIGITSTATUS</variable>\n+            is\n+            <literal>DTMF</literal>\n+            .\n+          </para>\n+        </variable>\n+      </variablelist>\n     </description>\n     <see-also>\n-      <ref type=\"manager\">Filter</ref>\n+      <ref type=\"application\">Wait</ref>\n+      <ref type=\"application\">WaitExten</ref>\n     </see-also>\n-  </manager>\n-  <manager name=\"BlindTransfer\" language=\"en_US\">\n-    <synopsis>Blind transfer channel(s) to the given destination</synopsis>\n+  </application>\n+  <application name=\"WaitExten\" language=\"en_US\">\n+    <synopsis>Waits for an extension to be entered.</synopsis>\n     <syntax>\n-      <parameter name=\"Channel\" required=\"true\"/>\n-      <parameter name=\"Context\"/>\n-      <parameter name=\"Exten\"/>\n+      <parameter name=\"seconds\">\n+        <para>\n+          Can be passed with fractions of a second. For example,\n+          <literal>1.5</literal>\n+          will ask the\n+\t\t\t\tapplication to wait for 1.5 seconds.\n+        </para>\n+      </parameter>\n+      <parameter name=\"options\">\n+        <optionlist>\n+          <option name=\"m\">\n+            <para>Provide music on hold to the caller while waiting for an extension.</para>\n+            <argument name=\"x\">\n+              <para>\n+                Specify the class for music on hold.\n+                <emphasis>CHANNEL(musicclass) will\n+\t\t\t\t\t\t\tbe used instead if set</emphasis>\n+              </para>\n+            </argument>\n+          </option>\n+          <option name=\"d\">\n+            <para>\n+              Play\n+              <literal>dial</literal>\n+              indications tone on channel while waiting\n+\t\t\t\t\t\tfor digits.\n+            </para>\n+          </option>\n+        </optionlist>\n+      </parameter>\n     </syntax>\n     <description>\n-      <para>Redirect all channels currently bridged to the specified channel to the specified destination.</para>\n+      <para>\n+        This application waits for the user to enter a new extension for a specified number\n+\t\t\tof\n+        <replaceable>seconds</replaceable>\n+        .\n+      </para>\n+      <xi:include xpointer=\"xpointer(/docs/application[@name='Macro']/description/warning[2])\"/>\n     </description>\n     <see-also>\n-      <ref type=\"manager\">Redirect</ref>\n-      <ref type=\"managerEvent\">BlindTransfer</ref>\n+      <ref type=\"application\">Background</ref>\n+      <ref type=\"function\">TIMEOUT</ref>\n     </see-also>\n-  </manager>\n-  <managerEvent name=\"ExtensionStatus\" language=\"en_US\">\n-    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n-      <synopsis>Raised when a hint changes due to a device state change.</synopsis>\n-      <syntax>\n-        <parameter name=\"Exten\">\n-          <para>Name of the extension.</para>\n-        </parameter>\n-        <parameter name=\"Context\">\n-          <para>Context that owns the extension.</para>\n-        </parameter>\n-        <parameter name=\"Hint\">\n-          <para>Hint set for the extension</para>\n-        </parameter>\n-        <parameter name=\"Status\">\n-          <para>Numerical value of the extension status. Extension\n-\t\t\t\t\tstatus is determined by the combined device state of all items\n-\t\t\t\t\tcontained in the hint.</para>\n-          <enumlist>\n-            <enum name=\"-2\">\n-              <para>The extension was removed from the dialplan.</para>\n-            </enum>\n-            <enum name=\"-1\">\n-              <para>The extension's hint was removed from the dialplan.</para>\n-            </enum>\n-            <enum name=\"0\">\n-              <para>\n-                <literal>Idle</literal>\n-                - Related device(s) are in an idle\n-\t\t\t\t\t\t\tstate.\n-              </para>\n-            </enum>\n-            <enum name=\"1\">\n-              <para>\n-                <literal>InUse</literal>\n-                - Related device(s) are in active\n-\t\t\t\t\t\t\tcalls but may take more calls.\n-              </para>\n-            </enum>\n-            <enum name=\"2\">\n-              <para>\n-                <literal>Busy</literal>\n-                - Related device(s) are in active\n-\t\t\t\t\t\t\tcalls and may not take any more calls.\n-              </para>\n-            </enum>\n-            <enum name=\"4\">\n-              <para>\n-                <literal>Unavailable</literal>\n-                - Related device(s) are\n-\t\t\t\t\t\t\tnot reachable.\n-              </para>\n-            </enum>\n-            <enum name=\"8\">\n-              <para>\n-                <literal>Ringing</literal>\n-                - Related device(s) are\n-\t\t\t\t\t\t\tcurrently ringing.\n-              </para>\n-            </enum>\n-            <enum name=\"9\">\n-              <para>\n-                <literal>InUse&amp;Ringing</literal>\n-                - Related device(s)\n-\t\t\t\t\t\t\tare currently ringing and in active calls.\n-              </para>\n-            </enum>\n-            <enum name=\"16\">\n-              <para>\n-                <literal>Hold</literal>\n-                - Related device(s) are\n-\t\t\t\t\t\t\tcurrently on hold.\n-              </para>\n-            </enum>\n-            <enum name=\"17\">\n-              <para>\n-                <literal>InUse&amp;Hold</literal>\n-                - Related device(s)\n-\t\t\t\t\t\t\tare currently on hold and in active calls.\n-              </para>\n-            </enum>\n-          </enumlist>\n-        </parameter>\n-        <parameter name=\"StatusText\">\n-          <para>\n-            Text representation of\n-            <literal>Status</literal>\n-            .\n-          </para>\n-          <enumlist>\n-            <enum name=\"Idle\"/>\n-            <enum name=\"InUse\"/>\n-            <enum name=\"Busy\"/>\n-            <enum name=\"Unavailable\"/>\n-            <enum name=\"Ringing\"/>\n-            <enum name=\"InUse&amp;Ringing\"/>\n-            <enum name=\"Hold\"/>\n-            <enum name=\"InUse&amp;Hold\"/>\n-            <enum name=\"Unknown\">\n-              <para>Status does not match any of the above values.</para>\n-            </enum>\n-          </enumlist>\n-        </parameter>\n-      </syntax>\n-      <see-also>\n-        <ref type=\"manager\">ExtensionState</ref>\n-      </see-also>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <managerEvent name=\"PresenceStatus\" language=\"en_US\">\n-    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n-      <synopsis>Raised when a hint changes due to a presence state change.</synopsis>\n-      <syntax>\n-        <parameter name=\"Exten\"/>\n-        <parameter name=\"Context\"/>\n-        <parameter name=\"Hint\"/>\n-        <parameter name=\"Status\"/>\n-        <parameter name=\"Subtype\"/>\n-        <parameter name=\"Message\"/>\n-      </syntax>\n-      <see-also>\n-        <ref type=\"manager\">PresenceState</ref>\n-      </see-also>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <module language=\"en_US\" name=\"dns\">\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"timing\">\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"stasis_channels\">\n+  </application>\n+  <module language=\"en_US\" name=\"codec\">\n     <support_level>core</support_level>\n   </module>\n-  <managerEvent language=\"en_US\" name=\"VarSet\">\n-    <managerEventInstance class=\"EVENT_FLAG_DIALPLAN\">\n-      <synopsis>Raised when a variable is set to a particular value.</synopsis>\n-      <syntax>\n-        <channel_snapshot/>\n-        <parameter name=\"Variable\">\n-          <para>The variable being set.</para>\n-        </parameter>\n-        <parameter name=\"Value\">\n-          <para>The new value of the variable.</para>\n-        </parameter>\n-      </syntax>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <managerEvent language=\"en_US\" name=\"AgentLogin\">\n-    <managerEventInstance class=\"EVENT_FLAG_AGENT\">\n-      <synopsis>Raised when an Agent has logged in.</synopsis>\n-      <syntax>\n-        <channel_snapshot/>\n-        <parameter name=\"Agent\">\n-          <para>Agent ID of the agent.</para>\n-        </parameter>\n-      </syntax>\n-      <see-also>\n-        <ref type=\"application\">AgentLogin</ref>\n-        <ref type=\"managerEvent\">AgentLogoff</ref>\n-      </see-also>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <managerEvent language=\"en_US\" name=\"AgentLogoff\">\n-    <managerEventInstance class=\"EVENT_FLAG_AGENT\">\n-      <synopsis>Raised when an Agent has logged off.</synopsis>\n-      <syntax>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='AgentLogin']/managerEventInstance/syntax/parameter)\"/>\n-        <parameter name=\"Logintime\">\n-          <para>The number of seconds the agent was logged in.</para>\n-        </parameter>\n-      </syntax>\n-      <see-also>\n-        <ref type=\"managerEvent\">AgentLogin</ref>\n-      </see-also>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <managerEvent language=\"en_US\" name=\"ChannelTalkingStart\">\n-    <managerEventInstance class=\"EVENT_FLAG_CLASS\">\n-      <synopsis>Raised when talking is detected on a channel.</synopsis>\n-      <syntax>\n-        <channel_snapshot/>\n-      </syntax>\n-      <see-also>\n-        <ref type=\"function\">TALK_DETECT</ref>\n-        <ref type=\"managerEvent\">ChannelTalkingStop</ref>\n-      </see-also>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <managerEvent language=\"en_US\" name=\"ChannelTalkingStop\">\n-    <managerEventInstance class=\"EVENT_FLAG_CLASS\">\n-      <synopsis>Raised when talking is no longer detected on a channel.</synopsis>\n-      <syntax>\n-        <channel_snapshot/>\n-        <parameter name=\"Duration\">\n-          <para>The length in time, in milliseconds, that talking was\n-\t\t\t\t\tdetected on the channel.</para>\n-        </parameter>\n-      </syntax>\n-      <see-also>\n-        <ref type=\"function\">TALK_DETECT</ref>\n-        <ref type=\"managerEvent\">ChannelTalkingStart</ref>\n-      </see-also>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <module language=\"en_US\" name=\"dns_query_set\">\n-    <support_level>core</support_level>\n+  <module language=\"en_US\" name=\"res_hep_rtcp\">\n+    <depend>res_hep</depend>\n+    <support_level>extended</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"xmldoc\">\n+  <module language=\"en_US\" name=\"res_parking\">\n+    <depend>bridge_holding</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"fixedjitterbuf\">\n+  <configInfo name=\"res_parking\" language=\"en_US\">\n+    <configFile name=\"res_parking.conf\">\n+      <configObject name=\"globals\">\n+        <synopsis>Options that apply to every parking lot</synopsis>\n+        <configOption name=\"parkeddynamic\">\n+          <synopsis>Enables dynamically created parkinglots.</synopsis>\n+          <description>\n+            <para>If the option is enabled then the following variables can\n+\t\t\t\t\t\t\tbe used to dynamically create new parking lots.</para>\n+            <para>\n+              The\n+              <variable>PARKINGDYNAMIC</variable>\n+              variable specifies the\n+\t\t\t\t\t\t\tparking lot to use as a template to create a dynamic parking lot. It\n+\t\t\t\t\t\t\tis an error to specify a non-existent parking lot for the template.\n+\t\t\t\t\t\t\tIf not set then the default parking lot is used as the template.\n+            </para>\n+            <para>\n+              The\n+              <variable>PARKINGDYNCONTEXT</variable>\n+              variable specifies the\n+\t\t\t\t\t\t\tdialplan context to use for the newly created dynamic parking lot. If\n+\t\t\t\t\t\t\tnot set then the context from the parking lot template is used. The\n+\t\t\t\t\t\t\tcontext is created if it does not already exist and the new parking lot\n+\t\t\t\t\t\t\tneeds to create extensions.\n+            </para>\n+            <para>\n+              The\n+              <variable>PARKINGDYNEXTEN</variable>\n+              variable specifies the\n+              <literal>parkext</literal>\n+              to use for the newly created dynamic\n+\t\t\t\t\t\t\tparking lot. If not set then the\n+              <literal>parkext</literal>\n+              is used from\n+\t\t\t\t\t\t\tthe parking lot template. If the template does not specify a\n+              <literal>parkext</literal>\n+              then no extensions are created for the newly\n+\t\t\t\t\t\t\tcreated parking lot. The dynamic parking lot cannot be created if it\n+\t\t\t\t\t\t\tneeds to create extensions that overlap existing parking lot extensions.\n+\t\t\t\t\t\t\tThe only exception to this is for the\n+              <literal>parkext</literal>\n+              extension and only if neither of the overlaping parking lot's\n+              <literal>parkext</literal>\n+              is exclusive.\n+            </para>\n+            <para>\n+              The\n+              <variable>PARKINGDYNPOS</variable>\n+              variable specifies the\n+\t\t\t\t\t\t\tparking positions to use for the newly created dynamic parking lot. If\n+\t\t\t\t\t\t\tnot set then the\n+              <literal>parkpos</literal>\n+              from the parking lot template\n+\t\t\t\t\t\t\tis used.\n+            </para>\n+          </description>\n+        </configOption>\n+      </configObject>\n+      <configObject name=\"parking_lot\">\n+        <synopsis>Defined parking lots for res_parking to use to park calls on</synopsis>\n+        <configOption name=\"context\" default=\"parkedcalls\">\n+          <synopsis>The name of the context where calls are parked and picked up from.</synopsis>\n+          <description>\n+            <para>This option is only used if parkext is set.</para>\n+          </description>\n+        </configOption>\n+        <configOption name=\"parkext\">\n+          <synopsis>Extension to park calls to this parking lot.</synopsis>\n+          <description>\n+            <para>\n+              If this option is used, this extension will automatically\n+\t\t\t\t\t\t\tbe created to place calls into parking lots. In addition, if\n+              <literal>parkext_exclusive</literal>\n+              is set for this parking\n+\t\t\t\t\t\t\tlot, the name of the parking lot will be included in the\n+\t\t\t\t\t\t\tapplication's arguments so that it only parks to this parking\n+\t\t\t\t\t\t\tlot. The extension will be created in\n+              <literal>context</literal>\n+              .\n+\t\t\t\t\t\t\tUsing this option also creates extensions for retrieving\n+\t\t\t\t\t\t\tparked calls from the parking spaces in the same context.\n+            </para>\n+            <note>\n+              <para>\n+                Generated parking extensions cannot overlap.\n+\t\t\t\t\t\t\t\tThe only exception is if neither overlapping\n+                <literal>parkext</literal>\n+                is exclusive.\n+              </para>\n+            </note>\n+          </description>\n+        </configOption>\n+        <configOption name=\"parkext_exclusive\" default=\"no\">\n+          <synopsis>If yes, the extension registered as parkext will park exclusively to this parking lot.</synopsis>\n+        </configOption>\n+        <configOption name=\"parkpos\" default=\"701-750\">\n+          <synopsis>Numerical range of parking spaces which can be used to retrieve parked calls.</synopsis>\n+          <description>\n+            <para>\n+              If\n+              <literal>parkext</literal>\n+              is set, these extensions\n+\t\t\t\t\t\t\twill automatically be mapped in\n+              <literal>context</literal>\n+              in order to pick up calls parked to these parking spaces.\n+            </para>\n+          </description>\n+        </configOption>\n+        <configOption name=\"parkinghints\" default=\"no\">\n+          <synopsis>If yes, this parking lot will add hints automatically for parking spaces.</synopsis>\n+        </configOption>\n+        <configOption name=\"parkingtime\" default=\"45\">\n+          <synopsis>Amount of time a call will remain parked before giving up (in seconds).</synopsis>\n+        </configOption>\n+        <configOption name=\"parkedmusicclass\">\n+          <synopsis>Which music class to use for parked calls. They will use the default if unspecified.</synopsis>\n+        </configOption>\n+        <configOption name=\"comebacktoorigin\" default=\"yes\">\n+          <synopsis>Determines what should be done with the parked channel if no one picks it up before it times out.</synopsis>\n+          <description>\n+            <para>Valid Options:</para>\n+            <enumlist>\n+              <enum name=\"yes\">\n+                <para>\n+                  Automatically have the parked channel dial the device that parked the call with dial\n+\t\t\t\t\t\t\t\t\ttimeout set by the\n+                  <literal>parkingtime</literal>\n+                  option. When the call times out an extension\n+\t\t\t\t\t\t\t\t\tto dial the PARKER will automatically be created in the\n+                  <literal>park-dial</literal>\n+                  context with\n+\t\t\t\t\t\t\t\t\tan extension of the flattened parker device name. If the call is not answered, the parked channel\n+\t\t\t\t\t\t\t\t\tthat is timing out will continue in the dial plan at that point if there are more priorities in\n+\t\t\t\t\t\t\t\t\tthe extension (which won't be the case unless the dialplan deliberately includes such priorities\n+\t\t\t\t\t\t\t\t\tin the\n+                  <literal>park-dial</literal>\n+                  context through pattern matching or deliberately written\n+\t\t\t\t\t\t\t\t\tflattened peer extensions).\n+                </para>\n+              </enum>\n+              <enum name=\"no\">\n+                <para>\n+                  Place the call into the PBX at\n+                  <literal>comebackcontext</literal>\n+                  instead. The extension will\n+\t\t\t\t\t\t\t\t\tstill be set as the flattened peer name. If an extension the flattened peer name isn't available\n+\t\t\t\t\t\t\t\t\tthen it will fall back to the\n+                  <literal>s</literal>\n+                  extension. If that also is unavailable it will\n+\t\t\t\t\t\t\t\t\tattempt to fall back to\n+                  <literal>s@default</literal>\n+                  . The normal dial extension will still be\n+\t\t\t\t\t\t\t\t\tcreated in the\n+                  <literal>park-dial</literal>\n+                  context with the extension also being the flattened\n+\t\t\t\t\t\t\t\t\tpeer name.\n+                </para>\n+              </enum>\n+            </enumlist>\n+            <note>\n+              <para>\n+                Flattened Peer Names - Extensions can not include slash characters since those are used for pattern\n+\t\t\t\t\t\t\tmatching. When a peer name is flattened, slashes become underscores. For example if the parker of a call\n+\t\t\t\t\t\t\tis called\n+                <literal>SIP/0004F2040001</literal>\n+                then flattened peer name and therefor the extensions created\n+\t\t\t\t\t\t\tand used on timeouts will be\n+                <literal>SIP_0004F204001</literal>\n+                .\n+              </para>\n+            </note>\n+            <note>\n+              <para>When parking times out and the channel returns to the dial plan, the following variables are set:</para>\n+            </note>\n+            <variablelist>\n+              <variable name=\"PARKING_SPACE\">\n+                <para>extension that the call was parked in prior to timing out.</para>\n+              </variable>\n+              <variable name=\"PARKINGSLOT\">\n+                <para>\n+                  Deprecated.  Use\n+                  <variable>PARKING_SPACE</variable>\n+                  instead.\n+                </para>\n+              </variable>\n+              <variable name=\"PARKEDLOT\">\n+                <para>name of the lot that the call was parked in prior to timing out.</para>\n+              </variable>\n+              <variable name=\"PARKER\">\n+                <para>The device that parked the call</para>\n+              </variable>\n+              <variable name=\"PARKER_FLAT\">\n+                <para>\n+                  The flat version of\n+                  <variable>PARKER</variable>\n+                </para>\n+              </variable>\n+            </variablelist>\n+          </description>\n+        </configOption>\n+        <configOption name=\"comebackdialtime\" default=\"30\">\n+          <synopsis>Timeout for the Dial extension created to call back the parker when a parked call times out.</synopsis>\n+        </configOption>\n+        <configOption name=\"comebackcontext\" default=\"parkedcallstimeout\">\n+          <synopsis>Context where parked calls will enter the PBX on timeout when comebacktoorigin=no</synopsis>\n+          <description>\n+            <para>The extension the call enters will prioritize the flattened peer name in this context.\n+\t\t\t\t\t\tIf the flattened peer name extension is unavailable, then the 's' extension in this context will be\n+\t\t\t\t\t\tused. If that also is unavailable, the 's' extension in the 'default' context will be used.</para>\n+          </description>\n+        </configOption>\n+        <configOption name=\"courtesytone\">\n+          <synopsis>If the name of a sound file is provided, use this as the courtesy tone</synopsis>\n+          <description>\n+            <para>\n+              By default, this tone is only played to the caller of a parked call. Who receives the tone\n+\t\t\t\t\t\tcan be changed using the\n+              <literal>parkedplay</literal>\n+              option.\n+            </para>\n+          </description>\n+        </configOption>\n+        <configOption name=\"parkedplay\" default=\"caller\">\n+          <synopsis>Who we should play the courtesytone to on the pickup of a parked call from this lot</synopsis>\n+          <description>\n+            <enumlist>\n+              <enum name=\"no\">\n+                <para>Apply to neither side.</para>\n+              </enum>\n+              <enum name=\"caller\">\n+                <para>Apply only to the call connecting with the call coming out of the parking lot.</para>\n+              </enum>\n+              <enum name=\"callee\">\n+                <para>Apply only to the call coming out of the parking lot.</para>\n+              </enum>\n+              <enum name=\"both\">\n+                <para>Apply to both sides.</para>\n+              </enum>\n+            </enumlist>\n+            <note>\n+              <para>If courtesy tone is not specified then this option will be ignored.</para>\n+            </note>\n+          </description>\n+        </configOption>\n+        <configOption name=\"parkedcalltransfers\" default=\"no\">\n+          <synopsis>Who to apply the DTMF transfer features to when parked calls are picked up or timeout.</synopsis>\n+          <description>\n+            <xi:include xpointer=\"xpointer(/docs/configInfo[@name='res_parking']/configFile[@name='res_parking.conf']/configObject[@name='parking_lot']/configOption[@name='parkedplay']/description/enumlist)\"/>\n+          </description>\n+        </configOption>\n+        <configOption name=\"parkedcallreparking\" default=\"no\">\n+          <synopsis>Who to apply the DTMF parking feature to when parked calls are picked up or timeout.</synopsis>\n+          <description>\n+            <xi:include xpointer=\"xpointer(/docs/configInfo[@name='res_parking']/configFile[@name='res_parking.conf']/configObject[@name='parking_lot']/configOption[@name='parkedplay']/description/enumlist)\"/>\n+          </description>\n+        </configOption>\n+        <configOption name=\"parkedcallhangup\" default=\"no\">\n+          <synopsis>Who to apply the DTMF hangup feature to when parked calls are picked up or timeout.</synopsis>\n+          <description>\n+            <xi:include xpointer=\"xpointer(/docs/configInfo[@name='res_parking']/configFile[@name='res_parking.conf']/configObject[@name='parking_lot']/configOption[@name='parkedplay']/description/enumlist)\"/>\n+          </description>\n+        </configOption>\n+        <configOption name=\"parkedcallrecording\" default=\"no\">\n+          <synopsis>Who to apply the DTMF MixMonitor recording feature to when parked calls are picked up or timeout.</synopsis>\n+          <description>\n+            <xi:include xpointer=\"xpointer(/docs/configInfo[@name='res_parking']/configFile[@name='res_parking.conf']/configObject[@name='parking_lot']/configOption[@name='parkedplay']/description/enumlist)\"/>\n+          </description>\n+        </configOption>\n+        <configOption name=\"findslot\" default=\"first\">\n+          <synopsis>Rule to use when trying to figure out which parking space a call should be parked with.</synopsis>\n+          <description>\n+            <enumlist>\n+              <enum name=\"first\">\n+                <para>Always try to place in the lowest available space in the parking lot</para>\n+              </enum>\n+              <enum name=\"next\">\n+                <para>Track the last parking space used and always attempt to use the one immediately after.</para>\n+              </enum>\n+            </enumlist>\n+          </description>\n+        </configOption>\n+      </configObject>\n+    </configFile>\n+  </configInfo>\n+  <module language=\"en_US\" name=\"res_pjsip_mwi\">\n+    <depend>pjproject</depend>\n+    <depend>res_pjsip</depend>\n+    <depend>res_pjsip_pubsub</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"codec\">\n-    <support_level>core</support_level>\n+  <module language=\"en_US\" name=\"res_hep_pjsip\">\n+    <depend>pjproject</depend>\n+    <depend>res_pjsip</depend>\n+    <depend>res_pjsip_session</depend>\n+    <depend>res_hep</depend>\n+    <support_level>extended</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"chanvars\">\n+  <module language=\"en_US\" name=\"res_pjsip_dialog_info_body_generator\">\n+    <depend>pjproject</depend>\n+    <depend>res_pjsip</depend>\n+    <depend>res_pjsip_pubsub</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"db\">\n+  <module language=\"en_US\" name=\"res_pjsip_path\">\n+    <depend>pjproject</depend>\n+    <depend>res_pjsip</depend>\n+    <depend>res_pjsip_session</depend>\n     <support_level>core</support_level>\n   </module>\n-  <manager name=\"DBGet\" language=\"en_US\">\n-    <synopsis>Get DB Entry.</synopsis>\n-    <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"Family\" required=\"true\"/>\n-      <parameter name=\"Key\" required=\"true\"/>\n-    </syntax>\n-    <description/>\n-  </manager>\n-  <manager name=\"DBGetTree\" language=\"en_US\">\n-    <synopsis>Get DB entries, optionally at a particular family/key</synopsis>\n-    <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"Family\" required=\"false\"/>\n-      <parameter name=\"Key\" required=\"false\"/>\n-    </syntax>\n-    <description/>\n-  </manager>\n-  <manager name=\"DBPut\" language=\"en_US\">\n-    <synopsis>Put DB entry.</synopsis>\n-    <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"Family\" required=\"true\"/>\n-      <parameter name=\"Key\" required=\"true\"/>\n-      <parameter name=\"Val\"/>\n-    </syntax>\n-    <description/>\n-  </manager>\n-  <manager name=\"DBDel\" language=\"en_US\">\n-    <synopsis>Delete DB entry.</synopsis>\n-    <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"Family\" required=\"true\"/>\n-      <parameter name=\"Key\" required=\"true\"/>\n-    </syntax>\n-    <description/>\n-  </manager>\n-  <manager name=\"DBDelTree\" language=\"en_US\">\n-    <synopsis>Delete DB Tree.</synopsis>\n-    <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"Family\" required=\"true\"/>\n-      <parameter name=\"Key\"/>\n-    </syntax>\n-    <description/>\n-  </manager>\n-  <module language=\"en_US\" name=\"dns_tlsa\">\n+  <module language=\"en_US\" name=\"res_format_attr_h264\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"channel_internal_api\">\n+  <module language=\"en_US\" name=\"res_mwi_external\">\n+    <defaultenabled>no</defaultenabled>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"options\">\n+  <configInfo name=\"res_mwi_external\" language=\"en_US\">\n+    <synopsis>Core external MWI support</synopsis>\n+    <configFile name=\"sorcery.conf\">\n+      <configObject name=\"mailboxes\">\n+        <synopsis>Persistent cache of external MWI Mailboxs.</synopsis>\n+        <description>\n+          <para>Allows the alteration of sorcery backend mapping for\n+\t\t\t\t\tthe persistent cache of external MWI mailboxes.</para>\n+        </description>\n+      </configObject>\n+    </configFile>\n+  </configInfo>\n+  <module language=\"en_US\" name=\"res_ari_applications\">\n+    <depend type=\"module\">res_ari</depend>\n+    <depend type=\"module\">res_ari_model</depend>\n+    <depend type=\"module\">res_stasis</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"test\">\n+  <module language=\"en_US\" name=\"res_format_attr_opus\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"dsp\">\n+  <module language=\"en_US\" name=\"res_pjsip_rfc3326\">\n+    <depend>pjproject</depend>\n+    <depend>res_pjsip</depend>\n+    <depend>res_pjsip_session</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"stasis_cache_pattern\">\n+  <module language=\"en_US\" name=\"res_security_log\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"translate\">\n+  <module language=\"en_US\" name=\"res_pjsip_send_to_voicemail\">\n+    <depend>pjproject</depend>\n+    <depend>res_pjsip</depend>\n+    <depend>res_pjsip_session</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"loader\">\n+  <module language=\"en_US\" name=\"res_pjproject\">\n+    <depend>pjproject</depend>\n+    <depend>res_sorcery_config</depend>\n     <support_level>core</support_level>\n   </module>\n-  <managerEvent language=\"en_US\" name=\"Reload\">\n-    <managerEventInstance class=\"EVENT_FLAG_SYSTEM\">\n-      <synopsis>Raised when a module has been reloaded in Asterisk.</synopsis>\n-      <syntax>\n-        <parameter name=\"Module\">\n-          <para>\n-            The name of the module that was reloaded, or\n-            <literal>All</literal>\n-            if all modules were reloaded\n-          </para>\n-        </parameter>\n-        <parameter name=\"Status\">\n-          <para>The numeric status code denoting the success or failure\n-\t\t\t\t\tof the reload request.</para>\n-          <enumlist>\n-            <enum name=\"0\">\n-              <para>Success</para>\n-            </enum>\n-            <enum name=\"1\">\n-              <para>Request queued</para>\n-            </enum>\n-            <enum name=\"2\">\n-              <para>Module not found</para>\n-            </enum>\n-            <enum name=\"3\">\n-              <para>Error</para>\n-            </enum>\n-            <enum name=\"4\">\n-              <para>Reload already in progress</para>\n-            </enum>\n-            <enum name=\"5\">\n-              <para>Module uninitialized</para>\n-            </enum>\n-            <enum name=\"6\">\n-              <para>Reload not supported</para>\n-            </enum>\n-          </enumlist>\n-        </parameter>\n-      </syntax>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <managerEvent language=\"en_US\" name=\"Load\">\n-    <managerEventInstance class=\"EVENT_FLAG_SYSTEM\">\n-      <synopsis>Raised when a module has been loaded in Asterisk.</synopsis>\n-      <syntax>\n-        <parameter name=\"Module\">\n-          <para>The name of the module that was loaded</para>\n-        </parameter>\n-        <parameter name=\"Status\">\n-          <para>The result of the load request.</para>\n-          <enumlist>\n-            <enum name=\"Failure\">\n-              <para>Module could not be loaded properly</para>\n-            </enum>\n-            <enum name=\"Success\">\n-              <para>Module loaded and configured</para>\n-            </enum>\n-            <enum name=\"Decline\">\n-              <para>Module is not configured</para>\n-            </enum>\n-          </enumlist>\n-        </parameter>\n-      </syntax>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <managerEvent language=\"en_US\" name=\"Unload\">\n-    <managerEventInstance class=\"EVENT_FLAG_SYSTEM\">\n-      <synopsis>Raised when a module has been unloaded in Asterisk.</synopsis>\n-      <syntax>\n-        <parameter name=\"Module\">\n-          <para>The name of the module that was unloaded</para>\n-        </parameter>\n-        <parameter name=\"Status\">\n-          <para>The result of the unload request.</para>\n-          <enumlist>\n-            <enum name=\"Success\">\n-              <para>Module unloaded successfully</para>\n-            </enum>\n-          </enumlist>\n-        </parameter>\n-      </syntax>\n-    </managerEventInstance>\n-  </managerEvent>\n+  <configInfo name=\"res_pjproject\" language=\"en_US\">\n+    <synopsis>pjproject common configuration</synopsis>\n+    <configFile name=\"pjproject.conf\">\n+      <configObject name=\"startup\">\n+        <synopsis>Asterisk startup time options for PJPROJECT</synopsis>\n+        <description>\n+          <note>\n+            <para>The id of this object, as well as its type, must be\n+\t\t\t\t\t'startup' or it won't be found.</para>\n+          </note>\n+        </description>\n+        <configOption name=\"type\">\n+          <synopsis>Must be of type 'startup'.</synopsis>\n+        </configOption>\n+        <configOption name=\"log_level\" default=\"2\">\n+          <synopsis>Initial maximum pjproject logging level to log.</synopsis>\n+          <description>\n+            <para>Valid values are: 0-6, and default</para>\n+            <note>\n+              <para>This option is needed very early in the startup process\n+\t\t\t\t\t\tso it can only be read from config files because the\n+\t\t\t\t\t\tmodules for other methods have not been loaded yet.</para>\n+            </note>\n+          </description>\n+        </configOption>\n+      </configObject>\n+      <configObject name=\"log_mappings\">\n+        <synopsis>PJPROJECT to Asterisk Log Level Mapping</synopsis>\n+        <description>\n+          <para>Warnings and errors in the pjproject libraries are generally handled\n+\t\t\t\t\tby Asterisk.  In many cases, Asterisk wouldn't even consider them to\n+\t\t\t\t\tbe warnings or errors so the messages emitted by pjproject directly\n+\t\t\t\t\tare either superfluous or misleading.  The 'log_mappings'\n+\t\t\t\t\tobject allows mapping the pjproject levels to Asterisk levels, or nothing.</para>\n+          <note>\n+            <para>The id of this object, as well as its type, must be\n+\t\t\t\t\t'log_mappings' or it won't be found.</para>\n+          </note>\n+        </description>\n+        <configOption name=\"type\">\n+          <synopsis>Must be of type 'log_mappings'.</synopsis>\n+        </configOption>\n+        <configOption name=\"asterisk_error\" default=\"0,1\">\n+          <synopsis>A comma separated list of pjproject log levels to map to Asterisk LOG_ERROR.</synopsis>\n+        </configOption>\n+        <configOption name=\"asterisk_warning\" default=\"2\">\n+          <synopsis>A comma separated list of pjproject log levels to map to Asterisk LOG_WARNING.</synopsis>\n+        </configOption>\n+        <configOption name=\"asterisk_notice\" default=\"\">\n+          <synopsis>A comma separated list of pjproject log levels to map to Asterisk LOG_NOTICE.</synopsis>\n+        </configOption>\n+        <configOption name=\"asterisk_verbose\" default=\"\">\n+          <synopsis>A comma separated list of pjproject log levels to map to Asterisk LOG_VERBOSE.</synopsis>\n+        </configOption>\n+        <configOption name=\"asterisk_debug\" default=\"3,4\">\n+          <synopsis>A comma separated list of pjproject log levels to map to Asterisk LOG_DEBUG.</synopsis>\n+        </configOption>\n+        <configOption name=\"asterisk_trace\" default=\"5,6\">\n+          <synopsis>A comma separated list of pjproject log levels to map to Asterisk LOG_TRACE.</synopsis>\n+        </configOption>\n+      </configObject>\n+    </configFile>\n+  </configInfo>\n   <module language=\"en_US\" name=\"res_ari_asterisk\">\n     <depend type=\"module\">res_ari</depend>\n     <depend type=\"module\">res_ari_model</depend>\n     <depend type=\"module\">res_stasis</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"res_pjsip_pidf_digium_body_supplement\">\n+  <module language=\"en_US\" name=\"res_format_attr_ilbc\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"res_pjsip_caller_id\">\n     <depend>pjproject</depend>\n     <depend>res_pjsip</depend>\n-    <depend>res_pjsip_pubsub</depend>\n+    <depend>res_pjsip_session</depend>\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"res_format_attr_h263\">\n     <support_level>core</support_level>\n   </module>\n+  <module language=\"en_US\" name=\"res_remb_modifier\">\n+    <defaultenabled>no</defaultenabled>\n+    <support_level>extended</support_level>\n+  </module>\n   <module language=\"en_US\" name=\"res_odbc_transaction\">\n     <depend>generic_odbc</depend>\n     <support_level>core</support_level>\n   </module>\n   <function name=\"ODBC\" language=\"en_US\">\n     <synopsis>Controls ODBC transaction properties.</synopsis>\n     <syntax>\n@@ -27188,78 +27627,298 @@\n       <para>\n         Rolls back the database transaction specified by\n         <replaceable>transaction ID</replaceable>\n         or the current active transaction, if not specified.\n       </para>\n     </description>\n   </application>\n-  <module language=\"en_US\" name=\"res_pjsip_nat\">\n-    <depend>pjproject</depend>\n-    <depend>res_pjsip</depend>\n-    <depend>res_pjsip_session</depend>\n+  <module language=\"en_US\" name=\"res_sorcery_memory_cache\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"res_pjsip_mwi\">\n-    <depend>pjproject</depend>\n-    <depend>res_pjsip</depend>\n-    <depend>res_pjsip_pubsub</depend>\n+  <manager name=\"SorceryMemoryCacheExpireObject\" language=\"en_US\">\n+    <synopsis>Expire (remove) an object from a sorcery memory cache.</synopsis>\n+    <syntax>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      <parameter name=\"Cache\" required=\"true\">\n+        <para>The name of the cache to expire the object from.</para>\n+      </parameter>\n+      <parameter name=\"Object\" required=\"true\">\n+        <para>The name of the object to expire.</para>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>Expires (removes) an object from a sorcery memory cache. If full backend caching is enabled\n+\t\t\tthis action is not available and will fail. In this case the SorceryMemoryCachePopulate or\n+\t\t\tSorceryMemoryCacheExpire AMI actions must be used instead.</para>\n+    </description>\n+  </manager>\n+  <manager name=\"SorceryMemoryCacheExpire\" language=\"en_US\">\n+    <synopsis>Expire (remove) ALL objects from a sorcery memory cache.</synopsis>\n+    <syntax>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      <parameter name=\"Cache\" required=\"true\">\n+        <para>The name of the cache to expire all objects from.</para>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>Expires (removes) ALL objects from a sorcery memory cache.</para>\n+    </description>\n+  </manager>\n+  <manager name=\"SorceryMemoryCacheStaleObject\" language=\"en_US\">\n+    <synopsis>Mark an object in a sorcery memory cache as stale.</synopsis>\n+    <syntax>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      <parameter name=\"Cache\" required=\"true\">\n+        <para>The name of the cache to mark the object as stale in.</para>\n+      </parameter>\n+      <parameter name=\"Object\" required=\"true\">\n+        <para>The name of the object to mark as stale.</para>\n+      </parameter>\n+      <parameter name=\"Reload\" required=\"false\">\n+        <para>If true, then immediately reload the object from the backend cache instead of waiting for the next retrieval</para>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>Marks an object as stale within a sorcery memory cache.</para>\n+    </description>\n+  </manager>\n+  <manager name=\"SorceryMemoryCacheStale\" language=\"en_US\">\n+    <synopsis>Marks ALL objects in a sorcery memory cache as stale.</synopsis>\n+    <syntax>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      <parameter name=\"Cache\" required=\"true\">\n+        <para>The name of the cache to mark all object as stale in.</para>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>Marks ALL objects in a sorcery memory cache as stale.</para>\n+    </description>\n+  </manager>\n+  <manager name=\"SorceryMemoryCachePopulate\" language=\"en_US\">\n+    <synopsis>Expire all objects from a memory cache and populate it with all objects from the backend.</synopsis>\n+    <syntax>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      <parameter name=\"Cache\" required=\"true\">\n+        <para>The name of the cache to populate.</para>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>Expires all objects from a memory cache and populate it with all objects from the backend.</para>\n+    </description>\n+  </manager>\n+  <module language=\"en_US\" name=\"res_config_odbc\">\n+    <depend>res_odbc</depend>\n+    <depend>generic_odbc</depend>\n     <support_level>core</support_level>\n   </module>\n   <module language=\"en_US\" name=\"res_ari_mailboxes\">\n     <depend type=\"module\">res_ari</depend>\n     <depend type=\"module\">res_ari_model</depend>\n     <depend type=\"module\">res_stasis</depend>\n     <depend type=\"module\">res_stasis_mailbox</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"res_pjsip_diversion\">\n+  <module language=\"en_US\" name=\"res_pjsip_phoneprov_provider\">\n     <depend>pjproject</depend>\n     <depend>res_pjsip</depend>\n-    <depend>res_pjsip_session</depend>\n-    <support_level>core</support_level>\n+    <depend>res_phoneprov</depend>\n+    <support_level>extended</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"res_pjsip_rfc3326\">\n+  <configInfo name=\"res_pjsip_phoneprov_provider\" language=\"en_US\">\n+    <synopsis>Module that integrates res_pjsip with res_phoneprov.</synopsis>\n+    <description>\n+      <para>\n+        <emphasis>PJSIP Phoneprov Provider</emphasis>\n+      </para>\n+      <para>\n+        This module creates the integration between\n+        <literal>res_pjsip</literal>\n+        and\n+        <literal>res_phoneprov</literal>\n+        .\n+      </para>\n+      <para>\n+        Each user to be integrated requires a\n+        <literal>phoneprov</literal>\n+        section defined in\n+        <filename>pjsip.conf</filename>\n+        .  Each section identifies\n+\t\t\tthe endpoint associated with the user and any other name/value pairs to be passed\n+\t\t\ton to res_phoneprov's template substitution.  Only\n+        <literal>MAC</literal>\n+        and\n+        <literal>PROFILE</literal>\n+        variables are required.  Any other variables\n+\t\t\tsupplied will be passed through.\n+      </para>\n+      <para/>\n+      <para>Example:</para>\n+      <para>[1000]</para>\n+      <para>type = phoneprovr</para>\n+      <para>endpoint = ep1000</para>\n+      <para>MAC = deadbeef4dad</para>\n+      <para>PROFILE = grandstream2</para>\n+      <para>LINEKEYS = 2</para>\n+      <para>LINE = 1</para>\n+      <para>OTHERVAR = othervalue</para>\n+      <para/>\n+      <para>The following variables are automatically defined if an endpoint\n+\t\t\tis defined for the user:</para>\n+      <enumlist>\n+        <enum name=\"USERNAME\">\n+          <para>Source: The user_name defined in the first auth reference\n+\t\t\t\tin the endpoint.</para>\n+        </enum>\n+        <enum name=\"SECRET\">\n+          <para>Source: The user_pass defined in the first auth reference\n+\t\t\t\tin the endpoint.</para>\n+        </enum>\n+        <enum name=\"CALLERID\">\n+          <para>Source: The number part of the callerid defined in\n+\t\t\t\tthe endpoint.</para>\n+        </enum>\n+        <enum name=\"DISPLAY_NAME\">\n+          <para>Source: The name part of the callerid defined in\n+\t\t\t\tthe endpoint.</para>\n+        </enum>\n+        <enum name=\"LABEL\">\n+          <para>Source: The id of the phoneprov section.</para>\n+        </enum>\n+      </enumlist>\n+      <para/>\n+      <para>In addition to the standard variables, the following are also automatically defined:</para>\n+      <enumlist>\n+        <enum name=\"ENDPOINT_ID\">\n+          <para>Source: The id of the endpoint.</para>\n+        </enum>\n+        <enum name=\"TRANSPORT_ID\">\n+          <para>Source: The id of the transport used by the endpoint.</para>\n+        </enum>\n+        <enum name=\"AUTH_ID\">\n+          <para>Source: The id of the auth used by the endpoint.</para>\n+        </enum>\n+      </enumlist>\n+      <para/>\n+      <para>All other template substitution variables must be explicitly defined in the\n+\t\t\tphoneprov_default or phoneprov sections.</para>\n+    </description>\n+    <configFile name=\"pjsip.conf\">\n+      <configObject name=\"phoneprov\">\n+        <synopsis>Provides variables for each user.</synopsis>\n+        <configOption name=\"type\">\n+          <synopsis>Must be of type 'phoneprov'.</synopsis>\n+        </configOption>\n+        <configOption name=\"endpoint\">\n+          <synopsis>The endpoint from which variables will be retrieved.</synopsis>\n+        </configOption>\n+        <configOption name=\"MAC\">\n+          <synopsis>The mac address for this user. (required)</synopsis>\n+        </configOption>\n+        <configOption name=\"PROFILE\">\n+          <synopsis>The phoneprov profile to use for this user. (required)</synopsis>\n+        </configOption>\n+        <configOption name=\"*\">\n+          <synopsis>Other name/value pairs to be passed through for use in templates.</synopsis>\n+        </configOption>\n+      </configObject>\n+    </configFile>\n+  </configInfo>\n+  <module language=\"en_US\" name=\"res_pjsip_xpidf_body_generator\">\n     <depend>pjproject</depend>\n     <depend>res_pjsip</depend>\n-    <depend>res_pjsip_session</depend>\n+    <depend>res_pjsip_pubsub</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"res_pjsip_endpoint_identifier_user\">\n-    <depend>pjproject</depend>\n-    <depend>res_pjsip</depend>\n-    <support_level>core</support_level>\n+  <module language=\"en_US\" name=\"res_phoneprov\">\n+    <support_level>extended</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"res_mwi_devstate\">\n+  <function name=\"PP_EACH_EXTENSION\" language=\"en_US\">\n+    <synopsis>Execute specified template for each extension.</synopsis>\n+    <syntax>\n+      <parameter name=\"mac\" required=\"true\"/>\n+      <parameter name=\"template_file\" required=\"true\"/>\n+    </syntax>\n+    <description>\n+      <para>Output the specified template for each extension associated with the specified MAC address.</para>\n+    </description>\n+  </function>\n+  <function name=\"PP_EACH_USER\" language=\"en_US\">\n+    <synopsis>Generate a string for each phoneprov user.</synopsis>\n+    <syntax>\n+      <parameter name=\"string\" required=\"true\"/>\n+      <parameter name=\"exclude_mac\" required=\"true\"/>\n+    </syntax>\n+    <description>\n+      <para>\n+        Pass in a string, with phoneprov variables you want substituted in the format of\n+\t\t\t%{VARNAME}, and you will get the string rendered for each user in phoneprov\n+\t\t\texcluding ones with MAC address\n+        <replaceable>exclude_mac</replaceable>\n+        . Probably not\n+\t\t\tuseful outside of res_phoneprov.\n+      </para>\n+      <para>Example: ${PP_EACH_USER(&lt;item&gt;&lt;fn&gt;%{DISPLAY_NAME}&lt;/fn&gt;&lt;/item&gt;|${MAC})</para>\n+    </description>\n+  </function>\n+  <module language=\"en_US\" name=\"res_crypto\">\n+    <depend>openssl</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"res_hep_rtcp\">\n-    <depend>res_hep</depend>\n-    <support_level>extended</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"res_remb_modifier\">\n-    <defaultenabled>no</defaultenabled>\n-    <support_level>extended</support_level>\n+  <module language=\"en_US\" name=\"res_pjsip_registrar\">\n+    <depend>pjproject</depend>\n+    <depend>res_pjproject</depend>\n+    <depend>res_pjsip</depend>\n+    <support_level>core</support_level>\n   </module>\n+  <manager name=\"PJSIPShowRegistrationsInbound\" language=\"en_US\">\n+    <synopsis>Lists PJSIP inbound registrations.</synopsis>\n+    <syntax/>\n+    <description>\n+      <para>\n+        In response,\n+        <literal>InboundRegistrationDetail</literal>\n+        events showing configuration\n+\t\t\tand status information are raised for all contacts, static or dynamic.  Once all events\n+\t\t\tare completed an\n+        <literal>InboundRegistrationDetailComplete</literal>\n+        is issued.\n+      </para>\n+      <warning>\n+        <para>\n+          This command just dumps all coonfigured AORs with contacts, even if the contact\n+\t\t\t\tis a permanent one.  To really get just inbound registrations, use\n+          <literal>PJSIPShowRegistrationInboundContactStatuses</literal>\n+          .\n+        </para>\n+      </warning>\n+    </description>\n+    <see-also>\n+      <ref type=\"manager\" module=\"res_pjsip_registrar\">PJSIPShowRegistrationInboundContactStatuses</ref>\n+    </see-also>\n+  </manager>\n+  <manager name=\"PJSIPShowRegistrationInboundContactStatuses\" language=\"en_US\">\n+    <synopsis>Lists ContactStatuses for PJSIP inbound registrations.</synopsis>\n+    <syntax/>\n+    <description>\n+      <para>\n+        In response,\n+        <literal>ContactStatusDetail</literal>\n+        events showing status information\n+\t\t\tare raised for each inbound registration (dynamic contact) object.  Once all events\n+\t\t\tare completed a\n+        <literal>ContactStatusDetailComplete</literal>\n+        event is issued.\n+      </para>\n+    </description>\n+  </manager>\n   <module language=\"en_US\" name=\"res_rtp_asterisk\">\n     <use type=\"external\">openssl</use>\n     <use type=\"external\">pjproject</use>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"res_snmp\">\n-    <depend>netsnmp</depend>\n-    <support_level>extended</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"res_clioriginate\">\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"res_stasis_mailbox\">\n-    <depend type=\"module\">res_stasis</depend>\n-    <depend type=\"module\">res_mwi_external</depend>\n-    <support_level>core</support_level>\n-  </module>\n   <module language=\"en_US\" name=\"res_pjsip_header_funcs\">\n     <depend>pjproject</depend>\n     <depend>res_pjsip</depend>\n     <depend>res_pjsip_session</depend>\n     <support_level>core</support_level>\n   </module>\n   <function name=\"PJSIP_HEADER\" language=\"en_US\">\n@@ -27515,777 +28174,730 @@\n       </para>\n     </description>\n     <see-also>\n       <ref type=\"function\">PJSIP_RESPONSE_HEADER</ref>\n       <ref type=\"function\">PJSIP_HEADERS</ref>\n     </see-also>\n   </function>\n-  <module language=\"en_US\" name=\"res_stasis_device_state\">\n-    <depend type=\"module\">res_stasis</depend>\n+  <module language=\"en_US\" name=\"res_pjsip_sips_contact\">\n+    <depend>pjproject</depend>\n+    <depend>res_pjsip</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"res_pjsip_publish_asterisk\">\n+  <module language=\"en_US\" name=\"res_pjsip_endpoint_identifier_user\">\n     <depend>pjproject</depend>\n     <depend>res_pjsip</depend>\n-    <depend>res_pjsip_outbound_publish</depend>\n-    <depend>res_pjsip_pubsub</depend>\n     <support_level>core</support_level>\n   </module>\n-  <configInfo name=\"res_pjsip_publish_asterisk\" language=\"en_US\">\n-    <synopsis>SIP resource for inbound and outbound Asterisk event publications</synopsis>\n-    <description>\n-      <para>\n-        <emphasis>Inbound and outbound Asterisk event publication</emphasis>\n-      </para>\n-      <para>\n-        This module allows\n-        <literal>res_pjsip</literal>\n-        to send and receive Asterisk event publications.\n-      </para>\n-    </description>\n-    <configFile name=\"pjsip.conf\">\n-      <configObject name=\"asterisk-publication\">\n-        <synopsis>The configuration for inbound Asterisk event publication</synopsis>\n-        <description>\n-          <para>\n-            Publish is\n-            <emphasis>COMPLETELY</emphasis>\n-            separate from the rest of\n-            <literal>pjsip.conf</literal>\n-            .\n-          </para>\n-        </description>\n-        <configOption name=\"devicestate_publish\">\n-          <synopsis>Optional name of a publish item that can be used to publish a request for full device state information.</synopsis>\n-        </configOption>\n-        <configOption name=\"mailboxstate_publish\">\n-          <synopsis>Optional name of a publish item that can be used to publish a request for full mailbox state information.</synopsis>\n-        </configOption>\n-        <configOption name=\"device_state\" default=\"no\">\n-          <synopsis>Whether we should permit incoming device state events.</synopsis>\n-        </configOption>\n-        <configOption name=\"device_state_filter\">\n-          <synopsis>Optional regular expression used to filter what devices we accept events for.</synopsis>\n-        </configOption>\n-        <configOption name=\"mailbox_state\" default=\"no\">\n-          <synopsis>Whether we should permit incoming mailbox state events.</synopsis>\n-        </configOption>\n-        <configOption name=\"mailbox_state_filter\">\n-          <synopsis>Optional regular expression used to filter what mailboxes we accept events for.</synopsis>\n-        </configOption>\n-        <configOption name=\"type\">\n-          <synopsis>Must be of type 'asterisk-publication'.</synopsis>\n-        </configOption>\n-      </configObject>\n-    </configFile>\n-  </configInfo>\n-  <module language=\"en_US\" name=\"res_format_attr_vp8\">\n+  <module language=\"en_US\" name=\"res_ari_sounds\">\n+    <depend type=\"module\">res_ari</depend>\n+    <depend type=\"module\">res_ari_model</depend>\n+    <depend type=\"module\">res_stasis</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"res_ari_channels\">\n+  <module language=\"en_US\" name=\"res_ari_bridges\">\n     <depend type=\"module\">res_ari</depend>\n     <depend type=\"module\">res_ari_model</depend>\n     <depend type=\"module\">res_stasis</depend>\n-    <depend type=\"module\">res_stasis_answer</depend>\n-    <depend type=\"module\">res_stasis_playback</depend>\n     <depend type=\"module\">res_stasis_recording</depend>\n-    <depend type=\"module\">res_stasis_snoop</depend>\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"res_pjsip_dlg_options\">\n-    <depend>pjproject</depend>\n-    <depend>res_pjsip</depend>\n-    <depend>res_pjsip_session</depend>\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"res_pjsip_sdp_rtp\">\n-    <depend>pjproject</depend>\n-    <depend>res_pjsip</depend>\n-    <depend>res_pjsip_session</depend>\n+    <depend type=\"module\">res_stasis_playback</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"res_stasis_snoop\">\n-    <depend type=\"module\">res_stasis</depend>\n+  <module language=\"en_US\" name=\"res_fax\">\n+    <conflict>app_fax</conflict>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"res_monitor\">\n-    <use type=\"module\">func_periodic_hook</use>\n-    <support_level>deprecated</support_level>\n-    <replacement>app_mixmonitor</replacement>\n-    <deprecated_in>16</deprecated_in>\n-    <removed_in>21</removed_in>\n-  </module>\n-  <application name=\"Monitor\" language=\"en_US\">\n-    <synopsis>Monitor a channel.</synopsis>\n+  <application name=\"ReceiveFAX\" language=\"en_US\" module=\"res_fax\">\n+    <synopsis>Receive a FAX and save as a TIFF/F file.</synopsis>\n     <syntax>\n-      <parameter name=\"file_format\" argsep=\":\">\n-        <argument name=\"file_format\" required=\"true\">\n-          <para>\n-            Optional.  If not set, defaults to\n-            <literal>wav</literal>\n-          </para>\n-        </argument>\n-        <argument name=\"urlbase\"/>\n-      </parameter>\n-      <parameter name=\"fname_base\">\n-        <para>If set, changes the filename used to the one specified.</para>\n-      </parameter>\n+      <parameter name=\"filename\" required=\"true\"/>\n       <parameter name=\"options\">\n         <optionlist>\n-          <option name=\"m\">\n-            <para>\n-              When the recording ends mix the two leg files into one and\n-\t\t\t\t\t\tdelete the two leg files. If the variable\n-              <variable>MONITOR_EXEC</variable>\n-              is set, the application referenced in it will be executed instead of\n-\t\t\t\t\t\tsoxmix/sox and the raw leg files will NOT be deleted automatically.\n-\t\t\t\t\t\tsoxmix/sox or\n-              <variable>MONITOR_EXEC</variable>\n-              is handed 3 arguments,\n-\t\t\t\t\t\tthe two leg files and a target mixed file name which is the same as\n-\t\t\t\t\t\tthe leg file names only without the in/out designator.\n-            </para>\n-            <para>\n-              If\n-              <variable>MONITOR_EXEC_ARGS</variable>\n-              is set, the contents\n-\t\t\t\t\t\twill be passed on as additional arguments to\n-              <variable>MONITOR_EXEC</variable>\n-              .\n-\t\t\t\t\t\tBoth\n-              <variable>MONITOR_EXEC</variable>\n-              and the Mix flag can be set from the\n-\t\t\t\t\t\tadministrator interface.\n-            </para>\n-            <warning>\n-              <para>\n-                Do not use untrusted strings such as\n-                <variable>CALLERID(num)</variable>\n-                or\n-                <variable>CALLERID(name)</variable>\n-                as part of\n-                <variable>MONITOR_EXEC</variable>\n-                or\n-                <variable>MONITOR_EXEC_ARGS</variable>\n-                .  You risk a command injection\n-\t\t\t\t\t\tattack executing arbitrary commands if the untrusted strings aren't\n-\t\t\t\t\t\tfiltered to remove dangerous characters.  See function\n-                <variable>FILTER()</variable>\n-                .\n-              </para>\n-            </warning>\n-          </option>\n-          <option name=\"b\">\n-            <para>Don't begin recording unless a call is bridged to another channel.</para>\n+          <option name=\"d\">\n+            <para>Enable FAX debugging.</para>\n           </option>\n-          <option name=\"B\">\n-            <para>Play a periodic beep while this call is being recorded.</para>\n-            <argument name=\"interval\">\n-              <para>Interval, in seconds. Default is 15.</para>\n-            </argument>\n+          <option name=\"f\">\n+            <para>Allow audio fallback FAX transfer on T.38 capable channels.</para>\n           </option>\n-          <option name=\"i\">\n-            <para>\n-              Skip recording of input stream (disables\n-              <literal>m</literal>\n-              option).\n-            </para>\n+          <option name=\"F\">\n+            <para>Force usage of audio mode on T.38 capable channels.</para>\n           </option>\n-          <option name=\"o\">\n-            <para>\n-              Skip recording of output stream (disables\n-              <literal>m</literal>\n-              option).\n-            </para>\n+          <option name=\"s\">\n+            <para>Send progress Manager events (overrides statusevents setting in res_fax.conf).</para>\n           </option>\n         </optionlist>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>Used to start monitoring a channel. The channel's input and output\n-\t\t\tvoice packets are logged to files until the channel hangs up or\n-\t\t\tmonitoring is stopped by the StopMonitor application.</para>\n-      <para>\n-        By default, files are stored to\n-        <filename>/var/spool/asterisk/monitor/</filename>\n-        .\n-\t\t\tReturns\n-        <literal>-1</literal>\n-        if monitor files can't be opened or if the channel is\n-\t\t\talready monitored, otherwise\n-        <literal>0</literal>\n-        .\n-      </para>\n+      <para>This application is provided by res_fax, which is a FAX technology agnostic module\n+ \t\t\tthat utilizes FAX technology resource modules to complete a FAX transmission.</para>\n+      <para>Session arguments can be set by the FAXOPT function and to check results of the ReceiveFax() application.</para>\n     </description>\n     <see-also>\n-      <ref type=\"application\">StopMonitor</ref>\n+      <ref type=\"function\">FAXOPT</ref>\n     </see-also>\n   </application>\n-  <application name=\"StopMonitor\" language=\"en_US\">\n-    <synopsis>Stop monitoring a channel.</synopsis>\n-    <syntax/>\n-    <description>\n-      <para>Stops monitoring a channel. Has no effect if the channel is not monitored.</para>\n-    </description>\n-  </application>\n-  <application name=\"ChangeMonitor\" language=\"en_US\">\n-    <synopsis>Change monitoring filename of a channel.</synopsis>\n+  <application name=\"SendFAX\" language=\"en_US\" module=\"res_fax\">\n+    <synopsis>Sends a specified TIFF/F file as a FAX.</synopsis>\n     <syntax>\n-      <parameter name=\"filename_base\" required=\"true\">\n-        <para>The new filename base to use for monitoring this channel.</para>\n+      <parameter name=\"filename\" required=\"true\" argsep=\"&amp;\">\n+        <argument name=\"filename2\" multiple=\"true\">\n+          <para>TIFF file to send as a FAX.</para>\n+        </argument>\n+      </parameter>\n+      <parameter name=\"options\">\n+        <optionlist>\n+          <option name=\"d\">\n+            <para>Enable FAX debugging.</para>\n+          </option>\n+          <option name=\"f\">\n+            <para>Allow audio fallback FAX transfer on T.38 capable channels.</para>\n+          </option>\n+          <option name=\"F\">\n+            <para>Force usage of audio mode on T.38 capable channels.</para>\n+          </option>\n+          <option name=\"s\">\n+            <para>Send progress Manager events (overrides statusevents setting in res_fax.conf).</para>\n+          </option>\n+          <option name=\"z\">\n+            <para>Initiate a T.38 reinvite on the channel if the remote end does not.</para>\n+          </option>\n+        </optionlist>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>Changes monitoring filename of a channel. Has no effect if the\n-\t\t\tchannel is not monitored.</para>\n-    </description>\n-  </application>\n-  <application name=\"PauseMonitor\" language=\"en_US\">\n-    <synopsis>Pause monitoring of a channel.</synopsis>\n-    <syntax/>\n-    <description>\n-      <para>Pauses monitoring of a channel until it is re-enabled by a call to UnpauseMonitor.</para>\n-    </description>\n-    <see-also>\n-      <ref type=\"application\">UnpauseMonitor</ref>\n-    </see-also>\n-  </application>\n-  <application name=\"UnpauseMonitor\" language=\"en_US\">\n-    <synopsis>Unpause monitoring of a channel.</synopsis>\n-    <syntax/>\n-    <description>\n-      <para>Unpauses monitoring of a channel on which monitoring had\n-\t\t\tpreviously been paused with PauseMonitor.</para>\n+      <para>This application is provided by res_fax, which is a FAX technology agnostic module\n+ \t\t\tthat utilizes FAX technology resource modules to complete a FAX transmission.</para>\n+      <para>Session arguments can be set by the FAXOPT function and to check results of the SendFax() application.</para>\n     </description>\n     <see-also>\n-      <ref type=\"application\">PauseMonitor</ref>\n+      <ref type=\"function\">FAXOPT</ref>\n     </see-also>\n   </application>\n-  <manager name=\"Monitor\" language=\"en_US\">\n-    <synopsis>Monitor a channel.</synopsis>\n+  <function name=\"FAXOPT\" language=\"en_US\" module=\"res_fax\">\n+    <synopsis>Gets/sets various pieces of information about a fax session.</synopsis>\n     <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"Channel\" required=\"true\">\n-        <para>Used to specify the channel to record.</para>\n-      </parameter>\n-      <parameter name=\"File\">\n-        <para>Is the name of the file created in the monitor spool directory.\n-\t\t\t\tDefaults to the same name as the channel (with slashes replaced with dashes).</para>\n-      </parameter>\n-      <parameter name=\"Format\">\n-        <para>\n-          Is the audio recording format. Defaults to\n-          <literal>wav</literal>\n-          .\n-        </para>\n-      </parameter>\n-      <parameter name=\"Mix\">\n-        <para>Boolean parameter as to whether to mix the input and output channels\n-\t\t\t\ttogether after the recording is finished.</para>\n+      <parameter name=\"item\" required=\"true\">\n+        <enumlist>\n+          <enum name=\"ecm\">\n+            <para>R/W Error Correction Mode (ECM) enable with 'yes', disable with 'no'.</para>\n+          </enum>\n+          <enum name=\"error\">\n+            <para>R/O FAX transmission error code upon failure.</para>\n+          </enum>\n+          <enum name=\"filename\">\n+            <para>R/O Filename of the first file of the FAX transmission.</para>\n+          </enum>\n+          <enum name=\"filenames\">\n+            <para>R/O Filenames of all of the files in the FAX transmission (comma separated).</para>\n+          </enum>\n+          <enum name=\"headerinfo\">\n+            <para>R/W FAX header information.</para>\n+          </enum>\n+          <enum name=\"localstationid\">\n+            <para>R/W Local Station Identification.</para>\n+          </enum>\n+          <enum name=\"minrate\">\n+            <para>R/W Minimum transfer rate set before transmission.</para>\n+          </enum>\n+          <enum name=\"maxrate\">\n+            <para>R/W Maximum transfer rate set before transmission.</para>\n+          </enum>\n+          <enum name=\"modem\">\n+            <para>R/W Modem type (v17/v27/v29).</para>\n+          </enum>\n+          <enum name=\"gateway\">\n+            <para>R/W T38 fax gateway, with optional fax activity timeout in seconds (yes[,timeout]/no)</para>\n+          </enum>\n+          <enum name=\"faxdetect\">\n+            <para>R/W Enable FAX detect with optional timeout in seconds (yes,t38,cng[,timeout]/no)</para>\n+          </enum>\n+          <enum name=\"pages\">\n+            <para>R/O Number of pages transferred.</para>\n+          </enum>\n+          <enum name=\"rate\">\n+            <para>R/O Negotiated transmission rate.</para>\n+          </enum>\n+          <enum name=\"remotestationid\">\n+            <para>R/O Remote Station Identification after transmission.</para>\n+          </enum>\n+          <enum name=\"resolution\">\n+            <para>R/O Negotiated image resolution after transmission.</para>\n+          </enum>\n+          <enum name=\"sessionid\">\n+            <para>R/O Session ID of the FAX transmission.</para>\n+          </enum>\n+          <enum name=\"status\">\n+            <para>R/O Result Status of the FAX transmission.</para>\n+          </enum>\n+          <enum name=\"statusstr\">\n+            <para>R/O Verbose Result Status of the FAX transmission.</para>\n+          </enum>\n+          <enum name=\"t38timeout\">\n+            <para>R/W The timeout used for T.38 negotiation.</para>\n+          </enum>\n+          <enum name=\"negotiate_both\">\n+            <para>R/W Upon v21 detection allow gateway to send negotiation requests to both T.38 endpoints, and do not wait on the &quot;other&quot; side to initiate (yes|no)</para>\n+          </enum>\n+        </enumlist>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>This action may be used to record the audio on a\n-\t\t\tspecified channel.</para>\n+      <para>\n+        FAXOPT can be used to override the settings for a FAX session listed in\n+        <filename>res_fax.conf</filename>\n+        ,\n+\t\t   \tit can also be used to retrieve information about a FAX session that has finished eg. pages/status.\n+      </para>\n     </description>\n-  </manager>\n-  <manager name=\"StopMonitor\" language=\"en_US\">\n-    <synopsis>Stop monitoring a channel.</synopsis>\n+    <see-also>\n+      <ref type=\"application\">ReceiveFax</ref>\n+      <ref type=\"application\">SendFax</ref>\n+    </see-also>\n+  </function>\n+  <manager name=\"FAXSessions\" language=\"en_US\">\n+    <synopsis>Lists active FAX sessions</synopsis>\n     <syntax>\n       <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"Channel\" required=\"true\">\n-        <para>The name of the channel monitored.</para>\n-      </parameter>\n     </syntax>\n     <description>\n-      <para>This action may be used to end a previously started 'Monitor' action.</para>\n+      <para>Will generate a series of FAXSession events with information about each FAXSession. Closes with\n+\t\t\ta FAXSessionsComplete event which includes a count of the included FAX sessions. This action works in\n+\t\t\tthe same manner as the CLI command 'fax show sessions'</para>\n     </description>\n   </manager>\n-  <manager name=\"ChangeMonitor\" language=\"en_US\">\n-    <synopsis>Change monitoring filename of a channel.</synopsis>\n+  <managerEvent language=\"en_US\" name=\"FAXSessionsEntry\">\n+    <managerEventInstance class=\"EVENT_FLAG_REPORTING\">\n+      <synopsis>A single list item for the FAXSessions AMI command</synopsis>\n+      <syntax>\n+        <parameter name=\"ActionID\" required=\"false\"/>\n+        <parameter name=\"Channel\">\n+          <para>Name of the channel responsible for the FAX session</para>\n+        </parameter>\n+        <parameter name=\"Technology\">\n+          <para>The FAX technology that the FAX session is using</para>\n+        </parameter>\n+        <parameter name=\"SessionNumber\">\n+          <para>The numerical identifier for this particular session</para>\n+        </parameter>\n+        <parameter name=\"SessionType\">\n+          <para>FAX session passthru/relay type</para>\n+          <enumlist>\n+            <enum name=\"G.711\"/>\n+            <enum name=\"T.38\"/>\n+          </enumlist>\n+        </parameter>\n+        <parameter name=\"Operation\">\n+          <para>FAX session operation type</para>\n+          <enumlist>\n+            <enum name=\"gateway\"/>\n+            <enum name=\"V.21\"/>\n+            <enum name=\"send\"/>\n+            <enum name=\"receive\"/>\n+            <enum name=\"none\"/>\n+          </enumlist>\n+        </parameter>\n+        <parameter name=\"State\">\n+          <para>Current state of the FAX session</para>\n+          <enumlist>\n+            <enum name=\"Uninitialized\"/>\n+            <enum name=\"Initialized\"/>\n+            <enum name=\"Open\"/>\n+            <enum name=\"Active\"/>\n+            <enum name=\"Complete\"/>\n+            <enum name=\"Reserved\"/>\n+            <enum name=\"Inactive\"/>\n+            <enum name=\"Unknown\"/>\n+          </enumlist>\n+        </parameter>\n+        <parameter name=\"Files\">\n+          <para>File or list of files associated with this FAX session</para>\n+        </parameter>\n+      </syntax>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <managerEvent language=\"en_US\" name=\"FAXSessionsComplete\">\n+    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n+      <synopsis>Raised when all FAXSession events are completed for a FAXSessions command</synopsis>\n+      <syntax>\n+        <parameter name=\"ActionID\" required=\"false\"/>\n+        <parameter name=\"Total\">\n+          <para>Count of FAXSession events sent in response to FAXSessions action</para>\n+        </parameter>\n+      </syntax>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <manager name=\"FAXSession\" language=\"en_US\">\n+    <synopsis>Responds with a detailed description of a single FAX session</synopsis>\n     <syntax>\n       <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"Channel\" required=\"true\">\n-        <para>Used to specify the channel to record.</para>\n-      </parameter>\n-      <parameter name=\"File\" required=\"true\">\n-        <para>Is the new name of the file created in the\n-\t\t\t\tmonitor spool directory.</para>\n+      <parameter name=\"SessionNumber\" required=\"true\">\n+        <para>The session ID of the fax the user is interested in.</para>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>This action may be used to change the file\n-\t\t\tstarted by a previous 'Monitor' action.</para>\n+      <para>Provides details about a specific FAX session. The response will include a common subset of\n+\t\t\tthe output from the CLI command 'fax show session &lt;session_number&gt;' for each technology. If the\n+\t\t\tFAX technolgy used by this session does not include a handler for FAXSession, then this action\n+\t\t\twill fail.</para>\n     </description>\n   </manager>\n-  <manager name=\"PauseMonitor\" language=\"en_US\">\n-    <synopsis>Pause monitoring of a channel.</synopsis>\n+  <managerEvent language=\"en_US\" name=\"FAXSession\">\n+    <managerEventInstance class=\"EVENT_FLAG_REPORTING\">\n+      <synopsis>Raised in response to FAXSession manager command</synopsis>\n+      <syntax>\n+        <parameter name=\"ActionID\" required=\"false\"/>\n+        <parameter name=\"SessionNumber\">\n+          <para>The numerical identifier for this particular session</para>\n+        </parameter>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FAXSessionsEntry']/managerEventInstance/syntax/parameter[@name='Operation'])\"/>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FAXSessionsEntry']/managerEventInstance/syntax/parameter[@name='State'])\"/>\n+        <parameter name=\"ErrorCorrectionMode\" required=\"false\">\n+          <para>Whether error correcting mode is enabled for the FAX session. This field is not\n+\t\t\t\t\tincluded when operation is 'V.21 Detect' or if operation is 'gateway' and state is\n+\t\t\t\t\t'Uninitialized'</para>\n+          <enumlist>\n+            <enum name=\"yes\"/>\n+            <enum name=\"no\"/>\n+          </enumlist>\n+        </parameter>\n+        <parameter name=\"DataRate\" required=\"false\">\n+          <para>Bit rate of the FAX. This field is not included when operation is 'V.21 Detect' or\n+\t\t\t\t\tif operation is 'gateway' and state is 'Uninitialized'.</para>\n+        </parameter>\n+        <parameter name=\"ImageResolution\" required=\"false\">\n+          <para>Resolution of each page of the FAX. Will be in the format of X_RESxY_RES. This field\n+\t\t\t\t\tis not included if the operation is anything other than Receive/Transmit.</para>\n+        </parameter>\n+        <parameter name=\"PageNumber\" required=\"false\">\n+          <para>Current number of pages transferred during this FAX session. May change as the FAX\n+\t\t\t\t\tprogresses. This field is not included when operation is 'V.21 Detect' or if operation is\n+\t\t\t\t\t'gateway' and state is 'Uninitialized'.</para>\n+        </parameter>\n+        <parameter name=\"FileName\" required=\"false\">\n+          <para>Filename of the image being sent/received for this FAX session. This field is not\n+\t\t\t\t\tincluded if Operation isn't 'send' or 'receive'.</para>\n+        </parameter>\n+        <parameter name=\"PagesTransmitted\" required=\"false\">\n+          <para>Total number of pages sent during this session. This field is not included if\n+\t\t\t\t\tOperation isn't 'send' or 'receive'. Will always be 0 for 'receive'.</para>\n+        </parameter>\n+        <parameter name=\"PagesReceived\" required=\"false\">\n+          <para>Total number of pages received during this session. This field is not included if\n+\t\t\t\t\tOperation is not 'send' or 'receive'. Will be 0 for 'send'.</para>\n+        </parameter>\n+        <parameter name=\"TotalBadLines\" required=\"false\">\n+          <para>Total number of bad lines sent/received during this session. This field is not\n+\t\t\t\t\tincluded if Operation is not 'send' or 'received'.</para>\n+        </parameter>\n+      </syntax>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <manager name=\"FAXStats\" language=\"en_US\">\n+    <synopsis>Responds with fax statistics</synopsis>\n     <syntax>\n       <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"Channel\" required=\"true\">\n-        <para>Used to specify the channel to record.</para>\n-      </parameter>\n     </syntax>\n     <description>\n-      <para>This action may be used to temporarily stop the\n-\t\t\trecording of a channel.</para>\n+      <para>Provides FAX statistics including the number of active sessions, reserved sessions, completed\n+\t\t\tsessions, failed sessions, and the number of receive/transmit attempts. This command provides all\n+\t\t\tof the non-technology specific information provided by the CLI command 'fax show stats'</para>\n     </description>\n   </manager>\n-  <manager name=\"UnpauseMonitor\" language=\"en_US\">\n-    <synopsis>Unpause monitoring of a channel.</synopsis>\n+  <managerEvent language=\"en_US\" name=\"FAXStats\">\n+    <managerEventInstance class=\"EVENT_FLAG_REPORTING\">\n+      <synopsis>Raised in response to FAXStats manager command</synopsis>\n+      <syntax>\n+        <parameter name=\"ActionID\" required=\"false\"/>\n+        <parameter name=\"CurrentSessions\" required=\"true\">\n+          <para>Number of active FAX sessions</para>\n+        </parameter>\n+        <parameter name=\"ReservedSessions\" required=\"true\">\n+          <para>Number of reserved FAX sessions</para>\n+        </parameter>\n+        <parameter name=\"TransmitAttempts\" required=\"true\">\n+          <para>Total FAX sessions for which Asterisk is/was the transmitter</para>\n+        </parameter>\n+        <parameter name=\"ReceiveAttempts\" required=\"true\">\n+          <para>Total FAX sessions for which Asterisk is/was the recipient</para>\n+        </parameter>\n+        <parameter name=\"CompletedFAXes\" required=\"true\">\n+          <para>Total FAX sessions which have been completed successfully</para>\n+        </parameter>\n+        <parameter name=\"FailedFAXes\" required=\"true\">\n+          <para>Total FAX sessions which failed to complete successfully</para>\n+        </parameter>\n+      </syntax>\n+    </managerEventInstance>\n+  </managerEvent>\n+  <module language=\"en_US\" name=\"agent\">\n+    <support_level>extended</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"res_pjsip_pidf_body_generator\">\n+    <depend>pjproject</depend>\n+    <depend>res_pjsip</depend>\n+    <depend>res_pjsip_pubsub</depend>\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"res_manager_presencestate\">\n+    <support_level>core</support_level>\n+  </module>\n+  <manager name=\"PresenceStateList\" language=\"en_US\">\n+    <synopsis>List the current known presence states.</synopsis>\n     <syntax>\n       <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"Channel\" required=\"true\">\n-        <para>Used to specify the channel to record.</para>\n-      </parameter>\n     </syntax>\n     <description>\n-      <para>This action may be used to re-enable recording\n-\t\t\tof a channel after calling PauseMonitor.</para>\n+      <para>\n+        This will list out all known presence states in a\n+\t\t\tsequence of\n+        <replaceable>PresenceStateChange</replaceable>\n+        events.\n+\t\t\tWhen finished, a\n+        <replaceable>PresenceStateListComplete</replaceable>\n+        event\n+\t\t\twill be emitted.\n+      </para>\n     </description>\n+    <see-also>\n+      <ref type=\"manager\">PresenceState</ref>\n+      <ref type=\"managerEvent\">PresenceStatus</ref>\n+      <ref type=\"function\">PRESENCE_STATE</ref>\n+    </see-also>\n+    <responses>\n+      <list-elements>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='PresenceStateChange'])\"/>\n+      </list-elements>\n+      <managerEvent name=\"PresenceStateListComplete\" language=\"en_US\">\n+        <managerEventInstance class=\"EVENT_FLAG_COMMAND\">\n+          <synopsis>Indicates the end of the list the current known extension states.</synopsis>\n+          <syntax>\n+            <parameter name=\"EventList\">\n+              <para>Conveys the status of the event list.</para>\n+            </parameter>\n+            <parameter name=\"ListItems\">\n+              <para>Conveys the number of statuses reported.</para>\n+            </parameter>\n+          </syntax>\n+        </managerEventInstance>\n+      </managerEvent>\n+    </responses>\n   </manager>\n   <module language=\"en_US\" name=\"res_ari_model\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"res_ari_endpoints\">\n-    <depend type=\"module\">res_ari</depend>\n-    <depend type=\"module\">res_ari_model</depend>\n-    <depend type=\"module\">res_stasis</depend>\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"res_pjsip_logger\">\n+  <module language=\"en_US\" name=\"res_pjsip_dtmf_info\">\n     <depend>pjproject</depend>\n     <depend>res_pjsip</depend>\n-    <defaultenabled>yes</defaultenabled>\n+    <depend>res_pjsip_session</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"res_pjsip_mwi_body_generator\">\n+  <module language=\"en_US\" name=\"res_speech\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"res_mwi_devstate\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"res_snmp\">\n+    <depend>netsnmp</depend>\n+    <support_level>extended</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"res_sorcery_memory\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"res_rtp_multicast\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"res_resolver_unbound\">\n+    <depend>unbound</depend>\n+    <support_level>core</support_level>\n+  </module>\n+  <configInfo name=\"res_resolver_unbound\" language=\"en_US\">\n+    <configFile name=\"resolver_unbound.conf\">\n+      <configObject name=\"general\">\n+        <synopsis>General options for res_resolver_unbound</synopsis>\n+        <configOption name=\"hosts\">\n+          <synopsis>Full path to an optional hosts file</synopsis>\n+          <description>\n+            <para>Hosts specified in a hosts file will be resolved within the resolver itself. If a value\n+\t\t\t\t\tof system is provided the system-specific file will be used.</para>\n+          </description>\n+        </configOption>\n+        <configOption name=\"resolv\">\n+          <synopsis>Full path to an optional resolv.conf file</synopsis>\n+          <description>\n+            <para>The resolv.conf file specifies the nameservers to contact when resolving queries. If a\n+\t\t\t\t\tvalue of system is provided the system-specific file will be used. If provided alongside explicit nameservers the\n+\t\t\t\t\tnameservers contained within the resolv.conf file will be used after all others.</para>\n+          </description>\n+        </configOption>\n+        <configOption name=\"nameserver\">\n+          <synopsis>Nameserver to use for queries</synopsis>\n+          <description>\n+            <para>An explicit nameserver can be specified which is used for resolving queries. If multiple\n+\t\t\t\t\tnameserver lines are specified the first will be the primary with failover occurring, in order, to the other\n+\t\t\t\t\tnameservers as backups. If provided alongside a resolv.conf file the nameservers explicitly specified will be\n+\t\t\t\t\tused before all others.</para>\n+          </description>\n+        </configOption>\n+        <configOption name=\"debug\">\n+          <synopsis>Unbound debug level</synopsis>\n+          <description>\n+            <para>The debugging level for the unbound resolver. While there is no explicit range generally\n+\t\t\t\t\tthe higher the number the more debug is output.</para>\n+          </description>\n+        </configOption>\n+        <configOption name=\"ta_file\">\n+          <synopsis>Trust anchor file</synopsis>\n+          <description>\n+            <para>Full path to a file with DS and DNSKEY records in zone file format. This file is provided\n+\t\t\t\t\tto unbound and is used as a source for trust anchors.</para>\n+          </description>\n+        </configOption>\n+      </configObject>\n+    </configFile>\n+  </configInfo>\n+  <module language=\"en_US\" name=\"res_pjsip_exten_state\">\n     <depend>pjproject</depend>\n     <depend>res_pjsip</depend>\n     <depend>res_pjsip_pubsub</depend>\n+    <depend>res_pjsip_outbound_publish</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"res_xmpp\">\n-    <depend>iksemel</depend>\n-    <use type=\"external\">openssl</use>\n-    <support_level>core</support_level>\n+  <module language=\"en_US\" name=\"res_calendar\">\n+    <support_level>extended</support_level>\n   </module>\n-  <application name=\"JabberSend\" language=\"en_US\" module=\"res_xmpp\">\n-    <synopsis>Sends an XMPP message to a buddy.</synopsis>\n+  <function name=\"CALENDAR_BUSY\" language=\"en_US\">\n+    <synopsis>Determine if the calendar is marked busy at this time.</synopsis>\n     <syntax>\n-      <parameter name=\"account\" required=\"true\">\n-        <para>The local named account to listen on (specified in\n-\t\t\t\txmpp.conf)</para>\n-      </parameter>\n-      <parameter name=\"jid\" required=\"true\">\n-        <para>Jabber ID of the buddy to send the message to. It can be a\n-\t\t\t\tbare JID (username@domain) or a full JID (username@domain/resource).</para>\n-      </parameter>\n-      <parameter name=\"message\" required=\"true\">\n-        <para>The message to send.</para>\n-      </parameter>\n+      <parameter name=\"calendar\" required=\"true\"/>\n     </syntax>\n     <description>\n-      <para>\n-        Sends the content of\n-        <replaceable>message</replaceable>\n-        as text message\n-\t\t\tfrom the given\n-        <replaceable>account</replaceable>\n-        to the buddy identified by\n-        <replaceable>jid</replaceable>\n-      </para>\n-      <para>\n-        The example below sends &quot;Hello world&quot; to\n-        <replaceable>bob@domain.com</replaceable>\n-        as an XMPP message from the account\n-        <replaceable>asterisk</replaceable>\n-        , configured in xmpp.conf.\n-      </para>\n-      <example title=\"Send 'Hello world' to Bob\">same =&gt; n,JabberSend(asterisk,bob@domain.com,Hello world)</example>\n+      <para>Check the specified calendar's current busy status.</para>\n     </description>\n     <see-also>\n-      <ref type=\"function\" module=\"res_xmpp\">JABBER_STATUS</ref>\n-      <ref type=\"function\" module=\"res_xmpp\">JABBER_RECEIVE</ref>\n+      <ref type=\"function\">CALENDAR_EVENT</ref>\n+      <ref type=\"function\">CALENDAR_QUERY</ref>\n+      <ref type=\"function\">CALENDAR_QUERY_RESULT</ref>\n+      <ref type=\"function\">CALENDAR_WRITE</ref>\n     </see-also>\n-  </application>\n-  <function name=\"JABBER_RECEIVE\" language=\"en_US\" module=\"res_xmpp\">\n-    <synopsis>Reads XMPP messages.</synopsis>\n+  </function>\n+  <function name=\"CALENDAR_EVENT\" language=\"en_US\">\n+    <synopsis>Get calendar event notification data from a notification call.</synopsis>\n     <syntax>\n-      <parameter name=\"account\" required=\"true\">\n-        <para>The local named account to listen on (specified in\n-\t\t\t\txmpp.conf)</para>\n-      </parameter>\n-      <parameter name=\"jid\" required=\"true\">\n-        <para>Jabber ID of the buddy to receive message from. It can be a\n-\t\t\t\tbare JID (username@domain) or a full JID (username@domain/resource).</para>\n-      </parameter>\n-      <parameter name=\"timeout\">\n-        <para>\n-          In seconds, defaults to\n-          <literal>20</literal>\n-          .\n-        </para>\n+      <parameter name=\"field\" required=\"true\">\n+        <enumlist>\n+          <enum name=\"summary\">\n+            <para>The VEVENT SUMMARY property or Exchange event 'subject'</para>\n+          </enum>\n+          <enum name=\"description\">\n+            <para>The text description of the event</para>\n+          </enum>\n+          <enum name=\"organizer\">\n+            <para>The organizer of the event</para>\n+          </enum>\n+          <enum name=\"location\">\n+            <para>The location of the event</para>\n+          </enum>\n+          <enum name=\"categories\">\n+            <para>The categories of the event</para>\n+          </enum>\n+          <enum name=\"priority\">\n+            <para>The priority of the event</para>\n+          </enum>\n+          <enum name=\"calendar\">\n+            <para>The name of the calendar associated with the event</para>\n+          </enum>\n+          <enum name=\"uid\">\n+            <para>The unique identifier for this event</para>\n+          </enum>\n+          <enum name=\"start\">\n+            <para>The start time of the event</para>\n+          </enum>\n+          <enum name=\"end\">\n+            <para>The end time of the event</para>\n+          </enum>\n+          <enum name=\"busystate\">\n+            <para>The busy state of the event 0=FREE, 1=TENTATIVE, 2=BUSY</para>\n+          </enum>\n+        </enumlist>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>\n-        Receives a text message on the given\n-        <replaceable>account</replaceable>\n-        from the buddy identified by\n-        <replaceable>jid</replaceable>\n-        and returns the contents.\n-      </para>\n-      <para>\n-        The example below returns an XMPP message sent from\n-        <replaceable>bob@domain.com</replaceable>\n-        (or nothing in case of a time out), to\n-\t\t\tthe\n-        <replaceable>asterisk</replaceable>\n-        XMPP account configured in xmpp.conf.\n-      </para>\n-      <example title=\"Receive a message\">same =&gt; n,Set(msg=${JABBER_RECEIVE(asterisk,bob@domain.com)})</example>\n+      <para>Whenever a calendar event notification call is made, the event data\n+\t\t\tmay be accessed with this function.</para>\n     </description>\n     <see-also>\n-      <ref type=\"function\" module=\"res_xmpp\">JABBER_STATUS</ref>\n-      <ref type=\"application\" module=\"res_xmpp\">JabberSend</ref>\n+      <ref type=\"function\">CALENDAR_BUSY</ref>\n+      <ref type=\"function\">CALENDAR_QUERY</ref>\n+      <ref type=\"function\">CALENDAR_QUERY_RESULT</ref>\n+      <ref type=\"function\">CALENDAR_WRITE</ref>\n     </see-also>\n   </function>\n-  <function name=\"JABBER_STATUS\" language=\"en_US\" module=\"res_xmpp\">\n-    <synopsis>Retrieves a buddy's status.</synopsis>\n+  <function name=\"CALENDAR_QUERY\" language=\"en_US\">\n+    <synopsis>Query a calendar server and store the data on a channel</synopsis>\n     <syntax>\n-      <parameter name=\"account\" required=\"true\">\n-        <para>The local named account to listen on (specified in\n-\t\t\t\txmpp.conf)</para>\n+      <parameter name=\"calendar\" required=\"true\">\n+        <para>The calendar that should be queried</para>\n       </parameter>\n-      <parameter name=\"jid\" required=\"true\">\n-        <para>Jabber ID of the buddy to receive message from. It can be a\n-\t\t\t\tbare JID (username@domain) or a full JID (username@domain/resource).</para>\n+      <parameter name=\"start\" required=\"false\">\n+        <para>The start time of the query (in seconds since epoch)</para>\n+      </parameter>\n+      <parameter name=\"end\" required=\"false\">\n+        <para>The end time of the query (in seconds since epoch)</para>\n       </parameter>\n     </syntax>\n     <description>\n       <para>\n-        Retrieves the numeric status associated with the buddy identified\n-\t\t\tby\n-        <replaceable>jid</replaceable>\n-        .\n-\t\t\tIf the buddy does not exist in the buddylist, returns 7.\n-      </para>\n-      <para>Status will be 1-7.</para>\n-      <para>1=Online, 2=Chatty, 3=Away, 4=XAway, 5=DND, 6=Offline</para>\n-      <para>If not in roster variable will be set to 7.</para>\n-      <para>\n-        Example: ${JABBER_STATUS(asterisk,bob@domain.com)} returns 1 if\n-        <replaceable>bob@domain.com</replaceable>\n-        is online.\n-        <replaceable>asterisk</replaceable>\n-        is\n-\t\t\tthe associated XMPP account configured in xmpp.conf.\n+        Get a list of events in the currently accessible timeframe of the\n+        <replaceable>calendar</replaceable>\n+        The function returns the id for accessing the result with CALENDAR_QUERY_RESULT()\n       </para>\n     </description>\n     <see-also>\n-      <ref type=\"function\" module=\"res_xmpp\">JABBER_RECEIVE</ref>\n-      <ref type=\"application\" module=\"res_xmpp\">JabberSend</ref>\n+      <ref type=\"function\">CALENDAR_BUSY</ref>\n+      <ref type=\"function\">CALENDAR_EVENT</ref>\n+      <ref type=\"function\">CALENDAR_QUERY_RESULT</ref>\n+      <ref type=\"function\">CALENDAR_WRITE</ref>\n     </see-also>\n   </function>\n-  <application name=\"JabberSendGroup\" language=\"en_US\" module=\"res_xmpp\">\n-    <synopsis>Send a Jabber Message to a specified chat room</synopsis>\n+  <function name=\"CALENDAR_QUERY_RESULT\" language=\"en_US\">\n+    <synopsis>Retrieve data from a previously run CALENDAR_QUERY() call</synopsis>\n     <syntax>\n-      <parameter name=\"Jabber\" required=\"true\">\n-        <para>Client or transport Asterisk uses to connect to Jabber.</para>\n-      </parameter>\n-      <parameter name=\"RoomJID\" required=\"true\">\n-        <para>XMPP/Jabber JID (Name) of chat room.</para>\n-      </parameter>\n-      <parameter name=\"Message\" required=\"true\">\n-        <para>Message to be sent to the chat room.</para>\n-      </parameter>\n-      <parameter name=\"Nickname\" required=\"false\">\n-        <para>The nickname Asterisk uses in the chat room.</para>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>Allows user to send a message to a chat room via XMPP.</para>\n-      <note>\n+      <parameter name=\"id\" required=\"true\">\n         <para>\n-          To be able to send messages to a chat room, a user must have previously joined it. Use the\n-          <replaceable>JabberJoin</replaceable>\n-          function to do so.\n+          The query ID returned by\n+          <literal>CALENDAR_QUERY</literal>\n         </para>\n-      </note>\n-    </description>\n-  </application>\n-  <application name=\"JabberJoin\" language=\"en_US\" module=\"res_xmpp\">\n-    <synopsis>Join a chat room</synopsis>\n-    <syntax>\n-      <parameter name=\"Jabber\" required=\"true\">\n-        <para>Client or transport Asterisk uses to connect to Jabber.</para>\n-      </parameter>\n-      <parameter name=\"RoomJID\" required=\"true\">\n-        <para>XMPP/Jabber JID (Name) of chat room.</para>\n-      </parameter>\n-      <parameter name=\"Nickname\" required=\"false\">\n-        <para>The nickname Asterisk will use in the chat room.</para>\n-        <note>\n-          <para>If a different nickname is supplied to an already joined room, the old nick will be changed to the new one.</para>\n-        </note>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>Allows Asterisk to join a chat room.</para>\n-    </description>\n-  </application>\n-  <application name=\"JabberLeave\" language=\"en_US\" module=\"res_xmpp\">\n-    <synopsis>Leave a chat room</synopsis>\n-    <syntax>\n-      <parameter name=\"Jabber\" required=\"true\">\n-        <para>Client or transport Asterisk uses to connect to Jabber.</para>\n-      </parameter>\n-      <parameter name=\"RoomJID\" required=\"true\">\n-        <para>XMPP/Jabber JID (Name) of chat room.</para>\n-      </parameter>\n-      <parameter name=\"Nickname\" required=\"false\">\n-        <para>The nickname Asterisk uses in the chat room.</para>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>Allows Asterisk to leave a chat room.</para>\n-    </description>\n-  </application>\n-  <application name=\"JabberStatus\" language=\"en_US\" module=\"res_xmpp\">\n-    <synopsis>Retrieve the status of a jabber list member</synopsis>\n-    <syntax>\n-      <parameter name=\"Jabber\" required=\"true\">\n-        <para>Client or transport Asterisk users to connect to Jabber.</para>\n       </parameter>\n-      <parameter name=\"JID\" required=\"true\">\n-        <para>XMPP/Jabber JID (Name) of recipient.</para>\n+      <parameter name=\"field\" required=\"true\">\n+        <enumlist>\n+          <enum name=\"getnum\">\n+            <para>number of events occurring during time range</para>\n+          </enum>\n+          <enum name=\"summary\">\n+            <para>A summary of the event</para>\n+          </enum>\n+          <enum name=\"description\">\n+            <para>The full event description</para>\n+          </enum>\n+          <enum name=\"organizer\">\n+            <para>The event organizer</para>\n+          </enum>\n+          <enum name=\"location\">\n+            <para>The event location</para>\n+          </enum>\n+          <enum name=\"categories\">\n+            <para>The categories of the event</para>\n+          </enum>\n+          <enum name=\"priority\">\n+            <para>The priority of the event</para>\n+          </enum>\n+          <enum name=\"calendar\">\n+            <para>The name of the calendar associted with the event</para>\n+          </enum>\n+          <enum name=\"uid\">\n+            <para>The unique identifier for the event</para>\n+          </enum>\n+          <enum name=\"start\">\n+            <para>The start time of the event (in seconds since epoch)</para>\n+          </enum>\n+          <enum name=\"end\">\n+            <para>The end time of the event (in seconds since epoch)</para>\n+          </enum>\n+          <enum name=\"busystate\">\n+            <para>The busy status of the event 0=FREE, 1=TENTATIVE, 2=BUSY</para>\n+          </enum>\n+        </enumlist>\n       </parameter>\n-      <parameter name=\"Variable\" required=\"true\">\n-        <para>Variable to store the status of requested user.</para>\n+      <parameter name=\"entry\" required=\"false\" default=\"1\">\n+        <para>Return data from a specific event returned by the query</para>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>This application is deprecated. Please use the JABBER_STATUS() function instead.</para>\n       <para>\n-        Retrieves the numeric status associated with the specified buddy\n-        <replaceable>JID</replaceable>\n-        .\n-\t\t\tThe return value in the\n-        <replaceable>Variable</replaceable>\n-        will be one of the following.\n+        After running CALENDAR_QUERY and getting a result\n+        <replaceable>id</replaceable>\n+        , calling\n+        <literal>CALENDAR_QUERY</literal>\n+        with that\n+        <replaceable>id</replaceable>\n+        and a\n+        <replaceable>field</replaceable>\n+        will return the data for that field. If multiple events matched the query, and\n+        <replaceable>entry</replaceable>\n+        is provided, information from that event will be returned.\n       </para>\n-      <enumlist>\n-        <enum name=\"1\">\n-          <para>Online.</para>\n-        </enum>\n-        <enum name=\"2\">\n-          <para>Chatty.</para>\n-        </enum>\n-        <enum name=\"3\">\n-          <para>Away.</para>\n-        </enum>\n-        <enum name=\"4\">\n-          <para>Extended Away.</para>\n-        </enum>\n-        <enum name=\"5\">\n-          <para>Do Not Disturb.</para>\n-        </enum>\n-        <enum name=\"6\">\n-          <para>Offline.</para>\n-        </enum>\n-        <enum name=\"7\">\n-          <para>Not In Roster.</para>\n-        </enum>\n-      </enumlist>\n     </description>\n-  </application>\n-  <manager name=\"JabberSend\" language=\"en_US\" module=\"res_xmpp\">\n-    <synopsis>Sends a message to a Jabber Client.</synopsis>\n+    <see-also>\n+      <ref type=\"function\">CALENDAR_BUSY</ref>\n+      <ref type=\"function\">CALENDAR_EVENT</ref>\n+      <ref type=\"function\">CALENDAR_QUERY</ref>\n+      <ref type=\"function\">CALENDAR_WRITE</ref>\n+    </see-also>\n+  </function>\n+  <function name=\"CALENDAR_WRITE\" language=\"en_US\">\n+    <synopsis>Write an event to a calendar</synopsis>\n     <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"Jabber\" required=\"true\">\n-        <para>Client or transport Asterisk uses to connect to JABBER.</para>\n-      </parameter>\n-      <parameter name=\"JID\" required=\"true\">\n-        <para>XMPP/Jabber JID (Name) of recipient.</para>\n+      <parameter name=\"calendar\" required=\"true\">\n+        <para>The calendar to write to</para>\n       </parameter>\n-      <parameter name=\"Message\" required=\"true\">\n-        <para>Message to be sent to the buddy.</para>\n+      <parameter name=\"field\" multiple=\"true\" required=\"true\">\n+        <enumlist>\n+          <enum name=\"summary\">\n+            <para>A summary of the event</para>\n+          </enum>\n+          <enum name=\"description\">\n+            <para>The full event description</para>\n+          </enum>\n+          <enum name=\"organizer\">\n+            <para>The event organizer</para>\n+          </enum>\n+          <enum name=\"location\">\n+            <para>The event location</para>\n+          </enum>\n+          <enum name=\"categories\">\n+            <para>The categories of the event</para>\n+          </enum>\n+          <enum name=\"priority\">\n+            <para>The priority of the event</para>\n+          </enum>\n+          <enum name=\"uid\">\n+            <para>The unique identifier for the event</para>\n+          </enum>\n+          <enum name=\"start\">\n+            <para>The start time of the event (in seconds since epoch)</para>\n+          </enum>\n+          <enum name=\"end\">\n+            <para>The end time of the event (in seconds since epoch)</para>\n+          </enum>\n+          <enum name=\"busystate\">\n+            <para>The busy status of the event 0=FREE, 1=TENTATIVE, 2=BUSY</para>\n+          </enum>\n+        </enumlist>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>Sends a message to a Jabber Client.</para>\n+      <example title=\"Set calendar fields\">same =&gt; n,Set(CALENDAR_WRITE(calendar,field1,field2,field3)=val1,val2,val3)</example>\n+      <para>The field and value arguments can easily be set/passed using the HASHKEYS() and HASH() functions</para>\n+      <variablelist>\n+        <variable name=\"CALENDAR_SUCCESS\">\n+          <para>The status of the write operation to the calendar</para>\n+          <value name=\"1\">The event was successfully written to the calendar.</value>\n+          <value name=\"0\">The event was not written to the calendar due to network issues, permissions, etc.</value>\n+        </variable>\n+      </variablelist>\n     </description>\n-  </manager>\n-  <info name=\"MessageDestinationInfo\" language=\"en_US\" tech=\"XMPP\">\n-    <para>\n-      Specifying a prefix of\n-      <literal>xmpp:</literal>\n-      will send the\n-\t\tmessage as an XMPP chat message.\n-    </para>\n-  </info>\n-  <info name=\"MessageFromInfo\" language=\"en_US\" tech=\"XMPP\">\n-    <para>\n-      Specifying a prefix of\n-      <literal>xmpp:</literal>\n-      will specify the\n-\t\taccount defined in\n-      <literal>xmpp.conf</literal>\n-      to send the message from.\n-\t\tNote that this field is required for XMPP messages.\n-    </para>\n-  </info>\n-  <info name=\"MessageToInfo\" language=\"en_US\" tech=\"XMPP\">\n-    <para>Ignored</para>\n-  </info>\n-  <configInfo name=\"res_xmpp\" language=\"en_US\">\n-    <synopsis>XMPP Messaging</synopsis>\n-    <configFile name=\"xmpp.conf\">\n-      <configObject name=\"global\">\n-        <synopsis>Global configuration settings</synopsis>\n-        <configOption name=\"debug\">\n-          <synopsis>Enable/disable XMPP message debugging</synopsis>\n-        </configOption>\n-        <configOption name=\"autoprune\">\n-          <synopsis>Auto-remove users from buddy list.</synopsis>\n-          <description>\n-            <para>Auto-remove users from buddy list. Depending on the setup\n-\t\t\t\t\t(e.g., using your personal Gtalk account for a test) this could cause loss of\n-\t\t\t\t\tthe contact list.</para>\n-          </description>\n-        </configOption>\n-        <configOption name=\"autoregister\">\n-          <synopsis>Auto-register users from buddy list</synopsis>\n-        </configOption>\n-        <configOption name=\"collection_nodes\">\n-          <synopsis>Enable support for XEP-0248 for use with distributed device state</synopsis>\n-        </configOption>\n-        <configOption name=\"pubsub_autocreate\">\n-          <synopsis>Whether or not the PubSub server supports/is using auto-create for nodes</synopsis>\n-        </configOption>\n-        <configOption name=\"auth_policy\">\n-          <synopsis>Whether to automatically accept or deny users' subscription requests</synopsis>\n-        </configOption>\n-      </configObject>\n-      <configObject name=\"client\">\n-        <synopsis>Configuration options for an XMPP client</synopsis>\n-        <configOption name=\"username\">\n-          <synopsis>XMPP username with optional resource</synopsis>\n-        </configOption>\n-        <configOption name=\"secret\">\n-          <synopsis>XMPP password</synopsis>\n-        </configOption>\n-        <configOption name=\"refresh_token\">\n-          <synopsis>Google OAuth 2.0 refresh token</synopsis>\n-        </configOption>\n-        <configOption name=\"oauth_clientid\">\n-          <synopsis>Google OAuth 2.0 application's client id</synopsis>\n-        </configOption>\n-        <configOption name=\"oauth_secret\">\n-          <synopsis>Google OAuth 2.0 application's secret</synopsis>\n-        </configOption>\n-        <configOption name=\"serverhost\">\n-          <synopsis>Route to server, e.g. talk.google.com</synopsis>\n-        </configOption>\n-        <configOption name=\"statusmessage\">\n-          <synopsis>Custom status message</synopsis>\n-        </configOption>\n-        <configOption name=\"pubsub_node\">\n-          <synopsis>Node for publishing events via PubSub</synopsis>\n-        </configOption>\n-        <configOption name=\"context\">\n-          <synopsis>Dialplan context to send incoming messages to</synopsis>\n-        </configOption>\n-        <configOption name=\"priority\">\n-          <synopsis>XMPP resource priority</synopsis>\n-        </configOption>\n-        <configOption name=\"port\">\n-          <synopsis>XMPP server port</synopsis>\n-        </configOption>\n-        <configOption name=\"timeout\">\n-          <synopsis>Timeout in seconds to hold incoming messages</synopsis>\n-          <description>\n-            <para>\n-              Timeout (in seconds) on the message stack. Messages stored longer\n-\t\t\t\t\tthan this value will be deleted by Asterisk. This option applies to incoming messages only\n-\t\t\t\t\twhich are intended to be processed by the\n-              <literal>JABBER_RECEIVE</literal>\n-              dialplan function.\n-            </para>\n-          </description>\n-        </configOption>\n-        <configOption name=\"debug\">\n-          <synopsis>Enable debugging</synopsis>\n-        </configOption>\n-        <configOption name=\"type\">\n-          <synopsis>Connection is either a client or a component</synopsis>\n-        </configOption>\n-        <configOption name=\"distribute_events\">\n-          <synopsis>Whether or not to distribute events using this connection</synopsis>\n-        </configOption>\n-        <configOption name=\"usetls\">\n-          <synopsis>Whether to use TLS for the connection or not</synopsis>\n-        </configOption>\n-        <configOption name=\"usesasl\">\n-          <synopsis>Whether to use SASL for the connection or not</synopsis>\n-        </configOption>\n-        <configOption name=\"forceoldssl\">\n-          <synopsis>Force the use of old-style SSL for the connection</synopsis>\n-        </configOption>\n-        <configOption name=\"keepalive\">\n-          <synopsis>If enabled, periodically send an XMPP message from this client with an empty message</synopsis>\n-        </configOption>\n-        <configOption name=\"autoprune\">\n-          <synopsis>Auto-remove users from buddy list.</synopsis>\n-          <description>\n-            <para>Auto-remove users from buddy list. Depending on the setup\n-\t\t\t\t\t(e.g., using your personal Gtalk account for a test) this could cause loss of\n-\t\t\t\t\tthe contact list.</para>\n-          </description>\n-        </configOption>\n-        <configOption name=\"autoregister\">\n-          <synopsis>Auto-register users bfrom buddy list</synopsis>\n-        </configOption>\n-        <configOption name=\"auth_policy\">\n-          <synopsis>Whether to automatically accept or deny users' subscription requests</synopsis>\n-        </configOption>\n-        <configOption name=\"sendtodialplan\">\n-          <synopsis>Send incoming messages into the dialplan</synopsis>\n-        </configOption>\n-        <configOption name=\"status\">\n-          <synopsis>Default XMPP status for the client</synopsis>\n-          <description>\n-            <para>Can be one of the following XMPP statuses:</para>\n-            <enumlist>\n-              <enum name=\"chat\"/>\n-              <enum name=\"available\"/>\n-              <enum name=\"away\"/>\n-              <enum name=\"xaway\"/>\n-              <enum name=\"dnd\"/>\n-            </enumlist>\n-          </description>\n-        </configOption>\n-        <configOption name=\"buddy\">\n-          <synopsis>Manual addition of buddy to list</synopsis>\n-          <description>\n-            <para>Manual addition of buddy to the buddy list. For distributed events, these buddies are\n-\t\t\t\t\tautomatically added in the whitelist as 'owners' of the node(s).</para>\n-          </description>\n-        </configOption>\n-      </configObject>\n-    </configFile>\n-  </configInfo>\n-  <module language=\"en_US\" name=\"res_pjsip_pidf_body_generator\">\n-    <depend>pjproject</depend>\n-    <depend>res_pjsip</depend>\n-    <depend>res_pjsip_pubsub</depend>\n-    <support_level>core</support_level>\n-  </module>\n+    <see-also>\n+      <ref type=\"function\">CALENDAR_BUSY</ref>\n+      <ref type=\"function\">CALENDAR_EVENT</ref>\n+      <ref type=\"function\">CALENDAR_QUERY</ref>\n+      <ref type=\"function\">CALENDAR_QUERY_RESULT</ref>\n+    </see-also>\n+  </function>\n   <module language=\"en_US\" name=\"res_mwi_external_ami\">\n     <depend>res_mwi_external</depend>\n     <support_level>core</support_level>\n   </module>\n   <manager name=\"MWIGet\" language=\"en_US\">\n     <synopsis>Get selected mailboxes with message counts.</synopsis>\n     <syntax>\n@@ -28365,503 +28977,18 @@\n \t\t\t\tto zero if missing.</para>\n       </parameter>\n     </syntax>\n     <description>\n       <para>Update the mailbox message counts.</para>\n     </description>\n   </manager>\n-  <module language=\"en_US\" name=\"res_pjsip_notify\">\n-    <depend>pjproject</depend>\n-    <depend>res_pjsip</depend>\n-    <support_level>core</support_level>\n-  </module>\n-  <manager name=\"PJSIPNotify\" language=\"en_US\">\n-    <synopsis>Send a NOTIFY to either an endpoint, an arbitrary URI, or inside a SIP dialog.</synopsis>\n-    <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"Endpoint\" required=\"false\">\n-        <para>The endpoint to which to send the NOTIFY.</para>\n-      </parameter>\n-      <parameter name=\"URI\" required=\"false\">\n-        <para>Abritrary URI to which to send the NOTIFY.</para>\n-      </parameter>\n-      <parameter name=\"channel\" required=\"false\">\n-        <para>Channel name to send the NOTIFY. Must be a PJSIP channel.</para>\n-      </parameter>\n-      <parameter name=\"Variable\" required=\"true\">\n-        <para>\n-          Appends variables as headers/content to the NOTIFY. If the variable is\n-\t\t\t\tnamed\n-          <literal>Content</literal>\n-          , then the value will compose the body\n-\t\t\t\tof the message if another variable sets\n-          <literal>Content-Type</literal>\n-          .\n-          <replaceable>name</replaceable>\n-          =\n-          <replaceable>value</replaceable>\n-        </para>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>Sends a NOTIFY to an endpoint, an arbitrary URI, or inside a SIP dialog.</para>\n-      <para>\n-        All parameters for this event must be specified in the body of this\n-\t\t\trequest\tvia multiple\n-        <literal>Variable: name=value</literal>\n-        sequences.\n-      </para>\n-      <note>\n-        <para>\n-          One (and only one) of\n-          <literal>Endpoint</literal>\n-          ,\n-          <literal>URI</literal>\n-          , or\n-          <literal>Channel</literal>\n-          must be specified.\n-\t\t\tIf\n-          <literal>URI</literal>\n-          is used, the default outbound endpoint will be used\n-\t\t\tto send the message. If the default outbound endpoint isn't configured, this command\n-\t\t\tcan not send to an arbitrary URI.\n-        </para>\n-      </note>\n-    </description>\n-  </manager>\n-  <configInfo name=\"res_pjsip_notify\" language=\"en_US\">\n-    <synopsis>Module that supports sending NOTIFY requests to endpoints from external sources</synopsis>\n-    <configFile name=\"pjsip_notify.conf\">\n-      <configObject name=\"general\">\n-        <synopsis>Unused, but reserved.</synopsis>\n-      </configObject>\n-      <configObject name=\"notify\">\n-        <synopsis>Configuration of a NOTIFY request.</synopsis>\n-        <description>\n-          <para>\n-            Each key-value pair in a\n-            <literal>notify</literal>\n-            configuration section defines either a SIP header to send\n-\t\t\t\t\tin the request or a line of content in the request message\n-\t\t\t\t\tbody. A key of\n-            <literal>Content</literal>\n-            is treated\n-\t\t\t\t\tas part of the message body and is appended in sequential\n-\t\t\t\t\torder; any other header is treated as part of the SIP\n-\t\t\t\t\trequest.\n-          </para>\n-        </description>\n-        <configOption name=\"\">\n-          <synopsis>A key/value pair to add to a NOTIFY request.</synopsis>\n-          <description>\n-            <para>\n-              If the key is\n-              <literal>Content</literal>\n-              ,\n-\t\t\t\t\t\tit will be treated as part of the message body. Otherwise,\n-\t\t\t\t\t\tit will be added as a header in the NOTIFY request.\n-            </para>\n-            <para>The following headers are reserved and cannot be\n-\t\t\t\t\t\tspecified:</para>\n-            <enumlist>\n-              <enum name=\"Call-ID\"/>\n-              <enum name=\"Contact\"/>\n-              <enum name=\"CSeq\"/>\n-              <enum name=\"To\"/>\n-              <enum name=\"From\"/>\n-              <enum name=\"Record-Route\"/>\n-              <enum name=\"Route\"/>\n-              <enum name=\"Via\"/>\n-            </enumlist>\n-          </description>\n-        </configOption>\n-      </configObject>\n-    </configFile>\n-  </configInfo>\n-  <module language=\"en_US\" name=\"res_clialiases\">\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"res_geolocation\">\n-    <depend>libxml2</depend>\n-    <depend>libxslt</depend>\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"res_pjsip_endpoint_identifier_ip\">\n-    <depend>pjproject</depend>\n-    <depend>res_pjsip</depend>\n-    <support_level>core</support_level>\n-  </module>\n-  <configInfo name=\"res_pjsip_endpoint_identifier_ip\" language=\"en_US\">\n-    <synopsis>Module that identifies endpoints</synopsis>\n-    <configFile name=\"pjsip.conf\">\n-      <configObject name=\"identify\">\n-        <synopsis>Identifies endpoints via some criteria.</synopsis>\n-        <description>\n-          <para>This module provides alternatives to matching inbound requests to\n-\t\t\t\t\ta configured endpoint. At least one of the matching mechanisms\n-\t\t\t\t\tmust be provided, or the object configuration is invalid.</para>\n-          <para>The matching mechanisms are provided by the following\n-\t\t\t\t\tconfiguration options:</para>\n-          <enumlist>\n-            <enum name=\"match\">\n-              <para>Match by source IP address.</para>\n-            </enum>\n-            <enum name=\"match_header\">\n-              <para>Match by SIP header.</para>\n-            </enum>\n-          </enumlist>\n-          <note>\n-            <para>\n-              If multiple matching criteria are provided then an inbound\n-\t\t\t\t\trequest will be matched to the endpoint if it matches\n-              <emphasis>any</emphasis>\n-              of the criteria.\n-            </para>\n-          </note>\n-        </description>\n-        <configOption name=\"endpoint\">\n-          <synopsis>Name of endpoint identified</synopsis>\n-        </configOption>\n-        <configOption name=\"match\">\n-          <synopsis>IP addresses or networks to match against.</synopsis>\n-          <description>\n-            <para>The value is a comma-delimited list of IP addresses or\n-\t\t\t\t\t\thostnames.</para>\n-            <para>IP addresses may have a subnet mask appended. The subnet\n-\t\t\t\t\t\tmask may be written in either CIDR or dotted-decimal\n-\t\t\t\t\t\tnotation. Separate the IP address and subnet mask with a slash\n-\t\t\t\t\t\t('/'). A source port can also be specified by adding a colon (':')\n-\t\t\t\t\t\tafter the address but before the subnet mask, e.g.\n-\t\t\t\t\t\t3.2.1.0:5061/24. To specify a source port for an IPv6 address, the\n-\t\t\t\t\t\taddress itself must be enclosed in square brackets\n-\t\t\t\t\t\t('[2001:db8:0::1]:5060')</para>\n-            <para>\n-              When a hostname is used, the behavior depends on whether\n-              <replaceable>srv_lookups</replaceable>\n-              is enabled and/or a source\n-\t\t\t\t\t\tport is provided. If\n-              <replaceable>srv_lookups</replaceable>\n-              is\n-\t\t\t\t\t\tenabled and a source port is not provided, Asterisk will perform\n-\t\t\t\t\t\tan SRV lookup on the provided hostname, adding all of the A and\n-\t\t\t\t\t\tAAAA records that are resolved.\n-            </para>\n-            <para>\n-              If the SRV lookup fails,\n-              <replaceable>srv_lookups</replaceable>\n-              is disabled, or a source\n-\t\t\t\t\t\tport is specified when the hostname is configured, Asterisk will\n-\t\t\t\t\t\tresolve the hostname and add all A and AAAA records that are\n-\t\t\t\t\t\tresolved.\n-            </para>\n-          </description>\n-        </configOption>\n-        <configOption name=\"srv_lookups\" default=\"yes\">\n-          <synopsis>Perform SRV lookups for provided hostnames.</synopsis>\n-          <description>\n-            <para>\n-              When enabled,\n-              <replaceable>srv_lookups</replaceable>\n-              will\n-\t\t\t\t\t\tperform SRV lookups for _sip._udp, _sip._tcp, and _sips._tcp of\n-\t\t\t\t\t\tthe given hostnames to determine additional addresses that traffic\n-\t\t\t\t\t\tmay originate from.\n-            </para>\n-          </description>\n-        </configOption>\n-        <configOption name=\"match_header\">\n-          <synopsis>Header/value pair to match against.</synopsis>\n-          <description>\n-            <para>\n-              A SIP header whose value is used to match against.  SIP\n-\t\t\t\t\t\trequests containing the header, along with the specified value,\n-\t\t\t\t\t\twill be mapped to the specified endpoint.  The header must be\n-\t\t\t\t\t\tspecified with a\n-              <literal>:</literal>\n-              , as in\n-              <literal>match_header = SIPHeader: value</literal>\n-              .\n-            </para>\n-            <para>\n-              The specified SIP header value can be a regular\n-\t\t\t\t\t\texpression if the value is of the form\n-\t\t\t\t\t\t/\n-              <replaceable>regex</replaceable>\n-              /.\n-            </para>\n-            <note>\n-              <para>Use of a regex is expensive so be sure you need\n-\t\t\t\t\t\tto use a regex to match your endpoint.</para>\n-            </note>\n-          </description>\n-        </configOption>\n-        <configOption name=\"type\">\n-          <synopsis>Must be of type 'identify'.</synopsis>\n-        </configOption>\n-      </configObject>\n-    </configFile>\n-  </configInfo>\n-  <module language=\"en_US\" name=\"res_odbc\">\n-    <depend>generic_odbc</depend>\n-    <depend>res_odbc_transaction</depend>\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"res_pjsip_outbound_registration\">\n-    <depend>pjproject</depend>\n-    <depend>res_pjsip</depend>\n-    <use type=\"module\">res_statsd</use>\n-    <support_level>core</support_level>\n-  </module>\n-  <configInfo name=\"res_pjsip_outbound_registration\" language=\"en_US\">\n-    <synopsis>SIP resource for outbound registrations</synopsis>\n-    <description>\n-      <para>\n-        <emphasis>Outbound Registration</emphasis>\n-      </para>\n-      <para>\n-        This module allows\n-        <literal>res_pjsip</literal>\n-        to register to other SIP servers.\n-      </para>\n-    </description>\n-    <configFile name=\"pjsip.conf\">\n-      <configObject name=\"registration\">\n-        <synopsis>The configuration for outbound registration</synopsis>\n-        <description>\n-          <para>\n-            Registration is\n-            <emphasis>COMPLETELY</emphasis>\n-            separate from the rest of\n-            <literal>pjsip.conf</literal>\n-            . A minimal configuration consists of\n-\t\t\t\t\tsetting a\n-            <literal>server_uri</literal>\n-            and a\n-            <literal>client_uri</literal>\n-            .\n-          </para>\n-        </description>\n-        <configOption name=\"auth_rejection_permanent\" default=\"yes\">\n-          <synopsis>Determines whether failed authentication challenges are treated\n-\t\t\t\t\tas permanent failures.</synopsis>\n-          <description>\n-            <para>If this option is enabled and an authentication challenge fails,\n-\t\t\t\t\tregistration will not be attempted again until the configuration is reloaded.</para>\n-          </description>\n-        </configOption>\n-        <configOption name=\"client_uri\">\n-          <synopsis>Client SIP URI used when attemping outbound registration</synopsis>\n-          <description>\n-            <para>This is the address-of-record for the outbound registration (i.e. the URI in\n-\t\t\t\t\t\tthe To header of the REGISTER).</para>\n-            <para>For registration with an ITSP, the client SIP URI may need to consist of\n-\t\t\t\t\t\tan account name or number and the provider's hostname for their registrar, e.g.\n-\t\t\t\t\t\tclient_uri=1234567890@example.com. This may differ between providers.</para>\n-            <para>For registration to generic registrars, the client SIP URI will depend\n-\t\t\t\t\t\ton networking specifics and configuration of the registrar.</para>\n-          </description>\n-        </configOption>\n-        <configOption name=\"contact_user\">\n-          <synopsis>Contact User to use in request</synopsis>\n-        </configOption>\n-        <configOption name=\"expiration\" default=\"3600\">\n-          <synopsis>Expiration time for registrations in seconds</synopsis>\n-        </configOption>\n-        <configOption name=\"max_retries\" default=\"10\">\n-          <synopsis>Maximum number of registration attempts.</synopsis>\n-          <description>\n-            <para>This sets the maximum number of registration attempts that are made before\n-\t\t\t\t\t\tstopping any further attempts. If set to 0 then upon failure no further attempts\n-\t\t\t\t\t\tare made.</para>\n-          </description>\n-        </configOption>\n-        <configOption name=\"outbound_auth\" default=\"\">\n-          <synopsis>Authentication object(s) to be used for outbound registrations.</synopsis>\n-          <description>\n-            <para>\n-              This is a comma-delimited list of\n-              <replaceable>auth</replaceable>\n-              sections defined in\n-              <filename>pjsip.conf</filename>\n-              used to respond\n-\t\t\t\t\t\tto outbound authentication challenges.\n-            </para>\n-            <note>\n-              <para>Using the same auth section for inbound and outbound\n-\t\t\t\t\t\tauthentication is not recommended.  There is a difference in\n-\t\t\t\t\t\tmeaning for an empty realm setting between inbound and outbound\n-\t\t\t\t\t\tauthentication uses.  See the auth realm description for details.</para>\n-            </note>\n-          </description>\n-        </configOption>\n-        <configOption name=\"outbound_proxy\" default=\"\">\n-          <synopsis>Full SIP URI of the outbound proxy used to send registrations</synopsis>\n-        </configOption>\n-        <configOption name=\"max_random_initial_delay\" default=\"10\">\n-          <synopsis>Maximum interval in seconds for which an initial registration may be randomly delayed</synopsis>\n-          <description>\n-            <para>By default, registrations are randomly delayed by a small amount to prevent\n-\t\t\t\t\t\ttoo many registrations from being made simultaneously.</para>\n-            <para>Depending on your system usage, it may be desirable to set this to a smaller\n-\t\t\t\t\t\tor larger value to have fine grained control over the size of this random delay.</para>\n-          </description>\n-        </configOption>\n-        <configOption name=\"retry_interval\" default=\"60\">\n-          <synopsis>Interval in seconds between retries if outbound registration is unsuccessful</synopsis>\n-        </configOption>\n-        <configOption name=\"forbidden_retry_interval\" default=\"0\">\n-          <synopsis>Interval used when receiving a 403 Forbidden response.</synopsis>\n-          <description>\n-            <para>\n-              If a 403 Forbidden is received, chan_pjsip will wait\n-              <replaceable>forbidden_retry_interval</replaceable>\n-              seconds before\n-\t\t\t\t\t\tattempting registration again. If 0 is specified, chan_pjsip will not\n-\t\t\t\t\t\tretry after receiving a 403 Forbidden response. Setting this to a non-zero\n-\t\t\t\t\t\tvalue goes against a &quot;SHOULD NOT&quot; in RFC3261, but can be used to work around\n-\t\t\t\t\t\tbuggy registrars.\n-            </para>\n-          </description>\n-        </configOption>\n-        <configOption name=\"fatal_retry_interval\" default=\"0\">\n-          <synopsis>Interval used when receiving a Fatal response.</synopsis>\n-          <description>\n-            <para>\n-              If a fatal response is received, chan_pjsip will wait\n-              <replaceable>fatal_retry_interval</replaceable>\n-              seconds before\n-\t\t\t\t\t\tattempting registration again. If 0 is specified, chan_pjsip will not\n-\t\t\t\t\t\tretry after receiving a fatal (non-temporary 4xx, 5xx, 6xx) response.\n-\t\t\t\t\t\tSetting this to a non-zero value may go against a &quot;SHOULD NOT&quot; in RFC3261,\n-\t\t\t\t\t\tbut can be used to work around buggy registrars.\n-            </para>\n-            <note>\n-              <para>\n-                if also set the\n-                <replaceable>forbidden_retry_interval</replaceable>\n-                takes precedence over this one when a 403 is received.\n-\t\t\t\t\t\tAlso, if\n-                <replaceable>auth_rejection_permanent</replaceable>\n-                equals 'yes' then\n-\t\t\t\t\t\ta 401 and 407 become subject to this retry interval.\n-              </para>\n-            </note>\n-          </description>\n-        </configOption>\n-        <configOption name=\"server_uri\">\n-          <synopsis>SIP URI of the server to register against</synopsis>\n-          <description>\n-            <para>This is the URI at which to find the registrar to send the outbound REGISTER. This URI\n-\t\t\t\t\t\tis used as the request URI of the outbound REGISTER request from Asterisk.</para>\n-            <para>For registration with an ITSP, the setting may often be just the domain of\n-\t\t\t\t\t\tthe registrar, e.g. sip:sip.example.com.</para>\n-          </description>\n-        </configOption>\n-        <configOption name=\"transport\">\n-          <synopsis>Transport used for outbound authentication</synopsis>\n-          <description>\n-            <note>\n-              <para>\n-                A\n-                <replaceable>transport</replaceable>\n-                configured in\n-                <literal>pjsip.conf</literal>\n-                . As with other\n-                <literal>res_pjsip</literal>\n-                modules, this will use the first available transport of the appropriate type if unconfigured.\n-              </para>\n-            </note>\n-          </description>\n-        </configOption>\n-        <configOption name=\"line\">\n-          <synopsis>Whether to add a 'line' parameter to the Contact for inbound call matching</synopsis>\n-          <description>\n-            <para>When enabled this option will cause a 'line' parameter to be added to the Contact\n-\t\t\t\t\t\theader placed into the outgoing registration request. If the remote server sends a call\n-\t\t\t\t\t\tthis line parameter will be used to establish a relationship to the outbound registration,\n-\t\t\t\t\t\tultimately causing the configured endpoint to be used.</para>\n-          </description>\n-        </configOption>\n-        <configOption name=\"endpoint\">\n-          <synopsis>Endpoint to use for incoming related calls</synopsis>\n-          <description>\n-            <para>When line support is enabled this configured endpoint name is used for incoming calls\n-\t\t\t\t\t\tthat are related to the outbound registration.</para>\n-          </description>\n-        </configOption>\n-        <configOption name=\"type\">\n-          <synopsis>Must be of type 'registration'.</synopsis>\n-        </configOption>\n-        <configOption name=\"support_path\">\n-          <synopsis>Enables Path support for outbound REGISTER requests.</synopsis>\n-          <description>\n-            <para>When this option is enabled, outbound REGISTER requests will advertise\n-\t\t\t\t\t\tsupport for Path headers so that intervening proxies can add to the Path\n-\t\t\t\t\t\theader as necessary.</para>\n-          </description>\n-        </configOption>\n-      </configObject>\n-    </configFile>\n-  </configInfo>\n-  <manager name=\"PJSIPUnregister\" language=\"en_US\">\n-    <synopsis>Unregister an outbound registration.</synopsis>\n-    <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"Registration\" required=\"true\">\n-        <para>The outbound registration to unregister or '*all' to unregister them all.</para>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>Unregisters the specified (or all) outbound registration(s) and stops future registration attempts.\n-\t\t\tCall PJSIPRegister to start registration and schedule re-registrations according to configuration.</para>\n-    </description>\n-  </manager>\n-  <manager name=\"PJSIPRegister\" language=\"en_US\">\n-    <synopsis>Register an outbound registration.</synopsis>\n-    <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"Registration\" required=\"true\">\n-        <para>The outbound registration to register or '*all' to register them all.</para>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>Unregisters the specified (or all) outbound registration(s) then starts registration and schedules re-registrations\n-\t\t\taccording to configuration.</para>\n-    </description>\n-  </manager>\n-  <manager name=\"PJSIPShowRegistrationsOutbound\" language=\"en_US\">\n-    <synopsis>Lists PJSIP outbound registrations.</synopsis>\n-    <syntax/>\n-    <description>\n-      <para>\n-        In response\n-        <literal>OutboundRegistrationDetail</literal>\n-        events showing configuration and status\n-\t\t\tinformation are raised for each outbound registration object.\n-        <literal>AuthDetail</literal>\n-        events are raised for each associated auth object as well.  Once all events are completed an\n-        <literal>OutboundRegistrationDetailComplete</literal>\n-        is issued.\n-      </para>\n-    </description>\n-  </manager>\n-  <module language=\"en_US\" name=\"res_format_attr_h263\">\n+  <module language=\"en_US\" name=\"res_stasis_recording\">\n+    <depend type=\"module\">res_stasis</depend>\n     <support_level>core</support_level>\n   </module>\n-  <function name=\"PARK_GET_CHANNEL\" language=\"en_US\">\n-    <synopsis>Get the channel name of an occupied parking space in a parking lot.</synopsis>\n-    <syntax>\n-      <parameter name=\"parking_space\" required=\"true\"/>\n-      <parameter name=\"parking_lot\" required=\"true\"/>\n-    </syntax>\n-    <description>\n-      <para>This function returns the channel of the specified parking space\n-\t\t\t\tif the parking lot space is occupied.</para>\n-    </description>\n-  </function>\n   <application name=\"Park\" language=\"en_US\">\n     <synopsis>Park yourself.</synopsis>\n     <syntax>\n       <parameter name=\"parking_lot_name\">\n         <para>Specify in which parking lot to park a call.</para>\n         <para>The parking lot used is selected in the following order:</para>\n         <para>1) parking_lot_name option to this application</para>\n@@ -29103,14 +29230,25 @@\n       </para>\n     </description>\n     <see-also>\n       <ref type=\"application\">Park</ref>\n       <ref type=\"application\">ParkedCall</ref>\n     </see-also>\n   </application>\n+  <function name=\"PARK_GET_CHANNEL\" language=\"en_US\">\n+    <synopsis>Get the channel name of an occupied parking space in a parking lot.</synopsis>\n+    <syntax>\n+      <parameter name=\"parking_space\" required=\"true\"/>\n+      <parameter name=\"parking_lot\" required=\"true\"/>\n+    </syntax>\n+    <description>\n+      <para>This function returns the channel of the specified parking space\n+\t\t\t\tif the parking lot space is occupied.</para>\n+    </description>\n+  </function>\n   <manager name=\"Parkinglots\" language=\"en_US\">\n     <synopsis>Get a list of parking lots</synopsis>\n     <syntax>\n       <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n     </syntax>\n     <description>\n       <para>List all parking lots as a series of AMI events</para>\n@@ -29242,748 +29380,420 @@\n         <para>This event is raised when a channel initially parked in the parking lot\n \t\t\t\tis swapped out with a different channel. The most common case for this is when\n \t\t\t\tan attended transfer to a parking lot occurs. The Parkee information in the event\n \t\t\t\twill indicate the party that was swapped into the parking lot.</para>\n       </description>\n     </managerEventInstance>\n   </managerEvent>\n-  <module language=\"en_US\" name=\"res_config_pgsql\">\n-    <depend>pgsql</depend>\n-    <support_level>extended</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"res_srtp\">\n-    <depend>srtp</depend>\n-    <use type=\"external\">openssl</use>\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"res_pjsip_empty_info\">\n-    <depend>pjproject</depend>\n-    <depend>res_pjsip</depend>\n-    <depend>res_pjsip_session</depend>\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"res_pjsip_registrar\">\n-    <depend>pjproject</depend>\n-    <depend>res_pjproject</depend>\n-    <depend>res_pjsip</depend>\n-    <support_level>core</support_level>\n-  </module>\n-  <manager name=\"PJSIPShowRegistrationsInbound\" language=\"en_US\">\n-    <synopsis>Lists PJSIP inbound registrations.</synopsis>\n-    <syntax/>\n-    <description>\n-      <para>\n-        In response,\n-        <literal>InboundRegistrationDetail</literal>\n-        events showing configuration\n-\t\t\tand status information are raised for all contacts, static or dynamic.  Once all events\n-\t\t\tare completed an\n-        <literal>InboundRegistrationDetailComplete</literal>\n-        is issued.\n-      </para>\n-      <warning>\n-        <para>\n-          This command just dumps all coonfigured AORs with contacts, even if the contact\n-\t\t\t\tis a permanent one.  To really get just inbound registrations, use\n-          <literal>PJSIPShowRegistrationInboundContactStatuses</literal>\n-          .\n-        </para>\n-      </warning>\n-    </description>\n-    <see-also>\n-      <ref type=\"manager\" module=\"res_pjsip_registrar\">PJSIPShowRegistrationInboundContactStatuses</ref>\n-    </see-also>\n-  </manager>\n-  <manager name=\"PJSIPShowRegistrationInboundContactStatuses\" language=\"en_US\">\n-    <synopsis>Lists ContactStatuses for PJSIP inbound registrations.</synopsis>\n-    <syntax/>\n-    <description>\n-      <para>\n-        In response,\n-        <literal>ContactStatusDetail</literal>\n-        events showing status information\n-\t\t\tare raised for each inbound registration (dynamic contact) object.  Once all events\n-\t\t\tare completed a\n-        <literal>ContactStatusDetailComplete</literal>\n-        event is issued.\n-      </para>\n-    </description>\n-  </manager>\n-  <module language=\"en_US\" name=\"res_mutestream\">\n-    <support_level>core</support_level>\n-  </module>\n-  <function name=\"MUTEAUDIO\" language=\"en_US\">\n-    <synopsis>Muting audio streams in the channel</synopsis>\n-    <syntax>\n-      <parameter name=\"direction\" required=\"true\">\n-        <para>Must be one of</para>\n-        <enumlist>\n-          <enum name=\"in\">\n-            <para>Inbound stream (to the PBX)</para>\n-          </enum>\n-          <enum name=\"out\">\n-            <para>Outbound stream (from the PBX)</para>\n-          </enum>\n-          <enum name=\"all\">\n-            <para>Both streams</para>\n-          </enum>\n-        </enumlist>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>The MUTEAUDIO function can be used to mute inbound (to the PBX) or outbound audio in a call.</para>\n-      <example title=\"Mute incoming audio\">exten =&gt; s,1,Set(MUTEAUDIO(in)=on)</example>\n-      <example title=\"Do not mute incoming audio\">exten =&gt; s,1,Set(MUTEAUDIO(in)=off)</example>\n-    </description>\n-  </function>\n-  <manager name=\"MuteAudio\" language=\"en_US\">\n-    <synopsis>Mute an audio stream.</synopsis>\n-    <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"Channel\" required=\"true\">\n-        <para>The channel you want to mute.</para>\n-      </parameter>\n-      <parameter name=\"Direction\" required=\"true\">\n-        <enumlist>\n-          <enum name=\"in\">\n-            <para>Set muting on inbound audio stream. (to the PBX)</para>\n-          </enum>\n-          <enum name=\"out\">\n-            <para>Set muting on outbound audio stream. (from the PBX)</para>\n-          </enum>\n-          <enum name=\"all\">\n-            <para>Set muting on inbound and outbound audio streams.</para>\n-          </enum>\n-        </enumlist>\n-      </parameter>\n-      <parameter name=\"State\" required=\"true\">\n-        <enumlist>\n-          <enum name=\"on\">\n-            <para>Turn muting on.</para>\n-          </enum>\n-          <enum name=\"off\">\n-            <para>Turn muting off.</para>\n-          </enum>\n-        </enumlist>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>Mute an incoming or outgoing audio stream on a channel.</para>\n-    </description>\n-  </manager>\n-  <module language=\"en_US\" name=\"res_pjsip_geolocation\">\n-    <depend>res_geolocation</depend>\n+  <module language=\"en_US\" name=\"res_pjsip_messaging\">\n     <depend>pjproject</depend>\n     <depend>res_pjsip</depend>\n     <depend>res_pjsip_session</depend>\n-    <depend>chan_pjsip</depend>\n-    <depend>libxml2</depend>\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"res_tonedetect\">\n-    <support_level>extended</support_level>\n-  </module>\n-  <application name=\"WaitForTone\" language=\"en_US\">\n-    <since>\n-      <version>16.21.0</version>\n-      <version>18.7.0</version>\n-      <version>19.0.0</version>\n-    </since>\n-    <synopsis>Wait for tone</synopsis>\n-    <syntax>\n-      <parameter name=\"freq\" required=\"true\">\n-        <para>Frequency of the tone to wait for.</para>\n-      </parameter>\n-      <parameter name=\"duration_ms\" required=\"false\">\n-        <para>Minimum duration of tone, in ms. Default is 500ms.\n-\t\t\t\tUsing a minimum duration under 50ms is unlikely to produce\n-\t\t\t\taccurate results.</para>\n-      </parameter>\n-      <parameter name=\"timeout\" required=\"false\">\n-        <para>Maximum amount of time, in seconds, to wait for specified tone.\n-\t\t\t\tDefault is forever.</para>\n-      </parameter>\n-      <parameter name=\"times\" required=\"false\">\n-        <para>Number of times the tone should be detected (subject to the\n-\t\t\t\tprovided timeout) before returning. Default is 1.</para>\n-      </parameter>\n-      <parameter name=\"options\" required=\"false\">\n-        <optionlist>\n-          <option name=\"d\">\n-            <para>Custom decibel threshold to use. Default is 16.</para>\n-          </option>\n-          <option name=\"s\">\n-            <para>Squelch tone.</para>\n-          </option>\n-        </optionlist>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>Waits for a single-frequency tone to be detected before dialplan execution continues.</para>\n-      <variablelist>\n-        <variable name=\"WAITFORTONESTATUS\">\n-          <para>This indicates the result of the wait.</para>\n-          <value name=\"SUCCESS\"/>\n-          <value name=\"ERROR\"/>\n-          <value name=\"TIMEOUT\"/>\n-          <value name=\"HANGUP\"/>\n-        </variable>\n-      </variablelist>\n-    </description>\n-    <see-also>\n-      <ref type=\"application\">PlayTones</ref>\n-    </see-also>\n-  </application>\n-  <application name=\"ToneScan\" language=\"en_US\">\n-    <since>\n-      <version>16.23.0</version>\n-      <version>18.9.0</version>\n-      <version>19.1.0</version>\n-    </since>\n-    <synopsis>Wait for period of time while scanning for call progress tones</synopsis>\n-    <syntax>\n-      <parameter name=\"zone\" required=\"false\">\n-        <para>Call progress zone. Default is the system default.</para>\n-      </parameter>\n-      <parameter name=\"timeout\" required=\"false\">\n-        <para>Maximum amount of time, in seconds, to wait for call progress\n-\t\t\t\tor signal tones. Default is forever.</para>\n-      </parameter>\n-      <parameter name=\"threshold\" required=\"false\">\n-        <para>DSP threshold required for a match. A higher number will\n-\t\t\t\trequire a longer match and may reduce false positives, at the\n-\t\t\t\texpense of false negatives. Default is 1.</para>\n-      </parameter>\n-      <parameter name=\"options\" required=\"false\">\n-        <optionlist>\n-          <option name=\"f\">\n-            <para>Enable fax machine detection. By default, this is disabled.</para>\n-          </option>\n-          <option name=\"v\">\n-            <para>Enable voice detection. By default, this is disabled.</para>\n-          </option>\n-        </optionlist>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>Waits for a a distinguishable call progress tone and then exits.\n-\t\t\tUnlike a conventional scanner, this is not currently capable of\n-\t\t\tscanning for modem carriers.</para>\n-      <variablelist>\n-        <variable name=\"TONESCANSTATUS\">\n-          This indicates the result of the scan.\n-          <value name=\"RINGING\">Audible ringback tone</value>\n-          <value name=\"BUSY\">Busy tone</value>\n-          <value name=\"SIT\">Special Information Tones</value>\n-          <value name=\"VOICE\">Human voice detected</value>\n-          <value name=\"DTMF\">DTMF digit</value>\n-          <value name=\"FAX\">Fax (answering)</value>\n-          <value name=\"MODEM\">Modem (answering)</value>\n-          <value name=\"DIALTONE\">Dial tone</value>\n-          <value name=\"NUT\">UK Number Unobtainable tone</value>\n-          <value name=\"TIMEOUT\">Timeout reached before any positive detection</value>\n-          <value name=\"HANGUP\">Caller hung up before any positive detection</value>\n-        </variable>\n-      </variablelist>\n-    </description>\n-    <see-also>\n-      <ref type=\"application\">WaitForTone</ref>\n-    </see-also>\n-  </application>\n-  <function name=\"TONE_DETECT\" language=\"en_US\">\n-    <since>\n-      <version>16.21.0</version>\n-      <version>18.7.0</version>\n-      <version>19.0.0</version>\n-    </since>\n-    <synopsis>Asynchronously detects a tone</synopsis>\n-    <syntax>\n-      <parameter name=\"freq\" required=\"true\">\n-        <para>Frequency of the tone to detect. To disable frequency\n-\t\t\t\tdetection completely (e.g. for signal detection only),\n-\t\t\t\tspecify 0 for the frequency.</para>\n-      </parameter>\n-      <parameter name=\"duration_ms\" required=\"false\">\n-        <para>Minimum duration of tone, in ms. Default is 500ms.\n-\t\t\t\tUsing a minimum duration under 50ms is unlikely to produce\n-\t\t\t\taccurate results.</para>\n-      </parameter>\n-      <parameter name=\"options\">\n-        <optionlist>\n-          <option name=\"a\">\n-            <para>Match immediately on Special Information Tones, instead of or in addition\n-\t\t\t\t\t\tto a particular frequency.</para>\n-          </option>\n-          <option name=\"b\">\n-            <para>Match immediately on a busy signal, instead of or in addition to\n-\t\t\t\t\t\ta particular frequency.</para>\n-          </option>\n-          <option name=\"c\">\n-            <para>Match immediately on a dial tone, instead of or in addition to\n-\t\t\t\t\t\ta particular frequency.</para>\n-          </option>\n-          <option name=\"d\">\n-            <para>Custom decibel threshold to use. Default is 16.</para>\n-          </option>\n-          <option name=\"g\">\n-            <para>Go to the specified context,exten,priority if tone is received on this channel.\n-\t\t\t\t\t\tDetection will not end automatically.</para>\n-          </option>\n-          <option name=\"h\">\n-            <para>Go to the specified context,exten,priority if tone is transmitted on this channel.\n-\t\t\t\t\t\tDetection will not end automatically.</para>\n-          </option>\n-          <option name=\"n\">\n-            <para>\n-              Number of times the tone should be detected (subject to the\n-\t\t\t\t\t\tprovided timeout) before going to the destination provided in the\n-              <literal>g</literal>\n-              or\n-              <literal>h</literal>\n-              option. Default is 1.\n-            </para>\n-          </option>\n-          <option name=\"r\">\n-            <para>Apply to received frames only. Default is both directions.</para>\n-          </option>\n-          <option name=\"s\">\n-            <para>Squelch tone.</para>\n-          </option>\n-          <option name=\"t\">\n-            <para>Apply to transmitted frames only. Default is both directions.</para>\n-          </option>\n-          <option name=\"x\">\n-            <para>Destroy the detector (stop detection).</para>\n-          </option>\n-        </optionlist>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>The TONE_DETECT function detects a single-frequency tone and keeps\n-\t\t\ttrack of how many times the tone has been detected.</para>\n-      <para>\n-        When reading this function (instead of writing), supply\n-        <literal>tx</literal>\n-        to get the number of times a tone has been detected in the TX direction and\n-        <literal>rx</literal>\n-        to get the number of times a tone has been detected in the\n-\t\t\tRX direction.\n-      </para>\n-      <example title=\"intercept2600\">same =&gt; n,Set(TONE_DETECT(2600,1000,g(got-2600,s,1))=) ; detect 2600 Hz\n-\t\t\tsame =&gt; n,Wait(15)\n-\t\t\tsame =&gt; n,NoOp(${TONE_DETECT(rx)})</example>\n-      <example title=\"dropondialtone\">same =&gt; n,Set(TONE_DETECT(0,,bg(my-hangup,s,1))=) ; disconnect a call if we hear a busy signal\n-\t\t\tsame =&gt; n,Goto(somewhere-else)\n-\t\t\tsame =&gt; n(myhangup),Hangup()</example>\n-      <example title=\"removedetector\">same =&gt; n,Set(TONE_DETECT(0,,x)=) ; remove the detector from the channel</example>\n-    </description>\n-  </function>\n-  <module language=\"en_US\" name=\"res_crypto\">\n-    <depend>openssl</depend>\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"res_format_attr_siren7\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"res_security_log\">\n+  <info name=\"MessageDestinationInfo\" language=\"en_US\" tech=\"PJSIP\">\n+    <para>\n+      The\n+      <literal>destination</literal>\n+      parameter is used to construct\n+\t\tthe Request URI for an outgoing message.  It can be in one of the following\n+\t\tformats, all prefixed with the\n+      <literal>pjsip:</literal>\n+      message tech.\n+    </para>\n+    <para/>\n+    <enumlist>\n+      <enum name=\"endpoint\">\n+        <para>Request URI comes from the endpoint's default aor and contact.</para>\n+      </enum>\n+      <enum name=\"endpoint/aor\">\n+        <para>Request URI comes from the specific aor/contact.</para>\n+      </enum>\n+      <enum name=\"endpoint@domain\">\n+        <para>Request URI from the endpoint's default aor and contact.  The domain is discarded.</para>\n+      </enum>\n+    </enumlist>\n+    <para/>\n+    <para>These all use the endpoint to send the message with the specified URI:</para>\n+    <para/>\n+    <enumlist>\n+      <enum name=\"endpoint/&lt;sip[s]:host&gt;&gt;\"/>\n+      <enum name=\"endpoint/&lt;sip[s]:user@host&gt;\"/>\n+      <enum name=\"endpoint/&quot;display name&quot; &lt;sip[s]:host&gt;\"/>\n+      <enum name=\"endpoint/&quot;display name&quot; &lt;sip[s]:user@host&gt;\"/>\n+      <enum name=\"endpoint/sip[s]:host\"/>\n+      <enum name=\"endpoint/sip[s]:user@host\"/>\n+      <enum name=\"endpoint/host\"/>\n+      <enum name=\"endpoint/user@host\"/>\n+    </enumlist>\n+    <para/>\n+    <para>These all use the default endpoint to send the message with the specified URI:</para>\n+    <para/>\n+    <enumlist>\n+      <enum name=\"&lt;sip[s]:host&gt;\"/>\n+      <enum name=\"&lt;sip[s]:user@host&gt;\"/>\n+      <enum name=\"&quot;display name&quot; &lt;sip[s]:host&gt;\"/>\n+      <enum name=\"&quot;display name&quot; &lt;sip[s]:user@host&gt;\"/>\n+      <enum name=\"sip[s]:host\"/>\n+      <enum name=\"sip[s]:user@host\"/>\n+    </enumlist>\n+    <para/>\n+    <para>These use the default endpoint to send the message with the specified host:</para>\n+    <para/>\n+    <enumlist>\n+      <enum name=\"host\"/>\n+      <enum name=\"user@host\"/>\n+    </enumlist>\n+    <para/>\n+    <para>This form is similar to a dialstring:</para>\n+    <para/>\n+    <enumlist>\n+      <enum name=\"PJSIP/user@endpoint\"/>\n+    </enumlist>\n+    <para/>\n+    <para>\n+      You still need to prefix the destination with\n+\t\tthe\n+      <literal>pjsip:</literal>\n+      message technology prefix.  For example:\n+      <literal>pjsip:PJSIP/8005551212@myprovider</literal>\n+      .\n+\t\tThe endpoint contact's URI will have the\n+      <literal>user</literal>\n+      inserted\n+\t\tinto it and will become the Request URI.  If the contact URI already has\n+\t\ta user specified, it will be replaced.\n+    </para>\n+    <para/>\n+  </info>\n+  <info name=\"MessageFromInfo\" language=\"en_US\" tech=\"PJSIP\">\n+    <para>\n+      The\n+      <literal>from</literal>\n+      parameter is used to specity the\n+      <literal>From:</literal>\n+      header in the outgoing SIP MESSAGE.  It will override the value specified in\n+\t\tMESSAGE(from) which itself will override any\n+      <literal>from</literal>\n+      value from\n+\t\tan incoming SIP MESSAGE.\n+    </para>\n+    <para/>\n+  </info>\n+  <info name=\"MessageToInfo\" language=\"en_US\" tech=\"PJSIP\">\n+    <para>\n+      The\n+      <literal>to</literal>\n+      parameter is used to specity the\n+      <literal>To:</literal>\n+      header in the outgoing SIP MESSAGE.  It will override the value specified in\n+\t\tMESSAGE(to) which itself will override any\n+      <literal>to</literal>\n+      value from\n+\t\tan incoming SIP MESSAGE.\n+    </para>\n+    <para/>\n+  </info>\n+  <module language=\"en_US\" name=\"res_timing_dahdi\">\n+    <depend>dahdi</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"res_ari_playbacks\">\n-    <depend type=\"module\">res_ari</depend>\n-    <depend type=\"module\">res_ari_model</depend>\n+  <module language=\"en_US\" name=\"res_stasis_playback\">\n     <depend type=\"module\">res_stasis</depend>\n-    <depend type=\"module\">res_stasis_playback</depend>\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"res_pjsip_caller_id\">\n-    <depend>pjproject</depend>\n-    <depend>res_pjsip</depend>\n-    <depend>res_pjsip_session</depend>\n+    <depend type=\"module\">res_stasis_recording</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"res_stir_shaken\">\n-    <depend>crypto</depend>\n-    <depend>curl</depend>\n-    <depend>res_curl</depend>\n-    <support_level>core</support_level>\n+  <module language=\"en_US\" name=\"res_hep\">\n+    <support_level>extended</support_level>\n   </module>\n-  <configInfo name=\"res_stir_shaken\" language=\"en_US\">\n-    <synopsis>STIR/SHAKEN module for Asterisk</synopsis>\n-    <configFile name=\"stir_shaken.conf\">\n+  <configInfo name=\"res_hep\" language=\"en_US\">\n+    <synopsis>Resource for integration with Homer using HEPv3</synopsis>\n+    <configFile name=\"hep.conf\">\n       <configObject name=\"general\">\n-        <synopsis>STIR/SHAKEN general options</synopsis>\n-        <configOption name=\"type\">\n-          <synopsis>Must be of type 'general'.</synopsis>\n-        </configOption>\n-        <configOption name=\"ca_file\" default=\"\">\n-          <synopsis>File path to the certificate authority certificate</synopsis>\n+        <synopsis>General settings.</synopsis>\n+        <description>\n+          <para>\n+            The\n+            <emphasis>general</emphasis>\n+            settings section contains information\n+\t\t\t\t\tto configure Asterisk as a Homer capture agent.\n+          </para>\n+        </description>\n+        <configOption name=\"enabled\" default=\"yes\">\n+          <synopsis>Enable or disable packet capturing.</synopsis>\n+          <description>\n+            <enumlist>\n+              <enum name=\"no\"/>\n+              <enum name=\"yes\"/>\n+            </enumlist>\n+          </description>\n         </configOption>\n-        <configOption name=\"ca_path\" default=\"\">\n-          <synopsis>File path to a chain of trust</synopsis>\n+        <configOption name=\"uuid_type\" default=\"call-id\">\n+          <synopsis>The preferred type of UUID to pass to Homer.</synopsis>\n+          <description>\n+            <enumlist>\n+              <enum name=\"call-id\">\n+                <para>Use the PJSIP Call-Id</para>\n+              </enum>\n+              <enum name=\"channel\">\n+                <para>Use the Asterisk channel name</para>\n+              </enum>\n+            </enumlist>\n+          </description>\n         </configOption>\n-        <configOption name=\"cache_max_size\" default=\"1000\">\n-          <synopsis>Maximum size to use for caching public keys</synopsis>\n+        <configOption name=\"capture_address\">\n+          <synopsis>The address and port of the Homer server to send packets to.</synopsis>\n         </configOption>\n-        <configOption name=\"curl_timeout\" default=\"2\">\n-          <synopsis>Maximum time to wait to CURL certificates</synopsis>\n+        <configOption name=\"capture_password\">\n+          <synopsis>If set, the authentication password to send to Homer.</synopsis>\n         </configOption>\n-        <configOption name=\"signature_timeout\" default=\"15\">\n-          <synopsis>Amount of time a signature is valid for</synopsis>\n+        <configOption name=\"capture_id\" default=\"0\">\n+          <synopsis>The ID for this capture agent.</synopsis>\n         </configOption>\n       </configObject>\n-      <configObject name=\"store\">\n-        <synopsis>STIR/SHAKEN certificate store options</synopsis>\n-        <configOption name=\"type\">\n-          <synopsis>Must be of type 'store'.</synopsis>\n-        </configOption>\n-        <configOption name=\"path\" default=\"\">\n-          <synopsis>Path to a directory containing certificates</synopsis>\n+    </configFile>\n+  </configInfo>\n+  <module language=\"en_US\" name=\"res_corosync\">\n+    <depend>corosync</depend>\n+    <defaultenabled>no</defaultenabled>\n+    <support_level>extended</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"res_pjsip_outbound_publish\">\n+    <depend>pjproject</depend>\n+    <depend>res_pjproject</depend>\n+    <depend>res_pjsip</depend>\n+    <support_level>core</support_level>\n+  </module>\n+  <configInfo name=\"res_pjsip_outbound_publish\" language=\"en_US\">\n+    <synopsis>SIP resource for outbound publish</synopsis>\n+    <description>\n+      <para>\n+        <emphasis>Outbound Publish</emphasis>\n+      </para>\n+      <para>\n+        This module allows\n+        <literal>res_pjsip</literal>\n+        to publish to other SIP servers.\n+      </para>\n+    </description>\n+    <configFile name=\"pjsip.conf\">\n+      <configObject name=\"outbound-publish\">\n+        <synopsis>The configuration for outbound publish</synopsis>\n+        <description>\n+          <para>\n+            Publish is\n+            <emphasis>COMPLETELY</emphasis>\n+            separate from the rest of\n+            <literal>pjsip.conf</literal>\n+            . A minimal configuration consists of\n+\t\t\t\t\tsetting a\n+            <literal>server_uri</literal>\n+            and\n+            <literal>event</literal>\n+            .\n+          </para>\n+        </description>\n+        <configOption name=\"expiration\" default=\"3600\">\n+          <synopsis>Expiration time for publications in seconds</synopsis>\n         </configOption>\n-        <configOption name=\"public_cert_url\" default=\"\">\n-          <synopsis>URL to the public certificate(s)</synopsis>\n+        <configOption name=\"outbound_auth\" default=\"\">\n+          <synopsis>Authentication object(s) to be used for outbound publishes.</synopsis>\n           <description>\n-            <para>Must be a valid http, or https, URL. The URL must also contain the ${CERTIFICATE} variable, which is used for public key name substitution.\n-\t\t\t\t\t For example: http://mycompany.com/${CERTIFICATE}.pub</para>\n+            <para>\n+              This is a comma-delimited list of\n+              <replaceable>auth</replaceable>\n+              sections defined in\n+              <filename>pjsip.conf</filename>\n+              used to respond\n+\t\t\t\t\t\tto outbound authentication challenges.\n+            </para>\n+            <note>\n+              <para>Using the same auth section for inbound and outbound\n+\t\t\t\t\t\tauthentication is not recommended.  There is a difference in\n+\t\t\t\t\t\tmeaning for an empty realm setting between inbound and outbound\n+\t\t\t\t\t\tauthentication uses.  See the auth realm description for details.</para>\n+            </note>\n           </description>\n         </configOption>\n-      </configObject>\n-      <configObject name=\"certificate\">\n-        <synopsis>STIR/SHAKEN certificate options</synopsis>\n-        <configOption name=\"type\">\n-          <synopsis>Must be of type 'certificate'.</synopsis>\n+        <configOption name=\"outbound_proxy\" default=\"\">\n+          <synopsis>Full SIP URI of the outbound proxy used to send publishes</synopsis>\n         </configOption>\n-        <configOption name=\"path\" default=\"\">\n-          <synopsis>File path to a certificate</synopsis>\n+        <configOption name=\"server_uri\">\n+          <synopsis>SIP URI of the server and entity to publish to</synopsis>\n+          <description>\n+            <para>This is the URI at which to find the entity and server to send the outbound PUBLISH to.\n+\t\t\t\t\t\tThis URI is used as the request URI of the outbound PUBLISH request from Asterisk.</para>\n+          </description>\n         </configOption>\n-        <configOption name=\"public_cert_url\" default=\"\">\n-          <synopsis>URL to the public certificate</synopsis>\n+        <configOption name=\"from_uri\">\n+          <synopsis>SIP URI to use in the From header</synopsis>\n           <description>\n-            <para>Must be a valid http, or https, URL.</para>\n+            <para>\n+              This is the URI that will be placed into the From header of outgoing PUBLISH\n+\t\t\t\t\t\tmessages. If no URI is specified then the URI provided in\n+              <literal>server_uri</literal>\n+              will be used.\n+            </para>\n           </description>\n         </configOption>\n-        <configOption name=\"attestation\">\n-          <synopsis>Attestation level</synopsis>\n+        <configOption name=\"to_uri\">\n+          <synopsis>SIP URI to use in the To header</synopsis>\n+          <description>\n+            <para>\n+              This is the URI that will be placed into the To header of outgoing PUBLISH\n+\t\t\t\t\t\tmessages. If no URI is specified then the URI provided in\n+              <literal>server_uri</literal>\n+              will be used.\n+            </para>\n+          </description>\n         </configOption>\n-        <configOption name=\"caller_id_number\" default=\"\">\n-          <synopsis>The caller ID number to match on.</synopsis>\n+        <configOption name=\"event\" default=\"\">\n+          <synopsis>Event type of the PUBLISH.</synopsis>\n         </configOption>\n-      </configObject>\n-      <configObject name=\"profile\">\n-        <synopsis>STIR/SHAKEN profile configuration options</synopsis>\n-        <configOption name=\"type\">\n-          <synopsis>Must be of type 'profile'.</synopsis>\n+        <configOption name=\"max_auth_attempts\" default=\"5\">\n+          <synopsis>Maximum number of authentication attempts before stopping the publication.</synopsis>\n         </configOption>\n-        <configOption name=\"stir_shaken\" default=\"on\">\n-          <synopsis>STIR/SHAKEN configuration settings</synopsis>\n+        <configOption name=\"transport\">\n+          <synopsis>Transport used for outbound publish</synopsis>\n           <description>\n-            <para>Attest, verify, or do both STIR/SHAKEN operations. On incoming\n-\t\t\t\t\t\tINVITEs, the Identity header will be checked for validity. On\n-\t\t\t\t\t\toutgoing INVITEs, an Identity header will be added.</para>\n+            <note>\n+              <para>\n+                A\n+                <replaceable>transport</replaceable>\n+                configured in\n+                <literal>pjsip.conf</literal>\n+                . As with other\n+                <literal>res_pjsip</literal>\n+                modules, this will use the first available transport of the appropriate type if unconfigured.\n+              </para>\n+            </note>\n           </description>\n         </configOption>\n-        <configOption name=\"acllist\" default=\"\">\n-          <synopsis>An existing ACL from acl.conf to use</synopsis>\n-        </configOption>\n-        <configOption name=\"permit\" default=\"\">\n-          <synopsis>An IP or subnet to permit</synopsis>\n+        <configOption name=\"multi_user\" default=\"no\">\n+          <synopsis>Enable multi-user support</synopsis>\n+          <description>\n+            <para>When enabled the user portion of the server uri is replaced by a dynamically created user</para>\n+          </description>\n         </configOption>\n-        <configOption name=\"deny\" default=\"\">\n-          <synopsis>An IP or subnet to deny</synopsis>\n+        <configOption name=\"type\">\n+          <synopsis>Must be of type 'outbound-publish'.</synopsis>\n         </configOption>\n       </configObject>\n     </configFile>\n   </configInfo>\n-  <function name=\"STIR_SHAKEN\" language=\"en_US\">\n-    <synopsis>Gets the number of STIR/SHAKEN results or a specific STIR/SHAKEN value from a result on the channel.</synopsis>\n-    <syntax>\n-      <parameter name=\"index\" required=\"true\">\n-        <para>The index of the STIR/SHAKEN result to get. If only 'count' is passed in, gets the number of STIR/SHAKEN results instead.</para>\n-      </parameter>\n-      <parameter name=\"value\" required=\"false\">\n-        <para>The value to get from the STIR/SHAKEN result. Only used when an index is passed in (instead of 'count'). Allowable values:</para>\n-        <enumlist>\n-          <enum name=\"identity\"/>\n-          <enum name=\"attestation\"/>\n-          <enum name=\"verify_result\"/>\n-        </enumlist>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>This function will either return the number of STIR/SHAKEN identities, or return information on the specified identity.\n-\t\t\tTo get the number of identities, just pass 'count' as the only parameter to the function. If you want to get information on a\n-\t\t\tspecific STIR/SHAKEN identity, you can get the number of identities and then pass an index as the first parameter and one of\n-\t\t\tthe values you would like to retrieve as the second parameter.</para>\n-      <example title=\"Get count and retrieve value\">same =&gt; n,NoOp(Number of STIR/SHAKEN identities: ${STIR_SHAKEN(count)})\n-\t\t\tsame =&gt; n,NoOp(Identity ${STIR_SHAKEN(0, identity)} has attestation level ${STIR_SHAKEN(0, attestation)})</example>\n-    </description>\n-  </function>\n-  <module language=\"en_US\" name=\"res_calendar\">\n+  <module language=\"en_US\" name=\"res_format_attr_siren7\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"res_calendar_exchange\">\n+    <depend>res_calendar</depend>\n+    <depend>neon</depend>\n+    <depend>ical</depend>\n+    <depend>iksemel</depend>\n     <support_level>extended</support_level>\n   </module>\n-  <function name=\"CALENDAR_BUSY\" language=\"en_US\">\n-    <synopsis>Determine if the calendar is marked busy at this time.</synopsis>\n-    <syntax>\n-      <parameter name=\"calendar\" required=\"true\"/>\n-    </syntax>\n-    <description>\n-      <para>Check the specified calendar's current busy status.</para>\n-    </description>\n-    <see-also>\n-      <ref type=\"function\">CALENDAR_EVENT</ref>\n-      <ref type=\"function\">CALENDAR_QUERY</ref>\n-      <ref type=\"function\">CALENDAR_QUERY_RESULT</ref>\n-      <ref type=\"function\">CALENDAR_WRITE</ref>\n-    </see-also>\n-  </function>\n-  <function name=\"CALENDAR_EVENT\" language=\"en_US\">\n-    <synopsis>Get calendar event notification data from a notification call.</synopsis>\n-    <syntax>\n-      <parameter name=\"field\" required=\"true\">\n-        <enumlist>\n-          <enum name=\"summary\">\n-            <para>The VEVENT SUMMARY property or Exchange event 'subject'</para>\n-          </enum>\n-          <enum name=\"description\">\n-            <para>The text description of the event</para>\n-          </enum>\n-          <enum name=\"organizer\">\n-            <para>The organizer of the event</para>\n-          </enum>\n-          <enum name=\"location\">\n-            <para>The location of the event</para>\n-          </enum>\n-          <enum name=\"categories\">\n-            <para>The categories of the event</para>\n-          </enum>\n-          <enum name=\"priority\">\n-            <para>The priority of the event</para>\n-          </enum>\n-          <enum name=\"calendar\">\n-            <para>The name of the calendar associated with the event</para>\n-          </enum>\n-          <enum name=\"uid\">\n-            <para>The unique identifier for this event</para>\n-          </enum>\n-          <enum name=\"start\">\n-            <para>The start time of the event</para>\n-          </enum>\n-          <enum name=\"end\">\n-            <para>The end time of the event</para>\n-          </enum>\n-          <enum name=\"busystate\">\n-            <para>The busy state of the event 0=FREE, 1=TENTATIVE, 2=BUSY</para>\n-          </enum>\n-        </enumlist>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>Whenever a calendar event notification call is made, the event data\n-\t\t\tmay be accessed with this function.</para>\n-    </description>\n-    <see-also>\n-      <ref type=\"function\">CALENDAR_BUSY</ref>\n-      <ref type=\"function\">CALENDAR_QUERY</ref>\n-      <ref type=\"function\">CALENDAR_QUERY_RESULT</ref>\n-      <ref type=\"function\">CALENDAR_WRITE</ref>\n-    </see-also>\n-  </function>\n-  <function name=\"CALENDAR_QUERY\" language=\"en_US\">\n-    <synopsis>Query a calendar server and store the data on a channel</synopsis>\n-    <syntax>\n-      <parameter name=\"calendar\" required=\"true\">\n-        <para>The calendar that should be queried</para>\n-      </parameter>\n-      <parameter name=\"start\" required=\"false\">\n-        <para>The start time of the query (in seconds since epoch)</para>\n-      </parameter>\n-      <parameter name=\"end\" required=\"false\">\n-        <para>The end time of the query (in seconds since epoch)</para>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>\n-        Get a list of events in the currently accessible timeframe of the\n-        <replaceable>calendar</replaceable>\n-        The function returns the id for accessing the result with CALENDAR_QUERY_RESULT()\n-      </para>\n-    </description>\n-    <see-also>\n-      <ref type=\"function\">CALENDAR_BUSY</ref>\n-      <ref type=\"function\">CALENDAR_EVENT</ref>\n-      <ref type=\"function\">CALENDAR_QUERY_RESULT</ref>\n-      <ref type=\"function\">CALENDAR_WRITE</ref>\n-    </see-also>\n-  </function>\n-  <function name=\"CALENDAR_QUERY_RESULT\" language=\"en_US\">\n-    <synopsis>Retrieve data from a previously run CALENDAR_QUERY() call</synopsis>\n-    <syntax>\n-      <parameter name=\"id\" required=\"true\">\n-        <para>\n-          The query ID returned by\n-          <literal>CALENDAR_QUERY</literal>\n-        </para>\n-      </parameter>\n-      <parameter name=\"field\" required=\"true\">\n-        <enumlist>\n-          <enum name=\"getnum\">\n-            <para>number of events occurring during time range</para>\n-          </enum>\n-          <enum name=\"summary\">\n-            <para>A summary of the event</para>\n-          </enum>\n-          <enum name=\"description\">\n-            <para>The full event description</para>\n-          </enum>\n-          <enum name=\"organizer\">\n-            <para>The event organizer</para>\n-          </enum>\n-          <enum name=\"location\">\n-            <para>The event location</para>\n-          </enum>\n-          <enum name=\"categories\">\n-            <para>The categories of the event</para>\n-          </enum>\n-          <enum name=\"priority\">\n-            <para>The priority of the event</para>\n-          </enum>\n-          <enum name=\"calendar\">\n-            <para>The name of the calendar associted with the event</para>\n-          </enum>\n-          <enum name=\"uid\">\n-            <para>The unique identifier for the event</para>\n-          </enum>\n-          <enum name=\"start\">\n-            <para>The start time of the event (in seconds since epoch)</para>\n-          </enum>\n-          <enum name=\"end\">\n-            <para>The end time of the event (in seconds since epoch)</para>\n-          </enum>\n-          <enum name=\"busystate\">\n-            <para>The busy status of the event 0=FREE, 1=TENTATIVE, 2=BUSY</para>\n-          </enum>\n-        </enumlist>\n-      </parameter>\n-      <parameter name=\"entry\" required=\"false\" default=\"1\">\n-        <para>Return data from a specific event returned by the query</para>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>\n-        After running CALENDAR_QUERY and getting a result\n-        <replaceable>id</replaceable>\n-        , calling\n-        <literal>CALENDAR_QUERY</literal>\n-        with that\n-        <replaceable>id</replaceable>\n-        and a\n-        <replaceable>field</replaceable>\n-        will return the data for that field. If multiple events matched the query, and\n-        <replaceable>entry</replaceable>\n-        is provided, information from that event will be returned.\n-      </para>\n-    </description>\n-    <see-also>\n-      <ref type=\"function\">CALENDAR_BUSY</ref>\n-      <ref type=\"function\">CALENDAR_EVENT</ref>\n-      <ref type=\"function\">CALENDAR_QUERY</ref>\n-      <ref type=\"function\">CALENDAR_WRITE</ref>\n-    </see-also>\n-  </function>\n-  <function name=\"CALENDAR_WRITE\" language=\"en_US\">\n-    <synopsis>Write an event to a calendar</synopsis>\n-    <syntax>\n-      <parameter name=\"calendar\" required=\"true\">\n-        <para>The calendar to write to</para>\n-      </parameter>\n-      <parameter name=\"field\" multiple=\"true\" required=\"true\">\n-        <enumlist>\n-          <enum name=\"summary\">\n-            <para>A summary of the event</para>\n-          </enum>\n-          <enum name=\"description\">\n-            <para>The full event description</para>\n-          </enum>\n-          <enum name=\"organizer\">\n-            <para>The event organizer</para>\n-          </enum>\n-          <enum name=\"location\">\n-            <para>The event location</para>\n-          </enum>\n-          <enum name=\"categories\">\n-            <para>The categories of the event</para>\n-          </enum>\n-          <enum name=\"priority\">\n-            <para>The priority of the event</para>\n-          </enum>\n-          <enum name=\"uid\">\n-            <para>The unique identifier for the event</para>\n-          </enum>\n-          <enum name=\"start\">\n-            <para>The start time of the event (in seconds since epoch)</para>\n-          </enum>\n-          <enum name=\"end\">\n-            <para>The end time of the event (in seconds since epoch)</para>\n-          </enum>\n-          <enum name=\"busystate\">\n-            <para>The busy status of the event 0=FREE, 1=TENTATIVE, 2=BUSY</para>\n-          </enum>\n-        </enumlist>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <example title=\"Set calendar fields\">same =&gt; n,Set(CALENDAR_WRITE(calendar,field1,field2,field3)=val1,val2,val3)</example>\n-      <para>The field and value arguments can easily be set/passed using the HASHKEYS() and HASH() functions</para>\n-      <variablelist>\n-        <variable name=\"CALENDAR_SUCCESS\">\n-          <para>The status of the write operation to the calendar</para>\n-          <value name=\"1\">The event was successfully written to the calendar.</value>\n-          <value name=\"0\">The event was not written to the calendar due to network issues, permissions, etc.</value>\n-        </variable>\n-      </variablelist>\n-    </description>\n-    <see-also>\n-      <ref type=\"function\">CALENDAR_BUSY</ref>\n-      <ref type=\"function\">CALENDAR_EVENT</ref>\n-      <ref type=\"function\">CALENDAR_QUERY</ref>\n-      <ref type=\"function\">CALENDAR_QUERY_RESULT</ref>\n-    </see-also>\n-  </function>\n-  <module language=\"en_US\" name=\"res_ael_share\">\n+  <module language=\"en_US\" name=\"res_odbc\">\n+    <depend>generic_odbc</depend>\n+    <depend>res_odbc_transaction</depend>\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"res_ari_recordings\">\n+    <depend type=\"module\">res_ari</depend>\n+    <depend type=\"module\">res_ari_model</depend>\n+    <depend type=\"module\">res_stasis</depend>\n+    <depend type=\"module\">res_stasis_recording</depend>\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"res_config_ldap\">\n+    <depend>ldap</depend>\n     <support_level>extended</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"res_pjsip_history\">\n+  <module language=\"en_US\" name=\"res_srtp\">\n+    <depend>srtp</depend>\n+    <use type=\"external\">openssl</use>\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"res_format_attr_celt\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"res_pktccops\">\n+    <defaultenabled>no</defaultenabled>\n+    <support_level>extended</support_level>\n+    <deprecated_in>19</deprecated_in>\n+    <removed_in>21</removed_in>\n+  </module>\n+  <module language=\"en_US\" name=\"res_pjsip_one_touch_record_info\">\n     <depend>pjproject</depend>\n     <depend>res_pjsip</depend>\n-    <support_level>extended</support_level>\n+    <depend>res_pjsip_session</depend>\n+    <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"res_calendar_caldav\">\n-    <depend>res_calendar</depend>\n-    <depend>neon</depend>\n-    <depend>ical</depend>\n-    <depend>libxml2</depend>\n-    <support_level>extended</support_level>\n+  <module language=\"en_US\" name=\"res_format_attr_vp8\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"res_sorcery_config\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"res_format_attr_g729\">\n+    <support_level>core</support_level>\n   </module>\n   <module language=\"en_US\" name=\"res_config_sqlite\">\n     <depend>sqlite</depend>\n     <support_level>deprecated</support_level>\n     <deprecated_in>16</deprecated_in>\n     <removed_in>19</removed_in>\n   </module>\n-  <module language=\"en_US\" name=\"res_pjsip_pidf_eyebeam_body_supplement\">\n-    <depend>pjproject</depend>\n-    <depend>res_pjsip</depend>\n-    <depend>res_pjsip_pubsub</depend>\n+  <module language=\"en_US\" name=\"resource_playbacks\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"res_pjsip_xpidf_body_generator\">\n+  <module language=\"en_US\" name=\"resource_channels\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"resource_asterisk\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"resource_device_states\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"resource_bridges\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"resource_mailboxes\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"resource_recordings\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"resource_events\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"res_pjsip_stir_shaken\">\n     <depend>pjproject</depend>\n     <depend>res_pjsip</depend>\n-    <depend>res_pjsip_pubsub</depend>\n+    <depend>res_pjsip_session</depend>\n+    <depend>res_stir_shaken</depend>\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"res_stasis_mailbox\">\n+    <depend type=\"module\">res_stasis</depend>\n+    <depend type=\"module\">res_mwi_external</depend>\n     <support_level>core</support_level>\n   </module>\n+  <module language=\"en_US\" name=\"res_calendar_caldav\">\n+    <depend>res_calendar</depend>\n+    <depend>neon</depend>\n+    <depend>ical</depend>\n+    <depend>libxml2</depend>\n+    <support_level>extended</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"res_calendar_icalendar\">\n+    <depend>res_calendar</depend>\n+    <depend>neon</depend>\n+    <depend>ical</depend>\n+    <support_level>extended</support_level>\n+  </module>\n   <module language=\"en_US\" name=\"res_pjsip_pubsub\">\n     <depend>pjproject</depend>\n     <depend>res_pjsip</depend>\n     <support_level>core</support_level>\n   </module>\n   <manager name=\"PJSIPShowSubscriptionsInbound\" language=\"en_US\">\n     <synopsis>Lists subscriptions.</synopsis>\n@@ -30180,506 +29990,840 @@\n         </configOption>\n         <configOption name=\"type\">\n           <synopsis>Must be of type 'inbound-publication'.</synopsis>\n         </configOption>\n       </configObject>\n     </configFile>\n   </configInfo>\n-  <module language=\"en_US\" name=\"res_corosync\">\n-    <depend>corosync</depend>\n-    <defaultenabled>no</defaultenabled>\n-    <support_level>extended</support_level>\n+  <module language=\"en_US\" name=\"res_adsi\">\n+    <support_level>deprecated</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"res_format_attr_ilbc\">\n+  <module language=\"en_US\" name=\"res_stasis\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"res_pjsip_session\">\n+  <module language=\"en_US\" name=\"res_pjsip_outbound_authenticator_digest\">\n     <depend>pjproject</depend>\n     <depend>res_pjsip</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"res_format_attr_siren14\">\n+  <module language=\"en_US\" name=\"res_http_post\">\n+    <depend>gmime</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"res_sorcery_memory_cache\">\n+  <module language=\"en_US\" name=\"res_pjsip_publish_asterisk\">\n+    <depend>pjproject</depend>\n+    <depend>res_pjsip</depend>\n+    <depend>res_pjsip_outbound_publish</depend>\n+    <depend>res_pjsip_pubsub</depend>\n     <support_level>core</support_level>\n   </module>\n-  <manager name=\"SorceryMemoryCacheExpireObject\" language=\"en_US\">\n-    <synopsis>Expire (remove) an object from a sorcery memory cache.</synopsis>\n+  <configInfo name=\"res_pjsip_publish_asterisk\" language=\"en_US\">\n+    <synopsis>SIP resource for inbound and outbound Asterisk event publications</synopsis>\n+    <description>\n+      <para>\n+        <emphasis>Inbound and outbound Asterisk event publication</emphasis>\n+      </para>\n+      <para>\n+        This module allows\n+        <literal>res_pjsip</literal>\n+        to send and receive Asterisk event publications.\n+      </para>\n+    </description>\n+    <configFile name=\"pjsip.conf\">\n+      <configObject name=\"asterisk-publication\">\n+        <synopsis>The configuration for inbound Asterisk event publication</synopsis>\n+        <description>\n+          <para>\n+            Publish is\n+            <emphasis>COMPLETELY</emphasis>\n+            separate from the rest of\n+            <literal>pjsip.conf</literal>\n+            .\n+          </para>\n+        </description>\n+        <configOption name=\"devicestate_publish\">\n+          <synopsis>Optional name of a publish item that can be used to publish a request for full device state information.</synopsis>\n+        </configOption>\n+        <configOption name=\"mailboxstate_publish\">\n+          <synopsis>Optional name of a publish item that can be used to publish a request for full mailbox state information.</synopsis>\n+        </configOption>\n+        <configOption name=\"device_state\" default=\"no\">\n+          <synopsis>Whether we should permit incoming device state events.</synopsis>\n+        </configOption>\n+        <configOption name=\"device_state_filter\">\n+          <synopsis>Optional regular expression used to filter what devices we accept events for.</synopsis>\n+        </configOption>\n+        <configOption name=\"mailbox_state\" default=\"no\">\n+          <synopsis>Whether we should permit incoming mailbox state events.</synopsis>\n+        </configOption>\n+        <configOption name=\"mailbox_state_filter\">\n+          <synopsis>Optional regular expression used to filter what mailboxes we accept events for.</synopsis>\n+        </configOption>\n+        <configOption name=\"type\">\n+          <synopsis>Must be of type 'asterisk-publication'.</synopsis>\n+        </configOption>\n+      </configObject>\n+    </configFile>\n+  </configInfo>\n+  <module language=\"en_US\" name=\"res_pjsip_mwi_body_generator\">\n+    <depend>pjproject</depend>\n+    <depend>res_pjsip</depend>\n+    <depend>res_pjsip_pubsub</depend>\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"res_smdi\">\n+    <support_level>extended</support_level>\n+  </module>\n+  <function name=\"SMDI_MSG_RETRIEVE\" language=\"en_US\">\n+    <synopsis>Retrieve an SMDI message.</synopsis>\n     <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"Cache\" required=\"true\">\n-        <para>The name of the cache to expire the object from.</para>\n+      <parameter name=\"smdi port\" required=\"true\"/>\n+      <parameter name=\"search key\" required=\"true\"/>\n+      <parameter name=\"timeout\"/>\n+      <parameter name=\"options\">\n+        <enumlist>\n+          <enum name=\"t\">\n+            <para>Instead of searching on the forwarding station, search on the message desk terminal.</para>\n+          </enum>\n+          <enum name=\"n\">\n+            <para>Instead of searching on the forwarding station, search on the message desk number.</para>\n+          </enum>\n+        </enumlist>\n       </parameter>\n-      <parameter name=\"Object\" required=\"true\">\n-        <para>The name of the object to expire.</para>\n+    </syntax>\n+    <description>\n+      <para>This function is used to retrieve an incoming SMDI message. It returns\n+\t\t\tan ID which can be used with the SMDI_MSG() function to access details of\n+\t\t\tthe message.  Note that this is a destructive function in the sense that\n+\t\t\tonce an SMDI message is retrieved using this function, it is no longer in\n+\t\t\tthe global SMDI message queue, and can not be accessed by any other Asterisk\n+\t\t\tchannels.  The timeout for this function is optional, and the default is\n+\t\t\t3 seconds.  When providing a timeout, it should be in milliseconds.</para>\n+      <para>The default search is done on the forwarding station ID. However, if\n+\t\t\tyou set one of the search key options in the options field, you can change\n+\t\t\tthis behavior.</para>\n+    </description>\n+    <see-also>\n+      <ref type=\"function\">SMDI_MSG</ref>\n+    </see-also>\n+  </function>\n+  <function name=\"SMDI_MSG\" language=\"en_US\">\n+    <synopsis>Retrieve details about an SMDI message.</synopsis>\n+    <syntax>\n+      <parameter name=\"message_id\" required=\"true\"/>\n+      <parameter name=\"component\" required=\"true\">\n+        <para>Valid message components are:</para>\n+        <enumlist>\n+          <enum name=\"number\">\n+            <para>The message desk number</para>\n+          </enum>\n+          <enum name=\"terminal\">\n+            <para>The message desk terminal</para>\n+          </enum>\n+          <enum name=\"station\">\n+            <para>The forwarding station</para>\n+          </enum>\n+          <enum name=\"callerid\">\n+            <para>The callerID of the calling party that was forwarded</para>\n+          </enum>\n+          <enum name=\"type\">\n+            <para>The call type.  The value here is the exact character\n+\t\t\t\t\t\tthat came in on the SMDI link.  Typically, example values\n+\t\t\t\t\t\tare:</para>\n+            <para>Options:</para>\n+            <enumlist>\n+              <enum name=\"D\">\n+                <para>Direct Calls</para>\n+              </enum>\n+              <enum name=\"A\">\n+                <para>Forward All Calls</para>\n+              </enum>\n+              <enum name=\"B\">\n+                <para>Forward Busy Calls</para>\n+              </enum>\n+              <enum name=\"N\">\n+                <para>Forward No Answer Calls</para>\n+              </enum>\n+            </enumlist>\n+          </enum>\n+        </enumlist>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>Expires (removes) an object from a sorcery memory cache. If full backend caching is enabled\n-\t\t\tthis action is not available and will fail. In this case the SorceryMemoryCachePopulate or\n-\t\t\tSorceryMemoryCacheExpire AMI actions must be used instead.</para>\n+      <para>This function is used to access details of an SMDI message that was\n+\t\t\tpulled from the incoming SMDI message queue using the SMDI_MSG_RETRIEVE()\n+\t\t\tfunction.</para>\n     </description>\n-  </manager>\n-  <manager name=\"SorceryMemoryCacheExpire\" language=\"en_US\">\n-    <synopsis>Expire (remove) ALL objects from a sorcery memory cache.</synopsis>\n+    <see-also>\n+      <ref type=\"function\">SMDI_MSG_RETRIEVE</ref>\n+    </see-also>\n+  </function>\n+  <module language=\"en_US\" name=\"res_ari_channels\">\n+    <depend type=\"module\">res_ari</depend>\n+    <depend type=\"module\">res_ari_model</depend>\n+    <depend type=\"module\">res_stasis</depend>\n+    <depend type=\"module\">res_stasis_answer</depend>\n+    <depend type=\"module\">res_stasis_playback</depend>\n+    <depend type=\"module\">res_stasis_recording</depend>\n+    <depend type=\"module\">res_stasis_snoop</depend>\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"res_pjsip_pidf_digium_body_supplement\">\n+    <depend>pjproject</depend>\n+    <depend>res_pjsip</depend>\n+    <depend>res_pjsip_pubsub</depend>\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"res_monitor\">\n+    <use type=\"module\">func_periodic_hook</use>\n+    <support_level>deprecated</support_level>\n+    <replacement>app_mixmonitor</replacement>\n+    <deprecated_in>16</deprecated_in>\n+    <removed_in>21</removed_in>\n+  </module>\n+  <application name=\"Monitor\" language=\"en_US\">\n+    <synopsis>Monitor a channel.</synopsis>\n     <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"Cache\" required=\"true\">\n-        <para>The name of the cache to expire all objects from.</para>\n+      <parameter name=\"file_format\" argsep=\":\">\n+        <argument name=\"file_format\" required=\"true\">\n+          <para>\n+            Optional.  If not set, defaults to\n+            <literal>wav</literal>\n+          </para>\n+        </argument>\n+        <argument name=\"urlbase\"/>\n+      </parameter>\n+      <parameter name=\"fname_base\">\n+        <para>If set, changes the filename used to the one specified.</para>\n+      </parameter>\n+      <parameter name=\"options\">\n+        <optionlist>\n+          <option name=\"m\">\n+            <para>\n+              When the recording ends mix the two leg files into one and\n+\t\t\t\t\t\tdelete the two leg files. If the variable\n+              <variable>MONITOR_EXEC</variable>\n+              is set, the application referenced in it will be executed instead of\n+\t\t\t\t\t\tsoxmix/sox and the raw leg files will NOT be deleted automatically.\n+\t\t\t\t\t\tsoxmix/sox or\n+              <variable>MONITOR_EXEC</variable>\n+              is handed 3 arguments,\n+\t\t\t\t\t\tthe two leg files and a target mixed file name which is the same as\n+\t\t\t\t\t\tthe leg file names only without the in/out designator.\n+            </para>\n+            <para>\n+              If\n+              <variable>MONITOR_EXEC_ARGS</variable>\n+              is set, the contents\n+\t\t\t\t\t\twill be passed on as additional arguments to\n+              <variable>MONITOR_EXEC</variable>\n+              .\n+\t\t\t\t\t\tBoth\n+              <variable>MONITOR_EXEC</variable>\n+              and the Mix flag can be set from the\n+\t\t\t\t\t\tadministrator interface.\n+            </para>\n+            <warning>\n+              <para>\n+                Do not use untrusted strings such as\n+                <variable>CALLERID(num)</variable>\n+                or\n+                <variable>CALLERID(name)</variable>\n+                as part of\n+                <variable>MONITOR_EXEC</variable>\n+                or\n+                <variable>MONITOR_EXEC_ARGS</variable>\n+                .  You risk a command injection\n+\t\t\t\t\t\tattack executing arbitrary commands if the untrusted strings aren't\n+\t\t\t\t\t\tfiltered to remove dangerous characters.  See function\n+                <variable>FILTER()</variable>\n+                .\n+              </para>\n+            </warning>\n+          </option>\n+          <option name=\"b\">\n+            <para>Don't begin recording unless a call is bridged to another channel.</para>\n+          </option>\n+          <option name=\"B\">\n+            <para>Play a periodic beep while this call is being recorded.</para>\n+            <argument name=\"interval\">\n+              <para>Interval, in seconds. Default is 15.</para>\n+            </argument>\n+          </option>\n+          <option name=\"i\">\n+            <para>\n+              Skip recording of input stream (disables\n+              <literal>m</literal>\n+              option).\n+            </para>\n+          </option>\n+          <option name=\"o\">\n+            <para>\n+              Skip recording of output stream (disables\n+              <literal>m</literal>\n+              option).\n+            </para>\n+          </option>\n+        </optionlist>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>Expires (removes) ALL objects from a sorcery memory cache.</para>\n+      <para>Used to start monitoring a channel. The channel's input and output\n+\t\t\tvoice packets are logged to files until the channel hangs up or\n+\t\t\tmonitoring is stopped by the StopMonitor application.</para>\n+      <para>\n+        By default, files are stored to\n+        <filename>/var/spool/asterisk/monitor/</filename>\n+        .\n+\t\t\tReturns\n+        <literal>-1</literal>\n+        if monitor files can't be opened or if the channel is\n+\t\t\talready monitored, otherwise\n+        <literal>0</literal>\n+        .\n+      </para>\n     </description>\n-  </manager>\n-  <manager name=\"SorceryMemoryCacheStaleObject\" language=\"en_US\">\n-    <synopsis>Mark an object in a sorcery memory cache as stale.</synopsis>\n+    <see-also>\n+      <ref type=\"application\">StopMonitor</ref>\n+    </see-also>\n+  </application>\n+  <application name=\"StopMonitor\" language=\"en_US\">\n+    <synopsis>Stop monitoring a channel.</synopsis>\n+    <syntax/>\n+    <description>\n+      <para>Stops monitoring a channel. Has no effect if the channel is not monitored.</para>\n+    </description>\n+  </application>\n+  <application name=\"ChangeMonitor\" language=\"en_US\">\n+    <synopsis>Change monitoring filename of a channel.</synopsis>\n+    <syntax>\n+      <parameter name=\"filename_base\" required=\"true\">\n+        <para>The new filename base to use for monitoring this channel.</para>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>Changes monitoring filename of a channel. Has no effect if the\n+\t\t\tchannel is not monitored.</para>\n+    </description>\n+  </application>\n+  <application name=\"PauseMonitor\" language=\"en_US\">\n+    <synopsis>Pause monitoring of a channel.</synopsis>\n+    <syntax/>\n+    <description>\n+      <para>Pauses monitoring of a channel until it is re-enabled by a call to UnpauseMonitor.</para>\n+    </description>\n+    <see-also>\n+      <ref type=\"application\">UnpauseMonitor</ref>\n+    </see-also>\n+  </application>\n+  <application name=\"UnpauseMonitor\" language=\"en_US\">\n+    <synopsis>Unpause monitoring of a channel.</synopsis>\n+    <syntax/>\n+    <description>\n+      <para>Unpauses monitoring of a channel on which monitoring had\n+\t\t\tpreviously been paused with PauseMonitor.</para>\n+    </description>\n+    <see-also>\n+      <ref type=\"application\">PauseMonitor</ref>\n+    </see-also>\n+  </application>\n+  <manager name=\"Monitor\" language=\"en_US\">\n+    <synopsis>Monitor a channel.</synopsis>\n     <syntax>\n       <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"Cache\" required=\"true\">\n-        <para>The name of the cache to mark the object as stale in.</para>\n+      <parameter name=\"Channel\" required=\"true\">\n+        <para>Used to specify the channel to record.</para>\n       </parameter>\n-      <parameter name=\"Object\" required=\"true\">\n-        <para>The name of the object to mark as stale.</para>\n+      <parameter name=\"File\">\n+        <para>Is the name of the file created in the monitor spool directory.\n+\t\t\t\tDefaults to the same name as the channel (with slashes replaced with dashes).</para>\n       </parameter>\n-      <parameter name=\"Reload\" required=\"false\">\n-        <para>If true, then immediately reload the object from the backend cache instead of waiting for the next retrieval</para>\n+      <parameter name=\"Format\">\n+        <para>\n+          Is the audio recording format. Defaults to\n+          <literal>wav</literal>\n+          .\n+        </para>\n+      </parameter>\n+      <parameter name=\"Mix\">\n+        <para>Boolean parameter as to whether to mix the input and output channels\n+\t\t\t\ttogether after the recording is finished.</para>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>Marks an object as stale within a sorcery memory cache.</para>\n+      <para>This action may be used to record the audio on a\n+\t\t\tspecified channel.</para>\n     </description>\n   </manager>\n-  <manager name=\"SorceryMemoryCacheStale\" language=\"en_US\">\n-    <synopsis>Marks ALL objects in a sorcery memory cache as stale.</synopsis>\n+  <manager name=\"StopMonitor\" language=\"en_US\">\n+    <synopsis>Stop monitoring a channel.</synopsis>\n     <syntax>\n       <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"Cache\" required=\"true\">\n-        <para>The name of the cache to mark all object as stale in.</para>\n+      <parameter name=\"Channel\" required=\"true\">\n+        <para>The name of the channel monitored.</para>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>Marks ALL objects in a sorcery memory cache as stale.</para>\n+      <para>This action may be used to end a previously started 'Monitor' action.</para>\n     </description>\n   </manager>\n-  <manager name=\"SorceryMemoryCachePopulate\" language=\"en_US\">\n-    <synopsis>Expire all objects from a memory cache and populate it with all objects from the backend.</synopsis>\n+  <manager name=\"ChangeMonitor\" language=\"en_US\">\n+    <synopsis>Change monitoring filename of a channel.</synopsis>\n     <syntax>\n       <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"Cache\" required=\"true\">\n-        <para>The name of the cache to populate.</para>\n+      <parameter name=\"Channel\" required=\"true\">\n+        <para>Used to specify the channel to record.</para>\n+      </parameter>\n+      <parameter name=\"File\" required=\"true\">\n+        <para>Is the new name of the file created in the\n+\t\t\t\tmonitor spool directory.</para>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>Expires all objects from a memory cache and populate it with all objects from the backend.</para>\n+      <para>This action may be used to change the file\n+\t\t\tstarted by a previous 'Monitor' action.</para>\n     </description>\n   </manager>\n-  <module language=\"en_US\" name=\"res_mwi_external\">\n-    <defaultenabled>no</defaultenabled>\n-    <support_level>core</support_level>\n-  </module>\n-  <configInfo name=\"res_mwi_external\" language=\"en_US\">\n-    <synopsis>Core external MWI support</synopsis>\n-    <configFile name=\"sorcery.conf\">\n-      <configObject name=\"mailboxes\">\n-        <synopsis>Persistent cache of external MWI Mailboxs.</synopsis>\n-        <description>\n-          <para>Allows the alteration of sorcery backend mapping for\n-\t\t\t\t\tthe persistent cache of external MWI mailboxes.</para>\n-        </description>\n-      </configObject>\n-    </configFile>\n-  </configInfo>\n-  <module language=\"en_US\" name=\"res_musiconhold\">\n-    <conflict>win32</conflict>\n-    <support_level>core</support_level>\n-  </module>\n-  <application name=\"MusicOnHold\" language=\"en_US\">\n-    <synopsis>Play Music On Hold indefinitely.</synopsis>\n+  <manager name=\"PauseMonitor\" language=\"en_US\">\n+    <synopsis>Pause monitoring of a channel.</synopsis>\n     <syntax>\n-      <parameter name=\"class\" required=\"true\"/>\n-      <parameter name=\"duration\"/>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      <parameter name=\"Channel\" required=\"true\">\n+        <para>Used to specify the channel to record.</para>\n+      </parameter>\n     </syntax>\n     <description>\n-      <para>\n-        Plays hold music specified by class. If omitted, the default music\n-\t\t\tsource for the channel will be used. Change the default class with\n-\t\t\tSet(CHANNEL(musicclass)=...). If duration is given, hold music will be played\n-\t\t\tspecified number of seconds. If duration is omitted, music plays indefinitely.\n-\t\t\tReturns\n-        <literal>0</literal>\n-        when done,\n-        <literal>-1</literal>\n-        on hangup.\n-      </para>\n-      <para>This application does not automatically answer and should be preceeded by\n-\t\t\tan application such as Answer() or Progress().</para>\n+      <para>This action may be used to temporarily stop the\n+\t\t\trecording of a channel.</para>\n     </description>\n-  </application>\n-  <application name=\"StartMusicOnHold\" language=\"en_US\">\n-    <synopsis>Play Music On Hold.</synopsis>\n+  </manager>\n+  <manager name=\"UnpauseMonitor\" language=\"en_US\">\n+    <synopsis>Unpause monitoring of a channel.</synopsis>\n     <syntax>\n-      <parameter name=\"class\" required=\"true\"/>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      <parameter name=\"Channel\" required=\"true\">\n+        <para>Used to specify the channel to record.</para>\n+      </parameter>\n     </syntax>\n     <description>\n-      <para>\n-        Starts playing music on hold, uses default music class for channel.\n-\t\t\tStarts playing music specified by class. If omitted, the default music\n-\t\t\tsource for the channel will be used. Always returns\n-        <literal>0</literal>\n-        .\n-      </para>\n-    </description>\n-  </application>\n-  <application name=\"StopMusicOnHold\" language=\"en_US\">\n-    <synopsis>Stop playing Music On Hold.</synopsis>\n-    <syntax/>\n-    <description>\n-      <para>Stops playing music on hold.</para>\n+      <para>This action may be used to re-enable recording\n+\t\t\tof a channel after calling PauseMonitor.</para>\n     </description>\n-  </application>\n-  <module language=\"en_US\" name=\"res_config_odbc\">\n-    <depend>res_odbc</depend>\n-    <depend>generic_odbc</depend>\n+  </manager>\n+  <module language=\"en_US\" name=\"res_clialiases\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"res_ari_endpoints\">\n+    <depend type=\"module\">res_ari</depend>\n+    <depend type=\"module\">res_ari_model</depend>\n+    <depend type=\"module\">res_stasis</depend>\n     <support_level>core</support_level>\n   </module>\n   <module language=\"en_US\" name=\"res_curl\">\n     <depend>curl</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"agent\">\n-    <support_level>extended</support_level>\n+  <module language=\"en_US\" name=\"res_pjsip_authenticator_digest\">\n+    <depend>pjproject</depend>\n+    <depend>res_pjsip</depend>\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"res_manager_devicestate\">\n+    <support_level>core</support_level>\n   </module>\n+  <manager name=\"DeviceStateList\" language=\"en_US\">\n+    <synopsis>List the current known device states.</synopsis>\n+    <syntax>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+    </syntax>\n+    <description>\n+      <para>\n+        This will list out all known device states in a\n+\t\t\tsequence of\n+        <replaceable>DeviceStateChange</replaceable>\n+        events.\n+\t\t\tWhen finished, a\n+        <replaceable>DeviceStateListComplete</replaceable>\n+        event\n+\t\t\twill be emitted.\n+      </para>\n+    </description>\n+    <see-also>\n+      <ref type=\"managerEvent\">DeviceStateChange</ref>\n+      <ref type=\"function\">DEVICE_STATE</ref>\n+    </see-also>\n+    <responses>\n+      <list-elements>\n+        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='DeviceStateChange'])\"/>\n+      </list-elements>\n+      <managerEvent name=\"DeviceStateListComplete\" language=\"en_US\">\n+        <managerEventInstance class=\"EVENT_FLAG_COMMAND\">\n+          <synopsis>Indicates the end of the list the current known extension states.</synopsis>\n+          <syntax>\n+            <parameter name=\"EventList\">\n+              <para>Conveys the status of the event list.</para>\n+            </parameter>\n+            <parameter name=\"ListItems\">\n+              <para>Conveys the number of statuses reported.</para>\n+            </parameter>\n+          </syntax>\n+        </managerEventInstance>\n+      </managerEvent>\n+    </responses>\n+  </manager>\n   <module language=\"en_US\" name=\"res_ari_events\">\n     <depend type=\"module\">res_ari</depend>\n     <depend type=\"module\">res_ari_model</depend>\n     <depend type=\"module\">res_stasis</depend>\n     <depend type=\"module\">res_http_websocket</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"res_pjsip_t38\">\n-    <depend>pjproject</depend>\n-    <depend>res_pjsip</depend>\n-    <depend>res_pjsip_session</depend>\n+  <module language=\"en_US\" name=\"res_fax_spandsp\">\n+    <depend>spandsp</depend>\n+    <depend>res_fax</depend>\n+    <support_level>extended</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"res_config_pgsql\">\n+    <depend>pgsql</depend>\n+    <support_level>extended</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"res_calendar_ews\">\n+    <depend>res_calendar</depend>\n+    <depend>neon29</depend>\n+    <support_level>extended</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"res_http_media_cache\">\n+    <depend>curl</depend>\n+    <depend>res_curl</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"res_statsd\">\n+  <module language=\"en_US\" name=\"res_tonedetect\">\n     <support_level>extended</support_level>\n   </module>\n-  <configInfo name=\"res_statsd\" language=\"en_US\">\n-    <synopsis>StatsD client</synopsis>\n+  <application name=\"WaitForTone\" language=\"en_US\">\n+    <since>\n+      <version>16.21.0</version>\n+      <version>18.7.0</version>\n+      <version>19.0.0</version>\n+    </since>\n+    <synopsis>Wait for tone</synopsis>\n+    <syntax>\n+      <parameter name=\"freq\" required=\"true\">\n+        <para>Frequency of the tone to wait for.</para>\n+      </parameter>\n+      <parameter name=\"duration_ms\" required=\"false\">\n+        <para>Minimum duration of tone, in ms. Default is 500ms.\n+\t\t\t\tUsing a minimum duration under 50ms is unlikely to produce\n+\t\t\t\taccurate results.</para>\n+      </parameter>\n+      <parameter name=\"timeout\" required=\"false\">\n+        <para>Maximum amount of time, in seconds, to wait for specified tone.\n+\t\t\t\tDefault is forever.</para>\n+      </parameter>\n+      <parameter name=\"times\" required=\"false\">\n+        <para>Number of times the tone should be detected (subject to the\n+\t\t\t\tprovided timeout) before returning. Default is 1.</para>\n+      </parameter>\n+      <parameter name=\"options\" required=\"false\">\n+        <optionlist>\n+          <option name=\"d\">\n+            <para>Custom decibel threshold to use. Default is 16.</para>\n+          </option>\n+          <option name=\"s\">\n+            <para>Squelch tone.</para>\n+          </option>\n+        </optionlist>\n+      </parameter>\n+    </syntax>\n     <description>\n+      <para>Waits for a single-frequency tone to be detected before dialplan execution continues.</para>\n+      <variablelist>\n+        <variable name=\"WAITFORTONESTATUS\">\n+          <para>This indicates the result of the wait.</para>\n+          <value name=\"SUCCESS\"/>\n+          <value name=\"ERROR\"/>\n+          <value name=\"TIMEOUT\"/>\n+          <value name=\"HANGUP\"/>\n+        </variable>\n+      </variablelist>\n+    </description>\n+    <see-also>\n+      <ref type=\"application\">PlayTones</ref>\n+    </see-also>\n+  </application>\n+  <application name=\"ToneScan\" language=\"en_US\">\n+    <since>\n+      <version>16.23.0</version>\n+      <version>18.9.0</version>\n+      <version>19.1.0</version>\n+    </since>\n+    <synopsis>Wait for period of time while scanning for call progress tones</synopsis>\n+    <syntax>\n+      <parameter name=\"zone\" required=\"false\">\n+        <para>Call progress zone. Default is the system default.</para>\n+      </parameter>\n+      <parameter name=\"timeout\" required=\"false\">\n+        <para>Maximum amount of time, in seconds, to wait for call progress\n+\t\t\t\tor signal tones. Default is forever.</para>\n+      </parameter>\n+      <parameter name=\"threshold\" required=\"false\">\n+        <para>DSP threshold required for a match. A higher number will\n+\t\t\t\trequire a longer match and may reduce false positives, at the\n+\t\t\t\texpense of false negatives. Default is 1.</para>\n+      </parameter>\n+      <parameter name=\"options\" required=\"false\">\n+        <optionlist>\n+          <option name=\"f\">\n+            <para>Enable fax machine detection. By default, this is disabled.</para>\n+          </option>\n+          <option name=\"v\">\n+            <para>Enable voice detection. By default, this is disabled.</para>\n+          </option>\n+        </optionlist>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>Waits for a a distinguishable call progress tone and then exits.\n+\t\t\tUnlike a conventional scanner, this is not currently capable of\n+\t\t\tscanning for modem carriers.</para>\n+      <variablelist>\n+        <variable name=\"TONESCANSTATUS\">\n+          This indicates the result of the scan.\n+          <value name=\"RINGING\">Audible ringback tone</value>\n+          <value name=\"BUSY\">Busy tone</value>\n+          <value name=\"SIT\">Special Information Tones</value>\n+          <value name=\"VOICE\">Human voice detected</value>\n+          <value name=\"DTMF\">DTMF digit</value>\n+          <value name=\"FAX\">Fax (answering)</value>\n+          <value name=\"MODEM\">Modem (answering)</value>\n+          <value name=\"DIALTONE\">Dial tone</value>\n+          <value name=\"NUT\">UK Number Unobtainable tone</value>\n+          <value name=\"TIMEOUT\">Timeout reached before any positive detection</value>\n+          <value name=\"HANGUP\">Caller hung up before any positive detection</value>\n+        </variable>\n+      </variablelist>\n+    </description>\n+    <see-also>\n+      <ref type=\"application\">WaitForTone</ref>\n+    </see-also>\n+  </application>\n+  <function name=\"TONE_DETECT\" language=\"en_US\">\n+    <since>\n+      <version>16.21.0</version>\n+      <version>18.7.0</version>\n+      <version>19.0.0</version>\n+    </since>\n+    <synopsis>Asynchronously detects a tone</synopsis>\n+    <syntax>\n+      <parameter name=\"freq\" required=\"true\">\n+        <para>Frequency of the tone to detect. To disable frequency\n+\t\t\t\tdetection completely (e.g. for signal detection only),\n+\t\t\t\tspecify 0 for the frequency.</para>\n+      </parameter>\n+      <parameter name=\"duration_ms\" required=\"false\">\n+        <para>Minimum duration of tone, in ms. Default is 500ms.\n+\t\t\t\tUsing a minimum duration under 50ms is unlikely to produce\n+\t\t\t\taccurate results.</para>\n+      </parameter>\n+      <parameter name=\"options\">\n+        <optionlist>\n+          <option name=\"a\">\n+            <para>Match immediately on Special Information Tones, instead of or in addition\n+\t\t\t\t\t\tto a particular frequency.</para>\n+          </option>\n+          <option name=\"b\">\n+            <para>Match immediately on a busy signal, instead of or in addition to\n+\t\t\t\t\t\ta particular frequency.</para>\n+          </option>\n+          <option name=\"c\">\n+            <para>Match immediately on a dial tone, instead of or in addition to\n+\t\t\t\t\t\ta particular frequency.</para>\n+          </option>\n+          <option name=\"d\">\n+            <para>Custom decibel threshold to use. Default is 16.</para>\n+          </option>\n+          <option name=\"g\">\n+            <para>Go to the specified context,exten,priority if tone is received on this channel.\n+\t\t\t\t\t\tDetection will not end automatically.</para>\n+          </option>\n+          <option name=\"h\">\n+            <para>Go to the specified context,exten,priority if tone is transmitted on this channel.\n+\t\t\t\t\t\tDetection will not end automatically.</para>\n+          </option>\n+          <option name=\"n\">\n+            <para>\n+              Number of times the tone should be detected (subject to the\n+\t\t\t\t\t\tprovided timeout) before going to the destination provided in the\n+              <literal>g</literal>\n+              or\n+              <literal>h</literal>\n+              option. Default is 1.\n+            </para>\n+          </option>\n+          <option name=\"r\">\n+            <para>Apply to received frames only. Default is both directions.</para>\n+          </option>\n+          <option name=\"s\">\n+            <para>Squelch tone.</para>\n+          </option>\n+          <option name=\"t\">\n+            <para>Apply to transmitted frames only. Default is both directions.</para>\n+          </option>\n+          <option name=\"x\">\n+            <para>Destroy the detector (stop detection).</para>\n+          </option>\n+        </optionlist>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>The TONE_DETECT function detects a single-frequency tone and keeps\n+\t\t\ttrack of how many times the tone has been detected.</para>\n       <para>\n-        The\n-        <literal>res_statsd</literal>\n-        module provides an API that\n-\t\t\tallows Asterisk and its modules to send statistics to a StatsD\n-\t\t\tserver. It only provides a means to communicate with a StatsD server\n-\t\t\tand does not send any metrics of its own.\n-      </para>\n-      <para>\n-        An example module,\n-        <literal>res_chan_stats</literal>\n-        , is\n-\t\t\tprovided which uses the API exposed by this module to send channel\n-\t\t\tstatistics to the configured StatsD server.\n+        When reading this function (instead of writing), supply\n+        <literal>tx</literal>\n+        to get the number of times a tone has been detected in the TX direction and\n+        <literal>rx</literal>\n+        to get the number of times a tone has been detected in the\n+\t\t\tRX direction.\n       </para>\n-      <para>More information about StatsD can be found at\n-\t\t\thttps://github.com/statsd/statsd</para>\n+      <example title=\"intercept2600\">same =&gt; n,Set(TONE_DETECT(2600,1000,g(got-2600,s,1))=) ; detect 2600 Hz\n+\t\t\tsame =&gt; n,Wait(15)\n+\t\t\tsame =&gt; n,NoOp(${TONE_DETECT(rx)})</example>\n+      <example title=\"dropondialtone\">same =&gt; n,Set(TONE_DETECT(0,,bg(my-hangup,s,1))=) ; disconnect a call if we hear a busy signal\n+\t\t\tsame =&gt; n,Goto(somewhere-else)\n+\t\t\tsame =&gt; n(myhangup),Hangup()</example>\n+      <example title=\"removedetector\">same =&gt; n,Set(TONE_DETECT(0,,x)=) ; remove the detector from the channel</example>\n     </description>\n-    <configFile name=\"statsd.conf\">\n-      <configObject name=\"global\">\n-        <synopsis>Global configuration settings</synopsis>\n-        <configOption name=\"enabled\">\n-          <synopsis>Enable/disable the StatsD module</synopsis>\n-        </configOption>\n-        <configOption name=\"server\">\n-          <synopsis>Address of the StatsD server</synopsis>\n-        </configOption>\n-        <configOption name=\"prefix\">\n-          <synopsis>Prefix to prepend to every metric</synopsis>\n-        </configOption>\n-        <configOption name=\"add_newline\">\n-          <synopsis>Append a newline to every event. This is useful if\n-\t\t\t\t\tyou want to fake out a server using netcat\n-\t\t\t\t\t(nc -lu 8125)</synopsis>\n-        </configOption>\n-        <configOption name=\"meter_support\">\n-          <synopsis>Enable/disable the non-standard StatsD Meter type,\n-\t\t\t\t\tif disabled falls back to counter and will append a &quot;_meter&quot; suffix to the metric name</synopsis>\n-        </configOption>\n-      </configObject>\n-    </configFile>\n-  </configInfo>\n-  <module language=\"en_US\" name=\"res_pjsip_outbound_publish\">\n+  </function>\n+  <module language=\"en_US\" name=\"res_pjsip_acl\">\n     <depend>pjproject</depend>\n-    <depend>res_pjproject</depend>\n     <depend>res_pjsip</depend>\n     <support_level>core</support_level>\n   </module>\n-  <configInfo name=\"res_pjsip_outbound_publish\" language=\"en_US\">\n-    <synopsis>SIP resource for outbound publish</synopsis>\n+  <configInfo name=\"res_pjsip_acl\" language=\"en_US\">\n+    <synopsis>SIP ACL module</synopsis>\n     <description>\n       <para>\n-        <emphasis>Outbound Publish</emphasis>\n+        <emphasis>ACL</emphasis>\n       </para>\n       <para>\n-        This module allows\n+        The ACL module used by\n         <literal>res_pjsip</literal>\n-        to publish to other SIP servers.\n+        . This module is\n+\t\t\tindependent of\n+        <literal>endpoints</literal>\n+        and operates on all inbound\n+\t\t\tSIP communication using res_pjsip.\n+      </para>\n+      <para>\n+        There are two main ways of defining your ACL with the options\n+\t\t\tprovided. You can use the\n+        <literal>permit</literal>\n+        and\n+        <literal>deny</literal>\n+        options\n+\t\t\twhich act on\n+        <emphasis>IP</emphasis>\n+        addresses, or the\n+        <literal>contactpermit</literal>\n+        and\n+        <literal>contactdeny</literal>\n+        options which act on\n+        <emphasis>Contact header</emphasis>\n+        addresses in incoming REGISTER requests. You can combine the various options to\n+\t\t\tcreate a mixed ACL.\n+      </para>\n+      <para>\n+        Additionally, instead of defining an ACL with options, you can reference IP or\n+\t\t\tContact header ACLs from the file\n+        <filename>acl.conf</filename>\n+        by using the\n+        <literal>acl</literal>\n+        or\n+        <literal>contactacl</literal>\n+        options.\n       </para>\n     </description>\n     <configFile name=\"pjsip.conf\">\n-      <configObject name=\"outbound-publish\">\n-        <synopsis>The configuration for outbound publish</synopsis>\n-        <description>\n-          <para>\n-            Publish is\n-            <emphasis>COMPLETELY</emphasis>\n-            separate from the rest of\n-            <literal>pjsip.conf</literal>\n-            . A minimal configuration consists of\n-\t\t\t\t\tsetting a\n-            <literal>server_uri</literal>\n-            and\n-            <literal>event</literal>\n-            .\n-          </para>\n-        </description>\n-        <configOption name=\"expiration\" default=\"3600\">\n-          <synopsis>Expiration time for publications in seconds</synopsis>\n-        </configOption>\n-        <configOption name=\"outbound_auth\" default=\"\">\n-          <synopsis>Authentication object(s) to be used for outbound publishes.</synopsis>\n+      <configObject name=\"acl\">\n+        <synopsis>Access Control List</synopsis>\n+        <configOption name=\"acl\">\n+          <synopsis>List of IP ACL section names in acl.conf</synopsis>\n           <description>\n             <para>\n-              This is a comma-delimited list of\n-              <replaceable>auth</replaceable>\n-              sections defined in\n-              <filename>pjsip.conf</filename>\n-              used to respond\n-\t\t\t\t\t\tto outbound authentication challenges.\n+              This matches sections configured in\n+              <literal>acl.conf</literal>\n+              . The value is\n+\t\t\t\t\t\tdefined as a list of comma-delimited section names.\n             </para>\n-            <note>\n-              <para>Using the same auth section for inbound and outbound\n-\t\t\t\t\t\tauthentication is not recommended.  There is a difference in\n-\t\t\t\t\t\tmeaning for an empty realm setting between inbound and outbound\n-\t\t\t\t\t\tauthentication uses.  See the auth realm description for details.</para>\n-            </note>\n-          </description>\n-        </configOption>\n-        <configOption name=\"outbound_proxy\" default=\"\">\n-          <synopsis>Full SIP URI of the outbound proxy used to send publishes</synopsis>\n-        </configOption>\n-        <configOption name=\"server_uri\">\n-          <synopsis>SIP URI of the server and entity to publish to</synopsis>\n-          <description>\n-            <para>This is the URI at which to find the entity and server to send the outbound PUBLISH to.\n-\t\t\t\t\t\tThis URI is used as the request URI of the outbound PUBLISH request from Asterisk.</para>\n           </description>\n         </configOption>\n-        <configOption name=\"from_uri\">\n-          <synopsis>SIP URI to use in the From header</synopsis>\n+        <configOption name=\"contact_acl\">\n+          <synopsis>List of Contact ACL section names in acl.conf</synopsis>\n           <description>\n             <para>\n-              This is the URI that will be placed into the From header of outgoing PUBLISH\n-\t\t\t\t\t\tmessages. If no URI is specified then the URI provided in\n-              <literal>server_uri</literal>\n-              will be used.\n+              This matches sections configured in\n+              <literal>acl.conf</literal>\n+              . The value is\n+\t\t\t\t\t\tdefined as a list of comma-delimited section names.\n             </para>\n           </description>\n         </configOption>\n-        <configOption name=\"to_uri\">\n-          <synopsis>SIP URI to use in the To header</synopsis>\n+        <configOption name=\"contact_deny\">\n+          <synopsis>List of Contact header addresses to deny</synopsis>\n           <description>\n-            <para>\n-              This is the URI that will be placed into the To header of outgoing PUBLISH\n-\t\t\t\t\t\tmessages. If no URI is specified then the URI provided in\n-              <literal>server_uri</literal>\n-              will be used.\n-            </para>\n+            <para>The value is a comma-delimited list of IP addresses. IP addresses may\n+\t\t\t\t\t\thave a subnet mask appended. The subnet mask may be written in either\n+\t\t\t\t\t\tCIDR or dotted-decimal notation. Separate the IP address and subnet\n+\t\t\t\t\t\tmask with a slash ('/')</para>\n           </description>\n         </configOption>\n-        <configOption name=\"event\" default=\"\">\n-          <synopsis>Event type of the PUBLISH.</synopsis>\n-        </configOption>\n-        <configOption name=\"max_auth_attempts\" default=\"5\">\n-          <synopsis>Maximum number of authentication attempts before stopping the publication.</synopsis>\n-        </configOption>\n-        <configOption name=\"transport\">\n-          <synopsis>Transport used for outbound publish</synopsis>\n+        <configOption name=\"contact_permit\">\n+          <synopsis>List of Contact header addresses to permit</synopsis>\n           <description>\n-            <note>\n-              <para>\n-                A\n-                <replaceable>transport</replaceable>\n-                configured in\n-                <literal>pjsip.conf</literal>\n-                . As with other\n-                <literal>res_pjsip</literal>\n-                modules, this will use the first available transport of the appropriate type if unconfigured.\n-              </para>\n-            </note>\n+            <para>The value is a comma-delimited list of IP addresses. IP addresses may\n+\t\t\t\t\t\thave a subnet mask appended. The subnet mask may be written in either\n+\t\t\t\t\t\tCIDR or dotted-decimal notation. Separate the IP address and subnet\n+\t\t\t\t\t\tmask with a slash ('/')</para>\n           </description>\n         </configOption>\n-        <configOption name=\"multi_user\" default=\"no\">\n-          <synopsis>Enable multi-user support</synopsis>\n+        <configOption name=\"deny\">\n+          <synopsis>List of IP addresses to deny access from</synopsis>\n           <description>\n-            <para>When enabled the user portion of the server uri is replaced by a dynamically created user</para>\n+            <para>The value is a comma-delimited list of IP addresses. IP addresses may\n+\t\t\t\t\t\thave a subnet mask appended. The subnet mask may be written in either\n+\t\t\t\t\t\tCIDR or dotted-decimal notation. Separate the IP address and subnet\n+\t\t\t\t\t\tmask with a slash ('/')</para>\n           </description>\n         </configOption>\n-        <configOption name=\"type\">\n-          <synopsis>Must be of type 'outbound-publish'.</synopsis>\n+        <configOption name=\"permit\">\n+          <synopsis>List of IP addresses to permit access from</synopsis>\n+          <description>\n+            <para>The value is a comma-delimited list of IP addresses. IP addresses may\n+\t\t\t\t\t\thave a subnet mask appended. The subnet mask may be written in either\n+\t\t\t\t\t\tCIDR or dotted-decimal notation. Separate the IP address and subnet\n+\t\t\t\t\t\tmask with a slash ('/')</para>\n+          </description>\n         </configOption>\n-      </configObject>\n-    </configFile>\n-  </configInfo>\n-  <module language=\"en_US\" name=\"res_pjsip_phoneprov_provider\">\n-    <depend>pjproject</depend>\n-    <depend>res_pjsip</depend>\n-    <depend>res_phoneprov</depend>\n-    <support_level>extended</support_level>\n-  </module>\n-  <configInfo name=\"res_pjsip_phoneprov_provider\" language=\"en_US\">\n-    <synopsis>Module that integrates res_pjsip with res_phoneprov.</synopsis>\n-    <description>\n-      <para>\n-        <emphasis>PJSIP Phoneprov Provider</emphasis>\n-      </para>\n-      <para>\n-        This module creates the integration between\n-        <literal>res_pjsip</literal>\n-        and\n-        <literal>res_phoneprov</literal>\n-        .\n-      </para>\n-      <para>\n-        Each user to be integrated requires a\n-        <literal>phoneprov</literal>\n-        section defined in\n-        <filename>pjsip.conf</filename>\n-        .  Each section identifies\n-\t\t\tthe endpoint associated with the user and any other name/value pairs to be passed\n-\t\t\ton to res_phoneprov's template substitution.  Only\n-        <literal>MAC</literal>\n-        and\n-        <literal>PROFILE</literal>\n-        variables are required.  Any other variables\n-\t\t\tsupplied will be passed through.\n-      </para>\n-      <para/>\n-      <para>Example:</para>\n-      <para>[1000]</para>\n-      <para>type = phoneprovr</para>\n-      <para>endpoint = ep1000</para>\n-      <para>MAC = deadbeef4dad</para>\n-      <para>PROFILE = grandstream2</para>\n-      <para>LINEKEYS = 2</para>\n-      <para>LINE = 1</para>\n-      <para>OTHERVAR = othervalue</para>\n-      <para/>\n-      <para>The following variables are automatically defined if an endpoint\n-\t\t\tis defined for the user:</para>\n-      <enumlist>\n-        <enum name=\"USERNAME\">\n-          <para>Source: The user_name defined in the first auth reference\n-\t\t\t\tin the endpoint.</para>\n-        </enum>\n-        <enum name=\"SECRET\">\n-          <para>Source: The user_pass defined in the first auth reference\n-\t\t\t\tin the endpoint.</para>\n-        </enum>\n-        <enum name=\"CALLERID\">\n-          <para>Source: The number part of the callerid defined in\n-\t\t\t\tthe endpoint.</para>\n-        </enum>\n-        <enum name=\"DISPLAY_NAME\">\n-          <para>Source: The name part of the callerid defined in\n-\t\t\t\tthe endpoint.</para>\n-        </enum>\n-        <enum name=\"LABEL\">\n-          <para>Source: The id of the phoneprov section.</para>\n-        </enum>\n-      </enumlist>\n-      <para/>\n-      <para>In addition to the standard variables, the following are also automatically defined:</para>\n-      <enumlist>\n-        <enum name=\"ENDPOINT_ID\">\n-          <para>Source: The id of the endpoint.</para>\n-        </enum>\n-        <enum name=\"TRANSPORT_ID\">\n-          <para>Source: The id of the transport used by the endpoint.</para>\n-        </enum>\n-        <enum name=\"AUTH_ID\">\n-          <para>Source: The id of the auth used by the endpoint.</para>\n-        </enum>\n-      </enumlist>\n-      <para/>\n-      <para>All other template substitution variables must be explicitly defined in the\n-\t\t\tphoneprov_default or phoneprov sections.</para>\n-    </description>\n-    <configFile name=\"pjsip.conf\">\n-      <configObject name=\"phoneprov\">\n-        <synopsis>Provides variables for each user.</synopsis>\n         <configOption name=\"type\">\n-          <synopsis>Must be of type 'phoneprov'.</synopsis>\n-        </configOption>\n-        <configOption name=\"endpoint\">\n-          <synopsis>The endpoint from which variables will be retrieved.</synopsis>\n-        </configOption>\n-        <configOption name=\"MAC\">\n-          <synopsis>The mac address for this user. (required)</synopsis>\n-        </configOption>\n-        <configOption name=\"PROFILE\">\n-          <synopsis>The phoneprov profile to use for this user. (required)</synopsis>\n-        </configOption>\n-        <configOption name=\"*\">\n-          <synopsis>Other name/value pairs to be passed through for use in templates.</synopsis>\n+          <synopsis>Must be of type 'acl'.</synopsis>\n         </configOption>\n       </configObject>\n     </configFile>\n   </configInfo>\n-  <module language=\"en_US\" name=\"res_adsi\">\n-    <support_level>deprecated</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"res_ari_device_states\">\n-    <depend type=\"module\">res_ari</depend>\n-    <depend type=\"module\">res_ari_model</depend>\n-    <depend type=\"module\">res_stasis</depend>\n-    <depend type=\"module\">res_stasis_device_state</depend>\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"res_config_sqlite3\">\n-    <depend>sqlite3</depend>\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"res_calendar_icalendar\">\n-    <depend>res_calendar</depend>\n-    <depend>neon</depend>\n-    <depend>ical</depend>\n+  <module language=\"en_US\" name=\"res_endpoint_stats\">\n+    <depend>res_statsd</depend>\n+    <defaultenabled>no</defaultenabled>\n     <support_level>extended</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"res_convert\">\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"res_calendar_ews\">\n-    <depend>res_calendar</depend>\n-    <depend>neon29</depend>\n+  <module language=\"en_US\" name=\"res_chan_stats\">\n+    <depend>res_statsd</depend>\n+    <defaultenabled>no</defaultenabled>\n     <support_level>extended</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"res_limit\">\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"res_sorcery_memory\">\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"res_http_websocket\">\n-    <support_level>core</support_level>\n-  </module>\n   <module language=\"en_US\" name=\"res_pjsip_config_wizard\">\n     <depend>pjproject</depend>\n     <depend>res_pjsip</depend>\n     <support_level>core</support_level>\n   </module>\n   <configInfo name=\"res_pjsip_config_wizard\" language=\"en_US\">\n     <synopsis>Module that provides simple configuration wizard capabilities.</synopsis>\n@@ -30962,254 +31106,462 @@\n           <description>\n             <para>To activate phoneprov, at least phoneprov/MAC must be set.</para>\n           </description>\n         </configOption>\n       </configObject>\n     </configFile>\n   </configInfo>\n-  <module language=\"en_US\" name=\"res_format_attr_silk\">\n+  <module language=\"en_US\" name=\"res_pjsip_nat\">\n+    <depend>pjproject</depend>\n+    <depend>res_pjsip</depend>\n+    <depend>res_pjsip_session</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"res_format_attr_h264\">\n+  <module language=\"en_US\" name=\"res_pjsip_sdp_rtp\">\n+    <depend>pjproject</depend>\n+    <depend>res_pjsip</depend>\n+    <depend>res_pjsip_session</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"res_phoneprov\">\n-    <support_level>extended</support_level>\n+  <module language=\"en_US\" name=\"res_convert\">\n+    <support_level>core</support_level>\n   </module>\n-  <function name=\"PP_EACH_EXTENSION\" language=\"en_US\">\n-    <synopsis>Execute specified template for each extension.</synopsis>\n+  <module language=\"en_US\" name=\"res_stasis_test\">\n+    <depend>TEST_FRAMEWORK</depend>\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"res_musiconhold\">\n+    <conflict>win32</conflict>\n+    <support_level>core</support_level>\n+  </module>\n+  <application name=\"MusicOnHold\" language=\"en_US\">\n+    <synopsis>Play Music On Hold indefinitely.</synopsis>\n     <syntax>\n-      <parameter name=\"mac\" required=\"true\"/>\n-      <parameter name=\"template_file\" required=\"true\"/>\n+      <parameter name=\"class\" required=\"true\"/>\n+      <parameter name=\"duration\"/>\n     </syntax>\n     <description>\n-      <para>Output the specified template for each extension associated with the specified MAC address.</para>\n+      <para>\n+        Plays hold music specified by class. If omitted, the default music\n+\t\t\tsource for the channel will be used. Change the default class with\n+\t\t\tSet(CHANNEL(musicclass)=...). If duration is given, hold music will be played\n+\t\t\tspecified number of seconds. If duration is omitted, music plays indefinitely.\n+\t\t\tReturns\n+        <literal>0</literal>\n+        when done,\n+        <literal>-1</literal>\n+        on hangup.\n+      </para>\n+      <para>This application does not automatically answer and should be preceeded by\n+\t\t\tan application such as Answer() or Progress().</para>\n     </description>\n-  </function>\n-  <function name=\"PP_EACH_USER\" language=\"en_US\">\n-    <synopsis>Generate a string for each phoneprov user.</synopsis>\n+  </application>\n+  <application name=\"StartMusicOnHold\" language=\"en_US\">\n+    <synopsis>Play Music On Hold.</synopsis>\n     <syntax>\n-      <parameter name=\"string\" required=\"true\"/>\n-      <parameter name=\"exclude_mac\" required=\"true\"/>\n+      <parameter name=\"class\" required=\"true\"/>\n     </syntax>\n     <description>\n       <para>\n-        Pass in a string, with phoneprov variables you want substituted in the format of\n-\t\t\t%{VARNAME}, and you will get the string rendered for each user in phoneprov\n-\t\t\texcluding ones with MAC address\n-        <replaceable>exclude_mac</replaceable>\n-        . Probably not\n-\t\t\tuseful outside of res_phoneprov.\n+        Starts playing music on hold, uses default music class for channel.\n+\t\t\tStarts playing music specified by class. If omitted, the default music\n+\t\t\tsource for the channel will be used. Always returns\n+        <literal>0</literal>\n+        .\n       </para>\n-      <para>Example: ${PP_EACH_USER(&lt;item&gt;&lt;fn&gt;%{DISPLAY_NAME}&lt;/fn&gt;&lt;/item&gt;|${MAC})</para>\n     </description>\n-  </function>\n-  <module language=\"en_US\" name=\"res_pjsip_acl\">\n+  </application>\n+  <application name=\"StopMusicOnHold\" language=\"en_US\">\n+    <synopsis>Stop playing Music On Hold.</synopsis>\n+    <syntax/>\n+    <description>\n+      <para>Stops playing music on hold.</para>\n+    </description>\n+  </application>\n+  <module language=\"en_US\" name=\"res_pjsip_notify\">\n     <depend>pjproject</depend>\n     <depend>res_pjsip</depend>\n     <support_level>core</support_level>\n   </module>\n-  <configInfo name=\"res_pjsip_acl\" language=\"en_US\">\n-    <synopsis>SIP ACL module</synopsis>\n+  <manager name=\"PJSIPNotify\" language=\"en_US\">\n+    <synopsis>Send a NOTIFY to either an endpoint, an arbitrary URI, or inside a SIP dialog.</synopsis>\n+    <syntax>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      <parameter name=\"Endpoint\" required=\"false\">\n+        <para>The endpoint to which to send the NOTIFY.</para>\n+      </parameter>\n+      <parameter name=\"URI\" required=\"false\">\n+        <para>Abritrary URI to which to send the NOTIFY.</para>\n+      </parameter>\n+      <parameter name=\"channel\" required=\"false\">\n+        <para>Channel name to send the NOTIFY. Must be a PJSIP channel.</para>\n+      </parameter>\n+      <parameter name=\"Variable\" required=\"true\">\n+        <para>\n+          Appends variables as headers/content to the NOTIFY. If the variable is\n+\t\t\t\tnamed\n+          <literal>Content</literal>\n+          , then the value will compose the body\n+\t\t\t\tof the message if another variable sets\n+          <literal>Content-Type</literal>\n+          .\n+          <replaceable>name</replaceable>\n+          =\n+          <replaceable>value</replaceable>\n+        </para>\n+      </parameter>\n+    </syntax>\n     <description>\n+      <para>Sends a NOTIFY to an endpoint, an arbitrary URI, or inside a SIP dialog.</para>\n       <para>\n-        <emphasis>ACL</emphasis>\n-      </para>\n-      <para>\n-        The ACL module used by\n-        <literal>res_pjsip</literal>\n-        . This module is\n-\t\t\tindependent of\n-        <literal>endpoints</literal>\n-        and operates on all inbound\n-\t\t\tSIP communication using res_pjsip.\n+        All parameters for this event must be specified in the body of this\n+\t\t\trequest\tvia multiple\n+        <literal>Variable: name=value</literal>\n+        sequences.\n       </para>\n+      <note>\n+        <para>\n+          One (and only one) of\n+          <literal>Endpoint</literal>\n+          ,\n+          <literal>URI</literal>\n+          , or\n+          <literal>Channel</literal>\n+          must be specified.\n+\t\t\tIf\n+          <literal>URI</literal>\n+          is used, the default outbound endpoint will be used\n+\t\t\tto send the message. If the default outbound endpoint isn't configured, this command\n+\t\t\tcan not send to an arbitrary URI.\n+        </para>\n+      </note>\n+    </description>\n+  </manager>\n+  <configInfo name=\"res_pjsip_notify\" language=\"en_US\">\n+    <synopsis>Module that supports sending NOTIFY requests to endpoints from external sources</synopsis>\n+    <configFile name=\"pjsip_notify.conf\">\n+      <configObject name=\"general\">\n+        <synopsis>Unused, but reserved.</synopsis>\n+      </configObject>\n+      <configObject name=\"notify\">\n+        <synopsis>Configuration of a NOTIFY request.</synopsis>\n+        <description>\n+          <para>\n+            Each key-value pair in a\n+            <literal>notify</literal>\n+            configuration section defines either a SIP header to send\n+\t\t\t\t\tin the request or a line of content in the request message\n+\t\t\t\t\tbody. A key of\n+            <literal>Content</literal>\n+            is treated\n+\t\t\t\t\tas part of the message body and is appended in sequential\n+\t\t\t\t\torder; any other header is treated as part of the SIP\n+\t\t\t\t\trequest.\n+          </para>\n+        </description>\n+        <configOption name=\"\">\n+          <synopsis>A key/value pair to add to a NOTIFY request.</synopsis>\n+          <description>\n+            <para>\n+              If the key is\n+              <literal>Content</literal>\n+              ,\n+\t\t\t\t\t\tit will be treated as part of the message body. Otherwise,\n+\t\t\t\t\t\tit will be added as a header in the NOTIFY request.\n+            </para>\n+            <para>The following headers are reserved and cannot be\n+\t\t\t\t\t\tspecified:</para>\n+            <enumlist>\n+              <enum name=\"Call-ID\"/>\n+              <enum name=\"Contact\"/>\n+              <enum name=\"CSeq\"/>\n+              <enum name=\"To\"/>\n+              <enum name=\"From\"/>\n+              <enum name=\"Record-Route\"/>\n+              <enum name=\"Route\"/>\n+              <enum name=\"Via\"/>\n+            </enumlist>\n+          </description>\n+        </configOption>\n+      </configObject>\n+    </configFile>\n+  </configInfo>\n+  <module language=\"en_US\" name=\"res_realtime\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"res_timing_timerfd\">\n+    <depend>timerfd</depend>\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"res_ael_share\">\n+    <support_level>extended</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"res_ari_playbacks\">\n+    <depend type=\"module\">res_ari</depend>\n+    <depend type=\"module\">res_ari_model</depend>\n+    <depend type=\"module\">res_stasis</depend>\n+    <depend type=\"module\">res_stasis_playback</depend>\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"res_pjsip_endpoint_identifier_anonymous\">\n+    <depend>pjproject</depend>\n+    <depend>res_pjsip</depend>\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"res_pjsip_transport_websocket\">\n+    <depend>pjproject</depend>\n+    <depend>res_pjsip</depend>\n+    <depend>res_http_websocket</depend>\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"res_pjsip_outbound_registration\">\n+    <depend>pjproject</depend>\n+    <depend>res_pjsip</depend>\n+    <use type=\"module\">res_statsd</use>\n+    <support_level>core</support_level>\n+  </module>\n+  <configInfo name=\"res_pjsip_outbound_registration\" language=\"en_US\">\n+    <synopsis>SIP resource for outbound registrations</synopsis>\n+    <description>\n       <para>\n-        There are two main ways of defining your ACL with the options\n-\t\t\tprovided. You can use the\n-        <literal>permit</literal>\n-        and\n-        <literal>deny</literal>\n-        options\n-\t\t\twhich act on\n-        <emphasis>IP</emphasis>\n-        addresses, or the\n-        <literal>contactpermit</literal>\n-        and\n-        <literal>contactdeny</literal>\n-        options which act on\n-        <emphasis>Contact header</emphasis>\n-        addresses in incoming REGISTER requests. You can combine the various options to\n-\t\t\tcreate a mixed ACL.\n+        <emphasis>Outbound Registration</emphasis>\n       </para>\n       <para>\n-        Additionally, instead of defining an ACL with options, you can reference IP or\n-\t\t\tContact header ACLs from the file\n-        <filename>acl.conf</filename>\n-        by using the\n-        <literal>acl</literal>\n-        or\n-        <literal>contactacl</literal>\n-        options.\n+        This module allows\n+        <literal>res_pjsip</literal>\n+        to register to other SIP servers.\n       </para>\n     </description>\n     <configFile name=\"pjsip.conf\">\n-      <configObject name=\"acl\">\n-        <synopsis>Access Control List</synopsis>\n-        <configOption name=\"acl\">\n-          <synopsis>List of IP ACL section names in acl.conf</synopsis>\n+      <configObject name=\"registration\">\n+        <synopsis>The configuration for outbound registration</synopsis>\n+        <description>\n+          <para>\n+            Registration is\n+            <emphasis>COMPLETELY</emphasis>\n+            separate from the rest of\n+            <literal>pjsip.conf</literal>\n+            . A minimal configuration consists of\n+\t\t\t\t\tsetting a\n+            <literal>server_uri</literal>\n+            and a\n+            <literal>client_uri</literal>\n+            .\n+          </para>\n+        </description>\n+        <configOption name=\"auth_rejection_permanent\" default=\"yes\">\n+          <synopsis>Determines whether failed authentication challenges are treated\n+\t\t\t\t\tas permanent failures.</synopsis>\n+          <description>\n+            <para>If this option is enabled and an authentication challenge fails,\n+\t\t\t\t\tregistration will not be attempted again until the configuration is reloaded.</para>\n+          </description>\n+        </configOption>\n+        <configOption name=\"client_uri\">\n+          <synopsis>Client SIP URI used when attemping outbound registration</synopsis>\n+          <description>\n+            <para>This is the address-of-record for the outbound registration (i.e. the URI in\n+\t\t\t\t\t\tthe To header of the REGISTER).</para>\n+            <para>For registration with an ITSP, the client SIP URI may need to consist of\n+\t\t\t\t\t\tan account name or number and the provider's hostname for their registrar, e.g.\n+\t\t\t\t\t\tclient_uri=1234567890@example.com. This may differ between providers.</para>\n+            <para>For registration to generic registrars, the client SIP URI will depend\n+\t\t\t\t\t\ton networking specifics and configuration of the registrar.</para>\n+          </description>\n+        </configOption>\n+        <configOption name=\"contact_user\">\n+          <synopsis>Contact User to use in request</synopsis>\n+        </configOption>\n+        <configOption name=\"expiration\" default=\"3600\">\n+          <synopsis>Expiration time for registrations in seconds</synopsis>\n+        </configOption>\n+        <configOption name=\"max_retries\" default=\"10\">\n+          <synopsis>Maximum number of registration attempts.</synopsis>\n+          <description>\n+            <para>This sets the maximum number of registration attempts that are made before\n+\t\t\t\t\t\tstopping any further attempts. If set to 0 then upon failure no further attempts\n+\t\t\t\t\t\tare made.</para>\n+          </description>\n+        </configOption>\n+        <configOption name=\"outbound_auth\" default=\"\">\n+          <synopsis>Authentication object(s) to be used for outbound registrations.</synopsis>\n           <description>\n             <para>\n-              This matches sections configured in\n-              <literal>acl.conf</literal>\n-              . The value is\n-\t\t\t\t\t\tdefined as a list of comma-delimited section names.\n+              This is a comma-delimited list of\n+              <replaceable>auth</replaceable>\n+              sections defined in\n+              <filename>pjsip.conf</filename>\n+              used to respond\n+\t\t\t\t\t\tto outbound authentication challenges.\n             </para>\n+            <note>\n+              <para>Using the same auth section for inbound and outbound\n+\t\t\t\t\t\tauthentication is not recommended.  There is a difference in\n+\t\t\t\t\t\tmeaning for an empty realm setting between inbound and outbound\n+\t\t\t\t\t\tauthentication uses.  See the auth realm description for details.</para>\n+            </note>\n           </description>\n         </configOption>\n-        <configOption name=\"contact_acl\">\n-          <synopsis>List of Contact ACL section names in acl.conf</synopsis>\n+        <configOption name=\"outbound_proxy\" default=\"\">\n+          <synopsis>Full SIP URI of the outbound proxy used to send registrations</synopsis>\n+        </configOption>\n+        <configOption name=\"max_random_initial_delay\" default=\"10\">\n+          <synopsis>Maximum interval in seconds for which an initial registration may be randomly delayed</synopsis>\n+          <description>\n+            <para>By default, registrations are randomly delayed by a small amount to prevent\n+\t\t\t\t\t\ttoo many registrations from being made simultaneously.</para>\n+            <para>Depending on your system usage, it may be desirable to set this to a smaller\n+\t\t\t\t\t\tor larger value to have fine grained control over the size of this random delay.</para>\n+          </description>\n+        </configOption>\n+        <configOption name=\"retry_interval\" default=\"60\">\n+          <synopsis>Interval in seconds between retries if outbound registration is unsuccessful</synopsis>\n+        </configOption>\n+        <configOption name=\"forbidden_retry_interval\" default=\"0\">\n+          <synopsis>Interval used when receiving a 403 Forbidden response.</synopsis>\n           <description>\n             <para>\n-              This matches sections configured in\n-              <literal>acl.conf</literal>\n-              . The value is\n-\t\t\t\t\t\tdefined as a list of comma-delimited section names.\n+              If a 403 Forbidden is received, chan_pjsip will wait\n+              <replaceable>forbidden_retry_interval</replaceable>\n+              seconds before\n+\t\t\t\t\t\tattempting registration again. If 0 is specified, chan_pjsip will not\n+\t\t\t\t\t\tretry after receiving a 403 Forbidden response. Setting this to a non-zero\n+\t\t\t\t\t\tvalue goes against a &quot;SHOULD NOT&quot; in RFC3261, but can be used to work around\n+\t\t\t\t\t\tbuggy registrars.\n             </para>\n           </description>\n         </configOption>\n-        <configOption name=\"contact_deny\">\n-          <synopsis>List of Contact header addresses to deny</synopsis>\n+        <configOption name=\"fatal_retry_interval\" default=\"0\">\n+          <synopsis>Interval used when receiving a Fatal response.</synopsis>\n           <description>\n-            <para>The value is a comma-delimited list of IP addresses. IP addresses may\n-\t\t\t\t\t\thave a subnet mask appended. The subnet mask may be written in either\n-\t\t\t\t\t\tCIDR or dotted-decimal notation. Separate the IP address and subnet\n-\t\t\t\t\t\tmask with a slash ('/')</para>\n+            <para>\n+              If a fatal response is received, chan_pjsip will wait\n+              <replaceable>fatal_retry_interval</replaceable>\n+              seconds before\n+\t\t\t\t\t\tattempting registration again. If 0 is specified, chan_pjsip will not\n+\t\t\t\t\t\tretry after receiving a fatal (non-temporary 4xx, 5xx, 6xx) response.\n+\t\t\t\t\t\tSetting this to a non-zero value may go against a &quot;SHOULD NOT&quot; in RFC3261,\n+\t\t\t\t\t\tbut can be used to work around buggy registrars.\n+            </para>\n+            <note>\n+              <para>\n+                if also set the\n+                <replaceable>forbidden_retry_interval</replaceable>\n+                takes precedence over this one when a 403 is received.\n+\t\t\t\t\t\tAlso, if\n+                <replaceable>auth_rejection_permanent</replaceable>\n+                equals 'yes' then\n+\t\t\t\t\t\ta 401 and 407 become subject to this retry interval.\n+              </para>\n+            </note>\n           </description>\n         </configOption>\n-        <configOption name=\"contact_permit\">\n-          <synopsis>List of Contact header addresses to permit</synopsis>\n+        <configOption name=\"server_uri\">\n+          <synopsis>SIP URI of the server to register against</synopsis>\n           <description>\n-            <para>The value is a comma-delimited list of IP addresses. IP addresses may\n-\t\t\t\t\t\thave a subnet mask appended. The subnet mask may be written in either\n-\t\t\t\t\t\tCIDR or dotted-decimal notation. Separate the IP address and subnet\n-\t\t\t\t\t\tmask with a slash ('/')</para>\n+            <para>This is the URI at which to find the registrar to send the outbound REGISTER. This URI\n+\t\t\t\t\t\tis used as the request URI of the outbound REGISTER request from Asterisk.</para>\n+            <para>For registration with an ITSP, the setting may often be just the domain of\n+\t\t\t\t\t\tthe registrar, e.g. sip:sip.example.com.</para>\n           </description>\n         </configOption>\n-        <configOption name=\"deny\">\n-          <synopsis>List of IP addresses to deny access from</synopsis>\n+        <configOption name=\"transport\">\n+          <synopsis>Transport used for outbound authentication</synopsis>\n           <description>\n-            <para>The value is a comma-delimited list of IP addresses. IP addresses may\n-\t\t\t\t\t\thave a subnet mask appended. The subnet mask may be written in either\n-\t\t\t\t\t\tCIDR or dotted-decimal notation. Separate the IP address and subnet\n-\t\t\t\t\t\tmask with a slash ('/')</para>\n+            <note>\n+              <para>\n+                A\n+                <replaceable>transport</replaceable>\n+                configured in\n+                <literal>pjsip.conf</literal>\n+                . As with other\n+                <literal>res_pjsip</literal>\n+                modules, this will use the first available transport of the appropriate type if unconfigured.\n+              </para>\n+            </note>\n           </description>\n         </configOption>\n-        <configOption name=\"permit\">\n-          <synopsis>List of IP addresses to permit access from</synopsis>\n+        <configOption name=\"line\">\n+          <synopsis>Whether to add a 'line' parameter to the Contact for inbound call matching</synopsis>\n           <description>\n-            <para>The value is a comma-delimited list of IP addresses. IP addresses may\n-\t\t\t\t\t\thave a subnet mask appended. The subnet mask may be written in either\n-\t\t\t\t\t\tCIDR or dotted-decimal notation. Separate the IP address and subnet\n-\t\t\t\t\t\tmask with a slash ('/')</para>\n+            <para>When enabled this option will cause a 'line' parameter to be added to the Contact\n+\t\t\t\t\t\theader placed into the outgoing registration request. If the remote server sends a call\n+\t\t\t\t\t\tthis line parameter will be used to establish a relationship to the outbound registration,\n+\t\t\t\t\t\tultimately causing the configured endpoint to be used.</para>\n+          </description>\n+        </configOption>\n+        <configOption name=\"endpoint\">\n+          <synopsis>Endpoint to use for incoming related calls</synopsis>\n+          <description>\n+            <para>When line support is enabled this configured endpoint name is used for incoming calls\n+\t\t\t\t\t\tthat are related to the outbound registration.</para>\n           </description>\n         </configOption>\n         <configOption name=\"type\">\n-          <synopsis>Must be of type 'acl'.</synopsis>\n+          <synopsis>Must be of type 'registration'.</synopsis>\n+        </configOption>\n+        <configOption name=\"support_path\">\n+          <synopsis>Enables Path support for outbound REGISTER requests.</synopsis>\n+          <description>\n+            <para>When this option is enabled, outbound REGISTER requests will advertise\n+\t\t\t\t\t\tsupport for Path headers so that intervening proxies can add to the Path\n+\t\t\t\t\t\theader as necessary.</para>\n+          </description>\n         </configOption>\n       </configObject>\n     </configFile>\n   </configInfo>\n-  <module language=\"en_US\" name=\"res_smdi\">\n-    <support_level>extended</support_level>\n-  </module>\n-  <function name=\"SMDI_MSG_RETRIEVE\" language=\"en_US\">\n-    <synopsis>Retrieve an SMDI message.</synopsis>\n+  <manager name=\"PJSIPUnregister\" language=\"en_US\">\n+    <synopsis>Unregister an outbound registration.</synopsis>\n     <syntax>\n-      <parameter name=\"smdi port\" required=\"true\"/>\n-      <parameter name=\"search key\" required=\"true\"/>\n-      <parameter name=\"timeout\"/>\n-      <parameter name=\"options\">\n-        <enumlist>\n-          <enum name=\"t\">\n-            <para>Instead of searching on the forwarding station, search on the message desk terminal.</para>\n-          </enum>\n-          <enum name=\"n\">\n-            <para>Instead of searching on the forwarding station, search on the message desk number.</para>\n-          </enum>\n-        </enumlist>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      <parameter name=\"Registration\" required=\"true\">\n+        <para>The outbound registration to unregister or '*all' to unregister them all.</para>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>This function is used to retrieve an incoming SMDI message. It returns\n-\t\t\tan ID which can be used with the SMDI_MSG() function to access details of\n-\t\t\tthe message.  Note that this is a destructive function in the sense that\n-\t\t\tonce an SMDI message is retrieved using this function, it is no longer in\n-\t\t\tthe global SMDI message queue, and can not be accessed by any other Asterisk\n-\t\t\tchannels.  The timeout for this function is optional, and the default is\n-\t\t\t3 seconds.  When providing a timeout, it should be in milliseconds.</para>\n-      <para>The default search is done on the forwarding station ID. However, if\n-\t\t\tyou set one of the search key options in the options field, you can change\n-\t\t\tthis behavior.</para>\n+      <para>Unregisters the specified (or all) outbound registration(s) and stops future registration attempts.\n+\t\t\tCall PJSIPRegister to start registration and schedule re-registrations according to configuration.</para>\n     </description>\n-    <see-also>\n-      <ref type=\"function\">SMDI_MSG</ref>\n-    </see-also>\n-  </function>\n-  <function name=\"SMDI_MSG\" language=\"en_US\">\n-    <synopsis>Retrieve details about an SMDI message.</synopsis>\n+  </manager>\n+  <manager name=\"PJSIPRegister\" language=\"en_US\">\n+    <synopsis>Register an outbound registration.</synopsis>\n     <syntax>\n-      <parameter name=\"message_id\" required=\"true\"/>\n-      <parameter name=\"component\" required=\"true\">\n-        <para>Valid message components are:</para>\n-        <enumlist>\n-          <enum name=\"number\">\n-            <para>The message desk number</para>\n-          </enum>\n-          <enum name=\"terminal\">\n-            <para>The message desk terminal</para>\n-          </enum>\n-          <enum name=\"station\">\n-            <para>The forwarding station</para>\n-          </enum>\n-          <enum name=\"callerid\">\n-            <para>The callerID of the calling party that was forwarded</para>\n-          </enum>\n-          <enum name=\"type\">\n-            <para>The call type.  The value here is the exact character\n-\t\t\t\t\t\tthat came in on the SMDI link.  Typically, example values\n-\t\t\t\t\t\tare:</para>\n-            <para>Options:</para>\n-            <enumlist>\n-              <enum name=\"D\">\n-                <para>Direct Calls</para>\n-              </enum>\n-              <enum name=\"A\">\n-                <para>Forward All Calls</para>\n-              </enum>\n-              <enum name=\"B\">\n-                <para>Forward Busy Calls</para>\n-              </enum>\n-              <enum name=\"N\">\n-                <para>Forward No Answer Calls</para>\n-              </enum>\n-            </enumlist>\n-          </enum>\n-        </enumlist>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      <parameter name=\"Registration\" required=\"true\">\n+        <para>The outbound registration to register or '*all' to register them all.</para>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>This function is used to access details of an SMDI message that was\n-\t\t\tpulled from the incoming SMDI message queue using the SMDI_MSG_RETRIEVE()\n-\t\t\tfunction.</para>\n+      <para>Unregisters the specified (or all) outbound registration(s) then starts registration and schedules re-registrations\n+\t\t\taccording to configuration.</para>\n     </description>\n-    <see-also>\n-      <ref type=\"function\">SMDI_MSG_RETRIEVE</ref>\n-    </see-also>\n-  </function>\n+  </manager>\n+  <manager name=\"PJSIPShowRegistrationsOutbound\" language=\"en_US\">\n+    <synopsis>Lists PJSIP outbound registrations.</synopsis>\n+    <syntax/>\n+    <description>\n+      <para>\n+        In response\n+        <literal>OutboundRegistrationDetail</literal>\n+        events showing configuration and status\n+\t\t\tinformation are raised for each outbound registration object.\n+        <literal>AuthDetail</literal>\n+        events are raised for each associated auth object as well.  Once all events are completed an\n+        <literal>OutboundRegistrationDetailComplete</literal>\n+        is issued.\n+      </para>\n+    </description>\n+  </manager>\n+  <module language=\"en_US\" name=\"res_config_curl\">\n+    <depend>func_curl</depend>\n+    <depend>res_curl</depend>\n+    <depend>curl</depend>\n+    <support_level>core</support_level>\n+  </module>\n   <module language=\"en_US\" name=\"res_agi\">\n     <depend>res_speech</depend>\n     <support_level>core</support_level>\n   </module>\n   <agi name=\"answer\" language=\"en_US\">\n     <synopsis>Answer channel</synopsis>\n     <syntax/>\n@@ -32755,143 +33107,674 @@\n       </syntax>\n       <see-also>\n         <ref type=\"managerEvent\">AGIExecStart</ref>\n         <ref type=\"application\">AGI</ref>\n       </see-also>\n     </managerEventInstance>\n   </managerEvent>\n-  <module language=\"en_US\" name=\"res_http_media_cache\">\n-    <depend>curl</depend>\n-    <depend>res_curl</depend>\n+  <module language=\"en_US\" name=\"res_ari_device_states\">\n+    <depend type=\"module\">res_ari</depend>\n+    <depend type=\"module\">res_ari_model</depend>\n+    <depend type=\"module\">res_stasis</depend>\n+    <depend type=\"module\">res_stasis_device_state</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"res_timing_pthread\">\n-    <support_level>extended</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"res_stasis_recording\">\n-    <depend type=\"module\">res_stasis</depend>\n+  <module language=\"en_US\" name=\"res_limit\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"res_pjsip_dialog_info_body_generator\">\n+  <module language=\"en_US\" name=\"res_pjsip_history\">\n     <depend>pjproject</depend>\n     <depend>res_pjsip</depend>\n-    <depend>res_pjsip_pubsub</depend>\n-    <support_level>core</support_level>\n+    <support_level>extended</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"res_stasis_test\">\n-    <depend>TEST_FRAMEWORK</depend>\n+  <module language=\"en_US\" name=\"res_xmpp\">\n+    <depend>iksemel</depend>\n+    <use type=\"external\">openssl</use>\n     <support_level>core</support_level>\n   </module>\n+  <application name=\"JabberSend\" language=\"en_US\" module=\"res_xmpp\">\n+    <synopsis>Sends an XMPP message to a buddy.</synopsis>\n+    <syntax>\n+      <parameter name=\"account\" required=\"true\">\n+        <para>The local named account to listen on (specified in\n+\t\t\t\txmpp.conf)</para>\n+      </parameter>\n+      <parameter name=\"jid\" required=\"true\">\n+        <para>Jabber ID of the buddy to send the message to. It can be a\n+\t\t\t\tbare JID (username@domain) or a full JID (username@domain/resource).</para>\n+      </parameter>\n+      <parameter name=\"message\" required=\"true\">\n+        <para>The message to send.</para>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>\n+        Sends the content of\n+        <replaceable>message</replaceable>\n+        as text message\n+\t\t\tfrom the given\n+        <replaceable>account</replaceable>\n+        to the buddy identified by\n+        <replaceable>jid</replaceable>\n+      </para>\n+      <para>\n+        The example below sends &quot;Hello world&quot; to\n+        <replaceable>bob@domain.com</replaceable>\n+        as an XMPP message from the account\n+        <replaceable>asterisk</replaceable>\n+        , configured in xmpp.conf.\n+      </para>\n+      <example title=\"Send 'Hello world' to Bob\">same =&gt; n,JabberSend(asterisk,bob@domain.com,Hello world)</example>\n+    </description>\n+    <see-also>\n+      <ref type=\"function\" module=\"res_xmpp\">JABBER_STATUS</ref>\n+      <ref type=\"function\" module=\"res_xmpp\">JABBER_RECEIVE</ref>\n+    </see-also>\n+  </application>\n+  <function name=\"JABBER_RECEIVE\" language=\"en_US\" module=\"res_xmpp\">\n+    <synopsis>Reads XMPP messages.</synopsis>\n+    <syntax>\n+      <parameter name=\"account\" required=\"true\">\n+        <para>The local named account to listen on (specified in\n+\t\t\t\txmpp.conf)</para>\n+      </parameter>\n+      <parameter name=\"jid\" required=\"true\">\n+        <para>Jabber ID of the buddy to receive message from. It can be a\n+\t\t\t\tbare JID (username@domain) or a full JID (username@domain/resource).</para>\n+      </parameter>\n+      <parameter name=\"timeout\">\n+        <para>\n+          In seconds, defaults to\n+          <literal>20</literal>\n+          .\n+        </para>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>\n+        Receives a text message on the given\n+        <replaceable>account</replaceable>\n+        from the buddy identified by\n+        <replaceable>jid</replaceable>\n+        and returns the contents.\n+      </para>\n+      <para>\n+        The example below returns an XMPP message sent from\n+        <replaceable>bob@domain.com</replaceable>\n+        (or nothing in case of a time out), to\n+\t\t\tthe\n+        <replaceable>asterisk</replaceable>\n+        XMPP account configured in xmpp.conf.\n+      </para>\n+      <example title=\"Receive a message\">same =&gt; n,Set(msg=${JABBER_RECEIVE(asterisk,bob@domain.com)})</example>\n+    </description>\n+    <see-also>\n+      <ref type=\"function\" module=\"res_xmpp\">JABBER_STATUS</ref>\n+      <ref type=\"application\" module=\"res_xmpp\">JabberSend</ref>\n+    </see-also>\n+  </function>\n+  <function name=\"JABBER_STATUS\" language=\"en_US\" module=\"res_xmpp\">\n+    <synopsis>Retrieves a buddy's status.</synopsis>\n+    <syntax>\n+      <parameter name=\"account\" required=\"true\">\n+        <para>The local named account to listen on (specified in\n+\t\t\t\txmpp.conf)</para>\n+      </parameter>\n+      <parameter name=\"jid\" required=\"true\">\n+        <para>Jabber ID of the buddy to receive message from. It can be a\n+\t\t\t\tbare JID (username@domain) or a full JID (username@domain/resource).</para>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>\n+        Retrieves the numeric status associated with the buddy identified\n+\t\t\tby\n+        <replaceable>jid</replaceable>\n+        .\n+\t\t\tIf the buddy does not exist in the buddylist, returns 7.\n+      </para>\n+      <para>Status will be 1-7.</para>\n+      <para>1=Online, 2=Chatty, 3=Away, 4=XAway, 5=DND, 6=Offline</para>\n+      <para>If not in roster variable will be set to 7.</para>\n+      <para>\n+        Example: ${JABBER_STATUS(asterisk,bob@domain.com)} returns 1 if\n+        <replaceable>bob@domain.com</replaceable>\n+        is online.\n+        <replaceable>asterisk</replaceable>\n+        is\n+\t\t\tthe associated XMPP account configured in xmpp.conf.\n+      </para>\n+    </description>\n+    <see-also>\n+      <ref type=\"function\" module=\"res_xmpp\">JABBER_RECEIVE</ref>\n+      <ref type=\"application\" module=\"res_xmpp\">JabberSend</ref>\n+    </see-also>\n+  </function>\n+  <application name=\"JabberSendGroup\" language=\"en_US\" module=\"res_xmpp\">\n+    <synopsis>Send a Jabber Message to a specified chat room</synopsis>\n+    <syntax>\n+      <parameter name=\"Jabber\" required=\"true\">\n+        <para>Client or transport Asterisk uses to connect to Jabber.</para>\n+      </parameter>\n+      <parameter name=\"RoomJID\" required=\"true\">\n+        <para>XMPP/Jabber JID (Name) of chat room.</para>\n+      </parameter>\n+      <parameter name=\"Message\" required=\"true\">\n+        <para>Message to be sent to the chat room.</para>\n+      </parameter>\n+      <parameter name=\"Nickname\" required=\"false\">\n+        <para>The nickname Asterisk uses in the chat room.</para>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>Allows user to send a message to a chat room via XMPP.</para>\n+      <note>\n+        <para>\n+          To be able to send messages to a chat room, a user must have previously joined it. Use the\n+          <replaceable>JabberJoin</replaceable>\n+          function to do so.\n+        </para>\n+      </note>\n+    </description>\n+  </application>\n+  <application name=\"JabberJoin\" language=\"en_US\" module=\"res_xmpp\">\n+    <synopsis>Join a chat room</synopsis>\n+    <syntax>\n+      <parameter name=\"Jabber\" required=\"true\">\n+        <para>Client or transport Asterisk uses to connect to Jabber.</para>\n+      </parameter>\n+      <parameter name=\"RoomJID\" required=\"true\">\n+        <para>XMPP/Jabber JID (Name) of chat room.</para>\n+      </parameter>\n+      <parameter name=\"Nickname\" required=\"false\">\n+        <para>The nickname Asterisk will use in the chat room.</para>\n+        <note>\n+          <para>If a different nickname is supplied to an already joined room, the old nick will be changed to the new one.</para>\n+        </note>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>Allows Asterisk to join a chat room.</para>\n+    </description>\n+  </application>\n+  <application name=\"JabberLeave\" language=\"en_US\" module=\"res_xmpp\">\n+    <synopsis>Leave a chat room</synopsis>\n+    <syntax>\n+      <parameter name=\"Jabber\" required=\"true\">\n+        <para>Client or transport Asterisk uses to connect to Jabber.</para>\n+      </parameter>\n+      <parameter name=\"RoomJID\" required=\"true\">\n+        <para>XMPP/Jabber JID (Name) of chat room.</para>\n+      </parameter>\n+      <parameter name=\"Nickname\" required=\"false\">\n+        <para>The nickname Asterisk uses in the chat room.</para>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>Allows Asterisk to leave a chat room.</para>\n+    </description>\n+  </application>\n+  <application name=\"JabberStatus\" language=\"en_US\" module=\"res_xmpp\">\n+    <synopsis>Retrieve the status of a jabber list member</synopsis>\n+    <syntax>\n+      <parameter name=\"Jabber\" required=\"true\">\n+        <para>Client or transport Asterisk users to connect to Jabber.</para>\n+      </parameter>\n+      <parameter name=\"JID\" required=\"true\">\n+        <para>XMPP/Jabber JID (Name) of recipient.</para>\n+      </parameter>\n+      <parameter name=\"Variable\" required=\"true\">\n+        <para>Variable to store the status of requested user.</para>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>This application is deprecated. Please use the JABBER_STATUS() function instead.</para>\n+      <para>\n+        Retrieves the numeric status associated with the specified buddy\n+        <replaceable>JID</replaceable>\n+        .\n+\t\t\tThe return value in the\n+        <replaceable>Variable</replaceable>\n+        will be one of the following.\n+      </para>\n+      <enumlist>\n+        <enum name=\"1\">\n+          <para>Online.</para>\n+        </enum>\n+        <enum name=\"2\">\n+          <para>Chatty.</para>\n+        </enum>\n+        <enum name=\"3\">\n+          <para>Away.</para>\n+        </enum>\n+        <enum name=\"4\">\n+          <para>Extended Away.</para>\n+        </enum>\n+        <enum name=\"5\">\n+          <para>Do Not Disturb.</para>\n+        </enum>\n+        <enum name=\"6\">\n+          <para>Offline.</para>\n+        </enum>\n+        <enum name=\"7\">\n+          <para>Not In Roster.</para>\n+        </enum>\n+      </enumlist>\n+    </description>\n+  </application>\n+  <manager name=\"JabberSend\" language=\"en_US\" module=\"res_xmpp\">\n+    <synopsis>Sends a message to a Jabber Client.</synopsis>\n+    <syntax>\n+      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n+      <parameter name=\"Jabber\" required=\"true\">\n+        <para>Client or transport Asterisk uses to connect to JABBER.</para>\n+      </parameter>\n+      <parameter name=\"JID\" required=\"true\">\n+        <para>XMPP/Jabber JID (Name) of recipient.</para>\n+      </parameter>\n+      <parameter name=\"Message\" required=\"true\">\n+        <para>Message to be sent to the buddy.</para>\n+      </parameter>\n+    </syntax>\n+    <description>\n+      <para>Sends a message to a Jabber Client.</para>\n+    </description>\n+  </manager>\n+  <info name=\"MessageDestinationInfo\" language=\"en_US\" tech=\"XMPP\">\n+    <para>\n+      Specifying a prefix of\n+      <literal>xmpp:</literal>\n+      will send the\n+\t\tmessage as an XMPP chat message.\n+    </para>\n+  </info>\n+  <info name=\"MessageFromInfo\" language=\"en_US\" tech=\"XMPP\">\n+    <para>\n+      Specifying a prefix of\n+      <literal>xmpp:</literal>\n+      will specify the\n+\t\taccount defined in\n+      <literal>xmpp.conf</literal>\n+      to send the message from.\n+\t\tNote that this field is required for XMPP messages.\n+    </para>\n+  </info>\n+  <info name=\"MessageToInfo\" language=\"en_US\" tech=\"XMPP\">\n+    <para>Ignored</para>\n+  </info>\n+  <configInfo name=\"res_xmpp\" language=\"en_US\">\n+    <synopsis>XMPP Messaging</synopsis>\n+    <configFile name=\"xmpp.conf\">\n+      <configObject name=\"global\">\n+        <synopsis>Global configuration settings</synopsis>\n+        <configOption name=\"debug\">\n+          <synopsis>Enable/disable XMPP message debugging</synopsis>\n+        </configOption>\n+        <configOption name=\"autoprune\">\n+          <synopsis>Auto-remove users from buddy list.</synopsis>\n+          <description>\n+            <para>Auto-remove users from buddy list. Depending on the setup\n+\t\t\t\t\t(e.g., using your personal Gtalk account for a test) this could cause loss of\n+\t\t\t\t\tthe contact list.</para>\n+          </description>\n+        </configOption>\n+        <configOption name=\"autoregister\">\n+          <synopsis>Auto-register users from buddy list</synopsis>\n+        </configOption>\n+        <configOption name=\"collection_nodes\">\n+          <synopsis>Enable support for XEP-0248 for use with distributed device state</synopsis>\n+        </configOption>\n+        <configOption name=\"pubsub_autocreate\">\n+          <synopsis>Whether or not the PubSub server supports/is using auto-create for nodes</synopsis>\n+        </configOption>\n+        <configOption name=\"auth_policy\">\n+          <synopsis>Whether to automatically accept or deny users' subscription requests</synopsis>\n+        </configOption>\n+      </configObject>\n+      <configObject name=\"client\">\n+        <synopsis>Configuration options for an XMPP client</synopsis>\n+        <configOption name=\"username\">\n+          <synopsis>XMPP username with optional resource</synopsis>\n+        </configOption>\n+        <configOption name=\"secret\">\n+          <synopsis>XMPP password</synopsis>\n+        </configOption>\n+        <configOption name=\"refresh_token\">\n+          <synopsis>Google OAuth 2.0 refresh token</synopsis>\n+        </configOption>\n+        <configOption name=\"oauth_clientid\">\n+          <synopsis>Google OAuth 2.0 application's client id</synopsis>\n+        </configOption>\n+        <configOption name=\"oauth_secret\">\n+          <synopsis>Google OAuth 2.0 application's secret</synopsis>\n+        </configOption>\n+        <configOption name=\"serverhost\">\n+          <synopsis>Route to server, e.g. talk.google.com</synopsis>\n+        </configOption>\n+        <configOption name=\"statusmessage\">\n+          <synopsis>Custom status message</synopsis>\n+        </configOption>\n+        <configOption name=\"pubsub_node\">\n+          <synopsis>Node for publishing events via PubSub</synopsis>\n+        </configOption>\n+        <configOption name=\"context\">\n+          <synopsis>Dialplan context to send incoming messages to</synopsis>\n+        </configOption>\n+        <configOption name=\"priority\">\n+          <synopsis>XMPP resource priority</synopsis>\n+        </configOption>\n+        <configOption name=\"port\">\n+          <synopsis>XMPP server port</synopsis>\n+        </configOption>\n+        <configOption name=\"timeout\">\n+          <synopsis>Timeout in seconds to hold incoming messages</synopsis>\n+          <description>\n+            <para>\n+              Timeout (in seconds) on the message stack. Messages stored longer\n+\t\t\t\t\tthan this value will be deleted by Asterisk. This option applies to incoming messages only\n+\t\t\t\t\twhich are intended to be processed by the\n+              <literal>JABBER_RECEIVE</literal>\n+              dialplan function.\n+            </para>\n+          </description>\n+        </configOption>\n+        <configOption name=\"debug\">\n+          <synopsis>Enable debugging</synopsis>\n+        </configOption>\n+        <configOption name=\"type\">\n+          <synopsis>Connection is either a client or a component</synopsis>\n+        </configOption>\n+        <configOption name=\"distribute_events\">\n+          <synopsis>Whether or not to distribute events using this connection</synopsis>\n+        </configOption>\n+        <configOption name=\"usetls\">\n+          <synopsis>Whether to use TLS for the connection or not</synopsis>\n+        </configOption>\n+        <configOption name=\"usesasl\">\n+          <synopsis>Whether to use SASL for the connection or not</synopsis>\n+        </configOption>\n+        <configOption name=\"forceoldssl\">\n+          <synopsis>Force the use of old-style SSL for the connection</synopsis>\n+        </configOption>\n+        <configOption name=\"keepalive\">\n+          <synopsis>If enabled, periodically send an XMPP message from this client with an empty message</synopsis>\n+        </configOption>\n+        <configOption name=\"autoprune\">\n+          <synopsis>Auto-remove users from buddy list.</synopsis>\n+          <description>\n+            <para>Auto-remove users from buddy list. Depending on the setup\n+\t\t\t\t\t(e.g., using your personal Gtalk account for a test) this could cause loss of\n+\t\t\t\t\tthe contact list.</para>\n+          </description>\n+        </configOption>\n+        <configOption name=\"autoregister\">\n+          <synopsis>Auto-register users bfrom buddy list</synopsis>\n+        </configOption>\n+        <configOption name=\"auth_policy\">\n+          <synopsis>Whether to automatically accept or deny users' subscription requests</synopsis>\n+        </configOption>\n+        <configOption name=\"sendtodialplan\">\n+          <synopsis>Send incoming messages into the dialplan</synopsis>\n+        </configOption>\n+        <configOption name=\"status\">\n+          <synopsis>Default XMPP status for the client</synopsis>\n+          <description>\n+            <para>Can be one of the following XMPP statuses:</para>\n+            <enumlist>\n+              <enum name=\"chat\"/>\n+              <enum name=\"available\"/>\n+              <enum name=\"away\"/>\n+              <enum name=\"xaway\"/>\n+              <enum name=\"dnd\"/>\n+            </enumlist>\n+          </description>\n+        </configOption>\n+        <configOption name=\"buddy\">\n+          <synopsis>Manual addition of buddy to list</synopsis>\n+          <description>\n+            <para>Manual addition of buddy to the buddy list. For distributed events, these buddies are\n+\t\t\t\t\tautomatically added in the whitelist as 'owners' of the node(s).</para>\n+          </description>\n+        </configOption>\n+      </configObject>\n+    </configFile>\n+  </configInfo>\n   <module language=\"en_US\" name=\"res_sorcery_realtime\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"pval\">\n-    <support_level>extended</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"res_sorcery_astdb\">\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"res_ari_applications\">\n-    <depend type=\"module\">res_ari</depend>\n-    <depend type=\"module\">res_ari_model</depend>\n+  <module language=\"en_US\" name=\"res_stasis_snoop\">\n     <depend type=\"module\">res_stasis</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"resource_channels\">\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"resource_bridges\">\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"resource_mailboxes\">\n+  <module language=\"en_US\" name=\"res_pjsip\">\n+    <depend>pjproject</depend>\n+    <depend>res_pjproject</depend>\n+    <depend>res_sorcery_config</depend>\n+    <depend>res_sorcery_memory</depend>\n+    <depend>res_sorcery_astdb</depend>\n+    <use type=\"module\">res_statsd</use>\n+    <use type=\"module\">res_geolocation</use>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"resource_events\">\n+  <module language=\"en_US\" name=\"res_pjsip_diversion\">\n+    <depend>pjproject</depend>\n+    <depend>res_pjsip</depend>\n+    <depend>res_pjsip_session</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"resource_recordings\">\n+  <module language=\"en_US\" name=\"res_pjsip_logger\">\n+    <depend>pjproject</depend>\n+    <depend>res_pjsip</depend>\n+    <defaultenabled>yes</defaultenabled>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"resource_device_states\">\n+  <module language=\"en_US\" name=\"res_pjsip_pidf_eyebeam_body_supplement\">\n+    <depend>pjproject</depend>\n+    <depend>res_pjsip</depend>\n+    <depend>res_pjsip_pubsub</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"resource_playbacks\">\n+  <module language=\"en_US\" name=\"res_pjsip_dlg_options\">\n+    <depend>pjproject</depend>\n+    <depend>res_pjsip</depend>\n+    <depend>res_pjsip_session</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"resource_asterisk\">\n-    <support_level>core</support_level>\n+  <module language=\"en_US\" name=\"res_timing_kqueue\">\n+    <depend>kqueue</depend>\n+    <conflict>launchd</conflict>\n+    <support_level>extended</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"res_pjsip_transport_websocket\">\n+  <module language=\"en_US\" name=\"res_pjsip_endpoint_identifier_ip\">\n     <depend>pjproject</depend>\n     <depend>res_pjsip</depend>\n-    <depend>res_http_websocket</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"res_pjsip_exten_state\">\n+  <configInfo name=\"res_pjsip_endpoint_identifier_ip\" language=\"en_US\">\n+    <synopsis>Module that identifies endpoints</synopsis>\n+    <configFile name=\"pjsip.conf\">\n+      <configObject name=\"identify\">\n+        <synopsis>Identifies endpoints via some criteria.</synopsis>\n+        <description>\n+          <para>This module provides alternatives to matching inbound requests to\n+\t\t\t\t\ta configured endpoint. At least one of the matching mechanisms\n+\t\t\t\t\tmust be provided, or the object configuration is invalid.</para>\n+          <para>The matching mechanisms are provided by the following\n+\t\t\t\t\tconfiguration options:</para>\n+          <enumlist>\n+            <enum name=\"match\">\n+              <para>Match by source IP address.</para>\n+            </enum>\n+            <enum name=\"match_header\">\n+              <para>Match by SIP header.</para>\n+            </enum>\n+          </enumlist>\n+          <note>\n+            <para>\n+              If multiple matching criteria are provided then an inbound\n+\t\t\t\t\trequest will be matched to the endpoint if it matches\n+              <emphasis>any</emphasis>\n+              of the criteria.\n+            </para>\n+          </note>\n+        </description>\n+        <configOption name=\"endpoint\">\n+          <synopsis>Name of endpoint identified</synopsis>\n+        </configOption>\n+        <configOption name=\"match\">\n+          <synopsis>IP addresses or networks to match against.</synopsis>\n+          <description>\n+            <para>The value is a comma-delimited list of IP addresses or\n+\t\t\t\t\t\thostnames.</para>\n+            <para>IP addresses may have a subnet mask appended. The subnet\n+\t\t\t\t\t\tmask may be written in either CIDR or dotted-decimal\n+\t\t\t\t\t\tnotation. Separate the IP address and subnet mask with a slash\n+\t\t\t\t\t\t('/'). A source port can also be specified by adding a colon (':')\n+\t\t\t\t\t\tafter the address but before the subnet mask, e.g.\n+\t\t\t\t\t\t3.2.1.0:5061/24. To specify a source port for an IPv6 address, the\n+\t\t\t\t\t\taddress itself must be enclosed in square brackets\n+\t\t\t\t\t\t('[2001:db8:0::1]:5060')</para>\n+            <para>\n+              When a hostname is used, the behavior depends on whether\n+              <replaceable>srv_lookups</replaceable>\n+              is enabled and/or a source\n+\t\t\t\t\t\tport is provided. If\n+              <replaceable>srv_lookups</replaceable>\n+              is\n+\t\t\t\t\t\tenabled and a source port is not provided, Asterisk will perform\n+\t\t\t\t\t\tan SRV lookup on the provided hostname, adding all of the A and\n+\t\t\t\t\t\tAAAA records that are resolved.\n+            </para>\n+            <para>\n+              If the SRV lookup fails,\n+              <replaceable>srv_lookups</replaceable>\n+              is disabled, or a source\n+\t\t\t\t\t\tport is specified when the hostname is configured, Asterisk will\n+\t\t\t\t\t\tresolve the hostname and add all A and AAAA records that are\n+\t\t\t\t\t\tresolved.\n+            </para>\n+          </description>\n+        </configOption>\n+        <configOption name=\"srv_lookups\" default=\"yes\">\n+          <synopsis>Perform SRV lookups for provided hostnames.</synopsis>\n+          <description>\n+            <para>\n+              When enabled,\n+              <replaceable>srv_lookups</replaceable>\n+              will\n+\t\t\t\t\t\tperform SRV lookups for _sip._udp, _sip._tcp, and _sips._tcp of\n+\t\t\t\t\t\tthe given hostnames to determine additional addresses that traffic\n+\t\t\t\t\t\tmay originate from.\n+            </para>\n+          </description>\n+        </configOption>\n+        <configOption name=\"match_header\">\n+          <synopsis>Header/value pair to match against.</synopsis>\n+          <description>\n+            <para>\n+              A SIP header whose value is used to match against.  SIP\n+\t\t\t\t\t\trequests containing the header, along with the specified value,\n+\t\t\t\t\t\twill be mapped to the specified endpoint.  The header must be\n+\t\t\t\t\t\tspecified with a\n+              <literal>:</literal>\n+              , as in\n+              <literal>match_header = SIPHeader: value</literal>\n+              .\n+            </para>\n+            <para>\n+              The specified SIP header value can be a regular\n+\t\t\t\t\t\texpression if the value is of the form\n+\t\t\t\t\t\t/\n+              <replaceable>regex</replaceable>\n+              /.\n+            </para>\n+            <note>\n+              <para>Use of a regex is expensive so be sure you need\n+\t\t\t\t\t\tto use a regex to match your endpoint.</para>\n+            </note>\n+          </description>\n+        </configOption>\n+        <configOption name=\"type\">\n+          <synopsis>Must be of type 'identify'.</synopsis>\n+        </configOption>\n+      </configObject>\n+    </configFile>\n+  </configInfo>\n+  <module language=\"en_US\" name=\"res_pjsip_geolocation\">\n+    <depend>res_geolocation</depend>\n     <depend>pjproject</depend>\n     <depend>res_pjsip</depend>\n-    <depend>res_pjsip_pubsub</depend>\n-    <depend>res_pjsip_outbound_publish</depend>\n+    <depend>res_pjsip_session</depend>\n+    <depend>chan_pjsip</depend>\n+    <depend>libxml2</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"res_config_curl\">\n-    <depend>func_curl</depend>\n-    <depend>res_curl</depend>\n-    <depend>curl</depend>\n+  <module language=\"en_US\" name=\"res_statsd\">\n+    <support_level>extended</support_level>\n+  </module>\n+  <configInfo name=\"res_statsd\" language=\"en_US\">\n+    <synopsis>StatsD client</synopsis>\n+    <description>\n+      <para>\n+        The\n+        <literal>res_statsd</literal>\n+        module provides an API that\n+\t\t\tallows Asterisk and its modules to send statistics to a StatsD\n+\t\t\tserver. It only provides a means to communicate with a StatsD server\n+\t\t\tand does not send any metrics of its own.\n+      </para>\n+      <para>\n+        An example module,\n+        <literal>res_chan_stats</literal>\n+        , is\n+\t\t\tprovided which uses the API exposed by this module to send channel\n+\t\t\tstatistics to the configured StatsD server.\n+      </para>\n+      <para>More information about StatsD can be found at\n+\t\t\thttps://github.com/statsd/statsd</para>\n+    </description>\n+    <configFile name=\"statsd.conf\">\n+      <configObject name=\"global\">\n+        <synopsis>Global configuration settings</synopsis>\n+        <configOption name=\"enabled\">\n+          <synopsis>Enable/disable the StatsD module</synopsis>\n+        </configOption>\n+        <configOption name=\"server\">\n+          <synopsis>Address of the StatsD server</synopsis>\n+        </configOption>\n+        <configOption name=\"prefix\">\n+          <synopsis>Prefix to prepend to every metric</synopsis>\n+        </configOption>\n+        <configOption name=\"add_newline\">\n+          <synopsis>Append a newline to every event. This is useful if\n+\t\t\t\t\tyou want to fake out a server using netcat\n+\t\t\t\t\t(nc -lu 8125)</synopsis>\n+        </configOption>\n+        <configOption name=\"meter_support\">\n+          <synopsis>Enable/disable the non-standard StatsD Meter type,\n+\t\t\t\t\tif disabled falls back to counter and will append a &quot;_meter&quot; suffix to the metric name</synopsis>\n+        </configOption>\n+      </configObject>\n+    </configFile>\n+  </configInfo>\n+  <module language=\"en_US\" name=\"res_stasis_device_state\">\n+    <depend type=\"module\">res_stasis</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"res_rtp_multicast\">\n+  <module language=\"en_US\" name=\"res_format_attr_siren14\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"res_manager_devicestate\">\n+  <module language=\"en_US\" name=\"res_clioriginate\">\n     <support_level>core</support_level>\n   </module>\n-  <manager name=\"DeviceStateList\" language=\"en_US\">\n-    <synopsis>List the current known device states.</synopsis>\n-    <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-    </syntax>\n-    <description>\n-      <para>\n-        This will list out all known device states in a\n-\t\t\tsequence of\n-        <replaceable>DeviceStateChange</replaceable>\n-        events.\n-\t\t\tWhen finished, a\n-        <replaceable>DeviceStateListComplete</replaceable>\n-        event\n-\t\t\twill be emitted.\n-      </para>\n-    </description>\n-    <see-also>\n-      <ref type=\"managerEvent\">DeviceStateChange</ref>\n-      <ref type=\"function\">DEVICE_STATE</ref>\n-    </see-also>\n-    <responses>\n-      <list-elements>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='DeviceStateChange'])\"/>\n-      </list-elements>\n-      <managerEvent name=\"DeviceStateListComplete\" language=\"en_US\">\n-        <managerEventInstance class=\"EVENT_FLAG_COMMAND\">\n-          <synopsis>Indicates the end of the list the current known extension states.</synopsis>\n-          <syntax>\n-            <parameter name=\"EventList\">\n-              <para>Conveys the status of the event list.</para>\n-            </parameter>\n-            <parameter name=\"ListItems\">\n-              <para>Conveys the number of statuses reported.</para>\n-            </parameter>\n-          </syntax>\n-        </managerEventInstance>\n-      </managerEvent>\n-    </responses>\n-  </manager>\n-  <module language=\"en_US\" name=\"res_config_ldap\">\n-    <depend>ldap</depend>\n-    <support_level>extended</support_level>\n+  <module language=\"en_US\" name=\"res_pjsip_t38\">\n+    <depend>pjproject</depend>\n+    <depend>res_pjsip</depend>\n+    <depend>res_pjsip_session</depend>\n+    <support_level>core</support_level>\n   </module>\n   <module language=\"en_US\" name=\"res_ari\">\n     <depend type=\"module\">res_http_websocket</depend>\n     <depend type=\"module\">res_stasis</depend>\n     <support_level>core</support_level>\n   </module>\n   <configInfo name=\"res_ari\" language=\"en_US\">\n@@ -32960,1127 +33843,244 @@\n         </configOption>\n         <configOption name=\"password_format\">\n           <synopsis>password_format may be set to plain (the default) or crypt. When set to crypt, crypt(3) is used to validate the password. A crypted password can be generated using mkpasswd -m sha-512. When set to plain, the password is in plaintext</synopsis>\n         </configOption>\n       </configObject>\n     </configFile>\n   </configInfo>\n-  <module language=\"en_US\" name=\"res_pjsip_one_touch_record_info\">\n-    <depend>pjproject</depend>\n-    <depend>res_pjsip</depend>\n-    <depend>res_pjsip_session</depend>\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"res_timing_timerfd\">\n-    <depend>timerfd</depend>\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"res_stasis_playback\">\n-    <depend type=\"module\">res_stasis</depend>\n-    <depend type=\"module\">res_stasis_recording</depend>\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"res_pktccops\">\n-    <defaultenabled>no</defaultenabled>\n-    <support_level>extended</support_level>\n-    <deprecated_in>19</deprecated_in>\n-    <removed_in>21</removed_in>\n-  </module>\n-  <module language=\"en_US\" name=\"res_pjsip_send_to_voicemail\">\n-    <depend>pjproject</depend>\n-    <depend>res_pjsip</depend>\n-    <depend>res_pjsip_session</depend>\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"res_pjsip_stir_shaken\">\n-    <depend>pjproject</depend>\n-    <depend>res_pjsip</depend>\n-    <depend>res_pjsip_session</depend>\n-    <depend>res_stir_shaken</depend>\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"res_fax_spandsp\">\n-    <depend>spandsp</depend>\n-    <depend>res_fax</depend>\n-    <support_level>extended</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"res_speech\">\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"res_pjsip\">\n-    <depend>pjproject</depend>\n-    <depend>res_pjproject</depend>\n-    <depend>res_sorcery_config</depend>\n-    <depend>res_sorcery_memory</depend>\n-    <depend>res_sorcery_astdb</depend>\n-    <use type=\"module\">res_statsd</use>\n-    <use type=\"module\">res_geolocation</use>\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"res_pjsip_path\">\n-    <depend>pjproject</depend>\n-    <depend>res_pjsip</depend>\n-    <depend>res_pjsip_session</depend>\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"res_pjsip_dtmf_info\">\n-    <depend>pjproject</depend>\n-    <depend>res_pjsip</depend>\n-    <depend>res_pjsip_session</depend>\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"res_cliexec\">\n-    <defaultenabled>no</defaultenabled>\n-    <support_level>extended</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"res_hep_pjsip\">\n-    <depend>pjproject</depend>\n-    <depend>res_pjsip</depend>\n-    <depend>res_pjsip_session</depend>\n-    <depend>res_hep</depend>\n-    <support_level>extended</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"res_chan_stats\">\n-    <depend>res_statsd</depend>\n-    <defaultenabled>no</defaultenabled>\n-    <support_level>extended</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"res_realtime\">\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"res_stun_monitor\">\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"res_ari_bridges\">\n-    <depend type=\"module\">res_ari</depend>\n-    <depend type=\"module\">res_ari_model</depend>\n-    <depend type=\"module\">res_stasis</depend>\n-    <depend type=\"module\">res_stasis_recording</depend>\n-    <depend type=\"module\">res_stasis_playback</depend>\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"res_pjsip_refer\">\n-    <depend>pjproject</depend>\n-    <depend>res_pjsip</depend>\n-    <depend>res_pjsip_session</depend>\n-    <depend>res_pjsip_pubsub</depend>\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"res_endpoint_stats\">\n-    <depend>res_statsd</depend>\n-    <defaultenabled>no</defaultenabled>\n-    <support_level>extended</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"res_pjsip_messaging\">\n-    <depend>pjproject</depend>\n-    <depend>res_pjsip</depend>\n-    <depend>res_pjsip_session</depend>\n+  <module language=\"en_US\" name=\"res_stir_shaken\">\n+    <depend>crypto</depend>\n+    <depend>curl</depend>\n+    <depend>res_curl</depend>\n     <support_level>core</support_level>\n   </module>\n-  <info name=\"MessageDestinationInfo\" language=\"en_US\" tech=\"PJSIP\">\n-    <para>\n-      The\n-      <literal>destination</literal>\n-      parameter is used to construct\n-\t\tthe Request URI for an outgoing message.  It can be in one of the following\n-\t\tformats, all prefixed with the\n-      <literal>pjsip:</literal>\n-      message tech.\n-    </para>\n-    <para/>\n-    <enumlist>\n-      <enum name=\"endpoint\">\n-        <para>Request URI comes from the endpoint's default aor and contact.</para>\n-      </enum>\n-      <enum name=\"endpoint/aor\">\n-        <para>Request URI comes from the specific aor/contact.</para>\n-      </enum>\n-      <enum name=\"endpoint@domain\">\n-        <para>Request URI from the endpoint's default aor and contact.  The domain is discarded.</para>\n-      </enum>\n-    </enumlist>\n-    <para/>\n-    <para>These all use the endpoint to send the message with the specified URI:</para>\n-    <para/>\n-    <enumlist>\n-      <enum name=\"endpoint/&lt;sip[s]:host&gt;&gt;\"/>\n-      <enum name=\"endpoint/&lt;sip[s]:user@host&gt;\"/>\n-      <enum name=\"endpoint/&quot;display name&quot; &lt;sip[s]:host&gt;\"/>\n-      <enum name=\"endpoint/&quot;display name&quot; &lt;sip[s]:user@host&gt;\"/>\n-      <enum name=\"endpoint/sip[s]:host\"/>\n-      <enum name=\"endpoint/sip[s]:user@host\"/>\n-      <enum name=\"endpoint/host\"/>\n-      <enum name=\"endpoint/user@host\"/>\n-    </enumlist>\n-    <para/>\n-    <para>These all use the default endpoint to send the message with the specified URI:</para>\n-    <para/>\n-    <enumlist>\n-      <enum name=\"&lt;sip[s]:host&gt;\"/>\n-      <enum name=\"&lt;sip[s]:user@host&gt;\"/>\n-      <enum name=\"&quot;display name&quot; &lt;sip[s]:host&gt;\"/>\n-      <enum name=\"&quot;display name&quot; &lt;sip[s]:user@host&gt;\"/>\n-      <enum name=\"sip[s]:host\"/>\n-      <enum name=\"sip[s]:user@host\"/>\n-    </enumlist>\n-    <para/>\n-    <para>These use the default endpoint to send the message with the specified host:</para>\n-    <para/>\n-    <enumlist>\n-      <enum name=\"host\"/>\n-      <enum name=\"user@host\"/>\n-    </enumlist>\n-    <para/>\n-    <para>This form is similar to a dialstring:</para>\n-    <para/>\n-    <enumlist>\n-      <enum name=\"PJSIP/user@endpoint\"/>\n-    </enumlist>\n-    <para/>\n-    <para>\n-      You still need to prefix the destination with\n-\t\tthe\n-      <literal>pjsip:</literal>\n-      message technology prefix.  For example:\n-      <literal>pjsip:PJSIP/8005551212@myprovider</literal>\n-      .\n-\t\tThe endpoint contact's URI will have the\n-      <literal>user</literal>\n-      inserted\n-\t\tinto it and will become the Request URI.  If the contact URI already has\n-\t\ta user specified, it will be replaced.\n-    </para>\n-    <para/>\n-  </info>\n-  <info name=\"MessageFromInfo\" language=\"en_US\" tech=\"PJSIP\">\n-    <para>\n-      The\n-      <literal>from</literal>\n-      parameter is used to specity the\n-      <literal>From:</literal>\n-      header in the outgoing SIP MESSAGE.  It will override the value specified in\n-\t\tMESSAGE(from) which itself will override any\n-      <literal>from</literal>\n-      value from\n-\t\tan incoming SIP MESSAGE.\n-    </para>\n-    <para/>\n-  </info>\n-  <info name=\"MessageToInfo\" language=\"en_US\" tech=\"PJSIP\">\n-    <para>\n-      The\n-      <literal>to</literal>\n-      parameter is used to specity the\n-      <literal>To:</literal>\n-      header in the outgoing SIP MESSAGE.  It will override the value specified in\n-\t\tMESSAGE(to) which itself will override any\n-      <literal>to</literal>\n-      value from\n-\t\tan incoming SIP MESSAGE.\n-    </para>\n-    <para/>\n-  </info>\n-  <module language=\"en_US\" name=\"res_hep\">\n-    <support_level>extended</support_level>\n-  </module>\n-  <configInfo name=\"res_hep\" language=\"en_US\">\n-    <synopsis>Resource for integration with Homer using HEPv3</synopsis>\n-    <configFile name=\"hep.conf\">\n+  <configInfo name=\"res_stir_shaken\" language=\"en_US\">\n+    <synopsis>STIR/SHAKEN module for Asterisk</synopsis>\n+    <configFile name=\"stir_shaken.conf\">\n       <configObject name=\"general\">\n-        <synopsis>General settings.</synopsis>\n-        <description>\n-          <para>\n-            The\n-            <emphasis>general</emphasis>\n-            settings section contains information\n-\t\t\t\t\tto configure Asterisk as a Homer capture agent.\n-          </para>\n-        </description>\n-        <configOption name=\"enabled\" default=\"yes\">\n-          <synopsis>Enable or disable packet capturing.</synopsis>\n-          <description>\n-            <enumlist>\n-              <enum name=\"no\"/>\n-              <enum name=\"yes\"/>\n-            </enumlist>\n-          </description>\n+        <synopsis>STIR/SHAKEN general options</synopsis>\n+        <configOption name=\"type\">\n+          <synopsis>Must be of type 'general'.</synopsis>\n         </configOption>\n-        <configOption name=\"uuid_type\" default=\"call-id\">\n-          <synopsis>The preferred type of UUID to pass to Homer.</synopsis>\n-          <description>\n-            <enumlist>\n-              <enum name=\"call-id\">\n-                <para>Use the PJSIP Call-Id</para>\n-              </enum>\n-              <enum name=\"channel\">\n-                <para>Use the Asterisk channel name</para>\n-              </enum>\n-            </enumlist>\n-          </description>\n+        <configOption name=\"ca_file\" default=\"\">\n+          <synopsis>File path to the certificate authority certificate</synopsis>\n         </configOption>\n-        <configOption name=\"capture_address\">\n-          <synopsis>The address and port of the Homer server to send packets to.</synopsis>\n+        <configOption name=\"ca_path\" default=\"\">\n+          <synopsis>File path to a chain of trust</synopsis>\n         </configOption>\n-        <configOption name=\"capture_password\">\n-          <synopsis>If set, the authentication password to send to Homer.</synopsis>\n+        <configOption name=\"cache_max_size\" default=\"1000\">\n+          <synopsis>Maximum size to use for caching public keys</synopsis>\n         </configOption>\n-        <configOption name=\"capture_id\" default=\"0\">\n-          <synopsis>The ID for this capture agent.</synopsis>\n+        <configOption name=\"curl_timeout\" default=\"2\">\n+          <synopsis>Maximum time to wait to CURL certificates</synopsis>\n         </configOption>\n-      </configObject>\n-    </configFile>\n-  </configInfo>\n-  <module language=\"en_US\" name=\"res_ari_sounds\">\n-    <depend type=\"module\">res_ari</depend>\n-    <depend type=\"module\">res_ari_model</depend>\n-    <depend type=\"module\">res_stasis</depend>\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"res_format_attr_g729\">\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"res_ari_recordings\">\n-    <depend type=\"module\">res_ari</depend>\n-    <depend type=\"module\">res_ari_model</depend>\n-    <depend type=\"module\">res_stasis</depend>\n-    <depend type=\"module\">res_stasis_recording</depend>\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"res_calendar_exchange\">\n-    <depend>res_calendar</depend>\n-    <depend>neon</depend>\n-    <depend>ical</depend>\n-    <depend>iksemel</depend>\n-    <support_level>extended</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"res_pjsip_authenticator_digest\">\n-    <depend>pjproject</depend>\n-    <depend>res_pjsip</depend>\n-    <support_level>core</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"res_parking\">\n-    <depend>bridge_holding</depend>\n-    <support_level>core</support_level>\n-  </module>\n-  <configInfo name=\"res_parking\" language=\"en_US\">\n-    <configFile name=\"res_parking.conf\">\n-      <configObject name=\"globals\">\n-        <synopsis>Options that apply to every parking lot</synopsis>\n-        <configOption name=\"parkeddynamic\">\n-          <synopsis>Enables dynamically created parkinglots.</synopsis>\n-          <description>\n-            <para>If the option is enabled then the following variables can\n-\t\t\t\t\t\t\tbe used to dynamically create new parking lots.</para>\n-            <para>\n-              The\n-              <variable>PARKINGDYNAMIC</variable>\n-              variable specifies the\n-\t\t\t\t\t\t\tparking lot to use as a template to create a dynamic parking lot. It\n-\t\t\t\t\t\t\tis an error to specify a non-existent parking lot for the template.\n-\t\t\t\t\t\t\tIf not set then the default parking lot is used as the template.\n-            </para>\n-            <para>\n-              The\n-              <variable>PARKINGDYNCONTEXT</variable>\n-              variable specifies the\n-\t\t\t\t\t\t\tdialplan context to use for the newly created dynamic parking lot. If\n-\t\t\t\t\t\t\tnot set then the context from the parking lot template is used. The\n-\t\t\t\t\t\t\tcontext is created if it does not already exist and the new parking lot\n-\t\t\t\t\t\t\tneeds to create extensions.\n-            </para>\n-            <para>\n-              The\n-              <variable>PARKINGDYNEXTEN</variable>\n-              variable specifies the\n-              <literal>parkext</literal>\n-              to use for the newly created dynamic\n-\t\t\t\t\t\t\tparking lot. If not set then the\n-              <literal>parkext</literal>\n-              is used from\n-\t\t\t\t\t\t\tthe parking lot template. If the template does not specify a\n-              <literal>parkext</literal>\n-              then no extensions are created for the newly\n-\t\t\t\t\t\t\tcreated parking lot. The dynamic parking lot cannot be created if it\n-\t\t\t\t\t\t\tneeds to create extensions that overlap existing parking lot extensions.\n-\t\t\t\t\t\t\tThe only exception to this is for the\n-              <literal>parkext</literal>\n-              extension and only if neither of the overlaping parking lot's\n-              <literal>parkext</literal>\n-              is exclusive.\n-            </para>\n-            <para>\n-              The\n-              <variable>PARKINGDYNPOS</variable>\n-              variable specifies the\n-\t\t\t\t\t\t\tparking positions to use for the newly created dynamic parking lot. If\n-\t\t\t\t\t\t\tnot set then the\n-              <literal>parkpos</literal>\n-              from the parking lot template\n-\t\t\t\t\t\t\tis used.\n-            </para>\n-          </description>\n+        <configOption name=\"signature_timeout\" default=\"15\">\n+          <synopsis>Amount of time a signature is valid for</synopsis>\n         </configOption>\n       </configObject>\n-      <configObject name=\"parking_lot\">\n-        <synopsis>Defined parking lots for res_parking to use to park calls on</synopsis>\n-        <configOption name=\"context\" default=\"parkedcalls\">\n-          <synopsis>The name of the context where calls are parked and picked up from.</synopsis>\n-          <description>\n-            <para>This option is only used if parkext is set.</para>\n-          </description>\n-        </configOption>\n-        <configOption name=\"parkext\">\n-          <synopsis>Extension to park calls to this parking lot.</synopsis>\n-          <description>\n-            <para>\n-              If this option is used, this extension will automatically\n-\t\t\t\t\t\t\tbe created to place calls into parking lots. In addition, if\n-              <literal>parkext_exclusive</literal>\n-              is set for this parking\n-\t\t\t\t\t\t\tlot, the name of the parking lot will be included in the\n-\t\t\t\t\t\t\tapplication's arguments so that it only parks to this parking\n-\t\t\t\t\t\t\tlot. The extension will be created in\n-              <literal>context</literal>\n-              .\n-\t\t\t\t\t\t\tUsing this option also creates extensions for retrieving\n-\t\t\t\t\t\t\tparked calls from the parking spaces in the same context.\n-            </para>\n-            <note>\n-              <para>\n-                Generated parking extensions cannot overlap.\n-\t\t\t\t\t\t\t\tThe only exception is if neither overlapping\n-                <literal>parkext</literal>\n-                is exclusive.\n-              </para>\n-            </note>\n-          </description>\n+      <configObject name=\"store\">\n+        <synopsis>STIR/SHAKEN certificate store options</synopsis>\n+        <configOption name=\"type\">\n+          <synopsis>Must be of type 'store'.</synopsis>\n         </configOption>\n-        <configOption name=\"parkext_exclusive\" default=\"no\">\n-          <synopsis>If yes, the extension registered as parkext will park exclusively to this parking lot.</synopsis>\n+        <configOption name=\"path\" default=\"\">\n+          <synopsis>Path to a directory containing certificates</synopsis>\n         </configOption>\n-        <configOption name=\"parkpos\" default=\"701-750\">\n-          <synopsis>Numerical range of parking spaces which can be used to retrieve parked calls.</synopsis>\n+        <configOption name=\"public_cert_url\" default=\"\">\n+          <synopsis>URL to the public certificate(s)</synopsis>\n           <description>\n-            <para>\n-              If\n-              <literal>parkext</literal>\n-              is set, these extensions\n-\t\t\t\t\t\t\twill automatically be mapped in\n-              <literal>context</literal>\n-              in order to pick up calls parked to these parking spaces.\n-            </para>\n+            <para>Must be a valid http, or https, URL. The URL must also contain the ${CERTIFICATE} variable, which is used for public key name substitution.\n+\t\t\t\t\t For example: http://mycompany.com/${CERTIFICATE}.pub</para>\n           </description>\n         </configOption>\n-        <configOption name=\"parkinghints\" default=\"no\">\n-          <synopsis>If yes, this parking lot will add hints automatically for parking spaces.</synopsis>\n-        </configOption>\n-        <configOption name=\"parkingtime\" default=\"45\">\n-          <synopsis>Amount of time a call will remain parked before giving up (in seconds).</synopsis>\n-        </configOption>\n-        <configOption name=\"parkedmusicclass\">\n-          <synopsis>Which music class to use for parked calls. They will use the default if unspecified.</synopsis>\n-        </configOption>\n-        <configOption name=\"comebacktoorigin\" default=\"yes\">\n-          <synopsis>Determines what should be done with the parked channel if no one picks it up before it times out.</synopsis>\n-          <description>\n-            <para>Valid Options:</para>\n-            <enumlist>\n-              <enum name=\"yes\">\n-                <para>\n-                  Automatically have the parked channel dial the device that parked the call with dial\n-\t\t\t\t\t\t\t\t\ttimeout set by the\n-                  <literal>parkingtime</literal>\n-                  option. When the call times out an extension\n-\t\t\t\t\t\t\t\t\tto dial the PARKER will automatically be created in the\n-                  <literal>park-dial</literal>\n-                  context with\n-\t\t\t\t\t\t\t\t\tan extension of the flattened parker device name. If the call is not answered, the parked channel\n-\t\t\t\t\t\t\t\t\tthat is timing out will continue in the dial plan at that point if there are more priorities in\n-\t\t\t\t\t\t\t\t\tthe extension (which won't be the case unless the dialplan deliberately includes such priorities\n-\t\t\t\t\t\t\t\t\tin the\n-                  <literal>park-dial</literal>\n-                  context through pattern matching or deliberately written\n-\t\t\t\t\t\t\t\t\tflattened peer extensions).\n-                </para>\n-              </enum>\n-              <enum name=\"no\">\n-                <para>\n-                  Place the call into the PBX at\n-                  <literal>comebackcontext</literal>\n-                  instead. The extension will\n-\t\t\t\t\t\t\t\t\tstill be set as the flattened peer name. If an extension the flattened peer name isn't available\n-\t\t\t\t\t\t\t\t\tthen it will fall back to the\n-                  <literal>s</literal>\n-                  extension. If that also is unavailable it will\n-\t\t\t\t\t\t\t\t\tattempt to fall back to\n-                  <literal>s@default</literal>\n-                  . The normal dial extension will still be\n-\t\t\t\t\t\t\t\t\tcreated in the\n-                  <literal>park-dial</literal>\n-                  context with the extension also being the flattened\n-\t\t\t\t\t\t\t\t\tpeer name.\n-                </para>\n-              </enum>\n-            </enumlist>\n-            <note>\n-              <para>\n-                Flattened Peer Names - Extensions can not include slash characters since those are used for pattern\n-\t\t\t\t\t\t\tmatching. When a peer name is flattened, slashes become underscores. For example if the parker of a call\n-\t\t\t\t\t\t\tis called\n-                <literal>SIP/0004F2040001</literal>\n-                then flattened peer name and therefor the extensions created\n-\t\t\t\t\t\t\tand used on timeouts will be\n-                <literal>SIP_0004F204001</literal>\n-                .\n-              </para>\n-            </note>\n-            <note>\n-              <para>When parking times out and the channel returns to the dial plan, the following variables are set:</para>\n-            </note>\n-            <variablelist>\n-              <variable name=\"PARKING_SPACE\">\n-                <para>extension that the call was parked in prior to timing out.</para>\n-              </variable>\n-              <variable name=\"PARKINGSLOT\">\n-                <para>\n-                  Deprecated.  Use\n-                  <variable>PARKING_SPACE</variable>\n-                  instead.\n-                </para>\n-              </variable>\n-              <variable name=\"PARKEDLOT\">\n-                <para>name of the lot that the call was parked in prior to timing out.</para>\n-              </variable>\n-              <variable name=\"PARKER\">\n-                <para>The device that parked the call</para>\n-              </variable>\n-              <variable name=\"PARKER_FLAT\">\n-                <para>\n-                  The flat version of\n-                  <variable>PARKER</variable>\n-                </para>\n-              </variable>\n-            </variablelist>\n-          </description>\n+      </configObject>\n+      <configObject name=\"certificate\">\n+        <synopsis>STIR/SHAKEN certificate options</synopsis>\n+        <configOption name=\"type\">\n+          <synopsis>Must be of type 'certificate'.</synopsis>\n         </configOption>\n-        <configOption name=\"comebackdialtime\" default=\"30\">\n-          <synopsis>Timeout for the Dial extension created to call back the parker when a parked call times out.</synopsis>\n+        <configOption name=\"path\" default=\"\">\n+          <synopsis>File path to a certificate</synopsis>\n         </configOption>\n-        <configOption name=\"comebackcontext\" default=\"parkedcallstimeout\">\n-          <synopsis>Context where parked calls will enter the PBX on timeout when comebacktoorigin=no</synopsis>\n+        <configOption name=\"public_cert_url\" default=\"\">\n+          <synopsis>URL to the public certificate</synopsis>\n           <description>\n-            <para>The extension the call enters will prioritize the flattened peer name in this context.\n-\t\t\t\t\t\tIf the flattened peer name extension is unavailable, then the 's' extension in this context will be\n-\t\t\t\t\t\tused. If that also is unavailable, the 's' extension in the 'default' context will be used.</para>\n+            <para>Must be a valid http, or https, URL.</para>\n           </description>\n         </configOption>\n-        <configOption name=\"courtesytone\">\n-          <synopsis>If the name of a sound file is provided, use this as the courtesy tone</synopsis>\n-          <description>\n-            <para>\n-              By default, this tone is only played to the caller of a parked call. Who receives the tone\n-\t\t\t\t\t\tcan be changed using the\n-              <literal>parkedplay</literal>\n-              option.\n-            </para>\n-          </description>\n+        <configOption name=\"attestation\">\n+          <synopsis>Attestation level</synopsis>\n         </configOption>\n-        <configOption name=\"parkedplay\" default=\"caller\">\n-          <synopsis>Who we should play the courtesytone to on the pickup of a parked call from this lot</synopsis>\n-          <description>\n-            <enumlist>\n-              <enum name=\"no\">\n-                <para>Apply to neither side.</para>\n-              </enum>\n-              <enum name=\"caller\">\n-                <para>Apply only to the call connecting with the call coming out of the parking lot.</para>\n-              </enum>\n-              <enum name=\"callee\">\n-                <para>Apply only to the call coming out of the parking lot.</para>\n-              </enum>\n-              <enum name=\"both\">\n-                <para>Apply to both sides.</para>\n-              </enum>\n-            </enumlist>\n-            <note>\n-              <para>If courtesy tone is not specified then this option will be ignored.</para>\n-            </note>\n-          </description>\n+        <configOption name=\"caller_id_number\" default=\"\">\n+          <synopsis>The caller ID number to match on.</synopsis>\n         </configOption>\n-        <configOption name=\"parkedcalltransfers\" default=\"no\">\n-          <synopsis>Who to apply the DTMF transfer features to when parked calls are picked up or timeout.</synopsis>\n-          <description>\n-            <xi:include xpointer=\"xpointer(/docs/configInfo[@name='res_parking']/configFile[@name='res_parking.conf']/configObject[@name='parking_lot']/configOption[@name='parkedplay']/description/enumlist)\"/>\n-          </description>\n+      </configObject>\n+      <configObject name=\"profile\">\n+        <synopsis>STIR/SHAKEN profile configuration options</synopsis>\n+        <configOption name=\"type\">\n+          <synopsis>Must be of type 'profile'.</synopsis>\n         </configOption>\n-        <configOption name=\"parkedcallreparking\" default=\"no\">\n-          <synopsis>Who to apply the DTMF parking feature to when parked calls are picked up or timeout.</synopsis>\n+        <configOption name=\"stir_shaken\" default=\"on\">\n+          <synopsis>STIR/SHAKEN configuration settings</synopsis>\n           <description>\n-            <xi:include xpointer=\"xpointer(/docs/configInfo[@name='res_parking']/configFile[@name='res_parking.conf']/configObject[@name='parking_lot']/configOption[@name='parkedplay']/description/enumlist)\"/>\n+            <para>Attest, verify, or do both STIR/SHAKEN operations. On incoming\n+\t\t\t\t\t\tINVITEs, the Identity header will be checked for validity. On\n+\t\t\t\t\t\toutgoing INVITEs, an Identity header will be added.</para>\n           </description>\n         </configOption>\n-        <configOption name=\"parkedcallhangup\" default=\"no\">\n-          <synopsis>Who to apply the DTMF hangup feature to when parked calls are picked up or timeout.</synopsis>\n-          <description>\n-            <xi:include xpointer=\"xpointer(/docs/configInfo[@name='res_parking']/configFile[@name='res_parking.conf']/configObject[@name='parking_lot']/configOption[@name='parkedplay']/description/enumlist)\"/>\n-          </description>\n+        <configOption name=\"acllist\" default=\"\">\n+          <synopsis>An existing ACL from acl.conf to use</synopsis>\n         </configOption>\n-        <configOption name=\"parkedcallrecording\" default=\"no\">\n-          <synopsis>Who to apply the DTMF MixMonitor recording feature to when parked calls are picked up or timeout.</synopsis>\n-          <description>\n-            <xi:include xpointer=\"xpointer(/docs/configInfo[@name='res_parking']/configFile[@name='res_parking.conf']/configObject[@name='parking_lot']/configOption[@name='parkedplay']/description/enumlist)\"/>\n-          </description>\n+        <configOption name=\"permit\" default=\"\">\n+          <synopsis>An IP or subnet to permit</synopsis>\n         </configOption>\n-        <configOption name=\"findslot\" default=\"first\">\n-          <synopsis>Rule to use when trying to figure out which parking space a call should be parked with.</synopsis>\n-          <description>\n-            <enumlist>\n-              <enum name=\"first\">\n-                <para>Always try to place in the lowest available space in the parking lot</para>\n-              </enum>\n-              <enum name=\"next\">\n-                <para>Track the last parking space used and always attempt to use the one immediately after.</para>\n-              </enum>\n-            </enumlist>\n-          </description>\n+        <configOption name=\"deny\" default=\"\">\n+          <synopsis>An IP or subnet to deny</synopsis>\n         </configOption>\n       </configObject>\n     </configFile>\n   </configInfo>\n-  <module language=\"en_US\" name=\"res_fax\">\n-    <conflict>app_fax</conflict>\n-    <support_level>core</support_level>\n-  </module>\n-  <application name=\"ReceiveFAX\" language=\"en_US\" module=\"res_fax\">\n-    <synopsis>Receive a FAX and save as a TIFF/F file.</synopsis>\n-    <syntax>\n-      <parameter name=\"filename\" required=\"true\"/>\n-      <parameter name=\"options\">\n-        <optionlist>\n-          <option name=\"d\">\n-            <para>Enable FAX debugging.</para>\n-          </option>\n-          <option name=\"f\">\n-            <para>Allow audio fallback FAX transfer on T.38 capable channels.</para>\n-          </option>\n-          <option name=\"F\">\n-            <para>Force usage of audio mode on T.38 capable channels.</para>\n-          </option>\n-          <option name=\"s\">\n-            <para>Send progress Manager events (overrides statusevents setting in res_fax.conf).</para>\n-          </option>\n-        </optionlist>\n-      </parameter>\n-    </syntax>\n-    <description>\n-      <para>This application is provided by res_fax, which is a FAX technology agnostic module\n- \t\t\tthat utilizes FAX technology resource modules to complete a FAX transmission.</para>\n-      <para>Session arguments can be set by the FAXOPT function and to check results of the ReceiveFax() application.</para>\n-    </description>\n-    <see-also>\n-      <ref type=\"function\">FAXOPT</ref>\n-    </see-also>\n-  </application>\n-  <application name=\"SendFAX\" language=\"en_US\" module=\"res_fax\">\n-    <synopsis>Sends a specified TIFF/F file as a FAX.</synopsis>\n+  <function name=\"STIR_SHAKEN\" language=\"en_US\">\n+    <synopsis>Gets the number of STIR/SHAKEN results or a specific STIR/SHAKEN value from a result on the channel.</synopsis>\n     <syntax>\n-      <parameter name=\"filename\" required=\"true\" argsep=\"&amp;\">\n-        <argument name=\"filename2\" multiple=\"true\">\n-          <para>TIFF file to send as a FAX.</para>\n-        </argument>\n+      <parameter name=\"index\" required=\"true\">\n+        <para>The index of the STIR/SHAKEN result to get. If only 'count' is passed in, gets the number of STIR/SHAKEN results instead.</para>\n       </parameter>\n-      <parameter name=\"options\">\n-        <optionlist>\n-          <option name=\"d\">\n-            <para>Enable FAX debugging.</para>\n-          </option>\n-          <option name=\"f\">\n-            <para>Allow audio fallback FAX transfer on T.38 capable channels.</para>\n-          </option>\n-          <option name=\"F\">\n-            <para>Force usage of audio mode on T.38 capable channels.</para>\n-          </option>\n-          <option name=\"s\">\n-            <para>Send progress Manager events (overrides statusevents setting in res_fax.conf).</para>\n-          </option>\n-          <option name=\"z\">\n-            <para>Initiate a T.38 reinvite on the channel if the remote end does not.</para>\n-          </option>\n-        </optionlist>\n+      <parameter name=\"value\" required=\"false\">\n+        <para>The value to get from the STIR/SHAKEN result. Only used when an index is passed in (instead of 'count'). Allowable values:</para>\n+        <enumlist>\n+          <enum name=\"identity\"/>\n+          <enum name=\"attestation\"/>\n+          <enum name=\"verify_result\"/>\n+        </enumlist>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>This application is provided by res_fax, which is a FAX technology agnostic module\n- \t\t\tthat utilizes FAX technology resource modules to complete a FAX transmission.</para>\n-      <para>Session arguments can be set by the FAXOPT function and to check results of the SendFax() application.</para>\n+      <para>This function will either return the number of STIR/SHAKEN identities, or return information on the specified identity.\n+\t\t\tTo get the number of identities, just pass 'count' as the only parameter to the function. If you want to get information on a\n+\t\t\tspecific STIR/SHAKEN identity, you can get the number of identities and then pass an index as the first parameter and one of\n+\t\t\tthe values you would like to retrieve as the second parameter.</para>\n+      <example title=\"Get count and retrieve value\">same =&gt; n,NoOp(Number of STIR/SHAKEN identities: ${STIR_SHAKEN(count)})\n+\t\t\tsame =&gt; n,NoOp(Identity ${STIR_SHAKEN(0, identity)} has attestation level ${STIR_SHAKEN(0, attestation)})</example>\n     </description>\n-    <see-also>\n-      <ref type=\"function\">FAXOPT</ref>\n-    </see-also>\n-  </application>\n-  <function name=\"FAXOPT\" language=\"en_US\" module=\"res_fax\">\n-    <synopsis>Gets/sets various pieces of information about a fax session.</synopsis>\n+  </function>\n+  <module language=\"en_US\" name=\"res_stun_monitor\">\n+    <support_level>core</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"res_mutestream\">\n+    <support_level>core</support_level>\n+  </module>\n+  <function name=\"MUTEAUDIO\" language=\"en_US\">\n+    <synopsis>Muting audio streams in the channel</synopsis>\n     <syntax>\n-      <parameter name=\"item\" required=\"true\">\n+      <parameter name=\"direction\" required=\"true\">\n+        <para>Must be one of</para>\n         <enumlist>\n-          <enum name=\"ecm\">\n-            <para>R/W Error Correction Mode (ECM) enable with 'yes', disable with 'no'.</para>\n-          </enum>\n-          <enum name=\"error\">\n-            <para>R/O FAX transmission error code upon failure.</para>\n-          </enum>\n-          <enum name=\"filename\">\n-            <para>R/O Filename of the first file of the FAX transmission.</para>\n-          </enum>\n-          <enum name=\"filenames\">\n-            <para>R/O Filenames of all of the files in the FAX transmission (comma separated).</para>\n-          </enum>\n-          <enum name=\"headerinfo\">\n-            <para>R/W FAX header information.</para>\n-          </enum>\n-          <enum name=\"localstationid\">\n-            <para>R/W Local Station Identification.</para>\n-          </enum>\n-          <enum name=\"minrate\">\n-            <para>R/W Minimum transfer rate set before transmission.</para>\n-          </enum>\n-          <enum name=\"maxrate\">\n-            <para>R/W Maximum transfer rate set before transmission.</para>\n-          </enum>\n-          <enum name=\"modem\">\n-            <para>R/W Modem type (v17/v27/v29).</para>\n-          </enum>\n-          <enum name=\"gateway\">\n-            <para>R/W T38 fax gateway, with optional fax activity timeout in seconds (yes[,timeout]/no)</para>\n-          </enum>\n-          <enum name=\"faxdetect\">\n-            <para>R/W Enable FAX detect with optional timeout in seconds (yes,t38,cng[,timeout]/no)</para>\n-          </enum>\n-          <enum name=\"pages\">\n-            <para>R/O Number of pages transferred.</para>\n-          </enum>\n-          <enum name=\"rate\">\n-            <para>R/O Negotiated transmission rate.</para>\n-          </enum>\n-          <enum name=\"remotestationid\">\n-            <para>R/O Remote Station Identification after transmission.</para>\n-          </enum>\n-          <enum name=\"resolution\">\n-            <para>R/O Negotiated image resolution after transmission.</para>\n-          </enum>\n-          <enum name=\"sessionid\">\n-            <para>R/O Session ID of the FAX transmission.</para>\n-          </enum>\n-          <enum name=\"status\">\n-            <para>R/O Result Status of the FAX transmission.</para>\n-          </enum>\n-          <enum name=\"statusstr\">\n-            <para>R/O Verbose Result Status of the FAX transmission.</para>\n+          <enum name=\"in\">\n+            <para>Inbound stream (to the PBX)</para>\n           </enum>\n-          <enum name=\"t38timeout\">\n-            <para>R/W The timeout used for T.38 negotiation.</para>\n+          <enum name=\"out\">\n+            <para>Outbound stream (from the PBX)</para>\n           </enum>\n-          <enum name=\"negotiate_both\">\n-            <para>R/W Upon v21 detection allow gateway to send negotiation requests to both T.38 endpoints, and do not wait on the &quot;other&quot; side to initiate (yes|no)</para>\n+          <enum name=\"all\">\n+            <para>Both streams</para>\n           </enum>\n         </enumlist>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>\n-        FAXOPT can be used to override the settings for a FAX session listed in\n-        <filename>res_fax.conf</filename>\n-        ,\n-\t\t   \tit can also be used to retrieve information about a FAX session that has finished eg. pages/status.\n-      </para>\n+      <para>The MUTEAUDIO function can be used to mute inbound (to the PBX) or outbound audio in a call.</para>\n+      <example title=\"Mute incoming audio\">exten =&gt; s,1,Set(MUTEAUDIO(in)=on)</example>\n+      <example title=\"Do not mute incoming audio\">exten =&gt; s,1,Set(MUTEAUDIO(in)=off)</example>\n     </description>\n-    <see-also>\n-      <ref type=\"application\">ReceiveFax</ref>\n-      <ref type=\"application\">SendFax</ref>\n-    </see-also>\n   </function>\n-  <manager name=\"FAXSessions\" language=\"en_US\">\n-    <synopsis>Lists active FAX sessions</synopsis>\n-    <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-    </syntax>\n-    <description>\n-      <para>Will generate a series of FAXSession events with information about each FAXSession. Closes with\n-\t\t\ta FAXSessionsComplete event which includes a count of the included FAX sessions. This action works in\n-\t\t\tthe same manner as the CLI command 'fax show sessions'</para>\n-    </description>\n-  </manager>\n-  <managerEvent language=\"en_US\" name=\"FAXSessionsEntry\">\n-    <managerEventInstance class=\"EVENT_FLAG_REPORTING\">\n-      <synopsis>A single list item for the FAXSessions AMI command</synopsis>\n-      <syntax>\n-        <parameter name=\"ActionID\" required=\"false\"/>\n-        <parameter name=\"Channel\">\n-          <para>Name of the channel responsible for the FAX session</para>\n-        </parameter>\n-        <parameter name=\"Technology\">\n-          <para>The FAX technology that the FAX session is using</para>\n-        </parameter>\n-        <parameter name=\"SessionNumber\">\n-          <para>The numerical identifier for this particular session</para>\n-        </parameter>\n-        <parameter name=\"SessionType\">\n-          <para>FAX session passthru/relay type</para>\n-          <enumlist>\n-            <enum name=\"G.711\"/>\n-            <enum name=\"T.38\"/>\n-          </enumlist>\n-        </parameter>\n-        <parameter name=\"Operation\">\n-          <para>FAX session operation type</para>\n-          <enumlist>\n-            <enum name=\"gateway\"/>\n-            <enum name=\"V.21\"/>\n-            <enum name=\"send\"/>\n-            <enum name=\"receive\"/>\n-            <enum name=\"none\"/>\n-          </enumlist>\n-        </parameter>\n-        <parameter name=\"State\">\n-          <para>Current state of the FAX session</para>\n-          <enumlist>\n-            <enum name=\"Uninitialized\"/>\n-            <enum name=\"Initialized\"/>\n-            <enum name=\"Open\"/>\n-            <enum name=\"Active\"/>\n-            <enum name=\"Complete\"/>\n-            <enum name=\"Reserved\"/>\n-            <enum name=\"Inactive\"/>\n-            <enum name=\"Unknown\"/>\n-          </enumlist>\n-        </parameter>\n-        <parameter name=\"Files\">\n-          <para>File or list of files associated with this FAX session</para>\n-        </parameter>\n-      </syntax>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <managerEvent language=\"en_US\" name=\"FAXSessionsComplete\">\n-    <managerEventInstance class=\"EVENT_FLAG_CALL\">\n-      <synopsis>Raised when all FAXSession events are completed for a FAXSessions command</synopsis>\n-      <syntax>\n-        <parameter name=\"ActionID\" required=\"false\"/>\n-        <parameter name=\"Total\">\n-          <para>Count of FAXSession events sent in response to FAXSessions action</para>\n-        </parameter>\n-      </syntax>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <manager name=\"FAXSession\" language=\"en_US\">\n-    <synopsis>Responds with a detailed description of a single FAX session</synopsis>\n+  <manager name=\"MuteAudio\" language=\"en_US\">\n+    <synopsis>Mute an audio stream.</synopsis>\n     <syntax>\n       <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-      <parameter name=\"SessionNumber\" required=\"true\">\n-        <para>The session ID of the fax the user is interested in.</para>\n+      <parameter name=\"Channel\" required=\"true\">\n+        <para>The channel you want to mute.</para>\n+      </parameter>\n+      <parameter name=\"Direction\" required=\"true\">\n+        <enumlist>\n+          <enum name=\"in\">\n+            <para>Set muting on inbound audio stream. (to the PBX)</para>\n+          </enum>\n+          <enum name=\"out\">\n+            <para>Set muting on outbound audio stream. (from the PBX)</para>\n+          </enum>\n+          <enum name=\"all\">\n+            <para>Set muting on inbound and outbound audio streams.</para>\n+          </enum>\n+        </enumlist>\n+      </parameter>\n+      <parameter name=\"State\" required=\"true\">\n+        <enumlist>\n+          <enum name=\"on\">\n+            <para>Turn muting on.</para>\n+          </enum>\n+          <enum name=\"off\">\n+            <para>Turn muting off.</para>\n+          </enum>\n+        </enumlist>\n       </parameter>\n     </syntax>\n     <description>\n-      <para>Provides details about a specific FAX session. The response will include a common subset of\n-\t\t\tthe output from the CLI command 'fax show session &lt;session_number&gt;' for each technology. If the\n-\t\t\tFAX technolgy used by this session does not include a handler for FAXSession, then this action\n-\t\t\twill fail.</para>\n-    </description>\n-  </manager>\n-  <managerEvent language=\"en_US\" name=\"FAXSession\">\n-    <managerEventInstance class=\"EVENT_FLAG_REPORTING\">\n-      <synopsis>Raised in response to FAXSession manager command</synopsis>\n-      <syntax>\n-        <parameter name=\"ActionID\" required=\"false\"/>\n-        <parameter name=\"SessionNumber\">\n-          <para>The numerical identifier for this particular session</para>\n-        </parameter>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FAXSessionsEntry']/managerEventInstance/syntax/parameter[@name='Operation'])\"/>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='FAXSessionsEntry']/managerEventInstance/syntax/parameter[@name='State'])\"/>\n-        <parameter name=\"ErrorCorrectionMode\" required=\"false\">\n-          <para>Whether error correcting mode is enabled for the FAX session. This field is not\n-\t\t\t\t\tincluded when operation is 'V.21 Detect' or if operation is 'gateway' and state is\n-\t\t\t\t\t'Uninitialized'</para>\n-          <enumlist>\n-            <enum name=\"yes\"/>\n-            <enum name=\"no\"/>\n-          </enumlist>\n-        </parameter>\n-        <parameter name=\"DataRate\" required=\"false\">\n-          <para>Bit rate of the FAX. This field is not included when operation is 'V.21 Detect' or\n-\t\t\t\t\tif operation is 'gateway' and state is 'Uninitialized'.</para>\n-        </parameter>\n-        <parameter name=\"ImageResolution\" required=\"false\">\n-          <para>Resolution of each page of the FAX. Will be in the format of X_RESxY_RES. This field\n-\t\t\t\t\tis not included if the operation is anything other than Receive/Transmit.</para>\n-        </parameter>\n-        <parameter name=\"PageNumber\" required=\"false\">\n-          <para>Current number of pages transferred during this FAX session. May change as the FAX\n-\t\t\t\t\tprogresses. This field is not included when operation is 'V.21 Detect' or if operation is\n-\t\t\t\t\t'gateway' and state is 'Uninitialized'.</para>\n-        </parameter>\n-        <parameter name=\"FileName\" required=\"false\">\n-          <para>Filename of the image being sent/received for this FAX session. This field is not\n-\t\t\t\t\tincluded if Operation isn't 'send' or 'receive'.</para>\n-        </parameter>\n-        <parameter name=\"PagesTransmitted\" required=\"false\">\n-          <para>Total number of pages sent during this session. This field is not included if\n-\t\t\t\t\tOperation isn't 'send' or 'receive'. Will always be 0 for 'receive'.</para>\n-        </parameter>\n-        <parameter name=\"PagesReceived\" required=\"false\">\n-          <para>Total number of pages received during this session. This field is not included if\n-\t\t\t\t\tOperation is not 'send' or 'receive'. Will be 0 for 'send'.</para>\n-        </parameter>\n-        <parameter name=\"TotalBadLines\" required=\"false\">\n-          <para>Total number of bad lines sent/received during this session. This field is not\n-\t\t\t\t\tincluded if Operation is not 'send' or 'received'.</para>\n-        </parameter>\n-      </syntax>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <manager name=\"FAXStats\" language=\"en_US\">\n-    <synopsis>Responds with fax statistics</synopsis>\n-    <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-    </syntax>\n-    <description>\n-      <para>Provides FAX statistics including the number of active sessions, reserved sessions, completed\n-\t\t\tsessions, failed sessions, and the number of receive/transmit attempts. This command provides all\n-\t\t\tof the non-technology specific information provided by the CLI command 'fax show stats'</para>\n+      <para>Mute an incoming or outgoing audio stream on a channel.</para>\n     </description>\n   </manager>\n-  <managerEvent language=\"en_US\" name=\"FAXStats\">\n-    <managerEventInstance class=\"EVENT_FLAG_REPORTING\">\n-      <synopsis>Raised in response to FAXStats manager command</synopsis>\n-      <syntax>\n-        <parameter name=\"ActionID\" required=\"false\"/>\n-        <parameter name=\"CurrentSessions\" required=\"true\">\n-          <para>Number of active FAX sessions</para>\n-        </parameter>\n-        <parameter name=\"ReservedSessions\" required=\"true\">\n-          <para>Number of reserved FAX sessions</para>\n-        </parameter>\n-        <parameter name=\"TransmitAttempts\" required=\"true\">\n-          <para>Total FAX sessions for which Asterisk is/was the transmitter</para>\n-        </parameter>\n-        <parameter name=\"ReceiveAttempts\" required=\"true\">\n-          <para>Total FAX sessions for which Asterisk is/was the recipient</para>\n-        </parameter>\n-        <parameter name=\"CompletedFAXes\" required=\"true\">\n-          <para>Total FAX sessions which have been completed successfully</para>\n-        </parameter>\n-        <parameter name=\"FailedFAXes\" required=\"true\">\n-          <para>Total FAX sessions which failed to complete successfully</para>\n-        </parameter>\n-      </syntax>\n-    </managerEventInstance>\n-  </managerEvent>\n-  <module language=\"en_US\" name=\"res_resolver_unbound\">\n-    <depend>unbound</depend>\n-    <support_level>core</support_level>\n-  </module>\n-  <configInfo name=\"res_resolver_unbound\" language=\"en_US\">\n-    <configFile name=\"resolver_unbound.conf\">\n-      <configObject name=\"general\">\n-        <synopsis>General options for res_resolver_unbound</synopsis>\n-        <configOption name=\"hosts\">\n-          <synopsis>Full path to an optional hosts file</synopsis>\n-          <description>\n-            <para>Hosts specified in a hosts file will be resolved within the resolver itself. If a value\n-\t\t\t\t\tof system is provided the system-specific file will be used.</para>\n-          </description>\n-        </configOption>\n-        <configOption name=\"resolv\">\n-          <synopsis>Full path to an optional resolv.conf file</synopsis>\n-          <description>\n-            <para>The resolv.conf file specifies the nameservers to contact when resolving queries. If a\n-\t\t\t\t\tvalue of system is provided the system-specific file will be used. If provided alongside explicit nameservers the\n-\t\t\t\t\tnameservers contained within the resolv.conf file will be used after all others.</para>\n-          </description>\n-        </configOption>\n-        <configOption name=\"nameserver\">\n-          <synopsis>Nameserver to use for queries</synopsis>\n-          <description>\n-            <para>An explicit nameserver can be specified which is used for resolving queries. If multiple\n-\t\t\t\t\tnameserver lines are specified the first will be the primary with failover occurring, in order, to the other\n-\t\t\t\t\tnameservers as backups. If provided alongside a resolv.conf file the nameservers explicitly specified will be\n-\t\t\t\t\tused before all others.</para>\n-          </description>\n-        </configOption>\n-        <configOption name=\"debug\">\n-          <synopsis>Unbound debug level</synopsis>\n-          <description>\n-            <para>The debugging level for the unbound resolver. While there is no explicit range generally\n-\t\t\t\t\tthe higher the number the more debug is output.</para>\n-          </description>\n-        </configOption>\n-        <configOption name=\"ta_file\">\n-          <synopsis>Trust anchor file</synopsis>\n-          <description>\n-            <para>Full path to a file with DS and DNSKEY records in zone file format. This file is provided\n-\t\t\t\t\tto unbound and is used as a source for trust anchors.</para>\n-          </description>\n-        </configOption>\n-      </configObject>\n-    </configFile>\n-  </configInfo>\n-  <module language=\"en_US\" name=\"res_manager_presencestate\">\n+  <module language=\"en_US\" name=\"res_stasis_answer\">\n+    <depend type=\"module\">res_stasis</depend>\n     <support_level>core</support_level>\n   </module>\n-  <manager name=\"PresenceStateList\" language=\"en_US\">\n-    <synopsis>List the current known presence states.</synopsis>\n-    <syntax>\n-      <xi:include xpointer=\"xpointer(/docs/manager[@name='Login']/syntax/parameter[@name='ActionID'])\"/>\n-    </syntax>\n-    <description>\n-      <para>\n-        This will list out all known presence states in a\n-\t\t\tsequence of\n-        <replaceable>PresenceStateChange</replaceable>\n-        events.\n-\t\t\tWhen finished, a\n-        <replaceable>PresenceStateListComplete</replaceable>\n-        event\n-\t\t\twill be emitted.\n-      </para>\n-    </description>\n-    <see-also>\n-      <ref type=\"manager\">PresenceState</ref>\n-      <ref type=\"managerEvent\">PresenceStatus</ref>\n-      <ref type=\"function\">PRESENCE_STATE</ref>\n-    </see-also>\n-    <responses>\n-      <list-elements>\n-        <xi:include xpointer=\"xpointer(/docs/managerEvent[@name='PresenceStateChange'])\"/>\n-      </list-elements>\n-      <managerEvent name=\"PresenceStateListComplete\" language=\"en_US\">\n-        <managerEventInstance class=\"EVENT_FLAG_COMMAND\">\n-          <synopsis>Indicates the end of the list the current known extension states.</synopsis>\n-          <syntax>\n-            <parameter name=\"EventList\">\n-              <para>Conveys the status of the event list.</para>\n-            </parameter>\n-            <parameter name=\"ListItems\">\n-              <para>Conveys the number of statuses reported.</para>\n-            </parameter>\n-          </syntax>\n-        </managerEventInstance>\n-      </managerEvent>\n-    </responses>\n-  </manager>\n-  <module language=\"en_US\" name=\"res_pjsip_endpoint_identifier_anonymous\">\n+  <module language=\"en_US\" name=\"res_pjsip_refer\">\n     <depend>pjproject</depend>\n     <depend>res_pjsip</depend>\n+    <depend>res_pjsip_session</depend>\n+    <depend>res_pjsip_pubsub</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"res_pjsip_sips_contact\">\n-    <depend>pjproject</depend>\n-    <depend>res_pjsip</depend>\n-    <support_level>core</support_level>\n+  <module language=\"en_US\" name=\"pval\">\n+    <support_level>extended</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"res_pjsip_outbound_authenticator_digest\">\n-    <depend>pjproject</depend>\n-    <depend>res_pjsip</depend>\n+  <module language=\"en_US\" name=\"res_sorcery_astdb\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"res_http_post\">\n-    <depend>gmime</depend>\n-    <support_level>core</support_level>\n+  <module language=\"en_US\" name=\"res_cliexec\">\n+    <defaultenabled>no</defaultenabled>\n+    <support_level>extended</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"res_timing_dahdi\">\n-    <depend>dahdi</depend>\n+  <module language=\"en_US\" name=\"res_geolocation\">\n+    <depend>libxml2</depend>\n+    <depend>libxslt</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"res_pjproject\">\n+  <module language=\"en_US\" name=\"res_pjsip_session\">\n     <depend>pjproject</depend>\n-    <depend>res_sorcery_config</depend>\n+    <depend>res_pjsip</depend>\n     <support_level>core</support_level>\n   </module>\n-  <configInfo name=\"res_pjproject\" language=\"en_US\">\n-    <synopsis>pjproject common configuration</synopsis>\n-    <configFile name=\"pjproject.conf\">\n-      <configObject name=\"startup\">\n-        <synopsis>Asterisk startup time options for PJPROJECT</synopsis>\n-        <description>\n-          <note>\n-            <para>The id of this object, as well as its type, must be\n-\t\t\t\t\t'startup' or it won't be found.</para>\n-          </note>\n-        </description>\n-        <configOption name=\"type\">\n-          <synopsis>Must be of type 'startup'.</synopsis>\n-        </configOption>\n-        <configOption name=\"log_level\" default=\"2\">\n-          <synopsis>Initial maximum pjproject logging level to log.</synopsis>\n-          <description>\n-            <para>Valid values are: 0-6, and default</para>\n-            <note>\n-              <para>This option is needed very early in the startup process\n-\t\t\t\t\t\tso it can only be read from config files because the\n-\t\t\t\t\t\tmodules for other methods have not been loaded yet.</para>\n-            </note>\n-          </description>\n-        </configOption>\n-      </configObject>\n-      <configObject name=\"log_mappings\">\n-        <synopsis>PJPROJECT to Asterisk Log Level Mapping</synopsis>\n-        <description>\n-          <para>Warnings and errors in the pjproject libraries are generally handled\n-\t\t\t\t\tby Asterisk.  In many cases, Asterisk wouldn't even consider them to\n-\t\t\t\t\tbe warnings or errors so the messages emitted by pjproject directly\n-\t\t\t\t\tare either superfluous or misleading.  The 'log_mappings'\n-\t\t\t\t\tobject allows mapping the pjproject levels to Asterisk levels, or nothing.</para>\n-          <note>\n-            <para>The id of this object, as well as its type, must be\n-\t\t\t\t\t'log_mappings' or it won't be found.</para>\n-          </note>\n-        </description>\n-        <configOption name=\"type\">\n-          <synopsis>Must be of type 'log_mappings'.</synopsis>\n-        </configOption>\n-        <configOption name=\"asterisk_error\" default=\"0,1\">\n-          <synopsis>A comma separated list of pjproject log levels to map to Asterisk LOG_ERROR.</synopsis>\n-        </configOption>\n-        <configOption name=\"asterisk_warning\" default=\"2\">\n-          <synopsis>A comma separated list of pjproject log levels to map to Asterisk LOG_WARNING.</synopsis>\n-        </configOption>\n-        <configOption name=\"asterisk_notice\" default=\"\">\n-          <synopsis>A comma separated list of pjproject log levels to map to Asterisk LOG_NOTICE.</synopsis>\n-        </configOption>\n-        <configOption name=\"asterisk_verbose\" default=\"\">\n-          <synopsis>A comma separated list of pjproject log levels to map to Asterisk LOG_VERBOSE.</synopsis>\n-        </configOption>\n-        <configOption name=\"asterisk_debug\" default=\"3,4\">\n-          <synopsis>A comma separated list of pjproject log levels to map to Asterisk LOG_DEBUG.</synopsis>\n-        </configOption>\n-        <configOption name=\"asterisk_trace\" default=\"5,6\">\n-          <synopsis>A comma separated list of pjproject log levels to map to Asterisk LOG_TRACE.</synopsis>\n-        </configOption>\n-      </configObject>\n-    </configFile>\n-  </configInfo>\n-  <module language=\"en_US\" name=\"res_stasis_answer\">\n-    <depend type=\"module\">res_stasis</depend>\n+  <module language=\"en_US\" name=\"res_http_websocket\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"res_stasis\">\n+  <module language=\"en_US\" name=\"res_format_attr_silk\">\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"res_sorcery_config\">\n+  <module language=\"en_US\" name=\"res_config_sqlite3\">\n+    <depend>sqlite3</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"res_timing_kqueue\">\n-    <depend>kqueue</depend>\n-    <conflict>launchd</conflict>\n-    <support_level>extended</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"res_format_attr_opus\">\n+  <module language=\"en_US\" name=\"res_pjsip_empty_info\">\n+    <depend>pjproject</depend>\n+    <depend>res_pjsip</depend>\n+    <depend>res_pjsip_session</depend>\n     <support_level>core</support_level>\n   </module>\n-  <module language=\"en_US\" name=\"res_format_attr_celt\">\n-    <support_level>core</support_level>\n+  <module language=\"en_US\" name=\"res_timing_pthread\">\n+    <support_level>extended</support_level>\n   </module>\n   <configInfo name=\"res_pjsip\" language=\"en_US\">\n     <synopsis>SIP Resource using PJProject</synopsis>\n     <configFile name=\"pjsip.conf\">\n       <configObject name=\"endpoint\">\n         <synopsis>Endpoint</synopsis>\n         <description>\n@@ -38031,28 +38031,14 @@\n         <enum name=\"-3\">\n           <para>There was an issue specific to the field specified\n \t\t\t(value not valid or field name not found)</para>\n         </enum>\n       </enumlist>\n     </description>\n   </function>\n-  <module language=\"en_US\" name=\"format_mp3\">\n-    <support_level>extended</support_level>\n-  </module>\n-  <module language=\"en_US\" name=\"app_mysql\">\n-    <depend>mysqlclient</depend>\n-    <support_level>deprecated</support_level>\n-    <replacement>func_odbc</replacement>\n-    <deprecated_in>1.8</deprecated_in>\n-    <removed_in>19</removed_in>\n-  </module>\n-  <module language=\"en_US\" name=\"res_config_mysql\">\n-    <depend>mysqlclient</depend>\n-    <support_level>extended</support_level>\n-  </module>\n   <module language=\"en_US\" name=\"chan_ooh323\">\n     <support_level>extended</support_level>\n   </module>\n   <info name=\"CHANNEL\" language=\"en_US\" tech=\"OOH323\">\n     <enumlist>\n       <enum name=\"faxdetect\">\n         <para>R/W Fax Detect</para>\n@@ -38092,19 +38078,33 @@\n \t\t\tbefore the call fails. &quot;Forwards&quot; in this case refers to redirects by phones as well\n \t\t\tas calls to local channels.\n \n \t\t\tNote that this has no relation to the SIP Max-Forwards header.</para>\n       </enum>\n     </enumlist>\n   </info>\n+  <module language=\"en_US\" name=\"chan_mobile\">\n+    <depend>bluetooth</depend>\n+    <support_level>extended</support_level>\n+  </module>\n+  <module language=\"en_US\" name=\"format_mp3\">\n+    <support_level>extended</support_level>\n+  </module>\n   <module language=\"en_US\" name=\"cdr_mysql\">\n     <depend>mysqlclient</depend>\n     <support_level>deprecated</support_level>\n     <replacement>cdr_adaptive_odbc</replacement>\n     <deprecated_in>1.8</deprecated_in>\n     <removed_in>19</removed_in>\n   </module>\n-  <module language=\"en_US\" name=\"chan_mobile\">\n-    <depend>bluetooth</depend>\n+  <module language=\"en_US\" name=\"res_config_mysql\">\n+    <depend>mysqlclient</depend>\n     <support_level>extended</support_level>\n   </module>\n+  <module language=\"en_US\" name=\"app_mysql\">\n+    <depend>mysqlclient</depend>\n+    <support_level>deprecated</support_level>\n+    <replacement>func_odbc</replacement>\n+    <deprecated_in>1.8</deprecated_in>\n+    <removed_in>19</removed_in>\n+  </module>\n </docs>\n"}]}]}]}]}]}