<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>