RATFOR(1)						      General Commands Manual							 RATFOR(1)

NAME

       ratfor - ratfor preprocessor for Fortran 77

SYNOPSIS

       ratfor [-l n] [-C] [-o outputfile] filename

PARAMETERS

       -l n    Set starting label number.

       -o output
	       Specify output file; default is stdout.

       -C      Keep comments in (useful for compiler directives).

       -?      Show summary of options.

DESCRIPTION

       Ratfor has the following syntax:

       prog:   stat
	       prog stat

       stat:   if (...) stat
	       if (...) stat else stat
	       while (...) stat
	       repeat stat
	       repeat stat until (...)
	       for (...;...;...) stat
	       do ... stat
	       switch (intexpr) { case val[,val]: stmt ... default: stmt }
	       break n
	       next n
	       return (...)
	       digits stat
	       { prog }  or  [ prog ]  or  $( prog $)
	       anything unrecognizable

       where stat is any Fortran or Ratfor statement, and intexpr is an expression that resolves into an integer value.  A statement is terminated
       by an end-of-line or a semicolon.  The following translations are also performed.

	       <       .lt.    <=      .le.
	       ==      .eq.
	       !=      .ne.    ^=      .ne.    ~=      .ne.
	       >=      .ge.    >       .gt.
	       |       .or.    &       .and.
	       !       .not.   ^       .not.   ~       .not.

       Integer constants in bases other that decimal may be specified as n%dddd...  where n is a decimal number indicating the	base  and  dddd...
       are  digits  in	that  base.  For bases > 10, letters are used for digits above 9.  Examples:  8%77, 16%2ff, 2%0010011.	The number is con-
       verted the equivalent decimal value using multiplication; this may cause sign problems if the number has too many digits.

       String literals ("..." or '...') can be continued across line boundaries by ending the line to be continued with an underline.  The  under-
       line  is  not  included as part of the literal.	Leading blanks and tabs on the next line are ignored; this facilitates consistent indenta-
       tion.

	       include file

       will include the named file in the input.

	       define (name,value)     or
	       define name value

       defines name as a symbolic parameter with the indicated value.  Names of symbolic parameters may  contain  letters,  digits,  periods,  and
       underline character but must begin with a letter (e.g.  B.FLAG).  Upper case is not equivalent to lower case in parameter names.

	       string name "character string"	       or
	       string name(size) "character string"

       defines name to be an integer array long enough to accommodate the ASCII codes for the given character string, one per word.  The last word
       of name is initialized to the symbolic parameter EOS, and indicates the end of string.

KEYWORDS

       ratfor fortran preprocessor fortran77 ratfor77

								     Jun 1996								 RATFOR(1)