141 lines
4.4 KiB
Text
141 lines
4.4 KiB
Text
$NetBSD: patch-ab,v 1.3 2001/04/13 01:28:01 jtb Exp $
|
|
|
|
--- ratfor.man.orig Sun Feb 14 02:05:24 1999
|
|
+++ ratfor.man
|
|
@@ -1,21 +1,29 @@
|
|
-NAME
|
|
- ratfor77 - ratfor preprocessor for fortran77
|
|
-
|
|
-SYNOPSIS
|
|
- ratfor [-l n] [-C] [-o output] input
|
|
-
|
|
-PARAMETERS
|
|
- -l n user sets strating label n
|
|
- -o output specify output file, otherwise it is stdout
|
|
- -C keep comments in (useful for compiler directives)
|
|
-
|
|
-
|
|
-DESCRIPTION
|
|
+.Dd February 1, 2001
|
|
+.Dt RATFOR 1
|
|
+.Os
|
|
+.Sh NAME
|
|
+.Nm ratfor
|
|
+.Nd Preprocessor for Rational Fortran
|
|
+.Sh SYNOPSIS
|
|
+.Nm
|
|
+.Op Fl l Ar n
|
|
+.Op Fl C
|
|
+.Op Fl o Ar output
|
|
+.Ar input
|
|
+.Sh PARAMETERS
|
|
+.Bl -tag -width Ar
|
|
+.It Fl l Ar n
|
|
+user sets starting label n
|
|
+.It Fl o Ar output
|
|
+specify output file, otherwise it is stdout
|
|
+.It Fl C
|
|
+keep comments in (useful for compiler directives)
|
|
+.Sh DESCRIPTION
|
|
Ratfor has the following syntax:
|
|
-
|
|
+.Pp
|
|
prog: stat
|
|
prog stat
|
|
-
|
|
+.Pp
|
|
stat: if (...) stat
|
|
if (...) stat else stat
|
|
while (...) stat
|
|
@@ -30,11 +38,11 @@
|
|
digits stat
|
|
{ prog } or [ prog ] or $( prog $)
|
|
anything unrecognizable
|
|
-
|
|
+.Pp
|
|
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.
|
|
+terminated by an end-of-line or a semicolon. The following
|
|
+translations are also performed.
|
|
|
|
< .lt. <= .le.
|
|
== .eq.
|
|
@@ -42,39 +50,56 @@
|
|
>= .ge. > .gt.
|
|
| .or. & .and.
|
|
! .not. ^ .not. ~ .not.
|
|
-
|
|
+.Pp
|
|
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 converted
|
|
the equivalent decimal value using multiplication; this may cause sign
|
|
problems if the number has too many digits.
|
|
-
|
|
+.Pp
|
|
String literals ("..." or '...') can be continued across line boundaries
|
|
by ending the line to be continued with an underline. The underline is
|
|
not included as part of the literal. Leading blanks and tabs on the
|
|
next line are ignored; this facilitates consistent indentation.
|
|
-
|
|
+.Pp
|
|
include file
|
|
-
|
|
+.Pp
|
|
will include the named file in the input.
|
|
-
|
|
+.Pp
|
|
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.
|
|
-
|
|
+.Pp
|
|
+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.
|
|
+.Pp
|
|
string name "character string" or
|
|
string name(size) "character string"
|
|
-
|
|
-defines name to be an integer array long enough to accomodate 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 spp
|
|
-
|
|
+.Pp
|
|
+defines name to be an integer array long enough to accomodate 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.
|
|
+.Pp
|
|
+.Sh SEE ALSO
|
|
+.Xr f77 1 ,
|
|
+.Xr f2c 1
|
|
+.Pp
|
|
+.Sh HISTORY
|
|
+Derived from a preprocessor distributed by the University of Arizona
|
|
+(not derived from AT&T code). Closely corresponds to the preprocessor
|
|
+described in the "SOFTWARE TOOLS" book.
|
|
+.Pp
|
|
+.Sh BUGS
|
|
+The switch statment switches on an integer valued expression. It
|
|
+should switch on an integer variable. The reason is that "implicit
|
|
+undefined" "implicit null" is unusable because the switch is done on a
|
|
+new variable that is not declared or declarable by the programmer who
|
|
+cannot guess its name. (This is not really a bug but a design error in
|
|
+both AT&T ratfor and this public domain ratfor).
|
|
+.Pp
|
|
+.Sh COPYING
|
|
+This code is in the public domain. In other words, all rights
|
|
+are granted to all recipients, the public at large.
|