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

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


STEP #1 : Building Welcome2L
----------------------------
( Only required if you have the source distribution.
  If you got 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 real 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


ON SUSE 5.3 SYSTEM:
===================
[ From: Ronny Ziegler <ronny.ziegler@usa.net> ]

> 1)Put the following script called logo into /sbin/init.d
> 
> #! /bin/sh
> #
> # Author: Ronny Ziegler <ronny.ziegler@usa.net>, 1998
> #
> # /sbin/init.d/logo
> #
> 
> case "$1" in
>     start)
>         echo "Starting  logo"
>         /usr/local/bin/Welcome2L
>         /bin/sleep 1
>         ;;
>     stop)
>         ;;
>     reload|restart)
>         ;;
>     *)
>         echo "Usage: $0 {start|stop|reload|restart}"
>        exit 1
>  esac
>  exit 0
> 
>  2) cd /sbin/init.d/rc2.d
>  3) mv S99zzreached S98zzreached
>  4) ln -s ../logo S99logo
>    Now the logo will be executed as last before login-prompt
>  5) You don't need the old Login-Text any more:
>   mv /etc/issue /etc/issue.orig
>   touch /etc/issue
> 
>  That's it.


ON SUSE 6.0 SYSTEM:
===================
[ From: Ronny Ziegler <ronny.ziegler@usa.net> ]

>  You should have an error-free bootprocess before installing Welcome2L.
>
>   1) Add the following in your /sbin/init.d/rc file as
>      the line before last (thats the one with exit 0)
>          /usr/local/bin/Welcome2L
>      where this is the path to your Welcome2L-executeable
>
>   1b)Optional: If you dontt like Welcome2L to overwrite your
>      boot-messages, add
>          echo -e \\v\\v\\v\\v\\v\\v
>      (or some more \\v s) in you rc before starting Welcome2L.
>
>   2) Now you dont need the old Login-Text any more:
>      mv /etc/issue /etc/issue.orig
>      touch /etc/issue
>
>  Thats all. Now you can continue playing NetTrek. ;-)

 



OPTIONS:
========
-scrxx
 display the screen number xx

-msg"text of message" 
 show the msg given as the distribution info. 

-lcolxx 
 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 and binaries distribution or redhat package at :

	http://www.littleigloo.org

Author can be reached at : 

	jm@littleigloo.org	

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 : jm@littleigloo.org

In the mail remember to include:

* The version of Welcome2L you are using

* 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 <jm@littleigloo.org>, 
Copyright (c)1998-1999, Little Igloo Org http://www.LittleIgloo.org
---------------------------------------------------------------------
