{"thread":{"id":"21012","subject":"[PATCH] Remove '< >' from [<options>] since it's not necessary.","startedAt":"2009-09-20T19:48:36Z","lastAt":"2009-09-21T06:50:45Z","messageCount":4,"participants":["Thiago Farina","tom fogal","Matthieu Moy"],"isPatch":true,"patchVersion":1,"patchTotal":null},"messages":[{"id":"123552","messageId":"1253476116-24284-1-git-send-email-tfransosi@gmail.com","threadId":"21012","inReplyTo":null,"subject":"[PATCH] Remove '< >' from [<options>] since it's not necessary.","fromName":"Thiago Farina","fromEmail":"tfransosi@gmail.com","sentAt":"2009-09-20T19:48:36Z","receivedAt":"2009-09-20T19:48:36Z","isPatch":true,"sender":{"key":"tfransosi@gmail.com","avatar":"https://avatars.githubusercontent.com/u/970071?v=4"},"body":"Signed-off-by: Thiago Farina <tfransosi@gmail.com>\n---\n builtin-log.c |    2 +-\n 1 files changed, 1 insertions(+), 1 deletions(-)\n\ndiff --git a/builtin-log.c b/builtin-log.c\nindex 25e21ed..1685546 100644\n--- a/builtin-log.c\n+++ b/builtin-log.c\n@@ -28,7 +28,7 @@ static const char *fmt_patch_subject_prefix = \"PATCH\";\n static const char *fmt_pretty;\n \n static const char * const builtin_log_usage =\n-\t\"git log [<options>] [<since>..<until>] [[--] <path>...]\\n\"\n+\t\"git log [options] [<since>..<until>] [[--] <path>...]\\n\"\n \t\"   or: git show [options] <object>...\";\n \n static void cmd_log_init(int argc, const char **argv, const char *prefix,\n-- \n1.6.5.rc1.37.gf5c31.dirty\n"},{"id":"123553","messageId":"auto-000020523806@sci.utah.edu","threadId":"21012","inReplyTo":"1253476116-24284-1-git-send-email-tfransosi@gmail.com","subject":"Re: [PATCH] Remove '< >' from [<options>] since it's not necessary.","fromName":"tom fogal","fromEmail":"tfogal@alumni.unh.edu","sentAt":"2009-09-20T20:52:26Z","receivedAt":"2009-09-20T20:52:26Z","isPatch":true,"sender":{"key":"tfogal@alumni.unh.edu","avatar":"https://gravatar.com/avatar/a2f71bfbe12b2b73cad0be2386d554aa403fff7a89df2f79e812c97c7eab0498?d=mp&s=160"},"body":"Thiago Farina <tfransosi@gmail.com> writes:\n> -\t\"git log [<options>] [<since>..<until>] [[--] <path>...]\\n\"\n> +\t\"git log [options] [<since>..<until>] [[--] <path>...]\\n\"\n>  \t\"   or: git show [options] <object>...\";\n\nTo me, \"<blah>\" implies to me that the other meant, \"something which\nis sort-of `blah'-ish but is not actually the string literal, `blah'\",\nwhereas `blah' means, \"the string literal, `blah'.\"\n\n-tom\n"},{"id":"123555","messageId":"auto-000020523897@sci.utah.edu","threadId":"21012","inReplyTo":"auto-000020523806@sci.utah.edu","subject":"Re: [PATCH] Remove '< >' from [<options>] since it's not necessary.","fromName":"tom fogal","fromEmail":"tfogal@alumni.unh.edu","sentAt":"2009-09-20T21:12:44Z","receivedAt":"2009-09-20T21:12:44Z","isPatch":true,"sender":{"key":"tfogal@alumni.unh.edu","avatar":"https://gravatar.com/avatar/a2f71bfbe12b2b73cad0be2386d554aa403fff7a89df2f79e812c97c7eab0498?d=mp&s=160"},"body":"tom fogal <tfogal@alumni.unh.edu> writes:\n> Thiago Farina <tfransosi@gmail.com> writes:\n> > -\t\"git log [<options>] [<since>..<until>] [[--] <path>...]\\n\"\n> > +\t\"git log [options] [<since>..<until>] [[--] <path>...]\\n\"\n> >  \t\"   or: git show [options] <object>...\";\n> \n> To me, \"<blah>\" implies to me that the other meant, \"something which\n                                         ^^^^^\n... author.  sorry.\n\n-tom\n"},{"id":"123559","messageId":"vpq7hvssse2.fsf@bauges.imag.fr","threadId":"21012","inReplyTo":"auto-000020523806@sci.utah.edu","subject":"Re: [PATCH] Remove '< >' from [<options>] since it's not necessary.","fromName":"Matthieu Moy","fromEmail":"matthieu.moy@grenoble-inp.fr","sentAt":"2009-09-21T06:50:45Z","receivedAt":"2009-09-21T06:50:45Z","isPatch":true,"sender":{"key":"matthieu.moy@grenoble-inp.fr","avatar":"https://gravatar.com/avatar/72c8a2705971a25dfaff23cece15130d405685845d911aedd5667ace277f3fc5?d=mp&s=160"},"body":"tom fogal <tfogal@alumni.unh.edu> writes:\n\n> Thiago Farina <tfransosi@gmail.com> writes:\n>> -\t\"git log [<options>] [<since>..<until>] [[--] <path>...]\\n\"\n>> +\t\"git log [options] [<since>..<until>] [[--] <path>...]\\n\"\n>>  \t\"   or: git show [options] <object>...\";\n>\n> To me, \"<blah>\" implies to me that the author meant, \"something which\n> is sort-of `blah'-ish but is not actually the string literal, `blah'\",\n> whereas `blah' means, \"the string literal, `blah'.\"\n\nStrictly speaking, you're right, but in the particular case of\n[options], it's rather well established that it means \"one or several\noptions\", and not the litteral \"option\". In any case, we should be\nconsistant:\n\nDocumentation$ grep -n '\\[<options>\\]' *.txt\ngit-log.txt:11:'git log' [<options>] [<since>..<until>] [[\\--] <path>...]\ngit-stash.txt:11:'git stash' list [<options>]\ngit-stash.txt:67:list [<options>]::\nDocumentation$ grep -n '\\[options\\]' *.txt\ngit-annotate.txt:10:'git annotate' [options] file [revision]\ngitcli.txt:84:usage: git-describe [options] <committish>*\ngit-cvsserver.txt:25:'git cvsserver' [options] [pserver|server] [<directory> ...]\ngit-fast-export.txt:11:'git fast-export [options]' | 'git fast-import'\ngit-fast-import.txt:11:frontend | 'git fast-import' [options]\ngit-rebase.txt:11:'git rebase' [-i | --interactive] [options] [--onto <newbase>]\ngit-rebase.txt:13:'git rebase' [-i | --interactive] [options] --onto <newbase>\ngit-rev-parse.txt:405:some-command [options] <args>...\ngit-send-email.txt:11:'git send-email' [options] <file|directory|rev-list options>...\ngit-show.txt:11:'git show' [options] <object>...\ngit-svn.txt:10:'git svn' <command> [options] [arguments]\n\n=> either get rid of the 3 occurences of [<options>], not just one, or\nget rid of all the [options]. My vote goes for the first.\n\n--\nMatthieu Moy\nhttp://www-verimag.imag.fr/~moy/\n"}]}