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