
     DATE :  WEDNESDAY FEBRUARY 5, 2003

     FILE :  .../HELP_V1_INSTALL_APOLLO.TXT

     VERSION : 01

     AUTHOR  : STAN DUNAJSKI

     SUBJECT : INSTALLING ENHANCED AEGIS HELP COMMAND
     ===========================================================================

     NOTES
     -----
     1) Scope

        This document provides suggestions on installing the enhanced AEGIS
        help program on an Apollo workstation running SR10.x.

        This version 1 (v1) program was created by Pat Lynch in 1991/05/01
        and submitted to the ADUS/InterWorks library.


     2) Applicability

        The command has been tested successfully in AEGIS running Aegis
        shell, BSD4.3 running either CSH or KSH, and SYS5.3 running either
        CSH or KSH.

        The reason for using HELP in UNIX environments would be to access
        customized help file sources that use the AEGIS model.


     COMPILE SOURCE
     --------------
     If desired the default HELPPATH and HELPSIZE variables in help.c can
     be updated for the target site. This would then require recompiling
     help.c for M68K and A88K (PRISM) platforms.


     INSTALL ENHANCED HELP COMMAND FOR AEGIS
     ---------------------------------------
     1) Login as ROOT on target node.

        # /com/sh <cr>   Start AEGIS shell


     2) Install enhanced HELP binary.

        For M68K machines
        -----------------
        $ wd /com <cr>

        $ cpf help help.orig <cr>

        $ cpf <repository>/help.m68k  help  -r <cr>

        $ edacl help <cr>  set desired ACLs
          .
          .
          .

        $ acl help <cr>  Example
        Acl for help:
        Required entries
         root.%.%                         prwx-
         %.sys_admin.%                    prwx-
         %.%.none                         [ignored]
         %.%.%                            -r-xk
         Extended entry rights mask:      -----


        For A88K machines
        -----------------
        $ wd /com <cr>

        $ cpf help help.orig <cr>

        $ cpf <repository>/help.prism  help  -r <cr>

        $ edacl help <cr>  set desired ACLs
          .
          .
          .
        $ acl help <cr>  Example
        Acl for help:
        Required entries
         root.%.%                         prwx-
         %.sys_admin.%                    prwx-
         %.%.none                         [ignored]
         %.%.%                            -r-xk
         Extended entry rights mask:      -----


     3) Install enhanced HELP help file (M68K, A88K).

        $ wd /sys/help <cr>

        $ cpf help.hlp help.hlp.orig <cr>

        $ cpf <repository>/help.hlp -r <cr>

        $ edacl help <cr>  set desired ACLs
          .
          .
          .

        $ acl help.hlp <cr>
        Acl for help.hlp:
        Required entries
         root.%.%                         prw--
         %.sys_admin.%                    prw--
         %.%.none                         [ignored]
         %.%.%                            -r--k
         Extended entry rights mask:      -----


     INSTALL ENHANCED HELP COMMAND FOR BSD4.3
     ----------------------------------------
     BSD4.3 has an existing help command located in /usr/bin.

     /bsd4.3/usr/bin/help provides help on SCCS commands and messages.

     1) Login as ROOT on target node.

     2) Install enhanced HELP binary.

        For M68K machines
        -----------------
        # cd /bsd4.3/bin <cr>

        # cp <repository>/help.m68k help <cr>

        # chmod 755 help <cr>

        # ls -l help <cr>


        For A88K machines
        -----------------
        # cd /bsd4.3/bin <cr>

        # cp <repository>/help.prism help <cr>

        # chmod 755 help <cr>

        # ls -l help <cr>


     3) Install enhanced HELP help file (M68K, A88K).

        # cd /sys/help <cr>

        # cp help.hlp help.hlp.orig <cr>

        # cp <repository>/help.hlp help.hlp <cr>

        # chmod 644 help.hlp <cr>

        # ls -l help.hlp <cr>


     INSTALL ENHANCED HELP COMMAND FOR SYS5.3
     ----------------------------------------
     SYS5.3 has an existing help command located in /usr/bin.

     /sys5.3/usr/bin/help provides help on SCCS commands and messages.

     1) Login as ROOT on target node.

     2) Install enhanced HELP binary.

        For M68K machines
        -----------------
        # cd /sys5.3/bin <cr>

        # cp <repository>/help.m68k help <cr>

        # chmod 755 help <cr>

        # ls -l help <cr>


        For A88K machines
        -----------------
        # cd /sys5.3/bin <cr>

        # cp <repository>/help.prism help <cr>

        # chmod 755 help <cr>

        # ls -l help <cr>


     3) Install enhanced HELP help file (M68K, A88K).

        # cd /sys/help <cr>

        # cp help.hlp help.hlp.orig <cr>

        # cp <repository>/help.hlp help.hlp <cr>

        # chmod 644 help.hlp <cr>

        # ls -l help.hlp <cr>


     USER LOGIN FILE UPDATES
     -----------------------
     Each user should update their login files. The following examples
     were tested successfully.

     AEGIS
     -----
     Add the following to ~/user_data/sh/startup :

     setvar -type env HELPPATH "/sys/help:/systest/ssr_util:/usr/local/help:/usr/local/ce/help"
     setvar -type env HELPSIZE "0,0:575,725:80,80"


     CSH
     ---
     Add the following to ~/.cshrc :

     setenv HELPPATH /sys/help:/systest/ssr_util:/usr/local/help:/usr/local/ce/help
     setenv HELPSIZE "0,0:575,725:80,80"

     Ensure old aliases defining HELP are removed, uncommented, or redefined.


     KSH
     ---
     Add the following to ~/.profile :

     HELPPATH=/sys/help:/systest/ssr_util:/usr/local/help:/usr/local/ce/help
     export HELPPATH

     HELPSIZE="0,0:575,725:80,80"
     export HELPSIZE

     Ensure old aliases defining HELP are removed, uncommented, or redefined.



