2 # Config.in.legacy - support for backward compatibility
4 # When an existing Config.in symbol is removed, it should be added again in
5 # this file, and take appropriate action to approximate backward compatibility.
6 # This will make the transition for the user more convenient.
8 # When adding legacy symbols to this file, add them to the front. The oldest
9 # symbols will be removed again after about two years.
11 # The symbol should be copied as-is from the place where it was previously
12 # defined, but the help text should be removed or replaced with something that
13 # explains how to fix it.
15 # For bool options, the old symbol should select BR2_LEGACY, so that the user
16 # is informed at build-time about selected legacy options.
17 # If there is an equivalent (set of) new symbols, these should be select'ed by
18 # the old symbol for backwards compatibility.
20 # For string options, it is not possible to directly select another symbol. In
21 # this case, a hidden wrap bool option has to be added, that defaults to y if
22 # the old string is not set at its default value. The wrap symbol should select
24 # If the original symbol has been renamed, the new symbol should use the value
25 # of the old symbol as default. This requires a change outside of
26 # Config.in.legacy, and this should be clearly marked as such below, so that
27 # removal of legacy options also include the removal of these external
30 # [Example: renaming a string option from FOO to BAR]
32 # config BR2_FOO_STRING
33 # string "Some foo string"
36 # config BR2_BAR_STRING
37 # string "Some bar string"
38 # default BR2_FOO_STRING if BR2_FOO_STRING != "" # legacy
40 # and in Config.in.legacy:
41 # config BR2_FOO_STRING
42 # string "The foo string has been renamed"
44 # <suitable help text>
46 # config BR2_FOO_STRING_WRAP
48 # default y if BR2_FOO_STRING != ""
51 # # Note: BR2_FOO_STRING is still referenced from package/foo/Config.in
58 This option is selected automatically when your old .config uses an
59 option that no longer exists in current buildroot. In that case, the
60 build will fail. Look for config options which are selected in the
61 menu below: they no longer exist and should be replaced by something
64 # This comment fits exactly in a 80-column display
65 comment "Legacy detected: check the content of the menu below"
68 menu "Legacy config options"
71 comment "----------------------------------------------------"
72 comment "Your old configuration uses legacy options that no "
73 comment "longer exist in buildroot, as indicated in the menu "
74 comment "below. As long as these options stay selected, or in"
75 comment "case of string options are non-empty, the build "
78 comment "Where possible, an automatic conversion from old to "
79 comment "new symbols has been performed. Before making any "
80 comment "change in this legacy menu, make sure to exit the "
81 comment "configuration editor a first time and save the "
82 comment "configuration. Otherwise, the automatic conversion "
83 comment "of symbols will be lost. "
85 comment "After this initial save, reopen the configuration "
86 comment "editor, inspect the options selected below, read "
87 comment "their help texts, and verify/update the new "
88 comment "configuration in the corresponding configuration "
89 comment "menus. When everything is ok, you can disable the "
90 comment "legacy options in the menu below. Once you have "
91 comment "disabled all legacy options, this text will "
92 comment "disappear and you will be able to start the build. "
94 comment "Note: at some point in the future, the oldest legacy"
95 comment "options will be removed, and configuration files "
96 comment "that still have those options set, will fail to "
97 comment "build, or run, in unpredictable ways. "
98 comment "----------------------------------------------------"
101 ###############################################################################
102 comment "Legacy options removed in 2014.05"
104 config BR2_KERNEL_HEADERS_SNAP
105 bool "Local Linux snapshot support removed"
108 Support for using a custom snapshot to install the Linux
109 kernel headers has been removed.
111 config BR2_ROOTFS_DEVICE_CREATION_DYNAMIC_UDEV
112 bool "/dev management by udev removed"
115 The 'udev' package has been converted to a virtual package.
116 The providers for this feature are: 'eudev', 'systemd'.
118 Therefore, if you are not using 'systemd' as init system, you
119 must choose 'Dynamic using eudev' in the '/dev management'
120 menu to get the same behaviour as in your old configuration.
122 If you are using 'systemd', its internal implementation of
123 'udev' will be used automatically.
125 You must also check the packages depending on 'udev' are still
128 config BR2_PACKAGE_UDEV
129 bool "udev is now a virtual package"
131 select BR2_PACKAGE_HAS_UDEV
133 The 'udev' package has been converted to a virtual package.
134 The providers for this feature are: 'eudev', 'systemd'.
136 Your old configuration refers to packages depending on 'udev',
137 either for build or at runtime.
139 Check that a 'udev' provider is selected. If you are not using
140 'systemd' as init system, 'eudev' should be selected, which is
141 the case if '/dev management' is set to 'Dynamic using eudev'.
143 If you are using 'systemd', its internal implementation of 'udev'
146 config BR2_PACKAGE_UDEV_RULES_GEN
147 bool "udev rules generation handled by provider"
149 select BR2_PACKAGE_EUDEV if !BR2_INIT_SYSTEMD
150 select BR2_PACKAGE_EUDEV_RULES_GEN if !BR2_INIT_SYSTEMD
152 The 'udev' package has been converted to a virtual package.
153 The providers for this feature are: 'eudev', 'systemd'.
155 If you are not using 'systemd' as init system, udev rules
156 generation will be handled by 'eudev'. Check that
157 '/dev management' is set to 'Dynamic using eudev' to get
158 the same behaviour as in your old configuration.
160 If you are using 'systemd', it internal implementation of 'udev'
161 will generate the rules.
163 config BR2_PACKAGE_UDEV_ALL_EXTRAS
164 bool "udev extras removed"
167 The 'udev' package has been converted to a virtual package.
168 The providers for this feature are: 'eudev', 'systemd'.
170 The option to enable the extra features of 'udev' (gudev, ...)
171 has been removed. These features are automatically enabled in
172 the 'udev' providers if the dependencies are selected. For
173 example, selecting 'libglib2' will trigger the build of gudev.
175 config BR2_PACKAGE_XLIB_LIBPTHREAD_STUBS
176 bool "xlib-libpthread-stubs option has been renamed"
177 depends on BR2_PACKAGE_XORG7
179 select BR2_PACKAGE_LIBPTHREAD_STUBS
181 The pthread stubs neither depend on X11 nor Xlib. Thus the
182 package has been renamed BR2_PACKAGE_LIBPTHREAD_STUBS
184 ###############################################################################
185 comment "Legacy options removed in 2014.02"
188 bool "sh2 support removed"
190 Due to an inexistent user base and generally poor Linux
191 support, the support for the SH2 architecture was removed.
194 bool "sh3 support removed"
196 Due to an inexistent user base and generally poor Linux
197 support, the support for the SH3 architecture was removed.
200 bool "sh3eb support removed"
202 Due to an inexistent user base and generally poor Linux
203 support, the support for the SH3eb architecture was removed.
205 config BR2_KERNEL_HEADERS_3_1
206 bool "kernel headers version 3.1.x are no longer supported"
207 select BR2_KERNEL_HEADERS_3_2
210 Version 3.1.x of the Linux kernel headers have been deprecated
211 for more than four buildroot releases and are now removed.
212 As an alternative, version 3.2.x of the headers have been
213 automatically selected in your configuration.
215 config BR2_KERNEL_HEADERS_3_3
216 bool "kernel headers version 3.3.x are no longer supported"
217 select BR2_KERNEL_HEADERS_3_4
220 Version 3.3.x of the Linux kernel headers have been deprecated
221 for more than four buildroot releases and are now removed.
222 As an alternative, version 3.4.x of the headers have been
223 automatically selected in your configuration.
225 config BR2_KERNEL_HEADERS_3_5
226 bool "kernel headers version 3.5.x are no longer supported"
227 select BR2_KERNEL_HEADERS_3_6
230 Version 3.5.x of the Linux kernel headers have been deprecated
231 for more than four buildroot releases and are now removed.
232 As an alternative, version 3.6.x of the headers have been
233 automatically selected in your configuration.
235 config BR2_GDB_VERSION_7_2
236 bool "gdb 7.2.x is no longer supported"
237 select BR2_GDB_VERSION_7_5
240 Version 7.2.x of gdb has been deprecated for more than four
241 buildroot releases and is now removed. As an alternative, gdb
242 7.5.x has been automatically selected in your configuration.
244 config BR2_GDB_VERSION_7_3
245 bool "gdb 7.3.x is no longer supported"
246 select BR2_GDB_VERSION_7_5
249 Version 7.3.x of gdb has been deprecated for more than four
250 buildroot releases and is now removed. As an alternative, gdb
251 7.5.x has been automatically selected in your configuration.
253 config BR2_PACKAGE_CCACHE
254 bool "ccache target package has been removed"
257 The 'ccache' target package has been removed since it has been
258 deprecated for more than four buildroot releases.
259 Note: using ccache for speeding up builds is still supported.
261 config BR2_HAVE_DOCUMENTATION
262 bool "support for documentation on target has been removed"
265 Support for documentation on target has been removed since it has
266 been deprecated for more than four buildroot releases.
268 config BR2_PACKAGE_AUTOMAKE
269 bool "automake target package has been removed"
272 The 'automake' target package has been removed since it has been
273 deprecated for more than four buildroot releases.
274 Note: the host automake still exists.
276 config BR2_PACKAGE_AUTOCONF
277 bool "autoconf target package has been removed"
280 The 'autoconf' target package has been removed since it has been
281 deprecated for more than four buildroot releases.
282 Note: the host autoconf still exists.
284 config BR2_PACKAGE_XSTROKE
285 bool "xstroke has been removed"
288 The 'xstroke' package has been removed since it has been
289 deprecated for more than four buildroot releases.
291 config BR2_PACKAGE_LZMA
292 bool "lzma target package has been removed"
295 The 'lzma' target package has been removed since it has been
296 deprecated for more than four buildroot releases.
297 Note: generating lzma-compressed rootfs images is still supported.
299 config BR2_PACKAGE_TTCP
300 bool "ttcp has been removed"
303 The 'ttcp' package has been removed since it has been
304 deprecated for more than four buildroot releases.
306 config BR2_PACKAGE_LIBNFC_LLCP
307 bool "libnfc-llcp has been replaced by libllcp"
309 select BR2_PACKAGE_LIBLLCP
311 The 'libnfc-llcp' package has been removed since upstream renamed
312 to 'libllcp'. We have added a new package for 'libllcp' and bumped
313 the version at the same time.
315 config BR2_PACKAGE_MYSQL_CLIENT
316 bool "MySQL client renamed to MySQL"
318 select BR2_PACKAGE_MYSQL
320 The option has been renamed BR2_PACKAGE_MYSQL
322 config BR2_PACKAGE_SQUASHFS3
323 bool "squashfs3 has been removed"
325 select BR2_PACKAGE_SQUASHFS
327 The 'squashfs3' package has been removed since it has been
328 deprecated for more than four buildroot releases. Package
329 'squashfs' (4) has been selected automatically as replacement.
331 config BR2_TARGET_ROOTFS_SQUASHFS3
332 bool "squashfs3 rootfs support has been removed"
335 Together with the removal of the squashfs3 package, support
336 for squashfs3 root filesystems has been removed too. Squashfs
337 root filesystems will automatically use squashfs4 now.
339 config BR2_PACKAGE_NETKITBASE
340 bool "netkitbase has been removed"
343 The 'netkitbase' package has been removed since it has been
344 deprecated since 2012.11. This package provided 'inetd'
345 which is replaced by 'xinet' and 'ping' which is replaced by
346 'busybox' or 'fping'.
348 config BR2_PACKAGE_NETKITTELNET
349 bool "netkittelnet has been removed"
352 The 'netkittelnet' package has been removed since it has
353 been deprecated since 2012.11. 'busybox' provides a telnet
354 client and should be used instead.
356 config BR2_PACKAGE_LUASQL
357 bool "luasql has been replaced by luasql-sqlite3"
358 select BR2_PACKAGE_LUASQL_SQLITE3
361 The option has been renamed BR2_PACKAGE_LUASQL_SQLITE3.
363 config BR2_PACKAGE_LUACJSON
364 bool "luacjson has been replaced by lua-cjson"
365 select BR2_PACKAGE_LUA_CJSON
368 The option has been renamed BR2_PACKAGE_LUA_CJSON.
370 ###############################################################################
371 comment "Legacy options removed in 2013.11"
373 config BR2_PACKAGE_LVM2_DMSETUP_ONLY
374 bool "lvm2's 'dmsetup only' option removed"
377 The BR2_PACKAGE_LVM2_DMSETUP_ONLY was a negative option, which
378 led to problems with other packages that need the full lvm2
379 suite. Therefore, the option has been replaced with the positive
380 BR2_PACKAGE_LVM2_STANDARD_INSTALL option.
382 # Note: BR2_PACKAGE_LVM2_DMSETUP_ONLY is still referenced in package/lvm2/Config.in
383 # in order to automatically propagate old configs
385 config BR2_PACKAGE_QT_JAVASCRIPTCORE
386 bool "qt javascriptcore option removed"
389 The BR2_PACKAGE_QT_JAVASCRIPTCORE option was available to
390 force the activation or disabling of the JIT compiler in the
391 Qt Javascript interpreter. However, the JIT compiler is not
392 available for all architectures, so forcing its activation
393 does not always work. Moreover, Qt knows by itself for which
394 architectures JIT support is possible, and will
395 automatically enable it if possible.
397 Therefore, this option was in fact useless, and causing
398 build problems when enabled on architectures for which the
399 JIT support was not available. It has been removed, and
400 there is no replacement: Qt will enable JIT at compile time
403 config BR2_PACKAGE_MODULE_INIT_TOOLS
404 bool "module-init-tools replaced by kmod"
405 select BR2_PACKAGE_KMOD
406 select BR2_PACKAGE_KMOD_TOOLS
409 The 'module-init-tools' package has been removed, since it
410 has been depracated upstream and replaced by 'kmod'.
412 config BR2_TARGET_UBOOT_CUSTOM_GIT_REPO_URL
413 string "u-boot: the git repository URL option has been renamed"
415 The option BR2_TARGET_UBOOT_CUSTOM_GIT_REPO_URL has
416 been renamed to BR2_TARGET_UBOOT_CUSTOM_REPO_URL.
418 config BR2_TARGET_UBOOT_CUSTOM_GIT_REPO_URL_WRAP
420 default y if BR2_TARGET_UBOOT_CUSTOM_GIT_REPO_URL != ""
423 # Note: BR2_TARGET_UBOOT_CUSTOM_GIT_REPO_URL is still referenced from
424 # boot/uboot/Config.in
426 config BR2_TARGET_UBOOT_CUSTOM_GIT_VERSION
427 string "u-boot: the git repository version option has been renamed"
429 The option BR2_TARGET_UBOOT_CUSTOM_GIT_VERSION has
430 been renamed to BR2_TARGET_UBOOT_CUSTOM_REPO_VERSION.
432 config BR2_TARGET_UBOOT_CUSTOM_GIT_VERSION_WRAP
434 default y if BR2_TARGET_UBOOT_CUSTOM_GIT_VERSION != ""
437 # Note: BR2_TARGET_UBOOT_CUSTOM_GIT_VERSION is still referenced from
438 # boot/uboot/Config.in
440 config BR2_LINUX_KERNEL_CUSTOM_GIT_REPO_URL
441 string "linux: the git repository URL option has been renamed"
443 The option BR2_LINUX_KERNEL_CUSTOM_GIT_REPO_URL has
445 BR2_LINUX_KERNEL_CUSTOM_REPO_URL.
447 config BR2_LINUX_KERNEL_CUSTOM_GIT_REPO_URL_WRAP
449 default y if BR2_LINUX_KERNEL_CUSTOM_GIT_REPO_URL != ""
452 # Note: BR2_LINUX_KERNEL_CUSTOM_GIT_REPO_URL is still referenced from
455 config BR2_LINUX_KERNEL_CUSTOM_GIT_VERSION
456 string "linux: the git repository version option has been renamed"
458 The option BR2_LINUX_KERNEL_CUSTOM_GIT_VERSION has
460 BR2_LINUX_KERNEL_CUSTOM_REPO_VERSION.
462 config BR2_LINUX_KERNEL_CUSTOM_GIT_VERSION_WRAP
464 default y if BR2_LINUX_KERNEL_CUSTOM_GIT_VERSION != ""
467 # Note: BR2_LINUX_KERNEL_CUSTOM_GIT_VERSION is still referenced from
470 ###############################################################################
471 comment "Legacy options removed in 2013.08"
474 bool "ARM OABI support has been removed"
477 The support for the ARM OABI was deprecated since a while,
478 and has been removed completely from Buildroot. It is also
479 deprecated in upstream gcc, since gcc 4.7. People should
480 switch to EABI instead, which should not be a problem as
481 long as you don't have pre-built OABI binaries in your
482 system that you can't recompile.
484 config BR2_PACKAGE_DOSFSTOOLS_DOSFSCK
485 bool "dosfstools dosfsck renamed to fsck.fat"
487 select BR2_PACKAGE_DOSFSTOOLS_FSCK_FAT
489 dosfsck was renamed upstream to fsck.fat for consistency.
491 config BR2_PACKAGE_DOSFSTOOLS_DOSFSLABEL
492 bool "dosfstools dosfslabel renamed to fatlabel"
494 select BR2_PACKAGE_DOSFSTOOLS_FATLABEL
496 doslabel was renamed upstream to fatlabel for consistency.
498 config BR2_PACKAGE_DOSFSTOOLS_MKDOSFS
499 bool "dosfstools mkdosfs renamed to mkfs.fat"
501 select BR2_PACKAGE_DOSFSTOOLS_MKFS_FAT
503 mkdosfs was renamed upstream to mkfs.fat for consistency.
506 bool "the elf2flt option has been renamed"
509 The BR2_ELF2FLT option has been renamed to
510 BR2_PACKAGE_HOST_ELF2FLT due to the conversion of elf2flt to
511 the package infrastructure.
514 bool "the ARM VFP floating point option has been renamed"
517 Due to a major refactoring of the floating-point handling of
518 the ARM architecture support, the BR2_VFP_FLOAT option has
519 been replaced with a choice of options that allows to select
520 between various VFP versions/capabilities.
522 config BR2_PACKAGE_GCC_TARGET
523 bool "gcc on the target filesystem has been removed"
526 The support for gcc in the target filesystem was deprecated
527 since a while, and has been removed completely from Buildroot.
528 See Buildroot's documentation for more explanations.
530 config BR2_HAVE_DEVFILES
531 bool "development files in target filesystem has been removed"
534 The installation of the development files in the target
535 filesystem was deprecated since a while, and has been removed
536 completely from Buildroot.
537 See Buildroot's documentation for more explanations.
539 ###############################################################################
540 comment "Legacy options removed in 2013.05"
542 config BR2_PACKAGE_LINUX_FIRMWARE_RTL_8192
543 bool "Realtek 8192 replaced by Realtek 81xx"
545 select BR2_PACKAGE_LINUX_FIRMWARE_RTL_81XX
547 Now covers the whole Realtek 81xx familly: 8188/8192.
549 config BR2_PACKAGE_LINUX_FIRMWARE_RTL_8712
550 bool "Realtek 8712 replaced by Realtek 87xx"
552 select BR2_PACKAGE_LINUX_FIRMWARE_RTL_87XX
554 Now covers the whole Realtek 87xx familly: 8712/8723.
556 ###############################################################################
557 comment "Legacy options removed in 2013.02"
560 bool "sa110 ARM target switched to strongarm"
564 The SA110 is the same as a generic StrongARM, it just differs
565 in speed, peripherals and cache.
568 bool "sa1100 ARM target switched to strongarm"
572 The SA1100 is the same as a generic StrongARM, it just differs
573 in speed, peripherals and cache.
575 config BR2_PACKAGE_GDISK
576 bool "gdisk has been replaced by gptfdisk"
578 select BR2_PACKAGE_GPTFDISK
580 The option has been renamed BR2_PACKAGE_GPTFDISK.
582 config BR2_PACKAGE_GDISK_GDISK
583 bool "gdisk tool from gdisk has been replaced by gdisk in gptfdisk"
585 select BR2_PACKAGE_GPTFDISK
586 select BR2_PACKAGE_GPTFDISK_GDISK
588 The option has been renamed BR2_PACKAGE_GPTFDISK_GDISK.
590 config BR2_PACKAGE_GDISK_SGDISK
591 bool "sgdisk tool from gdisk has been replaced by sgdisk in gptfdisk"
593 select BR2_PACKAGE_GPTFDISK
594 select BR2_PACKAGE_GPTFDISK_SGDISK
596 The option has been renamed BR2_PACKAGE_GPTFDISK_SGDISK.
598 config BR2_PACKAGE_GDB_HOST
599 bool "gdb for the host option has been renamed"
600 select BR2_PACKAGE_HOST_GDB
603 Due to the conversion of gdb to the package infrastructure,
604 the BR2_PACKAGE_GDB_HOST option has been renamed
605 BR2_PACKAGE_HOST_GDB.
607 config BR2_PACKAGE_DIRECTB_DITHER_RGB16
608 bool "DirectFB RGB16 dithering option has been renamed"
609 select BR2_PACKAGE_DIRECTFB_DITHER_RGB16
612 The option has been renamed
613 BR2_PACKAGE_DIRECTFB_DITHER_RGB16.
615 config BR2_PACKAGE_DIRECTB_TESTS
616 bool "DirectFB Tests option has been renamed"
617 select BR2_PACKAGE_DIRECTFB_TESTS
620 The option has been renamed
621 BR2_PACKAGE_DIRECTFB_TESTS.
623 ###############################################################################
624 comment "Legacy options removed in 2012.11"
626 config BR2_PACKAGE_CUSTOMIZE
627 bool "customize package has been removed"
630 The 'customize' special package has been removed. Instead,
631 we recommend to create either your own packages, or use a
632 post-build script to customize your root filesystem. See
633 Buildroot's documentation for more details.
635 config BR2_PACKAGE_XSERVER_xorg
636 bool "X.org modular server"
638 select BR2_PACKAGE_XSERVER_XORG_SERVER_MODULAR
640 The option has been renamed
641 BR2_PACKAGE_XSERVER_XORG_SERVER_MODULAR.
643 config BR2_PACKAGE_XSERVER_tinyx
644 bool "KDrive / TinyX server"
646 select BR2_PACKAGE_XSERVER_XORG_SERVER_KDRIVE
648 The option has been renamed
649 BR2_PACKAGE_XSERVER_XORG_SERVER_KDRIVE.
651 config BR2_PACKAGE_PTHREAD_STUBS
652 bool "pthread-stubs option has been renamed"
654 select BR2_PACKAGE_LIBPTHREAD_STUBS
656 For consistency reason, the pthread-stubs package has been
657 renamed to libpthread-stubs.
659 ###############################################################################
660 comment "Legacy options removed in 2012.08"
662 config BR2_PACKAGE_GETTEXT_STATIC
663 bool "libgettext.a is now selected by BR2_PREFER_STATIC_LIB"
666 To build a static gettext library, select BR2_PREFER_STATIC_LIB.
669 config BR2_PACKAGE_LIBINTL
672 select BR2_PACKAGE_GETTEXT
674 libintl is now installed by selecting BR2_PACKAGE_GETTEXT. This now
675 only installs the library, not the executables.
677 config BR2_PACKAGE_INPUT_TOOLS_EVTEST
678 bool "input-tools evtest is now a separate package evtest"
680 select BR2_PACKAGE_EVTEST
682 The evtest program from input-tools is now a separate package.
684 config BR2_BFIN_FDPIC
685 bool "BR2_BFIN_FDPIC is now BR2_BINFMT_FDPIC"
686 select BR2_BINFMT_FDPIC
690 bool "BR2_BFIN_FLAT is now BR2_BINFMT_FLAT"
691 select BR2_BINFMT_FLAT