blob: f8d1ce4090bbeaaeaf0a60e08468771beadd00f7 [file] [log] [blame] [view]
# New C++ bindings headers
The headers in this directory are meant to support the new C++ bindings
(https://fxbug.dev/42138399). The headers would be exposed to users via the same include
pattern as those from the high-level C++ bindings at //sdk/lib/fidl/cpp,
i.e. `#include <lib/fidl/cpp/foobar.h>`. The intention is that as the unified
C++ bindings becomes the prevalent C++ bindings API, we won't have to make
another LSC to move the header locations. Therefore, a bit of extra attention is
needed to ensure the headers and definitions in this library don't collide with
those in //sdk/lib/fidl/cpp.
Different from //sdk/lib/fidl/cpp, this library has an explicit "include" folder
that hosts the headers. This is desirable because we avoid exposing the entire
"//src" tree available for inclusion otherwise. Given enough time, we should
migrate libraries in //sdk to use a dedicated "include" folder too.
## Design
See [structure of new C++ FIDL bindings](docs/structure-of-unified-cpp-fidl-bindings.md).