README for grubconf-0.5
 +-----------------------------------------------------------------+
 |                                                                 |
 |  Copyright (C) 2002-2003 Grubconf                               |
 |                     http://grubconf.sourceforge.net/            |
 |                                                                 |
 | This program is free software; you can redistribute it and/or   |
 | modify it under the terms of the GNU General Public License     |
 | as published by the Free Software Foundation; either version 2  |
 | of the License, or (at your option) any later version           |
 |                                                                 |
 | This program is distributed in the hope that it will be useful, |
 | but WITHOUT ANY WARRANTY; without even the implied warranty of  |
 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the   |
 | GNU General Public License for more details.                    |
 |                                                                 |
 | A copy of the GNU General Public License may be found in the    |
 | installation directory named "COPYING"                          |
 |                                                                 |
 | WARNING:                                                        |
 |                                                                 |
 | WE TAKE NO RESPONSIBILITY FOR LOST OR CORRUPTED GRUB            |
 | CONFIGURATION FILES, UN-BOOTABLE SYSTEMS, OR ANYTHING THAT MAY  |
 | BE CAUSED BY GRUBCONF. IF A PROBLEM OCCURS, PLEASE CONTACT US   |
 | SO WE CAN MAKE SURE GRUBCONF WILL NOT DO IT AGAIN.              |
 |                                                                 |
 | IT IS HIGHLY RECOMMENDED THAT THIS README IS READ COMPLETELY    |
 +-----------------------------------------------------------------+


ABOUT

	Grubconf is a Gnome2 based GRUB configuration editor. It provides 
	an easy to use interface allowing effortless modification of OS's 
	and the flexibility to configure the most obscure options. 
	Designed to require minimal user interaction while providing tools 
	for the most adventurous user. 

	Grubconf must be run as ROOT. This is to gain access to the
	grub configuration file.


RELEASE NOTES
	
	This release allows configuration and detection of splashimage
	support. It also expands the GRUB configuration support.
	
	If things are not working as you had hoped, dont just remove
	grubconf from your system and give up; let us know.
	
	This is a beta release for Grubconf. Because of this and the 
	complexities of obscure GRUB configurations there will be bugs and 
	incompatibilities. If you find a problem please check our forums:
			
		http://sourceforge.net/forum/forum.php?forum_id=54657

	and if the problem is not known, search the bug tracker and submit
	a new bug if needed:
	
		http://sourceforge.net/tracker/?group_id=17229&atid=117229
		
	
INSTALLATION
	
	For installation instructions consult INSTALL file
	
	For the impatient, all the standard configure and make options
	are used. To install with no extra options use this:
	
		./configure
		make
		make install

	There is also the option to configure in either splashimage or boot
	menu color selection. With no configure options the configure script 
	will autodetect splashimage support. If the configure script is
	unable to find your grub install the script will fail (it checks 
	/boot/grub/). To set your grub installation path use this configure 
	option:
		
		./configure --enable-splashimage=/path/to/grub
	
	To force splashimage support without autodetection use this configure 
	option:
	
		./configure --enable-splashimage
		
	To force configure to disable splashimage support and enable boot 
	menu color selection use this configure option:
	
		./configure --disable-splashimage
		
	
	There is no automatic uninstall.


	Redhat users have the option of using the program 'consolehelper' to
	have the OS prompt for root authentication via PAM.  To enable this:
	
	1. Make a file called 'grubconf' in the /etc/pam.d directory with 
	   these contents:
		
	 #%PAM-1.0
	 auth       sufficient   /lib/security/pam_rootok.so
	 auth       required     /lib/security/pam_stack.so service=system-auth
	 session    required     /lib/security/pam_permit.so
	 session    optional     /lib/security/pam_xauth.so
	 account    required     /lib/security/pam_permit.so
	
	2. Make a file called 'grubconf' in the /etc/security/console.apps/ 
	   directory with these contents:
	   
	   	USER=root
		PROGRAM=/usr/sbin/grubconf
		SESSION=true
		
	3. Now with the secuity configurations in place we need to relink the
           grubconf executable to reflect the changes. Do the following:
	   
	    ln -s /usr/bin/consolehelper /usr/bin/grubconf
	
        Now, running /usr/bin/grubconf via the command line or via a GNOME 
		panel launcher will first pop up a password query, and then execute 
		grubconf with root user privileges.

	Adapted from instructions by Ed Halley.
	For his example see: http://www.halley.cc/ed/linux/howto/eroaster.html

USAGE

	After installation, run this command AS ROOT
	
		grubconf
	
	For information on using grubconf, type this
	
		man grubconf
		
	or read the in-app help


KNOWN PROBLEMS

	* Grubconf only fully supports Linux and Windows OS types.
	  Other OSes will be considered type OTHER and can still be
	  configured with Grubconf, but not to the same degree as fully
	  supported OS's. If an OS was not added by grubconf it cannot 
	  classify the OS unless the title contains "linux" for a Linux 
	  OS or "win" for a Windows OS (this is done case-insensitive)

	* Under rare circumstances when attempting to access the manual
	  from the help button gnome-help will segmentation fault.
	  This is not a problem with grubconf, but with Yelp (the gnome-
	  help viewer) and/or Gnome libraries. The cause of this is not
	  yet completely known but appears when gnome is compiled with 
	  aggressive C flags and Yelp is executed as root. If you 
	  experience this please email countjoe@users.sourceforge.net 
	  with your version of Gnome, any compilation flags that have 
	  been used, and any extra system information you can provide 
	  (like distribution).

	* When using devfs in your kernel, you must be running devfsd for 
	  GrubConf to successfully detect partitions.
