Annotation of Amaya/README, revision 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.

Webmaster