From 6e03d3470ca6f7c5bdfad6def41b0f0eaf9d33a6 Mon Sep 17 00:00:00 2001 From: Garrett D'Amore Date: Sat, 4 Jan 2025 10:13:49 -0800 Subject: api: remove old protocol headers --- docs/ref/migrate/nng1.md | 26 +++++++++++++++++++++++--- 1 file changed, 23 insertions(+), 3 deletions(-) (limited to 'docs/ref') diff --git a/docs/ref/migrate/nng1.md b/docs/ref/migrate/nng1.md index 74350ec0..964bba50 100644 --- a/docs/ref/migrate/nng1.md +++ b/docs/ref/migrate/nng1.md @@ -13,6 +13,29 @@ See the [Migrating From libnanomsg](nanomsg.md) chapter for details. It is now required for applications to initialize the library explicitly before using it. This is done using the [`nng_init`] function. +## Removed Headers + +The following header files are removed, and the declarations they provided are now provided by including ``. +Simply remove any references to them. + +- `nng/protocol/bus0/bus.h` +- `nng/protocol/pair0/pair.h` +- `nng/protocol/pair1/pair.h` +- `nng/protocol/pipeline0/pull.h` +- `nng/protocol/pipeline0/push.h` +- `nng/protocol/pubsub0/pub.h` +- `nng/protocol/pubsub0/sub.h` +- `nng/protocol/reqrep0/rep.h` +- `nng/protocol/reqrep0/req.h` +- `nng/protocol/survey0/respond.h` +- `nng/protocol/survey0/survey.h` +- `nng/transport/inproc/inproc.h` +- `nng/transport/ipc/ipc.h` +- `nng/transport/tcp/tcp.h` +- `nng/transport/tls/tls.h` +- `nng/transport/ws/websocket.h` +- `nng/transport/zerotier/zerotier.h` + ## Renamed Functions The following functions have been renamed as described by the following table. @@ -42,9 +65,6 @@ The following macro aliases are removed, unless `NNG1_TRANSITION` is defined in Just add either `0` or `1` (in the case of PAIRv1) to get the protocol desired. (Forcing the version number to be supplied should avoid surprises later as new versions of protocols are added.) -Additionally, the header files for protocols are now empty, as all of their content has been moved to `nng/nng.h`. -Please remove `#include` references to protocol headers as we anticipate removing them in the future. - ## NNG_FLAG_ALLOC Removed The `NNG_FLAG_ALLOC` flag that allowed a zero copy semantic with [`nng_send`] and [`nng_recv`] is removed. -- cgit v1.2.3-70-g09d2