aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorAvatar David Leverton <levertond@googlemail.com> 2007-11-10 21:31:37 +0000
committerAvatar David Leverton <levertond@googlemail.com> 2007-11-10 21:31:37 +0000
commit000faa029182c67e8b7cb5c046c0b8b472f55a47 (patch)
tree53b67f568a142df97a4a87cc0a30ef61d3720d80
parentb3a38e91988353704c4277546278f6fdb8ef15e4 (diff)
downloadpaludis-000faa029182c67e8b7cb5c046c0b8b472f55a47.tar.gz
paludis-000faa029182c67e8b7cb5c046c0b8b472f55a47.tar.xz
Add FAQ entry about broken compilers.
-rw-r--r--doc/faq/general.html.part31
-rw-r--r--doc/faq/index.html.part1
2 files changed, 32 insertions, 0 deletions
diff --git a/doc/faq/general.html.part b/doc/faq/general.html.part
index 48224b5..ff85631 100644
--- a/doc/faq/general.html.part
+++ b/doc/faq/general.html.part
@@ -8,6 +8,7 @@
<li><a href="general.html#cplusplus">Why C++?</a></li>
<li><a href="general.html#butcplusplusis">But C++ is ...</a></li>
<li><a href="general.html#contribute">Contributing</a></li>
+ <li><a href="general.html#compilers">Known compiler issues</a></li>
</ul>
<h2 id="ihaveaquestion">I have an Unanswered Question</h2>
@@ -61,3 +62,33 @@ the code now does.</p>
<li>We don't need or desire assistance with hosting etc. at present.</li>
</ul>
+<h2 id="compilers">Known compiler issues</h2>
+
+<p>The primary supported compiler for building Paludis is GCC, version
+4.1 or later; 3.4 can be used on most platforms if the Boost library
+is installed. Some versions of GCC, and some compiler flags, are
+known to have problems:</p>
+
+<ul>
+ <li>GCC 3.4.6 on the x86_64 architecture segfaults while building
+ Paludis.</li>
+
+ <li>GCC 4.1.1 segfaults while building Paludis.</li>
+
+ <li>GCC 4.2.2 segfaults while building Paludis if
+ the <code>-g</code> compiler flag is used.</li>
+
+ <li>The <code>-O3</code> compiler flag causes linker errors when
+ building some versions of Paludis (note that the Gentoo and
+ paludis-overlay ebuilds remove this flag automatically).</li>
+
+ <li>The <code>-Os</code> compiler flag has been known to cause GCC
+ to miscompile Paludis at least on x86_64, and possibly others
+ (note that the Gentoo and paludis-overlay ebuilds remove this flag
+ automatically).</li>
+
+ <li>The <code>-O0</code> flag (or equivalently, absense of
+ any <code>-O</code>x flag) has been known to cause GCC to
+ miscompile Paludis in the past at least on x86_64.</li>
+</ul>
+
diff --git a/doc/faq/index.html.part b/doc/faq/index.html.part
index 6a55198..a681369 100644
--- a/doc/faq/index.html.part
+++ b/doc/faq/index.html.part
@@ -17,6 +17,7 @@ functionality. Pestering anyone about these is liable to get you hurt a lot.</p>
<li><a href="general.html#cplusplus">Why C++?</a></li>
<li><a href="general.html#butcplusplusis">But C++ is ...</a></li>
<li><a href="general.html#contribute">Contributing</a></li>
+ <li><a href="general.html#compilers">Known compiler issues</a></li>
</ul>
<h2>How do I ...?</h2>