docs/rust/use_declarations.md

# C++ bindings for Rust `use` declarations

Crubit supports `use` declarations for functions and types, mapping them to
equivalent `using` declarations in C++.

**Limitations:**

*   The `use` declaration must refer to a function or type.
    *   If it refers to a function, it must not rename the function.
*   The `use` declaration must import exactly one entity per name. For example,
    `pub use m::x;` is supported if `x` refers to a function, or to a type, but
    not if it refers to *both* a function *and* a type.

## Example

Given the following Rust crate:

```
{{ #include ../../examples/rust/use_declaration/example.rs }}
```
<!--  content:\bpub\ use\b -->


Crubit will generate the following bindings:

```
{{ #include ../../examples/rust/use_declaration/example_generated.h }}
```
<!--  content:\busing\b[^;]*; -->