git.oblomov.eu Git - git/blob - TODO

   1 The GIT To-Do File
   2 ==================
   3
   4   The latest copy of this document is found at
   5
   6     http://kernel.org/git/?p=git/git.git;a=blob;hb=todo;f=TODO
   7
   8
   9 What to expect until 1.0
  10 ========================
  11
  12 This is written in a form of to-do list for me, so if I say
  13 "accept patch", it means I do not currently plan to do that
  14 myself.  People interested in seeing it materialize please take
  15 a hint.  Also whatever I marked "Perhaps" do not have to happen
  16 if ever -- only if somebody cares enough and submits a clean
  17 patch, perhaps ;-).
  18
  19 Only handful things remain until 1.0.
  20
  21
  22 Documentation
  23 -------------
  24
  25 * Accept patches from people who actually have done CVS
  26   migration and update the cvs-migration documentation.
  27   Link the documentation from the main git.txt page.
  28
  29 * Talk about using rsync just once at the beginning when
  30   initializing a remote repository so that local packs do not
  31   need to be expanded.  I personally do not think we need tool
  32   support for this (but see below about optimized cloning).
  33
  34 * Maybe update tutorial with a toy project that involves two or
  35   three developers.
  36
  37 * Update tutorial to cover setting up repository hooks to do
  38   common tasks.
  39
  40 * Do we still have missing docs?  If so accept patches to finish
  41   them.
  42
  43 * Accept patches to talk about "Whoops, it broke.  What's
  44   next?" [ONGOING].
  45
  46 * Accept patches to make formatted tables in asciidoc to work
  47   well in both html and man pages (see git-diff(1)).
  48
  49 * Work around multiple synopses lines in manual pages
  50   (e.g. git-bisect).
  51
  52
  53 Technical (heavier)
  54 -------------------
  55
  56 * Libification.  There are many places "run once" mentality is
  57   ingrained in the management of basic data structures, which
  58   need to be fixed.  [Matthias Urlichs is already working on
  59   this: <pan.2005.10.03.20.48.52.132570@smurf.noris.de>; Post
  60   1.0].
  61
  62 * Maybe a pack optimizer.
  63
  64   Given a set of objects and a set of refs (probably a handful
  65   branch heads and point release tags), find a set of packs to
  66   allow reasonably minimum download for all of these classes of
  67   people: (1) somebody cloning the repository from scratch, (2)
  68   somebody who tends to follow the master branch head reasonably
  69   closely, (3) somebody who tends to follow only the point
  70   releases.
  71
  72   This needs a matching smart on the dumb protocol downloader.
  73
  74 * Maybe an Emacs VC backend.
  75
  76 * Look at libified GNU diff CVS seems to use, or libxdiff.
  77   [Daniel has his own diff tool almost ready to start
  78   integrating and testing; Post 1.0]
  79
  80 * Plug-in file-level merges [Post 1.0].  On the other hand, we
  81   may not even need this; just tell people to run "xxdiff -U" on
  82   the working tree files.
  83
  84 * Ref namespace management.  Perhaps use refs/local/ suggestion
  85   by Linus. [Does not seem to be high on people's priority list,
  86   and not interested myself.  People can resurrect this
  87   discussion if they want.]
  88
  89
  90 Technical (milder)
  91 ------------------
  92
  93 * strip leading directory from ls-tree output.
  94
  95 * diff stopping at the first output; qgit wants to know if this
  96   tree has any A or D from the other tree and nothing else.
  97   Would help internal tree-diff in rev-list as well [can be post
  98   1.0].
  99
 100 * merge-recursive needs to register conflicting paths as higher
 101   stage entries in the index.  For that, it first needs to
 102   construct three trees whose paths are already renamed, and
 103   call 3-way read-tree.  Alternatively, update-index needs to
 104   give it a way to construct higher stages [can be post 1.0, but
 105   nicer to have in 1.0].
 106
 107 * daemon --strict-symlink [can be post 1.0].
 108
 109 * Binary package split.  Plan laid out and discussion mostly
 110   done. [RPM side done; Debian side thrown over the wall.]
 111
 112 * Perhaps detect cloning request in upload-pack and cache the
 113   result for next cloning request until any of our refs change.
 114
 115 * Perhaps accept patch to optionally allow '--fuzz' in
 116   'git-apply'.
 117
 118 * Allow 'git apply' to accept GNU diff 2.7 output that forgets
 119   to say '\No newline' if both input ends with incomplete
 120   lines.
 121
 122 * Maybe grok PGP signed text/plain in applymbox as well.
 123
 124 * Enhance "git repack" to not always use --all; this would be
 125   handy if the repository contains wagging heads like "pu" in
 126   git.git repository.
 127
 128 * Output full path in the "git-rev-list --objects" output, not
 129   just the basename, and see the improved clustering results in
 130   better packing [Tried, but did not work out well].
 131
 132
 133 Technical (trivial)
 134 -------------------
 135
 136 * We would want test scripts for the relative directory path
 137   stuff Linus has been working on.  Most of the C-level
 138   commands should be usable with relative directory paths.
 139
 140 * In a freashly created empty repository, `git fetch foo:bar`
 141   works OK, but `git checkout bar` afterwards does not (missing
 142   `.git/HEAD`).
 143
 144 \f
 145 Local Variables:
 146 mode: text
 147 End: