*******************************************************************************
*****************                                           *******************
*****************      This is AfterStep'9& (1.4.5.0 )      *******************
*****************                                           *******************
*******************************************************************************



0) Sum up ; procedure is :
--------------------------

vi Imakefile ; vi configure.h ; ./configure ; xmkmf ; make Makefiles ; make ;
su root -c "make install ; make install.man" ; echo afterstep > ~/.xinitrc ;
startx 



1) Do-It-Yourself Instructions :
--------------------------------

1-1) Edit files in this directory if needed :

	vi Imakefile
	vi configure.h

If you can't become root, you will have to change in configure.h :
"AFTER_BIN_DIR", "AFTER_MOD_DIR" and "AFTER_MAN_DIR" to "~/af" ; then copy
"./afterstep" hierarchy to "~/GNUstep/Library/AfterStep/" and edit base* to
replace each occurence of "/usr/X11R6/bin" by "~/af/" .

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

Run configure to guess system-dependant options :

        ./configure

Create Makefiles :

        xmkmf
	make Makefiles

Launch compilation then have a cup of coffee (drink slowly :-] )

	make

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

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

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

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

	echo afterstep > ~/.xinitrc

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

1-5) Test afterstep by typing :

	startx > ~/AF-debug  2>&1

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

	Start/Desktop/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/Desktop/Feels/feel.purenext
	Start/Quit/Restart this session

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

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

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

1-6) Now, before asking any question:

Read 'doc/NEW-IN-1.4' & 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 events.c functions.c menus.c
misc.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



4) AfterStep maintainer :
-------------------------

Well, it's me :-)

Email me for feedback or bug reports.


                                            Guylhem AZNAR <guylhem@oeil.qc.ca>

