X-Git-Url: https://code.delx.au/refind/blobdiff_plain/3ea2147587e27beae55294420d52e4a10b6331b2..107d80e5276d89f8b0763f6aa208e60d540ca06b:/refind.conf-sample

diff --git a/refind.conf-sample b/refind.conf-sample
index 8fca9fb..4c6fdd0 100644
--- a/refind.conf-sample
+++ b/refind.conf-sample
@@ -207,6 +207,15 @@ timeout 20
 #
 #scanfor internal,external,optical,manual
 
+# By default, rEFInd relies on the UEFI firmware to detect BIOS-mode boot
+# devices. This sometimes doesn't detect all the available devices, though.
+# For these cases, uefi_deep_legacy_scan results in a forced scan and
+# modification of NVRAM variables on each boot. Adding "0", "off", or
+# "false" resets to the default value. This token has no effect on Macs or
+# when no BIOS-mode options are set via scanfor.
+# Default is unset (or "uefi_deep_legacy_scan true")
+#uefi_deep_legacy_scan
+
 # Delay for the specified number of seconds before scanning disks.
 # This can help some users who find that some of their disks
 # (usually external or optical discs) aren't detected initially,
@@ -230,10 +239,13 @@ timeout 20
 #
 #also_scan_dirs boot,ESP2:EFI/linux/kernels
 
-# Partitions to omit from scans. You must specify a volume by its
-# label, which you can obtain in an EFI shell by typing "vol", from
-# Linux by typing "blkid /dev/{devicename}", or by examining the
-# disk's label in various OSes' file browsers.
+# Partitions (or whole disks, for legacy-mode boots) to omit from scans.
+# For EFI-mode scans, you must specify a volume by its label, which you
+# can obtain in an EFI shell by typing "vol", from Linux by typing
+# "blkid /dev/{devicename}", or by examining the disk's label in various
+# OSes' file browsers.
+# For legacy-mode scans, you can specify any subset of the boot loader
+# description shown when you highlight the option in rEFInd.
 # The default is "Recovery HD,LRS_ESP".
 #
 #dont_scan_volumes "Recovery HD"
@@ -304,10 +316,13 @@ scan_all_linux_kernels
 # default loader using:
 #  - A digit between 1 and 9, in which case the Nth loader in the menu
 #    will be the default. 
+#  - A "+" symbol at the start of the string, which refers to the most
+#    recently booted loader.
 #  - Any substring that corresponds to a portion of the loader's title
 #    (usually the OS's name or boot loader's path).
 # You may also specify multiple selectors by separating them with commas
-# and enclosing the list in quotes.
+# and enclosing the list in quotes. (The "+" option is only meaningful in
+# this context.)
 # If you follow the selector(s) with two times, in 24-hour format, the
 # default will apply only between those times. The times are in the
 # motherboard's time standard, whether that's UTC or local time, so if
@@ -317,10 +332,11 @@ scan_all_linux_kernels
 # case the last one to match takes precedence. Thus, you can set a main
 # option without a time followed by one or more that include times to
 # set different defaults for different times of day.
+# The default behavior is to boot the previously-booted OS.
 #
 #default_selection 1
 #default_selection Microsoft
-#default_selection "bzImage,vmlinuz"
+#default_selection "+,bzImage,vmlinuz"
 #default_selection Maintenance 23:30 2:00
 #default_selection "Maintenance,OS X" 1:00 2:30
 
@@ -380,7 +396,7 @@ scan_all_linux_kernels
 # specification. Also note that a leading slash is optional in file
 # specifications.
 menuentry Linux {
-	icon EFI/refind/icons/os_linux.icns
+	icon EFI/refind/icons/os_linux.png
 	volume KERNELS
 	loader bzImage-3.3.0-rc7
 	initrd initrd-3.3.0.img
@@ -392,7 +408,7 @@ menuentry Linux {
 # its GRUB 2 boot loader. Note uses of Linux-style forward slashes
 menuentry Ubuntu {
 	loader /EFI/ubuntu/grubx64.efi
-	icon /EFI/refined/icons/os_linux.icns
+	icon /EFI/refined/icons/os_linux.png
 	disabled
 }
 
@@ -417,7 +433,7 @@ menuentry "Windows 7" {
 # could initialize hardware and then launch an OS, or it could
 # do something entirely different.
 menuentry "Windows via shell script" {
-	icon \EFI\refind\icons\os_win.icns
+	icon \EFI\refind\icons\os_win.png
 	loader \EFI\tools\shell.efi
 	options "fs0:\EFI\tools\launch_windows.nsh"
 	disabled
@@ -430,7 +446,7 @@ menuentry "Windows via shell script" {
 # certainly need to change the "volume" line for this example
 # to work.
 menuentry "My Mac OS X" {
-	icon \EFI\refind\icons\os_mac.icns
+	icon \EFI\refind\icons\os_mac.png
 	volume "OS X boot"
 	loader \System\Library\CoreServices\boot.efi
 	disabled