home *** CD-ROM | disk | FTP | other *** search
/ CP/M / CPM_CDROM.iso / cpm / utils / asmutl / symx23.ark / SYMX23.DOC < prev    next >
Encoding:
Text File  |  1984-09-29  |  3.4 KB  |  79 lines
  1.  
  2.         SYMX - Symbol table file expander
  3.         =================================
  4.  
  5.          Copyright (C) 1984 by Jeffrey J. Nonken
  6.         Portions Copyright (C) 1981 by Microsoft
  7.  
  8. Unlimited  duplication and distribution permitted for  non-profit
  9. purposes.   NOTE:  Microsoft  has  given  blanket  permission  to
  10. distribute  their  old    library (distributed  as  OBSLIB.REL  and
  11. linked    into  this  program),  without need  of  registration  or
  12. royalties, so long as a copyright notice is included (see above).
  13.  
  14.  
  15.             SYMX description
  16.             ================
  17.  
  18.      SYMX  is  a symbol table expanding  routine.  The    Microsoft
  19. FORTRAN-80 (F80),  MACRO-80 (M80), BASIC-80 (BASCOM), and LINK-
  20. 80  (L80)  programs only put public symbols in the  symbol  table
  21. (SYM)  file.  However,    occasionally  it is useful to have  local
  22. symbol locations available. SYMX will take PRN files generated by
  23. MACRO-80  and  combine    all non-public symbols in  them  with  an
  24. existing SYM file, creating a larger file with the same name. The
  25. new file will be readable by SID and ZSID if the old file was.
  26.  
  27.  
  28.             SYMX instructions
  29.             =================
  30.  
  31. For interactive mode, execute with no parameters.
  32.     SYMX <c/r>
  33. Next, enter the name of the SYM file.
  34.     SYM FILE NAME? XYZZY.SYM <c/r>
  35.            -or-
  36.     SYM FILE NAME? XYZZY <c/r>
  37. SYMX  will read in the SYM file and display the number of symbols
  38. found.
  39.     PRN FILE NAME?
  40. Now you may enter the PRN files. You may either enter them one at
  41. a time or all on a single line.  For the first method,    SYMX will
  42. prompt you for each name, and entering a blank line will cause it
  43. to finish. For the second method, you must enter all names on one
  44. line,  separated by commas.  SYMX will not prompt you  again.  As
  45. each  file  is    opened its name will be displayed;  after  it  is
  46. loaded,  the total number of symbols will be displayed. (NOTE: if
  47. you start by entering one on a line,  you may at any time  finish
  48. by typing the remaining PRN file names on one line.)
  49.      For  file controlled mode,  execute with the file name as    a
  50. parameter.
  51.     SYMX XYZZY <c/r>
  52. If you do not specify an extension, SYMX will assume an extension
  53. of SYX. The above statement is the same as
  54.     SYMX XYZZY.SYX <c/r>
  55. The  syntax for the file controlled mode is the same as that  for
  56. interactive mode.  The SYX file is an ASCII file.  The blank line
  57. on  the  end  of the one-per-line method is  acceptable  but  not
  58. necessary.  Also, if SYMX encounters a question mark (?) alone on
  59. a  line,  it will revert to interactive mode.  Note that this  is
  60. only good for the PRN files; a SYX file must contain at least the
  61. SYM file name before a question mark.
  62.  
  63.  
  64.             SYMX limitations
  65.             ================
  66.  
  67.      SYMX  can    only  handle 1500 symbols.  If    you  exceed  1500
  68. symbols,  SYMX    will probably blow up,    as there is no protection
  69. against symbol table overflow.
  70.      SYMX  was    designed  to work only with  symbol  table  files
  71. compatible with Digital Research's MAC and Microsoft's L80. It is
  72. also designed to work with PRN files generated by M80. If it used
  73. with any other assembler,  the list of symbols at the end of  the
  74. listing  must  look exactly the same as with M80,  including  the
  75. legend 'Symbols:' at the top of the symbol table.
  76.  
  77.                   - Jeffrey J. Nonken
  78.                 San Clemente, Ca.
  79.