*******************************
 Filename:      README.config  
 Software:      Acrobat
 Locker:        acro (base)

 Last Updated: 5/15/13
               Alex Prengel

*******************************

VOLUMES IN LOCKER:

        sw.acro          top level       replicated

LINKS TO VOLUMES/LOCKERS:

       acro_v9.5.4  -> /afs/.../acro_v9.5.4            Version 9.5.4
       acro_v9.5.5  -> /afs/.../acro_v9.5.5            Version 9.5.5

CHANGES FOR ATHENA:

	A number of special symlinks are needed to allow cwis-dev to use the
        current plug-in libraries and acroread binaries. Essentially,
        /mit/acro/nsplugins must contain the current plug-in dynamic library
        (nppdf.so), and /mit/acro/current/bin must contain the current acroread
        vendor-supplied launch script. 

        To do this we make the following links:
        /mit/acro/nsplugins 
          -> arch/@sys/nsplugins

        /mit/acro/arch/@sys/nsplugins 
          -> /mit/acro/current/distrib/@sys/Adobe/Reader9/Browser/@sys
        
       in the directories /mit/acro/current/distrib/@sys/Adobe/Reader9/Browser,
        we need links from our @sys values to their equivalents (i.e.,
        i386_deb50 -> intellinux)

        finally, we have a link:

        /mit/acro/current/bin -> distrib/@sys/Adobe/Reader9/bin
 
To switch to a new version:

1. edit /mit/acro/current to point to the new version

2. edit the line, for acroread:

  $version = 

in file /mit/acro/arch/share/bin/wrapper to point to the new version.

        See also the version-specific README files.

NOTE 10/30/98: if local changes need to be made to acroread, these can't
               be made in the local shared acroread startup script in
               /mit/acro_v4.0/arch/share/bin; instead, they must be made
               to the Adobe startup scripts in 
               /mit/acro_v4.0/distrib/${ATHENA_SYS}/bin (which are
               different for each platform). This is due to complicated
               interdependencies with the Netscape locker which uses acroread
               as a plug-in and helper application.

NOTE 8/30/99: permissions on the base locker wrapper script must be set to
              755, otherwise error messages involving "unable to execute" 
              appear when trying to use acroread as a browser helper 
              application. It seems that standard UNIX permissions
              are involved in execution through the main wrapper script
              for reasons that are unclear.

NOTE 11/8/05: all cookie messages removed from base locker launch script as
this may cause problems with -toPostScript functionality.

PROGRAMS IN LOCKER:

        Acrobat (acroread)

STARTUP SCRIPT:

    DESCRIPTION 

        "wrapper" is a generic startup script for all versions. Links to it 
        must be installed into the platform-specific arch subdirectories. 
        It invokes secondary startup scripts or links in the version 
        specific lockers (like acro_v4.0).

    INSTALLATION 

        The vendor intends for different platform versions to be placed in 
        separate installation trees.