# Notes for maintainers
## Generating docs from bindings
Whenever updating libproj or bindgen you must regenerate the prebuilt bindings
at `proj-sys/src/bindings_docs-rs.rs`.
These prebuilt bindings are only used for generating documentation - e.g. on
https://docs.rs. Actual usage of the crate depends on dynamically built bindings, but
that entails having libproj installed or built from source, which we can't
expect docs.rs to do.
## To update the prebuilt bindings
After updating the source in PROJSRC and the build.rs script to reference the new source,
The process of updating bindings looks like:
```
cd proj-sys
cargo clean
cargo build
find ../target/debug/build/proj-sys* -name bindings.rs
```
copy that file over the `src/bindings_docs-rs.rs`, but retain the header:
```
/* THESE ARE NOT LIVE BINDINGS */
/* THEY EXIST FOR USE BY DOCS-RS ONLY */
```