WELCOME2L - Welcome to Linux, ANSI login logo for Linux
=======================================================

INSTALLATION
=============


STEP #1 : Building Welcome2L
----------------------------
( Only required if you have the source distribution.
  If you have the binary distribution you can jump to step #2)


To build Welcome2L:
`cd' to the directory containing the package's source code and type:
% make

This will start the compilation process. Note that gcc may report some
warnings. Don't worry about them. Only worry if gcc returns an error code.

At this step you can verify that a Welcome2L excutable have been created 
by typing :
% ls

You can even launch it by typing :
% ./Welcome2L

NOTE: running it in a xterm will not give you the really ANSI picture.


STEP #2 : Installing Welcome2L
------------------------------

type :
% make install
(This will copy Welcome2L to /usr/local/bin/Welcome2L)

or you can manually copy Welcome2L to /usr/local/bin
and chmod it 0755 :
% chmod 0755 Welcome2L


STEP #3 : running Welcome2L
---------------------------

ON REDHAT SYSTEM:
=================
The best place to run Welcome2L is IMHO in rc.local :
- cd to /etc/rc.d/
- edit rc.local
- near the end find these lines (may be not exactly the same) :
    echo "" > /etc/issue
    echo "Red Hat Linux $R" >> /etc/issue
    echo "Kernel $(uname -r) on $a $(uname -m)" >> /etc/issue
- comment them out
- add this one (change the version numbers to yours) :
    /usr/local/bin/Welcome2L -msg"Red Hat 5.0 (Hurricane)" -getty> /etc/issue
- to obtain something like that:
    #echo "" > /etc/issue
    #echo "Red Hat Linux $R" >> /etc/issue
    #echo "Kernel $(uname -r) on $a $(uname -m)" >> /etc/issue
    /usr/local/bin/Welcome2L -msg"Red Hat 5.0 (Hurricane)" -getty> /etc/issue


ON DEBIAN SYSTEM:
=================
[ From: Gerd Bavendiek <bav@rw.sni.de> ]

  > I put a script in
  > lulu:/etc/rc.boot> ls
  > 0setserial  1netenv     2hdparm  3Welcome2L
  >  
  >  It's contents is just
  >  
  > #!/bin/sh
  >  /usr/local/bin/Welcome2L -getty -msg"Debian GNU/Linux 2.0" > /etc/issue


ON SLACKWARE SYSTEM:
=======================
[ From: Joe X <obliteration@hotmail.com> ]
     
  > you install Welcome2L in slackware like this:
  >
  > add these lines in /etc/rc.d/rc.M
  > /usr/local/bin/Welcome2L > /etc/issue
  > /usr/local/bin/Welcome2L > /etc/issue.net



OPTIONS:
========
-msg"text of message" 
 will show the msg given as the distribution info. 

-lcolxx 
 will change the prompt color to the color number xx
 (i.e. -lcol14 will give you a yellow prompt)
 type -help to see what number are attributted to a color

-getty
 will display more accurate information when launched at boot time
 in an init script.	 


Contact
=======
You can get the last Welcome2L version (sources or binaries distribution) at :
Official little igloo web site : http://www.chez.com/littleigloo
mirror : http://www.altern.org/littleigloo

Author can be reached at : littleigloo@chez.com

Comments/suggestions/contribution/anything are welcome.


How to report bugs
==================

PLEASE check the BUGS file before reporting a bug.

To report a bug, send mail to : littleigloo@chez.com

In the mail remember to include:

* The version of Welcome2L

* Information about your system. For instance:

   - What operating system and version

  And anything else you think is relevant.

* How to reproduce the bug. 

---------------------------------------------------------------------
WELCOME2L - By Jean-Marc Jacquet <littleigloo@chez.com>, 
Copyright (c)1998, Little Igloo Org - http://www.chez.com/littleigloo
---------------------------------------------------------------------
