home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / fchk294s.zip / readme.os2
Text File  |  1996-10-04  |  7KB  |  176 lines
  1. This is ftnchek, version 2.9.4, compiled for OS/2 2.x and above.
  2. It has been compiled with a minor modification using the makefiles
  3. and the configure_os2.cmd script supplied in the distribution.
  4.  
  5. Robert Moniot (the author of ftncheck) wrote it in a portable fashion,
  6. so that it just recompiles under Eberhard Mattes' emx environment w/o any
  7. complaints. See the original 'readme' file.
  8.  
  9.  
  10. The OS/2 2.x recompile can be found on the original ftnchek site 
  11.  
  12. ftp://ftp.dsm.fordham.edu/pub/ftnchek2.9/fchk294b.zip
  13. ftp://ftp.dsm.fordham.edu/pub/ftnchek2.9/fchk294s.zip
  14.  
  15. as well as on the usual OS/2 sites:
  16.  
  17.  
  18. fchk294s.zip          --- sources
  19. fchk294b.zip          --- binaries
  20.  
  21. ftp-os2.cdrom.com: (CD-ROM)
  22.  
  23. now:        /os2/incoming/
  24. move to:    /os2/dev32/
  25.  
  26. ftp-os2.nmsu.edu:  (HOBBES --- if this works again)
  27.  
  28. now:        /incoming/
  29. move to:    /os2/dev32/
  30.  
  31.  
  32. ftp.leo.org: (LEO)
  33.  
  34. now:       /incoming/os2
  35. move to:   /pub/comp/os/os2/devtools/utils
  36.  
  37.  
  38. A brief intro:
  39. ==============
  40.  
  41. ftnchek is a free Fortran syntax checker. Some say, it is similar to
  42. a commercial product called FLINT, which I don't know. It allows
  43. to catch all kinds of problems Fortran is (in)famouse for: unassigned
  44. variables, type casts, too long lines, wrong number / type of arguments
  45. in calles to functions/subroutines etc. It can catch lots of problems
  46. many Fortran compilers seem to fail finding.
  47. To cut it short, it helps do what a normal Pascal compiler would do 
  48. by itself on Pascal, for those of us who (still) need to use Fortran.
  49. Read the docs to learn more.
  50.  
  51.  
  52. New in version 2.9.4
  53. ====================
  54.  
  55. Some bug fixes and a few other things, see the PATCHES file of the 
  56. original distribution.
  57.  
  58.  
  59. The OS/2 port:
  60. ==============
  61.  
  62. It is now not a port anymore since OS/2 is a supported target in the
  63. original distribution.  The original sources have been obtained
  64. from ftp://ftp.dsm.fordham.edu/pub/ on 04-Oct-96 as a *.tar.gz file.
  65.  
  66. The first archive, fchk294s.zip, contains the sources.
  67. I took the liberty to repackage them in a *.zip file for the people
  68. without tar / gzip on their machines, or even for the last few people
  69. still using the silly DOS 8.3 FAT file system under OS/2 instead of HPFS.
  70.  
  71.  
  72.  
  73. The second archive, fchk294b.zip, includes the necessary documentation,
  74. test files, and the two binaries, 'ftnchek.exe' and 'ftnchekS.exe'. 
  75. If you don't plan to recompile it you should be fine with only this archive.
  76.  
  77. * 'ftnchek.exe' needs the 'emx09b / emxfix05' runtime system to work  
  78.   (can be found as emxrt.zip on many ftp sites, including hobbes 
  79.   (ftp-os2.nmsu.edu) and cdrom (ftp-os2.cdrom.com)). Make sure to have 
  80.   emx.dll in a directory in your LIBPATH. Any newer version of emx should do,
  81.   too.
  82. * 'ftnchekS.exe' can be used w/o having emxrt installed. This binary is 
  83.   slightly smaller this time.
  84.  
  85. All I did was: 
  86. 0) * Minor patch to ftnchek.c (patchfile included): UNIX allows removal
  87.      of open files, OS/2 does not. So I had to close empty files before 
  88.      calling unlink(), otherwise they'd just sit there.
  89.    * Extended configure_os2.cmd to generate also test/Makefile and
  90.      test/Compare.sh, for this I had to create test/Compare.in.
  91.  
  92. 1) compiled it with gcc 2.7.2 / emx09b + emxfix05, using
  93.  
  94.     configure_os2 -f aout -l dynamic
  95.     make
  96.     cp ftnchek.exe ftnchek.exe.dyn
  97.     configure_os2 -f omf -l static
  98.     make
  99.     mv ftnchek.exe ftnchekS.exe
  100.     mv ftnchek.exe.dyn ftnchek.exe
  101.  
  102.    Alternatively, one can also generate the  executables using the
  103.    makefile.os2, especially when you don't have all the stuff that
  104.    the configure_os2.cmd script calls.
  105.    The configure_os2.cmd script written by Christian Bartels to provide
  106.    the functionality of the UNIX shell script configure to OS/2. It generates
  107.    the Makefile.
  108.  
  109.    Since the makefile.os2 is still supplied but not supported anymore, the
  110.    configure script seems the better bet in the long run.
  111.    
  112. 2) put the binaries, makefile, some docs in this archive
  113. 3) upload the whole thing due to request in two packages, the
  114.    sources and the binaries with docs.
  115.  
  116. Installation: 
  117. =============
  118.  
  119. 1) If you are using an older version of ftnchek make a backup copy first!
  120.    Now put the binary 'ftnchek.exe' or 'ftnchekS.exe' in a directory in
  121.    your PATH. Of course, you can rename 'ftnchekS.exe' to 'ftnchek.exe'
  122.    if you wish. I fyou use the original 'ftnchek.exe' make sure to have
  123.    emx.dll installed as discussed above.
  124.  
  125. 2) If you have a postscript printer you may wish to print the file 
  126.    'ftnchek.ps'.  If you have GNU man installed, you may wish to move the 
  127.    file 'ftnchek.man' onto a file 'ftnchek.1' in your man/man1
  128.    directory. If you have neither nor read the file 'ftnchek.doc'
  129.  
  130. 3) If you wish to also use 'dcl2inc.cmd' to generate declarations 
  131.    automatically you need to put the file 'dcl2inc.awk' somewhere,
  132.    then edit 'dcl2inc.cmd' such that it can find the '*awk' file, and you
  133.    will need to have awk (gawk, nawk) installed.
  134.  
  135. 4) Use it.
  136.  
  137. As always: The progamme is distributed as is, no warranties are given or
  138. implied in any way. Use at your own risk; if it kills your cat -- too bad. 
  139. All the copyrights or -lefts of the original distribution apply. Check there.
  140.  
  141. You can now also run the makefile target 'check' under OS/2. You will need
  142. a good load of GNU utilities to be installed (bc, gawk, cat, diff, etc.)
  143. and a copy of sh.exe in your path. Cooking up a plain REXX solution is
  144. probably possible but seems like a waste of time when the other things work.
  145.  
  146. In the test subdirectory you will find a Makefile (which should be the same
  147. as the Makefile.os2 in the same directory) and a Compare.sh (the same as 
  148. Compare.sh.os2). The orignal files (Makefile.in, Compare.sh.distrbution)
  149. are still there.
  150. Next, in the test/Okay subdirectory, you will have to make sure that 
  151. your diff programme is clever enough (mine is) or that the
  152. test files have lines ending in CR+LF (the original UNIX distribution
  153. has only CR or only LF and hence cmp moans about differences).
  154. You can do this with a quick and dirty
  155.   zip -0 test *
  156.   unzip -o -aa test.zip
  157. but is shouldn't be needed. The check now works
  158. w/o a hitch (see file check.log), it just takes ages on a 486dx33.
  159.  
  160. Bug reports to the original author, please, unless they are clearly
  161. a 'feature' of the os/2 port. (I don't know what I can do then, since all
  162. I did was a re-compile anyway).
  163.  
  164. Chocolates to Robert Moniot (ftnchek), Eberhard Mattes (emx) and the other
  165. gcc people, Christian Bartels (configure_os2.cmd), and if some are left,
  166. as always, I'll take a bite.
  167.  
  168. Read the files 'README', 'readme.os2', and of course
  169. the documention of 'ftnchek' for more information.
  170.  
  171. That's it. Have fun.            Stefan A. Deutscher ,  04-Oct-1996
  172.  
  173.                           sad@utk.edu / stefand@elphy.irz.hu-berlin.de
  174.  
  175.  
  176.