Matthieu Moy <Matthieu.Moy@xxxxxxxxxxxxxxx> writes: > Ilari Liusvaara <ilari.liusvaara@xxxxxxxxxxx> writes: > >> + >> +-u:: >> +--set-upstream:: >> + For every branch that is up to date or successfully pushed, add >> + upstream (tracking) reference for argument-less git pull. > > Not just argument-less git pull. git status is also impacted for > example. Actually, we already have documentation for it in git-branch > (--track option), and git-config (branch.<name>.merge configuration > variable), so you should add a pointer to one of them. > > How about > > --set-upstream:: > For every branch that is up to date or successfully pushed, add > upstream (tracking) reference, used by argument-less > linkgit:git-pull[1] and other commands. For more information, > see 'branch.<name>.merge' in linkgit:git-config[1]. Yeah, if we talked only about the configuration variable it wouldn't help users, but this description is reayy good. > Or the --track option of branch and checkout should be renamed as > --set-upstream, but that seems a lot of trouble for little benefit. It might make sense to do so in the longer term UI clean-up, but I think that is largely an independent topic. By not introducing new places the confusing --track is used, we are at least not making things worse. -- 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