*******************************************************************************
****************                                            *******************
****************   This is AfterStep 1.5.0 (AfterStep'9x)   *******************
****************                                            *******************
*******************************************************************************


You can find translated versions of this README in doc/languages.

If there's no version corresponding to your language :
* please write it and send it to me !

If your README is too different from this one :
* please send me patches to update it.

0. Sum up 
----------

* Get AfterStep-SHARE and put afterstep/ in this directory

* Become root (su root)

* Now either run "./install.script"
	      or "./configure ; make ;
                  make install.all ; make install.man ;
		  mv ~/.xinitrc ~/xinitrc.old ;
		  echo afterstep > ~/.xinitrc ; startx"

* Then try AfterStep... I guess you'll love it.
If so, please vote for AfterStep at http://www.PLiG.org/xwinman/vote.html so
we will check if our work is worth something :-)

1. Do-It-Yourself Instructions :
--------------------------------

1-1. Execute the following commands to configure and compile AfterStep :

Run configure to guess system-dependant options :

        ./configure

If you can't become root, you will have to change systems-wide installation
paths to someplace from your PATH where you have perms to write.

Launch compilation then have a cup of coffee (drink slowly if your CPU is as
slow as mine :-] )

	make

Monitor the output of the above commands for possible error messages !

1-2. Become root to execute following commands : install binaries and man pages.

        su root -c "make install.all ; make install.man"

1-3. Put in ~/.xinitrc this single line : 'afterstep'

	echo afterstep > ~/.xinitrc

( If you couldn't be root, use 'echo /myhome/somewhere/afterstep >~/.xinitrc' )

If you prefer using a single configuration file instead of the logic
hierarchy, use :

	echo "afterstep -f ~/.steprc" > ~/.xinitrc

1-4. Test afterstep by typing :

	startx > ~/AF-debug  2>&1

1-5. Hints

If this doesn't give you fits, try the others look files included : click on :

	Start/Decorations/Looks/whatever you feel like trying

You can change feel (the way icon reacts ...) and backgrounds the same way :

For example, if you want only 2 title buttons, click on :

	Start/Decorations/Feels/feel.purenext
	Start/Quit/Restart this session

But if you want to use *different* look & feel files for *each* desktop, just
tell that to configure.

If you want a screen saver, get xautolock and xlock, then run :

<<
xautolock -time 5 -corners 00++ -locker "xlock -mode random -allowroot
-timeelapsed -echokeys " &
>>

1-6. Now, before asking any question:

Read 'doc/1.0_to_1.5' & run 'afterstepdoc'

2. Copyright, license, legal kludge :
-------------------------------------

2-1. Implicit copyrights

SINCE BERNE CONVENTION, COPYRIGHTS ARE IMPLICIT, EVEN IF AUTHORS DO NOT
WRITE "COPYRIGHT" WORD IN THE FILE THEY OWN INTELLECTUAL PROPERTY !

Therefore, every file is Copyright (C) by his (or its) respective(s) owner(s)
at the date of writing.

2-2. License

The whole program called AfterStep is distribued under GNU GPL v2 license.
AfterStep library is distributed under LGPL license.
AfterStep documentation is distributed under LDP license.

See doc/licenses/ files for more informations.

2-3. Exceptions

2-3-1. MIT/Evans & Sutherland copyright

Some files from src/, initially from twm, are covered by a different license :
add_window.c afterstep.c borders.c clientwin.c functions.c

2-3-2. Headers

Headers files are public domain ; Robert Nation stated in decorations.c :

<<

  Definitions of the hint structure and the constants are courtesy of
  mitnits@bgumail.bgu.ac.il (Roman Mitnitski ), who sent this note,
  after conferring with a friend at the OSF:

 >  Hi, Rob
 >
 >  I'm happy to announce, that you can use motif public
 >  headers in any way you can... I just got the letter from
 >  my friend, it says literally:
 >
 >>    Hi.
 >>
 >> Yes, you can use motif public header files, in particular because there is
 >> NO limitation on inclusion of this files in your programms....Also, no one
 >> can put copyright to the NUMBERS (I mean binary flags for decorations) or
 >> DATA STRUCTURES (I mean little structure used by motif to pass description
 >> of the decorations to the mwm). Call it another name, if you are THAT MUCH
 >> concerned.
 >>
 >> You can even use the little piece of code I've passed to you - we are
 >> talking about 10M distribution against two pages of code.
 >>
 >> Don't be silly.
 >>
 >> Best wishes.
 >> Eli

>>



3. Where can I find...
----------------------

3-1. More informations : www.afterstep.org

3-2. New versions : ftp.afterstep.org

3-3. Help : mail afterstep@eosys.com with subject: subscribe

3-4. Coders : mail afterstep-dev@eosys.com with subject: subscribe

3-5. Chat : #afterstep on EFNet
Access to EFNet can be done by connecting to irc.concentric.net



4. AfterStep maintainer :
-------------------------

Well, it's me :-)

Email me for feedback or bug reports.


                                            Guylhem AZNAR <guylhem@oeil.qc.ca>

