Bug#546351: grub-efi: Grub-efi lacks any documentation

[John Winters]

Package: grub-efi
Version: 1.96+20080724-16
Severity: important


The grub-efi package seems to be intended to allow Debian to be
booted on Intel-based Macs - e.g. a Mac mini.  However it lacks
any documentation about how you can do this.  There are references
to a general page on the EFI component of Grub2, but the package as
built does not match this page and the user is left scrabbling in
the dark.

Just a one page basic HOWTO would greatly improve the usefulness
of this package.  I'd offer to write it but I'm still struggling
to discover how the package can be used.

This package could potentially be extremely useful, given the
well known problems trying to boot Mac minis headless using
the legacy BIOS boot facility.

-- Package-specific info:

*********************** WARNING grub-setup left core.img in filesystem

*********************** BEGIN /proc/mounts
/dev/disk/by-uuid/9bfe8835-09d4-4640-a012-3b48575f3ab7 / ext3 rw,errors=remount-ro,data=ordered 0 0
/dev/mapper/lvmdata-home /home ext3 rw,errors=continue,data=ordered 0 0
/dev/mapper/lvmdata-usr /usr ext3 rw,errors=continue,data=ordered 0 0
*********************** END /proc/mounts

*********************** BEGIN /boot/grub/device.map
(hd0)	/dev/sda
*********************** END /boot/grub/device.map

*********************** BEGIN /boot/grub/grub.cfg
#
# DO NOT EDIT THIS FILE
#
# It is automatically generated by /usr/sbin/update-grub using templates
# from /etc/grub.d and settings from /etc/default/grub
#

### BEGIN /etc/grub.d/00_header ###
set default=0
set timeout=5
terminal console
### END /etc/grub.d/00_header ###

### BEGIN /etc/grub.d/05_debian_theme ###
set menu_color_normal=cyan/blue
set menu_color_highlight=white/blue
### END /etc/grub.d/05_debian_theme ###

### BEGIN /etc/grub.d/10_hurd ###
### END /etc/grub.d/10_hurd ###

### BEGIN /etc/grub.d/10_linux ###
menuentry "Debian GNU/Linux, linux 2.6.26-2-amd64" {
	set root=(hd0,3)
	search --fs-uuid --set 9bfe8835-09d4-4640-a012-3b48575f3ab7
	linux	/boot/vmlinuz-2.6.26-2-amd64 root=UUID=9bfe8835-09d4-4640-a012-3b48575f3ab7 ro  
	initrd	/boot/initrd.img-2.6.26-2-amd64
}
menuentry "Debian GNU/Linux, linux 2.6.26-2-amd64 (single-user mode)" {
	set root=(hd0,3)
	search --fs-uuid --set 9bfe8835-09d4-4640-a012-3b48575f3ab7
	linux	/boot/vmlinuz-2.6.26-2-amd64 root=UUID=9bfe8835-09d4-4640-a012-3b48575f3ab7 ro single 
	initrd	/boot/initrd.img-2.6.26-2-amd64
}
### END /etc/grub.d/10_linux ###

### BEGIN /etc/grub.d/30_os-prober ###
### END /etc/grub.d/30_os-prober ###

### BEGIN /etc/grub.d/40_custom ###
# This file is an example on how to add custom entries
### END /etc/grub.d/40_custom ###
*********************** END /boot/grub/grub.cfg

-- System Information:
Debian Release: 5.0.3
  APT prefers stable
  APT policy: (500, 'stable')
Architecture: amd64 (x86_64)

Kernel: Linux 2.6.26-2-amd64 (SMP w/2 CPU cores)
Locale: LANG=en_GB.UTF-8, LC_CTYPE=en_GB.UTF-8 (charmap=UTF-8)
Shell: /bin/sh linked to /bin/bash

Versions of packages grub-efi depends on:
ii  grub-common             1.96+20080724-16 GRand Unified Bootloader, version 
ii  libc6                   2.7-18           GNU C Library: Shared libraries

grub-efi recommends no packages.

Versions of packages grub-efi suggests:
pn  os-prober                     <none>     (no description available)

-- no debconf information