From 2c123e082a4fea6fa82132f6ab0f7257daac3f59 Mon Sep 17 00:00:00 2001
From: Garrett D'Amore <garrett@damore.org>
Date: Sat, 19 May 2018 21:42:07 -0700
Subject: fixes #458 Improve man page section descriptions.

---
 docs/man/nng_compat.3compat.adoc | 5 +++++
 1 file changed, 5 insertions(+)

(limited to 'docs/man/nng_compat.3compat.adoc')

diff --git a/docs/man/nng_compat.3compat.adoc b/docs/man/nng_compat.3compat.adoc
index 77e55313..a282b4a9 100644
--- a/docs/man/nng_compat.3compat.adoc
+++ b/docs/man/nng_compat.3compat.adoc
@@ -32,6 +32,11 @@ New applications should use the newer <<nng.7#,_nng_>> API instead.
 Applications making use of this ((compatibility layer)) must take care
 to link with <<libnng.3#,_libnng_>> instead of _libnn_.
 
+TIP: While not recommended for long term use, the value returned by
+<<nng_socket_id.3#,nng_socket_id()>> can be used with these functions
+just like a value returned by <<nn_socket.3compat#,nn_socket()>>.
+This can be way to facilitate incremental transition to the new API.
+
 NOTE: Some capabilities, protocols, and transports, will not be accessible
 using this API, as the compatible API has no provision for expression
 of certain concepts introduced in the newer <<nng.7#,_nng_>> API.
-- 
cgit v1.2.3-70-g09d2

