Google
 

Trailing-Edge - PDP-10 Archives - AP-D480B-SB_1978 - ftn5a.rnf
There are no other files named ftn5a.rnf in the archive.
.LC
.COMMENT VARIABLE FTEN   GENERATES -10 LINES (DEFAULT)
.COMMENT VARIABLE FTTENX GENERATES -20 LINES
.VR FTEN 1 2
.VR FTTENX 2 1
.LM0;.RM70;.F;.J;.FLAG CAP;.SP1
.IF FTTENX
<FORTRAN-20 ^INSTALLATION ^GUIDE
.ELSE FTTENX
<FORTRAN-10 ^INSTALLATION ^GUIDE
.ENDIF FTTENX
.BR
^OCTOBER 1977
.FG30
^^COPYRIGHT (C) 1975,1977 BY
.BR
DIGITAL EQUIPMENT CORPORATION, MAYNARD, MASS.
.B 2
THIS SOFTWARE IS FURNISHED UNDER A LICENSE AND MAY BE USED AND COPIED
ONLY IN ACCORDANCE WITH THE TERMS OF SUCH LICENSE AND WITH THE INCLUSION
OF THE ABOVE COPYRIGHT NOTICE. THIS SOFTWARE OR ANY OTHER COPIES
THEREOF MAY NOT BE PROVIDED OR OTHERWISE MADE AVAILABLE TO ANY OTHER
PERSON. NO TITLE TO AND OWNERSHIP OF THE SOFTWARE IS HEREBY TRANSFERRED.
.B 1
THE INFORMATION IN THIS SOFTWARE IS SUBJECT TO CHANGE WITHOUT
NOTICE AND SHOULD NOT BE CONSTRUED AS A COMMITMENT BY DIGITAL
EQUIPMENT CORPORATION.
.B 1
DIGITAL ASSUMES NO RESPONSIBILITY FOR THE USE OR RELIABILITY OF ITS
SOFTWARE ON EQUIPMENT WHICH IS NOT SUPPLIED BY DIGITAL\\.
.IF FTTENX
.TI <FTN5A.FIG - ^FORTRAN-20
.ELSE FTTENX
.TI <FTN5A.FIG - ^FORTRAN-10
.ENDIF FTTENX
.PG
.IF FTTENX
<FORTRAN-20 ^INSTALLATION ^GUIDE
.ELSE FTTENX
<FORTRAN-10 ^INSTALLATION ^GUIDE
.ENDIF FTTENX
.BR
^OCTOBER 1977
.B 3
1.0##<SUMMARY
.B 1
^THIS DOCUMENT DESCRIBES THE PROCEDURES FOR INSTALLING VERSION 5^A(621) OF THE <FORTRAN COMPILER,
VERSION 5^A(721) OF <FOROTS (THE <FORTRAN OBJECT TIME SYSTEM) AND
<FORLIB (THE <FORTRAN LIBRARY) AND VERSION 5^A(101) OF <FORDDT (THE <FORTRAN
DEBUGGER).  ^THE PROCEDURES  DESCRIBED HEREIN ARE:
.B 1;.LM 9;.I -4
1.##^INSTALLATION OF THE <FORTRAN BINARY FILES
.BR
^BUILDING THE <FORTRAN COMPILER FROM SOURCES
.BR
^USING THE <FORTRAN COMPILER WITH <DDT
.IFNOT FTTENX
.BR
^BUILDING A SINGLE SEGMENT VERSION OF <FORTRAN
.ENDIF FTTENX
.B 1;.I -4
2.##^INSTALLATION OF THE <FOROTS AND <FORLIB BINARY FILES
.BR
^BUILDING <FOROTS AND <FORLIB FROM SOURCES
.B 1;.I -4
3.##^INSTALLATION OF <FORDDT
.B 1;.LM 0
<FORTRAN, <FORLIB, <FOROTS AND <FORDDT SHOULD BE INSTALLED ON <SYS:.
.B 1
^THE RELEASE IS IN THE FORM OF A
.IF FTTENX
<DUMPER
.ELSE FTTENX
<BACKUP
.ENDIF FTTENX
TAPE IN
.IF FTTENX
<TOPS-20 <DUMPER FORMAT.
.ELSE FTTENX
<INTERCHANGE FORMAT.
.ENDIF FTTENX
^THE FOLLOWING FILES (OR GROUPS OF FILES) ARE INCLUDED:
.B 1;.LM 9;.I -4
1.##<FORTRAN BINARY FILES
.B 1;.I -4
2.##<FORTRAN SOURCE AND OBJECT FILES 
.B 1;.I -4
.IF FTTENX
3.##<B20FTN.CTL - CONTROL FILE TO BUILD THE COMPILER FROM SOURCES
.ELSE FTTENX
3.##<B10FTN.CTL - CONTROL FILE TO BUILD THE COMPILER FROM SOURCES
.ENDIF FTTENX
.B 1;.I -4
4.##<*.CMD - LOADER AND ASSEMBLY INDIRECT COMMAND FILES
.B 1;.I -4
5.##<FORDDT.MAC AND <.REL
.B 1;.I -4
.IF FTTENX
6.##<FTN5A2.DIR - A DIRECTORY OF ALL FILES ON THE TAPE
.ELSE FTTENX
6.##<FTN5A1.DIR - A DIRECTORY OF ALL FILES ON THE TAPE
.ENDIF FTTENX
.B 1;.I -4
7.##<.DOC AND <.HLP FILES FOR ALL SOFTWARE
.B 1;.I -4
8.##<FOROTS AND <FORLIB SOURCE AND COMMAND FILES
.B 1;.I -4
.IF FTTENX
9.##<B20FRS.CTL - CONTROL FILE TO BUILD <FORLIB AND <FOROTS
.ELSE FTTENX
9.##<B10FRS.CTL - CONTROL FILE TO BUILD <FORLIB AND <FOROTS
FOR BOTH THE <KA10 AND <KI/KL10
.ENDIF FTTENX
FROM SOURCES
.B 1;.I -5
10.##<BLIS10.EXE VERSION 7^B(222) WHICH IS USED BY THIS
RELEASE OF <FORTRAN, <BLIS10.HLP AND <BLIS10.ERR (THE <BLIS10 ERROR MESSAGE FILE).
.B 1;.I -5
.IF FTTENX
11.##<B20FDT.CTL - CONTROL FILE TO BUILD <FORDDT FROM THE SOURCE
.ELSE FTTENX
11.##<B10FDT.CTL - CONTROL FILE TO BUILD <FORDDT FROM THE SOURCE
.ENDIF FTTENX
.LM 0
.PG
2.0##^^INSTALLATION AND BUILDING OF THE COMPILER\\
.B 2
2.1##^INSTALLATION OF THE <FORTRAN ^BINARY ^FILES
.B 1
^THE FOLLOWING FILES COMPRISE THE <FORTRAN COMPILER. ^MERELY
COPYING THESE FILES FROM THE DISTRIBUTION TAPE PROVIDES A
WORKING <FORTRAN COMPILER.
.IFNOT FTTENX
<FORTRAN WORKS ON A <KA10, <KI10 OR <KL10.
.ENDIF FTTENX
^THE FILES ARE:
.B 1;.LM 5;.NF;.NJ
.IF FTTENX
<FORTRA.HLP
<FORTRA.EXE
.ELSE FTTENX
<FORTRA.HLP
<FORTRA.EXE		<FORTRA.SHR
			<FORTRA.LOW
