diff options
| author |   Jonas Frei <freijon@pm.me> | 2023-08-22 05:17:10 +0200 |
|---|---|---|
| committer |   Ulrich Müller <ulm@gentoo.org> | 2023-08-22 08:03:16 +0200 |
| commit | 29978d077d271058b31a4578617880013448093d (patch) | |
| tree | 9977913c79bb740182972d2c7642c97995f0f021 | |
| parent | function-reference/install-functions: Reword dostrip documentation (diff) | |
| download | devmanual-29978d077d271058b31a4578617880013448093d.tar.gz devmanual-29978d077d271058b31a4578617880013448093d.tar.bz2 devmanual-29978d077d271058b31a4578617880013448093d.zip | |
general-concepts/use-flags: Clarification about compiler flags
Signed-off-by: Jonas Frei <freijon@pm.me>
[Whitespace fixed.]
Signed-off-by: Ulrich Müller <ulm@gentoo.org>
| -rw-r--r-- | general-concepts/use-flags/text.xml | 11 |
1 files changed, 6 insertions, 5 deletions
diff --git a/general-concepts/use-flags/text.xml b/general-concepts/use-flags/text.xml index 7d0047a..5caa430 100644 --- a/general-concepts/use-flags/text.xml +++ b/general-concepts/use-flags/text.xml @@ -82,10 +82,10 @@ instead, or controlled by a flag such as <c>minimal</c>. </p> <p> -You should not introduce USE flags that merely manipulate <c>CFLAGS</c>, -<c>FEATURES</c> or similar variables configured directly by the user. Instead, -packages should avoid manipulating them at all, and let users set them directly. -Common mistakes include: +You should not introduce USE flags that manipulate compiler flags or similar +variables configured directly by the user (e.g. <c>-O3</c>, <c>-flto</c>). +Instead, packages should avoid manipulating them at all, and let users set +them directly. Common mistakes include: </p> <ol> @@ -114,7 +114,8 @@ There might be corner cases where these rules do not apply. For example, a few upstreams require users to use specific <c>CFLAGS</c> and reject bug reports against builds using other values. In this case, it is customary to strip flags by default and provide <c>custom-cflags</c> flag to allow users to force their -preferred flags. +preferred flags. Another exception are <c>CFLAGS</c> that enable/disable +features at compile time (via pre-processor macros). </p> </body> </section> |