1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
|
<HTML>
<HEAD>
<TITLE>Option: calltree</TITLE>
</HEAD>
<BODY>
<A HREF="toc.html">Table of Contents</A><P>
<P>Previous: <A HREF="array.html">-array</A><HR><P>
<H2>Option: <font color=#FF0080>calltree</font></H2><P>
<A NAME="calltree"></A><DT><B><A HREF="calltree.html">-calltree</A>=</B><I>list</I> </DT>
<DD>Causes <B>ftnchek </B> to print out the call structure
of the complete program. <blockquote></DD>
</DL>
<P>
The <I>list </I> consists of keywords separated by commas
or colons. There are two special keywords: <B>none </B> to turn off all the options,
and <B>help </B> to print the list of all the keywords with a brief explanation
of each. (The keyword <B>all </B> turns on all the options, but should not normally
be used since only one format should be specified.) If <I>list </I> is omitted,
<B><A HREF="calltree.html">-calltree</A> </B> is equivalent to <B><A HREF="calltree.html">-calltree</A>=tree </B>, and <B>-nocalltree </B> is equivalent
to <B><A HREF="calltree.html">-calltree</A>=none </B>. By default no call graph is printed. <P>
The keywords which
control which format is used are as follows:
<DL>
<DT><B>tree</B>: </DT>
<DD>produce the call graph
in tree format. </DD>
<DT><B>reference</B>: </DT>
<DD>produce the call graph in who-calls-who format
(same as <B><A HREF="reference.html">-reference</A> </B> switch). </DD>
<DT><B>vcg</B>: </DT>
<DD>produce the call graph in VCG format
(same as <B><A HREF="vcg.html">-vcg</A> </B> switch). </DD>
</DL>
<P>
Only one of the formats <B>tree </B>, <B>reference </B>, or <B>vcg
</B> may be specified. <P>
The following keywords control options affecting the
output:
<DL>
<DT><B>prune</B>: </DT>
<DD>prune repeated subtrees (applicable only with <B>tree </B>).
This the default. </DD>
<DT><B>sort</B>: </DT>
<DD>sort children of each routine into alphabetical
order. This is the default. </DD>
</DL>
<P>
See the discussion of the <B><A HREF="reference.html">-reference</A> </B> and <B><A HREF="vcg.html">-vcg</A>
</B> flags for details about these formats. <P>
For <B>tree </B> format, The call graph
is printed out starting from the main program, which is listed on the
first line at the left margin. Then on the following lines, each routine
called by the main program is listed, indented a few spaces, followed
by the subtree starting at that routine. <P>
In the default mode, if a routine
is called by more than one other routine, its call subtree is printed
only the first time it is encountered Later calls give only the routine
name and the notice ``(see above)''. To have the subtree printed for each occurrence
of the routine, use option <B>no-prune </B>. <P>
Note that the call tree will be incomplete
if any of the input files are project files containing more than one module
that were created in <B><A HREF="library.html">-library</A> </B> mode. See the discussion of project files
below. <P>
Technical points: Each list of routines called by a given routine
is printed in alphabetical order unless the <B>no-sort </B> option is given. If
multiple main programs are found, the call tree of each is printed separately.
If no main program is found, a report to that effect is printed out, and
the call trees of any top-level non-library routines are printed. This flag
only controls the printing of the call tree: <B>ftnchek </B> constructs the call
tree in any case because it is used to determine which library modules
will be cross-checked. See the discussion of the <B><A HREF="library.html">-library</A> </B> flag. <P>
For compatibility
with previous versions of <B>ftnchek </B>, a numeric form of this setting is
also accepted: the <I>list </I> is replaced by a number from 0 to 15. This number
is formed from 1 for <B>tree </B> format, 2 for <B>reference </B> format, or 3 for <B>vcg
</B> format, plus 4 for <B>no-prune </B>, and 8 for <B>no-sort </B>. <P>
See also: <B><A HREF="crossref.html">-crossref</A> </B>, <B><A HREF="library.html">-library</A>
</B>, <B><A HREF="reference.html">-reference</A> </B>, <B><A HREF="sort.html">-sort</A> </B>, <B><A HREF="symtab.html">-symtab</A> </B>, <B><A HREF="vcg.html">-vcg</A> </B>. </blockquote>
<P>
<DL>
<P><HR><P>Next: <A HREF="check.html">-check</A>
</BODY></HTML>
|
