NEWS

   1 ============================
   2 bzr-fastimport Release Notes
   3 ============================
   4
   5 .. contents::
   6
   7 In Development
   8 ==============
   9
  10 Compatability Breaks
  11 --------------------
  12
  13 New Features
  14 ------------
  15
  16 * The fast-import command now takes an optional but recommended
  17   DESTINATION argument. A repository will be created at this
  18   location and branches will be created within there. If the user
  19   is running bzr 1.17 up to 2.0, format "2a" is used for these,
  20   otherwise the default format is used. A format can be explicitly
  21   given using the new --format option. (Ian Clatworthy)
  22
  23 * Wrapper commands simplifying the generation of fast-import
  24   files from other tools are now provided. The general usage is:
  25
  26     bzr fast-export-from-xxx SOURCE project.fi
  27
  28   Before starting an export, these commands make an effort to
  29   check that dependent tools are installed. So far, wrapper
  30   commands are available for cvs, darcs, git, hg (Mercurial),
  31   mnt (Monotone), p4 (Perforce) and svn (Subversion).
  32   (Ian Clatworthy, Matt McClure)
  33
  34 * darcs-fast-export is now bundled. In fact, the project has
  35   merged into this one for the purposes of ongoing bug fixing
  36   and development. (Miklos Vajna)
  37
  38 * fast-export now supports a --no-plain parameter which causes
  39   richer metadata to be included in the output using the
  40   recently agreed 'feature' extension capability. The features
  41   used are called multiple-authors, commit-properties and
  42   empty-directories. (Ian Clatworthy)
  43
  44 * fast-import and fast-import-filter now support user mapping
  45   via the new --user-map option. The argument is a file specifying
  46   how user-ids should be mapped to preferred user-ids.
  47   (Ian Clatworthy)
  48
  49 * svn-fast-export now supports an address option (to control the
  50   default email domain) and a first-rev option (to select revisions
  51   since a given one). (Ted Gould)
  52
  53 Improvements
  54 ------------
  55
  56 * Large repositories now compress better thanks to a change in
  57   how file-ids are assigned. (Ian Clatworthy, John Arbash Meinel)
  58
  59 * If a fast-import source ends in ".gz", it is assumed to be in
  60   gzip format and the stream is implicitly uncompressed. This
  61   means fast-import dump files generated by fast-export-from-xxx
  62   can be stored gzipped to save space. (Ian Clatworthy)
  63
  64 * The working tree is now implicitly updated for trunk. Other
  65   branches still need to be explicitly created using 'bzr update'.
  66   (Ian Clatworthy)
  67
  68 * Directories that become empty following a delete or rename of
  69   one of their children are now implicitly pruned. If required,
  70   this will be made optional at a later date.
  71   (Tom Widmer, Ian Clatworthy)
  72
  73 * Blob tracking is now more intelligently done by an implicit
  74   first pass to collect blob usage statistics. This eliminates
  75   the need for an explicit 2-step process in all cases except
  76   where stdin is used as the input source. (Ian Clatworthy)
  77
  78 * Updated the bundled version of hg-fast-export to be the latest
  79   code (25-May-2009) from http://repo.or.cz/w/fast-export.git.
  80   (Ian Clatworthy)
  81
  82 Bug Fixes
  83 ---------
  84
  85 * Fixed the format used to create branches in a shared repository.
  86   It now selects the best branch format based on the repository
  87   format, rather than assume the default branch format is the right
  88   one. (Ian Clatworthy)
  89
  90 * Fixed inventory delta generation when deleting directories.
  91   (Previously the child paths included were relative to the
  92   directory when they ought to be relative to the root.)
  93   (Ian Clatworthy)
  94
  95 * Gracefully handle email addresses with unicode characters.
  96   (Ian Clatworthy)
  97
  98 * Gracefully handle an empty input stream. (Gonéri Le Bouder)
  99
 100 * Gracefully handle git submodules by ignoring them.
 101   (Ian Clatworthy)
 102
 103 * Get git-bzr working again. (Gonéri Le Bouder)
 104
 105 Documentation
 106 -------------
 107
 108 * Improved documentation has been published in the Bazaar Data Migration
 109   Guide: http://doc.bazaar-vcs.org/migration/en/data-migration/.
 110
 111 Testing
 112 -------
 113
 114 Internals
 115 ---------
 116
 117
 118 0.8 22-Jul-2009
 119 ===============
 120
 121 Compatibility Breaks
 122 --------------------
 123
 124 * ``exporters/bzr-fast-export`` has been replaced with a
 125   ``fast-export`` command. Some minor issues have been
 126   fixed at the same time: the first commit now goes into
 127   refs/heads/master (not refs/head/tmp); there's no
 128   checkpoint at the top of the stream; parent commits are
 129   now always given lower mark numbers than the commits they
 130   are merged into. (Ian Clatworthy)
 131
 132 * The ``fast-import`` command now uses a different mapping of
 133   git reference names to bzr branch names. In summary:
 134
 135   * ``refs/heads/foo`` is mapped to ``foo``
 136   * ``refs/remotes/origin/foo`` is mapped to ``foo.remote``
 137   * ``refs/tags/foo`` is mapped to ``foo.tag``
 138   * ``*/master`` is mapped to ``trunk``, ``trunk.remote``, etc.
 139   * ``*/trunk`` is mapped to ``git-trunk``, ``git-trunk.remote``, etc.
 140
 141   This new mapping has been introduced so that more natural
 142   branch names are used and to enable round-tripping back to git.
 143   (Ian Clatworthy)
 144
 145 * The old ``fast-import-filter`` command is now called
 146   ``fast-import-query``. ``fast-import-filter`` now
 147   really filters the input to produce a fast-import stream
 148   based on filtering criteria. See below.
 149   (Ian Clatworthy)
 150
 151 * The ``--inv-fulltext`` option is no longer supported. It was
 152   only used in experimental mode for old versions of bzrlib so
 153   it added more complexity than value. (Ian Clatworthy)
 154
 155 New Features
 156 ------------
 157
 158 * Added ``fast-import-filter`` command for splitting out a
 159   subdirectory or bunch of files into their own project. It can
 160   also be used to create a new repository without any history
 161   for nominated files and directories. This is useful for
 162   removing information which is a security risk, huge binary
 163   files like ISO images, etc.
 164   (Ian Clatworthy)
 165
 166 * Copying of files and symbolic links is now supported.
 167   (Ian Clatworthy)
 168
 169 * Initial cut at reset support. (Brian de Alwis, Ian Clatworthy)
 170
 171 Improvements
 172 ------------
 173
 174 * If ``refs/heads/xxx`` and ``refs/remotes/origin/xxx`` are both
 175   defined, the latter is now mapped to a bzr branch called
 176   ``xxx.remote`` rather than ``remotes--origins--xxx``.
 177   (Ian Clatworthy)
 178
 179 * ``bzr fast-import-info`` now handles an unlimited # of parents for a
 180   revision. The spec suggests the maximum ought to be 16 but the linux
 181   kernel has revisions with more than that.
 182   (Ian Clatworthy)
 183
 184 * ``bzr fast-import-info`` now reports on things that may need caching,
 185   i.e. merges, rename old paths and copy source paths.
 186   (Ian Clatworthy)
 187
 188 * Tag commands with a missing from clause now produce a warning but
 189   are otherwise ignored. (Scott James Remnant, Ian Clatworthy)
 190
 191 * The fastimport-id-map file can now have more revisions than the
 192   repository. (Scott James Remnant)
 193
 194 * Updated the bundled version of hg-fast-export to be the latest
 195   code from http://repo.or.cz/w/fast-export.git. It should now
 196   support recent Mercurial releases.
 197   (Ian Clatworthy, #318903)
 198
 199 Bug Fixes
 200 ---------
 201
 202 * Fixed a *bad* bug where filecopy commands were being parsed
 203   as filerename commands. Repositories generated by previous
 204   version of bzr-fast-import where the input stream contained
 205   filecopy commands might be missing data (the copy source will
 206   no longer be there if it was unchanged since the copy happened)
 207   and ought to be regenerated.
 208   (Ian Clatworthy)
 209
 210 * Fixed how the per-file graph is generated. The per-file graph
 211   may still be less than perfect in the case where a file is only
 212   changed in a merge and not the parent, but in the vast majority
 213   of cases now, ``bzr check`` should no longer report inconsistent
 214   parents. (Ian Clatworthy)
 215
 216 * Fix ``os`` import as needed on Windows.
 217   (Ian Clatworthy, esskov, #264988)
 218
 219 * Handle a directory turning into a file and then the children
 220   of that directory being deleted.
 221   (Ian Clatworthy, #309486)
 222
 223 * Handle an empty email section.
 224   (Ian Clatworthy)
 225
 226 * Handle multiple merges within the one merge clause. That's illegal
 227   according to the spec but git-fast-export does it.
 228   (Ian Clatworthy, #259711)
 229
 230 * Handle names and paths that aren't utf8 encoded. The spec recommends
 231   utf8 encoding of these but git-fast-export doesn't always do that.
 232   (Ian Clatworthy, #289088)
 233
 234 * Ignore lightweight tags with no from clause rather than abort.
 235   (It seems git-fast-export outputs these commands frequently now
 236   while it didn't appear to in early versions.)
 237   (Ian Clatworthy, edice, #259711)
 238
 239 * Import into rich-root (and subtree) repositories without aborting.
 240   (Ian Clatworthy, #300921)
 241
 242 * Recursively delete children when a directory is deleted.
 243   (Scott James Remnant)
 244
 245 * The ``deleteall`` command now only tries to delete files in the
 246   nominated branch, not all known files. As a consequence,
 247   it should now be possible (if it wasn't before) to import
 248   multiple Darcs branches (via darcs-fast-export) at once.
 249   (Ian Clatworthy)
 250
 251 Testing
 252 -------
 253
 254 * A large number of tests have been added.
 255   (Ian Clatworthy)
 256
 257 Internals
 258 ---------
 259
 260 * Refactored ``processors/generic_processor.py`` into a bunch of modules.
 261   (Ian Clatworthy)
 262
 263
 264 0.7 09-Feb-2009
 265 ===============
 266
 267 Compatibility Breaks
 268 --------------------
 269
 270 * bzr-fast-export.py renamed to bzr-fast-export.
 271   (Jelmer Vernooij)
 272
 273 Improvements
 274 ------------
 275
 276 * Add support for the deleteall command.
 277   (Miklos Vajna, #284941)
 278
 279 Bug Fixes
 280 ---------
 281
 282 * bzr-fast-export now exports rm+mv correctly.
 283   (Jonas)
 284
 285 * Fix recursive rename handling in bzr-fast-export.
 286   (Pieter de Bie, #287785)
 287
 288 * hg-fast-export should use binary mode on Windows.
 289   (Alexey Stukalov)
 290
 291 * setup.py no longer assumes python2.4.
 292   (schickb@gmail.com)
 293
 294 * setup.py support fixed.
 295   (Jelmer Vernooij)
 296
 297 * Update the last-modified revision for a renamed file.
 298   (John Arbash Meinel)
 299
 300
 301 0.6 23-Jul-2008
 302 ===============
 303
 304 Improvements
 305 ------------
 306
 307 * Added NEWS containing Release Notes. (Ian Clatworthy)
 308
 309 * ``bzr help fastimport`` now provides help that is useful.
 310   (Ian Clatworthy)
 311
 312 * Numerous fixes to ``bzr-fast-export.py`` to improve round-tripping
 313   with Git. Added ``--import-marks`` and ``--export-marks`` options
 314   to ``fast-import`` as well.
 315   (Pieter de Bie)
 316
 317 * ``svn-fast-export.py`` now supports a regular-expression to specify
 318   the branches to export.
 319   (Mirko Friedenhagen)
 320
 321 Bug Fixes
 322 ---------
 323
 324 * Support the new Repository API added in bzr.dev r3510. The old API
 325   will be used for earlier versions of bzr including bzr 1.6beta2 and
 326   earlier. (Ian Clatworthy)
 327
 328 Compatibility Breaks
 329 --------------------
 330
 331 * The ``--inv-fulltext`` option is not yet supported when the new
 332   Repository API is used to import revisions. The option can be
 333   provided but it will be ignored. (Ian Clatworthy)
 334
 335 API Breaks
 336
 337 * The ``RevisionLoader`` class has been renamed to ``RevisionLoader1``.
 338   The ``ExperimentalRevisionLoader`` class has been renamed to
 339   ``ImportRevisionLoader1``. New classes called ``RevisionLoader2``
 340   and ``ImportRevisionLoader2`` are provided that use the new
 341   Repository API. (Ian Clatworthy)
 342
 343 Internals
 344 ---------
 345
 346 * Improved packaging by adding a setup.py file. (Ian Clatworthy)
 347
 348
 349 0.5 02-Jun-2008
 350 ===============
 351
 352 * Version suitable for Bazaar 1.5.
 353   (Ian Clatworthy)