Research V7 development

Work on file usr/man/man1/ratfor.1

Synthesized-from: v7

diff --git a/usr/man/man1/ratfor.1 b/usr/man/man1/ratfor.1
new file mode 100644 (file)
index 0000000..7dab36e
--- /dev/null
+++ b/usr/man/man1/ratfor.1
@@ -0,0 +1,79 @@
+.TH RATFOR 1
+.SH NAME
+ratfor \- rational Fortran dialect
+.SH SYNOPSIS
+.B ratfor
+[ option ... ]
+[ filename ... ]
+.SH DESCRIPTION
+.I Ratfor
+converts a rational dialect of Fortran into ordinary irrational Fortran.
+.I Ratfor
+provides control flow constructs essentially identical to those in C:
+.TP
+statement grouping:
+.nf
+{ statement; statement; statement }
+.TP
+decision-making:
+if (condition) statement [ else statement ]
+.br
+switch (integer value) {
+       case integer:   statement
+       ...
+       [ default: ]    statement
+}
+.TP
+loops:
+while (condition) statement
+for (expression; condition; expression) statement
+do limits statement
+repeat statement [ until (condition) ]
+break [n]
+next [n]
+.LP
+and some syntactic sugar to make programs easier to read and write:
+.TP
+free form input:
+multiple statements/line; automatic continuation
+.TP
+comments:
+# this is a comment
+.TP
+translation of relationals:
+>, >=, etc., become .GT., .GE., etc.
+.TP
+return (expression)
+returns expression to caller from function
+.TP
+define:
+define name replacement
+.TP
+include:
+include filename
+.PP
+.fi
+The option
+.B \-h
+causes quoted strings to be turned into
+27H constructs.
+.B \-C
+copies comments to the output, and attempts
+to format it neatly.
+Normally, continuation lines are marked with a &
+in column 1;
+the option
+.B \-6x
+makes the continuation character
+.B x
+and places it in column 6.
+.PP
+.I Ratfor
+is best used with
+.IR f77 (1).
+.SH "SEE ALSO"
+f77(1)
+.br
+B. W. Kernighan and P. J. Plauger,
+.IR "Software Tools" ,
+Addison-Wesley, 1976.