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_get.3.adoc | 13 -------------
 1 file changed, 13 deletions(-)

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

diff --git a/docs/man/nng_socket_get.3.adoc b/docs/man/nng_socket_get.3.adoc
index cca1dc5a..f510eb39 100644
--- a/docs/man/nng_socket_get.3.adoc
+++ b/docs/man/nng_socket_get.3.adoc
@@ -29,8 +29,6 @@ int nng_socket_get_uint64(nng_socket s, const char *opt, uint64_t *u64p);
 
 int nng_socket_get_string(nng_socket s, const char *opt, char **strp);
 
-int nng_socket_get_ptr(nng_socket s, const char *opt, void **ptr);
-
 int nng_socket_get_ms(nng_socket s, const char *opt, nng_duration *durp);
 
 int nng_socket_get_addr(nng_socket s, const char *opt, nng_sockaddr *addrp);
@@ -47,11 +45,6 @@ A number of them are documented in xref:nng_options.5.adoc[nng_options(5)].
 
 Additionally protocol-specific options are documented with the protocols themselves.
 
-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_get.3.adoc[nng_dialer_get] or
-xref:nng_listener_get.3.adoc[nng_listener_get] for specific dialers or listeners.
-
 === Forms
 
 In all of these forms, the option _opt_ is retrieved from the socket _s_.
@@ -74,12 +67,6 @@ This function is used to retrieve time xref:nng_duration.5.adoc[durations]
 (The special value ((`NNG_DURATION_INFINITE`)) means an infinite amount of time, and
 the special value ((`NNG_DURATION_DEFAULT`)) means a context-specific default.)
 
-`nng_socket_get_ptr()`::
-This function is used to retrieve a pointer, _ptr_, to structured data.
-The data referenced by _ptr_ is generally managed using other functions.
-Note that this form is somewhat special in that the object is generally
-not copied, but instead the *pointer* to the object is copied.
-
 `nng_socket_get_size()`::
 This function is used to retrieve a size into the pointer _zp_,
 typically for buffer sizes, message maximum sizes, and similar options.
-- 
cgit v1.2.3-70-g09d2

