config/toolchain.in
author Andrzej Bieniek <andyhelp@gmail.com>
Sun Aug 26 10:35:20 2012 +0100 (2012-08-26)
changeset 3042 08aecbc69f12
parent 2936 2dfea349d307
child 3150 1d6fd9bde73c
permissions -rw-r--r--
config/toolchain: fixed typo in help string

Signed-off-by: "Andrzej Bieniek" <andyhelp@gmail.com>
     1 menu "Toolchain options"
     2 
     3 comment "General toolchain options"
     4 
     5 config FORCE_SYSROOT
     6     bool
     7     default y if !OBSOLETE
     8     select USE_SYSROOT
     9 
    10 config USE_SYSROOT
    11     bool
    12     prompt "Use sysroot'ed toolchain"
    13     default y
    14     help
    15       Use the 'shinny new' sysroot feature of gcc: libraries split between
    16       prefix/target/sysroot/lib and prefix/target/sysroot/usr/lib
    17       
    18       You definitely want to say 'Y' here. Yes you do. I know you do. Say 'Y'.
    19 
    20 config SYSROOT_NAME
    21     string
    22     prompt "sysroot directory name" if ! BACKEND
    23     depends on USE_SYSROOT
    24     default "sysroot"
    25     help
    26       Enter the base name of the sysroot directory. Usually, this simply
    27       is 'sysroot' (the default) or 'sys-root'.
    28       
    29       You are free to enter anything here, except for spaces, and '/'
    30       (see SYSROOT_DIR_PREFIX, below). If you leave this empty, then the
    31       default 'sysroot' is used.
    32 
    33 config SYSROOT_DIR_PREFIX
    34     string
    35     prompt "sysroot prefix dir (READ HELP)" if ! BACKEND
    36     depends on USE_SYSROOT
    37     default ""
    38     help
    39       *
    40       * Unless you really know you need that, leave it empty!
    41       *
    42       
    43       This string will be interpreted as a directory component to be added
    44       to the sysroot path, just before the actual sysroot directory.
    45       
    46       In fact, the sysroot path is constructed as:
    47         ${CT_PREFIX_DIR}/${CT_TARGET}/${CT_SYSROOT_DIR_PREFIX}/${CT_SYSROOT_NAME}
    48 
    49 config WANTS_STATIC_LINK
    50     bool
    51 
    52 config STATIC_TOOLCHAIN
    53     bool
    54     prompt "Build Static Toolchain (EXPERIMENTAL)"
    55     depends on EXPERIMENTAL
    56     select WANTS_STATIC_LINK
    57     help
    58       Build static host binaries.
    59       
    60       If you wish to move the toolchain to another host, and you are not
    61       confident that this host has the required versions of system libs, then
    62       you can say 'Y' here, and all the host tools will be linked statically.
    63       
    64       The impacted tools are:
    65         - the cross-binutils (GNU binutils, elf2flt)
    66         - the cross-compiler (gcc)
    67         - the cross-debugger (gdb)
    68       
    69       The default is 'N', to build dynamicaly-linked host binaries.
    70       
    71       NOTE: this has no connection to whether the target libraries will be
    72       dynamic or static. This only applies to the tools themselves.
    73 
    74 config TOOLCHAIN_PKGVERSION
    75     string
    76     prompt "Toolchain ID string"
    77     default ""
    78     help
    79       Specify a string that identifies your package. You may wish to include
    80       a build number or build date. This version string will be included in
    81       the output of gcc --version, and also in binutils, eglibc, gdb and
    82       gdbserver.
    83 
    84       If this string is left empty, the actual package version will be:
    85           "crosstool-NG ${CT_VERSION}"
    86       Otherwise, it will be:
    87           "crosstool-NG ${CT_VERSION} - ${CT_TOOLCHAIN_PKGVERSION}"
    88 
    89       This is passed to the configure flag --with-pkgversion.
    90 
    91 config TOOLCHAIN_BUGURL
    92     string
    93     prompt "Toolchain bug URL"
    94     default ""
    95     help
    96       Specify the URL that users should visit if they wish to report a bug.
    97 
    98 comment "Tuple completion and aliasing"
    99 
   100 config TARGET_VENDOR
   101     string
   102     prompt "Tuple's vendor string"
   103     default "unknown"
   104     help
   105       Vendor part of the target tuple.
   106       
   107       A tuple is of the form arch-vendor-kernel-system.
   108       You can set the second part, vendor, to whatever you see fit.
   109       Use a single word, or use underscores "_" to separate words.
   110       Use neither dash nor space, as it breaks things.
   111       
   112       Keep the default (unknown) if you don't know better.
   113 
   114 config TARGET_ALIAS_SED_EXPR
   115     string
   116     prompt "Tuple's sed transform"
   117     default ""
   118     help
   119       Normally, you'd call your toolchain components (especially gcc) by
   120       prefixing the target tuple followed by a dash and the component name
   121       (eg. armeb-unknown-linux-uclibc-gcc).
   122       
   123       You can enter here a sed expression to be applied to ${CT_TARGET} to
   124       create an alias for your toolchain.
   125       
   126       For example, "s/${CT_TARGET_VENDOR}/foobar/" (without the double quotes)
   127       will create the armeb-foobar-linux-uclibc alias to the above-mentioned
   128       toolchain.
   129       
   130       You shouldn't need to enter anything here, unless you plan to manually
   131       call the tools (autotools-based ./configure will use the standard name).
   132 
   133 config TARGET_ALIAS
   134     string
   135     prompt "Tuple's alias"
   136     default ""
   137     help
   138       Normally, you'd call your toolchain components (especially gcc) by
   139       prefixing the target tuple followed by a dash and the component name
   140       (eg. armeb-unknown-linux-uclibc-gcc).
   141       
   142       You can enter a shortcut here. This string will be used to create
   143       symbolic links to the toolchain tools (eg. if you enter "foo-bar" here,
   144       then gcc for your toolchain will also be available as "foo-bar-gcc" along
   145       with the original name).
   146       
   147       You shouldn't need to enter anything here, unless you plan to manually
   148       call the tools (autotools-based ./configure will use the standard name).
   149 
   150 comment "Toolchain type"
   151 
   152 choice
   153     bool
   154     prompt "Type"
   155     default CROSS
   156 
   157 config NATIVE
   158     bool
   159     prompt "Native       (NO CODE!) (EXPERIMENTAL)"
   160     depends on EXPERIMENTAL
   161     help
   162       Build a native toolchain.
   163       See: "docs/6 - Toolchain types.txt"
   164 
   165 config CROSS
   166     bool
   167     prompt "Cross"
   168     help
   169       Build a cross-toolchain.
   170       See: "docs/6 - Toolchain types.txt"
   171 
   172 config CROSS_NATIVE
   173     bool
   174     prompt "Cross-native (NO CODE!) (EXPERIMENTAL)"
   175     depends on EXPERIMENTAL
   176     help
   177       Build a cross-native toolchain.
   178       See: "docs/6 - Toolchain types.txt"
   179 
   180 config CANADIAN
   181     bool
   182     prompt "Canadian     (EXPERIMENTAL)"
   183     depends on EXPERIMENTAL
   184     help
   185       Build a canadian-toolchain.
   186       See: "docs/6 - Toolchain types.txt"
   187 
   188 endchoice
   189 
   190 config TOOLCHAIN_TYPE
   191     string
   192     default "native"        if NATIVE
   193     default "cross"         if CROSS
   194     default "cross-native"  if CROSS_NATIVE
   195     default "canadian"      if CANADIAN
   196 
   197 comment "Build system"
   198 
   199 config BUILD
   200     string
   201     prompt "|  Tuple        (READ HELP!)"
   202     default ""
   203     help
   204       Canonical name of the machine building the toolchain.
   205       You should leave empty, unless you really know what you're doing.
   206 
   207 config BUILD_PREFIX
   208     string
   209     prompt "|  Tools prefix (READ HELP!)"
   210     default ""
   211     help
   212       If you have your *build system* tools in a weird location, and/or
   213       they have an unusual prefix, enter it here.
   214       
   215       Usually, you should leave that empty!
   216       
   217       Eg.:
   218         If your *build* gcc is /opt/build-tools/bin/weird-gcc then you
   219         should enter:
   220             /opt/build-tools/bin/weird-
   221         
   222         If your *build* gcc is /opt/build-tools/bin/weird-gcc and
   223         /opt/build-tools/bin is in your PATH, you should enter:
   224             weird-
   225         
   226         If your *build* gcc is /opt/build-tools/bin/gcc then you
   227         should enter (do not forget to add the trailing '/'):
   228             /opt/build-tools/bin/
   229 
   230 config BUILD_SUFFIX
   231     string
   232     prompt "|  Tools suffix (READ HELP!)"
   233     default ""
   234     help
   235       If your *build system* tools have an unusual suffix, enter it
   236       here.
   237       
   238       Usually, you should leave that empty!
   239       
   240       Eg.:
   241         If your 'default' gcc is gcc 4.3.1, but you also have gcc-3.4.2
   242         installed as gcc-3.4, then you should enter:
   243             -3.4
   244       
   245       It can happen that some of the tools have a suffix, when others
   246       don't, eg. you can have 'gcc-3.4' and 'ar'. crosstool-NG accounts
   247       for that by checking the tools without the suffix in case it can
   248       not find some of the tool.
   249 
   250 if CANADIAN
   251 
   252 comment "Host system"
   253 
   254 config HOST
   255     string
   256     prompt "|  Tuple        (READ HELP!)"
   257     default ""
   258     help
   259       Canonical name of the machine running the toolchain.
   260 
   261 config HOST_PREFIX
   262     string
   263     prompt "|  Tools prefix (READ HELP!)"
   264     default ""
   265     help
   266       If you have your *host system* tools in a weird location, and/or
   267       they have an unusual prefix, enter it here.
   268       
   269       Usually, you should leave that empty!
   270       
   271       Eg.:
   272         If your *host* gcc is /opt/host-tools/bin/weird-gcc then you
   273         should enter:
   274             /opt/host-tools/bin/weird-
   275         
   276         If your *host* gcc is /opt/host-tools/bin/weird-gcc and
   277         /opt/host-tools/bin is in your PATH, you should enter:
   278             weird-
   279         
   280         If your *host* gcc is /opt/host-tools/bin/gcc then you
   281         should enter (do not forget to add the trailing '/'):
   282             /opt/host-tools/bin/
   283 
   284 config HOST_SUFFIX
   285     string
   286     prompt "|  Tools suffix (READ HELP!)"
   287     default ""
   288     help
   289       If your *host system* tools have an unusual suffix, enter it
   290       here.
   291       
   292       Usually, you should leave that empty!
   293       
   294       Eg.:
   295         If your 'default' gcc is gcc 4.3.1, but you also have gcc-3.4.2
   296         installed as gcc-3.4, then you should enter:
   297             -3.4
   298       
   299       It can happen that some of the tools have a suffix, when others
   300       don't, eg. you can have 'gcc-3.4' and 'ar'. crosstool-NG accounts
   301       for that by checking the tools without the suffix in case it can
   302       not find some of the tool.
   303 
   304 endif # CANADIAN
   305 
   306 comment "Misc options"
   307 
   308 config TOOLCHAIN_ENABLE_NLS
   309     bool
   310     prompt "Enable nls"
   311     help
   312       Say 'Y' here to enable native language support (nls).
   313 
   314 endmenu