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 ###############################################################################
176 comment "Legacy options removed in 2014.02"
179 bool "sh2 support removed"
181 Due to an inexistent user base and generally poor Linux
182 support, the support for the SH2 architecture was removed.
185 bool "sh3 support removed"
187 Due to an inexistent user base and generally poor Linux
188 support, the support for the SH3 architecture was removed.
191 bool "sh3eb support removed"
193 Due to an inexistent user base and generally poor Linux
194 support, the support for the SH3eb architecture was removed.
196 config BR2_KERNEL_HEADERS_3_1
197 bool "kernel headers version 3.1.x are no longer supported"
198 select BR2_KERNEL_HEADERS_3_2
201 Version 3.1.x of the Linux kernel headers have been deprecated
202 for more than four buildroot releases and are now removed.
203 As an alternative, version 3.2.x of the headers have been
204 automatically selected in your configuration.
206 config BR2_KERNEL_HEADERS_3_3
207 bool "kernel headers version 3.3.x are no longer supported"
208 select BR2_KERNEL_HEADERS_3_4
211 Version 3.3.x of the Linux kernel headers have been deprecated
212 for more than four buildroot releases and are now removed.
213 As an alternative, version 3.4.x of the headers have been
214 automatically selected in your configuration.
216 config BR2_KERNEL_HEADERS_3_5
217 bool "kernel headers version 3.5.x are no longer supported"
218 select BR2_KERNEL_HEADERS_3_6
221 Version 3.5.x of the Linux kernel headers have been deprecated
222 for more than four buildroot releases and are now removed.
223 As an alternative, version 3.6.x of the headers have been
224 automatically selected in your configuration.
226 config BR2_GDB_VERSION_7_2
227 bool "gdb 7.2.x is no longer supported"
228 select BR2_GDB_VERSION_7_5
231 Version 7.2.x of gdb has been deprecated for more than four
232 buildroot releases and is now removed. As an alternative, gdb
233 7.5.x has been automatically selected in your configuration.
235 config BR2_GDB_VERSION_7_3
236 bool "gdb 7.3.x is no longer supported"
237 select BR2_GDB_VERSION_7_5
240 Version 7.3.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_PACKAGE_CCACHE
245 bool "ccache target package has been removed"
248 The 'ccache' target package has been removed since it has been
249 deprecated for more than four buildroot releases.
250 Note: using ccache for speeding up builds is still supported.
252 config BR2_HAVE_DOCUMENTATION
253 bool "support for documentation on target has been removed"
256 Support for documentation on target has been removed since it has
257 been deprecated for more than four buildroot releases.
259 config BR2_PACKAGE_AUTOMAKE
260 bool "automake target package has been removed"
263 The 'automake' target package has been removed since it has been
264 deprecated for more than four buildroot releases.
265 Note: the host automake still exists.
267 config BR2_PACKAGE_AUTOCONF
268 bool "autoconf target package has been removed"
271 The 'autoconf' target package has been removed since it has been
272 deprecated for more than four buildroot releases.
273 Note: the host autoconf still exists.
275 config BR2_PACKAGE_XSTROKE
276 bool "xstroke has been removed"
279 The 'xstroke' package has been removed since it has been
280 deprecated for more than four buildroot releases.
282 config BR2_PACKAGE_LZMA
283 bool "lzma target package has been removed"
286 The 'lzma' target package has been removed since it has been
287 deprecated for more than four buildroot releases.
288 Note: generating lzma-compressed rootfs images is still supported.
290 config BR2_PACKAGE_TTCP
291 bool "ttcp has been removed"
294 The 'ttcp' package has been removed since it has been
295 deprecated for more than four buildroot releases.
297 config BR2_PACKAGE_LIBNFC_LLCP
298 bool "libnfc-llcp has been replaced by libllcp"
300 select BR2_PACKAGE_LIBLLCP
302 The 'libnfc-llcp' package has been removed since upstream renamed
303 to 'libllcp'. We have added a new package for 'libllcp' and bumped
304 the version at the same time.
306 config BR2_PACKAGE_MYSQL_CLIENT
307 bool "MySQL client renamed to MySQL"
309 select BR2_PACKAGE_MYSQL
311 The option has been renamed BR2_PACKAGE_MYSQL
313 config BR2_PACKAGE_SQUASHFS3
314 bool "squashfs3 has been removed"
316 select BR2_PACKAGE_SQUASHFS
318 The 'squashfs3' package has been removed since it has been
319 deprecated for more than four buildroot releases. Package
320 'squashfs' (4) has been selected automatically as replacement.
322 config BR2_TARGET_ROOTFS_SQUASHFS3
323 bool "squashfs3 rootfs support has been removed"
326 Together with the removal of the squashfs3 package, support
327 for squashfs3 root filesystems has been removed too. Squashfs
328 root filesystems will automatically use squashfs4 now.
330 config BR2_PACKAGE_NETKITBASE
331 bool "netkitbase has been removed"
334 The 'netkitbase' package has been removed since it has been
335 deprecated since 2012.11. This package provided 'inetd'
336 which is replaced by 'xinet' and 'ping' which is replaced by
337 'busybox' or 'fping'.
339 config BR2_PACKAGE_NETKITTELNET
340 bool "netkittelnet has been removed"
343 The 'netkittelnet' package has been removed since it has
344 been deprecated since 2012.11. 'busybox' provides a telnet
345 client and should be used instead.
347 config BR2_PACKAGE_LUASQL
348 bool "luasql has been replaced by luasql-sqlite3"
349 select BR2_PACKAGE_LUASQL_SQLITE3
352 The option has been renamed BR2_PACKAGE_LUASQL_SQLITE3.
354 config BR2_PACKAGE_LUACJSON
355 bool "luacjson has been replaced by lua-cjson"
356 select BR2_PACKAGE_LUA_CJSON
359 The option has been renamed BR2_PACKAGE_LUA_CJSON.
361 ###############################################################################
362 comment "Legacy options removed in 2013.11"
364 config BR2_PACKAGE_LVM2_DMSETUP_ONLY
365 bool "lvm2's 'dmsetup only' option removed"
368 The BR2_PACKAGE_LVM2_DMSETUP_ONLY was a negative option, which
369 led to problems with other packages that need the full lvm2
370 suite. Therefore, the option has been replaced with the positive
371 BR2_PACKAGE_LVM2_STANDARD_INSTALL option.
373 # Note: BR2_PACKAGE_LVM2_DMSETUP_ONLY is still referenced in package/lvm2/Config.in
374 # in order to automatically propagate old configs
376 config BR2_PACKAGE_QT_JAVASCRIPTCORE
377 bool "qt javascriptcore option removed"
380 The BR2_PACKAGE_QT_JAVASCRIPTCORE option was available to
381 force the activation or disabling of the JIT compiler in the
382 Qt Javascript interpreter. However, the JIT compiler is not
383 available for all architectures, so forcing its activation
384 does not always work. Moreover, Qt knows by itself for which
385 architectures JIT support is possible, and will
386 automatically enable it if possible.
388 Therefore, this option was in fact useless, and causing
389 build problems when enabled on architectures for which the
390 JIT support was not available. It has been removed, and
391 there is no replacement: Qt will enable JIT at compile time
394 config BR2_PACKAGE_MODULE_INIT_TOOLS
395 bool "module-init-tools replaced by kmod"
396 select BR2_PACKAGE_KMOD
397 select BR2_PACKAGE_KMOD_TOOLS
400 The 'module-init-tools' package has been removed, since it
401 has been depracated upstream and replaced by 'kmod'.
403 config BR2_TARGET_UBOOT_CUSTOM_GIT_REPO_URL
404 string "u-boot: the git repository URL option has been renamed"
406 The option BR2_TARGET_UBOOT_CUSTOM_GIT_REPO_URL has
407 been renamed to BR2_TARGET_UBOOT_CUSTOM_REPO_URL.
409 config BR2_TARGET_UBOOT_CUSTOM_GIT_REPO_URL_WRAP
411 default y if BR2_TARGET_UBOOT_CUSTOM_GIT_REPO_URL != ""
414 # Note: BR2_TARGET_UBOOT_CUSTOM_GIT_REPO_URL is still referenced from
415 # boot/uboot/Config.in
417 config BR2_TARGET_UBOOT_CUSTOM_GIT_VERSION
418 string "u-boot: the git repository version option has been renamed"
420 The option BR2_TARGET_UBOOT_CUSTOM_GIT_VERSION has
421 been renamed to BR2_TARGET_UBOOT_CUSTOM_REPO_VERSION.
423 config BR2_TARGET_UBOOT_CUSTOM_GIT_VERSION_WRAP
425 default y if BR2_TARGET_UBOOT_CUSTOM_GIT_VERSION != ""
428 # Note: BR2_TARGET_UBOOT_CUSTOM_GIT_VERSION is still referenced from
429 # boot/uboot/Config.in
431 config BR2_LINUX_KERNEL_CUSTOM_GIT_REPO_URL
432 string "linux: the git repository URL option has been renamed"
434 The option BR2_LINUX_KERNEL_CUSTOM_GIT_REPO_URL has
436 BR2_LINUX_KERNEL_CUSTOM_REPO_URL.
438 config BR2_LINUX_KERNEL_CUSTOM_GIT_REPO_URL_WRAP
440 default y if BR2_LINUX_KERNEL_CUSTOM_GIT_REPO_URL != ""
443 # Note: BR2_LINUX_KERNEL_CUSTOM_GIT_REPO_URL is still referenced from
446 config BR2_LINUX_KERNEL_CUSTOM_GIT_VERSION
447 string "linux: the git repository version option has been renamed"
449 The option BR2_LINUX_KERNEL_CUSTOM_GIT_VERSION has
451 BR2_LINUX_KERNEL_CUSTOM_REPO_VERSION.
453 config BR2_LINUX_KERNEL_CUSTOM_GIT_VERSION_WRAP
455 default y if BR2_LINUX_KERNEL_CUSTOM_GIT_VERSION != ""
458 # Note: BR2_LINUX_KERNEL_CUSTOM_GIT_VERSION is still referenced from
461 ###############################################################################
462 comment "Legacy options removed in 2013.08"
465 bool "ARM OABI support has been removed"
468 The support for the ARM OABI was deprecated since a while,
469 and has been removed completely from Buildroot. It is also
470 deprecated in upstream gcc, since gcc 4.7. People should
471 switch to EABI instead, which should not be a problem as
472 long as you don't have pre-built OABI binaries in your
473 system that you can't recompile.
475 config BR2_PACKAGE_DOSFSTOOLS_DOSFSCK
476 bool "dosfstools dosfsck renamed to fsck.fat"
478 select BR2_PACKAGE_DOSFSTOOLS_FSCK_FAT
480 dosfsck was renamed upstream to fsck.fat for consistency.
482 config BR2_PACKAGE_DOSFSTOOLS_DOSFSLABEL
483 bool "dosfstools dosfslabel renamed to fatlabel"
485 select BR2_PACKAGE_DOSFSTOOLS_FATLABEL
487 doslabel was renamed upstream to fatlabel for consistency.
489 config BR2_PACKAGE_DOSFSTOOLS_MKDOSFS
490 bool "dosfstools mkdosfs renamed to mkfs.fat"
492 select BR2_PACKAGE_DOSFSTOOLS_MKFS_FAT
494 mkdosfs was renamed upstream to mkfs.fat for consistency.
497 bool "the elf2flt option has been renamed"
500 The BR2_ELF2FLT option has been renamed to
501 BR2_PACKAGE_HOST_ELF2FLT due to the conversion of elf2flt to
502 the package infrastructure.
505 bool "the ARM VFP floating point option has been renamed"
508 Due to a major refactoring of the floating-point handling of
509 the ARM architecture support, the BR2_VFP_FLOAT option has
510 been replaced with a choice of options that allows to select
511 between various VFP versions/capabilities.
513 config BR2_PACKAGE_GCC_TARGET
514 bool "gcc on the target filesystem has been removed"
517 The support for gcc in the target filesystem was deprecated
518 since a while, and has been removed completely from Buildroot.
519 See Buildroot's documentation for more explanations.
521 config BR2_HAVE_DEVFILES
522 bool "development files in target filesystem has been removed"
525 The installation of the development files in the target
526 filesystem was deprecated since a while, and has been removed
527 completely from Buildroot.
528 See Buildroot's documentation for more explanations.
530 ###############################################################################
531 comment "Legacy options removed in 2013.05"
533 config BR2_PACKAGE_LINUX_FIRMWARE_RTL_8192
534 bool "Realtek 8192 replaced by Realtek 81xx"
536 select BR2_PACKAGE_LINUX_FIRMWARE_RTL_81XX
538 Now covers the whole Realtek 81xx familly: 8188/8192.
540 config BR2_PACKAGE_LINUX_FIRMWARE_RTL_8712
541 bool "Realtek 8712 replaced by Realtek 87xx"
543 select BR2_PACKAGE_LINUX_FIRMWARE_RTL_87XX
545 Now covers the whole Realtek 87xx familly: 8712/8723.
547 ###############################################################################
548 comment "Legacy options removed in 2013.02"
551 bool "sa110 ARM target switched to strongarm"
555 The SA110 is the same as a generic StrongARM, it just differs
556 in speed, peripherals and cache.
559 bool "sa1100 ARM target switched to strongarm"
563 The SA1100 is the same as a generic StrongARM, it just differs
564 in speed, peripherals and cache.
566 config BR2_PACKAGE_GDISK
567 bool "gdisk has been replaced by gptfdisk"
569 select BR2_PACKAGE_GPTFDISK
571 The option has been renamed BR2_PACKAGE_GPTFDISK.
573 config BR2_PACKAGE_GDISK_GDISK
574 bool "gdisk tool from gdisk has been replaced by gdisk in gptfdisk"
576 select BR2_PACKAGE_GPTFDISK
577 select BR2_PACKAGE_GPTFDISK_GDISK
579 The option has been renamed BR2_PACKAGE_GPTFDISK_GDISK.
581 config BR2_PACKAGE_GDISK_SGDISK
582 bool "sgdisk tool from gdisk has been replaced by sgdisk in gptfdisk"
584 select BR2_PACKAGE_GPTFDISK
585 select BR2_PACKAGE_GPTFDISK_SGDISK
587 The option has been renamed BR2_PACKAGE_GPTFDISK_SGDISK.
589 config BR2_PACKAGE_GDB_HOST
590 bool "gdb for the host option has been renamed"
591 select BR2_PACKAGE_HOST_GDB
594 Due to the conversion of gdb to the package infrastructure,
595 the BR2_PACKAGE_GDB_HOST option has been renamed
596 BR2_PACKAGE_HOST_GDB.
598 config BR2_PACKAGE_DIRECTB_DITHER_RGB16
599 bool "DirectFB RGB16 dithering option has been renamed"
600 select BR2_PACKAGE_DIRECTFB_DITHER_RGB16
603 The option has been renamed
604 BR2_PACKAGE_DIRECTFB_DITHER_RGB16.
606 config BR2_PACKAGE_DIRECTB_TESTS
607 bool "DirectFB Tests option has been renamed"
608 select BR2_PACKAGE_DIRECTFB_TESTS
611 The option has been renamed
612 BR2_PACKAGE_DIRECTFB_TESTS.
614 ###############################################################################
615 comment "Legacy options removed in 2012.11"
617 config BR2_PACKAGE_CUSTOMIZE
618 bool "customize package has been removed"
621 The 'customize' special package has been removed. Instead,
622 we recommend to create either your own packages, or use a
623 post-build script to customize your root filesystem. See
624 Buildroot's documentation for more details.
626 config BR2_PACKAGE_XSERVER_xorg
627 bool "X.org modular server"
629 select BR2_PACKAGE_XSERVER_XORG_SERVER_MODULAR
631 The option has been renamed
632 BR2_PACKAGE_XSERVER_XORG_SERVER_MODULAR.
634 config BR2_PACKAGE_XSERVER_tinyx
635 bool "KDrive / TinyX server"
637 select BR2_PACKAGE_XSERVER_XORG_SERVER_KDRIVE
639 The option has been renamed
640 BR2_PACKAGE_XSERVER_XORG_SERVER_KDRIVE.
642 config BR2_PACKAGE_PTHREAD_STUBS
643 bool "pthread-stubs option has been renamed"
645 select BR2_PACKAGE_XLIB_LIBPTHREAD_STUBS
646 depends on BR2_PACKAGE_XORG7
648 For consistency reason, the pthread-stubs package has been
649 renamed to xlib_libpthread-stubs.
651 ###############################################################################
652 comment "Legacy options removed in 2012.08"
654 config BR2_PACKAGE_GETTEXT_STATIC
655 bool "libgettext.a is now selected by BR2_PREFER_STATIC_LIB"
658 To build a static gettext library, select BR2_PREFER_STATIC_LIB.
661 config BR2_PACKAGE_LIBINTL
664 select BR2_PACKAGE_GETTEXT
666 libintl is now installed by selecting BR2_PACKAGE_GETTEXT. This now
667 only installs the library, not the executables.
669 config BR2_PACKAGE_INPUT_TOOLS_EVTEST
670 bool "input-tools evtest is now a separate package evtest"
672 select BR2_PACKAGE_EVTEST
674 The evtest program from input-tools is now a separate package.
676 config BR2_BFIN_FDPIC
677 bool "BR2_BFIN_FDPIC is now BR2_BINFMT_FDPIC"
678 select BR2_BINFMT_FDPIC
682 bool "BR2_BFIN_FLAT is now BR2_BINFMT_FLAT"
683 select BR2_BINFMT_FLAT