
Author: Luis R. Rodriguez <mcgrof@ruslug.rutgers.edu>
 
Debian GRUB Splashimages
------------------------

1. How to have GRUB display an splashimage?

  Include a line like 

  splashimage=(hd0,0)/boot/grub/splashimages/debsplash.xpm.gz

  in /boot/grub/menu.lst (adjusted to your local needs, of course).

  Please do also read the splashimage documentation in
  /usr/share/doc/grub/README.Debian.gz .

  Another method is to create in grub directory (usualy /boot/grub/) file
  named splash.xpm.gz and run update-grub.

---

2. How to make one?

  For a HOWTO on how to create one visit:

  http://ruslug.rutgers.edu/~mcgrof/grub-images/

  Basic instructions:
  * xpm file format
  * 640x480
  * 14 colors only

  GRUB understands xpm files directly but since they can be big we compress
  them hence you'll usually see splashimages with file extensions of xpm.gz.

  Note: be careful, gzip'ing a file and then renaming won't work. You must
  gzip the original name. Why? .gz files contains the original name of the 
  file and grub relies on this.

---

3. How to submit one?

  If you'd like your splashimage in this package send them to mcgrof@ruslug.rutgers.edu

---

4. License?

 Include a License that will allow me to redistribute it that is compliant
 with the "Debian Free Software Guidelines" [1]. I like the GPL ;). 
 Fortuntely the xpm file format accept C99 comments, so you can just edit the 
 file with your favorite editor (vim, emacs) and add some text like the following: 

[1] http://www.debian.org/social_contract.html#guidelines

---

/* 
* Copyright 2004 Your Name <yourname@yourdomain.com>
* 
* This xpm file image 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 xpm file image 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.
*
* You should have received a copy of the GNU General
* Public License along with this image; if not, write to the Free
* Software Foundation, Inc., 59 Temple Place, Suite 330, Boston,
* MA  02111-1307  USA
*/
