X-Git-Url: http://www.chiark.greenend.org.uk/ucgi/~ian/git?a=blobdiff_plain;f=README;h=8a68a652bd493c8397410362d98bcf58750dcb12;hb=b12909b329bc716317f37465c6f8652394c857c4;hp=7b117b89f44a836ecafe4e5077d7f33980a78209;hpb=d272e32afc116764cf2afc1033320953466f5ed5;p=topgit.git diff --git a/README b/README index 7b117b8..8a68a65 100644 --- a/README +++ b/README @@ -296,6 +296,8 @@ tg mail Since it actually boils down to `git send-email` please refer to its documentation for details on how to setup email for git. + You can pass arbitrary options to this command through the + '-s' parameter, but you must double-quote everything. TODO: 'tg mail patchfile' to mail an already exported patch TODO: mailing patch series @@ -327,6 +329,10 @@ tg summary '!' marks that it has missing dependencies (even recursively), 'B' marks that it is out-of-date wrt. its base). + This can take long time to accurately determine all the relevant + information about each branch; you can pass '-t' to get just + terse list of topic branch names quickly. + TODO: Speed up by an order of magnitude TODO: Graph view @@ -393,6 +399,10 @@ tg export and an argument specifying the directory where the quilt series should be saved. + With '--quilt', you can also pass '-b' parameter followed by + a comma-separated explicit list of branches to export. This + mode of operation is currently not supported with collapse. + Usage: tg export ([--collapse] BRANCH | --quilt DIR) TODO: Make stripping of non-essential headers configurable @@ -400,8 +410,6 @@ tg export TODO: --mbox option for other mode of operation TODO: -n option to prevent exporting of empty patches TODO: -a option to export all branches - TODO: Allow branches to be exported to be passed as arguments, default - to the current branch if none are specified TODO: For quilt exporting, use a temporary branch and remove it when done - this would allow producing conflict-less series @@ -474,7 +482,10 @@ can be prefilled from various optional topgit.* config options. .topdeps: Contains the one-per-line list of branches your patch depends on, pre-seeded with `tg create`. (Continuously updated) merge of these branches will be the "base" of your topic -branch. +branch. DO NOT EDIT THIS FILE MANUALLY!!! If you do so, you need +to know exactly what are you doing, since this file must stay in +sync with the Git history information, otherwise very bad things +will happen. TopGit also automagically installs a bunch of custom commit-related hooks that will verify if you are committing the .top* files in sane