code.delx.au - refind/blob - NEWS.txt

   1 0.10.3 (?/??/2016):
   2 -------------------
   3
   4 - Tightened exclusion of shell binary filenames from boot loader scan.
   5   Previously, any filename containing the substring "shell" was excluded
   6   from scans. Now it's tighter; only files matching one of the filenames in
   7   the constant SHELL_NAMES in main.c are excluded. This change will enable
   8   programs with names that include "shell", but that aren't in rEFInd's
   9   SHELL_NAMES list, such as "shelly.efi", to be shown in the rEFInd main
  10   menu.
  11
  12 - Fixed bug in NTFS driver that caused it to hang (and thus hang the
  13   computer) in some situations, particularly when a file on an NTFS volume
  14   had many fragments and when the computer's CSM was activated. (Fix
  15   courtesy of "S L.")
  16
  17 - Modified SIP/CSR rotation code: If the csr-active-config EFI variable is
  18   missing AND the firmware is Apple (as identified by the string "Apple"
  19   being present in the ST->FirmwareVendor string), rEFInd treats the
  20   computer as one on which SIP is available and set to the "enabled" state
  21   (0x10). The upshot is that the SIP/CSR tool will appear if the showtools
  22   and csr_values options are set appropriately in refind.conf, even if the
  23   csr-active-config variable is missing from the NVRAM. The point of this
  24   change is that I've received reports of some Macs that run OS X 10.11 but
  25   that lack this variable. OS X acts as if SIP were enabled, but rEFInd is
  26   then unable to disable SIP. This change gives rEFInd the ability to
  27   disable SIP on such systems. The drawback is that the variable might be
  28   set on some systems that don't run OS X 10.11. This should be harmless
  29   from a technical point of view, but the presence of SIP indicators in
  30   rEFInd could be confusing.
  31
  32 - Added refind-mkdefault script to simplify resetting rEFInd as the default
  33   boot program in Linux. The intent is to run this after GRUB, Windows, OS
  34   X, or some other tool takes over as the primary boot manager. It can be
  35   called from a startup script to handle this task automatically.
  36
  37 0.10.2 (1/26/2016):
  38 -------------------
  39
  40 - Fixed bug in refind-install that caused mountesp to be installed as a FILE
  41   called /usr/local/bin on OS X if the /usr/local/bin directory did not
  42   already exist.
  43
  44 - Fixed bug in mvrefind that caused it to fail to move bootmgfw.efi in
  45   some situations, and another that caused it to give the resulting NVRAM
  46   entry the default rEFInd name of "rEFInd Boot Manager," rather than the
  47   intended "Windows Boot Manager" (to work around bugs in some EFIs).
  48
  49 - Worked around bug/quirk in some EFIs (in HP ProBook 6470b laptop, at
  50   least) that prevented EFI filesystem drivers from working. (Drivers would
  51   load but not provide access to filesystems.)
  52
  53 - Fixed refind-install bug that caused --usedefault option to not work in OS
  54   X. (This bug did not affect Linux.)
  55
  56 - Improved Secure Boot detection in refind-install in Linux.
  57
  58 - Fixed bug that caused custom volume badges (vol_*.png) to be read only
  59   from default location ("icons" subdirectory), effectively eliminating the
  60   ability to adjust them.
  61
  62 - Added centos.crt and centos.cer public key files.
  63
  64 0.10.1 (12/12/2015):
  65 --------------------
  66
  67 - Change to PPA version: Installing the PPA now queries the user about
  68   whether to install to the ESP. Upgrades will remember the initial
  69   selection.
  70
  71 - Modified time-based sorting of loaders in a single directory to push
  72   anything starting with "vmlinuz-0-rescue" to the end of the list. Fedora
  73   gives its rescue kernels filenames that begin with that string, and if
  74   such a kernel happens to be the most recent, treating it normally will
  75   cause it to become the default when kernel folding is in use. This is
  76   almost certainly undesirable, so this change keeps the rescue kernel at
  77   the end of the list instead, which is saner.
  78
  79 - Significantly reworked the project's Makefiles. This should have no
  80   impact on ordinary users, and even most developers should barely notice
  81   it; but it should make future extensions to additional platforms or
  82   building in different environments easier.
  83
  84 - Added workaround to gptsync for issue with some Macs' EFIs that caused
  85   the program to skip through all prompts, thus accepting the default
  86   option. This would normally cause gptsync to do nothing.
  87
  88 - Added type code 53746F72-6167-11AA-AA11-00306543ECAC (Apple Core Storage,
  89   gdisk type AF05) to list of partition types recognized by gptsync.
  90
  91 - Removed Luxi Sans Mono font, since I discovered it was not open source;
  92   and changed the default font from Nimbus Mono to Liberation Mono.
  93
  94 - Added support for compiling rEFInd for ARM64 (aka AARCH64 or aa64). This
  95   works with both GNU-EFI and Tianocore UDK2014.SP1.P1. This support is
  96   currently poorly tested. In particular, I used QEMU on an x86-64 computer
  97   to create a virtualized ARM64 environment; I've not yet tested on a real
  98   computer. I couldn't get QEMU to create a video card, so I used a serial
  99   terminal, which means that the graphics features are untested -- I ran
 100   rEFInd with "textonly" uncommented in refind.conf. I've tested the ext4fs
 101   driver but no other drivers, although they all compile. (So does gptsync,
 102   although it's unlikely to be useful on ARM64.) Some rEFInd features are
 103   meaningless on ARM64, such as BIOS-mode boot support, anything geared
 104   toward Macs (csr_values/csr_rotate, spoof_osx_version, etc.), and
 105   enable_and_lock_vmx.
 106
 107 - Fixed bug that caused rEFInd to fail to scan EFI boot loaders on
 108   removable media when rEFInd itself was launched from the fallback
 109   filename.
 110
 111 - Moved detailed descriptions of refind-install from installing.html to
 112   a refind-install man page. To keep this information Web-accessible, I've
 113   also created HTML versions of the three man pages and linked them into
 114   the HTML documentation.
 115
 116 - Updated LodePNG to latest version (20151024).
 117
 118 - Fixed bugs in mkrlconf and in refind-install that could cause some kernel
 119   options to be excluded from refind_linux.conf. There were two trouble
 120   conditions:
 121   - Previously, these scripts assumed that the first option in
 122     /proc/cmdline was the kernel's filename, but this isn't always the
 123     case. (In particular, when gummiboot launches the kernel, this is not
 124     true. It might be an incorrect assumption in some other cases, too.)
 125     The fix involves checking for likely signs of a kernel filename before
 126     discarding this first option.
 127   - These scripts cut the "initrd=*" option from /proc/cmdline, but the
 128     call to "sed" was overzealous and cut until the end of input. This
 129     usually worked, since the initrd= option was usually last on the line;
 130     but if it wasn't, any options following initrd= would be lost.
 131
 132 - Added "kernel*" as a matching pattern for Linux kernels, since this is
 133   what Gentoo uses by default.
 134
 135 - The refind-install script can now be run as a symbolic link in Linux.
 136   This enables creating a /usr/sbin/refind-install link in Linux packages,
 137   with the binaries stashed wherever the package system likes them. This
 138   feature does NOT work in OS X, but there's relatively little need for it
 139   there.
 140
 141 0.10.0 (11/8/2015):
 142 -------------------
 143
 144 - Fixed bug that caused refind-install to not unmount the ESP when it
 145   should under OS X.
 146
 147 - Modified refind-install and mkrlconf scripts to use /proc/cmdline as
 148   source for default boot options EXCEPT when refind-install receives the
 149   --root option. In that case, refind-install continues to use
 150   /etc/default/grub as the source of default options. The idea behind this
 151   change is that it's more reliable to get boot options from /proc/cmdline
 152   when the targeted system is the one that's booted; but --root would be
 153   used from emergency disks or live CDs, in which case the current boot
 154   options would be completely wrong, so extracting boot options from GRUB
 155   files is the best bet for getting close to the right options.
 156
 157 - Added "@/boot" to default also_scan_dirs setting. This makes kernels
 158   show up on Btrfs volumes under Ubuntu (and perhaps others), at least when
 159   the Btrfs driver is loaded.
 160
 161 - Added new System Integrity Protection (SIP) rotation feature for Macs
 162   running OS X 10.11 or later. This feature is disabled by default, except
 163   on CD-R and USB flash drive images, on which it's enabled. To enable it,
 164   you must make TWO changes to refind.conf: Uncomment the new "csr_values"
 165   item and add "csr_rotate" to the "showtools" line (uncommenting it, too,
 166   if it's commented out). If desired, you can set more values on
 167   "csr_values"; these are comma-delimited one-byte hexadecimal values that
 168   define various SIP states.  When SIP/CSR rotation is activated, a new
 169   shield icon appears among the tools. Selecting it causes the next defined
 170   value to be set and a confirmation message to appear for three seconds.
 171
 172 - Added display of current System Integrity Protection (SIP) mode to
 173   "About" display.
 174
 175 - Added mountesp script for OS X to (you guessed it!) mount the ESP.
 176
 177 - Renamed support scripts: install.sh to refind-install, mvrefind.sh to
 178   mvrefind, and mkrlconf.sh to mkrlconf.
 179
 180 - New icons! The old ones were getting to be a jumbled mess of styles,
 181   particularly for OS tags. I used the AwOken icon set
 182   (http://alecive.deviantart.com/art/AwOken-163570862) for the core icons,
 183   then expanded from there by creating my own icons and modifying icons for
 184   Debian and Elementary OS. I'm also trying to keep better track of
 185   copyrights and licenses on icons. Between that and some icons being for
 186   OSes that probably see very little use (FreeDOS and eComstation, for
 187   instance), a few OS icons have been lost. If you prefer the old icons,
 188   you can continue to use them by upgrading rEFInd, renaming icons-backup
 189   to something else (say, icons-classic), and then adding an "icons" line
 190   in refind.conf to point to the old icons directory.
 191
 192 - Changed from .zip to .tar.gz as source code archive format. I did this
 193   because Linux is the only officially-supported build platform, and
 194   tarballs are a more natural fit to a Linux environment. I'm leaving .zip,
 195   .deb, and .rpm files as the formats for binary packages.
 196
 197 - Added detection of System Integrity Protection (SIP; aka "rootless") mode
 198   to OS X portion of install.sh script. When detected, and if no existing
 199   rEFInd installation is found, the script now prints a warning and brief
 200   instructions of how to enter the Recovery mode to install rEFInd and
 201   suggests aborting the installation. (The user can override and attempt
 202   installation anyhow.) If SIP is detected along with an existing rEFInd
 203   installation, the script moderates the warning and explains that an
 204   update of a working rEFInd will probably succeed, but that re-installing
 205   to fix a broken rEFInd will probably fail.
 206
 207 - Added new "spoof_osx_version" token, which takes an OS X version number
 208   (such as "10.9") as an option. This feature, when enabled, causes rEFInd
 209   to tell a Mac's firmware that the specified version of OS X is being
 210   launched. This option is usually unnecessary, but it can help properly
 211   initialize some hardware -- particularly secondary video devices. OTOH,
 212   on some Macs it can cause hardware (notably keyboards and mice) to become
 213   unresponsive, so you should not use this option unnecessarily.
 214
 215 - Worked around an EFI bug that affected my 32-bit Mac Mini: That system
 216   seems to have a broken EFI, or possibly a buggy CPU, that causes some
 217   (but not all) conversions from floating-point to integer numbers to hang
 218   the computer. Such operations were performed only in rEFInd's
 219   graphics-resizing code, and so would manifest only when icons or
 220   background images were resized. My fix eliminates the use of
 221   floating-point operations in the affected function, which eliminates the
 222   crashes. There may be some degradation in the quality of resized images,
 223   though, particularly on 32-bit systems. (64-bit systems use larger
 224   integers, which enable greater precision in my floating-point
 225   workaround.)
 226
 227 - Under OS X, install.sh can now be run from the recovery system. This may
 228   help work around OS X 10.11's problems with System Integrity Protection,
 229   since it should be possible to reboot into the recovery system to install
 230   rEFInd without disabling SIP for the main installation, even for just one
 231   boot.
 232
 233 0.9.2 (9/19/2015):
 234 ------------------
 235
 236 - Added "--keepname" option to install.sh. This option causes install.sh
 237   to keep refind_x64.efi named as such rather than rename it as grubx64.efi
 238   when using Shim. This option is meaningful only if the --shim option is
 239   also used. This option passes the refind_x64.efi filename as an option to
 240   Shim, which overrides the default filename of grubx64.efi. A big caveat:
 241   Only Shim 0.7 and later supports this feature. (Shim 0.4 also works if a
 242   refind_x64.efi is referred to as "\refind_x64.efi" on the command line,
 243   but the need for a leading backslash to refer to a file in the same
 244   directory as Shim is so confusing and wrong that I cannot in good
 245   conscience support it.) I've not seen signed Shim binaries between 0.4
 246   and 0.7, so I don't know if any of them might work.
 247
 248 - Implemented a workaround for a bug in Shim 0.8 that prevented
 249   authentication of more than one binary. If any filesystem drivers were
 250   installed, the first one would be verified, leaving rEFInd unable to
 251   launch anything else unless it was signed by a key in the computer's main
 252   Secure Boot db list.
 253
 254 0.9.1 (9/13/2015):
 255 ------------------
 256
 257 - When rEFInd identifies the root (/) partition via the Freedesktop.org
 258   Discoverable Partitions Specification, it now checks two of the
 259   partition's attributes, as per the DPS (see
 260   http://www.freedesktop.org/wiki/Specifications/DiscoverablePartitionsSpec/):
 261   - The partition's read-only attribute determines whether to pass a "rw"
 262     or "ro" option to the kernel.
 263   - If the partition's do-not-automount flag is set, rEFInd will not pass
 264     it as a "root=" option to the kernel. This flag can be used to remove
 265     all but one partition from consideration as a root (/) partition if a
 266     system has more than one with the correct type code.
 267
 268 - Improved Freedesktop.org Discoverable Partitions Specification support:
 269   Previously, if no refind_linux.conf file was present but an /etc/fstab
 270   file was found, rEFInd ignored the Discoverable Partitions Specification
 271   filesystem-type codes. This was fine if /etc/fstab contained a valid "/"
 272   filesystem specification, but if that was absent, the result was no
 273   "root=" specification being present. Under these circumstances
 274   (refind_linux.conf absent, /etc/fstab present but lacking a "/" entry),
 275   rEFInd now tries to identify a device to specify as "root=" via the
 276   Discoverable Partitions Specification.
 277
 278 - Fixed bug that caused "Found match!" and a prompt to press a key to
 279   continue to be printed if any partition used the Freedesktop.org
 280   Discoverable Partitions Specification root-partition GUID. (This
 281   was leftover debugging/testing code that I somehow missed deleting.)
 282
 283 - Added icon for Elementary OS.
 284
 285 - Added /etc/lsb-release to files scanned for clues about the Linux
 286   distribution. This file differentiates Mint and Elementary OS from Ubuntu
 287   better than does /etc/os-release, and may also help with other
 288   closely-related distributions.
 289
 290 - Improvements to handling of case-insensitive string comparisons. These
 291   are buggy on some EFIs, and such bugs affect things like dont_scan_*
 292   blacklists, removal of rEFInd's own directory from scanning, matching of
 293   keyword names in refind.conf, and even loading of icons. I've replaced
 294   many calls to problematic functions with safer calls, which should help a
 295   lot. There may still be problems on some systems with some computers,
 296   though; as far as I can tell, the bugs are buried deep in some EFI
 297   firmware, so I can only replace some of the most direct calls to
 298   potentially buggy system calls.
 299
 300 0.9.0 (7/26/2015):
 301 ------------------
 302
 303 - New icon for Kali Linux, submitted by Francesco D'Eugenio.
 304
 305 - Minor code changes to ensure that rEFInd compiles with GCC 5.1. (Tested
 306   with GNU-EFI on a Fedora 22 system; not yet tested with the TianoCore
 307   EDK2.)
 308
 309 - Added new "fold_linux_kernels" token to refind.conf. This option, when
 310   active (the default) "folds" all Linux kernels in a directory into a
 311   single entry on the rEFInd menu. The kernel with the most recent time
 312   stamp is launched by default. To launch another kernel, you must press F2
 313   or Insert; additional kernels appear as options on the first kernel's
 314   submenu. To see the pre-0.9.0 behavior, you must set "fold_linux_kernels
 315   false" (or one of its synonyms, "off" or "0"). The point of this option
 316   is to help de-clutter the rEFInd main menu.
 317
 318 - Added new Linux root (/) partition auto-discovery feature, based on
 319   Freedesktop.org's Discoverable Partitions Spec (DPS)
 320   (http://www.freedesktop.org/wiki/Specifications/DiscoverablePartitionsSpec/):
 321   If no refind_linux.conf file or /etc/fstab file is found, and if a
 322   partition with the correct DPS type code for the system architecture is
 323   found, rEFInd adds "ro root=/dev/disk/by-partuuid/{GUID}" to the kernel
 324   options. This will not help on LVM setups, and will get it right for only
 325   one installation on systems with multiple Linux installations, but it may
 326   help some users, if/when the DPS type codes become more common.
 327
 328 - Fixed bug that caused a rEFInd crash if an empty refind_linux.conf
 329   file was encountered.
 330
 331 - The mkrlconf.sh script now checks the OS on which it's running, which
 332   should help avoid confusion or problems by users who mistakenly run it
 333   under OS X.
 334
 335 - rEFInd now skips checking for various BIOS-mode boot sector signatures
 336   when running on a UEFI-based PC; these checks are run only on Macs. This
 337   may reduce startup time on systems with many partitions.
 338
 339 - Fixed Debian debinstall script to work correctly on IA32 systems. It had
 340   a bug that caused filesystem drivers and gptsync to not be packaged for
 341   IA32.
 342
 343 - Modified Debian postinst file to call install.sh with --localkeys option
 344   if sbsign and openssl are available, even when NOT in Secure Boot mode or
 345   if shim is not detected. This helps with my Ubuntu PPA when using custom
 346   Secure Boot keys, since the PPA is delivered unsigned. (Users will have
 347   to have added their own local keys to their firmware's db.) For
 348   consistency, I've made the same change to the RPM .spec file.
 349
 350 0.8.7 (3/1/2015):
 351 -----------------
 352
 353 - Fixed install.sh bug that caused inappropriate installation under the
 354   name bootx64.efi (or bootia32.efi) under Linux, with a failure to update
 355   the boot entries in NVRAM, has been fixed.
 356
 357 - Added identification of XFS as filesystem type in volume descriptions.
 358
 359 - More fixes to filesystem type detection code. Previous version sometimes
 360   identified FAT or NTFS (or anything with a boot loader) as a whole-disk
 361   device rather than the correct filesystem type.
 362
 363 - Added protections to the code to reduce the risk of crashes that might
 364   occur when dereferencing NULL pointers in various situations.
 365
 366 - I'm deprecating the use of filesystem numbers (as in "fs0:") because
 367   they're unreliable -- filesystem numbers can change between boots and
 368   might not be the same as those used in an EFI shell or other program.
 369   Sooner or later I'll remove code supporting this feature. In the
 370   meantime, if it doesn't work for you, please switch to using filesystem
 371   labels, partition labels, or partition GUIDs.
 372
 373 - Added detection of FreeBSD's BIOS-mode GPT boot loader. Previously,
 374   rEFInd could detect FreeBSD's BIOS-mode MBR boot loader, which gave
 375   FreeBSD an appropriate icon on Macs; but the BIOS-mode GPT boot loader
 376   code is different, so some recent FreeBSD installations showed up with
 377   generic grey diamond icons. This change creates FreeBSD icons instead.
 378
 379 - Added "Secure Boot [active|inactive]" notice to "about" menu for x86
 380   (32-bit) systems, since there are now a few 32-bit UEFI systems that
 381   support Secure Boot. (AFAIK, these are mostly tablets and convertibles
 382   such as the ASUS T100.)
 383
 384 - Added KeyTool.efi and KeyTool-signed.efi to list of MOK managers. KeyTool
 385   is the "super-deluxe" Secure Boot key and hash manager provided as part
 386   of the efitools package.
 387
 388 - Fixed more instances of "invalid parameter" errors on some EFIs.
 389
 390 - Improved Secure Boot detection in install.sh.
 391
 392 - install.sh should no longer complain when copying Shim or MokManager over
 393   itself.
 394
 395 0.8.6 (2/8/2015):
 396 -----------------
 397
 398 - Removed special case of ignoring an HFS+ name of "HFS+ volume", since the
 399   old rEFInd HFS+ driver that produced this name for all HFS+ volumes has
 400   long since been updated to deliver a real name.
 401
 402 - Addition of new Windows 8 OS icon. On Macs and for BIOS/legacy boots, the
 403   new icon is now used for Windows Vista, 7, and 8, while the old one is
 404   used for earlier versions of Windows. For EFI-mode boots, the new icon is
 405   used universally.
 406
 407 - If the NTFS driver is loaded, rEFInd now scans NTFS volumes on Macs for
 408   the presence of Windows boot files, and removes any NTFS volume that
 409   lacks such files from the BIOS/legacy boot list. This should help
 410   unclutter the display on Macs that contain NTFS data partitions.
 411
 412 - Fixed bug that caused misidentification of both whole disks and NTFS
 413   volumes as being FAT. (This bug affected the identification of devices
 414   and locations in the rEFInd menu, not actual access to devices.)
 415
 416 - Code refactoring to clear out legacy-boot functions from the
 417   ever-expanding refind/main.c file.
 418
 419 - Added new "badges" option to the "hideui" token in refind.conf. This
 420   option hides the device-type badges associated with the OS boot options.
 421
 422 - Reverted rEFIt commit r472, introduced in rEFInd 0.8.5 to support more
 423   BMP images because I've received bug reports that it's causing existing
 424   selection images to fail to load.
 425
 426 - Fixed install.sh bug that caused misidentification of installation
 427   directory under OS X if an already-mounted ESP has spaces in its path.
 428
 429 - Fixed Mac-specific install.sh bug that could cause misidentification of
 430   the ESP on disks with partition numbers of 10 or above.
 431
 432
 433 0.8.5 (2/1/2015):
 434 -----------------
 435
 436 - Added NTFS EFI filesystem driver.
 437
 438 - Minor improvements to filesystem driver framework code.
 439
 440 - Changes to
 441
 442 - Fixed bug in Btrfs driver's address reference.
 443
 444 - Improved install.sh to make it smarter about figuring out where to
 445   install on Macs. Specifically, this version now upgrades existing
 446   installations, if found (as it always has under Linux), rather than
 447   blindly install to EFI/BOOT; it installs to EFI/refind if not existing
 448   installation is found; it installs using the --shortform option to bless,
 449   which seems to eliminate the 30-second delay problem; and it can handle
 450   an HFS+ ESP, which it treats as a separate HFS+ volume (as if the user
 451   had used --ownhfs). These changes do not affect behavior under Linux.
 452
 453 - Added missing check of architecture type for several tools.
 454
 455 - Applied rEFIt commit r472, which adds support for BMP images with negative
 456   height fields, indicating that the image is NOT vertically flipped. This
 457   commit and r467 were not incorporated in the original rEFInd because I
 458   forked it from a Debian rEFIt package that had been patched to build
 459   under GNU-EFI, and was apparently based on a slightly earlier version.
 460
 461 - Applied rEFIt commit r467, which improves Mac handling of legacy boots
 462   from other than the first hard disk.
 463
 464
 465 0.8.4 (12/8/2014):
 466 ------------------
 467
 468 - Tweaked default for dont_scan_volumes: Removed "Recovery HD". This change
 469   better suits the needs of OS X 10.10 ("Yosemite") installations, but may
 470   result in some stray Recovery HD entries on some Macs.
 471
 472 - Updated icons for Fedora and Ubuntu and added an icon for Xubuntu.
 473
 474 - Added new configuration option, "enable_and_lock_vmx", which sets an
 475   Intel CPU feature that's required for some types of virtualization to
 476   work. Most EFIs enable setting this feature in their own setup utilities,
 477   but some (such as most Macs) don't.
 478
 479 - If rEFInd can't locate an icons directory (either the default or one
 480   specified by the icons_dir token), the program switches to text-only
 481   mode.
 482
 483 - If a loader contains the string "grub" and no other clue to the loader's
 484   OS association exists, search for os_grub.{png|icns} (which is not
 485   provided with rEFInd) or os_linux.{png|icns}. (Previous versions provided
 486   a generic loader icon for GRUB.)
 487
 488 - Fixed bug that caused dont_scan_files to not work with special-case
 489   boot loaders (for OS X and Windows) when specifying the complete path to
 490   the loader (e.g., EFI/Microsoft/Boot/bootmgfw.efi).
 491
 492 - Added support for the iPXE network boot tool (see BUILDING.txt for
 493   building and basic use instructions).
 494
 495 0.8.3 (7/6/2014):
 496 -----------------
 497
 498 - Added new feature: Setting "timeout = -1" in refind.conf causes rEFInd to
 499   immediately boot the default option UNLESS a keypress is in the buffer
 500   when rEFInd launches. In that case, if the keypress corresponds to a
 501   shortcut key, the associated boot loader is launched; or if not, the menu
 502   is displayed.
 503
 504 - Added new icons for Clover boot loader and for Mythbuntu Linux
 505   distribution.
 506
 507 - rEFInd now displays the partition's label, when one is available, when
 508   offering a BIOS-mode boot option for a partition with no filesystem
 509   driver. This works only on Macs doing BIOS-mode booting.
 510
 511 - Removed GPLv2 code from the FSW core files. This was done because the
 512   Btrfs driver is derived from the GRUB Btrfs driver, which is licensed
 513   under the GPLv3. Ironically, the GPLv2 and GPLv3 are incompatible
 514   licenses, so ensuring that the Btrfs driver doesn't rely on GPLv2 code
 515   was legally necessary. In most cases, I reverted to the original rEFIt
 516   code, although I kept my own cache code; since I wrote it, I can
 517   change its license to a BSD license.
 518
 519 - Fixed bug that caused rEFInd to unload drivers immediately after loading
 520   them. This didn't affect rEFInd's own drivers because they didn't include
 521   the unload hooks, but it did affect some other drivers.
 522
 523 - Changed default scan_all_linux_kernels setting from "false" to "true",
 524   and commented the option out in refind.conf-sample. This should not
 525   affect most people, since refind.conf-sample had this option commented
 526   out, and most rEFInd users either use it that way or don't have Linux
 527   kernels installed at all. I've made this change because I want rEFInd to
 528   "do the right thing" by default in as many cases as possible. For a while
 529   now, rEFInd has been excluding non-bootable files from its menu, and most
 530   kernels "in the wild" now include the EFI stub. Thus, enabling this
 531   support by default seems worthwhile. If you prefer to not scan Linux
 532   kernels by default, simply uncomment the "scan_all_linux_kernels" line
 533   and ensure it's set to "false".
 534
 535 0.8.2.1 (6/8/2014):
 536 -------------------
 537
 538 - Removed stray bit of debugging code that caused a prompt to press a
 539   key to appear at rEFInd startup.
 540
 541 0.8.2 (6/8/2014):
 542 -----------------
 543
 544 - Changed behavior when default_selection is not set: It now boots the
 545   previously-booted loader, assuming it's still available; if not, rEFInd
 546   boots the first loader (as it does now). Behavior is unchanged if
 547   default_selection is set. Note that this behavior depends on the ability
 548   of rEFInd to store an EFI variable in NVRAM. It therefore fails on
 549   systems with flaky NVRAM storage. You can view the previously-booted
 550   loader in the
 551   /sys/firmware/efi/efivars/PreviousBoot-36d08fa7-cf0b-42f5-8f14-68df73ed3740
 552   variable under Linux.
 553
 554 - Added icon for Mageia Linux (os_mageia.png).
 555
 556 - Fixed bug that could misidentify a not-quite-GUID as a GUID in a
 557   manual boot stanza's "volume" line.
 558
 559 - I've updated my personal build system, and therefore the rEFInd Makefiles
 560   and related files, to use TianoCore UDK2014 rather than UDK2010.
 561
 562 - Added "deep_uefi_legacy_scan" token. When not set (the default), rEFInd
 563   does not modify EFI NVRAM settings when scanning for BIOS-mode boot
 564   loaders on UEFI-based (non-Mac) computers. Some computers require
 565   uncommenting this setting for rEFInd to reliably detect some BIOS-mode
 566   boot devices. Passing "0", "off", or "false" as an option resets it to
 567   the default value (useful in a loaded secondary configuration file to
 568   override a setting in the main file).
 569
 570 0.8.1 (5/15/2014):
 571 ------------------
 572
 573 - Fixed bug that could cause rEFInd to fail to detect boot loaders stored
 574   on the root directory of a partition.
 575
 576 - Added two new bitmap fonts to those distributed with rEFInd: Ubuntu Mono
 577   and Nimbus Mono. Both come in 12-, 14-, 16-, and 24-point sizes.
 578
 579 - Messages about pauses for scanning and re-scanning of boot loaders are
 580   now suppressed when doing an initial delayed scan when scan_delay is 1
 581   second.
 582
 583 - Improved centering of legacy boot option descriptions on some systems'
 584   screens.
 585
 586 - Fixed bug that could cause a BIOS-mode boot to boot from an inappropriate
 587   device if that device had an innately high boot priority (as set by the
 588   firmware).
 589
 590 - Changed icons from ICNS to PNG form. There are several reasons to do
 591   this, all of them minor; but together they're enough to warrant a change.
 592   PNG is more common, and therefore more accessible to most users --
 593   particularly those who don't use OS X. The PNG files are smaller than
 594   their ICNS equivalents. PNG supports a wider range of sizes (although I'm
 595   not now using anything that ICNS doesn't support, I might in the future).
 596   The icon-scaling support added a few versions ago makes ICNS's support
 597   for multiple icon sizes relatively unimportant.
 598
 599 - Reversed order of search for icons by extension: rEFInd now searches
 600   for PNG files before ICNS files, rather than the other way around. This
 601   makes it possible to override a volume icon for rEFInd by giving it the
 602   name .VolumeIcon.png, even when a .VolumeIcon.icns file exists on the
 603   volume and is used by OS X.
 604
 605 - Fixed bug that caused .VolumeIcon.icns to take higher-than-intended
 606   precedence in icon setting for OS X.
 607
 608 - Chainloading to BIOS-mode boot loaders now works on UEFI-based PCs when
 609   rEFInd is built with GNU-EFI, not just when built with Tianocore.
 610
 611 0.8.0 (5/4/2014):
 612 -----------------
 613
 614 - The "dont_scan_volumes" parameter now also works with legacy-boot
 615   volumes. Unlike with EFI volumes, where the option you pass must exactly
 616   match an entire volume name, when applied to legacy-boot volumes, it
 617   matches any part of the description that appears beneath the item when
 618   you select it in the rEFInd main menu.
 619
 620 - Can now boot in legacy mode from second (and probably later) hard disks!
 621
 622 - rEFInd now limits the length of the firmware name string shown in the
 623   system information screen to 65 characters. This is done because at least
 624   one EFI presents a longer string by default, and this causes the entire
 625   information display to come up empty on 800x600 displays.
 626
 627 - rEFInd now uses the partition's name (as stored in the GPT data
 628   structures) as a fallback for the filesystem's name if the latter can't
 629   be found. Exceptions are if the partition name is one of three generic
 630   names used by GPT fdisk: "Microsoft basic data", "Linux filesystem", or
 631   "Apple HFS/HFS+". These are ignored in favor of the descriptive fallback
 632   (e.g., "20 GiB Btrfs volume")
 633
 634 - It's now possible to specify a volume by partition GUID number in a
 635   manual boot stanza. This should be more reliable (albeit also more
 636   awkward) than using a filesystem number (such as fs0: or fs1:).
 637
 638 - Fixed memory-allocation bug that could cause error message displays,
 639   and possibly hangs, when re-scanning boot loaders.
 640
 641 0.7.9 (4/20/2014):
 642 ------------------
 643
 644 - Attempt to fix rEFInd perpetually re-scanning after ejecting a disc on
 645   some Macs.
 646
 647 - Added check to remove redundant (or non-functional if Secure Boot is
 648   active) kernel entries for Ubuntu, which is now including two versions of
 649   kernels, one signed and the other unsigned.
 650
 651 - Fixed bug in install.sh that could cause it to display error messages
 652   if the dmraid utility was not installed.
 653
 654 - The HFS+ driver now reports a correct volume name.
 655
 656 - Fixed some EFI filesystem driver bugs that could cause lockups under
 657   some circumstances. These bugs could affect any of the filesystem
 658   drivers.
 659
 660 - Added "gdisk" option to the "showtools" configuration file token. When
 661   active, this adds gdisk.efi or gdisk_{arch}.efi, if present in the
 662   EFI\tools directory, to the tools row.
 663
 664 - Fixed mistaken identification of the MOK utility as the "MOK utility
 665   utility."
 666
 667
 668 0.7.8 (3/9/2014):
 669 -----------------
 670
 671 - Added "debian" directory to source, which facilitates creation of Debian
 672   packages. Packages built in this way are built with GNU-EFI and don't run
 673   any post-installation script, so although the rEFInd binaries are on the
 674   hard disk, they aren't installed to be bootable; you must manually run
 675   install.sh. Also, at least on Ubuntu, the Make.common file's /usr/lib64
 676   references must be changed to /usr/lib. This is more of a proof of
 677   concept and a "leg up" for distribution maintainers than anything else.
 678
 679 - Two new options, big_icon_size and small_icon_size, set the size of
 680   the first-row OS icons and of the second-row tool icons, respectively.
 681   The big_icon_size option also indirectly sets the size of disk-type
 682   badges; they're 1/4 the size of the big icons. Default values are 128 and
 683   48, respectively, to match the actual icon files provided with rEFInd. If
 684   the icon you're using is of a different size than you've specified,
 685   rEFInd scales it. For best quality, you should both provide icons drawn
 686   to the right size and set the icon sizes in refind.conf.
 687
 688 - rEFInd now automatically scales icons to fit the standard icon sizes.
 689   This won't have any effect with the icons that come with rEFInd, but it
 690   can help if you want to use another icon, since you needn't scale it in a
 691   graphics program before using it. Note that rEFInd uses bitmap icons, so
 692   scaling by a huge amount (say, a 16x16 icon to fit the standard 128x128
 693   OS icon) is not likely to look good.
 694
 695 - Added new option, banner_scale, that tells rEFInd how to handle banners:
 696   Set to "noscale" (the default), banners are not scaled, although they'll
 697   be cropped if they're too big for the display. This is the same as the
 698   behavior in previous versions. Set to "fillscreen", rEFInd now scales the
 699   banner image (larger or smaller) to fill the display.
 700
 701 - Adjusted the post-installation script in refind.spec (used to generate
 702   RPMs, and therefore also indirectly Debian packages) to search for
 703   existing shim program files under the filesnames shim.efi and shimx64.efi
 704   rather than just shim.efi. Ubuntu uses shimx64.efi, so Debian packages
 705   were failing to detect Ubuntu's shim in previous versions. (Note,
 706   however, that Ubuntu's early shim 0.1 is unsuitable for use with rEFInd
 707   The newer 0.4 version that's in the repositories now should work fine;
 708   it's only when installing on an older system that's NOT been updated that
 709   problems might arise.
 710
 711 0.7.7 (1/3/2014):
 712 -----------------
 713
 714 - Can now specify complete paths, optionally including volumes, in
 715   dont_scan_files.
 716
 717 - Added shimx64.efi to the default dont_scan_files list.
 718
 719 - Added windows_recovery_files token, to specify what program(s) launch a
 720   Windows recovery utility; and the "windows_recovery" option to
 721   "showtools," to control whether or not to display the Windows recovery
 722   utility on the second row of icons.
 723
 724 - The use_graphics_for, also_scan_dirs, dont_scan_dirs, dont_scan_files,
 725   and scan_driver_dirs tokens in refind.conf now support "+" as the first
 726   option, which causes the remaining options to be added to the default
 727   value rather than replacing that value. (This has no practical effect for
 728   scan_driver_dirs, though, since it has a null default value.)
 729
 730 - Added support for specifying the configuration file at program launch,
 731   via the "-c" parameter, as in "refind_x64.efi -c foo.conf" to use the
 732   foo.conf file as the main configuration file.
 733
 734 - Scans of ext2/3/4fs and ReiserFS partitions now omit partitions with
 735   duplicate filesystem UUIDs. These are likely parts of RAID arrays and so
 736   would have the same boot loaders or kernels as the first one with a given
 737   UUID.
 738
 739 - Added feature in install.sh: Script now tries to locate and mount an ESP
 740   in Linux, if it's currently unmounted.
 741
 742 - Fixed bug in mkrlconf.sh and install.sh that caused a stray line break
 743   and PARTUUID= specification to appear in generated refind_linux.conf file
 744   under some circumstances.
 745
 746 0.7.6 (12/15/2013):
 747 -------------------
 748
 749 - Added support for multiple "default_selection" targets. These MUST be
 750   comma-separated AND enclosed in quotes, as in:
 751   default_selection "fred,ginger"
 752   This example will launch "fred" by default if it's available; and if
 753   it's not, rEFInd will attempt to launch "ginger" as the default.
 754
 755 - Added support for time-sensitive "default_selection" setting. This token
 756   may now have either one or three options. If one, it's interpreted as it
 757   has been in the past, as setting a default that's independent of times.
 758   If you follow this default by two times, however, those are interpreted
 759   as the start and end times (in 24-hour format) for a default setting. For
 760   instance, "default_selection foo 8:00 17:00" causes foo to be the default
 761   from 8:00 (AM) to 17:00 (aka 5:00 PM). You can include multiple
 762   "default_selection" lines to set different defaults for a variety of
 763   times. If they're in conflict, the last one takes precedence. Note that
 764   times are hardware clock's native value, which may be local time or UTC,
 765   depending on your computer.
 766
 767 - Added support for a blank-screen startup: Set "screensaver -1" and the
 768   screen saver will be initialized when rEFInd starts. If you set a low
 769   "timeout" value, the result will be a boot straight to the default OS
 770   unless you hit a key soon after rEFInd starts. Once you hit a key, the
 771   screensaver will be disabled.
 772
 773 - Added --ownhfs {target} option to install.sh. This option causes rEFInd
 774   to install to an HFS+ partition in a way that's more consistent with the
 775   way the Mac's native boot loader is installed. Note that you should NOT
 776   install to an already-bootable partition with this option, since it will
 777   overwrite the existing boot loader, which would render OS X unbootable.
 778
 779 0.7.5 (11/10/2013):
 780 -------------------
 781
 782 - Fixed bug that caused unbootable exFAT partitions to show up as
 783   bootable on Macs with BIOS/CSM/legacy boot options enabled.
 784
 785 - Fixed bug in install.sh that caused installs to the ESP on recent
 786   versions of OS X to fail.
 787
 788 - Fixed bug that caused rEFInd to hang on some Macs when multiple EFI
 789   drivers were present.
 790
 791 - Fixed bug that caused clear to default gray screen when launching OSes
 792   with 'use_graphics_for' enabled, even when the rEFInd background is not
 793   gray. Now rEFInd clears to the same background color used in its menu.
 794   When launching OS X, though, the OS X boot loader will itself clear to
 795   gray a second or so later; and when launching Linux, it will clear to
 796   black a second or so later.
 797
 798 0.7.4.1 (8/25/2013):
 799 --------------------
 800
 801 - My initial 0.7.4 release broke legacy-boot ability on Macs, so I quickly
 802   released this version using the original 0.7.4 filenames to fix the
 803   problem.
 804
 805 0.7.4 (8/25/2013):
 806 ------------------
 807
 808 - Fixed options passing to loader to include loader's filename as the first
 809   option. This omission had no effect on most boot loaders, but caused
 810   VMware's mboot64.efi to fail.
 811
 812 - Added support for memtest86 as second-row option. Program must be
 813   stored in EFI/tools, EFI/tools/memtest, EFI/tools/memtest86, EFI/memtest,
 814   or EFI/memtest86; and must use the name memtest86.efi, memtest86_x64.efi,
 815   memtest86x64.efi, or bootx64.efi (changing "x64" to "ia32" on IA-32
 816   systems). The memtest86 program is scanned for when the "showtools"
 817   option includes the "memtest" or "memtest86" token, which it does by
 818   default.
 819
 820 - Added space to end of "Boot %s from %s" string; enables adding a space
 821   to the end of the "default_selection" item (in quotes) to set a default
 822   that matches a volume name that's identical to another one except for
 823   extra characters at the end of the non-wanted volume's name.
 824
 825 - Fixed bug that could cause rEFInd to hang when launching boot loaders
 826   under some conditions. (Launching from Firewire drives on Macs is the
 827   known case, but there may be others.)
 828
 829 0.7.3 (8/7/2013):
 830 -----------------
 831
 832 - Fixed bug that caused missing media-type badges on BIOS-mode boot
 833   loaders on Macs.
 834
 835 - Fixed bug that caused failure when launching BIOS-mode OSes on Macs.
 836
 837 0.7.2 (8/6/2013):
 838 -----------------
 839
 840 - Fixed bug that caused display glitches in the final entry on the first
 841   row of icons if the second row of icons was empty.
 842
 843 - Fixed bug that could cause incorrect scanning or even a rEFInd crash when
 844   using volume specification in also_scan_dirs token.
 845
 846 - Added protection against loading invalid drivers and other EFI programs.
 847   (Some EFIs crash when attempting to load such drivers and programs.)
 848
 849 - Added PreLoader.efi and shim-fedora.efi to default dont_scan_files list;
 850   it's now "shim.efi, shim-fedora.efi, PreLoader.efi, TextMode.efi,
 851   ebounce.efi, GraphicsConsole.efi, MokManager.efi, HashTool.efi,
 852   HashTool-signed.efi".
 853
 854 - Added icon for Funtoo Linux.
 855
 856 - Fixed reading of volume badges from user-specified icons directory, which
 857   was broken.
 858
 859 - Fixed handling of /.VolumeBadge.icns (or /.VolumeBadge.png) files, which
 860   was broken.
 861
 862 0.7.1 (7/8/2013):
 863 -----------------
 864
 865 - Fixed build problem with recent development versions of EDK2.
 866
 867 - Added scan for Boot Repair's backup of the Windows boot loader
 868   (bkpbootmgfw.efi). If found, give separate entries for it and for
 869   bootmgfw.efi, each with its own descriptive text label.
 870
 871 - Fixed also_scan_dirs; used to have bug that caused it to ignore
 872   volume specification, if present.
 873
 874 - Fixed bug in driver cache that caused Btrfs driver to hang sometimes.
 875
 876 0.7.0 (6/27/2013):
 877 ------------------
 878
 879 - Added Btrfs signature to rEFInd, so that it can identify the filesystem
 880   type for volumes that lack labels.
 881
 882 - Changed some critical filesystem driver pointers from 32-bit to 64-bit.
 883   This *SHOULD* enable use of over-2TiB filesystems (for those filesystems
 884   that support such large volumes). This capability is largely untested,
 885   though.
 886
 887 - Added a cache to the filesystem driver core, and therefore to all the
 888   filesystem drivers. This cache greatly improves performance in
 889   VirtualBox, and offers modest performance improvements on a few "real"
 890   computers. The most dramatic improvement is on ext2/3fs under VirtualBox:
 891   Loading a kernel and initrd used to take ~200 seconds on my system, but
 892   now takes ~3 seconds! On most "real" hardware, the improvement is much
 893   less dramatic -- an improvement of a second or less, presumably because
 894   of cacheing within the EFI or on the hard disk itself.
 895
 896 - Filter boot loaders based on a test of their validity; keeps out Linux
 897   kernels without EFI stub loader code, loaders for the wrong architecture,
 898   non-EFI loaders, etc.
 899
 900 - New Btrfs driver, contributed by Samuel Liao based on GRUB 2.00 Btrfs
 901   code.
 902
 903 0.6.12 (6/18/2013):
 904 -------------------
 905
 906 - Changed the 64-bit EFI shell included in the CD-R and USB flash drive
 907   images to a version 2 shell that should support the "bcfg" command.
 908
 909 - Added support for PreBootloader to refind.spec's built-in installation
 910   script.
 911
 912 - Added support for the Linux Foundation's PreLoader to install.sh. It's
 913   treated just like shim, including using the --shim option (or, now,
 914   --preloader); but it searches for and copies HashTool.efi rather than
 915   MokManager.efi, and filenames are adjusted appropriately.
 916
 917 - Added code to determine Linux root filesystem from /etc/fstab file, if
 918   it's on the same partition as the kernel and if the refind_linux.conf
 919   file is not available. This enables rEFInd to boot Linux without any
 920   rEFInd-specific configuration files on some (but not all) systems.
 921
 922 0.6.11 (5/13/2013):
 923 -------------------
 924
 925 - New feature: rEFInd now ignores symbolic links to files on filesystems
 926   that support them. This prevents the "vmlinuz" symbolic link that some
 927   distributions create in the root directory from appearing in the loader
 928   list. Note that this does NOT affect symbolic links to directories.
 929
 930 - Added icons for Lubuntu and Kubuntu.
 931
 932 - Improved the install.sh script so that it does a better job dealing with
 933   directory names that contain spaces.
 934
 935 - rEFInd now tries to guess the Linux distribution type based on the kernel
 936   filename (Fedora and RHEL only) or the "ID" or "NAME" variables in
 937   /etc/os-release on the kernel's partition. None of these is guaranteed to
 938   work. A fallback of the Tux penguin icon remains in place in case rEFInd
 939   can't find anything substantive enough for a guess.
 940
 941 - Added "EFI\opensuse" to the locations searched for MOK utilities, since
 942   OpenSUSE now uses that name.
 943
 944 - Renamed "Reboot to Firmware User Interface" to "Reboot to Computer Setup
 945   Utility" in menu.
 946
 947 - Fixed bug in gptsync that caused it to hang if the disk had too few GPT
 948   partitions to fill the MBR.
 949
 950 0.6.10 (5/5/2013):
 951 ------------------
 952
 953 - Added support for "screensaver" token. If set to a positive integer, this
 954   causes the screen to blank after the specified number of seconds of
 955   inactivity. Pressing most keys (unfortunately NOT including Shift, Alt,
 956   or Ctrl) will restore the display and restart the screen saver timeout.
 957
 958 - Added icon for ChromeOS (os_chrome.icns in the icons subdirectory).
 959   ChromeBooks reportedly boots using the fallback filename, but if a user
 960   wants to install rEFInd on a ChromeBook, renaming the original EFI/BOOT
 961   directory to EFI/chrome and then installing rEFInd in the fallback
 962   filename will bring up this new icon for ChromeOS.
 963
 964 - Added new option to reboot the computer into the firmware's user
 965   interface. This option is active by default, or can be set via the
 966   "firmware" option to the "showtools" token in refind.conf. It works
 967   on only some computers, though; older computers lack this feature, and
 968   when rEFInd is told to use this feature on such computers, the directive
 969   is quietly ignored.
 970
 971 - Upgraded LodePNG library from version 20121216 to 20130415 and
 972   restructured rEFInd-specific modifications to simplify future upgrades.
 973
 974 - Replaced hexadecimal error code with description if an error is
 975   encountered when saving a screen shot.
 976
 977 - Enable multiple screen shots: Rather than naming all screen shots
 978   "screenshot.bmp", the name is now "screenshot_###.bmp", where "###" is a
 979   sequence number, starting with "001".
 980
 981 0.6.9 (4/25/2013):
 982 ------------------
 983
 984 - Modified default banner to include the new rEFInd icon, provided by Erik
 985   Kemperman.
 986
 987 - Worked around a suspected firmware bug that caused rEFInd 0.6.6 to 0.6.8
 988   to hang at startup on some systems (DUET and some Macs).
 989
 990 - Modified rEFInd to search for gptsync under the names gptsync.efi and
 991   gptsync_{arch}.efi, where {arch} is ia32 or x64. (Previous versions
 992   searched only for gptsync.efi.)
 993
 994 - Added gptsync program from rEFIt project, but with some changes to
 995   improve flexibility and make it less likely that UEFI users will
 996   accidentally trash their systems.
 997
 998 - Changed timeout code so that the timeout continues if the keyboard is
 999   disconnected. This can help in booting a headless server or a system with
1000   a bluetooth or other keyboard that's not recognized by the EFI.
1001
1002 0.6.8 (3/18/2013):
1003 ------------------
1004
1005 - Added workaround for presumed EFI bug that was causing "Invalid
1006   Parameter" errors when scanning for boot loaders on some computers.
1007
1008 - Added search for an EFI shell called shell.efi in the root directory
1009   (previously this name was only accepted in EFI\tools).
1010
1011 - Fixed bug in install.sh that caused it to fail on some systems (Fedora
1012   18, for instance) because of a problem identifying the ESP.
1013
1014 - Fixed bug that caused icons named after boot loaders to not be used.
1015
1016 0.6.7 (2/3/2013):
1017 -----------------
1018
1019 - Added a more explicit error message summarizing options when a launch of
1020   a program results in a Secure Boot failure.
1021
1022 - Changed MOK tool detection to scan all volumes, not just the rEFInd
1023   home volume. This is desirable because the Linux Foundation's HashTool
1024   can only scan its own volume, making it desirable to place copies of this
1025   program on every volume that holds EFI boot loader binaries.
1026
1027 - Added support for launching the Linux Foundation HashTool as a means of
1028   managing MOKs (or MOK hashes, at any rate).
1029
1030 - Fixed bug that caused rEFInd to present an entry for itself as a
1031   Microsoft OS if it was launched as EFI/Microsoft/Boot/bootmgfw.efi.
1032
1033 - Fixed bug that caused dont_scan_volumes option to be added to
1034   also_scan_dirs list.
1035
1036 - Fixed dont_scan_volumes so that it works with OS X boot loaders.
1037
1038 - Fixed broken mixing of PNG and ICNS icons when using a user-specified
1039   icons directory -- previously, an ICNS file in the default directory
1040   would override a PNG file in the user-specified directory.
1041
1042 0.6.6 (1/26/2013):
1043 ------------------
1044
1045 - rEFInd now ignores the fallback boot loader (EFI/BOOT/bootx64.efi or
1046   EFI/BOOT/bootia32.efi) if it's identical to another boot loader on
1047   the same volume. This is intended to help unclutter the display on
1048   systems that run Windows, since Windows tends to duplicate its own boot
1049   loader under the fallback name.
1050
1051 - Added new "font" token to refind.conf, which enables specifying a font in
1052   the form of a PNG file. This file must contain monospace glyphs for the
1053   95 characters from ASCII 32 to 126 (space through tilde), inclusive, plus
1054   a glyph to be displayed for characters outside of this range, for a total
1055   of 96 glyphs.
1056
1057 - Replaced the old font (inherited from rEFInd) with an anti-aliased
1058   version of Luxi Mono Regular 14 point.
1059
1060 - Fixed bug that caused rEFInd to ignore manual boot stanzas in files
1061   included via the "include" token in refind.conf.
1062
1063 - Fixed bug that caused ASSERT error on some systems (and conceivably a
1064   crash on startup on some) when default_selection line in refind.conf was
1065   commented out or empty.
1066
1067 - Fixed bug that caused "Binary is whitelisted" message to persist on
1068   screen after loading MOK-signed drivers in Secure Boot mode.
1069
1070 - Fixed bug that caused rEFInd to ignore the "icon" token in refind.conf
1071   manual boot stanzas.
1072
1073 - Fixed bug in install.sh that caused the script to fail to update
1074   drivers when rEFInd was installed in EFI/BOOT/.
1075
1076 0.6.5 (1/16/2013):
1077 ------------------
1078
1079 - Improved text color support: rEFInd now uses black text against light
1080   backgrounds and white text against dark backgrounds.
1081
1082 - Added support for PNGs as banners, icons, and selectors.
1083
1084 - Added icon for ALT Linux.
1085
1086 - Added "safemode" option to "hideui" token, to hide option to boot into
1087   safe mode for OS X ("-v -x" option to boot.efi).
1088
1089 - Added icon for Haiku (os_haiku.icns).
1090
1091 - Enable transparency of icons & main-menu text when the banner icon is
1092   sized to cover these areas.
1093
1094 - Fixed bug that could cause rEFInd to crash if fed a banner image that's
1095   too big. Note that "too big" can be substantially smaller than the screen
1096   resolution!
1097
1098 0.6.4 (1/8/2013):
1099 -----------------
1100
1101 - Revised install.sh to copy ext2fs driver, rather than ext4fs driver, for
1102   ext2/3 filesystems. This can help keep non-functional entries from links
1103   from /vmlinuz to /boot/vmlinuz out of the menu if the system uses ext4fs
1104   on root and ext2fs or ext3fs on /boot.
1105
1106 - Fixed a couple of memory management bugs that cause rEFInd to hang at
1107   startup on some systems.
1108
1109 0.6.3 (1/6/2013):
1110 -----------------
1111
1112 - Added the ability to specify a volume name or number in the
1113   "dont_scan_dirs" and "also_scan_dirs" tokens.
1114
1115 - Fixed a bug that caused removable EFI media to not appear in scan lists
1116   if rEFInd was installed as EFI/BOOT/boot{arch}.efi on a hard disk.
1117
1118 - Modified ISO-9660 driver so that it can handle discs with other than
1119   2048-byte sectors. This makes it useful for reading "hybrid ISO" images
1120   burned to USB flash disks.
1121
1122 - New mvrefind.sh script to move a rEFInd installation between a standard
1123   location (typically EFI/refind) and one of the fallback locations
1124   (EFI/BOOT or EFI/Microsoft/Boot). It can also do more exotic locations.
1125
1126 - The install.sh script now installs to EFI/BOOT/bootx64.efi or
1127   EFI/Microsoft/Boot/bootmgfw.efi if it's run in BIOS mode. This is
1128   intended to give some chance of producing a bootable installation should
1129   a user accidentally install Linux in EFI mode and then install rEFInd
1130   from that installation.
1131
1132 - The install.sh script now tries to find an existing rEFInd installation
1133   and upgrade it, even if it's in EFI/BOOT or EFI/Microsoft/Boot rather
1134   than in EFI/refind.
1135
1136 - New "--yes" option to install.sh to help with unattended or automated
1137   installations (as from an RPM or Debian package).
1138
1139 0.6.2 (12/30/2012):
1140 -------------------
1141
1142 - Inclusion of a sample refind.spec file for the benefit of RPM
1143   distribution maintainers who might want to include rEFInd. It's a bit
1144   rough, but it gets you a good chunk of the way there....
1145
1146 - The EFI filesystem drivers can now be built with the GNU-EFI toolkit as
1147   well as with the TianoCore EDK2. See the BUILDING.txt file for details on
1148   how to build them with either toolkit. This improvement doesn't affect
1149   users of my binary packages, but it should make it easier for Linux
1150   distributions to adopt rEFInd into their package systems.
1151
1152 - Tweaked refind.inf file for better build results using "native" TianoCore
1153   EDK2 build process (vs. the Makefile-based build process that I use under
1154   Linux). This won't affect those who use my binary builds or build under
1155   Linux with the "make" command.
1156
1157 - Fixed bug that prevented Secure Boot launches from working when rEFInd
1158   was built with GNU-EFI rather than the TianoCore EDK2.
1159
1160 - Substantial reworking of Secure Boot code, based on James Bottomley's
1161   PreLoader program. This new code eliminates the limitation of launching
1162   just one driver in Secure Boot mode and is likely to be more reliable
1163   with future or obscure boot loaders. It should also work with non-x86-64
1164   systems, although this relies on a platform-specific shim program, which
1165   to date exists only for x86-64. The basic features are the same as before
1166   -- rEFInd relies on shim for authentication functions and will launch
1167   programs that are signed by Secure Boot keys, shim keys, or MOKs.
1168
1169 - Altered default for "textmode" option (when it's commented out) to not
1170   adjust the text mode at all. (Prior versions set it to mode 0 by
1171   default.)
1172
1173 0.6.1 (12/21/2012):
1174 -------------------
1175
1176 - Added "--root" option to install.sh, to enable installation of rEFInd
1177   to something other than the currently-running OS. This is intended for
1178   use on emergency discs.
1179
1180 - Thanks to Stefan Agner, the ext4fs driver now supports the "meta_bg"
1181   filesystem feature, which distributes metadata throughout the disk. This
1182   feature isn't used by default, but can be set at filesystem creation time
1183   by passing the "-O meta_bg,^resize_inode" option to mke2fs. (Using
1184   "^resize_inode" is necessary because meta_bg is incompatible with
1185   resize_inode, which IS used by default.) This feature can be used on
1186   ext3fs and ext2fs as well as on ext4fs, so the ext4fs driver can now
1187   handle some ext3fs and ext2fs partitions that the ext2fs driver can't
1188   handle.
1189
1190 - Fixed some screen resolution-setting bugs.
1191
1192 - Added the "words" that make up a filesystem's label (delimited by spaces,
1193   dashes, or underscores) to the list of bases used to search for OS icons.
1194   For instance, if the filesystem's label is "Arch", rEFInd searches for
1195   os_Arch.icns; if it's "Fedora 17", it searches for os_Fedora.icns and
1196   os_17.icns; and if it's "NEW_GENTOO", it searches for os_NEW.icns and
1197   os_GENTOO.icns.
1198
1199 - Refined hints displays to be more context-sensitive, particularly in text
1200   mode.
1201
1202 - Instead of displaying a blank filesystem label when a filesystem has
1203   none, rEFInd now displays the size and/or type of the filesystem, as in
1204   "boot EFI\foo\bar.efi from 200 MiB ext3 volume" rather than "boot
1205   EFI\foo\bar.efi from".
1206
1207 - Fixed a bug that caused the screen to clear after displaying an error
1208   message but before displaying the "Hit any key to continue" message when
1209   a boot loader launch failed.
1210
1211 0.6.0 (12/16/2012):
1212 -------------------
1213
1214 - Fixed a memory allocation bug that could cause a program crash when
1215   specifying certain values with the "also_scan_dirs", "dont_scan_volumes",
1216   "dont_scan_dirs", "dont_scan_files", and "scan_driver_dirs" refind.conf
1217   options.
1218
1219 - Modified Linux kernel initrd-finding code so that if an initrd is
1220   specified in refind_linux.conf, rEFInd will not add any initrd it finds.
1221   This enables an override of the default initrd, and is likely to be
1222   particularly helpful to Arch Linux users.
1223
1224 - Added ext4fs driver!
1225
1226 - Made "boot" the default value for "also_scan_dirs".
1227
1228 - Added identifying screen header to line editor.
1229
1230 - Fixed bug that caused rEFInd's display to be mis-sized upon return
1231   from a program that set the resolution itself.
1232
1233 - Adjusted "resolution" refind.conf parameter so that it can accept EITHER
1234   a resolution as width and height OR a single digit as a UEFI mode number
1235   (which is system-specific). This is done because some systems present the
1236   same mode twice in their mode lists, perhaps varying in refresh rate,
1237   monitor output, or some other salient characteristics; specifying the
1238   mode number enables selecting the higher-numbered mode, whereas using
1239   horizontal and vertical resolution values selects the lowest-numbered
1240   mode.
1241
1242 - Added "textmode" refind.conf parameter to set the text mode used in
1243   text-only displays, and for the line editor and boot-time handoff
1244   display even in graphics mode.
1245
1246 - Fixed bug that caused tools (shell, etc.) to launch when they were
1247   highlighted and F2 or Insert was pressed.
1248
1249 - Added "editor" option to the "hideui" token in refind.conf, which
1250   disables the boot options editor.
1251
1252 - Added hints text to rEFInd main menu and sub-menus. This can be disabled
1253   by setting the new "hints" option to the "hideui" token in refind.conf.
1254
1255 - Added "boot with minimal options" entry to refind_linux.conf file
1256   generated by install.sh. This entry boots without the options extracted
1257   from the /etc/default/grub file.
1258
1259 - Added keys subdirectory to main distribution, to hold public Secure
1260   Boot/shim keys from known sources.
1261
1262 - Changed install.sh --drivers option to --alldrivers, added new
1263   --nodrivers option, and made the default on Linux to install the one
1264   driver that's used on /boot (or the root filesystem if /boot isn't a
1265   separate partition). Of course, this won't install a non-existent driver,
1266   and it also won't work properly if run from an emergency disk unless you
1267   mount a separate /boot partition at that location.
1268
1269 - Fixed bug in install.sh that prevented creation of refind_linux.conf file
1270   on Linux systems.
1271
1272 0.5.1.1 (12/12/2012):
1273 ---------------------
1274
1275 - Fixed bug in install.sh that prevented it from working on OS X.
1276
1277 0.5.1 (12/11/2012):
1278 -------------------
1279
1280 - Added support for "0" options to "textonly" and "scan_all_linux_kernels"
1281   to reverse the usual meaning of these tokens. This is useful for
1282   including these options in a secondary configuration file called with the
1283   new "include" token to override a setting set in the main file.
1284
1285 - Added "include" token for refind.conf, to enable including a secondary
1286   configuration file from a primary one.
1287
1288 - Modified install.sh so that it creates a simple refind_linux.conf file in
1289   /boot, if that file doesn't already exist and if install.sh is run from
1290   Linux. If that directory happens to be on a FAT, HFS+, ext2fs, ext3fs, or
1291   ReiserFS volume, and if the necessary drivers are installed, the result
1292   is that rEFInd will detect the Linux installation with no further
1293   configuration on many systems. (Some may still require tweaking of kernel
1294   options, though; for instance, adding "dolvm" on Gentoo systems that use
1295   LVM.)
1296
1297 - Added --shim and --localkeys options to install.sh to help simplify setup
1298   on systems with Secure Boot active.
1299
1300 - Fixed (maybe) bug that caused resolution options to not be displayed on
1301   recent Macs with GOP graphics when specifying an invalid resolution in
1302   refind.conf.
1303
1304 - Fixed bug that caused some programs (EFI shells, in particular) to hang
1305   when launching on some systems (DUET, in particular).
1306
1307 - Implemented a fix to enable ELILO to launch with Secure Boot active.
1308   This fix might help with some other boot loaders in Secure Boot mode,
1309   too, but I don't know of any specifics.
1310
1311 0.5.0 (12/6/2012):
1312 ------------------
1313
1314 - Added the ability to include quote marks ('"') in refind.conf and
1315   refind_linux.conf tokens by doubling them up, as in:
1316   "ro root=/dev/sda4 some_value=""this is it"""
1317   This example results in the following string being passed as an
1318   option:
1319   ro root=/dev/sda4 some_value="this is it"
1320
1321 - Changed refind.conf-sample to uncomment the scan_all_linux_kernels
1322   option by default. If this option is deleted or commented out, the
1323   program default remains to not scan all Linux kernels; but with
1324   increasing numbers of distributions shipping with kernels that include
1325   EFI stub loader support, setting the configuration file default to scan
1326   for them makes sense.
1327
1328 - Modified the "resolution" token so that it affects text mode as well
1329   as graphics mode. On my systems, though, the actual text area is still
1330   restricted to an 80x25 area. (This seems to be a firmware limitation; my
1331   EFI shells are also so limited.)
1332
1333 - Fixed a bug that caused the options line editor to blank out lines that
1334   were not actually edited.
1335
1336 - Added support for using Matthew Garrett's Shim program and its Machine
1337   Owner Keys (MOKs) to extend Secure Boot capabilities. If rEFInd is
1338   launched from Shim on a computer with Secure Boot active, rEFInd will
1339   launch programs signed with either a standard UEFI Secure Boot key or a
1340   MOK. For the moment, this feature works only on x86-64 systems.
1341
1342 - Added new "dont_scan_files" (aka "don't_scan_files") token for
1343   refind.conf. The effect is similar to dont_scan_dirs, but it creates a
1344   blacklist of filenames within directories rather than directory names.
1345   I'm initially using it to place shim.efi and MokManager.efi in the
1346   blacklist to keep these programs out of the OS list. (MokManager.efi is
1347   scanned separately as a tool; see below.) I've moved checks for
1348   ebounce.efi, GraphicsConsole.efi, and TextMode.efi to this list. (These
1349   three had previously been blacklisted by hard-coding in ScanLoaderDir().)
1350
1351 - Added the directory from which rEFInd launched to dont_scan_dirs. This
1352   works around a bug in which rEFInd would show itself as a bogus Windows
1353   entry if it's installed as EFI/Microsoft/boot/bootmgfw.efi.
1354
1355 - Added support for launching MokManager.efi for managing the Machine Owner
1356   Keys (MOKs) maintained by the shim boot loader developed by Fedora and
1357   SUSE. This program is scanned and presented as a second-row tool.
1358
1359 - Added support for Apple's Recovery HD partition: If it's detected, a new
1360   icon appears on the second row. This icon can be removed by explicitly
1361   setting the "showtools" option in refind.conf and excluding the
1362   "apple_recovery" option from that line.
1363
1364 - Fixed bug that caused text-mode ("textonly" refind.conf option enabled)
1365   menu entries to be right-aligned rather than left-aligned when rEFInd was
1366   compiled with the TianoCore EDK2.
1367
1368 - Added "--usedefault {devicename}" and "--drivers" options to the
1369   install.sh script and changed the "esp" option to "--esp".
1370
1371 0.4.7 (11/6/2012):
1372 ------------------
1373
1374 - Added an icon for gummiboot.
1375
1376 - Added a boot option editor: Pressing the Insert or F2 key from a boot
1377   tag's options menu opens a simple text-mode line editor on which the boot
1378   options may be edited for a one-time boot with altered options.
1379
1380 - Modified the "scan_delay" feature to delay and then perform a re-scan,
1381   which may work better than the first attempt at this feature (which I'm
1382   told isn't working as planned).
1383
1384 - Modified rEFInd to add a space after the command-line options only when
1385   launching Mac OS X. On some early Macs, the extra space (which had been
1386   present by default, as a carryover from rEFIt) causes problems when
1387   booting Linux kernels from FAT partitions.
1388
1389 0.4.6 (10/6/2012):
1390 ------------------
1391
1392 - Fixed some minor memory management issues.
1393
1394 - Added new "scan_delay" feature to impose a delay before scanning
1395   for disks.
1396
1397 - Changed default "scanfor" option from internal-external-optical to either
1398   internal-external-optical-manual (for non-Macs) or
1399   internal-hdbios-external-biosexternal-optical-cd-manual (for Macs). I've
1400   done this for two reasons:
1401   - Many Mac users have been confused by the fact that rEFInd needs
1402     reconfiguration to detect Windows (or Linux installed in BIOS mode),
1403     since rEFIt scans BIOS devices by default. Adding the BIOS options as
1404     default for them should help them.
1405   - Adding the "manual" option enables users to simply add manual boot
1406     stanzas and have them work, which is more intuitive. Adding the
1407     "manual" option will have no effect unless manual stanzas are created
1408     or uncommented, so this part of the change won't affect users' working
1409     default configurations.
1410
1411 - Added new legacy (BIOS) boot support for UEFI-based PCs.
1412
1413 0.4.5 (8/12/2012):
1414 ------------------
1415
1416 - Fixed bug that caused a failure to boot BIOS-based OSes on Macs.
1417
1418 - Fixed bug in install.sh that caused it to fail to detect rEFItBlesser.
1419
1420 0.4.4 (6/23/2012):
1421 ------------------
1422
1423 - Fixed bug that caused filesystem labels to be corrupted by rEFInd on
1424   32-bit systems.
1425
1426 - Fixed bug that caused filesystem labels to be truncated in the drivers
1427   on 32-bit systems.
1428
1429 - Fixed bug in use_graphics_for option parsing that caused most options
1430   to set graphics mode for OS X and/or Linux but not other boot
1431   loaders/OSes.
1432
1433 - Tweaked install script to better isolate the ESP under OS X.
1434
1435 0.4.3 (6/21/2012):
1436 ------------------
1437
1438 - rEFInd now supports compilation using the TianoCore UDK2010/EDK2
1439   development kit in addition to GNU-EFI.
1440
1441 - Added new "use_graphics_for" option to control which OSes to boot in
1442   graphics mode. (This effect lasts for a fraction of a second on most
1443   systems, since the boot loader that rEFInd launches is likely to set
1444   graphics or text mode itself.)
1445
1446 - Graphics-mode booting now clears the screen to the current rEFInd
1447   background color (rather than black) and does NOT display boot messages.
1448   The intent is for a smoother transition when booting OS X, or perhaps
1449   other OSes that don't display boot loader messages. In practice, this
1450   effect will be tiny for many OSes, since the boot loader generally clears
1451   the screen within a fraction of a second of being launched; but the
1452   "flicker" of a rEFInd message in that time can sometimes be distracting.
1453
1454 - Filesystem drivers now work on EFI 1.x systems, such as Macs.
1455
1456 - Removed "linux.conf" as a valid alternative name for "refind_linux.conf"
1457   for holding Linux kernel options. The kernel developers plan to use
1458   "linux.conf" themselves.
1459
1460 0.4.2 (6/3/2012):
1461 -----------------
1462
1463 - Added a message to install.sh when run on Macs to remind users to update
1464   the "scanfor" line in refind.conf if they need to boot BIOS-based OSes
1465   via rEFInd.
1466
1467 - Modified install.sh script to be smarter about running efibootmgr on
1468   Linux. It now uses the whole path to the rEFInd binary as a key to
1469   determine whether an existing entry exists, rather than just the filename
1470   portion. If an entry exists and is the first entry in the boot order, the
1471   script does nothing to the NVRAM entries. If such an entry exists but is
1472   not the default, the script deletes that entry and creates a new one
1473   (implicitly making it the first in the boot order). If such an entry does
1474   not exist, the script creates a new one (again, making it the first in
1475   the boot order).
1476
1477 - Added "dont_scan_dirs" configuration file option, which adds directories
1478   to a "blacklist" of directories that are NOT scanned for boot loaders.
1479
1480 0.4.1 (5/25/2012):
1481 ------------------
1482
1483 - Added "scanning for new boot loaders" message to the re-scan function
1484   (hitting Esc at the main menu). It usually flashes up too quickly to
1485   be of importance, but if the scan function takes a while because of
1486   access to a CD that must be spun up, it should make it clear that the
1487   system hasn't hung.
1488
1489 - Modified install.sh script to detect rEFItBlesser on Macs, and if
1490   present, to ask the user if it should be removed.
1491
1492 - Cleaned up the Make.common file for the filesystem drivers.
1493
1494 - Changed HFS+ driver to return volume label of "HFS+ volume" rather than
1495   an empty label. (The driver doesn't currently read the real volume
1496   label.)
1497
1498 - Fixed bug that could cause rEFInd to appear in its own menu after
1499   running a shell and then re-scanning for boot loaders.
1500
1501 0.4.0 (5/20/2012):
1502 ------------------
1503
1504 - Inclusion of drivers for ISO-9660, HFS+, ReiserFS, and ext2fs. Most of
1505   these drivers originated with rEFIt, although the HFS+ driver seems to
1506   have come from Oracle's VirtualBox, with some files from Apple. I hadn't
1507   included these drivers previously because the build process proved
1508   challenging. As it is, they don't work on my Mac Mini, I suspect because
1509   the build process with the UDK2010 development kit may not work with the
1510   EFI 1.x that Apple uses.
1511
1512 - Addition of support for drivers in the "drivers_{arch}" subdirectory of
1513   the main rEFInd binary directory (e.g., "drivers_x64" or "drivers_ia32").
1514   Drivers may continue to be placed in the "drivers" subdirectory.
1515
1516 - Added new feature to eject CDs (and other removable media): Press F12 to
1517   eject all such media. This function works only on some Macs, though (it
1518   relies on an Apple-specific EFI extension, and this extension isn't even
1519   implemented on all Macs, much less on UEFI-based PCs).
1520
1521 - Fixed a problem that could cause GRUB 2 to fail to read its configuration
1522   file when launched from rEFInd.
1523
1524 0.3.5 (5/15/2012):
1525 ------------------
1526
1527 - Removed the GRUB 2 detection "reciped" added with 0.3.2, since I've
1528   received reports that it's not working as intended.
1529
1530 - Added re-scan feature: Press the Esc key to have rEFInd re-read its
1531   configuration file, tell the EFI to scan for new filesystems, and re-scan
1532   those filesystems for boot loaders. The main purpose is to enable
1533   scanning a new removable medium that you insert after launching rEFInd;
1534   however, it can also be used to immediately implement changes to the
1535   configuration file or new drivers you load from an EFI shell.
1536
1537 - Fixed a bug that could cause the scroll-right arrow to be replaced by the
1538   scroll-left arrow under some circumstances.
1539
1540 0.3.4 (5/9/2012):
1541 -----------------
1542
1543 - Added new configuration file option: "icons_dir", which sets the name
1544   of the subdirectory in which icons are found. See the documentation or
1545   sample configuration file for a full description.
1546
1547 - Modified Makefile to generate rEFInd binary that includes architecture
1548   code -- refind_ia32.efi or refind_x64.efi, rather than the generic
1549   refind.efi. This is done mainly to help the install.sh script. The
1550   program can be named anything you like on the disk. (The generic name
1551   refind.efi is used on unknown architectures.)
1552
1553 - Improved install.sh script: Fixed bug on OS X 10.7 and enable it to be
1554   used after building from source code (or via new "make install" Makefile
1555   target).
1556
1557 - Improved screen redraws to produce less flicker when moving among the
1558   second-row tags or to the last tag on the first row.
1559
1560 0.3.3 (5/6/2012):
1561 -----------------
1562
1563 - Improved menu navigation:
1564   - In graphics mode, left & right arrow keys move left & right, while up &
1565     down arrows move between rows.
1566   - Page Up and Page Down now move through chunks of visible tags (in both
1567     text & graphics modes), jumping from one row to another only when at
1568     the edge of the row. In text mode, the "rows" are broken down as in
1569     graphics mode, but they aren't visibly distinguished on the screen.
1570
1571 - Improved text-mode use: rEFInd now displays the proper number of entries
1572   when first started in text mode and scrolling is done sensibly when too
1573   many entries exist to fit on the screen.
1574
1575 0.3.2 (5/4/2012):
1576 -----------------
1577
1578 - Added the install.sh script to install rEFInd on Linux and Mac OS X
1579   systems. This script must be run as root (or via sudo). It requires
1580   no options, but on Mac OS X, passing it the "esp" option causes it
1581   to install rEFInd on the computer's ESP rather than the default of the
1582   currently OS X boot partition. (Under Linux, the default is to install to
1583   the ESP.) Note that there may be some unusual cases in which this script
1584   will fail to work.
1585
1586 - Does a better job of clearing the screen when launching OSes in text
1587   mode.
1588
1589 - Added detection "recipe" for GRUB 2's BIOS Boot Partition.
1590
1591 - Fixed bogus detection of ESPs created by Linux's mkdosfs utility or
1592   Windows as  bootable partitions when "scanfor" includes BIOS scanning
1593   options.
1594
1595
1596 0.3.1 (4/27/2012):
1597 ------------------
1598
1599 - Fixed bug that caused spurious "Unsupported while scanning the root
1600   directory" messages under some conitions on Macs.
1601
1602 - Modified loader scanning code to sort boot loader entries within a
1603   directory by modification time, so that the most recently-modified loader
1604   is first among those in a given directory. Thus, if you specify a
1605   directory name (or volume name, for loaders stored in the root directory
1606   of a volume) as the default_selection, the most recent of those loaders
1607   will be the default. This is intended to help with Linux kernel
1608   maintenance when using the EFI stub loader; set up this way, the most
1609   recent kernel copied to your kernel directory will be the default,
1610   obviating the need to adjust the refind.conf file when adding a new
1611   kernel. If you want to change the default among those in the default
1612   directory, you can use "touch" to adjust the modification timestamp.
1613
1614 - Tweaked code to find loader-specific .icns file so that it finds files
1615   for Linux kernels without .efi extensions. In this case, files should be
1616   named the same as the kernels they match, but with .icns extensions. For
1617   instance, bzImage-3.3.2 should have an icon called bzImage-3.3.2.icns.
1618   (The old code would have looked for an icon called bzImage-3.3.icns.)
1619
1620 - Eliminated bogus OS loader tags for filenames that end in ".icns" when
1621   the scan_all_linux_kernels option is set.
1622
1623 0.3.0 (4/22/2012):
1624 ------------------
1625
1626 - I'm officially upgrading this project's status from "alpha" to "beta" and
1627   giving it a bump from 0.2.x to 0.3.0. This doesn't reflect any major
1628   milestone with this version; rather, it reflects my sense that rEFInd has
1629   been "out there" for a while, and although I've gotten bug reports,
1630   they've been minor and/or have been fixed. The program still has known
1631   bugs, but my impression is that it is, overall, usable by ordinary users.
1632
1633 - Added "resolution" option to refind.conf, which enables setting the video
1634   resolution. To use it, pass two numeric values, as in "resolution 1024
1635   768" to use a 1024x768 video mode. Note that not all modes are supported.
1636   If you specify a non-supported video mode on a UEFI system, a message
1637   appears listing the supported video modes and you must then press a key
1638   to continue, using the default video mode (usually 800x600).
1639   Unfortunately, I don't know the calls to get a list of supported video
1640   modes on older EFI 1.x systems (including Macs), so on Macs setting an
1641   incorrect video mode silently fails (you keep using the default mode).
1642   This makes changing your video mode a hit-or-miss proposition on Macs.
1643   CAUTION: It's possible to set a legal video mode that your monitor can't
1644   handle, in which case you'll get a blank display until you boot an OS
1645   that resets the video mode.
1646
1647 - Fixed (maybe) a bug that caused rEFInd to crash when returning from an
1648   EFI shell or other programs on Macs, particularly when rEFInd used
1649   graphical mode. I'm not 100% sure this bug is squashed because I still
1650   don't understand the cause and I only have one Mac for testing. See
1651   comments in the ReinitRefitLib() function in refit/lib.c for more
1652   details.
1653
1654 - Added new refind.conf option: scan_all_linux_kernels, which causes Linux
1655   kernels that lack ".efi" extensions to be included in scans for EFI boot
1656   loaders. This may help integration with Linux distributions that don't
1657   give their kernels such names by default. Beware, though: It can detect
1658   unwanted files, such as older non-stub-loader kernels or .icns files used
1659   to give kernels with .efi extensions custom icons.
1660
1661 - Improved EFI boot loader detection on boards with Gigabyte's Hybrid EFI,
1662   and perhaps other EFIs with a buggy StriCmp() function. Files with both
1663   ".efi" and ".EFI" extensions should now be detected as boot loaders.
1664
1665 - Fixed a bug that caused rEFInd to fail to scan for drivers if the
1666   filesystem driver didn't set a volume name (that is, if the relevant
1667   field was set to NULL rather than even an empty string). In such
1668   situations, rEFInd now reports the volume name as "Unknown".
1669
1670 0.2.7 (4/19/2012):
1671 ------------------
1672
1673 - After much trial and tribulation, I've overcome a GNU-EFI limitation and
1674   enabled rEFInd to load EFI drivers. This feature was present in the
1675   original build of rEFIt but was removed in the versions that could
1676   compile under Linux, but now it's back -- and still being compiled under
1677   Linux! To use it, you should place your drivers in a convenient directory
1678   on the ESP (or whatever partition you use to launch rEFInd) and add a
1679   "scan_driver_dirs" entry to refind.conf to tell rEFInd where to look. (As
1680   always, you should specify the driver directory relative to the root of
1681   the filesystem.) Note that you can't launch drivers from another
1682   filesystem; they must be on the same volume that holds rEFInd. Those who
1683   compile from source code should note that implementing this feature
1684   necessitated using a more recent version of the GNU-EFI library. I'm
1685   currently using version 3.0p, and version 3.0i does NOT work. I don't
1686   know where the change occurred, but you may need to upgrade your GNU-EFI
1687   installation.
1688
1689 - Fixed bug that caused rEFInd to show up in its own menu sometimes.
1690
1691 - Added new refind.conf token: also_scan_dirs. When scanning volumes for
1692   EFI boot loaders, rEFInd always scans the root directory and every
1693   subdirectory of the /EFI directory, but it doesn't recurse into these
1694   directories. The also_scan_dirs token adds more directories to the scan
1695   list. It defaults to "elilo,boot", but you can set it to any directory or
1696   directories you like.
1697
1698 0.2.6 (4/14/2012):
1699 ------------------
1700
1701 - Added "volume" keyword to configuration file's stanza options. This
1702   option changes the volume from which subsequent files (specified by
1703   "loader" and "icon") are loaded. You pass "volume" the name/label of the
1704   FILESYSTEM you want to use (not the GPT partition name), or a number
1705   followed by a colon (e.g., "1:"). The former should reliably identify a
1706   filesystem, assuming the name is unique. The latter assigns numbers based
1707   on the order in which they're scanned, which may not be as reliable but
1708   should work when a volume is unnamed.
1709
1710 - Fixed bug in 0.2.5 that caused failure of Linux initial RAM disk
1711   mapping on some (but not all) systems. Affected computers include at
1712   least some Intel motherboards, maybe others.
1713
1714 0.2.5 (4/9/2012):
1715 -----------------
1716
1717 - Fixed bug that caused an inability to associate initial RAM disks with
1718   Linux kernels stored in a volume's root directory.
1719
1720 - Volume badges (that override default badges) are now stored in
1721   .VolumeBadge.icns. Although undocumented, rEFInd formerly loaded custom
1722   volume badges from .VolumeIcon.icns. This carryover from rEFIt was a
1723   confusing name, given the next (new) feature, so I've changed and
1724   documented the name....
1725
1726 - Added ability to set a default icon for a loader stored in the root
1727   directory of a volume: The icon is stored in .VolumeIcon.icns. This icon
1728   is also used for Mac OS X volumes booted from the standard location.
1729
1730 - Fixed bug that caused icons to drop back to generic icons when rEFInd
1731   was launched in certain ways (such as from an EFI shell in rEFInd's
1732   directory) on certain systems.
1733
1734 - Fixed bug that caused "unknown disable flag" to be shown (very briefly)
1735   instead of "unknown hideui flag" when an improper hideui flag was set.
1736
1737 0.2.4 (4/5/2012):
1738 -----------------
1739
1740 - Created new refind.conf entry: "showtools". This entry takes options of
1741   "shell", "gptsync", "about", "exit", "reboot", and "shutdown". This
1742   option is in some respects an affirmative version of portions of the old
1743   "disable" and "hideui" options; however, it enables users to specify the
1744   order in which these options appear on the screen. Also, the "exit"
1745   option is new; it terminates the program. The effect is usually to return
1746   to whatever tool launched it or to launch a default OS; however, this is
1747   somewhat unpredictable. The default therefore omits the "exit" option, as
1748   well as "gptsync", which has always been dangerous (but necessary on most
1749   MacOS/Windows dual-boot setups on Macs). As part of this reconfiguration,
1750   I've eliminated the "rescue Linux" option, which always seemed pointless
1751   to me.
1752
1753 - Folded "disable" and "hideui" refind.conf entries into one ("disable"),
1754   and reduced the number of options to six: "banner", "label",
1755   "singleuser", "hwtest", "arrows", and "all". ("arrows" is new and
1756   disables the scroll arrows when a system has too many tags to display
1757   simultaneously.)
1758
1759 - Added max_tags option to the refind.conf file, enabling users to reduce
1760   the maximum number of OS loader tags that can be displayed at once.
1761
1762 - Updated rEFIt icon, based on the 128x128 volume label from the rEFIt CD
1763   image.
1764
1765 - Added x86 and x86-64 EFI shells to the CD image version of the binary,
1766   but NOT to the binary zip file. The logic is that the CD image is more
1767   likely to be used directly as an emergency disc and so may need this
1768   feature, even though the source isn't part of the rEFInd project. (The
1769   source is readily available from the TianoCore project.)
1770
1771 - EFI shells may now be stored at /shellx64.efi for x86-64 systems or at
1772   /shellia32.efi for x86 systems. The /EFI/tools/shell.efi name is also
1773   recognized; however, if both files are present, two EFI shell icons will
1774   appear on the main menu. The /efi/{refind-path/apps/shell.efi filename,
1775   which was never officially documented but worked as a carryover from
1776   rEFIt, is no longer valid.
1777
1778 0.2.3 (3/26/2012):
1779 ------------------
1780
1781 - Fixed (maybe) a bug that caused hangs when launching a second program
1782   after returning from a first. There are some weird system-to-system
1783   differences, though, and this fix causes (apparently harmless) error
1784   messages about "(re)opening our installation volume" on at least one
1785   system (a 32-bit Mac Mini). I'm committing this change because, imperfect
1786   though it is, it's preferable to the earlier version, at least on my
1787   small sample of computers.
1788
1789 - Because of news that the Linux kernel developers are planning to use the
1790   filename linux.conf to hold Linux kernel configuration data for EFI
1791   booting, I'm transitioning rEFInd away from that name and to
1792   refind_linux.conf to avoid a conflict. This version can use either name,
1793   with refind_linux.conf taking precedence if both are present.
1794
1795 - Added logo for Arch Linux.
1796
1797 0.2.2 (3/23/2012):
1798 ------------------
1799
1800 - Fixed bug that caused program failure when Linux kernels with EFI stub
1801   support were detected with no associated version numbers. rEFInd now
1802   permits automatic linking of *ONE* versionless kernel to *ONE*
1803   versionless initrd file.
1804
1805 - Fixed bug that caused program hangs when a boot loader filename or label
1806   was too long. Such names are now properly truncated and program execution
1807   continues.
1808
1809 - Fixed bug that caused no text to appear in submenus on UEFI systems with
1810   small screens (800x600). NOTE: Problem still occurs on screens smaller
1811   than this, but such systems are very rare.
1812
1813 0.2.1 (3/19/2012):
1814 ------------------
1815
1816 - Added ability to set a "default_selection" that's a title or a substring
1817   of one -- the name given to a stanza in a "menuentry" or the boot
1818   loader's filename, in most cases, although "Mac OS X", "Windows XP
1819   (XoM)", and "Microsoft EFI boot" are also titles.
1820
1821 - Added support for semi-automatic scans of Linux kernels with EFI stub
1822   loader support. The program auto-detects matching initial RAM disk files
1823   and loads additional options from the "linux.conf" file in the same
1824   directory as the kernel.
1825
1826 - Added support for "submenuentry" keyword and associated sub-stanza
1827   entries in refind.conf file.
1828
1829 - Renamed icons/os_mint.icns to icons/os_linuxmint.icns to match the
1830   filename Linux Mint ACTUALLY uses for its ESP boot loader directory.
1831
1832
1833 0.2.0 (3/14/2012):
1834 ------------------
1835
1836 - Initial public release