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(-)
1 # Options specific to downloading packages
7 prompt "Forbid downloads"
10 Normally, crosstool-NG will try to download missing tarballs (or
11 checkout from CVS/SVN...).
12 If you do not have network connectivity when you run crosstool-NG,
13 and some files are missing, it can be a long time before crosstool-NG
16 Saying 'y' here will prevent crosstool-NG from downloading missing
17 files, thus failing early so that you don't get stuck.
23 prompt "Force downloads"
26 Force downloading tarballs, even if one already exists.
28 Usefull if you suspect a tarball to be damaged.
32 prompt "Use LAN mirror"
35 If you have a machine on your LAN that mirrors some of the needed
36 tarballs, you can say 'Y' here, and configure adequate values in
37 the following options.
39 Tarballs will be be preferably fetched from the LAN mirror, and if
40 not found there, standard places will be searched for.
42 Obviously, nothing prevents you from using a mirror that is in fact
43 *not* on your LAN, for example on another subnet of your company's
44 network, or a mirror on the Internet.
50 prompt "Prefer the mirror"
53 Say 'Y' here if you prefer the LAN miror over the upstream sources.
55 config MIRROR_BASE_URL
58 default "http://ymorin.is-a-geek.org/mirrors/"
60 This is the base URL searched in for tarballs.
62 I (Yann E. MORIN) have set up such a mirror to host snapshots of
63 some components, when those snapshots are volatile on the upstream
64 servers. The mirror is *slow*, because it is hosted behind an ADSL
65 line. For the time being, I haven't set up bandwidth limitations,
66 but should the mirror be abused, I will. Please avoid using my
67 machine when you can... Also, no guarantee is made as to its
68 availability. Use at your own risks.
70 The mirror is available at:
71 http://ymorin.is-a-geek.org/mirrors/
75 # prompt "Use ls-lR et al."
76 depends on EXPERIMENTAL
79 If the tarball was not found at the above location, see if the server
80 has a ls-lr.gz (or similar) file, and use that file to see if the
81 tarball is listed somewhere in that file.
83 Common file names looked for are:
84 ls-lrRt.txt (used at ftp.gnu.org)
90 config CONNECT_TIMEOUT
92 prompt "connection timeout"
96 Maximum time in seconds that you allow the connection to the server to take.
98 The scenario is as follows;
99 - some enterprise networks have firewalls that prohibit FTP traffic, while
101 - most download sites have http:// equivalent for the ftp:// URL
102 - after this number of seconds, it is considered that the connection could
103 not be established, and the next URL in the list is tried, until we reach
104 an URL that will go through the firewall, most probably an http:// URL.
106 If you have a slow network, you'd better set this value higher than the default
107 10s. If you know a firewall is blocking connections, but your network is globally
108 fast, you can try to lower this value to jump more quickly to allowed URLs. YMMV.
110 Note that this value applies equally to wget if you have that installed.
114 prompt "Stop after downloading tarballs"
117 Only download the tarballs. Exit once it done.
119 Usefull to pre-retrieve the tarballs before going off-line.
121 endif # ! FORBID_DOWNLOAD