# HG changeset patch # User "Yann E. MORIN" # Date 1240263025 0 # Node ID 7acdd1de5b50524b7582d5ac2c6e4fd2adff0b30 # Parent 3448ac3f1a5da3f78963f32016f2f0a8683069f0 Add a bit more explanations on the meaning of OBSOLETE and EXPERIMENTAL. -------- diffstat follows -------- /trunk/config/global/ct-behave.in | 22 13 9 0 +++++++++++++--------- /trunk/docs/overview.txt | 8 6 2 0 ++++++-- 2 files changed, 19 insertions(+), 11 deletions(-) diff -r 3448ac3f1a5d -r 7acdd1de5b50 config/global/ct-behave.in --- a/config/global/ct-behave.in Mon Apr 20 21:10:03 2009 +0000 +++ b/config/global/ct-behave.in Mon Apr 20 21:30:25 2009 +0000 @@ -8,9 +8,13 @@ default n help If you set this to Y, you will be able to select obsolete features. - - Such obsolete features are the use of old kernel headers, old - gcc versions, etc... + + Such obsolete features are the use of old kernel headers, old gcc + versions, etc... for which maintaining support in crosstool-NG + would be very costly. + + It does not however mean that the specific feature or version has been + marked obsolete by the upstream team. config EXPERIMENTAL bool @@ -19,7 +23,7 @@ help If you set this to Y, then you will be able to try very experimental features. - + Experimental features can be one of: - working, in which case you should tell me it is! - buggy, in which case you could try patching and send me the result @@ -32,7 +36,7 @@ prompt "Debug crosstool-NG" default n help - Say 'y' here to get some debugging options + Say 'y' here to get some options regarding debugging crosstool-NG. if DEBUG_CT @@ -51,10 +55,10 @@ help If you say 'y' here, then you will be able to restart crosstool-NG at any step. - - It is not currently possible to restart at any of the debug facility. + + It is not currently possible to restart at any of the debug facilities. They are treated as a whole. - + See docs/overview.txt for the list of steps. config DEBUG_CT_SAVE_STEPS_GZIP @@ -65,7 +69,7 @@ help If you are tight on space, then you can ask to gzip the saved states tarballs. On the other hand, this takes some longer time... - + To lose as less time as possible, the gzip process is done with a low compression ratio (-3), which gives roughly 70% gain in size. Going further doesn't gain much, and takes far more time (believe me, I've diff -r 3448ac3f1a5d -r 7acdd1de5b50 docs/overview.txt --- a/docs/overview.txt Mon Apr 20 21:10:03 2009 +0000 +++ b/docs/overview.txt Mon Apr 20 21:30:25 2009 +0000 @@ -277,13 +277,17 @@ Show obsolete versions or tools. Most of the time, you don't want to base your toolchain on too old a version (of gcc, for example). But at times, it can come handy to use such an old version for regression tests. Those old - versions are hidden behind CT_OBSOLETE. + versions are hidden behind CT_OBSOLETE. Those versions (or features) are so + marked because maintaining support for those in crosstool-NG would be too + costly, time-wise, and time is dear. CT_EXPERIMENTAL: Show experimental versions or tools. Again, you might not want to base your toolchain on too recent tools (eg. gcc) for production. But if you need a feature present only in a recent version, or a new tool, you can find them - hidden behind CT_EXPERIMENTAL. + hidden behind CT_EXPERIMENTAL. Those versions (or features) did not (yet) + receive thorough testing in crosstool-NG, and/or are not mature enough to + be blindly trusted. Re-building an existing toolchain | ----------------------------------+