1 ============================
2 bzr-fastimport Release Notes
3 ============================
12 * bzr-fastimport no longer ships exporters for various other version
13 control systems. The versions of these exporters shipped with bzr-fastimport
14 have been outdated for some time. Better and more recent exporters
20 * Avoid using Tree.inventory directly, which is deprecated in bzr 2.6.
23 * Reimport some modules removed from python-fastimport 0.9.2.
24 (Jelmer Vernooij, #693507)
31 * Cope with non-utf8 characters in paths when importing.
32 (Jelmer Vernooij, #838980)
37 * New option --rewrite-tag-names for 'bzr fast-export'. (Alex Usov, #872601)
39 * New option --dont-squash-empty-commits for 'bzr fast-import-filter'.
42 * Add --baseline option to ``bzr export``. (Andy Grimm, #893382)
49 * Fix internal error in 'bzr fast-import-info'. (Jelmer Vernooij, #730833)
51 * Setup.py no longer relies on bzrlib. (Jelmer Vernooij, #735201)
53 * Avoid Inventory.copy, which has disappeared in newer versions of Bazaar.
54 (Jelmer Vernooij, #485788)
56 * Allow "bzr fast-import-filter" to be used without first argument.
57 (Jelmer Vernooij, #792935)
59 * Remove --branches-path and --tags-path options from ``bzr fast-export-from-svn``.
60 These options are not supported by the underlying svn-fast-export.py yet.
61 (Jelmer Vernooij, #513747)
63 * In "plain" mode, skip tags that contain characters not valid in Git.
64 (Jelmer Vernooij, #386986)
66 * Support exporting files that are changed into directories.
67 (Henrik Nyberg, #631979)
74 * bzr-fastimport's file parsing and generation functionality has been exported into
75 separate upstream project called python-fastimport, that it now depends on.
76 python-fastimport can be retrieved from http://launchpad.net/python-fastimport.
81 * Cope with non-ascii characters in tag names. (Jelmer Vernooij, #598060)
83 * Cope with non-ascii characters in symbolic links. (Daniel Clemente,
84 Jelmer Vernooij, #238365)
86 * In plain mode, don't export multiple authors. (David Kilzer, #496677)
88 * Fix indentation when starting p4 fails. (Jelmer Vernooij)
90 * SOURCE argument to bzr fast-import-filter is now optional, consistent with
91 examples. (Jelmer Vernooij, #477861)
93 * Support new marks file format introduced in (apparently) git 1.6.
94 (Ian Clatworthy, Jelmer Vernooij, Gabriel Filion, #347729)
96 * Allow entries without email address in user map. (Jelmer Vernooij, #576598)
98 * Strip leading slashes when exporting Subversion repositories.
99 (Jelmer Vernooij, #477869)
101 * Cope with non-utf8 characters in commit messages. (Jelmer Vernooij, #444896)
103 * Include download_url in setup.py for use on pypi. (Jelmer Vernooij, #456957)
105 * Fix incremental imports from incremental import streams.
106 (termie, Jelmer Vernooij, #328494)
114 * The fast-import command now takes an optional but recommended
115 DESTINATION argument. A repository will be created at this
116 location and branches will be created within there. If the user
117 is running bzr 1.17 up to 2.0, format "2a" is used for these,
118 otherwise the default format is used. A format can be explicitly
119 given using the new --format option. (Ian Clatworthy)
121 * Wrapper commands simplifying the generation of fast-import
122 files from other tools are now provided. The general usage is:
124 bzr fast-export-from-xxx SOURCE project.fi
126 Before starting an export, these commands make an effort to
127 check that dependent tools are installed. So far, wrapper
128 commands are available for cvs, darcs, git, hg (Mercurial),
129 mnt (Monotone), p4 (Perforce) and svn (Subversion).
130 (Ian Clatworthy, Matt McClure)
132 * darcs-fast-export is now bundled. In fact, the project has
133 merged into this one for the purposes of ongoing bug fixing
134 and development. (Miklos Vajna)
136 * fast-export now supports a --no-plain parameter which causes
137 richer metadata to be included in the output using the
138 recently agreed 'feature' extension capability. The features
139 used are called multiple-authors, commit-properties and
140 empty-directories. (Ian Clatworthy)
142 * fast-import and fast-import-filter now support user mapping
143 via the new --user-map option. The argument is a file specifying
144 how user-ids should be mapped to preferred user-ids.
147 * svn-fast-export now supports an address option (to control the
148 default email domain) and a first-rev option (to select revisions
149 since a given one). (Ted Gould)
154 * Large repositories now compress better thanks to a change in
155 how file-ids are assigned. (Ian Clatworthy, John Arbash Meinel)
157 * Memory usage is improved by flushing blobs to a disk cache
158 when appropriate. (John Arbash Meinel)
160 * If a fast-import source ends in ".gz", it is assumed to be in
161 gzip format and the stream is implicitly uncompressed. This
162 means fast-import dump files generated by fast-export-from-xxx
163 can be stored gzipped to save space. (Ian Clatworthy)
165 * The working tree is now implicitly updated for trunk. Other
166 branches still need to be explicitly created using 'bzr update'.
169 * Directories that become empty following a delete or rename of
170 one of their children are now implicitly pruned. If required,
171 this will be made optional at a later date.
172 (Tom Widmer, Ian Clatworthy)
174 * Blob tracking is now more intelligently done by an implicit
175 first pass to collect blob usage statistics. This eliminates
176 the need for an explicit 2-step process in all cases except
177 where stdin is used as the input source. (Ian Clatworthy)
179 * Updated the bundled version of hg-fast-export to be the latest
180 code (25-May-2009) from http://repo.or.cz/w/fast-export.git.
186 * Fixed the format used to create branches in a shared repository.
187 It now selects the best branch format based on the repository
188 format, rather than assume the default branch format is the right
189 one. (Ian Clatworthy)
191 * Fixed inventory delta generation when deleting directories.
192 (Previously the child paths included were relative to the
193 directory when they ought to be relative to the root.)
196 * Gracefully handle email addresses with unicode characters.
199 * Gracefully handle an empty input stream. (Gonéri Le Bouder)
201 * Gracefully handle git submodules by ignoring them.
204 * Get git-bzr working again. (Gonéri Le Bouder)
209 * Improved documentation has been published in the Bazaar Data Migration
210 Guide: http://doc.bazaar-vcs.org/migration/en/data-migration/.
219 * ``exporters/bzr-fast-export`` has been replaced with a
220 ``fast-export`` command. Some minor issues have been
221 fixed at the same time: the first commit now goes into
222 refs/heads/master (not refs/head/tmp); there's no
223 checkpoint at the top of the stream; parent commits are
224 now always given lower mark numbers than the commits they
225 are merged into. (Ian Clatworthy)
227 * The ``fast-import`` command now uses a different mapping of
228 git reference names to bzr branch names. In summary:
230 * ``refs/heads/foo`` is mapped to ``foo``
231 * ``refs/remotes/origin/foo`` is mapped to ``foo.remote``
232 * ``refs/tags/foo`` is mapped to ``foo.tag``
233 * ``*/master`` is mapped to ``trunk``, ``trunk.remote``, etc.
234 * ``*/trunk`` is mapped to ``git-trunk``, ``git-trunk.remote``, etc.
236 This new mapping has been introduced so that more natural
237 branch names are used and to enable round-tripping back to git.
240 * The old ``fast-import-filter`` command is now called
241 ``fast-import-query``. ``fast-import-filter`` now
242 really filters the input to produce a fast-import stream
243 based on filtering criteria. See below.
246 * The ``--inv-fulltext`` option is no longer supported. It was
247 only used in experimental mode for old versions of bzrlib so
248 it added more complexity than value. (Ian Clatworthy)
253 * Added ``fast-import-filter`` command for splitting out a
254 subdirectory or bunch of files into their own project. It can
255 also be used to create a new repository without any history
256 for nominated files and directories. This is useful for
257 removing information which is a security risk, huge binary
258 files like ISO images, etc.
261 * Copying of files and symbolic links is now supported.
264 * Initial cut at reset support. (Brian de Alwis, Ian Clatworthy)
269 * If ``refs/heads/xxx`` and ``refs/remotes/origin/xxx`` are both
270 defined, the latter is now mapped to a bzr branch called
271 ``xxx.remote`` rather than ``remotes--origins--xxx``.
274 * ``bzr fast-import-info`` now handles an unlimited # of parents for a
275 revision. The spec suggests the maximum ought to be 16 but the linux
276 kernel has revisions with more than that.
279 * ``bzr fast-import-info`` now reports on things that may need caching,
280 i.e. merges, rename old paths and copy source paths.
283 * Tag commands with a missing from clause now produce a warning but
284 are otherwise ignored. (Scott James Remnant, Ian Clatworthy)
286 * The fastimport-id-map file can now have more revisions than the
287 repository. (Scott James Remnant)
289 * Updated the bundled version of hg-fast-export to be the latest
290 code from http://repo.or.cz/w/fast-export.git. It should now
291 support recent Mercurial releases.
292 (Ian Clatworthy, #318903)
297 * Fixed a *bad* bug where filecopy commands were being parsed
298 as filerename commands. Repositories generated by previous
299 version of bzr-fast-import where the input stream contained
300 filecopy commands might be missing data (the copy source will
301 no longer be there if it was unchanged since the copy happened)
302 and ought to be regenerated.
305 * Fixed how the per-file graph is generated. The per-file graph
306 may still be less than perfect in the case where a file is only
307 changed in a merge and not the parent, but in the vast majority
308 of cases now, ``bzr check`` should no longer report inconsistent
309 parents. (Ian Clatworthy)
311 * Fix ``os`` import as needed on Windows.
312 (Ian Clatworthy, esskov, #264988)
314 * Handle a directory turning into a file and then the children
315 of that directory being deleted.
316 (Ian Clatworthy, #309486)
318 * Handle an empty email section.
321 * Handle multiple merges within the one merge clause. That's illegal
322 according to the spec but git-fast-export does it.
323 (Ian Clatworthy, #259711)
325 * Handle names and paths that aren't utf8 encoded. The spec recommends
326 utf8 encoding of these but git-fast-export doesn't always do that.
327 (Ian Clatworthy, #289088)
329 * Ignore lightweight tags with no from clause rather than abort.
330 (It seems git-fast-export outputs these commands frequently now
331 while it didn't appear to in early versions.)
332 (Ian Clatworthy, edice, #259711)
334 * Import into rich-root (and subtree) repositories without aborting.
335 (Ian Clatworthy, #300921)
337 * Recursively delete children when a directory is deleted.
338 (Scott James Remnant)
340 * The ``deleteall`` command now only tries to delete files in the
341 nominated branch, not all known files. As a consequence,
342 it should now be possible (if it wasn't before) to import
343 multiple Darcs branches (via darcs-fast-export) at once.
349 * A large number of tests have been added.
355 * Refactored ``processors/generic_processor.py`` into a bunch of modules.
365 * bzr-fast-export.py renamed to bzr-fast-export.
371 * Add support for the deleteall command.
372 (Miklos Vajna, #284941)
377 * bzr-fast-export now exports rm+mv correctly.
380 * Fix recursive rename handling in bzr-fast-export.
381 (Pieter de Bie, #287785)
383 * hg-fast-export should use binary mode on Windows.
386 * setup.py no longer assumes python2.4.
389 * setup.py support fixed.
392 * Update the last-modified revision for a renamed file.
402 * Added NEWS containing Release Notes. (Ian Clatworthy)
404 * ``bzr help fastimport`` now provides help that is useful.
407 * Numerous fixes to ``bzr-fast-export.py`` to improve round-tripping
408 with Git. Added ``--import-marks`` and ``--export-marks`` options
409 to ``fast-import`` as well.
412 * ``svn-fast-export.py`` now supports a regular-expression to specify
413 the branches to export.
419 * Support the new Repository API added in bzr.dev r3510. The old API
420 will be used for earlier versions of bzr including bzr 1.6beta2 and
421 earlier. (Ian Clatworthy)
426 * The ``--inv-fulltext`` option is not yet supported when the new
427 Repository API is used to import revisions. The option can be
428 provided but it will be ignored. (Ian Clatworthy)
432 * The ``RevisionLoader`` class has been renamed to ``RevisionLoader1``.
433 The ``ExperimentalRevisionLoader`` class has been renamed to
434 ``ImportRevisionLoader1``. New classes called ``RevisionLoader2``
435 and ``ImportRevisionLoader2`` are provided that use the new
436 Repository API. (Ian Clatworthy)
441 * Improved packaging by adding a setup.py file. (Ian Clatworthy)
447 * Version suitable for Bazaar 1.5.