Skeletal instructions for using the contents of this tar file (for info 4.1 WJS. Aug 10) info 4.1 adds the REMOTE_TRADITIONAL info source. Those sites that have defined the JGOFS configuration parameter INFOSERVER will probably get better results by using REMOTE_TRADITIONAL instead of TRADITIONAL (see note, below; near bottom). If you would like to use this feature, you need to use at least build-env.pl v 1.3a, which configures for it. info 4.1 changes the names of some of the environment variables controlling logging. The old names are still accepted. If you wish to use the new logging environment variable names, and if your present build-env.pl file does NOT mention them, you will need an upgrade to build-env.pl, found as part of the build JGOFS utility. info 4.0b fixed a bug which cause info to fail in a web environment if info was invoked from a JGOFS page with an associated selection/projection string. info 4.0a removes leading and trailing blanks from info's control keywords info 4.0 is a re-write of info to increase robustness. Also, a design change was made to allow more precise control over which data info should present to the user. Please see the info.doc file in this release for details. info 4.0 requires a newly released JGOFS utility called perl_utils. info 4.0 requires the parse_path_info program found in the JGOFS path_info utility. It is possible but unlikely that this utility is already installed on your system. info 4.0 can be controlled by the same build-env.pl parameters (USEDATABASE or INFO_USEDATABASE) as the previous version of info. It also has a new set of controlling parameters. Old and new are described in info.doc. If you wish to make any modification to the defaults, and if your present build-env.pl file does NOT mention them, you will need an upgrade to build-env.pl, found as part of the build JGOFS utility. The latest versions of all 3 of the above utilities can be found on the same ftp site from which info was presumably downloaded. Indirectly related to info 4.0 is the fact that there is a bug in one of the library functions needed by an option of the parse_path_info program used by info. In particular, the library function path_info_routines must be at at least version 1.4a. path_info_routines is found in the libupd utility - check the ftp site for appropriate versions (more exact information not available at the time this is being written) The file jgofs_root/src/htmlbin/makefile.aaserv, if present, must be modified so that it does not try to create an older version of info. Replace the lines SCRIPTS = ${HTMLBINDIR}/dir \ ${HTMLBINDIR}/info with the line SCRIPTS = ${HTMLBINDIR}/dir This line should start in column 1, despite the way it is shown above. It is probably also advisable to remove or rename the old info source, jgofs_root/src/htmlbin/info_pl.tmp To install info 4.0 for the first time, determine which of the above utilties will be required (perl_utils, at least, will be needed). Each package has its own installation instructions (and the general build instructions has information about each package as well). The build package (if needed) should be installed before the path_info package (if needed). If the build package is installed, the safest thing to do is to rebuild the whole server. However, if you are sure that new and old build-env.pl files differ only by the parameters related to info, you might be able to get away without rebuilding. ===== Note regarding historical use of info on data servers with defined INFOSERVER JGOFS configuration parameter The JGOFS configuration parameter INFOSERVER caused many requests for info to go to a server on a system other than the data server, NOT the info program installed on the data server. If by chance a request was made to the info program installed on the data server, the response was typically a "no data" response. By default, info v 4 will act the same way. Using the REMOTE_TRADITIONAL parameter is an enhancement that allows requests made to the local info program to be referred to the appropriate remote server. ===== Files included in the info 4.1 tar file: info perl program info.doc documentation about info readme.info this file info_revision.doc comments from older versions of info