deploy: 85aff44

ref/api/url.html

@@ -229,16 +229,16 @@ <h1 id="urls"><a class="header" href="#urls">URLs</a></h1>
 that are not part of the IETF standards.</p>
 <h2 id="url-structure"><a class="header" href="#url-structure">URL Structure</a></h2>
 <pre><code class="language-c">typedef struct nng_url {
-    char *u_rawurl;
-    char *u_scheme;
-    char *u_userinfo;
-    char *u_host;
-    char *u_hostname;
-    char *u_port;
-    char *u_path;
-    char *u_query;
-    char *u_fragment;
-    char *u_requri;
+    char       *u_rawurl;
+    const char *u_scheme;
+    char       *u_userinfo;
+    char       *u_host;
+    char       *u_hostname;
+    uint16_t   u_port;
+    char       *u_path;
+    char       *u_query;
+    char       *u_fragment;
+    char       *u_requri;
 } nng_url;
 </code></pre>
 <h3 id="url-fields"><a class="header" href="#url-fields">URL Fields</a></h3>
@@ -251,7 +251,7 @@ <h3 id="url-fields"><a class="header" href="#url-fields">URL Fields</a></h3>
 <li><code>u_userinfo</code>: This username and password if supplied in the URL string. Will be <code>NULL</code> when not present.</li>
 <li><code>u_host</code>: The full host part of the URL, including the port if present (separated by a colon.)</li>
 <li><code>u_hostname</code>: The name of the host, and may be the empty string in some cases.</li>
-<li><code>u_port</code>: The port. May be empty if irrelevant or not specified.</li>
+<li><code>u_port</code>: The port. May be zero if irrelevant or not specified.</li>
 <li><code>u_path</code>: The path, typically used with HTTP or WebSockets. Will be empty string if not specified.</li>
 <li><code>u_query</code>: The query info (typically following <code>?</code> in the URL.) Will be <code>NULL</code> if not present.</li>
 <li><code>u_fragment</code>: This is used for specifying an anchor, the part after <code>#</code> in a URL. Will be <code>NULL</code> if not present.</li>

ref/migrate/nng1.html

@@ -344,6 +344,12 @@ <h2 id="statistics-use-constified-pointers"><a class="header" href="#statistics-
 <p>A number of the <a href="/api/stats.html">statistics</a> functions take, or return, <code>const nng_stat *</code> instead
 of plain <code>nng_stat *</code>. The ABI has not changed, but it may be necessary to declare
 certain methods variables <code>const</code> to avoid warnings about misuse of <code>const</code>.</p>
+<h2 id="url-structure-members"><a class="header" href="#url-structure-members">Url Structure Members</a></h2>
+<p>The details of <a href="/api/url.html#url-structure"><code>nng_url</code></a> have changed as follows:</p>
+<ul>
+<li><code>u_port</code> is no longer a string, but a <code>uint16_t</code></li>
+<li><code>u_scheme</code> is a const char *</li>
+</ul>
 <!-- Symbol cross reference -->
 <!-- Macros -->
 <!-- Protocols -->

ref/print.html

@@ -1530,16 +1530,16 @@ <h1 id="urls"><a class="header" href="#urls">URLs</a></h1>
 that are not part of the IETF standards.</p>
 <h2 id="url-structure"><a class="header" href="#url-structure">URL Structure</a></h2>
 <pre><code class="language-c">typedef struct nng_url {
-    char *u_rawurl;
-    char *u_scheme;
-    char *u_userinfo;
-    char *u_host;
-    char *u_hostname;
-    char *u_port;
-    char *u_path;
-    char *u_query;
-    char *u_fragment;
-    char *u_requri;
+    char       *u_rawurl;
+    const char *u_scheme;
+    char       *u_userinfo;
+    char       *u_host;
+    char       *u_hostname;
+    uint16_t   u_port;
+    char       *u_path;
+    char       *u_query;
+    char       *u_fragment;
+    char       *u_requri;
 } nng_url;
 </code></pre>
 <h3 id="url-fields"><a class="header" href="#url-fields">URL Fields</a></h3>
@@ -1552,7 +1552,7 @@ <h3 id="url-fields"><a class="header" href="#url-fields">URL Fields</a></h3>
 <li><code>u_userinfo</code>: This username and password if supplied in the URL string. Will be <code>NULL</code> when not present.</li>
 <li><code>u_host</code>: The full host part of the URL, including the port if present (separated by a colon.)</li>
 <li><code>u_hostname</code>: The name of the host, and may be the empty string in some cases.</li>
-<li><code>u_port</code>: The port. May be empty if irrelevant or not specified.</li>
+<li><code>u_port</code>: The port. May be zero if irrelevant or not specified.</li>
 <li><code>u_path</code>: The path, typically used with HTTP or WebSockets. Will be empty string if not specified.</li>
 <li><code>u_query</code>: The query info (typically following <code>?</code> in the URL.) Will be <code>NULL</code> if not present.</li>
 <li><code>u_fragment</code>: This is used for specifying an anchor, the part after <code>#</code> in a URL. Will be <code>NULL</code> if not present.</li>
@@ -5677,6 +5677,12 @@ <h2 id="statistics-use-constified-pointers"><a class="header" href="#statistics-
 <p>A number of the <a href="migrate//api/stats.html">statistics</a> functions take, or return, <code>const nng_stat *</code> instead
 of plain <code>nng_stat *</code>. The ABI has not changed, but it may be necessary to declare
 certain methods variables <code>const</code> to avoid warnings about misuse of <code>const</code>.</p>
+<h2 id="url-structure-members"><a class="header" href="#url-structure-members">Url Structure Members</a></h2>
+<p>The details of <a href="migrate//api/url.html#url-structure"><code>nng_url</code></a> have changed as follows:</p>
+<ul>
+<li><code>u_port</code> is no longer a string, but a <code>uint16_t</code></li>
+<li><code>u_scheme</code> is a const char *</li>
+</ul>
 <!-- Symbol cross reference -->
 <!-- Macros -->
 <!-- Protocols -->