David Stes
2024-03-31 8cdd197ba643eb2608c5aab87567625bb9336cee
doc/makefile-variables.txt
@@ -14,7 +14,16 @@
  field of `sha256sum $(COMPONENT_ARCHIVE)`.
* COMPONENT_ARCHIVE_URL is where the archive can be downloaded from.  This is
  typically constructed from $(COMPONENT_PROJECT_URL) and $(COMPONENT_ARCHIVE).
* COMPONENT_BUGDB is the lower-case rendering of the BugDB cat/subcat.
* COMPONENT_SIG_URL is the URL where the PGP signature for $(COMPONENT_ARCHIVE)
  can be found.  This can be used in addition to the hash in
  $(COMPONENT_ARCHIVE_HASH) to verify the correctness of the archive.  If
  COMPONENT_SIG_URL is present, then COMPONENT_ARCHIVE_HASH needn't be, but its
  presence is strongly encouraged to ensure that the archive contents don't
  change silently.  Note that when merging, because
  $WS/tools/.gnupg/pubring.gpg is a binary file, you will have to choose
  the correct version. To check if key is imported, run:
   gpg2 --homedir=$(git rev-parse --show-toplevel)/tools/.gnupg --list-keys
  before you 'git commit' your merge.
These two are both initialized in make-rules/shared-macros.mk rather than any
component-level Makefile, but are frequently referenced from the latter.
@@ -103,10 +112,15 @@
* CONFIGURE_SCRIPT should be set if the default "$(SOURCE_DIR)/configure" is
  unsuitable for whatever reason.
* studio_OPT has a default value of "-xO4".  Occasional bugs in the optimizer
  have been found which have required altering this to "-xO3".  There are also
  studio_OPT.$(MACH).$(BITS) versions of this available if greater specificity
  is needed.
* gcc_OPT has a default value of "-O3".  Occasional bugs in the optimizer
  have been found which have required altering this to "-O2" or lower values.
  There are also gcc_OPT.$(MACH).$(BITS) versions of this available if
  greater specificity is needed.
* Variable PYTHON3_SOABI selects between two library naming schemes of
  python3 extensions: *.cpython3Xm.so ("cpython") or *.abi3.so ("abi3").
  Currently, only a few components use ABI3 compliant extensions,
  therefore, the default value is set to "cpython".
If you frequently rebuild the same code, such as when you maintain a build server
or iterate recipes for the same component, you can benefit by caching the build