Quoting Junio C Hamano <gitster@xxxxxxxxx>: >> Because it is where the convention that is used in all of the UI is >> described, I think gitcli documentation is an appropriate place. > > I am still not convinced it is the best place but I guess it would be > better than not documenting it anywhere. > >> Don't you also want to talk about distinction between --cached and >> --index that new people are often confused about? These options are >> defined consistently across commands but people who do not know it bring >> up discussions to rename --cached to some commands to --index to make it >> inconsistent and waste your time every once in a while. Do you have any comment on the --index/--cached issue? -- Nanako Shiraishi http://ivory.ap.teacup.com/nanako3/ -- 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