NEWS

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