NEWS

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