package: unification of use $(subst [._-], [._-], $(<PKG>_VERSION)) macro
[buildroot-gz.git] / Config.in.legacy
blob597534ebf657080c4f77c6275d536cd63671b06a
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
23 # BR2_LEGACY.
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
28 # references.
30 # [Example: renaming a string option from FOO to BAR]
31 # original symbol:
32 #     config BR2_FOO_STRING
33 #             string "Some foo string"
35 # becomes:
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"
43 #             help
44 #               <suitable help text>
46 #     config BR2_FOO_STRING_WRAP
47 #             bool
48 #             default y if BR2_FOO_STRING != ""
49 #             select BR2_LEGACY
51 #     # Note: BR2_FOO_STRING is still referenced from package/foo/Config.in
53 # [End of example]
55 config BR2_LEGACY
56         bool
57         help
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
62           else.
64 # This comment fits exactly in a 80-column display
65 comment "Legacy detected: check the content of the menu below"
66         depends on BR2_LEGACY
68 menu "Legacy config options"
70 if BR2_LEGACY
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     "
76 comment "will fail.                                          "
77 comment "*                                                   "
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.                            "
84 comment "*                                                   "
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.  "
93 comment "*                                                   "
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 "----------------------------------------------------"
99 endif
101 ###############################################################################
102 config BR2_PACKAGE_LIBNFC_LLCP
103         bool "libnfc-llcp has been removed"
104         depends on BR2_TOOLCHAIN_HAS_THREADS # libusb
105         select BR2_PACKAGE_LIBNFC
106         select BR2_LEGACY
107         help
108           The 'libnfc-llcp' package has been removed since upstream renamed
109           to 'libllcp'. We have added a new package for 'libllcp' and bumped
110           the version at the same time.
112 ###############################################################################
113 comment "Legacy options removed in 2014.02"
115 config BR2_PACKAGE_SQUASHFS3
116         bool "squashfs3 has been removed"
117         select BR2_LEGACY
118         select BR2_PACKAGE_SQUASHFS
119         help
120           The 'squashfs3' package has been removed since it has been
121           deprecated for more than four buildroot releases. Package
122           'squashfs' (4) has been selected automatically as replacement.
124 config BR2_TARGET_ROOTFS_SQUASHFS3
125         bool "squashfs3 rootfs support has been removed"
126         select BR2_LEGACY
127         help
128           Together with the removal of the squashfs3 package, support
129           for squashfs3 root filesystems has been removed too. Squashfs
130           root filesystems will automatically use squashfs4 now.
132 config BR2_PACKAGE_NETKITBASE
133         bool "netkitbase has been removed"
134         select BR2_LEGACY
135         help
136           The 'netkitbase' package has been removed since it has been
137           deprecated since 2012.11. This package provided 'inetd'
138           which is replaced by 'xinet' and 'ping' which is replaced by
139           'busybox' or 'fping'.
141 config BR2_PACKAGE_NETKITTELNET
142         bool "netkittelnet has been removed"
143         select BR2_LEGACY
144         help
145           The 'netkittelnet' package has been removed since it has
146           been deprecated since 2012.11. 'busybox' provides a telnet
147           client and should be used instead.
149 config BR2_PACKAGE_LUASQL
150         bool "luasql has been replaced by luasql-sqlite3"
151         select BR2_PACKAGE_LUASQL_SQLITE3
152         select BR2_LEGACY
153         help
154           The option has been renamed BR2_PACKAGE_LUASQL_SQLITE3.
156 config BR2_PACKAGE_LUACJSON
157         bool "luacjson has been replaced by lua-cjson"
158         select BR2_PACKAGE_LUA_CJSON
159         select BR2_LEGACY
160         help
161           The option has been renamed BR2_PACKAGE_LUA_CJSON.
163 ###############################################################################
164 comment "Legacy options removed in 2013.11"
166 config BR2_PACKAGE_LVM2_DMSETUP_ONLY
167         bool "lvm2's 'dmsetup only' option removed"
168         select BR2_LEGACY
169         help
170           The BR2_PACKAGE_LVM2_DMSETUP_ONLY was a negative option, which
171           led to problems with other packages that need the full lvm2
172           suite. Therefore, the option has been replaced with the positive
173           BR2_PACKAGE_LVM2_STANDARD_INSTALL option.
175 # Note: BR2_PACKAGE_LVM2_DMSETUP_ONLY is still referenced in package/lvm2/Config.in
176 # in order to automatically propagate old configs
178 config BR2_PACKAGE_QT_JAVASCRIPTCORE
179         bool "qt javascriptcore option removed"
180         select BR2_LEGACY
181         help
182           The BR2_PACKAGE_QT_JAVASCRIPTCORE option was available to
183           force the activation or disabling of the JIT compiler in the
184           Qt Javascript interpreter. However, the JIT compiler is not
185           available for all architectures, so forcing its activation
186           does not always work. Moreover, Qt knows by itself for which
187           architectures JIT support is possible, and will
188           automatically enable it if possible.
190           Therefore, this option was in fact useless, and causing
191           build problems when enabled on architectures for which the
192           JIT support was not available. It has been removed, and
193           there is no replacement: Qt will enable JIT at compile time
194           when possible.
196 config BR2_PACKAGE_MODULE_INIT_TOOLS
197         bool "module-init-tools replaced by kmod"
198         select BR2_PACKAGE_KMOD
199         select BR2_PACKAGE_KMOD_TOOLS
200         select BR2_LEGACY
201         help
202           The 'module-init-tools' package has been removed, since it
203           has been depracated upstream and replaced by 'kmod'.
205 config BR2_TARGET_UBOOT_CUSTOM_GIT_REPO_URL
206         string "u-boot: the git repository URL option has been renamed"
207         help
208           The option BR2_TARGET_UBOOT_CUSTOM_GIT_REPO_URL has
209           been renamed to BR2_TARGET_UBOOT_CUSTOM_REPO_URL.
211 config BR2_TARGET_UBOOT_CUSTOM_GIT_REPO_URL_WRAP
212         bool
213         default y if BR2_TARGET_UBOOT_CUSTOM_GIT_REPO_URL != ""
214         select BR2_LEGACY
216 # Note: BR2_TARGET_UBOOT_CUSTOM_GIT_REPO_URL is still referenced from
217 # boot/uboot/Config.in
219 config BR2_TARGET_UBOOT_CUSTOM_GIT_VERSION
220         string "u-boot: the git repository version option has been renamed"
221         help
222           The option BR2_TARGET_UBOOT_CUSTOM_GIT_VERSION has
223           been renamed to BR2_TARGET_UBOOT_CUSTOM_REPO_VERSION.
225 config BR2_TARGET_UBOOT_CUSTOM_GIT_VERSION_WRAP
226         bool
227         default y if BR2_TARGET_UBOOT_CUSTOM_GIT_VERSION != ""
228         select BR2_LEGACY
230 # Note: BR2_TARGET_UBOOT_CUSTOM_GIT_VERSION is still referenced from
231 # boot/uboot/Config.in
233 config BR2_LINUX_KERNEL_CUSTOM_GIT_REPO_URL
234         string "linux: the git repository URL option has been renamed"
235         help
236           The option BR2_LINUX_KERNEL_CUSTOM_GIT_REPO_URL has
237           been renamed to
238           BR2_LINUX_KERNEL_CUSTOM_REPO_URL.
240 config BR2_LINUX_KERNEL_CUSTOM_GIT_REPO_URL_WRAP
241         bool
242         default y if BR2_LINUX_KERNEL_CUSTOM_GIT_REPO_URL != ""
243         select BR2_LEGACY
245 # Note: BR2_LINUX_KERNEL_CUSTOM_GIT_REPO_URL is still referenced from
246 # linux/Config.in
248 config BR2_LINUX_KERNEL_CUSTOM_GIT_VERSION
249         string "linux: the git repository version option has been renamed"
250         help
251           The option BR2_LINUX_KERNEL_CUSTOM_GIT_VERSION has
252           been renamed to
253           BR2_LINUX_KERNEL_CUSTOM_REPO_VERSION.
255 config BR2_LINUX_KERNEL_CUSTOM_GIT_VERSION_WRAP
256         bool
257         default y if BR2_LINUX_KERNEL_CUSTOM_GIT_VERSION != ""
258         select BR2_LEGACY
260 # Note: BR2_LINUX_KERNEL_CUSTOM_GIT_VERSION is still referenced from
261 # linux/Config.in
263 ###############################################################################
264 comment "Legacy options removed in 2013.08"
266 config BR2_ARM_OABI
267         bool "ARM OABI support has been removed"
268         select BR2_LEGACY
269         help
270           The support for the ARM OABI was deprecated since a while,
271           and has been removed completely from Buildroot. It is also
272           deprecated in upstream gcc, since gcc 4.7. People should
273           switch to EABI instead, which should not be a problem as
274           long as you don't have pre-built OABI binaries in your
275           system that you can't recompile.
277 config BR2_PACKAGE_DOSFSTOOLS_DOSFSCK
278         bool "dosfstools dosfsck renamed to fsck.fat"
279         select BR2_LEGACY
280         select BR2_PACKAGE_DOSFSTOOLS_FSCK_FAT
281         help
282           dosfsck was renamed upstream to fsck.fat for consistency.
284 config BR2_PACKAGE_DOSFSTOOLS_DOSFSLABEL
285         bool "dosfstools dosfslabel renamed to fatlabel"
286         select BR2_LEGACY
287         select BR2_PACKAGE_DOSFSTOOLS_FATLABEL
288         help
289           doslabel was renamed upstream to fatlabel for consistency.
291 config BR2_PACKAGE_DOSFSTOOLS_MKDOSFS
292         bool "dosfstools mkdosfs renamed to mkfs.fat"
293         select BR2_LEGACY
294         select BR2_PACKAGE_DOSFSTOOLS_MKFS_FAT
295         help
296           mkdosfs was renamed upstream to mkfs.fat for consistency.
298 config BR2_ELF2FLT
299         bool "the elf2flt option has been renamed"
300         select BR2_LEGACY
301         help
302           The BR2_ELF2FLT option has been renamed to
303           BR2_PACKAGE_HOST_ELF2FLT due to the conversion of elf2flt to
304           the package infrastructure.
306 config BR2_VFP_FLOAT
307         bool "the ARM VFP floating point option has been renamed"
308         select BR2_LEGACY
309         help
310           Due to a major refactoring of the floating-point handling of
311           the ARM architecture support, the BR2_VFP_FLOAT option has
312           been replaced with a choice of options that allows to select
313           between various VFP versions/capabilities.
315 config BR2_PACKAGE_GCC_TARGET
316         bool "gcc on the target filesystem has been removed"
317         select BR2_LEGACY
318         help
319           The support for gcc in the target filesystem was deprecated
320           since a while, and has been removed completely from Buildroot.
321           See Buildroot's documentation for more explanations.
323 config BR2_HAVE_DEVFILES
324         bool "development files in target filesystem has been removed"
325         select BR2_LEGACY
326         help
327           The installation of the development files in the target
328           filesystem was deprecated since a while, and has been removed
329           completely from Buildroot.
330           See Buildroot's documentation for more explanations.
332 ###############################################################################
333 comment "Legacy options removed in 2013.05"
335 config BR2_PACKAGE_LINUX_FIRMWARE_RTL_8192
336         bool "Realtek 8192 replaced by Realtek 81xx"
337         select BR2_LEGACY
338         select BR2_PACKAGE_LINUX_FIRMWARE_RTL_81XX
339         help
340           Now covers the whole Realtek 81xx familly: 8188/8192.
342 config BR2_PACKAGE_LINUX_FIRMWARE_RTL_8712
343         bool "Realtek 8712 replaced by Realtek 87xx"
344         select BR2_LEGACY
345         select BR2_PACKAGE_LINUX_FIRMWARE_RTL_87XX
346         help
347           Now covers the whole Realtek 87xx familly: 8712/8723.
349 ###############################################################################
350 comment "Legacy options removed in 2013.02"
352 config BR2_sa110
353         bool "sa110 ARM target switched to strongarm"
354         select BR2_LEGACY
355         select BR2_strongarm
356         help
357           The SA110 is the same as a generic StrongARM, it just differs
358           in speed, peripherals and cache.
360 config BR2_sa1100
361         bool "sa1100 ARM target switched to strongarm"
362         select BR2_LEGACY
363         select BR2_strongarm
364         help
365           The SA1100 is the same as a generic StrongARM, it just differs
366           in speed, peripherals and cache.
368 config BR2_PACKAGE_GDISK
369         bool "gdisk has been replaced by gptfdisk"
370         select BR2_LEGACY
371         select BR2_PACKAGE_GPTFDISK
372         help
373           The option has been renamed BR2_PACKAGE_GPTFDISK.
375 config BR2_PACKAGE_GDISK_GDISK
376         bool "gdisk tool from gdisk has been replaced by gdisk in gptfdisk"
377         select BR2_LEGACY
378         select BR2_PACKAGE_GPTFDISK
379         select BR2_PACKAGE_GPTFDISK_GDISK
380         help
381           The option has been renamed BR2_PACKAGE_GPTFDISK_GDISK.
383 config BR2_PACKAGE_GDISK_SGDISK
384         bool "sgdisk tool from gdisk has been replaced by sgdisk in gptfdisk"
385         select BR2_LEGACY
386         select BR2_PACKAGE_GPTFDISK
387         select BR2_PACKAGE_GPTFDISK_SGDISK
388         help
389           The option has been renamed BR2_PACKAGE_GPTFDISK_SGDISK.
391 config BR2_PACKAGE_GDB_HOST
392         bool "gdb for the host option has been renamed"
393         select BR2_PACKAGE_HOST_GDB
394         select BR2_LEGACY
395         help
396           Due to the conversion of gdb to the package infrastructure,
397           the BR2_PACKAGE_GDB_HOST option has been renamed
398           BR2_PACKAGE_HOST_GDB.
400 config BR2_PACKAGE_DIRECTB_DITHER_RGB16
401         bool "DirectFB RGB16 dithering option has been renamed"
402         select BR2_PACKAGE_DIRECTFB_DITHER_RGB16
403         select BR2_LEGACY
404         help
405           The option has been renamed
406           BR2_PACKAGE_DIRECTFB_DITHER_RGB16.
408 config BR2_PACKAGE_DIRECTB_TESTS
409         bool "DirectFB Tests option has been renamed"
410         select BR2_PACKAGE_DIRECTFB_TESTS
411         select BR2_LEGACY
412         help
413           The option has been renamed
414           BR2_PACKAGE_DIRECTFB_TESTS.
416 ###############################################################################
417 comment "Legacy options removed in 2012.11"
419 config BR2_PACKAGE_CUSTOMIZE
420         bool "customize package has been removed"
421         select BR2_LEGACY
422         help
423           The 'customize' special package has been removed. Instead,
424           we recommend to create either your own packages, or use a
425           post-build script to customize your root filesystem. See
426           Buildroot's documentation for more details.
428 config BR2_PACKAGE_XSERVER_xorg
429         bool "X.org modular server"
430         select BR2_LEGACY
431         select BR2_PACKAGE_XSERVER_XORG_SERVER_MODULAR
432         help
433           The option has been renamed
434           BR2_PACKAGE_XSERVER_XORG_SERVER_MODULAR.
436 config BR2_PACKAGE_XSERVER_tinyx
437         bool "KDrive / TinyX server"
438         select BR2_LEGACY
439         select BR2_PACKAGE_XSERVER_XORG_SERVER_KDRIVE
440         help
441           The option has been renamed
442           BR2_PACKAGE_XSERVER_XORG_SERVER_KDRIVE.
444 config BR2_PACKAGE_PTHREAD_STUBS
445         bool "pthread-stubs option has been renamed"
446         select BR2_LEGACY
447         select BR2_PACKAGE_XLIB_LIBPTHREAD_STUBS
448         depends on BR2_PACKAGE_XORG7
449         help
450           For consistency reason, the pthread-stubs package has been
451           renamed to xlib_libpthread-stubs.
453 ###############################################################################
454 comment "Legacy options removed in 2012.08"
456 config BR2_PACKAGE_GETTEXT_STATIC
457         bool "libgettext.a is now selected by BR2_PREFER_STATIC_LIB"
458         select BR2_LEGACY
459         help
460           To build a static gettext library, select BR2_PREFER_STATIC_LIB.
463 config BR2_PACKAGE_LIBINTL
464         bool "libintl"
465         select BR2_LEGACY
466         select BR2_PACKAGE_GETTEXT
467         help
468           libintl is now installed by selecting BR2_PACKAGE_GETTEXT. This now
469           only installs the library, not the executables.
471 config BR2_PACKAGE_INPUT_TOOLS_EVTEST
472         bool "input-tools evtest is now a separate package evtest"
473         select BR2_LEGACY
474         select BR2_PACKAGE_EVTEST
475         help
476           The evtest program from input-tools is now a separate package.
478 config BR2_BFIN_FDPIC
479         bool "BR2_BFIN_FDPIC is now BR2_BINFMT_FDPIC"
480         select BR2_BINFMT_FDPIC
481         select BR2_LEGACY
483 config BR2_BFIN_FLAT
484         bool "BR2_BFIN_FLAT is now BR2_BINFMT_FLAT"
485         select BR2_BINFMT_FLAT
486         select BR2_LEGACY
488 endmenu