home *** CD-ROM | disk | FTP | other *** search
/ Power-Programmierung / CD1.mdf / fortran / mslang / prefor / read_me.fst < prev    next >
Text File  |  1994-01-24  |  5KB  |  79 lines
  1. This upload contains the lastest versions as of 10/6/93 of the programs
  2. that I personally developed as input to the WIN32API consortium.  I ask  
  3. that the other contributers upload their inputs also so that we can continue
  4. the work in this forum.  The FORM32 and MOVE32
  5. module source are not included but are available from the Engineering Computer 
  6. Programers library if you want them.   Note that all these are alpha
  7. programs and that they are only used as starting points in development
  8. (for example; nested structure names are not automatically generated
  9. by this version; so if your code uses the paint structure but not the
  10. rectangle structure independently you need to include an entry using
  11. the rectangle structure to force the precompiler to pick up the structure
  12. definition--or paste it in using EDIT after the Precompiler does its work
  13. but before the Compiler is invoked.
  14. ***************PREFOR32******************************************
  15. This is a 2 pass pre FORTRAN compiler.  Since FORTRAN 32 Powerstation
  16. is limited to about 65000 bytes of symbols, it is impossible besides
  17. wasteful to include a bunch of define statemements for variables that
  18. are never used.  Therefore PREFOR32 scans the FORTRAN code of one file
  19. looking for variables found in the lists MASTERFI.LIS and MASTERFD.LIS
  20. and generates FILE_NAME.FI and FILE_NAME.FD (where FILE_NAME is the
  21. name of the file).  The programmer needs only put include statements
  22. in his FORTRAN code to use these.
  23. This is the selective copier of includes from the master include files
  24. to the user include files.  It selectively copies the include information
  25. for the selections which the user has specified in his(er) .fdh and .fih
  26. files.  It searches the 13 master .FI files and the 13 master .FD files
  27. in the order shown in the file PREFOR32.FOR.  It is run from NT by clicking
  28. on an icon which you have established to run prefor32.  For the example
  29. included (i.e., the program itself serves as an example of how to use
  30. the product) run the program twice.  The first time enter PREFOR32 into
  31. the file entry block of the dialog box.  The second time enter FORM32
  32. into the file entry block of the dialog box.  Examine the source code of
  33. PREFOR32.FOR, MOVETE32.FOR, and FORM32.FOR to see what include statements
  34. are needed where.  The .PRE files produced PREFOR32.PRE and FORM32.PRE
  35. will summarize the success of PREFOR32.  Listed in the files are the
  36. number of FI and FD symbols requested and the number not found.  If any
  37. symbols are not found, the symbols are listed.  A symbol being listed
  38. signifies one of two things: (1) the symbol was not found in any of the
  39. 13 master includes (in this case check the spelling in the .fih or .fid 
  40. file) or (2) the symbol occured twice in the .fdh or .fih file (in this 
  41. case delete one of the entries and rerun PREFOR32.
  42. ***************SCRUNCH_******************************************
  43. This is the second pass only of PREFOR32 that avoids the FORTRAN code
  44. search and uses the intermediate results FILE_NAME.FIH and FILE_NAME.FD
  45. to determine the contents of FILE_NAME.FI and FILE_NAME.FD.
  46. This is the selective copier of includes from the master include files
  47. to the user include files.  It selectively copies the include information
  48. for the selections which the user has specified in his(er) .fdh and .fih
  49. files.  It searches the 13 master .FI files and the 13 master .FD files
  50. in the order shown in the file PREFOR32.FOR.  It is run from NT by clicking
  51. on an icon which you have established to run prefor32.  For the example
  52. included (i.e., the program itself serves as an example of how to use
  53. the product) run the program twice.  The first time enter PREFOR32 into
  54. the file entry block of the dialog box.  The second time enter FORM32
  55. into the file entry block of the dialog box.  Examine the source code of
  56. PREFOR32.FOR, MOVETE32.FOR, and FORM32.FOR to see what include statements
  57. are needed where.  The .PRE files produced PREFOR32.PRE and FORM32.PRE
  58. will summarize the success of PREFOR32.  Listed in the files are the
  59. number of FI and FD symbols requested and the number not found.  If any
  60. symbols are not found, the symbols are listed.  A symbol being listed
  61. signifies one of two things: (1) the symbol was not found in any of the
  62. 13 master includes (in this case check the spelling in the .fih or .fid 
  63. file) or (2) the symbol occured twice in the .fdh or .fih file (in this 
  64. case delete one of the entries and rerun PREFOR32.
  65. ********************************************************************
  66. DEFS is a program that searches a C include file to find the DEFINE
  67. statements and generates the equivalent FORTRAN Parameter statements.
  68. It is a quick 'n dirty program to aid in generating the .FD master
  69. library.  It also generates MASTERFD.LIS
  70. ********************************************************************
  71. If you have any questions, send me mail at 71461,374 or post query in
  72. forum.  Barry
  73. ********************************************************************
  74.                  DANGER Will Robinson DANGER
  75. The USER32.FI and USER32.FD files included are examples and not the
  76. ones the forum is working on.  Please do not overcopy your versions
  77. of USER32.FI and USER32.FD; stick this stuff in a separate directory.
  78. ********************************************************************
  79.