tcp/tls: Remove support for local interface address in dialer URLs

This was an undocumented capability provided for libnanomsg.  The
correct way to obtain the same functionality is to use `NNG_OPT_LOCADDR`.

2 files changed, 15 insertions, 0 deletions

diff --git a/docs/ref/migrate/nanomsg.md b/docs/ref/migrate/nanomsg.md
index bb668121..66add9b2 100644
--- a/docs/ref/migrate/nanomsg.md
+++ b/docs/ref/migrate/nanomsg.md
@@ -121,4 +121,11 @@ There are some exceptions. Be aware that the numeric values are _not_ the same.
 | `EMFILE`       | [`NNG_ENOFILES`]                                                                         |
 | `ENOSPC`       | [`NNG_ENOSPC`]                                                                           |
 
+## Local Addresses for Dialing
+
+The ability to specify the source address in the UROL,to use when
+using `nn_dial` inside the URL is not present in NNG. The correct
+way to specify the local address is using the `NNG_OPT_LOCADDR` option on the
+dialer before starting to dial.
+
 {{#include ../xref.md}}
diff --git a/docs/ref/migrate/nng1.md b/docs/ref/migrate/nng1.md
index 7bafb8f5..d3440fe4 100644
--- a/docs/ref/migrate/nng1.md
+++ b/docs/ref/migrate/nng1.md
@@ -60,6 +60,14 @@ Support for very old TLS versions 1.0 and 1.1 is removed.
 Further, the `NNG_TLS_1_0` and `NNG_TLS_1_1` constants are also removed.
 Applications should use `NNG_TLS_1_2` or even `NNG_TLS_1_3` instead.
 
+## Support for Local Addresses in Dial URLs Removed
+
+NNG 1.x had an undocumented ability to specify the local address to bind
+to when dialing, by using the local address in front of the destination
+address separated by a semicolon. This was provided for legacy libnanomsg
+compatilibility, and is no longer offered. The correct way to specify a
+local address is by setting `NNG_OPT_LOCADDR` on the dialer.
+
 ## Option Functions
 
 The previously deprecated `nng_pipe_getopt_xxx` family of functions is removed.