Return to struct.1 CVS log

Up to [Research Unix] / researchv10dc / man / mana

Annotation of researchv10dc/man/mana/struct.1, revision 1.1.1.1

1.1       root        1: .TH STRUCT 1
                      2: .SH NAME
                      3: struct \- structure Fortran programs
                      4: .SH SYNOPSIS
                      5: .B struct
                      6: [
                      7: .I option ...
                      8: ]
                      9: .I file
                     10: .SH DESCRIPTION
                     11: .LP
                     12: .I Struct
                     13: translates the Fortran program specified by
                     14: .I file
                     15: (standard input default)
                     16: into a Ratfor program.
                     17: Wherever possible, Ratfor control constructs
                     18: replace the original Fortran.
                     19: Statement numbers appear only where still necessary.
                     20: Cosmetic changes are made, including changing Hollerith strings
                     21: into quoted strings
                     22: and relational operators into symbols (e.g.\&
                     23: .L .GT.
                     24: into
                     25: .LR > ).
                     26: The output is appropriately indented.
                     27: .PP
                     28: The following options may occur in any order.
                     29: .TP
                     30: .B  -s
                     31: Input uses standard Fortran comment and continuation conventions.
                     32: Normally input is in the form accepted by
                     33: .IR f77 (1)
                     34: .TP
                     35: .B  -i
                     36: Do not turn computed goto statements into
                     37: switches.
                     38: (Ratfor does not turn switches back
                     39: into computed goto statements.)
                     40: .TP
                     41: .B  -a
                     42: Turn sequences of else ifs into a
                     43: non-Ratfor switch of the form
                     44: .IP
                     45: .EX
                     46: switch
                     47:        {       case pred1: code
                     48:                case pred2: code
                     49:                case pred3: code
                     50:                default: code
                     51:        }
                     52: .EE
                     53: .IP
                     54: The case predicates are tested in order;
                     55: the code appropriate to only one case is executed.
                     56: This generalized form of switch statement does not
                     57: occur in Ratfor.
                     58: .TP
                     59: .B  -b
                     60: Generate goto's instead of multilevel break statements.
                     61: .TP
                     62: .B  -n
                     63: Generate goto's instead of multilevel next statements.
                     64: .TP
                     65: .BI -t n
                     66: Make
                     67: the nonzero integer
                     68: .I n
                     69: the lowest valued label in the output program
                     70: (default 10).
                     71: .TP
                     72: .BI -c n
                     73: Increment successive labels
                     74: in the output program
                     75: by the nonzero integer
                     76: .I n
                     77: (default 1).
                     78: .TP
                     79: .BI -e n
                     80: If
                     81: .I n
                     82: is 0 (default),
                     83: place code within a loop only if it can
                     84: lead to an iteration of the loop.
                     85: If
                     86: .I n
                     87: is nonzero,
                     88: admit a small code segment to a loop
                     89: if otherwise the loop would have exits to several places including the segment,
                     90: and the segment can be reached only from the loop.
                     91: `Small' is close to, but not equal to, the
                     92: number of statements in the code segment.
                     93: Values of
                     94: .I n
                     95: under 10 are suggested.
                     96: .SH FILES
                     97: .F /tmp/struct*
                     98: .br
                     99: .F /usr/lib/struct/*
                    100: .SH SEE ALSO
                    101: .IR f77 (1), 
                    102: .IR ratfor (A)
                    103: .br
                    104: B. S. Baker,
                    105: `An Algorithm for Structuring Flowgraphs',
                    106: .I JACM
                    107: .B 24 
                    108: (1977) 376-391
                    109: .SH BUGS
                    110: Struct knows Fortran 66 syntax, but not full Fortran 77.
                    111: .br
                    112: If an input Fortran program contains identifiers which
                    113: are reserved words in Ratfor, the structured
                    114: version of the program
                    115: will not be a valid Ratfor program.
                    116: .br
                    117: The labels generated cannot go above 32767.
                    118: .br
                    119: If you get a goto without a target, try
                    120: .BR -e .

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.