CVS commit: pkgsrc/doc/guide/files

["Roland Illig" <rillig%netbsd.org@localhost>]

Module Name:    pkgsrc
Committed By:   rillig
Date:           Sun Feb  9 00:44:25 UTC 2020

Modified Files:
        pkgsrc/doc/guide/files: faq.xml

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


To generate a diff of this commit:
cvs rdiff -u -r1.55 -r1.56 pkgsrc/doc/guide/files/faq.xml

Please note that diffs are not public domain; they are subject to the
copyright notices on the relevant files.

Modified files:

Index: pkgsrc/doc/guide/files/faq.xml
diff -u pkgsrc/doc/guide/files/faq.xml:1.55 pkgsrc/doc/guide/files/faq.xml:1.56
--- pkgsrc/doc/guide/files/faq.xml:1.55 Mon Jan  9 04:03:34 2017
+++ pkgsrc/doc/guide/files/faq.xml      Sun Feb  9 00:44:25 2020
@@ -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 @@ perform a security check before building
        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">