FTNCHEK 3.3
                            November, 2004

Contents of this directory:

     File                             Size        Description
                                   (approx KB)
README                                   4 Information about these files
ftnchek-3.3.1.tar.gz                  1024 Source & documentation tar+gzipped
ftnchek-3_3_1.zip                     1527 Same, zip file for DOS/Windows
ftnchek-3.3.1.tar.asc                    1 PGP signature for unzipped tar file
shell_mung_vms_shar.com                 62 Wildcard expansion routine for VMS
shell_mung_vms_shar.com_gz              19 Same, gzipped
ftnchek-3.3.1.pdf                      435 PDF version of manual
ftnchek-3.3.1.ps                       494 PostScript version of manual
ftnchek-3.3.1.ps.gz                    131 Same, gzipped
ftnchek-3.3.1.html.tar.gz               63 HTML version of manual tar+gzipped
ftnchek-3_3_1_html.zip                  98 Same, in zip file and DOS format
ftnchek-3.3.1.catman.tar.gz             68 Unix manpage for sites without nroff
ftnchek-3_3_1-win32.exe                306 Binary for Windows 9x/NT
ftnchek-3_3_1-win32.zip                150 Same, in zip file
ftnchek-3.3.1-linux-2.6-i686.tar.gz    187 Binary for Intel Linux
ftnchek-3.3.1-sunos-5.8-sun4u.tar.gz   252 Binary for Sun Solaris 5.8
ftnchek-3.3.1-mac-osx.gz               124 Binary for Mac OS X
dcl2inc.ps                              11 Manual for dcl2inc, PostScript
dcl2inc.pdf                             15 Manual for dcl2inc, PDF
pgp-public-key.asc                       1 PGP public key for Robert K. Moniot
ftnchek-3.3.1.lsm                        1 Linux Software Map entry

To install from ftnchek-3.3.1.tar.gz:

  Download in BINARY mode.  On Unix systems, give the following command:
        gzcat ftnchek-3.3.1.tar.gz | tar -xf -

  Alternatively,
        gunzip ftnchek-3.3.1.tar.gz
        tar -xf ftnchek-3.3.1.tar

  Note: gunzip and tar are available from the GNU project, ftp.gnu.ai.mit.edu

  To use the .bz2 compressed archive, follow the same procedure,
  replacing gunzip by bunzip2.  If you do not have gunzip or bunzip2,
  obtain ftnchek-3.3.1.tar.Z instead and substitute uncompress in
  place of gunzip in the above command.

  The source files will be unpacked into a subdirectory named
  ftnchek-3.2.1.  Change to this directory.  Then follow the
  instructions in the file INSTALL.


To install from vms_shar.com files:

  The distribution is no longer provided in vms_shar format, since I
  no longer have access to a VMS system with the vms_shar utility.

  The shell_mung routine, needed by VMS users to expand filename
  wildcards on the ftnchek command line, is still provided in vms_shar
  form.  It is not bundled with the ftnchek source code but provided
  separately.  Download the file shell_mung_vms_shar.com and then, to
  unpack it, simply put it into the ftnchek source directory and say

         @shell_mung_vms_shar

  Then follow the directions in the file INSTALL.  This procedure will
  create the executable file FTNCHEK.EXE and the help library FTNCHEK.HLB.
  After ftnchek is built, you can check it by saying

         @check

  to run the tests.  Note: on some older VMS systems, the SEARCH
  utility does not accept the /Nowarning qualifier.  This will
  generate the following message when running @check:
    %DCL-W-IVQUAL, unrecognized qualifier - check validity, spelling, and
    placement  \NOWARNING\
  If this occurs, edit line 144 of CHECK.COM to remove the /Nowarning
  qualifier from the Search command.  Then when @check is run, the
  following harmless warning will appear, which you should ignore:
    %SEARCH-I-NOMATCHES, no strings matched


Binary executables:

  The binary tar files contain all the files normally installed,
  namely the ftnchek executable, the dcl2inc wrapper, the dcl2inc awk
  script, and the man pages for ftnchek and dcl2inc, and the
  ftnchek.el emacs lisp file.  These tar files should be unpacked from
  the top of the default directory, e.g. /usr/local.  Thanks go to
  Nelson Beebe for providing most of the binary executables.

  Volunteers are invited to provide executables for other systems.


Robert Moniot
Fordham University
Fordham College at Lincoln Center
New York, NY  10023  (212) 636-6302

Email:    moniot(at)fordham.edu
URL:      http://www.dsm.fordham.edu/~moniot/