[pkgsrc/trunk]: pkgsrc/doc/guide/files doc/guide: explain how to track down w...

[rillig <rillig%pkgsrc.org@localhost>]

details:   https://anonhg.NetBSD.org/pkgsrc/rev/32621ea23197
branches:  trunk
changeset: 411268:32621ea23197
user:      rillig <rillig%pkgsrc.org@localhost>
date:      Sun Feb 09 00:44:25 2020 +0000

description:
doc/guide: explain how to track down where the CFLAGS are ignored

diffstat:

 doc/guide/files/faq.xml |  22 +++++++++++++++++++++-
 1 files changed, 21 insertions(+), 1 deletions(-)

diffs (36 lines):

diff -r 4271572bf5e7 -r 32621ea23197 doc/guide/files/faq.xml
--- a/doc/guide/files/faq.xml   Sun Feb 09 00:06:53 2020 +0000
+++ b/doc/guide/files/faq.xml   Sun Feb 09 00:44:25 2020 +0000
@@ -1,4 +1,4 @@
-<!-- $NetBSD: faq.xml,v 1.55 2017/01/09 04:03:34 sevan Exp $ -->
+<!-- $NetBSD: faq.xml,v 1.56 2020/02/09 00:44:25 rillig Exp $ -->
 
 <chapter id="faq"> <?dbhtml filename="faq.html"?>
 <title>Frequently Asked Questions</title>
@@ -558,6 +558,26 @@
        specific combination of <varname>CFLAGS</varname> they have
        chosen.</para>
 
+<para>To find out where the CFLAGS are ignored, add the following lines to &mk.conf;:</para>
+
+<programlisting>
+CPPFLAGS+=              -Dpkgsrc___CPPFLAGS
+CFLAGS+=                -Dpkgsrc___CFLAGS
+CXXFLAGS+=              -Dpkgsrc___CXXFLAGS
+</programlisting>
+
+<para>Then run <command>bmake show-all-configure show-all-build</command>
+to see whether the above flags are passed to the actual build
+commands in general.</para>
+
+<para>To find out whether the flags are passed to individual compiler
+commands, have a look at the file <filename>work/.work.log</filename>. In
+most cases, the flags from the original command lines (the lines starting
+with <literal>[*]</literal>) are passed unmodified to the actual compiler
+(the lines starting with <literal>&lt;.&gt;</literal>). If the flag is
+missing from the actual compiler command, it must have been removed by
+the <link linkend="build.wrapper">pkgsrc compiler wrappers</link>.</para>
+
 </sect1>
 
 <sect1 id="ufaq-fail">