tree 10ebc72d558ebe3765f47b9ffb7b370e88571aca
parent f21c591b5801ff79544d2b594afc6eb7250c6e6f
author Henry Schreiner <HenrySchreinerIII@gmail.com> 1791050172 -0400
committer GitHub <noreply@github.com> 1791050172 -0400
gpgsig -----BEGIN PGP SIGNATURE-----
 
 wsFcBAABCAAQBQJqwUG8CRC1aQ7uu5UhlAAAV8AQAJaSL0XxujLJdUPDwrBVfrlb
 omay0D+TJcGOdCmuyvJRQsMouY/8MheyH0u5AQrrRlDOa6eEpbcOGnwUbtDA3x2z
 /yRJgjBWrP8uDryP79XgS863zk1rzTTmajxn6WQ80pMFSknLSP3r2PiRpKK3Dm0I
 I9VIZVcI+mTPsZSHHXCR5NwLcQ88lasIMYwB48T09ntEaiZaJoaYcXgNUhP+ign/
 xEpZFTJ3dCIn/z6DAtCZUlyKwBkFCNFUiB0aRIwcYhlsiFwDR/co0kqbTrkl+qn5
 qZBgmzLSsYVdoqib+GGV3bKwpRQJPtcgj2OFOlchlVaYJ0DMlnfJAYsUN88h/SXC
 3LEyek1KZOa1Ho7+s9NGqcCOFhDwfaAYYBiS0l1/f9Y/ek8762XkSC8TkWdeqVEA
 HH/1l+3ck3O7vWDmifkFYi1IedZpLPuIxcx3pzc+Maf0WlYZy4lNJ1SbJHbwKV9x
 BhygtLMSTa+91IU3Vy381g6+DhHRB4HZVwR/+BtPNtvZBcZ3Iwm7tIKR9SE84QKn
 5TOk1nee6ckC18L7YWdwiSu8LmHNnccaDHEbcD8WQ3b5pz4kWjDoedkM1M1CV3Bh
 04whnA1IewNv8rYVYvZUJ2dQgae5sYxMC1GLb+ELtjNqBb8UHbmZqaIaQndHLd8a
 JNRTz/BjllAkAFHXnSbA
 =1KdW
 -----END PGP SIGNATURE-----
 

[feat/precompile-tooling] docs: document the opt-in precompiled mode (#6138)

* docs: document the opt-in precompiled mode

Assisted-by: ClaudeCode:claude-fable-5

* chore: lint the -inl.h invariants of the precompiled mode

tools/check_inl_headers.py checks that each namespace-scope definition
in an -inl.h file has PYBIND11_INLINE, and that each macro in a
preprocessor condition is known: either the same for the library and
the module, or encoded in the precompiled config guard. Also document
that a custom PYBIND11_NAMESPACE must reach the library.

Assisted-by: ClaudeCode:claude-opus-5-5

* docs: note the call overhead of a non-LTO precompiled library

Release build, trivial bound functions, against an LTO header-only
module: AppleClang arm64 adds 2-4 ns per call (7-11%), GCC 15 Linux
aarch64 adds 1-2 ns (1-7%). With LTO on the library, both are within a
few percent.

Assisted-by: ClaudeCode:claude-opus-5-5