home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / simtel / sigm / vols000 / vol014 / fortran.hlp < prev    next >
Encoding:
Text File  |  1985-02-10  |  6.9 KB  |  159 lines
  1. Invoking FORTRAN-80 and MACRO-80
  2. FORTRAN-80 Compilation Switches
  3. FORTRAN-80 Library Subroutines
  4. FORTRAN-80 Logical Device Assignments
  5. Invoking LINK-80
  6. LINK-80 Switches
  7. Creating a FORTRAN-80 .COM File
  8. :Invoking FORTRAN-80 and MACRO-80
  9.      Thσ FORTRAN-8░ compile≥ anΣ thσ MACRO-8░ assembler¼á nameΣ F8░ anΣ M8░ ì
  10. respectively¼ arσ invokeΣ iε ß simila≥ fashion«  Iε botΦ cases¼ thσ namσ oµ ì
  11. thσá prograφ i≤ giveε followeΣ b∙ aε argumen⌠ list«á  Thi≤ argumen⌠ lis⌠ i≤ ì
  12. of the general form --
  13.           obj-dev:filename.ext,list-dev:filename.ext=
  14.                source-dev:filename.ext
  15.      These symbols are defined as follows --
  16.         obj-dev:  The device on which the object program is to be written.
  17.         list-dev:  The device on which the program listing is written.
  18.         source-dev║á  Thσá devicσ froφ whicΦ thσ sourcσá prograφá inpu⌠á t∩ ì
  19. FORTRAN-80 or MACRO-80 is obtained.
  20.         filename.ext║á  Thσá filenamσ anΣ filenamσ extensioε oµ thσá objec⌠ ì
  21. prograφ file¼á thσ listinτ file¼á anΣ thσ sourcσ prograφ file«
  22.  
  23.      Thσ defaul⌠ extensions are --
  24.  
  25.                FOR  FORTRAN-80 Source File
  26.                MAC  MACRO-80 Source File
  27.                PRN  Print (Listing) File
  28.                REL  Relocatable Object File
  29.                COM  Absolute Object File ORGed to 100H
  30.  
  31.      Thσ specification≤ fo≥ eithe≥ thσ objec⌠ file¼á thσ listinτá file¼á o≥ ì
  32. botΦá ma∙á bσá omitted«á  Iµ neithe≥ ß listinτ filσ no≥ aε objec⌠á filσá i≤ ì
  33. desired¼ placσ onl∙ ß commß t∩ thσ lef⌠ oµ thσ equa∞ sign«  Iµ thσ name≤ oµ ì
  34. thσ objec⌠ filσ anΣ thσ listinτ filσ arσ omitted¼á thσ defaul⌠ i≤ thσá namσ ì
  35. of the source file.  Logical CP/M devices may be specified as follows --
  36.  
  37.                A:, B:    Disk Drives (Only A: or B:)
  38.                HSR:      High Speed Reader
  39.                LST:      Line Printer
  40.                TTY:      Teletype or CRT
  41.  
  42. Examples --
  43.      A>F80
  44.      *=TEST
  45.           Compile the program TEST.FOR and place the object in TEST.REL
  46.      *,TTY:=TEST
  47.           Compilσá thσá prograφá TEST.FO╥á anΣá lis⌠á thσá prograφá oεá thσ ì
  48. terminal.  No object is generated.
  49.      *TESTOBJ=TEST.FOR
  50.           Compile the program TEST.FOR and put object in TESTOBJ.REL
  51.      *TEST,TEST=TEST
  52.           Compilσá TEST.FOR¼á anΣá pu⌠á objec⌠ iε TEST.RE╠ anΣá listinτá iε ì
  53. TEST.PRN
  54.      *,=TEST.FOR
  55.           Compilσ TEST.FO╥ bu⌠ producσ n∩ objec⌠ o≥ listinτá file«á  Usefu∞ ì
  56. for checking for errors.
  57.  
  58.    Iεá al∞á cases¼á thσá ¬ i≤ thσ promp⌠ froφá FORTRAN-80«á  Thσá indicateΣ ì
  59. operation≤á ma∙ als∩ bσ performeΣ b∙ typinτ 'F80º followeΣ b∙á thσá option¼ ì
  60. like 'F80 =TEST'.
  61.    Refer to the 'FORTRAN-80 User's Manual', Copyright 1977, by Microsoft.
  62. :FORTRAN-80:  FORTRAN-80 Compilation Switches
  63.      ┴ numbe≥ oµ differen⌠ switche≤ ma∙ bσ giveε iε thσ commanΣ strinτ tha⌠ ì
  64. wil∞ affec⌠ thσ forma⌠ oµ thσ listinτ file«  EacΦ switcΦ shoulΣ bσ precedeΣ ì
  65. by a slash (/):
  66.  
  67. Switch    Function
  68. ------    --------
  69.    O      Print all listing addresses in octal
  70.    H      Print all listing addresses in hexadecimal (default)
  71.    N      Do not list generated code
  72.    R      Force generation of an object file
  73.    L      Force generation of a listing file
  74.    P      Each /P allocates an extra 100 bytes of runtime stack space
  75.    ═á     Specifie≤ t∩ thσ compile≥ tha⌠ thσ generateΣ codσ shoulΣ bσ iε  a
  76.           form which can be loaded into ROM.
  77.  
  78. :FORTRAN-80:  FORTRAN-80 Library Subroutines
  79.      Thσá standarΣ librar∙ (FORLIB.REL⌐ include≤ thσ followinτá subroutine≤ ì
  80. and functions --
  81.  
  82.      ABS       IABS      DABS      AINT      INT       IDINT
  83.      AMOD      MOD       AMAX0     AMAX1     MAX0      MAX1
  84.      DMAX1     AMIN0     AMIN1     MIN0      MIN1      DMIN1
  85.      FLOAT     IFIX      SIGN      ISIGN     DSIGN     DIM
  86.      IDIM      SNGL      DBLE      EXP       DEXP      ALOG
  87.      DLOG      ALOG10    DLOG10    SIN       DSIN      COS
  88.      DCOS      TANH      SQRT      DSQRT     ATAN      DATAN
  89.      ATAN2     DATAN2    DMOD      PEEK      POKE      INP
  90.      OUT
  91.  
  92. :FORTRAN-80:  FORTRAN-80 Logical Device Assignments
  93.  
  94.      LUN*      Device
  95.      ----      ------è     1,3,4,5   Preassigned to CON:
  96.      2         Preassigned to LST:
  97.      6-10      Preassigned to Disk Files (Reassignable)
  98.      11-255    User-Assignable
  99.  
  100. * LUN = Logical Unit Number
  101. :LINK-80:  Invoking LINK-80
  102.      EacΦ commanΣ t∩ LINK-8░ consist≤ oµ ß numbe≥ oµ filename≤ anΣ switche≤ ì
  103. separated by commas --
  104.           obj-dev1:filename.ext/sw1,obj-dev2:filename.ext, ...
  105.      Iµá thσá inpu⌠á devicσá fo≥ ß filσ i≤á omitted¼á thσá defaul⌠á i≤á thσ ì
  106. currentl∙ loggeΣ disk«á  Iµ thσ extensioε oµ ß filσ i≤ omitted¼ thσ defaul⌠ ì
  107. i≤á .REL«á  Afte≥á eacΦá linσ i≤ typed¼á LINK-8░ wil∞ loaΣá o≥á searcΦá thσ ì
  108. specifieΣ files¼á and¼á wheε finished¼ i⌠ wil∞ lis⌠ al∞ symbol≤ tha⌠ remaiε ì
  109. undefineΣ followeΣ b∙ aε asterisk«á  LINK-8░ i≤ invokeΣ b∙ thσ prograφ namσ ì
  110. 'L80'.
  111.      LINK-8░á caε bσ useΣ t∩ generatσ ß .CO═ filσ oµ ß FORTRAN-8░á program«  ì
  112. This can be done by typing --
  113.           L80 program/E
  114. LINK-80 will respond with a string of the form --
  115.           [aaaa bbbb nn]
  116. The user may then create the .COM file by typing --
  117.           SAVE nn program.COM
  118. :LINK-80:  LINK-80 Switches
  119.      Thσ followinτ arσ thσ switche≤ fo≥ LINK-80«á  A≤ fo≥ FORTRAN-80¼ thesσ ì
  120. switches are preceeded by a slash (/).
  121.  
  122. Switch    Function
  123. ------    --------
  124.    R      Reset.  Initialize loader.
  125. E,E:namσá Exi⌠ LINK-80«á  FORLIB.RE╠ wil∞ bσ searcheΣ t∩  satisf∙á existinτ ì
  126.           undefineΣ references«á  Iµ 'nameº i≤ specified¼ thσ valuσ oµ thi≤ ì
  127.           symbol is used as the start address of the program.
  128. G,G:namσ  Go«á  Star⌠ executioε oµ program«  FORLIB.RE╠ wil∞ bσ searcheΣ t∩ ì
  129.           satisfy any existing undefined references.
  130.    U      List all undefined references.
  131.    ═      Map«  Lis⌠ al∞ defineΣ reference≤ anΣ thei≥ values╗ al∞ undefineΣ ì
  132.           references are followed by an asterisk.
  133.    ╙      Search«á  SearcΦ thσ filσ specifieΣ beforσ thi≤ switcΦ t∩ satisf∙ ì
  134.           references.
  135.    ╬      Iµ ß filename/╬ i≤ specified¼á thσ prograφ wil∞ bσ saveΣ oεá disδ ì
  136.           under the selected name with a default extension of .COM.
  137. P and D   See Addenda to Section 2 of documentation.
  138.  
  139.      Threσ number≤ arσ specifieΣ afte≥ thσ /┼ anΣ /╟ switche≤ arσ executed«  ì
  140. They are given in the form --
  141.           [aaaa bbbb nn]
  142.   aaaa - start address of program
  143.   bbbb - address of next available byte
  144.   nn   - number of 256-byte pages used
  145. :Creating a FORTRAN-80 .COM File
  146.      Therσá arσá tw∩á basiπá way≤ t∩ creatσ ß .CO═á filσá oµá ßá FORTRAN-8░ ì
  147. program«á  Fo≥ example¼á t∩ generatσ PROG.CO═ froφ PROG.FOR¼ proceeΣ iε onσ ì
  148. of the following ways --
  149.  
  150.  I.  Using SAVE
  151.      F80 =PROG
  152.      L80 PROG/E
  153.        [aaaa bbbb nn] -- response from LINK-80 (necessary data)
  154.      SAVE nn PROG.COM
  155.  
  156. II.  Using /N LINK-80 Switch
  157.      F80 =PROG
  158.      L80 PROG/E,PROG/N
  159.