home *** CD-ROM | disk | FTP | other *** search
/ Simtel MSDOS 1992 December / simtel1292_SIMTEL_1292_Walnut_Creek.iso / msdos / ada / ada_lrm4.arc / INSTALL.DOC next >
Text File  |  1989-04-07  |  16KB  |  428 lines
  1.                        Installation Instructions for
  2.                    Ada Language Reference Manual Reader
  3.                      Copyright 1989, Esther M. Lumsdon
  4.      
  5.                                       
  6.      
  7.      Source for 2 versions of the Ada Language Reference Manual Reader 
  8.      is included in the VAX/VMS distribution of this software, and 
  9.      source and executable for 1 version in the PC/AT distribution. One 
  10.      of the VAX/VMS versions (using package LRM_SMG) interfaces to the 
  11.      SMG$ routines in the VAX/VMS Run-Time Library and requires a 
  12.      VT-100 or higher terminal; the other (using package LRM_NON_SMG) 
  13.      will run on any ANSI terminal, including a paper console. The 
  14.      VAX/VMS executables were compiled under DEC VAX Ada version 1.5 
  15.      and VMS version 4.7. The PC/AT executable was compiled under 
  16.      Meridian AdaVantage version 2.1 and MS-DOS version 3.2. The SMG$ 
  17.      version draws borders on the screen, and eliminates the need for 
  18.      the user to strike the RETURN key when answering most prompts. The 
  19.      PC/AT version will run on any PC/AT with at least 1 720KB drive, 
  20.      but users will prefer to install it on a hard drive containing 
  21.      more than 1,600,000 bytes of unused disk storage.
  22.      
  23.      The data filenames are read from file or VMS logical LRMinit by 
  24.      the Ada LRM Reader program. A first step in installing the Ada LRM 
  25.      Reader for any computer is to fill a file named or a file pointed 
  26.      to by a VMS logical LRMinit with complete filenames and paths for 
  27.      the various data files used by the program.
  28.      
  29.      
  30.                                       
  31.    
  32.    
  33.    
  34.    -------------------------------------------------------------------
  35.    
  36.    
  37.    VAX/VMS Installation Instructions:
  38.    
  39.    Symbols Required:
  40.    
  41.    Define symbol(s) representing the command(s) that execute the Ada LRM
  42.    Reader. Add these commands to a .COM file that will be executed every
  43.    time a user of this software logs into your computer system, such
  44.    as the LOGIN.COM of each user, or SYS$MANAGER:SYSLOGIN.COM.
  45.    LRMPLUS == "$SYS$MANAGER:ADA_LRM_SMG.EXE"! Name and directory of executable
  46.                                             ! for Vt100-or-better-ONLY version.
  47.    LRM     == "$SYS$MANAGER:ADA_LRM.EXE"    ! Name and directory of executable
  48.                         ! for version that runs on
  49.                         ! any ANSI terminal.
  50.    
  51.    
  52.    
  53.    Logicals Required:
  54.    
  55.    These logicals must be defined before execution of Ada LRM.
  56.    
  57.    Add these commands to the LOGIN.COM file of each user of Ada LRM Reader
  58.    if you don't want Ada LRM Reader to be system-wide.
  59.    DEFINE ADA$LRM_TOOLS  "DUA0:[NEW_ADA.ADA.LRM_TOOLS]"
  60.                         ! Directory where those files sit.
  61.    DEFINE ADA$LRM        "DUA0:[NEW_ADA.ADA.ANSI_LRM]"
  62.                         ! Directory where those files sit.
  63.    DEFINE LRMINIT        "SYS$MANAGER:LRMINIT.
  64.                         ! File and path names required.
  65.    
  66.    Or...
  67.    
  68.    Add these commands to a .COM file that will be executed every time your
  69.    computer system is booted or rebooted, such as SYS$MANAGER:SYSTARTUP.COM,
  70.    if you want Ada LRM Reader to be system-wide. Requires System Manager.
  71.    
  72.    DEFINE/SYSTEM ADA$LRM_TOOLS  "DUA0:[NEW_ADA.ADA.LRM_TOOLS]"
  73.                         ! Directory where those files sit.
  74.    DEFINE/SYSTEM ADA$LRM        "DUA0:[NEW_ADA.ADA.ANSI_LRM]"
  75.                         ! Directory where those files sit.
  76.    DEFINE/SYSTEM LRMINIT        "SYS$MANAGER:LRMINIT.
  77.                         ! File and path names required.
  78.    
  79.    
  80.    
  81.    
  82.    Make the executable images Shareable (optional) :
  83.    
  84.    ADD SYS$MANAGER:ADA_LRM.EXE/OPEN/SHARE/HEADER_RESIDENT
  85.    ADD SYS$MANAGER:ADA_LRM_SMG.EXE/OPEN/SHARE/HEADER_RESIDENT
  86.    ! format for System-wide command to make these shareable
  87.    !  installed images. Requires System Manager. These commands
  88.    !  are to be used with the INSTALL utility.
  89.    
  90.    
  91.    Copy the indicated files into the directory pointed at by logical
  92.    ADA$LRM. Copy the indicated files into the directory pointed at by
  93.    logical ADA$LRM_TOOLS. Compile the indicated units (see explanation
  94.    near the end of this document). Copy the executables to the places
  95.    pointed at by symbols LRM and LRMPLUS. To run either version of the Ada
  96.    LRM Reader, type LRM or LRMPLUS.
  97.    
  98.    List of files to be placed into directory ADA$LRM (also available from
  99.    SIMTEL Ada Repository):
  100.    
  101.    A0READ.ME;1         AAREAD.ME;1         CHAP01.DOC;1        CHAP01.ERR;1
  102.    CHAP02.DOC;1        CHAP02.ERR;1        CHAP03.DOC;1        CHAP03.ERR;1
  103.    CHAP04.DOC;1        CHAP04.ERR;1        CHAP05.DOC;1        CHAP05.ERR;1
  104.    CHAP06.DOC;1        CHAP06.ERR;1        CHAP07.DOC;1        CHAP07.ERR;1
  105.    CHAP08.DOC;1        CHAP08.ERR;1        CHAP09.DOC;1        CHAP09.ERR;1
  106.    CHAP10.DOC;1        CHAP10.ERR;1        CHAP11.DOC;1        CHAP11.ERR;1
  107.    CHAP12.DOC;1        CHAP12.ERR;1        CHAP13.DOC;1        CHAP13.ERR;1
  108.    CHAP14.DOC;1        CHAP14.ERR;1        CHAPA.DOC;1         CHAPA.ERR;1
  109.    CHAPB.DOC;1         CHAPB.ERR;1         CHAPC.DOC;1         CHAPC.ERR;1
  110.    CHAPD.DOC;1         CHAPE.DOC;1         CHAPF.DOC;1         CHAPF.ERR;1
  111.    FOREWARD.D16;1      FOREWARD.DOC;1      FOREWARD.ERR;1      FTPFILES.SUB;1
  112.    INDEX.DOC;1         POSTSCRPT.D16;1     POSTSCRPT.DOC;1     POSTSCRPT.ERR;1
  113.    TOC.D16;1           TOC.DOC;1           
  114.    
  115.    
  116.    
  117.    List of files to be placed into directory ADA$LRM_TOOLS:
  118.    
  119.    LRCHAPAR.DAT;31     LRCREDIT.DAT;5                      LRMINIT.;5
  120.    LREXPLN.DAT;1       LRANNEX.MEN;1                       LRCHAPTR.MEN;1     
  121.    LRMAIN.MEN;3        LRWELCOM.MEN;1  
  122.    
  123.    
  124.      
  125.      You must create a file named LRMINIT.; It must contain all of the 
  126.      file and path names of the data files used by the Ada LRM Reader.
  127.      LRMINIT.; must contain the following, in order:
  128.      full filename for the chapter pointers file, LRCHAPAR.DAT
  129.      full filename for the credits file, LRCREDIT.DAT
  130.      full filename for the explanation file, LREXPLN.DAT
  131.      full pathname for the ANSI LRM files, ADA$LRM: in the author's     
  132.      installation
  133.      filename that text extracted from the large ANSI LRM files will     
  134.      be saved into, LRMSAVED.OUT
  135.      full filename for the main menu file, LRMAIN.MEN
  136.      full filename for the annex menu file, LRANNEX.MEN
  137.      full filename for the chapter menu file, LRCHAPTR.MEN
  138.      full filename for the welcome message, LRWELCOM.MEN
  139.      
  140.      
  141.      
  142.      
  143.      
  144.      -----------------------------------------------------------------
  145.      
  146.      
  147.      
  148.      
  149.      PC/AT Installation Instructions:
  150.      
  151.      
  152.      
  153.      You must have either a hard drive containing at least 1,600,000 
  154.      free bytes of disk storage, or at least 1 720KB diskette drive. If 
  155.      you have a hard drive, you should request the archived PC 
  156.      distribution, and enclose 3 formatted disks of 3.5" or 5.25"  
  157.      media. Otherwise, you should request the unarchived PC 
  158.      distribution, and enclose 3 formatted disks (3.5" or 5.25") of 
  159.      720KB or larger capacity.
  160.       
  161.      The distributed executable of Ada LRM Reader was compiled using an 
  162.      80286 processor. The distributed executable should run on an 8086 
  163.      or 8088 machine. If it doesn't run on yours, please contact the 
  164.      Ada Repository, or the contact person at Norfolk State University 
  165.      for help.
  166.      
  167.      After installation, to run the Ada Language Reference Manual 
  168.      Reader, just type LRM.
  169.      
  170.      The files LRM.EXE and LRMINIT must be in the same subdirectory, in 
  171.      order for the Ada LRM Reader to work. You must be in that 
  172.      subdirectory, or be running the Ada LRM Reader from a .BAT file.
  173.      
  174.      You must create a file named LRMINIT. It must contain all of the 
  175.      file and path names of the data files used by the Ada LRM Reader.
  176.      LRMINIT must contain the following, in order:
  177.      full filename for the chapter pointers file, LRCHAPAR.DAT
  178.      full filename for the credits file, LRCREDIT.DAT
  179.      full filename for the explanation file, LREXPLN.DAT
  180.      full pathname for the ANSI LRM files, C:\LRM_CODE\LRM\ in the    
  181.      author's installation
  182.      filename that text extracted from the large ANSI LRM files will        
  183.      be saved into, LRMSAVED.OUT
  184.      full filename for the main menu file, LRMAIN.MEN
  185.      full filename for the annex menu file, LRANNEX.MEN
  186.      full filename for the chapter menu file, LRCHAPTR.MEN
  187.      full filename for the welcome message, LRWELCOM.MEN
  188.      
  189.      
  190.       
  191.      Hard Drive Installation Instructions: 
  192.      Create a subdirectory to contain the Ada Language Reference Manual 
  193.      Reader; subdirectory C:\ADALRM will be used in these instructions, 
  194.      but you may choose your own name. De-archive the files LRM1.ARC 
  195.      and LRM2.ARC from the distribution diskettes into C:\ADALRM. If 
  196.      you want the source code, dearchive LRM_CODE.ARC. To execute Ada 
  197.      LRM Reader, just type LRM. You'll find it helpful to use a disk 
  198.      cache with Ada LRM Reader. There is an archiving/dearchiving 
  199.      utility and documentation on the third disk of the distribution 
  200.      media.
  201.      
  202.      If you don't have 2 floppy drives, copy LRM1.ARC and LRM2.ARC into 
  203.      C:\ADALRM. Set your default drive and default subdirectory to 
  204.      C:\ADALRM.
  205.      Type [drive:]PKUNPAK -x [drive:]LRM1
  206.      and then [drive:]PKUNPAK -x [drive:]LRM2
  207.      to dearchive the Ada LRM Reader. [drive:] is necessary in order to 
  208.      tell DOS which drives the de-archive utility and LRM Reader 
  209.      archives are in.
  210.      
  211.      
  212.      720KB Diskette Installation Instructions:
  213.      The unarchived distribution is ready-to-run. Ada LRM Reader is 
  214.      split into 2 working halves. To use it, put the disk that you need 
  215.      into your drive, and type LRM. The third disk of the distribution 
  216.      media contains the source code.
  217.      
  218.      
  219.      List of files to be placed into subdirectory C:\ADALRM (these 
  220.      files are also available from SIMTEL Ada Repository):
  221.      
  222.      CHAP01.DOC
  223.      CHAP02.DOC        CHAP03.DOC
  224.      CHAP04.DOC        CHAP05.DOC
  225.      CHAP06.DOC        CHAP07.DOC
  226.      CHAP08.DOC        CHAP09.DOC
  227.      CHAP10.DOC        CHAP11.DOC
  228.      CHAP12.DOC        CHAP13.DOC
  229.      CHAP14.DOC        CHAPA.DOC
  230.      CHAPB.DOC         CHAPC.DOC
  231.      CHAPD.DOC         CHAPE.DOC         
  232.      CHAPF.DOC
  233.      FOREWARD.DOC      
  234.      INDEX.DOC         POSTSCRPT.DOC
  235.      TOC.DOC           
  236.      
  237.      
  238.      
  239.      List of files to be placed into subdirectory C:\ADALRM (these 
  240.      files are only available as part of the Ada Language Reference 
  241.      Manual Reader package):
  242.      
  243.      LRCHAPAR.DAT               LRCREDIT.DAT      LREXPLN.DAT           
  244.      LRANNEX.MEN                LRCHAPTR.MEN      LRM.EXE
  245.      LRMAIN.MEN                 LRWELCOM.MEN
  246.      
  247.      
  248.      
  249.      -----------------------------------------------------------------
  250.      
  251.      
  252.      
  253.      
  254.      
  255.      How to Install Ada LRM Reader on other machines:
  256.      
  257.      
  258.      Underscores are used heavily in this source code. If your Ada 
  259.      compiler doesn't like underscores, you'll have to edit them all 
  260.      out.
  261.      
  262.      First, compile files lr1G.src and lr5BG.src; these should compile 
  263.      on any machine.
  264.      
  265.      Look at the files lr2SC.src, lr2SV.src, lr3BCA.src and lr3BVA.src. 
  266.      
  267.      Decide which lr2xx.src and lr3x-x.src versions are nearest to your 
  268.      machine's characteristics. How many characters can be displayed on 
  269.      a line before wrapping, how many lines can be displayed on a 
  270.      screen before scrolling, what control character sequence will 
  271.      clear the screen?  lr3BCA.src contains a procedure that will clear 
  272.      the screen on any ANSI terminal. lr3BVA.src contains a procedure 
  273.      that will clear the screen on any VMS DEC terminal.
  274.      Edit one lr2xx.src and one lr3x-x.src to suit your machine and 
  275.      compile them.
  276.      
  277.      lr4SC.src and lr4SV.src contain declarations for string variables 
  278.      that contain filenames. If they aren't long enough to hold the 
  279.      filenames on your system, lengthen them. Change the initial value 
  280.      of FILE_NAMES_DATA_FILE_NAME to the file name that you want file 
  281.      "LRMINIT" to have on your system.  Compile lr4xx.src.
  282.      
  283.      Compile lr6AVCS.src and lr7AVCB.src. These depend on lr2xx.src and
  284.      lr3x-x.src, but there really isn't anything machine-dependent in 
  285.      this package.
  286.      
  287.      Compile lr8VC.src. The only machine-dependent characteristic of 
  288.      this source file is the decision whether to instantiate the 
  289.      package contained in lr6AVCS.src and lr7AVCB.src, or that 
  290.      contained in lr7VT.src.
  291.      
  292.      Copy the data files as indicated in the instructions for PC/AT and
  293.      VAX/VMS.
  294.      
  295.      Fill in file "LRMINIT".
  296.      
  297.      Link and run unit LRM.
  298.      
  299.      
  300.      
  301.      
  302.      ------------------------------------------------------------------
  303.      
  304.      
  305.      
  306.      
  307.      List of Ada source files for Ada LRM Reader:
  308.      
  309.      FILENAME                   UNIT NAME
  310.      
  311.      COMMON:
  312.      
  313.      lr1G.src            LRM_TYPES spec., no body
  314.      lr5BG.src            LRM_GLOBAL body
  315.      
  316.      VAX/VMS with ANSI terminal and PC/AT:
  317.      
  318.      lr6AVCS.src        LRM_NON_SMG spec.
  319.      lr7AVCB.src        LRM_NON_SMG body
  320.      lr8VC.src                 LRM procedure (MAIN BODY) 
  321.      
  322.      VAX/VMS:
  323.      
  324.      lr2SV.src            MACHINE_SPECIFIC spec.
  325.      lr3BVA.src            MACHINE_SPECIFIC body
  326.      lr4SV.src            LRM_GLOBAL spec.
  327.      
  328.      PC/AT:
  329.      
  330.      lr2SC.src            MACHINE_SPECIFIC spec.
  331.      lr3BCA.src            MACHINE_SPECIFIC body
  332.      lr4SC.src            LRM_GLOBAL spec.
  333.      
  334.      VAX/VMS with VT100 or better terminal: 
  335.      
  336.      lr7VT.src            LRM_SMG spec. and body
  337.      lr8VT.src            LRM procedure (MAIN BODY)
  338.      lr9VT.src            SMG spec., no body
  339.      
  340.      
  341.      
  342.      Order of Compilation of Source Files:
  343.      
  344.      Executable is included for PC/AT. The PC/AT version was compiled 
  345.      under Meridian AdaVantage version 2.1 under MS-DOS 3.2 on a 80286 
  346.      CPU. If you need an 8088 version, contact Dr. Harrison at Norfolk 
  347.      State University to make arrangements.
  348.      
  349.      For use on a PC/AT:
  350.      lr1G.src
  351.      lr2SC.src
  352.      lr3BCA.src
  353.      lr4SC.src
  354.      lr5BG.src
  355.      lr6AVCS.src
  356.      lr7AVCB.src
  357.      lr8VC.src
  358.      
  359.      
  360.      For use on VAX/VMS with VT100 or better terminals:
  361.      lr1G.src
  362.      lr2SV.src
  363.      lr3BVA.src
  364.      lr4SV.src
  365.      lr5BG.src
  366.      lr9VT.src
  367.      lr7VT.src
  368.      lr8VT.src
  369.      
  370.      
  371.      For use on VAX/VMS without VT100 terminals:
  372.      
  373.      lr1G.src
  374.      lr2SV.src
  375.      lr3BVA.src
  376.      lr4SV.src
  377.      lr5BG.src
  378.      lr6AVCS.src
  379.      lr7AVCB.src
  380.      lr8VC.src
  381.      
  382.      
  383.      
  384.      
  385.      These source files reference data filenames:
  386.      
  387.      lr4SV.src
  388.      lr4SC.src
  389.      lr5BG.src
  390.      lr7AVCB.src
  391.      lr7VT.src
  392.      lr8VC.src
  393.      lr8VT.src
  394.      
  395.      
  396.      
  397.      
  398.      Sample LRMINIT file for VMS:
  399.      
  400.      ada$lrm_tools:lrchapar.dat
  401.      ada$lrm_tools:lrcredit.dat
  402.      ada$lrm_tools:lrexpln.dat
  403.      ada$lrm:
  404.      lrmsaved.out
  405.      ada$lrm_tools:lrmain.men
  406.      ada$lrm_tools:lrannex.men
  407.      ada$lrm_tools:lrchaptr.men
  408.      ada$lrm_tools:lrwelcom.men
  409.      
  410.      
  411.      
  412.      Sample LRMINIT file for PC/AT:
  413.      
  414.      c:\lrm_code\lrm\lrchapar.dat
  415.      c:\lrm_code\lrm\lrcredit.dat
  416.      c:\lrm_code\lrm\lrexpln.dat
  417.      c:\lrm_code\lrm\
  418.      lrmsaved.out
  419.      c:\lrm_code\lrm\lrmain.men
  420.      c:\lrm_code\lrm\lrannex.men
  421.      c:\lrm_code\lrm\lrchaptr.men
  422.      c:\lrm_code\lrm\lrwelcom.men
  423.      
  424.                                       
  425.      
  426.                                --  The End --
  427.      
  428.