From cc3b5fe459d277ee46277bc26301249f57855470 Mon Sep 17 00:00:00 2001
From: Garrett D'Amore <garrett@damore.org>
Date: Sun, 24 Nov 2024 08:53:12 -0800
Subject: socket: remove unused nng_socket_get_ptr and nng_socket_set_ptr.

We will be removing these pointer based functions more generally
as we we have type-specific accessors instead.

We also removed the context versions of these functions, which were
not previously documented.
---
 docs/man/nng_socket_set.3.adoc | 17 -----------------
 1 file changed, 17 deletions(-)

(limited to 'docs/man/nng_socket_set.3.adoc')

diff --git a/docs/man/nng_socket_set.3.adoc b/docs/man/nng_socket_set.3.adoc
index bd3f7f47..b787436f 100644
--- a/docs/man/nng_socket_set.3.adoc
+++ b/docs/man/nng_socket_set.3.adoc
@@ -25,8 +25,6 @@ int nng_socket_set_int(nng_socket s, const char *opt, int ival);
 
 int nng_socket_set_ms(nng_socket s, const char *opt, nng_duration dur);
 
-int nng_socket_set_ptr(nng_socket s, const char *opt, void *ptr);
-
 int nng_socket_set_size(nng_socket s, const char *opt, size_t z);
 
 int nng_socket_set_string(nng_socket s, const char *opt, const char *str);
@@ -44,11 +42,6 @@ A number of them are documented in xref:nng_options.5.adoc[nng_options(5)].
 
 Protocol-specific options are documented with the protocol in question.
 
-IMPORTANT: Access to transport options via this function is deprecated, and may be
-removed from a future release.  Applications should instead make use of
-xref:nng_dialer_set.3.adoc[nng_dialer_get] or
-xref:nng_listener_set.3.adoc[nng_listener_get] for specific dialers or listeners.
-
 === Forms
 
 The details of the type, size, and semantics of the option will depend
@@ -67,16 +60,6 @@ This function is used to configure time durations (such as timeouts) using
 type xref:nng_duration.5.adoc[`nng_duration`].
 The duration _dur_ is an integer number of milliseconds.
 
-`nng_socket_set_ptr()`::
-This function is used to pass a pointer, _ptr_, to structured data.
-The data referenced by _ptr_ is generally managed by other functions.
-For example, TLS configuration objects created with
-(xref:nng_tls_config_alloc.3tls.adoc[`nng_tls_config_alloc()`])
-can be passed this way.
-
-NOTE: This form is somewhat special in that the object is generally
-not copied, but instead the *pointer* to the object is copied.
-
 `nng_socket_set_size()`::
 This function is used to configure a size, _z_, typically for buffer sizes,
 message maximum sizes, and similar options.
-- 
cgit v1.2.3-70-g09d2

