
******************************************************************************
   WARNING! WARNING! WARNING! WARNING! WARNING! WARNING! WARNING! WARNING !
******************************************************************************

THIS CODE IS ALPHA AND IT PLAYS WITH HARDWARE RESOURCEN AT VERY LOW LEVEL. A
LOT OF FUNCTIONALITY HAS TO BE IMPROVED AND TESTED, THEREFORE, USING IT COULD
BE SOMETIMES DANGEROUS FOR YOUR SYSTEM. USE IT ON YOUR OWN RISK !!!

******************************************************************************
   WARNING! WARNING! WARNING! WARNING! WARNING! WARNING! WARNING! WARNING !
******************************************************************************



Installing MLX environment:
============================

0)  The most easy way to compile and maintain this stuff is to have one simple
    directory, where you put mesa and mlx source trees. Set the $WORKDIR_3D
    environment variable to that directory:

	export WORKDIR_3D=/my-projects-dir/3d

1)  You need MLX source package. Untar it from within $WORKDIR_3D. The MLX
    root directory must be called 'mlx'. If not, rename it so or make a
    sumbolic link

2)  You need a Mesa-3.0 source tree. Untar it from within $WORKDIR_3D and make
    sure that the Mesa root is called 'mesa'. It's safe if you perform a
    'chmod -R +w mesa' because of default write permissions in mesa tree.
    Now, 'mesa' and 'mlx' should look like this (or similar):

    lrwxrwxrwx   1 sim      suse            9 Aug 32 17:38 mesa -> Mesa-3.0/
    lrwxrwxrwx   1 sim      suse            4 Sep 31 23:47 mlx->mlx.new

3)  You need the ACL Device Driver for Mesa-3.0, which could be usualy found in
    mlx/misc. Untar it from within $WORKDIR_3D.

4)  Switch to the mlx directory and run "make mlx-all"

5)  Go superuser mode. First, you have to edit a XF86Config

6)  IN XF86Config, OPTION 'no_accel' FOR YOUR CARD IS REQUIRED !!!

7)  The running virtual resolution should not be bigger than 800x600, if you
    have only 8MB VRAM and want to play with 3d !!!

8)  The modes 32bpp or 16bpp should work

9)  In mlx/misc there is an example of XF86Config. You can do what you want
    with it, but TAKE CARE WHEN YOU PLAY WITH MODELINES. WRONG XF86Config
    SETTINGS COULD DAMAGE YOUR MONITOR (ANYWAY) !!!

10) Make symbolic link /usr/local/mlx ---> $WORKDIR_3D/mlx. This is required
    because Mesa searches for aclapi.h in /usr/local/mlx/include/ directory.

11) Go to mlx/kernel and load kernel module with ./ldm

12) Superuser is not required anymore

13) Export LD_LIBRARY_PATH=$WORKDIR_3D/mesa/lib:$WORKDIR_3D/mlx/lib

14) Run "make linux-386-acl" in mesa root directory

15) (Re)Start X server. Be sure that it supports XDGA and XVIDMODE extensions
    Without XDGA you are going to mess up the working X screen, and without
    XVIDMODE, the best fitting resoulution cannot be set on the fly. But
    actualy, the stuff also works without XDGA and XVIDMODE extensions.

16) Read doc/aclmesa.txt before you start some Mesa/OpenGL client

