home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / fchek284.zip / readme.os2 < prev    next >
Text File  |  1996-03-31  |  4KB  |  112 lines
  1.  
  2. This is the OS/2 2.x recompile of Ftnchek, 2.8.4. Indeed, I can't call
  3. it a port since Robert Moniot (the author of ftncheck) wrote it in
  4. a portable fashion, so that it just recompiles under Eberhard Mattes'
  5. emx environment w/o any complaints. See the original 'readme' file.
  6.  
  7.  
  8. The OS/2 2.x recompile can be found on the usual sites:
  9.  
  10. ftp-os2.cdrom.com: (CD-ROM)
  11.  
  12. now:        /os2/incoming/fchek284.zip
  13. move to:    /os2/dev32/fchek284.zip
  14.  
  15. ftp-os2.nmsu.edu  (HOBBES)
  16.  
  17. now:        /incoming/fchek284.zip
  18. move to:    /os2/dev32/fchek284.zip
  19.  
  20.  
  21. A brief intro:
  22. ==============
  23.  
  24. ftnchek is a free Fortran syntax checker (some say, similar to
  25. a commercial product called FLINT, which I don't know). It allows
  26. to catch all kinds of problems Fortran is (in)famouse for: unassigned
  27. variables, type casts, too long lines, wrong number / type of arguments
  28. in calles to functions/subroutines etc. It can catch lots of problems
  29. many Fortran compilers seem to fail finding.
  30. To cut it short, it helps do what a normal Pascal compiler would do 
  31. by itself on Pascal, for those of us who (still) need to use Fortran.
  32. Read the docs to learn more.
  33.  
  34.  
  35. The OS/2 port:
  36. ==============
  37.  
  38. The only modifications I have made to the original distribution before
  39. recompiling with gcc 2.7.2 / emx09b + emxfix03 are:
  40.  
  41. a) Applied the patches to bring version 2.8.3 up to version 2.8.4. The 
  42.    original sources are renamed to name.orig.
  43.  
  44. b) Included a makefile for os/2, called 'makefile.os2' (which is identical
  45.    to the included makefile). 
  46.  
  47.    This file defines two new symbolic targets, OS2emx and OS2noemx,
  48.    with 'gcc' as the compiler and also sets the LARGE_MACHINE
  49.    option to allow for more table space for large programmes. (If that
  50.    is not enough, read the readme file and try with the DYNAMIC option,
  51.    or so. I haven't tried it since I never ran out of space even in the
  52.    default setting, but someone complained in the fortran news group
  53.    about needing LARGE). Also, it adds a TARGET with EXE extension, and
  54.    specifies the object files to be stripped to save some space.
  55.  
  56.    To re-build the version to be used with emx, run
  57.  
  58.      make -f makefile.os2 OS2emx.
  59.  
  60.    To re-build the version to be used without emx, run
  61.  
  62.      make -f makefile.os2 OS2noemx.
  63.  
  64.    I tested this only with gnu make.
  65.    The original 'makefile' is identical to 'makefile.unix' and got renamed
  66.    to 'makefile.distribution' for completeness.
  67.  
  68. c) Included a binary, ftnchek.exe, which needs the 'emx09b' runtime system 
  69.    to work.  This can be found as emxrt.zip on many ftp sites, including 
  70.    hobbes (ftp-os2.nmsu.edu) and cdrom (ftp-os2.cdrom.com). I compiled
  71.    it with gcc 2.7.2 / emx09b + emxfix03. To use it, make sure to have the 
  72.    emx runtime libraries installed in your LIBPATH.
  73.  
  74. d) I also included a binary, ftnchekS.exe, which can be used w/o having
  75.    emxrt installed. This binary is slightly bigger, and in case you have
  76.    emx.dll installed anyway, it is probably a good idea to use the first 
  77.    binary to free some RAM.
  78.  
  79. If you want to read more about the specifics of the port and the makefile
  80. changes, feel free to read my 'os2port.txt' file, included as well.
  81.  
  82. Installation: 
  83. =============
  84.  
  85. 1) If you are using an older version of ftnchek make a backup copy first!
  86.    Now put the binary 'ftnchek.exe' or 'ftnchekS.exe' in a directory in
  87.    your PATH. Of course, you can rename 'ftnchekS.exe' to 'ftnchek.exe'
  88.    if you wish.
  89.  
  90. 2) If you have a postscript printer you may wish to print the file 
  91.    'ftnchek.ps'.  If you have GNU man installed, you may wish to move the 
  92.    file 'ftnchek.man' onto a file 'ftnchek.1' in your man/man1
  93.    directory. If you have neither nor read the file 'ftnchek.doc'
  94.  
  95. 3) Use it.
  96.  
  97. As always: The progamme is distributed as is, no warranties are given or
  98. implied in any way. Use at your own risk; if it kills your cat -- too bad. 
  99. All the copyrights or -lefts of the original distribution apply. Check there.
  100.  
  101. Bug reports to the original author, please, unless they are clearly
  102. a 'feature' of the os/2 port. (I don't know what I can do then, since all
  103. I did was a re-compile anyway).
  104.  
  105. Chocolates to Robert Moniot (ftnchek), Eberhard Mattes (emx) and the other
  106. gcc people, and if some are left, as always, I'll take a bite.
  107.  
  108. That's it. Have fun.            Stefan A. Deutscher ,  31-Mar-1996
  109.  
  110.                           sad@utk.edu / stefand@elphy.irz.hu-berlin.de
  111.  
  112.