<p>George Joseph has uploaded this change for <strong>review</strong>.</p><p><a href="https://gerrit.asterisk.org/c/asterisk/+/18256">View Change</a></p><pre style="font-family: monospace,monospace; white-space: pre-wrap;">res_geolocation: XML documentation update<br><br>Change-Id: I237a42baa0844bae3c5b4a715389f5ee7009227b<br>---<br>M res/res_geolocation/geoloc_doc.xml<br>1 file changed, 28 insertions(+), 6 deletions(-)<br><br></pre><pre style="font-family: monospace,monospace; white-space: pre-wrap;">git pull ssh://gerrit.asterisk.org:29418/asterisk refs/changes/56/18256/1</pre><pre style="font-family: monospace,monospace; white-space: pre-wrap;"><span>diff --git a/res/res_geolocation/geoloc_doc.xml b/res/res_geolocation/geoloc_doc.xml</span><br><span>index 149baf1..74e13fa 100644</span><br><span>--- a/res/res_geolocation/geoloc_doc.xml</span><br><span>+++ b/res/res_geolocation/geoloc_doc.xml</span><br><span>@@ -18,10 +18,11 @@</span><br><span> <enumlist></span><br><span> <enum name="civicAddress"></span><br><span> <para></span><br><span style="color: hsl(0, 100%, 40%);">- The</span><br><span style="color: hsl(0, 100%, 40%);">- <literal>location_info</literal></span><br><span style="color: hsl(120, 100%, 40%);">+ The <literal>location_info</literal></span><br><span> parameter must contain a comma separated list of IANA codes</span><br><span style="color: hsl(0, 100%, 40%);">- describing the civicAddress of this location.</span><br><span style="color: hsl(120, 100%, 40%);">+ or synonyms describing the civicAddress of this location.</span><br><span style="color: hsl(120, 100%, 40%);">+ The IANA codes and synonyms can be obtained by executing</span><br><span style="color: hsl(120, 100%, 40%);">+ the CLI command <literal>geoloc show civicAddr_mapping</literal>.</span><br><span> </para></span><br><span> </enum></span><br><span> <enum name="GML"></span><br><span>@@ -46,20 +47,41 @@</span><br><span> <description></span><br><span> <para>The contents of this parameter are specific to the</span><br><span> location <literal>format</literal>.</para></span><br><span style="color: hsl(120, 100%, 40%);">+ <enumlist></span><br><span style="color: hsl(120, 100%, 40%);">+ <enum name="civicAddress"></span><br><span style="color: hsl(120, 100%, 40%);">+ <para></span><br><span style="color: hsl(120, 100%, 40%);">+ location_info = country=US,A1="New York",city_district=Manhattan,</span><br><span style="color: hsl(120, 100%, 40%);">+ A3="New York", house_number=1633, street=46th, street_suffix = Street,</span><br><span style="color: hsl(120, 100%, 40%);">+ postal_code=10222,floor=20,room=20A2</span><br><span style="color: hsl(120, 100%, 40%);">+ </para></span><br><span style="color: hsl(120, 100%, 40%);">+ </enum></span><br><span style="color: hsl(120, 100%, 40%);">+ <enum name="GML"></span><br><span style="color: hsl(120, 100%, 40%);">+ <para></span><br><span style="color: hsl(120, 100%, 40%);">+ location_info = Shape=Sphere, pos3d="39.12345 -105.98766 1920", radius=200</span><br><span style="color: hsl(120, 100%, 40%);">+ </para></span><br><span style="color: hsl(120, 100%, 40%);">+ </enum></span><br><span style="color: hsl(120, 100%, 40%);">+ <enum name="URI"></span><br><span style="color: hsl(120, 100%, 40%);">+ <para></span><br><span style="color: hsl(120, 100%, 40%);">+ location_info = URI=https:/something.com?exten=${EXTEN}</span><br><span style="color: hsl(120, 100%, 40%);">+ </para></span><br><span style="color: hsl(120, 100%, 40%);">+ </enum></span><br><span style="color: hsl(120, 100%, 40%);">+ </enumlist></span><br><span> </description></span><br><span> </configOption></span><br><span> <configOption name="location_source" default=""></span><br><span> <synopsis>Fully qualified host name</synopsis></span><br><span> <description></span><br><span style="color: hsl(0, 100%, 40%);">- <para>This parameter isn't required but if provides, RFC8787 says it MUST be a fully</span><br><span style="color: hsl(0, 100%, 40%);">- qualified host name. IP addresses are specifically NOT allowed.</para></span><br><span style="color: hsl(120, 100%, 40%);">+ <para>This parameter isn't required but if provided, RFC8787 says it MUST be a fully</span><br><span style="color: hsl(120, 100%, 40%);">+ qualified host name. IP addresses are specifically NOT allowed. The value will be placed</span><br><span style="color: hsl(120, 100%, 40%);">+ in a <literal>loc-src</literal> parameter appended to the URI in the <literal></span><br><span style="color: hsl(120, 100%, 40%);">+ Geolocation</literal> header.</para></span><br><span> </description></span><br><span> </configOption></span><br><span> <configOption name="method" default=""></span><br><span> <synopsis>Location determination method</synopsis></span><br><span> <description></span><br><span> <para>This is a rarely used field in the specification that would</span><br><span style="color: hsl(0, 100%, 40%);">- indicate teh method used to determine the location. It could be</span><br><span style="color: hsl(120, 100%, 40%);">+ indicate the method used to determine the location. It could be</span><br><span> something like "GPS" or "802.11". Its usage and values should be</span><br><span> pre-negotiated with any recipients.</para></span><br><span> </description></span><br><span></span><br></pre><p>To view, visit <a href="https://gerrit.asterisk.org/c/asterisk/+/18256">change 18256</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/+/18256"/><meta itemprop="name" content="View Change"/></div></div>
<div style="display:none"> Gerrit-Project: asterisk </div>
<div style="display:none"> Gerrit-Branch: development/16/geolocation </div>
<div style="display:none"> Gerrit-Change-Id: I237a42baa0844bae3c5b4a715389f5ee7009227b </div>
<div style="display:none"> Gerrit-Change-Number: 18256 </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>