[git commit master] FAQ: rephrase toolchain to be version agnostic
Bernhard Reutner-Fischer
rep.dot.nop at gmail.com
Wed Mar 17 09:56:06 UTC 2010
commit: http://git.uclibc.org/uClibc-website/commit/?id=d068b77fbc2d51023dd84c38c8a78320ec399dd2
branch: http://git.uclibc.org/uClibc-website/commit/?id=refs/heads/master
Signed-off-by: Bernhard Reutner-Fischer <rep.dot.nop at gmail.com>
---
FAQ.html | 57 +++++++++++++++++++++++++++++++++------------------------
1 files changed, 33 insertions(+), 24 deletions(-)
diff --git a/FAQ.html b/FAQ.html
index f3b98e2..e94ecca 100644
--- a/FAQ.html
+++ b/FAQ.html
@@ -379,56 +379,65 @@ How could it be smaller and not suck?</a></h2>
<p>
The current versions of things which are actively supported:
<ul>
- <li>Linux-2.4 and newer</li>
+ <li>Linux-2.6 and newer</li>
<li>The last two official GNU binutils releases</li>
<li>The last few official stable GNU gcc releases</li>
</ul>
<p>
- We know that people like to run older versions of Linux (such as the 2.0
- and 2.2 series). If things do not work for you on those series, you will
+ We know that people like to run older versions of Linux (such as the 2.2
+ and 2.4 series). If things do not work for you on those series, you will
need to come up with a clean fix that can be merged into uClibc. For
threading libraries, linuxthreads is planned to be maintained indefinitely
so long as linux-2.4 support is active. After that, it will be the same as
everything else: left alone and hopefully left working.
<p>
- The last two GNU binutils releases are 2.19 and 2.18. While 2.18 should
- work, workarounds for bugs in it are not considered.
+ The last two
+ <a href="http://www.gnu.org/software/binutils/">GNU binutils</a> releases
+ should work fine. Workarounds for bugs in older versions are not
+ considered.
<p>
- Since the GCC-3.4 and GCC-4.1 series are the recent stable release series
- (since the 4.0 and 4.2 series tend to be a bit broken for everyone), they
- are the latest versions we will address. If you encounter a compile error
- using an older version (say GCC 3.2), then you're out of luck. You'll need
- to workaround it yourself.
+ The last official
+ <a href="http://www.gnu.org/software/gcc/">GCC</a> point release is
+ supported.
+ If you encounter a compile error using an older version, then you're out of
+ luck. You'll need to workaround it yourself.
<p>
For the GNU toolchain releases, only the latest point release is supported.
- So if you encounter a bug in say GCC-3.4.4, but GCC-3.4.6 works fine, then
+ So if you encounter a bug in say GCC-x.y.7, but GCC-x.y.8 works fine, then
we will not address it. Upgrading GCC across point releases is trivial.
- Same goes for say binutils 2.16 and 2.16.1.
-
-
+ Same goes for binutils.
<hr>
<p>
<h2><a name="bugs">I think I found a bug in uClibc! What should I do?</a></h2>
<p>
- If you find a problem with uClibc, please submit a detailed bug report to
- the uClibc mailing list at <a href="mailto:uclibc at uclibc.org">
- uclibc at uclibc.org</a>. Please do not send private email to Erik
- (the maintainer of uClibc) asking for private help unless you are planning
- on paying for consulting services. When we answer questions on the uClibc
- mailing list, it helps everyone, while private answers help only you...
-
- A well-written bug report should include an example that demonstrates the
- problem behaviors and enables anyone else to duplicate the bug on their own
- machine. For larger applications where it may prove difficult to provide
+ A well-written bug report should include
+ <ul>
+ <li><em>small, self-contained example </em> that demonstrates the problem behaviors
+ <li>Versions of the toolchain used (gcc, binutils, etc)
+ <li>Other relevant information that enables anyone else to duplicate the bug
+ </ul>
+ For architecture-specific bugs, also mention the target triplet (like
+ armeb-linux-uclibcgnueabi).
+ <p>
+ For larger applications where it may prove difficult to provide
an example application, we recommend that you use a tool such as gdb,
strace, ltrace, and or valgrind to create a logfile showing the problem
behavior.
+ <p>
+ If you find a problem with uClibc, please submit a detailed bug report to
+ the uClibc <a href="https://bugs.uClibc.org/">bug tracker</a> or, if you are
+ uncertain that it is a bug, to the mailing list at
+ <a href="mailto:uclibc at uclibc.org"> uclibc at uclibc.org</a>. Please do not
+ send private email to individual developers asking for private help unless
+ you are planning on paying for consulting services. When we answer
+ questions on the uClibc mailing list, it helps everyone, while private
+ answers help only you...
<hr>
--
1.6.3.3
More information about the uClibc-cvs
mailing list