home *** CD-ROM | disk | FTP | other *** search
/ The Fred Fish Collection 1.5 / ffcollection-1-5-1992-11.iso / ff_progs / prog_c / f2c.lha / orig / F2CDOC.ZOO / index < prev    next >
Encoding:
Text File  |  1990-12-10  |  8.5 KB  |  231 lines
  1.  
  2. ====== index for f2c ============
  3.  
  4. FILES:
  5.  
  6. f2c.h    Include file necessary for compiling output of the converter.
  7.     See the second NOTE below.
  8.  
  9. f2c.1    Man page for f2c.
  10.  
  11. f2c.1t    Source for f2c.1 (to be processed by troff -man or nroff -man).
  12.  
  13. libf77    Library of non I/O support routines the generated C may need.
  14.     Fortran main programs result in a C function named MAIN__ that
  15.     is meant to be invoked by the main() in libf77.
  16.  
  17. libi77    Library of Fortran I/O routines the generated C may need.
  18.     Note that some vendors (e.g., BSD, Sun and MIPS) provide a
  19.     libF77 and libI77 that are incompatible with f2c -- they
  20.     provide some differently named routines or routines with the
  21.     names that f2c expects, but with different calling sequences.
  22.     On such systems, the recommended procedure is to merge
  23.     libf77 and libi77 into a single library, say libf2c, and
  24.     install it where you can access it by specifying -lf2c .
  25.  
  26. f2c.ps    Postscript for a technical report on f2c.
  27.  
  28. fixes    The complete change log, reporting bug fixes and other changes.
  29.     (Some recent change-log entries are given below).
  30.  
  31. fc    A shell script that uses f2c and imitates much of the behavior
  32.     of commonly found f77 commands.  You will almost certainly
  33.     need to adjust some of the shell-variable assignments to make
  34.     this script work on your system.
  35.  
  36.  
  37. SUBDIRECTORY:
  38.  
  39. f2c/src    Source for the converter itself, including a file of checksums
  40.     and source for a program to compute the checksums (to verify
  41.     correct transmission of the source), is available: ask netlib to
  42.         send all from f2c/src
  43.     If the checksums show damage to just a few source files, or if
  44.     the change log file (see "fixes" below) reports corrections to
  45.     some source files, you can request those files individually
  46.     "from f2c/src".  For example, to get defs.h and xsum0.out, you
  47.     would ask netlib to
  48.         send defs.h xsum0.out from f2c/src
  49.     "all from f2c/src" is 649462 bytes long.
  50.  
  51.     Tip: if asked to send over 99,000 bytes in one request, netlib
  52.     breaks the shipment into 1000 line pieces and sends each piece
  53.     separately (since otherwise some mailers might gag).  To avoid
  54.     the hassle of reassembling the pieces, try to keep each request
  55.     under 99,000 bytes long.  The final number in each line of
  56.     xsum0.out gives the length of each file in f2c/src.  For
  57.     example,
  58.         send exec.c expr.c from f2c/src
  59.         send format.c format_data.c from f2c/src
  60.     will give you slightly less hassle than
  61.         send exec.c expr.c format.c format_data.c from f2c/src
  62.  
  63. NOTE:    For now, you may exercise f2c by sending netlib a message whose
  64.     first line is "execute f2c" and whose remaining lines are
  65.     the Fortran 77 source that you wish to have converted.
  66.     Return mail brings you the resulting C, with f2c's error
  67.     messages between #ifdef uNdEfInEd and #endif at the end.
  68.     (To understand line numbers in the error messages, regard
  69.     the "execute f2c" line as line 0.  It is stripped away by
  70.     the netlib software before f2c sees your Fortran input.)
  71.     Options described in the man page may be transmitted to
  72.     netlib by having the first line of input be a comment
  73.     whose first 6 characters are "c$f2c " and whose remaining
  74.     characters are the desired options, e.g., "c$f2c -R -u".
  75.     This scheme may change -- ask netlib to
  76.                send index from f2c
  77.         if you do not get the behavior you expect.
  78.  
  79.     During the initial experimental period, incoming Fortran
  80.     will be saved in a file.  Don't send any secrets!
  81.  
  82.  
  83. BUGS:    Please send bug reports (including the shortest example
  84.     you can find that illustrates the bug) to research!dmg
  85.     or dmg@research.att.com .
  86.  
  87.  
  88. NOTE:    f2c.h defines several types, e.g., real, integer, doublereal.
  89.     The definitions in f2c.h are suitable for most machines, but if
  90.     your machine has sizeof(double) > 2*sizeof(long), you may need
  91.     to adjust f2c.h appropriately.  f2c assumes
  92.         sizeof(doublecomplex) = 2*sizeof(doublereal)
  93.         sizeof(doublereal) = sizeof(complex)
  94.         sizeof(doublereal) = 2*sizeof(real)
  95.         sizeof(real) = sizeof(integer)
  96.         sizeof(real) = sizeof(logical)
  97.         sizeof(real) = 2*sizeof(shortint)
  98.     EQUIVALENCEs may not be translated correctly if these
  99.     assumptions are violated.
  100.  
  101.     There exists a C compiler that objects to the lines
  102.         typedef VOID C_f;    /* complex function */
  103.         typedef VOID H_f;    /* character function */
  104.         typedef VOID Z_f;    /* double complex function */
  105.     in f2c.h .  If yours is such a compiler, do two things:
  106.     1. Complain to your vendor about this compiler bug.
  107.     2. Find the line
  108.         #define VOID void
  109.        in f2c.h and change it to
  110.         #define VOID int
  111.     (For readability, the f2c.h lines shown above have had two
  112.     tabs inserted before their first character.)
  113.  
  114. FTP:    All the material described above is now available by anonymous
  115.     ftp from research.att.com -- look in dist/f2c .  You must
  116.     uncompress the .Z files once you have a copy of them, e.g., by
  117.         uncompress *.Z
  118.  
  119. -----------------
  120. Recent change log (partial)
  121. -----------------
  122.  
  123. Wed Oct 17 16:40:37 EDT 1990:
  124.   libf77, libi77: minor cleanups: _cleanup() and abort() invocations
  125. replaced by invocations of sig_die in main.c; some error messages
  126. previously lost in buffers will now appear.
  127.  
  128. Mon Oct 22 16:11:27 EDT 1990:
  129.   libf77: separate sig_die from main (for folks who don't want to use
  130. the main in libF77).
  131.   libi77: minor tweak to comments in README.
  132.  
  133. Fri Nov  2 13:49:35 EST 1990:
  134.   Use two underscores rather than one in generated temporary variable
  135. names to avoid conflict with COMMON names.  f2c.ps updated to reflect
  136. this change and the NAME= extension introduced 15 Oct.
  137.  
  138. Mon Nov  5 16:43:55 EST 1990:
  139.   libi77: changes to open.c (and err.c): complain if an open stmt
  140. specifies new= and the file already exists (as specified by Fortrans 77
  141. and 90); allow file= to be omitted in open stmts and allow
  142. status='replace' (Fortran 90 extensions).
  143.  
  144. Fri Nov 30 10:10:14 EST 1990:
  145.   Adjust malloc.c for unusual systems whose sbrk() can return values
  146. not properly aligned for doubles.
  147.   Arrange for slightly more helpful and less repetitive warnings for
  148. non-character variables initialized with character data; these warnings
  149. are (still) suppressed by -w66.
  150.  
  151. Fri Nov 30 15:57:59 EST 1990:
  152.   Minor tweak to README (about changing VOID in f2c.h).
  153.  
  154. Mon Dec  3 07:36:20 EST 1990:
  155.   Fix spelling of "character" in f2c.1t.
  156.  
  157. Tue Dec  4 09:48:56 EST 1990:
  158.   Remark about link_msg and libf2c added to f2c/README.
  159.  
  160. Thu Dec  6 08:33:24 EST 1990:
  161.   Under -U, render label nnn as L_nnn rather than Lnnn.
  162.  
  163. Fri Dec  7 18:05:00 EST 1990:
  164.   Add more names from f2c.h (e.g. integer, real) to the c_keywords
  165. list of names to which an underscore is appended to avoid confusion.
  166.  
  167. Current timestamps of files in "all from f2c/src", sorted by time,
  168. appear below (mm/dd/year hh:mm:ss).  To bring your source up to date,
  169. obtain source files with a timestamp later than the time shown in your
  170. version.c.  Note that the time shown in the current version.c is the
  171. timestamp of the source module that immediately follows version.c below:
  172.  
  173. 12/07/1990  17:42:16  xsum0.out
  174. 12/07/1990  17:37:53  version.c
  175. 12/07/1990  17:37:08  names.c
  176. 12/04/1990   9:45:48  README
  177. 12/03/1990   7:29:45  f2c.1
  178. 12/03/1990   7:14:26  f2c.1t
  179. 11/30/1990   9:47:48  data.c
  180. 11/15/1990  18:00:20  malloc.c
  181. 11/02/1990  13:43:50  io.c
  182. 10/15/1990  19:58:17  mem.c
  183.  9/27/1990  15:58:58  expr.c
  184.  9/04/1990  12:18:27  main.c
  185.  9/04/1990   9:49:23  proc.c
  186.  8/28/1990   1:09:28  format.c
  187.  7/26/1990  10:54:47  parse_args.c
  188.  7/26/1990  10:44:26  parse.h
  189.  6/27/1990   0:14:45  putpcc.c
  190.  6/26/1990  11:04:46  p1output.c
  191.  6/25/1990   7:21:11  makefile
  192.  6/19/1990   7:21:39  output.c
  193.  6/19/1990   7:21:38  lex.c
  194.  6/19/1990   0:18:23  formatdata.c
  195.  5/11/1990  14:17:04  error.c
  196.  4/29/1990   9:40:47  exec.c
  197.  4/23/1990  17:35:47  sysdep.h
  198.  4/23/1990  16:37:50  sysdep.c
  199.  4/18/1990  23:41:25  misc.c
  200.  4/18/1990  12:25:19  init.c
  201.  4/18/1990  12:25:19  pread.c
  202.  4/18/1990  12:25:18  cds.c
  203.  4/17/1990  23:24:07  defs.h
  204.  4/14/1990   9:32:00  niceprintf.c
  205.  4/10/1990   0:00:38  put.c
  206.  4/06/1990   0:00:57  gram.io
  207.  4/05/1990  23:40:09  gram.exec
  208.  4/05/1990  23:40:09  gram.expr
  209.  4/01/1990  15:44:01  equiv.c
  210.  3/27/1990  16:39:18  names.h
  211.  3/27/1990  10:05:15  p1defs.h
  212.  3/27/1990  10:05:14  defines.h
  213.  3/27/1990   7:54:52  gram.head
  214.  2/25/1990   9:04:30  vax.c
  215.  2/16/1990  17:29:40  gram.dcl
  216.  2/16/1990  10:37:27  tokens
  217.  2/15/1990  16:57:16  intr.c
  218.  2/14/1990   2:09:18  xsum.c
  219.  2/14/1990   2:00:20  format.h
  220.  2/14/1990   1:38:46  output.h
  221.  2/14/1990   0:54:06  iob.h
  222.  2/03/1990   0:58:26  niceprintf.h
  223.  1/29/1990  13:26:52  memset.c
  224.  1/20/1990  23:03:00  f2c.h
  225.  1/20/1990  22:54:23  safstrncpy.c
  226.  1/11/1990  18:02:51  ftypes.h
  227.  1/09/1990  16:50:45  Notice
  228.  1/07/1990   1:20:01  usignal.h
  229. 11/27/1989   8:27:37  machdefs.h
  230.  7/01/1989  11:59:44  pccdefs.h
  231.