pkgsrc/doc/guide/files/faq.xml: 1.23 -> 1.24

[kano@na.rim.or.jp (OKANO Takayoshi)]

以下のページの更新をしました。ツッコミをお願いします。

pkgsrc/doc/guide/files/faq.xml: 1.23 -> 1.24

> revision 1.24
> date: 2006/05/21 12:23:29;  author: rillig;  state: Exp;  lines: +26 -1
> + FAQ: Why do packages ignore my CFLAGS?

木曜日までに異議がなければ、 commit します。

以下、訳と原文それぞれの新旧の差分です。

--- faq.xml.orig	2006-11-15 00:51:10.000000000 +0900
+++ faq.xml	2006-11-15 00:51:10.000000000 +0900
@@ -1,6 +1,6 @@
-<!-- $NetBSD: faq.xml,v 1.23 2006/04/22 05:43:51 lukem Exp $ -->
+<!-- $NetBSD: faq.xml,v 1.24 2006/05/21 12:23:29 rillig Exp $ -->
 <!-- Based on english version: -->
-<!-- NetBSD: faq.xml,v 1.23 2006/04/22 05:43:51 lukem Exp   -->
+<!-- NetBSD: faq.xml,v 1.24 2006/05/21 12:23:29 rillig Exp   -->
 
 <chapter id="faq"> <?dbhtml filename="faq.html"?>
 <title>よくある質問</title>
@@ -569,4 +569,30 @@
 
 </sect1>
 
+<sect1 id="ufaq-cflags">
+<title><varname>CFLAGS</varname> を無視するパッケージがあるのはなぜ?</title>
+
+	<para><filename>mk.conf</filename> で
+	<varname>CFLAGS</varname> 変数に独自の設定をした場合、
+	設定されたフラグは環境変数によって <filename>./configure</filename>
+	スクリプトに渡されてから &man.make.1; に渡されます。
+	パッケージの作者によっては、
+	環境変数で渡された <varname>CFLAGS</varname> を、
+	パッケージの <filename>Makefile</filename> で上書きして、
+	無視するようにしていることがあります。</para>
+
+	<para>現在のところ、この問題の解決策はありません。
+	独自の <varname>CFLAGS</varname> を使うことがどうしても必要な場合は、
+	パッケージのディレクトリーで <command>make patch</command> を実行してから、
+	<filename>Makefile</filename> と
+	<filename>Makefile.in</filename> をすべて調べて、
+	<varname>CFLAGS</varname> を明示的に定義していないかを調べてください。
+	ふつうは、その部分を削除することができます。
+	ただし、一部の<quote>小賢しい</quote>プログラマーは、
+	彼らが選んだ特定の <varname>CFLAGS</varname>
+	の組合せのもとでしか動作しないような、
+	まずいコードを書いていることに注意してください。</para>
+
+</sect1>
+
 </chapter>
Index: faq.xml
===================================================================
RCS file: /cvsroot/pkgsrc/doc/guide/files/faq.xml,v
retrieving revision 1.23
retrieving revision 1.24
diff -u -r1.23 -r1.24
--- faq.xml	22 Apr 2006 05:43:51 -0000	1.23
+++ faq.xml	21 May 2006 12:23:29 -0000	1.24
@@ -1,4 +1,4 @@
-<!-- $NetBSD: faq.xml,v 1.23 2006/04/22 05:43:51 lukem Exp $ -->
+<!-- $NetBSD: faq.xml,v 1.24 2006/05/21 12:23:29 rillig Exp $ -->
 
 <chapter id="faq"> <?dbhtml filename="faq.html"?>
 <title>Frequently Asked Questions</title>
@@ -576,4 +576,29 @@
 
 </sect1>
 
+<sect1 id="ufaq-cflags">
+<title>Why do some packages ignore my <varname>CFLAGS</varname>?</title>
+
+	<para>When you add your own preferences to the
+	<varname>CFLAGS</varname> variable in your
+	<filename>mk.conf</filename>, these flags are passed in
+	environment variables to the <filename>./configure</filename>
+	scripts and to &man.make.1;. Some package authors ignore the
+	<varname>CFLAGS</varname> from the environment variable by
+	overriding them in the <filename>Makefile</filename>s of their
+	package.</para>
+
+	<para>Currently there is no solution to this problem. If you
+	really need the package to use your <varname>CFLAGS</varname>
+	you should run <command>make patch</command> in the package
+	directory and then inspect any <filename>Makefile</filename> and
+	<filename>Makefile.in</filename> for whether they define
+	<varname>CFLAGS</varname> explicitly. Usually you can remove
+	these lines. But be aware that some <quote>smart</quote>
+	programmers write so bad code that it only works for the
+	specific combination of <varname>CFLAGS</varname> they have
+	chosen.</para>
+
+</sect1>
+
 </chapter>