Config.in.legacy

   1 #
   2 # Config.in.legacy - support for backward compatibility
   3 #
   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.
   7 #
   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.
  10 #
  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.
  14 #
  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.
  19 #
  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.
  29 #
  30 # [Example: renaming a string option from FOO to BAR]
  31 # original symbol:
  32 #     config BR2_FOO_STRING
  33 #             string "Some foo string"
  34 #
  35 # becomes:
  36 #     config BR2_BAR_STRING
  37 #             string "Some bar string"
  38 #             default BR2_FOO_STRING if BR2_FOO_STRING != ""  # legacy
  39 #
  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>
  45 #
  46 #     config BR2_FOO_STRING_WRAP
  47 #             bool
  48 #             default y if BR2_FOO_STRING != ""
  49 #             select BR2_LEGACY
  50 #
  51 #     # Note: BR2_FOO_STRING is still referenced from package/foo/Config.in
  52 #
  53 # [End of example]
  54
  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.
  63
  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
  67
  68 menu "Legacy config options"
  69
  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
 100
 101 ###############################################################################
 102 comment "Legacy options removed in 2013.11"
 103
 104 config BR2_PACKAGE_QT_JAVASCRIPTCORE
 105         bool "qt javascriptcore option removed"
 106         select BR2_LEGACY
 107         help
 108           The BR2_PACKAGE_QT_JAVASCRIPTCORE option was available to
 109           force the activation or disabling of the JIT compiler in the
 110           Qt Javascript interpreter. However, the JIT compiler is not
 111           available for all architectures, so forcing its activation
 112           does not always work. Moreover, Qt knows by itself for which
 113           architectures JIT support is possible, and will
 114           automatically enable it if possible.
 115
 116           Therefore, this option was in fact useless, and causing
 117           build problems when enabled on architectures for which the
 118           JIT support was not available. It has been removed, and
 119           there is no replacement: Qt will enable JIT at compile time
 120           when possible.
 121
 122 config BR2_PACKAGE_MODULE_INIT_TOOLS
 123         bool "module-init-tools replaced by kmod"
 124         select BR2_PACKAGE_KMOD
 125         select BR2_PACKAGE_KMOD_TOOLS
 126         select BR2_LEGACY
 127         help
 128           The 'module-init-tools' package has been removed, since it
 129           has been depracated upstream and replaced by 'kmod'.
 130
 131 config BR2_TARGET_UBOOT_CUSTOM_GIT_REPO_URL
 132         string "u-boot: the git repository URL option has been renamed"
 133         help
 134           The option BR2_TARGET_UBOOT_CUSTOM_GIT_REPO_URL has
 135           been renamed to BR2_TARGET_UBOOT_CUSTOM_REPO_URL.
 136
 137 config BR2_TARGET_UBOOT_CUSTOM_GIT_REPO_URL_WRAP
 138         bool
 139         default y if BR2_TARGET_UBOOT_CUSTOM_GIT_REPO_URL != ""
 140         select BR2_LEGACY
 141
 142 # Note: BR2_TARGET_UBOOT_CUSTOM_GIT_REPO_URL is still referenced from
 143 # boot/uboot/Config.in
 144
 145 config BR2_TARGET_UBOOT_CUSTOM_GIT_VERSION
 146         string "u-boot: the git repository version option has been renamed"
 147         help
 148           The option BR2_TARGET_UBOOT_CUSTOM_GIT_VERSION has
 149           been renamed to BR2_TARGET_UBOOT_CUSTOM_REPO_VERSION.
 150
 151 config BR2_TARGET_UBOOT_CUSTOM_GIT_VERSION_WRAP
 152         bool
 153         default y if BR2_TARGET_UBOOT_CUSTOM_GIT_VERSION != ""
 154         select BR2_LEGACY
 155
 156 # Note: BR2_TARGET_UBOOT_CUSTOM_GIT_VERSION is still referenced from
 157 # boot/uboot/Config.in
 158
 159 config BR2_LINUX_KERNEL_CUSTOM_GIT_REPO_URL
 160         string "linux: the git repository URL option has been renamed"
 161         help
 162           The option BR2_LINUX_KERNEL_CUSTOM_GIT_REPO_URL has
 163           been renamed to
 164           BR2_LINUX_KERNEL_CUSTOM_REPO_URL.
 165
 166 config BR2_LINUX_KERNEL_CUSTOM_GIT_REPO_URL_WRAP
 167         bool
 168         default y if BR2_LINUX_KERNEL_CUSTOM_GIT_REPO_URL != ""
 169         select BR2_LEGACY
 170
 171 # Note: BR2_LINUX_KERNEL_CUSTOM_GIT_REPO_URL is still referenced from
 172 # linux/Config.in
 173
 174 config BR2_LINUX_KERNEL_CUSTOM_GIT_VERSION
 175         string "linux: the git repository version option has been renamed"
 176         help
 177           The option BR2_LINUX_KERNEL_CUSTOM_GIT_VERSION has
 178           been renamed to
 179           BR2_LINUX_KERNEL_CUSTOM_REPO_VERSION.
 180
 181 config BR2_LINUX_KERNEL_CUSTOM_GIT_VERSION_WRAP
 182         bool
 183         default y if BR2_LINUX_KERNEL_CUSTOM_GIT_VERSION != ""
 184         select BR2_LEGACY
 185
 186 # Note: BR2_LINUX_KERNEL_CUSTOM_GIT_VERSION is still referenced from
 187 # linux/Config.in
 188
 189 ###############################################################################
 190 comment "Legacy options removed in 2013.08"
 191
 192 config BR2_ARM_OABI
 193         bool "ARM OABI support has been removed"
 194         select BR2_LEGACY
 195         help
 196           The support for the ARM OABI was deprecated since a while,
 197           and has been removed completely from Buildroot. It is also
 198           deprecated in upstream gcc, since gcc 4.7. People should
 199           switch to EABI instead, which should not be a problem as
 200           long as you don't have pre-built OABI binaries in your
 201           system that you can't recompile.
 202
 203 config BR2_PACKAGE_DOSFSTOOLS_DOSFSCK
 204         bool "dosfstools dosfsck renamed to fsck.fat"
 205         select BR2_LEGACY
 206         select BR2_PACKAGE_DOSFSTOOLS_FSCK_FAT
 207         help
 208           dosfsck was renamed upstream to fsck.fat for consistency.
 209
 210 config BR2_PACKAGE_DOSFSTOOLS_DOSFSLABEL
 211         bool "dosfstools dosfslabel renamed to fatlabel"
 212         select BR2_LEGACY
 213         select BR2_PACKAGE_DOSFSTOOLS_FATLABEL
 214         help
 215           doslabel was renamed upstream to fatlabel for consistency.
 216
 217 config BR2_PACKAGE_DOSFSTOOLS_MKDOSFS
 218         bool "dosfstools mkdosfs renamed to mkfs.fat"
 219         select BR2_LEGACY
 220         select BR2_PACKAGE_DOSFSTOOLS_MKFS_FAT
 221         help
 222           mkdosfs was renamed upstream to mkfs.fat for consistency.
 223
 224 config BR2_ELF2FLT
 225         bool "the elf2flt option has been renamed"
 226         select BR2_LEGACY
 227         help
 228           The BR2_ELF2FLT option has been renamed to
 229           BR2_PACKAGE_HOST_ELF2FLT due to the conversion of elf2flt to
 230           the package infrastructure.
 231
 232 config BR2_VFP_FLOAT
 233         bool "the ARM VFP floating point option has been renamed"
 234         select BR2_LEGACY
 235         help
 236           Due to a major refactoring of the floating-point handling of
 237           the ARM architecture support, the BR2_VFP_FLOAT option has
 238           been replaced with a choice of options that allows to select
 239           between various VFP versions/capabilities.
 240
 241 config BR2_PACKAGE_GCC_TARGET
 242         bool "gcc on the target filesystem has been removed"
 243         select BR2_LEGACY
 244         help
 245           The support for gcc in the target filesystem was deprecated
 246           since a while, and has been removed completely from Buildroot.
 247           See Buildroot's documentation for more explanations.
 248
 249 config BR2_HAVE_DEVFILES
 250         bool "development files in target filesystem has been removed"
 251         select BR2_LEGACY
 252         help
 253           The installation of the development files in the target
 254           filesystem was deprecated since a while, and has been removed
 255           completely from Buildroot.
 256           See Buildroot's documentation for more explanations.
 257
 258 ###############################################################################
 259 comment "Legacy options removed in 2013.05"
 260
 261 config BR2_PACKAGE_LINUX_FIRMWARE_RTL_8192
 262         bool "Realtek 8192 replaced by Realtek 81xx"
 263         select BR2_LEGACY
 264         select BR2_PACKAGE_LINUX_FIRMWARE_RTL_81XX
 265         help
 266           Now covers the whole Realtek 81xx familly: 8188/8192.
 267
 268 config BR2_PACKAGE_LINUX_FIRMWARE_RTL_8712
 269         bool "Realtek 8712 replaced by Realtek 87xx"
 270         select BR2_LEGACY
 271         select BR2_PACKAGE_LINUX_FIRMWARE_RTL_87XX
 272         help
 273           Now covers the whole Realtek 87xx familly: 8712/8723.
 274
 275 ###############################################################################
 276 comment "Legacy options removed in 2013.02"
 277
 278 config BR2_sa110
 279         bool "sa110 ARM target switched to strongarm"
 280         select BR2_LEGACY
 281         select BR2_strongarm
 282         help
 283           The SA110 is the same as a generic StrongARM, it just differs
 284           in speed, peripherals and cache.
 285
 286 config BR2_sa1100
 287         bool "sa1100 ARM target switched to strongarm"
 288         select BR2_LEGACY
 289         select BR2_strongarm
 290         help
 291           The SA1100 is the same as a generic StrongARM, it just differs
 292           in speed, peripherals and cache.
 293
 294 config BR2_PACKAGE_GDISK
 295         bool "gdisk has been replaced by gptfdisk"
 296         select BR2_LEGACY
 297         select BR2_PACKAGE_GPTFDISK
 298         help
 299           The option has been renamed BR2_PACKAGE_GPTFDISK.
 300
 301 config BR2_PACKAGE_GDISK_GDISK
 302         bool "gdisk tool from gdisk has been replaced by gdisk in gptfdisk"
 303         select BR2_LEGACY
 304         select BR2_PACKAGE_GPTFDISK
 305         select BR2_PACKAGE_GPTFDISK_GDISK
 306         help
 307           The option has been renamed BR2_PACKAGE_GPTFDISK_GDISK.
 308
 309 config BR2_PACKAGE_GDISK_SGDISK
 310         bool "sgdisk tool from gdisk has been replaced by sgdisk in gptfdisk"
 311         select BR2_LEGACY
 312         select BR2_PACKAGE_GPTFDISK
 313         select BR2_PACKAGE_GPTFDISK_SGDISK
 314         help
 315           The option has been renamed BR2_PACKAGE_GPTFDISK_SGDISK.
 316
 317 config BR2_PACKAGE_GDB_HOST
 318         bool "gdb for the host option has been renamed"
 319         select BR2_PACKAGE_HOST_GDB
 320         select BR2_LEGACY
 321         help
 322           Due to the conversion of gdb to the package infrastructure,
 323           the BR2_PACKAGE_GDB_HOST option has been renamed
 324           BR2_PACKAGE_HOST_GDB.
 325
 326 config BR2_PACKAGE_DIRECTB_DITHER_RGB16
 327         bool "DirectFB RGB16 dithering option has been renamed"
 328         select BR2_PACKAGE_DIRECTFB_DITHER_RGB16
 329         select BR2_LEGACY
 330         help
 331           The option has been renamed
 332           BR2_PACKAGE_DIRECTFB_DITHER_RGB16.
 333
 334 config BR2_PACKAGE_DIRECTB_TESTS
 335         bool "DirectFB Tests option has been renamed"
 336         select BR2_PACKAGE_DIRECTFB_TESTS
 337         select BR2_LEGACY
 338         help
 339           The option has been renamed
 340           BR2_PACKAGE_DIRECTFB_TESTS.
 341
 342 ###############################################################################
 343 comment "Legacy options removed in 2012.11"
 344
 345 config BR2_PACKAGE_CUSTOMIZE
 346         bool "customize package has been removed"
 347         select BR2_LEGACY
 348         help
 349           The 'customize' special package has been removed. Instead,
 350           we recommend to create either your own packages, or use a
 351           post-build script to customize your root filesystem. See
 352           Buildroot's documentation for more details.
 353
 354 config BR2_PACKAGE_XSERVER_xorg
 355         bool "X.org modular server"
 356         select BR2_LEGACY
 357         select BR2_PACKAGE_XSERVER_XORG_SERVER_MODULAR
 358         help
 359           The option has been renamed
 360           BR2_PACKAGE_XSERVER_XORG_SERVER_MODULAR.
 361
 362 config BR2_PACKAGE_XSERVER_tinyx
 363         bool "KDrive / TinyX server"
 364         select BR2_LEGACY
 365         select BR2_PACKAGE_XSERVER_XORG_SERVER_KDRIVE
 366         help
 367           The option has been renamed
 368           BR2_PACKAGE_XSERVER_XORG_SERVER_KDRIVE.
 369
 370 config BR2_PACKAGE_PTHREAD_STUBS
 371         bool "pthread-stubs option has been renamed"
 372         select BR2_LEGACY
 373         select BR2_PACKAGE_XLIB_LIBPTHREAD_STUBS
 374         depends on BR2_PACKAGE_XORG7
 375         help
 376           For consistency reason, the pthread-stubs package has been
 377           renamed to xlib_libpthread-stubs.
 378
 379 ###############################################################################
 380 comment "Legacy options removed in 2012.08"
 381
 382 config BR2_PACKAGE_GETTEXT_STATIC
 383         bool "libgettext.a is now selected by BR2_PREFER_STATIC_LIB"
 384         select BR2_LEGACY
 385         help
 386           To build a static gettext library, select BR2_PREFER_STATIC_LIB.
 387
 388
 389 config BR2_PACKAGE_LIBINTL
 390         bool "libintl"
 391         select BR2_LEGACY
 392         select BR2_PACKAGE_GETTEXT
 393         help
 394           libintl is now installed by selecting BR2_PACKAGE_GETTEXT. This now
 395           only installs the library, not the executables.
 396
 397 config BR2_PACKAGE_INPUT_TOOLS_EVTEST
 398         bool "input-tools evtest is now a separate package evtest"
 399         select BR2_LEGACY
 400         select BR2_PACKAGE_EVTEST
 401         help
 402           The evtest program from input-tools is now a separate package.
 403
 404 config BR2_BFIN_FDPIC
 405         bool "BR2_BFIN_FDPIC is now BR2_BINFMT_FDPIC"
 406         select BR2_BINFMT_FDPIC
 407         select BR2_LEGACY
 408
 409 config BR2_BFIN_FLAT
 410         bool "BR2_BFIN_FLAT is now BR2_BINFMT_FLAT"
 411         select BR2_BINFMT_FLAT
 412         select BR2_LEGACY
 413
 414 endmenu