[gentoo-commits] proj/devmanual:master commit in: general-concepts/use-flags/

["Ulrich Müller" <ulm@gentoo.org>]

commit:     29978d077d271058b31a4578617880013448093d
Author:     Jonas Frei <freijon <AT> pm <DOT> me>
AuthorDate: Tue Aug 22 03:17:10 2023 +0000
Commit:     Ulrich Müller <ulm <AT> gentoo <DOT> org>
CommitDate: Tue Aug 22 06:03:16 2023 +0000
URL:        https://gitweb.gentoo.org/proj/devmanual.git/commit/?id=29978d07

general-concepts/use-flags: Clarification about compiler flags

Signed-off-by: Jonas Frei <freijon <AT> pm.me>
[Whitespace fixed.]
Signed-off-by: Ulrich Müller <ulm <AT> gentoo.org>

 general-concepts/use-flags/text.xml | 11 ++++++-----
 1 file 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>