Return to README CVS log

Up to [Public] / Amaya

Annotation of Amaya/README, revision 1.1.1.1

1.1       cvs         1: 
                      2:                        Amaya 0.9 Alpha Release
                      3: 
                      4: 
                      5: About this release
                      6: ==================
                      7: 
                      8: Amaya is intended to be a comprehensive environment for testing and
                      9: evaluating new proposals for Web standards and formats. The first version of
                     10: this testbed should be available by the end of 1996, but in order to allow
                     11: the Web community to evaluate this software and to send feedback to the
                     12: development team, an early release is provided now.
                     13: 
                     14: This should be considered as a snapshot of a work in progress. A large part
                     15: of the intended features of Amaya are implemented, but some of them are not
                     16: complete yet and the software is not supposed to be very robust. The user
                     17: interface may change and can be improved.
                     18: 
                     19: 
                     20: Feedback
                     21: --------
                     22: 
                     23: As the main objective of this early release is to get feedback from future
                     24: users, comments, questions, and bug reports are welcome.
                     25: 
                     26: For communicating with the Amaya team, please use the mailing list:
                     27: 
                     28: www-amaya@w3.org
                     29: 
                     30: For subscribing to the mailing list, send a message to:
                     31: 
                     32: www-amaya-request@w3.org
                     33: 
                     34: with a body containing the line:
                     35: 
                     36: subscribe www-amaya
                     37: 
                     38: A history is maintained at the following URL:
                     39: 
                     40: http://opera.inrialpes.fr/amaya/messages/
                     41: 
                     42: 
                     43: Copyright
                     44: ---------
                     45: 
                     46: Amaya is covered by the MIT and INRIA Copyright Statement. Please read the
                     47: file COPYRIGHT carefully before installing Amaya.
                     48: 
                     49: How to Install Amaya Binary Release
                     50: ===================================
                     51: 
                     52: Choose a place for Amaya
                     53: ------------------------
                     54: 
                     55: Supposing the binary distribution was loaded fine, one must choose a place
                     56: to install it. We suggest
                     57: 
                     58:    * /usr/local for a system wide installation
                     59:    * the user home directory for a personnal installation
                     60: 
                     61: Extract the distribution
                     62: ------------------------
                     63: 
                     64: Move the distribution to this directory, verify the rights on this directory
                     65: allows you to create a directory and extract the distribution.
                     66: 
                     67: On a Linux ELF platform one must invoke:
                     68: tar xvzf amaya-linux-elf.tar.gz
                     69: 
                     70: More generally if the distribution is a tar.gz file:
                     71: gunzip -c amaya-system.tar.gz | tar xvf -
                     72: 
                     73: If this is a tar.Z file:
                     74: uncompress -c amaya-system.tar.gz | tar xvf -
                     75: 
                     76: Whatever the method used, this should print around 40 lines of output and
                     77: create a new directory called Amaya populated with a few files and
                     78: directories. If not, your distribution file was probably corrupted during
                     79: the transfer, please get a new one. Read carefully the COPYRIGHT file.
                     80: 
                     81: 
                     82: Set up the environment and start Amaya
                     83: --------------------------------------
                     84: 
                     85: The file Amaya/bin/$platform/amaya is executable file Amaya, the
                     86: best thing is to add the path to the Amaya/bin/$platform directory to your PATH
                     87: environment variable:
                     88:  
                     89: On a Linux ELF platform 
                     90: for a csh or tcsh shell. When using sh, bash or another variant of the
                     91: Bourne shell
                     92: PATH=$PATH:/usr/local/Amaya/bin/LINUX-ELF ; export $PATH
                     93: 
                     94: Maybe this command should be added to the .login startup script. Once done
                     95: one can lauch amaya simply by typing "amaya" to the shell prompt. The Amaya
                     96: main window should open and display the first page of the Amaya
                     97: documentation.
                     98: 
                     99: 
                    100: If something goes wrong and advice
                    101: ----------------------------------
                    102: 
                    103: * If Amaya doesn't seems to work, ckeck the following:
                    104: 
                    105:    1. the DISPLAY variable is correctly set.
                    106:    2. The binary just installed is the correct one, i.e. it is the
                    107:       correct binaries for the current machine (don't try to start the
                    108:       Linux-ELF version on a Solaris machine or an old Linux a.out
                    109:       installation).
                    110:    3. If the binary version is ok, check the availability of the dynamic
                    111:       libraries needed by the executable file Amaya.
                    112: 
                    113:       For example on a Linux-ELF platform
                    114:       ldd Amaya/bin/LINUX-ELF/amayamain
                    115: 
                    116:       and check that there is no missing libraries.
                    117: 
                    118: * One can install packages for different platform under the same
                    119:  directory (for example on a server filesystem exported via NFS to an
                    120:  heterogenous set of machines).
                    121: 
                    122: * The Amaya mailing-list is archived:
                    123:       http://opera.inrialpes.fr/amaya/messages/
                    124: 
                    125:  Please have a look at it before sending mail if something goes wrong.
                    126:  Remember, it's an Alpha release.