diff --git a/STYLE.md b/STYLE.md index 4b377e71..3c74b45c 100644 --- a/STYLE.md +++ b/STYLE.md @@ -207,3 +207,14 @@ return value patterns in legacy functions. Document private functions in their `internal.h` header or, if static, where defined. + + +## Build logic + +BoringSSL is used by many projects with many different build tools. +Reimplementing and maintaining build logic in each downstream build is +cumbersome, so build logic should be avoided where possible. Platform-specific +files should be excluded by wrapping the contents in `#ifdef`s, rather than +computing platform-specific file lists. Generated source files such as perlasm +and `err_data.c` may be used in the standalone CMake build but, for downstream +builds, they should be pre-generated in `generate_build_files.py`.