<p>George Joseph has uploaded this change for <strong>review</strong>.</p><p><a href="https://gerrit.asterisk.org/c/asterisk/+/18014">View Change</a></p><pre style="font-family: monospace,monospace; white-space: pre-wrap;">Makefile: Allow XML documentation to exist outside source files<br><br>Until now, XML documentation had to be in a "c" source file<br>in the top-level of each module directory.  For instance,<br>documentation would be found in res/res_pjsip.c but NOT<br>res/res_pjsip/pjsip_configuration.c.<br><br>With this change, you can now place documentation in any<br>"c" source file AND you can now place it in a separate<br>XML file altogether.  The following are examples of valid<br>locations:<br><br>res/res_pjsip.c<br>res/res_pjsip/pjsip_configuration.c<br>res/res_pjsip/pjsip_doc.xml<br><br>If you place the documentation in an XML file, it must be<br>a fully valid one.  The "configInfo", "manager", "managerEvent",<br>etc. elements that would be in the "c" file should be wrapped<br>properly.  Example for "somemodule.xml":<br><br><?xml version="1.0" encoding="UTF-8"?><br><!DOCTYPE docs SYSTEM "appdocsxml.dtd"><br><docs><br>    <configInfo><br>    ...<br>    </configInfo><br></docs><br><br>It's the "appdocsxml.dtd" that tells the Makefile that this is<br>a documentation XML file and not some other XML file.<br><br>Other than the ".xml" suffix, the name of the file is not<br>significant.<br><br>This change also moves the documentation that was in res_pjsip.c<br>to 2 new xml files in res/res_pjsip:  pjsip_config.xml and<br>pjsip_manager.xml.  This cut the number of lines in res_pjsip.c<br>in half.<br><br>Change-Id: I486c16c0b5a44d7a8870008e10c941fb19b71ade<br>---<br>M Makefile<br>M res/res_pjsip.c<br>A res/res_pjsip/pjsip_config.xml<br>A res/res_pjsip/pjsip_manager.xml<br>4 files changed, 2,939 insertions(+), 2,929 deletions(-)<br><br></pre><pre style="font-family: monospace,monospace; white-space: pre-wrap;">git pull ssh://gerrit.asterisk.org:29418/asterisk refs/changes/14/18014/1</pre><pre style="font-family: monospace,monospace; white-space: pre-wrap;"><span></span><br></pre><p>To view, visit <a href="https://gerrit.asterisk.org/c/asterisk/+/18014">change 18014</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/+/18014"/><meta itemprop="name" content="View Change"/></div></div>

<div style="display:none"> Gerrit-Project: asterisk </div>
<div style="display:none"> Gerrit-Branch: 16 </div>
<div style="display:none"> Gerrit-Change-Id: I486c16c0b5a44d7a8870008e10c941fb19b71ade </div>
<div style="display:none"> Gerrit-Change-Number: 18014 </div>
<div style="display:none"> Gerrit-PatchSet: 1 </div>
<div style="display:none"> Gerrit-Owner: George Joseph <gjoseph@digium.com> </div>
<div style="display:none"> Gerrit-MessageType: newchange </div>