John Keeping <john@xxxxxxxxxxxxx> writes: > On Fri, Sep 18, 2015 at 09:10:08AM +0200, Matthieu Moy wrote: > >> The `commit` may be omitted and defaults to HEAD if this is the final >> argument. > > I find that slightly confusing, although that might just be me. It's > slightly longer, but I would write: > > The `commit` may be omitted if this is the final argument, in > which case it defaults to `HEAD`. Probably clearer indeed. > I also had a look at git-branch(1), which has similar `--merged` and > `--no-merged` options and says: > > Only list branches whose tips are reachable from the specified > commit (HEAD if not specified). Implies `--list`. I think this lacks the "may be omitted if this is the final argument", which is actually the most confusing (see the other thread "git status -u is mildly astonishing" for an example of similar confusion). -- Matthieu Moy http://www-verimag.imag.fr/~moy/ -- To unsubscribe from this list: send the line "unsubscribe git" in the body of a message to majordomo@xxxxxxxxxxxxxxx More majordomo info at http://vger.kernel.org/majordomo-info.html