Accessing the AFS Binary Distribution and Documentation

OpenAFS binary distributions are available for a limited number of platforms on the OpenAFS site, http://www.openafs.org. As of version 1.0.4, the documentation is not included in the binary packages, nor is it included in the source package. The original documentation is available online at IBM's Open Source web site at http://oss.software.ibm.com/developerworks/opensource/afs/docs/html/index.html. The documentation set includes the following documents:

• OpenAFS Release Notes (this document)

• OpenAFS Administration Guide (called AFS System Administrator's Guide in previous releases)

• OpenAFS Administration Reference (called AFS Command Reference Manual in previous releases)

• OpenAFS Quick Beginnings (called AFS Installation Guide in previous releases)

• OpenAFS User Guide (called AFS User's Guide in previous releases)

Documents are provided in the following formats:

• HTML, suitable for online viewing in a Web browser or other HTML viewer

• PDF, suitable for online viewing or for printing using the Acrobat Reader program from Adobe

• PS, suitable for online viewing or for printing using Ghostview / Ghostscript

• SGML, the source used to generate the HTML, PDF, and PS versions of the documentation

If you do not already have the Acrobat Reader program, you can download it for free at http://www.adobe.com/products/acrobat/readstep.html. Adobe provides only an English-language version of Acrobat Reader for UNIX platforms. The program can display PDF files written in any language. It is the program interface (menus, messages, and so on) that is available in English only. To make Reader's interface display properly in non-English language locales, use one of two methods to set the program's language environment to English:

• Set the LANG environment variable in the Reader initialization script. The advantage of this method is that it ensures proper behavior even when Reader is launched by other applications, such as a browser or an application's Help menu. Editing the script usually requires local superuser root privilege, however. If your Reader distribution includes the script, it is installed by convention as ${AcroRead_Dir}/bin/acroread, where ${AcroRead_Dir} is the installation directory for Reader files. Add the following line to the script, directly after the "#!/bin/sh" statement:

  LANG=C; export LANG

• Set the LANG environment variable to the value C in the command shell before starting the Reader program. The following is the appropriate command for some shells.

  % setenv LANG C

  Note that this setting affects all programs started in the command shell, with possibly undesirable results if they also use the LANG variable. The preceding method affects Reader only.