From a1d9a36f2746250d8ee9ec51645f917f42bb1687 Mon Sep 17 00:00:00 2001
From: gdamore <gdamore@users.noreply.github.com>
Date: Wed, 1 Jan 2025 21:32:27 +0000
Subject: deploy: 8294f8993d10385e8470ce8270a8bf64047b8b07

---
 ref/migrate/nng1.html | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

(limited to 'ref/migrate/nng1.html')

diff --git a/ref/migrate/nng1.html b/ref/migrate/nng1.html
index 4dac6c5e..925351a6 100644
--- a/ref/migrate/nng1.html
+++ b/ref/migrate/nng1.html
@@ -233,6 +233,24 @@ This is done using the <a href="/api/init.html#initialization"><code>nng_init</c
 <p>The <code>nng_close</code> function has been renamed to <a href="/api/sock.html#closing-a-socket"><code>nng_socket_close</code></a> to make it clearer that
 the object being closed is a socket. A compatible <code>nng_close</code> macro is available by defining <code>NNG1_TRANSITION</code>
 in your compilation environment.</p>
+<h2 id="removed-protocol-aliases"><a class="header" href="#removed-protocol-aliases">Removed Protocol Aliases</a></h2>
+<p>The following macro aliases are removed, unless <code>NNG1_TRANSITION</code> is defined in your compilation environment.</p>
+<ul>
+<li><code>nng_bus_open</code></li>
+<li><code>nng_pair_open</code></li>
+<li><code>nng_pub_open</code></li>
+<li><code>nng_pull_open</code></li>
+<li><code>nng_push_open</code></li>
+<li><code>nng_rep_open</code></li>
+<li><code>nng_req_open</code></li>
+<li><code>nng_respondent_open</code></li>
+<li><code>nng_sub_open</code></li>
+<li><code>nng_surveyor_open</code></li>
+</ul>
+<p>Just add either <code>0</code> or <code>1</code> (in the case of PAIRv1) to get the protocol desired. (Forcing the version number to
+be supplied should avoid surprises later as new versions of protocols are added.)</p>
+<p>Additionally, the header files for protocols are now empty, as all of their content has been moved to <code>nng/nng.h</code>.
+Please remove <code>#include</code> references to protocol headers as we anticipate removing them in the future.</p>
 <h2 id="new-aio-error-code-nng_estopped"><a class="header" href="#new-aio-error-code-nng_estopped">New AIO Error Code NNG_ESTOPPED</a></h2>
 <p>When an operation fails with <a href="/api/errors.html#NNG_ESTOPPED"><code>NNG_ESTOPPED</code></a>, it means that the associated [<code>nni_aio</code>] object has
 been permanently stopped and must not be reused. Applications must watch for this error code, and
-- 
cgit v1.2.3-70-g09d2