On Sat, Jun 07, 2008 at 08:36:54PM -0500, Jon Loeliger wrote: >> Furthermore, for long-option consistency --author <author> >> is changed to --author=<author>. > Say, if we were to document and espouse one form over the other, > which would you recommend or prefer? $ sed -ne '/sticked/,/^$/p' Documentation/gitcli.txt * when a command line option takes an argument, use the 'sticked' form. In other words, write `"git foo -oArg"` instead of `"git foo -o Arg"` for short options, and `"git foo --long-opt=Arg"` instead of `"git foo --long-opt Arg"` for long options. An option that takes optional option-argument must be written in the 'sticked' form. 'sticked' form must be used: ---------------------------- $ git describe --abbrev HEAD # correct $ git describe --abbrev=10 HEAD # correct $ git describe --abbrev 10 HEAD # NOT WHAT YOU MEANT ---------------------------- -Peff -- 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
