NEWS

   1 Version 0.12 - UNRELEASED
   2
   3  End-user-visible changes
   4
   5  * Start of a renaming of the whole toolkit to DEPS (Dependency
   6    Extraction and Processing System), graph-includes being only the
   7    current user frontend.
   8
   9  * Graphs of grouped nodes now only include the defined groups.  The
  10    new --consolidate flag is now available to merge such graphs in a
  11    manner such that nodes of a given group-level, not included in any
  12    higher-level group, are shown as well.  As a side-effect, this flag
  13    also controls the highest group-level of the nodes to be drawn, in
  14    place of the --group flag.
  15
  16  * The --group flag to render groups as node clusters is not available
  17    any more.  It will come back in a later release, under a more suitable
  18    name.
  19
  20  * The documentation previously found in the README file is now
  21    available in DocBook XML format, in the doc/ directory.
  22
  23  Bugs fixed:
  24
  25  * Fixed the uniqueincludes project class, which has been broken since
  26    the 0.6 reorganization.
  27
  28  * Calculation of edge weights was wrong.
  29
  30  Changes for the class writer:
  31
  32  * A project is now made of a set of graphs, themselves connected as a
  33    graph representing the transformations used to produce them from the
  34    other graphs.  Most APIs changed consequently.
  35
  36  * Projects are now expected to provide a nlevels() method matching
  37    the number of grouping levels defined, and the filelabel() methods
  38    are now allowed to return undef when a node does not belong to any
  39    group at the requested level.
  40
  41  * Arbitrary transformations and styles can now be defined, although
  42    no facility is provided yet by the master graph-includes script to
  43    apply them, short of editing the script.  Currently available
  44    transformations are "compatgroup" (use the old filelabel() mechanism
  45    to define grouping levels), "consolidate" (merge several group levels
  46    in a single graph to show non-grouped nodes as well), and
  47    "transitivereduction".  The only currently available styler allows to
  48    apply style attributes (like colors) to a node according to the group
  49    it belongs to at a given grouping level.
  50
  51  Under the hood:
  52
  53  * Objects now get their hash locked in the constructors, to catch
  54    typos, unwanted modifications, and other errors likely to occur
  55    during subsequent refactorings.
  56
  57  * Introduced graph, node, and edge objects (splitted out from
  58    project, along with relevant methods).  A project now has a stack
  59    of graphs.
  60
  61  * Many other changes, fixing some bugs, and introducing brand new ones.
  62
  63 ==================================================
  64
  65 Version 0.11 - 2005-12-06
  66
  67  End-user-visible changes
  68
  69  * Generalized support for node coloring, with renderer::dot
  70    supporting 2 coloring levels (background and outline)
  71
  72  * Improved portability to non-UNIX platforms, was successfully run on
  73    win32.
  74
  75  * The C extractor now looks in for system headers in /usr/include by
  76    default.
  77
  78  * The Perl extractor uses the default @INC value to locate system
  79    headers.
  80
  81  Changes for the class writer:
  82
  83  * Per-language extractors can now declare a default system-include
  84    path.
  85
  86  Bugs fixed:
  87
  88  * The --color flag was broken.
  89
  90 ==================================================
  91
  92 Version 0.10 - 2005-11-29
  93
  94  End-user-visible changes
  95
  96  * Added a --renderer flag to select another renderer than dot.
  97
  98  * Added preliminary support to use tulip as renderer.
  99
 100 ==================================================
 101
 102 Version 0.9.2 - 2005-11-2
 103
 104  * Start of a "tutorial" or "how to use" section in the doc.
 105
 106  * Explicitely written down the plan for the upcoming redesign.
 107
 108 ==================================================
 109
 110 Version 0.9.1 - 2005-06-01
 111
 112  Bugs fixed:
 113
 114  * Fixed a typo preventing the recursive search to see .c and .h
 115    files.
 116
 117 ==================================================
 118
 119 Version 0.9 - 2005-06-01
 120
 121  Bugs fixed:
 122
 123  * Now fails nicely when no dependencies are found for any reason.
 124
 125  Other end-user-visible changes
 126
 127  * Command-line and version are now logged in the report file.
 128
 129  * New --version flag.
 130
 131  * Can now be run from source dir with no effort.
 132
 133  * Exit with usage on command-line.
 134
 135  * Updated usage summary with recent options.
 136
 137 ==================================================
 138
 139 Version 0.8 - 2005-05-26
 140
 141  End-user-visible changes
 142
 143  * Directory arguments are now searched for files, allowing to handle
 144    projects with a large number of files.
 145
 146  * New --fileregexp option to override the per-language regexp used to
 147    look for files inside directories.
 148
 149  * More statistics are available in the report file.
 150
 151  Changes for the class writer:
 152
 153  * extractors' getdeps methods cannot rely any more on @ARGV
 154    containing the files list, and must get it from the FILES instance
 155    variable.
 156
 157 ==================================================
 158
 159 Version 0.7 - 2005-05-10
 160
 161  Bugs fixed:
 162
 163  * The '.graph-includes.report' suffix used when using --output did
 164    not include the first dot.
 165
 166  Other end-user-visible changes
 167
 168  * Visible edges are now labelled with the number of real dependencies
 169    they represent, so we have some visual feedback of transitive
 170    reduction.
 171
 172  * Huge performance boost for the transitive reduction.
 173
 174  * When cycles are present, the specific reduction selected is usually
 175    a different one than in 0.6.1 and below, as a side-effect of
 176    implementation changes.
 177
 178  * More documentation has been written.
 179
 180  Changes for the class writer:
 181
 182  * project::record_missing_dep was split out of project::record_dep.
 183
 184  * Dependencies are now stored in a hash instead of an array.
 185
 186  * The "label" special_edge attribute is now an array of strings, to
 187    be presented on several lines.
 188
 189 ==================================================
 190
 191 Version 0.6.1 - 2005-04-26
 192
 193  Bugs fixed:
 194
 195  * Fixed the distribution which misses the C and perl extractors.
 196
 197 ==================================================
 198
 199 Version 0.6 - 2005-04-24
 200
 201  Bugs fixed:
 202
 203  * A typo in the graphincludes::params package prevented the
 204    parameters default values to be used.
 205
 206  Command-line changes:
 207
 208  * New --language flag to select syntax of source files.
 209
 210  * Preliminary support for extracting perl dependencies, using
 211    "--language perl"
 212
 213  Changes for the class writer:
 214
 215  * C-specific behaviour is now located in new extractor::C class.
 216
 217  * Changed special_edge() return value to an hash of graphviz node
 218    attribute/value pairs
 219
 220  * More methods were moved from project::default up to ancestor
 221    classes.
 222
 223 ==================================================
 224
 225 Version 0.5 - 2005-04-20
 226
 227  Command-line changes:
 228
 229  * --Include is now recognized as long form for -I.
 230
 231  * New --sysInclude option to specify system directories.  Included
 232    files not found in the project, but found in those directories are
 233    not considered as "not found".
 234
 235  Other end-user-visible changes
 236
 237  * Removed inconditional duplicate warnings flooding the output.
 238
 239  * Verbose diagnostics are now output unconditionally into a
 240    graph-includes.report (or <file>.graph-includes.report) file.
 241
 242  Changes for the class writer:
 243
 244  * The constructor for the project classes now uses named parameters,
 245    instead of positional parameters.
 246  * Global parameters were moved to a new graphincludes::params package.
 247
 248 ==================================================
 249
 250 Version 0.4 - 2005-04-17
 251
 252  Command-line changes:
 253
 254  * Implemented cpp-like "-I <dir>" syntax for #include lookup,
 255    dropping the infamous former ad-hoc heuristic.
 256
 257  Other end-user-visible changes
 258
 259  * `#include "..."' are now analyzed using the standard cpp semantics,
 260    and `#include <...>' line are now considered as well.
 261
 262  Under the hood
 263
 264  * Many code cleanups.
 265
 266 ==================================================
 267
 268 Version 0.3 - 2005-04-14
 269
 270  Bugs fixed:
 271
 272  * Fixed a bug in the ad-hoc #include resolver which caused some
 273    dependencies to be ignored
 274
 275  Command-line changes:
 276
 277  * New --paper option to get a graph printable on paper (for now, only
 278    a4, a3 and letter)
 279
 280  Other end-user-visible changes
 281
 282  * More documentation has been written.
 283
 284 ==================================================
 285
 286 Version 0.2 - 2005-04-01
 287
 288  Bugs fixed:
 289
 290  * --output would reject its argument.
 291
 292  * --focus and --showdropped caused invalid output.
 293
 294  Command-line changes:
 295
 296  * New --prefixstrip option to make the graph more readable by
 297    stripping a common prefix from all filenames.
 298
 299  * Obsolete (pre 0.1 !) --allfiles option was completely dropped.
 300
 301  Other end-user-visible changes
 302
 303  * More documentation has been written.
 304
 305  * The default project-class (and the sample wesnoth class) now
 306    provide default singleton level-2 groups (so "--group 2-2" should
 307    work on all projects).
 308
 309  Changes for the class writer:
 310
 311  * The tool expect a project class to build its dependency graph in an
 312    init() method, instead of in the constructor.
 313
 314  * The project class constructor now takes an additional prefixstrip
 315    argument.  More changes to come in this area to cause such changes
 316    to be less disruptive in the future.
 317
 318  * A project class can now specify excuses for abusive dependencies,
 319    to be shown in as edges of a different color, and with the excuse
 320    as a label.
 321
 322 ==================================================
 323
 324 Version 0.1 - 2005-03-28
 325
 326  Initial public release.