doc/notes.txt

   1 =======================
   2 Notes on bzr-fastimport
   3 =======================
   4
   5 ..contents::
   6
   7 Features
   8 ========
   9
  10 fast-import
  11 -----------
  12
  13 Things that ought to work:
  14
  15 * add & deletes of files and symlinks
  16
  17 * automatic creation of directories (but not deletion)
  18
  19 * executable permission
  20
  21 * branches created based on where the import is run:
  22
  23   * import into a shared repository outside a branch - branches
  24     are created as subdirectories of the current directory
  25
  26   * import into a branch inside a shared repository - current
  27     branch becomes the trunk and other branches are created
  28     as sister directories
  29
  30   * import into a standalone tree - warnings are given
  31     for branches (heads) found but not imported
  32
  33 * merge tracking
  34
  35 Things that probably work (more testing needed):
  36
  37 * separate author to committer
  38
  39 * lightweight tags
  40
  41
  42 Known Limitations
  43 =================
  44
  45 Parsing
  46 -------
  47
  48 Things not supported yet:
  49
  50 * renaming a path that contains a space in the old name
  51
  52 * copying a path that contains a space in the source name
  53
  54 * delimited data sections (all data must be length prefixed currently)
  55
  56 * rfc2822 dates.
  57
  58 fast-import
  59 -----------
  60
  61 Things not supported yet:
  62
  63 * deterministic revision-ids as an option
  64
  65 * 'reset' handling
  66
  67 * 'filedeleteall' handling
  68
  69 Things not recorded in Bazaar:
  70
  71 * tagger and message for (non-lightweight) tags
  72
  73 * copy semantics
  74
  75
  76 Custom Enhancements
  77 ===================
  78
  79 General
  80 -------
  81
  82 The date format is auto-detected.
  83
  84 Parsing
  85 -------
  86
  87 These enhancements over the specification are provided in order
  88 to read data produced by some verisons of git-fast-export:
  89
  90 * A person's name may be empty
  91
  92 * Long file modes with an extra leading 0, i.e. 0000644,
  93   0000755 and 0120000 are legal.