<FORTB.EXE		<FORTB.SHR
<FORTC.EXE		<FORTC.SHR
<FORTD.EXE		<FORTD.SHR
<FORTE.EXE		<FORTE.SHR
<FORTF.EXE		<FORTF.SHR
<FORTG.EXE		<FORTG.SHR
.ENDIF FTTENX
.B 2;.LM 0;.F;.J
2.2##^BUILDING THE <FORTRAN ^COMPILER ^FROM ^SOURCES
.B 1
^REQUIRED SOFTWARE
.B 1;.LM 5;.NF;.NJ
<BLIS10 7^B(222)
.IF FTTENX
<LINK 3(447) OR LATER
.ELSE FTTENX
<LINK 2^B(436) OR LATER
.ENDIF FTTENX
<MACRO 52
.IF FTTENX
<MAKLIB 2(20)
.ELSE FTTENX
<MAKLIB 2(14) OR LATER
.ENDIF FTTENX
<SCAN 7^B(572)
.IFNOT FTTENX
<WILD 7(311)
.ENDIF FTTENX
.B 1;.LM 0;.F;.J
^RUNNING THE CONTROL FILE
.IF FTTENX
<B20FTN.CTL
.ELSE FTTENX
<B10FTN.CTL
.ENDIF FTTENX
WILL BUILD THE COMPILER FROM
ITS SOURCES AND PRODUCE THE BINARY FILES.  ^IT HAS SUCCESSFULLY BUILT AND LOADED THE COMPILER
AT THE ^DIGITAL ^EQUIPMENT ^CORPORATION - ^MARLBORO COMPUTER FACILITIES.
^THIS, HOWEVER, IN NO WAY GUARANTEES ITS OPERATION OR SUPPORT.
.B 1
^THE CONTROL FILE USED TO BUILD THE COMPILER IN HOUSE USES
.IF FTTENX
PUBLIC STRUCTURE.
.ELSE FTTENX
A PRIVATE PACK CALLED <FTN.
.ENDIF FTTENX
^ALL REFERENCES TO <BLIS10 ARE ON "<BLS:" IN ORDER TO USE
VERSION 7^B(222) OF <BLIS10.  ^ALL REFERENCES TO <MACRO ARE
ON "<ASM:" IN ORDER TO USE <MACRO
52.  <BLIS10.EXE 7^B(222)
IS INCLUDED ON THE <FORTRAN RELEASE TAPE.
.IFNOT FTTENX
^ONE OTHER SET OF FILES REFERENCES [10,7] (<DEC:) AND [5,11] (<REL:) FOR
SEVERAL FILES.  ^THESE ARE THE <LINK <.CMD FILES WHICH USE
<WILD, <HELPER, AND <JOBDAT FROM [10,7] AND <SCAN FROM <REL:.
.ENDIF FTTENX
.B 1
^IT SHOULD BE NOTED THAT BUILDING THE <FORTRAN COMPILER FROM
THE SOURCES PROVIDED IS NOT A TRIVIAL COMPUTATIONAL TASK. ^IT
REQUIRES A CONSIDERABLE AMOUNT OF COMPUTER RESOURCES.
^ALL OF THE MODULES WILL COMPILE WITHIN
.IF FTTENX
140^P
.ELSE FTTENX
70^K
.ENDIF FTTENX
OF USER
CORE WITH THE EXCEPTION OF <LEXICA.BLI WHICH REQUIRES
.IF FTTENX
150^P.
.ELSE FTTENX
75^K.
.ENDIF FTTENX
^THE COMPLETE EXECUTION OF
.IF FTTENX
<B20FTN.CTL
.ELSE FTTENX
<B10FTN.CTL
.ENDIF FTTENX
REQUIRED AT LEAST 2 AND 1/2 HOURS ON A
.IF FTTENX
2040.
.ELSE FTTENX
<KA10.
.ENDIF FTTENX
^IT IS
ADVISED THAT ONLY INSTALLATIONS DESIRING TO MODIFY THE COMPILER
CONTEMPLATE COMPLETELY REBUILDING IT.
.IFNOT FTTENX
^IN ADDITION, IT SHOULD BE NOTED THAT
THE SUPPLIED CONTROL FILES ARE DIVIDED INTO CLEARLY COMMENTED
SECTIONS SO THAT IT CAN EASILY BE DETERMINED WHICH PHASES NEED TO BE
RELOADED IF MODIFICATIONS ARE MADE.  ^THEREFORE, INSTALLATIONS
INSERTING THEIR OWN MODIFICATIONS INTO THE COMPILER USUALLY NEED ONLY
RECOMPILE THE MODULES CHANGED AND RELOAD THE OVERLAYS AFFECTED
WITHOUT REBUILDING THE ENTIRE COMPILER.  ^SEE <MODULE.DOC FOR A LIST OF WHICH
MODULES ARE IN WHICH PHASES.
.ENDIF FTTENX
.B 1
(^NOTE: WHEN LOADING THE PROGRAMS <LEFT72, <LEFTFM AND <BUILD, UNDEFINED GLOBALS MAY BE
ENCOUNTERED. ^THESE SHOULD BE IGNORED.)
.IFNOT FTTENX
.B
^WHEN <LINK<ING THE <.REL FILES, IN ALL BUT <FORTRA, ONE CAN
EXPECT 4 UNDEFINED GLOBALS (<.TNEWL, <.POPJ1, <.SWDON
AND <.TCRLF.).  ^THESE ARE DUE TO THE PARTICULAR METHOD USED TO
LOAD THE COMPILER AND CAN BE IGNORED.  ^THEY OCCUR IN THE CODE WHICH
IS LOADED INTO THE <.LOW SEGMENT (TO LINE UP ALL DATA REFERENCES).
^SINCE THESE <.LOW SEGMENTS ARE UNUSED, THE UNDEFINED REFERENCES ARE MEANINGLESS.
.B
^THE SET OF CONTROL FILES CALLED <LIST?.CTL WILL PRODUCE A
COMPLETE SET OF SOURCE LISTINGS OF THE COMPILER.
.ENDIF FTTENX
.B 2
2.3##^USING THE <FORTRAN ^COMPILER WITH <DDT
.B 1
.IF FTTENX
^SYMBOLS ARE LOADED INTO <FORTRA.EXE SO THAT <DDT MAY BE USED WITH
THE <FORTRAN COMPILER WITHOUT ANY MODIFICATIONS.
.ELSE FTTENX
^THE RELEASE TAPE CONTAINS A VERSION OF THE SEGMENTED COMPILER LOADED
WITH <DDT UNDER THE NAMES <DORT*.EXE.  ^THESE FILES MUST BE RENAMED TO
<FORT*.EXE BEFORE USE.
.B 1
^IF FOR SOME REASON IT IS DESIRED TO LOAD THE
COMPILER WITH <DDT, THERE IS A SERIES OF <LINK INDIRECT FILES INCLUDED
WHICH ARE ANALOGOUS TO THE <?.CMD FILES USED IN <B10FTN.CTL.
^THEY ARE <D?.CMD AND ARE USED IN THE SAME FASHION AS THE <?.CMD FILES.
.B 1
^SINCE ONLY BREAK POINTS IN THE LOW SEGMENT ARE PHASE
INDEPENDENT,  THE STANDARD TECHNIQUE TO SET A BREAK POINT IS TO SET ONE
IN <FORTRA - MODULE <MAIN AT <GETSG+53 AND THEN <SAVE THE SEGMENT.
^THIS WILL CAUSE A BREAK POINT TO OCCUR AT THE BEGINNING OF EACH
PHASE OF THE COMPILER JUST AFTER IT IS LOADED. 
^AT THIS POINT, BREAK POINTS CAN BE SET IN THE PARTICULAR PHASE.
^THESE PHASE-DEPENDENT BREAKPOINTS SHOULD BE REMOVED PRIOR TO
BRINGING THE NEXT SEGMENT INTO CORE.
.B 2
2.4##^BUILDING A ^SINGLE ^SEGMENT ^VERSION OF <FORTRAN
.B 1
^THE <LINK INDIRECT FILE <ALL.CMD (AND THE <DDT VERSION <DALL.CMD) IS
INCLUDED AND CAN BE USED TO LOAD A 81^K SINGLE SEGMENT VERSION OF THE
COMPILER.  ^THIS IS PARTICULARLY ATTRACTIVE FOR INSTALLATIONS
WHERE THE JOB MIX CONTAINS MANY <FORTRAN COMPILATIONS OF SEVERAL
SMALL SUBROUTINES, ESPECIALLY IF THEY ARE HANDLED IN BATCH
MODE.  ^THE SINGLE SEGMENT VERSION IS COMPRISED OF THE SAME MODULES
AS THE MULTI-SEGMENT VERSION WITH THE EXCEPTIONS THAT THE <ERROV?.BLI
MODULES ARE NOT NEEDED AND <ONESEG.REL IS USED INSTEAD OF <MAIN.REL.
<ONESEG IS SIMPLY A RECOMPILATION OF <MAIN.BLI, RECOMPILED WITH
THE COMPILATION CONTROL VARIABLE <FT1SEG 
IN THE <REQUIRE<D FILE <FT1SEG.REQ (BUILT AS <FT1SEG.ON IN <B10FTN.CTL)
SET TO 1 RATHER THAN 0.  ^THIS ELIMINATES THE <GETSEG<S.  ^NOTE THAT <ONESEG.REL
AND <FT1SEG.ON AS WELL AS <SINGLE.EXE, ETC ARE INCLUDED ON THE <FORTRAN RELEASE TAPE.
.ENDIF FTTENX
.B 3
3.0##<FOROTS <AND <FORLIB
.B 2
3.1##^INSTALLATION OF THE <FOROTS AND <FORLIB ^BINARY ^FILES
.B 1
.IF FTTENX
^TO INSTALL <FOROTS AND <FORLIB, COPY
<FOROTS.EXE AND <FORLIB.REL FROM THE RELEASE TAPE.
.ELSE FTTENX
<FOROTS AND <FORLIB ARE PROCESSOR DEPENDENT.  ^THEREFORE THE
<FORTRAN RELEASE TAPE CONTAINS VERSIONS TO RUN ON BOTH THE <KA10
AND <KI/KL10:  <FORLKA.REL AND <FOROKA.SHR ARE FOR THE 
<KA;  <FORLKI.REL AND <FOROKI.EXE ARE FOR THE <KI OR <KL.  ^RENAME
THE APPROPRIATE MODULES TO <FORLIB.REL AND <FOROTS.EXE OR <.SHR.
.ENDIF FTTENX
.B 2
3.2##^BUILDING <FOROTS AND <FORLIB ^FROM ^SOURCES
.B 1
^THE CONTROL FILE
.IF FTTENX
<B20FRS.CTL
.ELSE FTTENX
<B10FRS.CTL
.ENDIF FTTENX
CAN BE USED TO BUILD <FOROTS AND <FORLIB
.IFNOT FTTENX
(BOTH THE <KA AND <KI/KL VERSIONS)
.ENDIF FTTENX
FROM THE SOURCES.
^NOTICE THAT THE BUILD PROCESS USES
.IF FTTENX
PUBLIC STRUCTURE
.ELSE FTTENX
STRUCTURE <FTN
.ENDIF FTTENX
AND FIELD IMAGE SOFTWARE AND <ASM:
FOR <MACRO 52 AND <MKL: FOR <MAKLIB.
.B 3
4.0##^INSTALLATION OF <FORDDT
.B 1
^TO INSTALL <FORDDT, COPY <FORDDT.REL AND <FORDDT.HLP FROM THE RELEASE TAPE.
.IFNOT FTTENX
<FORDDT WILL WORK ON A <KA10, <KI10  OR <KL10.
.ENDIF FTTENX
.B 1
^TO REBUILD, SIMPLY ASSEMBLE <FORDDT.MAC, RUN OFF
.IF FTTENX
<FDT5A.RNH/VARIANT:FTTENX
.ELSE FTTENX
<FDT5A.RNH
.ENDIF FTTENX
OR USE THE CONTROL FILE
.IF FTTENX
<B20FDT.CTL.
.ELSE FTTENX
<B10FDT.CTL.
.ENDIF FTTENX
.B 3
[^END OF <FTN5A.FIG]