NEWS

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