From 0fc1e86aac767b74729aa27f882210ce217b5e35 Mon Sep 17 00:00:00 2001
From: "Yann E. MORIN\"" <yann.morin.1998@anciens.enib.fr>
Date: Fri, 13 Jul 2007 14:25:06 +0000
Subject: Document CT_OBSOLETE, CT_EXPERIMENTAL and CT_BROKEN.


diff --git a/docs/overview.txt b/docs/overview.txt
index f49988d..9b30589 100644
--- a/docs/overview.txt
+++ b/docs/overview.txt
@@ -144,6 +144,27 @@ CT_TARGET_ALIAS:
   An alias for the toolchian. It will be used as a prefix to the toolchain
   tools. For example, you will have ${CT_TARGET_ALIAS}-gcc
 
+Also, if you think you don't see enough versions, you can try to enable one of
+those:
+
+CT_OBSOLETE:
+  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_BSOLETE.
+
+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.
+
+CT_BROKEN:
+  Show broken versions or tools. Some usefull tools are currently broken: they
+  won't compile, run, or worse, cause defects when running. But if you are
+  brave enough, you can try and debug them. They are hidden behind CT_BROKEN,
+  which itself is hiddent behind EXPERIMENTAL.
+
 ________________________
                        /
 Running crosstool-NG  /
-- 
cgit v0.10.2-6-g49f6