From 45f455064b5704f3d5ed8ecf9f197a18fe72ee59 Mon Sep 17 00:00:00 2001
From: Garrett D'Amore <garrett@damore.org>
Date: Wed, 4 Apr 2018 12:37:34 -0700
Subject: fixes #331 replace NNG_OPT_RAW option with constructor

This makes the raw mode something that is immutable, determined
at socket construction.  This is an enabling change for the
separate context support coming soon.

As a result, this is an API breaking change for users of the raw
mode option (NNG_OPT_RAW).  There aren't many of them out there.

Cooked mode is entirely unaffected.

There are changes to tests and documentation included.
---
 docs/man/nng_req_open.3.adoc | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

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

diff --git a/docs/man/nng_req_open.3.adoc b/docs/man/nng_req_open.3.adoc
index 638ef43a..dd2e7cb6 100644
--- a/docs/man/nng_req_open.3.adoc
+++ b/docs/man/nng_req_open.3.adoc
@@ -21,6 +21,8 @@ nng_req_open - create rep socket
 #include <nng/protocol/reqrep0/req.h>
 
 int nng_req0_open(nng_socket *s);
+
+int nng_req0_open_raw(nng_socket *s);
 ----
 
 == DESCRIPTION
@@ -28,9 +30,14 @@ int nng_req0_open(nng_socket *s);
 The `nng_req0_open()` function creates a <<nng_req.7#,_req_>> version 0
 <<nng_socket.5#,socket>> and returns it at the location pointed to by _s_.
 
+The `nng_req0_open_raw()` function creates a <<nng_req.7#,_req_>> version 0
+<<nng_socket.5#,socket>> in
+<<nng.7#raw_mode,raw>> mode
+and returns it at the location pointed to by _s_.
+
 == RETURN VALUES
 
-This function returns 0 on success, and non-zero otherwise.
+These functions return 0 on success, and non-zero otherwise.
 
 == ERRORS
 
@@ -39,6 +46,7 @@ This function returns 0 on success, and non-zero otherwise.
 
 == SEE ALSO
 
+<<nng_options.5#,nng_options(5)>>,
 <<nng_socket.5#,nng_socket(5)>>,
 <<nng_rep.7#,nng_rep(7)>>,
 <<nng_req.7#,nng_req(7)>>,
-- 
cgit v1.2.3-70-g09d2

