Debian Codegraph @

NEWS

raw
1 GNU cflow NEWS -- history of user-visible changes. 2025-07-30
2 See the end of file for copying conditions.
3
4 Please send cflow bug reports to <[email protected]>.
5
6 Version 1.8, 2025-07-30
7
8 * Configuration system rewritten
9
10 Cflow is shipped with a set of "profiles", providing defaults for
11 different standards of the C language. For example, to enable support
12 for gcc extensions it suffices to load the "gcc" profile:
13
14 cflow --profile=gcc
15
16 Users can define their own profiles and place them in a well-known
17 disk location for further use with the --profile option.
18
19 Site-wide or user-specific settings can be stored in the default
20 profile, which is always loaded.
21
22 Two options are provided for managing profiles: --prepend-path
23 modifies the profile search path and -q disables the use of the
24 default profile.
25
26 The configuration system used in previous versions (via the
27 CFLOW_OPTIONS and CFLOWRC environment variables) is considered
28 deprecated, but is still supported for backward compatibility.
29
30 * Emacs cflow-mode improved
31
32 * Bugfixes
33
34
35 Version 1.7, 2021-12-30
36
37 * Multiple start functions are allowed
38
39 The '--main' option can be given multiple times. A separate graph
40 will be drawn for each function given as its argument.
41
42 * New option --target=FUNCTION
43
44 If this option is given, the produced graph will contain only paths
45 leading from start function (or functions) to the given FUNCTION.
46
47 Multiple '--target' options are allowed.
48
49 * New output format: dot
50
51 The '-f dot' (or '--format=dot') option instructs cflow to output
52 graph as a description in DOT language, suitable as input to graphviz
53 programs.
54
55 * cflow-mode: new commands for navigating in the graph:
56
57 c go to the calling function
58 n go to the next function at the same nesting level
59 p go to the previous function at the same nesting level
60
61 * Bugfixes:
62
63 ** CVE-2019-16165
64 ** CVE-2019-16166
65 ** Fix parsing of K&R style function declarations
66 ** Improve parsing of typecasts
67 ** Fix recursive call detection
68
69
70 Version 1.6, 2019-02-23
71
72 * New option --all (-A)
73
74 Produce graphs for all global functions in the program. Use this
75 option if your program contains functions which are not directly
76 reachable from main().
77
78 The output consist of separate flow graphs for each global function
79 defined in the program. These graphs will be placed after the graph
80 for main() (if it exists), and will be ordered lexicographically by
81 the function name.
82
83 * New option --no-main
84
85 This option has the same effect as '--all', except that the graph for
86 main() function (if it exists) is treated same way as all the other
87 graphs, i.e. it will not be placed at the top of output, but in its
88 place as per the lexicographic ordering of function names.
89
90
91 Version 1.5, 2016-05-17
92
93 * Correctly handle functions returning struct/union (fixes bug #31792)
94 * Gracefully handle invalid inputs (fixes bug #44113)
95 * Debugging output goes to stderr
96 * Add a manpage
97 * Consistent use of exit codes
98
99
100 Version 1.4, 2011-10-11
101
102 * Symbol aliases
103
104 The `--symbol' option has been extended to allow for defining
105 symbol aliases. Aliases are useful for declaring reserved
106 words such as `__restrict' or `__inline'. For example,
107 the option `--symbol __restrict:=restrict' instructs cflow
108 to treat `__restrict' exactly as `restrict'.
109
110 * New syntactic class: qualifiers
111
112 Tokens in this class can legitimately appear in place
113 of C qualifiers, such as `static' or `inline'. This class
114 is useful for some compiler-depending keywords, such as
115 `__extension__' in gcc. The usual declaration of this symbol
116 is `--symbol __extension__:qualifier'.
117
118 * Speed up recursive call detection.
119
120 * Fix parsing of typedefs after `struct'.
121 * Fix the output of branch marks in tree mode.
122 * Fix processing of static inline functions (RH bug 650716).
123
124
125 Version 1.3, 2009-07-11
126
127 * Optimize symbol tables.
128
129 New symbol tables considerably improve the program performance.
130
131 * Bugfixes.
132
133
134 Version 1.2, 2007-06-29
135
136 * Licensed under the GPLv3
137
138
139 Version 1.1, 2006-07-09
140
141 * Bugfixes:
142 ** Fix stack overflow on erroneous nameless function arguments.
143 ** Fix global/static and static/static name clashes.
144 ** Fix initial allocation for level mark array
145
146 * New localization: Danish and Vietnamese
147
148
149 Version 1.0, 2005-10-15
150
151 * First official release.
152
153
154 Version 0.2.3:
155
156 * Finished documentation.
157
158 * Added `--no-' options.
159
160
161 Version 0.2.2:
162
163 * Added testsuite
164
165 * New option --number=N (-nN) - print line numbers along with the flow tree
166 (default in POSIX mode)
167
168 * Added localization support. New localizations: Polish and Ukrainian.
169
170
171 Version 0.2:
172
173 * Added autoconf suite.
174 * Added POSIX output support.
175
176
177 Version 0.1:
178
179 Initial version restored from 1997 snapshots.
180
181
182 ----------------------------------------------------------------------
183 * Copyright information:
184
185 Copyright (C) 2005-2025 Sergey Poznyakoff
186
187 Permission is granted to anyone to make or distribute verbatim copies
188 of this document as received, in any medium, provided that the
189 copyright notice and this permission notice are preserved,
190 thus giving the recipient permission to redistribute in turn.
191
192 Permission is granted to distribute modified versions
193 of this document, or of portions of it,
194 under the above conditions, provided also that they
195 carry prominent notices stating who last changed them.
196
197 Local variables:
198 mode: outline
199 paragraph-separate: "[ ]*$"
200 eval: (add-hook 'write-file-hooks 'time-stamp)
201 time-stamp-start: "changes. "
202 time-stamp-format: "%:y-%02m-%02d"
203 time-stamp-end: "\n"
204 end: