<p>Kevin Harwell <strong>submitted</strong> this change.</p><p><a href="https://gerrit.asterisk.org/c/asterisk/+/17958">View Change</a></p><div style="white-space:pre-wrap">Approvals:
  Joshua Colp: Looks good to me, but someone else must approve
  Kevin Harwell: Looks good to me, approved; Approved for Submit

</div><pre style="font-family: monospace,monospace; white-space: pre-wrap;">documentation: Add since tag to xmldocs DTD<br><br>Adds the since tag to the documentation DTD so<br>that individual applications, functions, etc.<br>can now specify when they were added to Asterisk.<br><br>This tag is added at the individual application,<br>function, etc. level as opposed to at the module<br>level because modules can expand over time as new<br>functionality is added, and granularity only<br>to the module level would generally not be useful.<br><br>This enables the ability to more easily determine<br>when new functionality was added to Asterisk, down<br>to minor version as opposed to just by major version.<br>This makes it easier for users to write more portable<br>dialplan if desired to not use functionality that may<br>not be widely available yet.<br><br>ASTERISK-29896 #close<br><br>Change-Id: Ibbb35c702d8038bdc3fd0a944fbfa69384cc15d5<br>---<br>M apps/app_reload.c<br>M doc/appdocsxml.dtd<br>2 files changed, 14 insertions(+), 5 deletions(-)<br><br></pre><pre style="font-family: monospace,monospace; white-space: pre-wrap;"><span>diff --git a/apps/app_reload.c b/apps/app_reload.c</span><br><span>index 16bcd63..88f234d 100644</span><br><span>--- a/apps/app_reload.c</span><br><span>+++ b/apps/app_reload.c</span><br><span>@@ -39,6 +39,11 @@</span><br><span> </span><br><span> /*** DOCUMENTATION</span><br><span>  <application name="Reload" language="en_US"></span><br><span style="color: hsl(120, 100%, 40%);">+                <since></span><br><span style="color: hsl(120, 100%, 40%);">+                 <version>16.20.0</version></span><br><span style="color: hsl(120, 100%, 40%);">+                        <version>18.6.0</version></span><br><span style="color: hsl(120, 100%, 40%);">+                 <version>19.0.0</version></span><br><span style="color: hsl(120, 100%, 40%);">+         </since></span><br><span>               <synopsis></span><br><span>                     Reloads an Asterisk module, blocking the channel until the reload has completed.</span><br><span>             </synopsis></span><br><span>diff --git a/doc/appdocsxml.dtd b/doc/appdocsxml.dtd</span><br><span>index c311e8d..fbcad6d 100644</span><br><span>--- a/doc/appdocsxml.dtd</span><br><span>+++ b/doc/appdocsxml.dtd</span><br><span>@@ -33,22 +33,22 @@</span><br><span> </span><br><span>   <!ELEMENT removed_in (#PCDATA)></span><br><span> </span><br><span style="color: hsl(0, 100%, 40%);">-  <!ELEMENT application (synopsis?,syntax?,description?,see-also?)></span><br><span style="color: hsl(120, 100%, 40%);">+  <!ELEMENT application (since?,synopsis?,syntax?,description?,see-also?)></span><br><span>   <!ATTLIST application name CDATA #REQUIRED></span><br><span>   <!ATTLIST application language CDATA #REQUIRED></span><br><span>   <!ATTLIST application module CDATA #IMPLIED></span><br><span> </span><br><span style="color: hsl(0, 100%, 40%);">-  <!ELEMENT function (synopsis?,syntax?,description?,see-also?)></span><br><span style="color: hsl(120, 100%, 40%);">+  <!ELEMENT function (since?,synopsis?,syntax?,description?,see-also?)></span><br><span>   <!ATTLIST function name CDATA #REQUIRED></span><br><span>   <!ATTLIST function language CDATA #REQUIRED></span><br><span>   <!ATTLIST function module CDATA #IMPLIED></span><br><span> </span><br><span style="color: hsl(0, 100%, 40%);">-  <!ELEMENT agi (synopsis?,syntax?,description?,see-also?)></span><br><span style="color: hsl(120, 100%, 40%);">+  <!ELEMENT agi (since?,synopsis?,syntax?,description?,see-also?)></span><br><span>   <!ATTLIST agi name CDATA #REQUIRED></span><br><span>   <!ATTLIST agi language CDATA #REQUIRED></span><br><span>   <!ATTLIST agi module CDATA #IMPLIED></span><br><span> </span><br><span style="color: hsl(0, 100%, 40%);">-  <!ELEMENT manager (synopsis?,syntax?,description?,see-also?,responses?)></span><br><span style="color: hsl(120, 100%, 40%);">+  <!ELEMENT manager (since?,synopsis?,syntax?,description?,see-also?,responses?)></span><br><span>   <!ATTLIST manager name CDATA #REQUIRED></span><br><span>   <!ATTLIST manager language CDATA #REQUIRED></span><br><span>   <!ATTLIST manager module CDATA #IMPLIED></span><br><span>@@ -62,7 +62,7 @@</span><br><span>   <!ATTLIST managerEvent language CDATA #REQUIRED></span><br><span>   <!ATTLIST managerEvent module CDATA #IMPLIED></span><br><span> </span><br><span style="color: hsl(0, 100%, 40%);">-  <!ELEMENT managerEventInstance (synopsis?,syntax?,description?,see-also?)*></span><br><span style="color: hsl(120, 100%, 40%);">+  <!ELEMENT managerEventInstance (since?,synopsis?,syntax?,description?,see-also?)*></span><br><span>   <!ATTLIST managerEventInstance class CDATA #REQUIRED></span><br><span> </span><br><span>   <!ELEMENT configInfo (synopsis?,description?,configFile+)></span><br><span>@@ -102,6 +102,10 @@</span><br><span>   <!ATTLIST ref type (application|function|astcli|link|manpage|filename|agi|manager|managerEvent|configOption) #REQUIRED></span><br><span>   <!ATTLIST ref module CDATA #IMPLIED></span><br><span> </span><br><span style="color: hsl(120, 100%, 40%);">+  <!ELEMENT since (version+)></span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span style="color: hsl(120, 100%, 40%);">+  <!ELEMENT version (#PCDATA)></span><br><span style="color: hsl(120, 100%, 40%);">+</span><br><span>   <!ELEMENT synopsis (#PCDATA)></span><br><span> </span><br><span>   <!ELEMENT syntax (parameter|dataType|category|matchInfo|xi:include|channel_snapshot|bridge_snapshot)*></span><br><span></span><br></pre><div style="white-space:pre-wrap"></div><p>To view, visit <a href="https://gerrit.asterisk.org/c/asterisk/+/17958">change 17958</a>. To unsubscribe, or for help writing mail filters, visit <a href="https://gerrit.asterisk.org/settings">settings</a>.</p><div itemscope itemtype="http://schema.org/EmailMessage"><div itemscope itemprop="action" itemtype="http://schema.org/ViewAction"><link itemprop="url" href="https://gerrit.asterisk.org/c/asterisk/+/17958"/><meta itemprop="name" content="View Change"/></div></div>

<div style="display:none"> Gerrit-Project: asterisk </div>
<div style="display:none"> Gerrit-Branch: master </div>
<div style="display:none"> Gerrit-Change-Id: Ibbb35c702d8038bdc3fd0a944fbfa69384cc15d5 </div>
<div style="display:none"> Gerrit-Change-Number: 17958 </div>
<div style="display:none"> Gerrit-PatchSet: 5 </div>
<div style="display:none"> Gerrit-Owner: N A <mail@interlinked.x10host.com> </div>
<div style="display:none"> Gerrit-Reviewer: Friendly Automation </div>
<div style="display:none"> Gerrit-Reviewer: Joshua Colp <jcolp@sangoma.com> </div>
<div style="display:none"> Gerrit-Reviewer: Kevin Harwell <kharwell@digium.com> </div>
<div style="display:none"> Gerrit-Reviewer: Sean Bright <sean@seanbright.com> </div>
<div style="display:none"> Gerrit-MessageType: merged </div>