* [PATCH] commit: Add -f, --fixes <commit> option to add Fixes: line [not found] ` <20131026181709.GB10488@kroah.com> @ 2013-10-27 1:34 ` Josh Triplett 2013-10-27 5:42 ` Michael Haggerty ` (4 more replies) 0 siblings, 5 replies; 49+ messages in thread From: Josh Triplett @ 2013-10-27 1:34 UTC (permalink / raw) To: git Cc: Dan Carpenter, Greg KH, ksummit-2013-discuss, ksummit-attendees, linux-kernel Linux Kernel Summit 2013 decided on a commit message convention to identify commits containing bugs fixed by a commit: a "Fixes:" line, included in the standard commit footer (along with "Signed-off-by:" if present), containing an abbreviated commit hash (at least 12 characters to keep it valid for a long time) and the subject of the commit (for human readers). This helps people (or automated tools) determine how far to backport a commit. Add a command line option for git commit to automatically construct the "Fixes:" line for a commit. This avoids the need to manually construct that line by copy-pasting the commit hash and subject. Also works with --amend to modify an existing commit's message. To add a Fixes line to an earlier commit in a series, use rebase -i and add the following line after the existing commit: x git commit --amend --no-edit -f $commit_containing_bug Generalize append_signoff to support appending arbitrary extra lines to a commit in the signoff block; this avoids duplicating the logic to find or construct that block. Signed-off-by: Josh Triplett <josh@joshtriplett.org> --- Documentation/git-commit.txt | 12 ++++++++++-- builtin/commit.c | 29 +++++++++++++++++++++++++++-- sequencer.c | 31 +++++++++++++++++++++++-------- sequencer.h | 3 +++ t/t7502-commit.sh | 39 ++++++++++++++++++++++++++++++++++++++- 5 files changed, 101 insertions(+), 13 deletions(-) diff --git a/Documentation/git-commit.txt b/Documentation/git-commit.txt index 1a7616c..fcc6ed2 100644 --- a/Documentation/git-commit.txt +++ b/Documentation/git-commit.txt @@ -8,8 +8,8 @@ git-commit - Record changes to the repository SYNOPSIS -------- [verse] -'git commit' [-a | --interactive | --patch] [-s] [-v] [-u<mode>] [--amend] - [--dry-run] [(-c | -C | --fixup | --squash) <commit>] +'git commit' [-a | --interactive | --patch] [-s] [-f <commit>] [-v] [-u<mode>] + [--amend] [--dry-run] [(-c | -C | --fixup | --squash) <commit>] [-F <file> | -m <msg>] [--reset-author] [--allow-empty] [--allow-empty-message] [--no-verify] [-e] [--author=<author>] [--date=<date>] [--cleanup=<mode>] [--[no-]status] @@ -156,6 +156,14 @@ OPTIONS Add Signed-off-by line by the committer at the end of the commit log message. +-f <commit>:: +--fixes=<commit>:: + Add Fixes line for the specified commit at the end of the commit + log message. This line includes an abbreviated commit hash for + the specified commit; the `core.abbrev` option determines the + length of the abbreviated commit hash used, with a minimum length + of 12 hex digits. + -n:: --no-verify:: This option bypasses the pre-commit and commit-msg hooks. diff --git a/builtin/commit.c b/builtin/commit.c index 6ab4605..9bbcd8a 100644 --- a/builtin/commit.c +++ b/builtin/commit.c @@ -123,6 +123,7 @@ static int use_editor = 1, include_status = 1; static int show_ignored_in_status, have_option_m; static const char *only_include_assumed; static struct strbuf message = STRBUF_INIT; +static struct strbuf fixes = STRBUF_INIT; static enum status_format { STATUS_FORMAT_NONE = 0, @@ -133,6 +134,28 @@ static enum status_format { STATUS_FORMAT_UNSPECIFIED } status_format = STATUS_FORMAT_UNSPECIFIED; +static int opt_parse_f(const struct option *opt, const char *arg, int unset) +{ + struct strbuf *sb = opt->value; + if (unset) { + strbuf_setlen(sb, 0); + } else { + struct pretty_print_context ctx = {0}; + struct commit *commit; + + commit = lookup_commit_reference_by_name(arg); + if (!commit) + die(_("could not lookup commit %s"), arg); + ctx.output_encoding = get_commit_output_encoding(); + ctx.abbrev = DEFAULT_ABBREV; + if (ctx.abbrev < 12) + ctx.abbrev = 12; + format_commit_message(commit, "Fixes: %h ('%s')\n", sb, &ctx); + } + + return 0; +} + static int opt_parse_m(const struct option *opt, const char *arg, int unset) { struct strbuf *buf = opt->value; @@ -718,7 +741,7 @@ static int prepare_to_commit(const char *index_file, const char *prefix, if (clean_message_contents) stripspace(&sb, 0); - if (signoff) { + if (signoff || fixes.len) { /* * See if we have a Conflicts: block at the end. If yes, count * its size, so we can ignore it. @@ -742,7 +765,8 @@ static int prepare_to_commit(const char *index_file, const char *prefix, previous = eol; } - append_signoff(&sb, ignore_footer, 0); + append_signoff_extra(&sb, ignore_footer, + signoff ? 0 : APPEND_EXTRA_ONLY, &fixes); } if (fwrite(sb.buf, 1, sb.len, s->fp) < sb.len) @@ -1463,6 +1487,7 @@ int cmd_commit(int argc, const char **argv, const char *prefix) OPT_STRING(0, "squash", &squash_message, N_("commit"), N_("use autosquash formatted message to squash specified commit")), OPT_BOOL(0, "reset-author", &renew_authorship, N_("the commit is authored by me now (used with -C/-c/--amend)")), OPT_BOOL('s', "signoff", &signoff, N_("add Signed-off-by:")), + OPT_CALLBACK('f', "fixes", &fixes, N_("commit"), N_("add Fixes: for the specified commit"), opt_parse_f), OPT_FILENAME('t', "template", &template_file, N_("use specified template file")), OPT_BOOL('e', "edit", &edit_flag, N_("force edit of commit")), OPT_STRING(0, "cleanup", &cleanup_arg, N_("default"), N_("how to strip spaces and #comments from message")), diff --git a/sequencer.c b/sequencer.c index 06e52b4..f4cf0e1 100644 --- a/sequencer.c +++ b/sequencer.c @@ -1135,26 +1135,33 @@ int sequencer_pick_revisions(struct replay_opts *opts) return pick_commits(todo_list, opts); } -void append_signoff(struct strbuf *msgbuf, int ignore_footer, unsigned flag) +void append_signoff_extra(struct strbuf *msgbuf, int ignore_footer, + unsigned flag, struct strbuf *extrabuf) { unsigned no_dup_sob = flag & APPEND_SIGNOFF_DEDUP; + unsigned append_sob = !(flag & APPEND_EXTRA_ONLY); struct strbuf sob = STRBUF_INIT; int has_footer; - strbuf_addstr(&sob, sign_off_header); - strbuf_addstr(&sob, fmt_name(getenv("GIT_COMMITTER_NAME"), - getenv("GIT_COMMITTER_EMAIL"))); - strbuf_addch(&sob, '\n'); + if (append_sob) { + strbuf_addstr(&sob, sign_off_header); + strbuf_addstr(&sob, fmt_name(getenv("GIT_COMMITTER_NAME"), + getenv("GIT_COMMITTER_EMAIL"))); + strbuf_addch(&sob, '\n'); + } /* * If the whole message buffer is equal to the sob, pretend that we * found a conforming footer with a matching sob */ - if (msgbuf->len - ignore_footer == sob.len && + if (append_sob && + msgbuf->len - ignore_footer == sob.len && !strncmp(msgbuf->buf, sob.buf, sob.len)) has_footer = 3; else - has_footer = has_conforming_footer(msgbuf, &sob, ignore_footer); + has_footer = has_conforming_footer(msgbuf, + append_sob ? &sob : NULL, + ignore_footer); if (!has_footer) { const char *append_newlines = NULL; @@ -1193,9 +1200,17 @@ void append_signoff(struct strbuf *msgbuf, int ignore_footer, unsigned flag) append_newlines, strlen(append_newlines)); } - if (has_footer != 3 && (!no_dup_sob || has_footer != 2)) + if (append_sob && has_footer != 3 && (!no_dup_sob || has_footer != 2)) strbuf_splice(msgbuf, msgbuf->len - ignore_footer, 0, sob.buf, sob.len); + if (extrabuf) + strbuf_insert(msgbuf, msgbuf->len - ignore_footer, + extrabuf->buf, extrabuf->len); strbuf_release(&sob); } + +void append_signoff(struct strbuf *msgbuf, int ignore_footer, unsigned flag) +{ + append_signoff_extra(msgbuf, ignore_footer, flag, NULL); +} diff --git a/sequencer.h b/sequencer.h index 1fc22dc..8716ad0 100644 --- a/sequencer.h +++ b/sequencer.h @@ -7,6 +7,7 @@ #define SEQ_OPTS_FILE "sequencer/opts" #define APPEND_SIGNOFF_DEDUP (1u << 0) +#define APPEND_EXTRA_ONLY (1u << 1) enum replay_action { REPLAY_REVERT, @@ -51,5 +52,7 @@ int sequencer_pick_revisions(struct replay_opts *opts); extern const char sign_off_header[]; void append_signoff(struct strbuf *msgbuf, int ignore_footer, unsigned flag); +void append_signoff_extra(struct strbuf *msgbuf, int ignore_footer, + unsigned flag, struct strbuf *extrabuf); #endif diff --git a/t/t7502-commit.sh b/t/t7502-commit.sh index 6313da2..12b123a 100755 --- a/t/t7502-commit.sh +++ b/t/t7502-commit.sh @@ -137,13 +137,50 @@ test_expect_success 'partial removal' ' ' +signoff_ident () { + git var GIT_COMMITTER_IDENT | sed -e "s/>.*/>/" +} + test_expect_success 'sign off' ' >positive && git add positive && git commit -s -m "thank you" && actual=$(git cat-file commit HEAD | sed -ne "s/Signed-off-by: //p") && - expected=$(git var GIT_COMMITTER_IDENT | sed -e "s/>.*/>/") && + expected=$(signoff_ident) && + test "z$actual" = "z$expected" + +' + +fixes_for_commits () { + for commit in "$@"; do + git -c core.abbrev=12 log -1 --pretty=format:"Fixes: %h ('%s')%n" "$commit" + done +} + +test_expect_success '--fixes' ' + + echo >>positive && + git add positive && + git commit -f HEAD -m "fix bug" && + actual=$(git cat-file commit HEAD | sed -e "1,/^\$/d") && + expected=$(echo fix bug; echo; fixes_for_commits HEAD^) && + test "z$actual" = "z$expected" + +' + +test_expect_success 'multiple --fixes with signoff' ' + + echo >>positive && + git add positive && + git commit -f HEAD^ -f HEAD -s -m "signed bugfix" && + actual=$(git cat-file commit HEAD | sed -e "1,/^\$/d") && + expected=$( + echo signed bugfix + echo + echo "Signed-off-by: $(signoff_ident)" + fixes_for_commits HEAD^^ HEAD^ + ) && test "z$actual" = "z$expected" ' -- 1.8.4.rc3 ^ permalink raw reply related [flat|nested] 49+ messages in thread
* Re: [PATCH] commit: Add -f, --fixes <commit> option to add Fixes: line 2013-10-27 1:34 ` [PATCH] commit: Add -f, --fixes <commit> option to add Fixes: line Josh Triplett @ 2013-10-27 5:42 ` Michael Haggerty 2013-10-27 6:37 ` Theodore Ts'o 2013-10-27 7:14 ` Josh Triplett 2013-10-27 8:33 ` Duy Nguyen ` (3 subsequent siblings) 4 siblings, 2 replies; 49+ messages in thread From: Michael Haggerty @ 2013-10-27 5:42 UTC (permalink / raw) To: Josh Triplett, git Cc: Dan Carpenter, Greg KH, ksummit-2013-discuss, ksummit-attendees, linux-kernel On 10/27/2013 02:34 AM, Josh Triplett wrote: > Linux Kernel Summit 2013 decided on a commit message convention to > identify commits containing bugs fixed by a commit: a "Fixes:" line, > included in the standard commit footer (along with "Signed-off-by:" if > present), containing an abbreviated commit hash (at least 12 characters > to keep it valid for a long time) and the subject of the commit (for > human readers). This helps people (or automated tools) determine how > far to backport a commit. > > Add a command line option for git commit to automatically construct the > "Fixes:" line for a commit. This avoids the need to manually construct > that line by copy-pasting the commit hash and subject. > > Also works with --amend to modify an existing commit's message. To add > a Fixes line to an earlier commit in a series, use rebase -i and add the > following line after the existing commit: > x git commit --amend --no-edit -f $commit_containing_bug > > Generalize append_signoff to support appending arbitrary extra lines to > a commit in the signoff block; this avoids duplicating the logic to find > or construct that block. I have a few comments and questions about the design of this feature: First of all, let me show my ignorance. How formalized is the use of metadata lines at the end of a commit message? I don't remember seeing documentation about such lines in general (as opposed to documentation about particular types of lines). Is the format defined well enough that tools that don't know about a particular line could nonetheless preserve it correctly? Is there/should there be a standard recommended order of metadata lines? (For example, should "Fixes:" lines always appear before "Signed-off-by" lines, or vice versa?) If so, is it documented somewhere and preserved by tools when such lines are added/modified? Should there be support for querying such lines? There is another thread [1] proposing the addition of a "Change-Id:" metadata line, so maybe now would be a good time to discuss such lines in general. Too bad your proposed new option sounds so similar to --fixup, which does something conceptually similar albeit very different in effect. This will likely lead to confusion. I wonder if the two features could be combined in some way? The main difference between the two features is how they are intended to be used: --fixup is to fix a commit that hasn't been pushed yet (where the user intends to squash the commits together), whereas --fixes is to mark a commit as a fix to a commit that has already been pushed (where the commits will remain separate). But there seems to be a common concept here. For example, what happens if a --fixes commit is "rebase -i"ed at the same time as the commit that it fixes? It might make sense to do the autosquash thing just like with a --fixup/--squash commit. (Otherwise the SHA-1 in the "Fixes:" line will become invalid anyway.) Conversely, I suppose one could ask whether there should be some way to prevent "fixup!" or "squash!" commits from being pushed, at least without some kind of --force option. This could of course be enforced by a hook but it might be nice to have some protection by default. I see that there a consistency check that the --fixes argument is a valid commit. But is there/should there be a check that it is an ancestor of the commit being created? Is there/should there be a check that both of these facts remain true if the the commit containing it is rebased, cherry-picked, etc? In workflows that make more use of cherry-picking, it could be that the original buggy commit was cherry-picked to a different branch. In this case the user would probably want to cherry-pick the fixing commit to the other branch, too. But then the commit that it would be fixing would have a different SHA-1 than it did on the original branch. A check that the "Fixes:" line refers to an ancestor of the current commit could warn against such errors. (In some cases it might be possible to use cherry-pick's "-x" lines to figure out how to rewrite the "Fixes:" line, but I doubt that would work often enough to be worthwhile.) > Signed-off-by: Josh Triplett <josh@joshtriplett.org> > --- > Documentation/git-commit.txt | 12 ++++++++++-- > builtin/commit.c | 29 +++++++++++++++++++++++++++-- > sequencer.c | 31 +++++++++++++++++++++++-------- > sequencer.h | 3 +++ > t/t7502-commit.sh | 39 ++++++++++++++++++++++++++++++++++++++- > 5 files changed, 101 insertions(+), 13 deletions(-) > > diff --git a/Documentation/git-commit.txt b/Documentation/git-commit.txt > index 1a7616c..fcc6ed2 100644 > --- a/Documentation/git-commit.txt > +++ b/Documentation/git-commit.txt > @@ -8,8 +8,8 @@ git-commit - Record changes to the repository > SYNOPSIS > -------- > [verse] > -'git commit' [-a | --interactive | --patch] [-s] [-v] [-u<mode>] [--amend] > - [--dry-run] [(-c | -C | --fixup | --squash) <commit>] > +'git commit' [-a | --interactive | --patch] [-s] [-f <commit>] [-v] [-u<mode>] > + [--amend] [--dry-run] [(-c | -C | --fixup | --squash) <commit>] You mention only "-f", not "--fixes" here. But I don't think that this feature should be given the "-f" short option, as (a) -f often means "force"; (b) it will increase the confusion with --fixup; (c) it just doesn't strike me as being likely to be such a frequently-used option (though if this changes over time the "-f" option could always be granted to it later). > [-F <file> | -m <msg>] [--reset-author] [--allow-empty] > [--allow-empty-message] [--no-verify] [-e] [--author=<author>] > [--date=<date>] [--cleanup=<mode>] [--[no-]status] > @@ -156,6 +156,14 @@ OPTIONS > Add Signed-off-by line by the committer at the end of the commit > log message. > > +-f <commit>:: > +--fixes=<commit>:: > + Add Fixes line for the specified commit at the end of the commit > + log message. This line includes an abbreviated commit hash for > + the specified commit; the `core.abbrev` option determines the > + length of the abbreviated commit hash used, with a minimum length > + of 12 hex digits. > + You might also mention that the "Fixes:" line includes the old commit's subject line. > -n:: > --no-verify:: > This option bypasses the pre-commit and commit-msg hooks. > diff --git a/builtin/commit.c b/builtin/commit.c > index 6ab4605..9bbcd8a 100644 > --- a/builtin/commit.c > +++ b/builtin/commit.c > @@ -123,6 +123,7 @@ static int use_editor = 1, include_status = 1; > static int show_ignored_in_status, have_option_m; > static const char *only_include_assumed; > static struct strbuf message = STRBUF_INIT; > +static struct strbuf fixes = STRBUF_INIT; > > static enum status_format { > STATUS_FORMAT_NONE = 0, > @@ -133,6 +134,28 @@ static enum status_format { > STATUS_FORMAT_UNSPECIFIED > } status_format = STATUS_FORMAT_UNSPECIFIED; > > +static int opt_parse_f(const struct option *opt, const char *arg, int unset) > +{ > + struct strbuf *sb = opt->value; > + if (unset) { > + strbuf_setlen(sb, 0); > + } else { > + struct pretty_print_context ctx = {0}; > + struct commit *commit; > + > + commit = lookup_commit_reference_by_name(arg); > + if (!commit) > + die(_("could not lookup commit %s"), arg); > + ctx.output_encoding = get_commit_output_encoding(); > + ctx.abbrev = DEFAULT_ABBREV; > + if (ctx.abbrev < 12) > + ctx.abbrev = 12; > + format_commit_message(commit, "Fixes: %h ('%s')\n", sb, &ctx); > + } > + > + return 0; > +} > + > static int opt_parse_m(const struct option *opt, const char *arg, int unset) > { > struct strbuf *buf = opt->value; > @@ -718,7 +741,7 @@ static int prepare_to_commit(const char *index_file, const char *prefix, > if (clean_message_contents) > stripspace(&sb, 0); > > - if (signoff) { > + if (signoff || fixes.len) { > /* > * See if we have a Conflicts: block at the end. If yes, count > * its size, so we can ignore it. > @@ -742,7 +765,8 @@ static int prepare_to_commit(const char *index_file, const char *prefix, > previous = eol; > } > > - append_signoff(&sb, ignore_footer, 0); > + append_signoff_extra(&sb, ignore_footer, > + signoff ? 0 : APPEND_EXTRA_ONLY, &fixes); > } > > if (fwrite(sb.buf, 1, sb.len, s->fp) < sb.len) > @@ -1463,6 +1487,7 @@ int cmd_commit(int argc, const char **argv, const char *prefix) > OPT_STRING(0, "squash", &squash_message, N_("commit"), N_("use autosquash formatted message to squash specified commit")), > OPT_BOOL(0, "reset-author", &renew_authorship, N_("the commit is authored by me now (used with -C/-c/--amend)")), > OPT_BOOL('s', "signoff", &signoff, N_("add Signed-off-by:")), > + OPT_CALLBACK('f', "fixes", &fixes, N_("commit"), N_("add Fixes: for the specified commit"), opt_parse_f), > OPT_FILENAME('t', "template", &template_file, N_("use specified template file")), > OPT_BOOL('e', "edit", &edit_flag, N_("force edit of commit")), > OPT_STRING(0, "cleanup", &cleanup_arg, N_("default"), N_("how to strip spaces and #comments from message")), > diff --git a/sequencer.c b/sequencer.c > index 06e52b4..f4cf0e1 100644 > --- a/sequencer.c > +++ b/sequencer.c > @@ -1135,26 +1135,33 @@ int sequencer_pick_revisions(struct replay_opts *opts) > return pick_commits(todo_list, opts); > } > > -void append_signoff(struct strbuf *msgbuf, int ignore_footer, unsigned flag) > +void append_signoff_extra(struct strbuf *msgbuf, int ignore_footer, > + unsigned flag, struct strbuf *extrabuf) > { > unsigned no_dup_sob = flag & APPEND_SIGNOFF_DEDUP; > + unsigned append_sob = !(flag & APPEND_EXTRA_ONLY); > struct strbuf sob = STRBUF_INIT; > int has_footer; > > - strbuf_addstr(&sob, sign_off_header); > - strbuf_addstr(&sob, fmt_name(getenv("GIT_COMMITTER_NAME"), > - getenv("GIT_COMMITTER_EMAIL"))); > - strbuf_addch(&sob, '\n'); > + if (append_sob) { > + strbuf_addstr(&sob, sign_off_header); > + strbuf_addstr(&sob, fmt_name(getenv("GIT_COMMITTER_NAME"), > + getenv("GIT_COMMITTER_EMAIL"))); > + strbuf_addch(&sob, '\n'); > + } > > /* > * If the whole message buffer is equal to the sob, pretend that we > * found a conforming footer with a matching sob > */ > - if (msgbuf->len - ignore_footer == sob.len && > + if (append_sob && > + msgbuf->len - ignore_footer == sob.len && > !strncmp(msgbuf->buf, sob.buf, sob.len)) > has_footer = 3; > else > - has_footer = has_conforming_footer(msgbuf, &sob, ignore_footer); > + has_footer = has_conforming_footer(msgbuf, > + append_sob ? &sob : NULL, > + ignore_footer); > > if (!has_footer) { > const char *append_newlines = NULL; > @@ -1193,9 +1200,17 @@ void append_signoff(struct strbuf *msgbuf, int ignore_footer, unsigned flag) > append_newlines, strlen(append_newlines)); > } > > - if (has_footer != 3 && (!no_dup_sob || has_footer != 2)) > + if (append_sob && has_footer != 3 && (!no_dup_sob || has_footer != 2)) > strbuf_splice(msgbuf, msgbuf->len - ignore_footer, 0, > sob.buf, sob.len); > + if (extrabuf) > + strbuf_insert(msgbuf, msgbuf->len - ignore_footer, > + extrabuf->buf, extrabuf->len); > > strbuf_release(&sob); > } > + > +void append_signoff(struct strbuf *msgbuf, int ignore_footer, unsigned flag) > +{ > + append_signoff_extra(msgbuf, ignore_footer, flag, NULL); > +} > diff --git a/sequencer.h b/sequencer.h > index 1fc22dc..8716ad0 100644 > --- a/sequencer.h > +++ b/sequencer.h > @@ -7,6 +7,7 @@ > #define SEQ_OPTS_FILE "sequencer/opts" > > #define APPEND_SIGNOFF_DEDUP (1u << 0) > +#define APPEND_EXTRA_ONLY (1u << 1) > > enum replay_action { > REPLAY_REVERT, > @@ -51,5 +52,7 @@ int sequencer_pick_revisions(struct replay_opts *opts); > extern const char sign_off_header[]; > > void append_signoff(struct strbuf *msgbuf, int ignore_footer, unsigned flag); > +void append_signoff_extra(struct strbuf *msgbuf, int ignore_footer, > + unsigned flag, struct strbuf *extrabuf); > > #endif > diff --git a/t/t7502-commit.sh b/t/t7502-commit.sh > index 6313da2..12b123a 100755 > --- a/t/t7502-commit.sh > +++ b/t/t7502-commit.sh > @@ -137,13 +137,50 @@ test_expect_success 'partial removal' ' > > ' > > +signoff_ident () { > + git var GIT_COMMITTER_IDENT | sed -e "s/>.*/>/" > +} > + > test_expect_success 'sign off' ' > > >positive && > git add positive && > git commit -s -m "thank you" && > actual=$(git cat-file commit HEAD | sed -ne "s/Signed-off-by: //p") && > - expected=$(git var GIT_COMMITTER_IDENT | sed -e "s/>.*/>/") && > + expected=$(signoff_ident) && > + test "z$actual" = "z$expected" > + > +' > + > +fixes_for_commits () { > + for commit in "$@"; do > + git -c core.abbrev=12 log -1 --pretty=format:"Fixes: %h ('%s')%n" "$commit" > + done > +} > + > +test_expect_success '--fixes' ' > + > + echo >>positive && > + git add positive && > + git commit -f HEAD -m "fix bug" && > + actual=$(git cat-file commit HEAD | sed -e "1,/^\$/d") && > + expected=$(echo fix bug; echo; fixes_for_commits HEAD^) && > + test "z$actual" = "z$expected" > + > +' > + > +test_expect_success 'multiple --fixes with signoff' ' > + > + echo >>positive && > + git add positive && > + git commit -f HEAD^ -f HEAD -s -m "signed bugfix" && > + actual=$(git cat-file commit HEAD | sed -e "1,/^\$/d") && > + expected=$( > + echo signed bugfix > + echo > + echo "Signed-off-by: $(signoff_ident)" > + fixes_for_commits HEAD^^ HEAD^ > + ) && > test "z$actual" = "z$expected" > > ' > Michael [1] http://thread.gmane.org/gmane.comp.version-control.git/236429/focus=236582 -- Michael Haggerty mhagger@alum.mit.edu http://softwareswirl.blogspot.com/ ^ permalink raw reply [flat|nested] 49+ messages in thread
* Re: [PATCH] commit: Add -f, --fixes <commit> option to add Fixes: line 2013-10-27 5:42 ` Michael Haggerty @ 2013-10-27 6:37 ` Theodore Ts'o 2013-10-27 7:14 ` Josh Triplett 1 sibling, 0 replies; 49+ messages in thread From: Theodore Ts'o @ 2013-10-27 6:37 UTC (permalink / raw) To: Michael Haggerty Cc: Josh Triplett, git, Dan Carpenter, Greg KH, ksummit-2013-discuss, ksummit-attendees, linux-kernel One of the uses of the Fixes commit line is so that when we fix a security bug that has been in mainline for a while, it can be tricky to determine whether it should be backported in to the various stable branches. For example, let's suppose the security bug (or any bug, but one of the contexts where this came up was for security fixes) was introduced in 3.5, and backported into the 3.2.x kernel series, but couldn't be applied into the 3.2.0 kernel series. The security fix was introduced in 3.12, and so it would be obvious that it should be backported to the 3.10 kernel series, but it might not be so obvious that it would also be required for the 3.2.x long-term stable series. So the inclusion of the Fixes: line provides this critical bit of information. It's also useful not just for the long-term stable tree maintainers, but the maintainers of distro kernels would also find it to be very useful. > I see that there a consistency check that the --fixes argument is a > valid commit. But is there/should there be a check that it is an > ancestor of the commit being created? Is there/should there be a check > that both of these facts remain true if the the commit containing it is > rebased, cherry-picked, etc? > > In workflows that make more use of cherry-picking, it could be that the > original buggy commit was cherry-picked to a different branch. In this > case the user would probably want to cherry-pick the fixing commit to > the other branch, too. But then the commit that it would be fixing > would have a different SHA-1 than it did on the original branch. A > check that the "Fixes:" line refers to an ancestor of the current commit > could warn against such errors. (In some cases it might be possible to > use cherry-pick's "-x" lines to figure out how to rewrite the "Fixes:" > line, but I doubt that would work often enough to be worthwhile.) I believe that in the discussions we had, it was assumed that the Fixes: line would reference the commit in the mainline kernel tree. i.e., it would always reference the commit which introduced the bug in 3.5, even if the commit-id after the buggy commit was backported to 3.2.x would obviously be different. Presumably the distro kernel maintainer would be able to find the commit in Linus's tree and then try to find the corresponding commit in the distro kernel git tree, probably by doing string searches over "git log". We could actually do a much more elegant job if we did have the concept of commit identity (i.e., ChangeID's) baked into git. That way, there would be a constant ChangeID that would remain constant not only across revisions of a patch under development, but also when the commit is cherry picked into stable branches. If we had that, then instead of doing string searches on git log output, we could imagine a web and/or command line interface where given a ChangeID, it would tell you which branches or which tags contained the same semantic patch. Of course, as soon as you do that, then if the multiple commits get squashed together, you might need to have to support multiple ChangeID's associated with one commit, at which point it becomes incompatible with Gerrit's use of this feature. So we could add all sorts of complexity, but it's not obvious to me that it's worth it. > First of all, let me show my ignorance. How formalized is the use of > metadata lines at the end of a commit message? I don't remember seeing > documentation about such lines in general (as opposed to documentation > about particular types of lines). Is the format defined well enough > that tools that don't know about a particular line could nonetheless > preserve it correctly? Is there/should there be a standard recommended > order of metadata lines? (For example, should "Fixes:" lines always > appear before "Signed-off-by" lines, or vice versa?) If so, is it > documented somewhere and preserved by tools when such lines are > added/modified? Should there be support for querying such lines? Internally inside Google, we have tools that will assist in forward porting local changes from a 3.x based kernel to a 3.y kernel, to make sure that all local changes are properly accounted for and none are accidentally dropped during the rebase operation. So we have various new metadata lines that we add internally, for example: Upstream-3.x-SHA1: <commit-id> for commits in newer kernels that have been backported Origin-3.x-SHA1: <commit-id> to indicate the commit-id of a patch that was forward ported as part of a rebase operation from 3.x to 3.9 Upstream-Dropped-3.x-SHA1: <commit-id> As part of an empty commit to indicate that a patch that was originally in our tree, has since been pushed upstream, so we can drop it as part of the rebase to the 3.y kernel. etc. Other projects have various metadata lines to reference a bug-tracker id number; folks may have seen commits with various metadata id's in public git repositories such as: Google-Bug-Id: 12345 BugLink: https://bugzilla.kernel.org/show_bug.cgi?id=62261 Addresses-Debian-Bug: #698879 These are clearly much less standardized, and are probably used more for human consumption than for any kind of automated tooling. They are out there, though, so it indicates that there definitely is a need for such things. I'm not entirely convinced that it's worth it to try to formalize this more than what we already have, but perhaps there's some killer new feature, such as better gitweb / Gerrit / Bugzilla integration, that could be added if this stuff was more formalized. Cheers, - Ted ^ permalink raw reply [flat|nested] 49+ messages in thread
* Re: [PATCH] commit: Add -f, --fixes <commit> option to add Fixes: line 2013-10-27 5:42 ` Michael Haggerty 2013-10-27 6:37 ` Theodore Ts'o @ 2013-10-27 7:14 ` Josh Triplett 2013-10-27 8:03 ` [Ksummit-2013-discuss] " Michel Lespinasse ` (2 more replies) 1 sibling, 3 replies; 49+ messages in thread From: Josh Triplett @ 2013-10-27 7:14 UTC (permalink / raw) To: Michael Haggerty Cc: git, Dan Carpenter, Greg KH, ksummit-2013-discuss, ksummit-attendees, linux-kernel On Sun, Oct 27, 2013 at 06:42:44AM +0100, Michael Haggerty wrote: > On 10/27/2013 02:34 AM, Josh Triplett wrote: > > Linux Kernel Summit 2013 decided on a commit message convention to > > identify commits containing bugs fixed by a commit: a "Fixes:" line, > > included in the standard commit footer (along with "Signed-off-by:" if > > present), containing an abbreviated commit hash (at least 12 characters > > to keep it valid for a long time) and the subject of the commit (for > > human readers). This helps people (or automated tools) determine how > > far to backport a commit. > > > > Add a command line option for git commit to automatically construct the > > "Fixes:" line for a commit. This avoids the need to manually construct > > that line by copy-pasting the commit hash and subject. > > > > Also works with --amend to modify an existing commit's message. To add > > a Fixes line to an earlier commit in a series, use rebase -i and add the > > following line after the existing commit: > > x git commit --amend --no-edit -f $commit_containing_bug > > > > Generalize append_signoff to support appending arbitrary extra lines to > > a commit in the signoff block; this avoids duplicating the logic to find > > or construct that block. > > I have a few comments and questions about the design of this feature: > > First of all, let me show my ignorance. How formalized is the use of > metadata lines at the end of a commit message? I don't remember seeing > documentation about such lines in general (as opposed to documentation > about particular types of lines). Is the format defined well enough > that tools that don't know about a particular line could nonetheless > preserve it correctly? Is there/should there be a standard recommended > order of metadata lines? (For example, should "Fixes:" lines always > appear before "Signed-off-by" lines, or vice versa?) If so, is it > documented somewhere and preserved by tools when such lines are > added/modified? Should there be support for querying such lines? While it isn't very well documented in git itself, metadata lines are quite standardized. See Documentation/SubmittingPatches and Documentation/development-process/5.Posting in the Linux kernel, for an explanation of "Reported-by:", "Tested-by:", "Reviewed-by:", "Suggested-by:", and "Acked-by:". And git itself looks for a very specific format; the has_conforming_footer function looks for a footer consisting exclusively of rfc2822-style (email-style) header lines to decide whether to append "Signed-off-by:" (and now "Fixes:") directly to that block or to create a new block. I do think there should be additional support for such lines in git, such as a git commit option to add "Cc:" lines (via a --cc-cmd like get_maintainer.pl run at commit time), or fast options in rebase -i to append arbitrary footer lines to a commit. > Too bad your proposed new option sounds so similar to --fixup, which > does something conceptually similar albeit very different in effect. > This will likely lead to confusion. Given that the line is named "Fixes:", I don't think the name of the option will extend the confusion any further. :) > I wonder if the two features could > be combined in some way? > > The main difference between the two features is how they are intended to > be used: --fixup is to fix a commit that hasn't been pushed yet (where > the user intends to squash the commits together), whereas --fixes is to > mark a commit as a fix to a commit that has already been pushed (where > the commits will remain separate). But there seems to be a common > concept here. > > For example, what happens if a --fixes commit is "rebase -i"ed at the > same time as the commit that it fixes? It might make sense to do the > autosquash thing just like with a --fixup/--squash commit. (Otherwise > the SHA-1 in the "Fixes:" line will become invalid anyway.) Most definitely not, no, at least not without an explicit option to enable that. Consider the case of backporting a series of patches and preserving the relative history of those patches, to make it easier to match up a set of patches. At most, it might be a good idea for cherry-pick or similar to provide an updated Fixes tag for the new hash of the older commit. Personally, I'd argue against doing this even with --autosquash. I could see the argument for an --autosquash-fixes, but I can't think of a real-world scenario where what would come up. Generally, if history is still editable, you should just squash in the fix to the original commit, and if history is no longer editable (which is the use case for "Fixes:" lines), the squash case simply won't come up, offering little point to adding special support for that case. > Conversely, I suppose one could ask whether there should be some way to > prevent "fixup!" or "squash!" commits from being pushed, at least > without some kind of --force option. This could of course be enforced > by a hook but it might be nice to have some protection by default. That's a good idea, but unrelated to this patch. And yes, a hook seems like the right answer there. > I see that there a consistency check that the --fixes argument is a > valid commit. But is there/should there be a check that it is an > ancestor of the commit being created? Is there/should there be a check > that both of these facts remain true if the the commit containing it is > rebased, cherry-picked, etc? That sounds like a nice future enhancement, sure. I don't have any plans to add such a check myself, though. Also note that --fixup and --squash don't have such a check either; if you want to add one, you should add it for all three options at once. > In workflows that make more use of cherry-picking, it could be that the > original buggy commit was cherry-picked to a different branch. In this > case the user would probably want to cherry-pick the fixing commit to > the other branch, too. But then the commit that it would be fixing > would have a different SHA-1 than it did on the original branch. A > check that the "Fixes:" line refers to an ancestor of the current commit > could warn against such errors. (In some cases it might be possible to > use cherry-pick's "-x" lines to figure out how to rewrite the "Fixes:" > line, but I doubt that would work often enough to be worthwhile.) That also sounds like a plausible future enhancement. :) I do like the idea of warning when a cherry-pick grabs a subsequently-fixed commit and not the fix; that seems quite useful. > > Signed-off-by: Josh Triplett <josh@joshtriplett.org> > > --- > > Documentation/git-commit.txt | 12 ++++++++++-- > > builtin/commit.c | 29 +++++++++++++++++++++++++++-- > > sequencer.c | 31 +++++++++++++++++++++++-------- > > sequencer.h | 3 +++ > > t/t7502-commit.sh | 39 ++++++++++++++++++++++++++++++++++++++- > > 5 files changed, 101 insertions(+), 13 deletions(-) > > > > diff --git a/Documentation/git-commit.txt b/Documentation/git-commit.txt > > index 1a7616c..fcc6ed2 100644 > > --- a/Documentation/git-commit.txt > > +++ b/Documentation/git-commit.txt > > @@ -8,8 +8,8 @@ git-commit - Record changes to the repository > > SYNOPSIS > > -------- > > [verse] > > -'git commit' [-a | --interactive | --patch] [-s] [-v] [-u<mode>] [--amend] > > - [--dry-run] [(-c | -C | --fixup | --squash) <commit>] > > +'git commit' [-a | --interactive | --patch] [-s] [-f <commit>] [-v] [-u<mode>] > > + [--amend] [--dry-run] [(-c | -C | --fixup | --squash) <commit>] > > You mention only "-f", not "--fixes" here. -u also has --untracked-files, and -e has --edit; synopsis lines like these normally show the shortest version of each option. > But I don't think that this feature should be given the "-f" short > option, as (a) -f often means "force"; (b) it will increase the > confusion with --fixup; (c) it just doesn't strike me as being likely to > be such a frequently-used option (though if this changes over time the > "-f" option could always be granted to it later). (a) -n often means --dry-run, but for commit it means --no-verify. Different commands have different options, and commit doesn't have a --force to abbreviate as -f. (b) If anything, I think the existence of a short option will make the distinction more obvious, since -f and --fixup are much less similar than --fixes and --fixup. Most users will never type --fixes, making confusion unlikely. (c) Short option letters tend to be first-come first-serve unless there's a strong reason to do otherwise. Why reserve 'f' for some hypothetical future option that doesn't exist yet? > > [-F <file> | -m <msg>] [--reset-author] [--allow-empty] > > [--allow-empty-message] [--no-verify] [-e] [--author=<author>] > > [--date=<date>] [--cleanup=<mode>] [--[no-]status] > > @@ -156,6 +156,14 @@ OPTIONS > > Add Signed-off-by line by the committer at the end of the commit > > log message. > > > > +-f <commit>:: > > +--fixes=<commit>:: > > + Add Fixes line for the specified commit at the end of the commit > > + log message. This line includes an abbreviated commit hash for > > + the specified commit; the `core.abbrev` option determines the > > + length of the abbreviated commit hash used, with a minimum length > > + of 12 hex digits. > > + > > You might also mention that the "Fixes:" line includes the old commit's > subject line. I only mentioned the abbreviated commit hash because it was necessary to explain the factors affecting hash length. -s, above, doesn't mention that the Signed-off-by line includes the name and email address of the committer. - Josh Triplett ^ permalink raw reply [flat|nested] 49+ messages in thread
* Re: [Ksummit-2013-discuss] [PATCH] commit: Add -f, --fixes <commit> option to add Fixes: line 2013-10-27 7:14 ` Josh Triplett @ 2013-10-27 8:03 ` Michel Lespinasse 2013-10-27 9:23 ` Josh Triplett 2013-10-27 8:09 ` Thomas Rast 2013-10-28 9:02 ` [PATCH] commit: Add -f, --fixes <commit> option to add Fixes: line Michael Haggerty 2 siblings, 1 reply; 49+ messages in thread From: Michel Lespinasse @ 2013-10-27 8:03 UTC (permalink / raw) To: Josh Triplett Cc: Michael Haggerty, ksummit-2013-discuss, LKML, ksummit-attendees, Git Mailing List, Dan Carpenter On Sun, Oct 27, 2013 at 12:14 AM, Josh Triplett <josh@joshtriplett.org> wrote: >> > +-f <commit>:: >> > +--fixes=<commit>:: >> > + Add Fixes line for the specified commit at the end of the commit >> > + log message. This line includes an abbreviated commit hash for >> > + the specified commit; the `core.abbrev` option determines the >> > + length of the abbreviated commit hash used, with a minimum length >> > + of 12 hex digits. >> >> You might also mention that the "Fixes:" line includes the old commit's >> subject line. > > I only mentioned the abbreviated commit hash because it was necessary to > explain the factors affecting hash length. -s, above, doesn't mention > that the Signed-off-by line includes the name and email address of the > committer. I do wonder, if we're going to bake into git the idea that too-short abbreviated sha1s don't make sense, why don't we just change the core.abbrev default to 12 everywhere rather than just in this one command ? -- Michel "Walken" Lespinasse A program is never fully debugged until the last user dies. ^ permalink raw reply [flat|nested] 49+ messages in thread
* Re: [Ksummit-2013-discuss] [PATCH] commit: Add -f, --fixes <commit> option to add Fixes: line 2013-10-27 8:03 ` [Ksummit-2013-discuss] " Michel Lespinasse @ 2013-10-27 9:23 ` Josh Triplett 0 siblings, 0 replies; 49+ messages in thread From: Josh Triplett @ 2013-10-27 9:23 UTC (permalink / raw) To: Michel Lespinasse Cc: Michael Haggerty, ksummit-2013-discuss, LKML, ksummit-attendees, Git Mailing List, Dan Carpenter On Sun, Oct 27, 2013 at 01:03:47AM -0700, Michel Lespinasse wrote: > On Sun, Oct 27, 2013 at 12:14 AM, Josh Triplett <josh@joshtriplett.org> wrote: > >> > +-f <commit>:: > >> > +--fixes=<commit>:: > >> > + Add Fixes line for the specified commit at the end of the commit > >> > + log message. This line includes an abbreviated commit hash for > >> > + the specified commit; the `core.abbrev` option determines the > >> > + length of the abbreviated commit hash used, with a minimum length > >> > + of 12 hex digits. > >> > >> You might also mention that the "Fixes:" line includes the old commit's > >> subject line. > > > > I only mentioned the abbreviated commit hash because it was necessary to > > explain the factors affecting hash length. -s, above, doesn't mention > > that the Signed-off-by line includes the name and email address of the > > committer. > > I do wonder, if we're going to bake into git the idea that too-short > abbreviated sha1s don't make sense, why don't we just change the > core.abbrev default to 12 everywhere rather than just in this one > command ? You won't get any argument from me on that one. I personally would have argued for making the hashes 40 characters always, but in any case bumping up the default (and minimum) for core.abbrev seems entirely sensible. - Josh Triplett ^ permalink raw reply [flat|nested] 49+ messages in thread
* Re: [PATCH] commit: Add -f, --fixes <commit> option to add Fixes: line 2013-10-27 7:14 ` Josh Triplett 2013-10-27 8:03 ` [Ksummit-2013-discuss] " Michel Lespinasse @ 2013-10-27 8:09 ` Thomas Rast 2013-10-27 9:20 ` Josh Triplett 2013-10-27 9:26 ` Stefan Beller 2013-10-28 9:02 ` [PATCH] commit: Add -f, --fixes <commit> option to add Fixes: line Michael Haggerty 2 siblings, 2 replies; 49+ messages in thread From: Thomas Rast @ 2013-10-27 8:09 UTC (permalink / raw) To: Josh Triplett Cc: Michael Haggerty, git, Dan Carpenter, Greg KH, ksummit-2013-discuss, ksummit-attendees, linux-kernel Josh Triplett <josh@joshtriplett.org> writes: > On Sun, Oct 27, 2013 at 06:42:44AM +0100, Michael Haggerty wrote: >> But I don't think that this feature should be given the "-f" short >> option, as (a) -f often means "force"; (b) it will increase the >> confusion with --fixup; (c) it just doesn't strike me as being likely to >> be such a frequently-used option (though if this changes over time the >> "-f" option could always be granted to it later). > > (a) -n often means --dry-run, but for commit it means --no-verify. > Different commands have different options, and commit doesn't have a > --force to abbreviate as -f. > > (b) If anything, I think the existence of a short option will make the > distinction more obvious, since -f and --fixup are much less similar > than --fixes and --fixup. Most users will never type --fixes, making > confusion unlikely. > > (c) Short option letters tend to be first-come first-serve unless > there's a strong reason to do otherwise. Why reserve 'f' for some > hypothetical future option that doesn't exist yet? No, lately the direction in Git has been to avoid giving options a one-letter shorthand until they have proven so useful that people using it in the wild start to suggest that it should have one. See e.g. http://article.gmane.org/gmane.comp.version-control.git/233998 http://article.gmane.org/gmane.comp.version-control.git/168748 A much better argument would be if it was already clear from the specs laid out for Fixes that n% of the kernel commits will end up having this footer, and thus kernel hackers will spend x amount of time spelling out --fixes and/or confusing it with --fixup to much headache. -- Thomas Rast tr@thomasrast.ch ^ permalink raw reply [flat|nested] 49+ messages in thread
* Re: [PATCH] commit: Add -f, --fixes <commit> option to add Fixes: line 2013-10-27 8:09 ` Thomas Rast @ 2013-10-27 9:20 ` Josh Triplett 2013-10-27 10:59 ` Johan Herland 2013-10-27 9:26 ` Stefan Beller 1 sibling, 1 reply; 49+ messages in thread From: Josh Triplett @ 2013-10-27 9:20 UTC (permalink / raw) To: Thomas Rast Cc: Michael Haggerty, git, Dan Carpenter, Greg KH, ksummit-2013-discuss, ksummit-attendees, linux-kernel On Sun, Oct 27, 2013 at 09:09:32AM +0100, Thomas Rast wrote: > Josh Triplett <josh@joshtriplett.org> writes: > > > On Sun, Oct 27, 2013 at 06:42:44AM +0100, Michael Haggerty wrote: > >> But I don't think that this feature should be given the "-f" short > >> option, as (a) -f often means "force"; (b) it will increase the > >> confusion with --fixup; (c) it just doesn't strike me as being likely to > >> be such a frequently-used option (though if this changes over time the > >> "-f" option could always be granted to it later). > > > > (a) -n often means --dry-run, but for commit it means --no-verify. > > Different commands have different options, and commit doesn't have a > > --force to abbreviate as -f. > > > > (b) If anything, I think the existence of a short option will make the > > distinction more obvious, since -f and --fixup are much less similar > > than --fixes and --fixup. Most users will never type --fixes, making > > confusion unlikely. > > > > (c) Short option letters tend to be first-come first-serve unless > > there's a strong reason to do otherwise. Why reserve 'f' for some > > hypothetical future option that doesn't exist yet? > > No, lately the direction in Git has been to avoid giving options a > one-letter shorthand until they have proven so useful that people using > it in the wild start to suggest that it should have one. > > See e.g. > > http://article.gmane.org/gmane.comp.version-control.git/233998 > http://article.gmane.org/gmane.comp.version-control.git/168748 Fair enough; easy enough to drop -f if that's the consensus. However... > A much better argument would be if it was already clear from the specs > laid out for Fixes that n% of the kernel commits will end up having this > footer, and thus kernel hackers will spend x amount of time spelling out > --fixes and/or confusing it with --fixup to much headache. ...good suggestion: ~/src/linux$ git log --grep='stable@' --oneline --since='1 year ago' | wc -l 2769 ~/src/linux$ git log --grep='stable@' --oneline --since='1 year ago' --pretty=format:%an | sort -u | wc -l 839 Several thousand commits per year by hundreds of unique people seems like enough to justify a short option. - Josh Triplett ^ permalink raw reply [flat|nested] 49+ messages in thread
* Re: [PATCH] commit: Add -f, --fixes <commit> option to add Fixes: line 2013-10-27 9:20 ` Josh Triplett @ 2013-10-27 10:59 ` Johan Herland 2013-10-27 19:10 ` Christian Couder 0 siblings, 1 reply; 49+ messages in thread From: Johan Herland @ 2013-10-27 10:59 UTC (permalink / raw) To: Josh Triplett Cc: Thomas Rast, Michael Haggerty, Git mailing list, Dan Carpenter, Greg KH, ksummit-2013-discuss, ksummit-attendees, Linux Kernel mailing list On Sun, Oct 27, 2013 at 10:20 AM, Josh Triplett <josh@joshtriplett.org> wrote: > On Sun, Oct 27, 2013 at 09:09:32AM +0100, Thomas Rast wrote: >> Josh Triplett <josh@joshtriplett.org> writes: >> > On Sun, Oct 27, 2013 at 06:42:44AM +0100, Michael Haggerty wrote: >> >> But I don't think that this feature should be given the "-f" short >> >> option, as (a) -f often means "force"; (b) it will increase the >> >> confusion with --fixup; (c) it just doesn't strike me as being likely to >> >> be such a frequently-used option (though if this changes over time the >> >> "-f" option could always be granted to it later). >> > >> > (a) -n often means --dry-run, but for commit it means --no-verify. >> > Different commands have different options, and commit doesn't have a >> > --force to abbreviate as -f. >> > >> > (b) If anything, I think the existence of a short option will make the >> > distinction more obvious, since -f and --fixup are much less similar >> > than --fixes and --fixup. Most users will never type --fixes, making >> > confusion unlikely. >> > >> > (c) Short option letters tend to be first-come first-serve unless >> > there's a strong reason to do otherwise. Why reserve 'f' for some >> > hypothetical future option that doesn't exist yet? >> >> No, lately the direction in Git has been to avoid giving options a >> one-letter shorthand until they have proven so useful that people using >> it in the wild start to suggest that it should have one. >> >> See e.g. >> >> http://article.gmane.org/gmane.comp.version-control.git/233998 >> http://article.gmane.org/gmane.comp.version-control.git/168748 > > Fair enough; easy enough to drop -f if that's the consensus. However... > >> A much better argument would be if it was already clear from the specs >> laid out for Fixes that n% of the kernel commits will end up having this >> footer, and thus kernel hackers will spend x amount of time spelling out >> --fixes and/or confusing it with --fixup to much headache. > > ...good suggestion: > > ~/src/linux$ git log --grep='stable@' --oneline --since='1 year ago' | wc -l > 2769 > ~/src/linux$ git log --grep='stable@' --oneline --since='1 year ago' --pretty=format:%an | sort -u | wc -l > 839 > > Several thousand commits per year by hundreds of unique people seems > like enough to justify a short option. I think this can be solved just as well (if not better) using a combination of a commit message template (or a prepare-commit-msg hook) and a commit-msg hook. The former appends a section of commonly-used RFC822-style headers (with empty values) to the bottom of the commit message, e.g. some variation on this: Fixes: Reported-by: Suggested-by: Improved-by: Acked-by: Reviewed-by: Tested-by: Signed-off-by: Then the user (in addition to writing the commit message above this block) may choose to fill in one or more values in this "form", e.g. like this: My commit subject This is the commit message body. Fixes: 1234beef Reported-by: Joe User <j.user@example.com> Suggested-by: Improved-by: Joe Hacker <j.hacker@example.com> Acked-by: Reviewed-by: Tested-by: Joe Tester <j.tester@example.com> Signed-off-by: Myself <myself@example.com> Then, the commit-msg hook can clean up and transform this into the final commit message: My commit subject This is the commit message body. Fixes: 1234beef56 (Commit message summmary) Reported-by: Joe User <j.user@example.com> Improved-by: Joe Hacker <j.hacker@example.com> Tested-by: Joe Tester <j.tester@example.com> Signed-off-by: Myself <myself@example.com> Here, the commit-msg hook removes the fields that were not filled in, and performs additional filtering on the "Fixes" line (Adding commit message summary). The filtering could also resolve ref names, so that if you had refs/tags/security-bug pointing at the buggy commit, then: Fixes: security-bug would be expanded/DWIMed into: Fixes: 1234beef56 (Commit message summmary) Obviously, any other fancy processing you want to do into in the commit-msg hook can be done as well, adding footnotes, checking that commits are present in the ancestry, etc, etc. Three good reasons to go this way: 1. If the user forgets to supply command-line options like -s, --fixes, etc, there is a nice reminder in the supplied form. 2. No need to add any command-line options to Git. 3. The whole mechanism is controlled by the project. The kernel folks can do whatever they want in their templates/hooks without needing changes to the Git project. ...Johan -- Johan Herland, <johan@herland.net> www.herland.net ^ permalink raw reply [flat|nested] 49+ messages in thread
* Re: [PATCH] commit: Add -f, --fixes <commit> option to add Fixes: line 2013-10-27 10:59 ` Johan Herland @ 2013-10-27 19:10 ` Christian Couder 2013-10-28 2:46 ` Johan Herland 0 siblings, 1 reply; 49+ messages in thread From: Christian Couder @ 2013-10-27 19:10 UTC (permalink / raw) To: Johan Herland Cc: Josh Triplett, Thomas Rast, Michael Haggerty, Git mailing list, Dan Carpenter, Greg KH, ksummit-2013-discuss, ksummit-attendees, Linux Kernel mailing list [Sorry I already sent the reply below to Johan only instead of everyone.] Hi Johan, On Sun, Oct 27, 2013 at 11:59 AM, Johan Herland <johan@herland.net> wrote: > On Sun, Oct 27, 2013 at 10:20 AM, Josh Triplett <josh@joshtriplett.org> wrote: >> >> ...good suggestion: >> >> ~/src/linux$ git log --grep='stable@' --oneline --since='1 year ago' | wc -l >> 2769 >> ~/src/linux$ git log --grep='stable@' --oneline --since='1 year ago' --pretty=format:%an | sort -u | wc -l >> 839 >> >> Several thousand commits per year by hundreds of unique people seems >> like enough to justify a short option. > > I think this can be solved just as well (if not better) using a > combination of a commit message template (or a prepare-commit-msg > hook) and a commit-msg hook. Your suggestion is very good, and it is not incompatible with command line options. So both could be implemented and even work together. For example if "-f ack:Peff" was passed to the command line, "git commit" could lookup in the commit message template and see if there is one RFC822-style header that starts with or contains "ack" (discarding case) and it could look in some previous commits if there is an author whose name contains "Peff" (discarding case) and if it is the case it could append the following to the bottom of the commit message: Fixes: Reported-by: Suggested-by: Improved-by: Acked-by: Jeff King <peff@peff.net> Reviewed-by: Tested-by: Signed-off-by: Myself <myself@example.com> (I suppose that the sob is automatically added.) It would work also with "-f fix:security-bug" and would put something like what you suggested: Fixes: 1234beef56 (Commit message summmary) > Then, the commit-msg hook can clean up and transform this into the > final commit message: > > My commit subject > > This is the commit message body. > > Fixes: 1234beef56 (Commit message summmary) > Reported-by: Joe User <j.user@example.com> > Improved-by: Joe Hacker <j.hacker@example.com> > Tested-by: Joe Tester <j.tester@example.com> > Signed-off-by: Myself <myself@example.com> > > Here, the commit-msg hook removes the fields that were not filled in, > and performs additional filtering on the "Fixes" line (Adding commit > message summary). The filtering could also resolve ref names, so that > if you had refs/tags/security-bug pointing at the buggy commit, then: > > Fixes: security-bug > > would be expanded/DWIMed into: > > Fixes: 1234beef56 (Commit message summmary) > > Obviously, any other fancy processing you want to do into in the > commit-msg hook can be done as well, adding footnotes, checking that > commits are present in the ancestry, etc, etc. Yeah, the commit message hook could do some more processing if the user adds or changes stuff. > Three good reasons to go this way: > > 1. If the user forgets to supply command-line options like -s, > --fixes, etc, there is a nice reminder in the supplied form. Great! > 2. No need to add any command-line options to Git. This is not a good reason. If many users prefer a command line option, why not let them use that? > 3. The whole mechanism is controlled by the project. The kernel folks > can do whatever they want in their templates/hooks without needing > changes to the Git project. The Git project already manages sob lines. It would be a good thing if it could manage more of this stuff to help users in a generic way while taking care of user preferences. Best regards, Christian. ^ permalink raw reply [flat|nested] 49+ messages in thread
* Re: [PATCH] commit: Add -f, --fixes <commit> option to add Fixes: line 2013-10-27 19:10 ` Christian Couder @ 2013-10-28 2:46 ` Johan Herland 2013-10-28 22:10 ` Thomas Rast 2013-10-29 6:23 ` Christian Couder 0 siblings, 2 replies; 49+ messages in thread From: Johan Herland @ 2013-10-28 2:46 UTC (permalink / raw) To: Christian Couder Cc: Josh Triplett, Thomas Rast, Michael Haggerty, Git mailing list, Dan Carpenter, Greg KH, ksummit-2013-discuss, ksummit-attendees, Linux Kernel mailing list On Sun, Oct 27, 2013 at 8:04 PM, Christian Couder <christian.couder@gmail.com> wrote: > On Sun, Oct 27, 2013 at 2:30 PM, Johan Herland <johan@herland.net> wrote: >> On Sun, Oct 27, 2013 at 1:30 PM, Christian Couder <christian.couder@gmail.com> wrote: >>> >>> Your suggestion is very good, and it is not incompatible with command >>> line options. >>> So both could be implemented and even work together. >>> >>> For example if "-f ack:Peff" was passed to the command line, "git commit" could >>> lookup in the commit message template and see if there is one >>> RFC822-style header >>> that starts with or contains "ack" (discarding case) and it could look >>> in some previous commits if >>> there is an author whose name contains "Peff" (discarding case) >> >> ...may be cheaper to (first) look at the .mailmap? > > Ok. I haven't really had a look at how it could best be done. > >>> and if it is the case >>> it could append the following to the bottom of the commit message: >>> >>> Fixes: >>> Reported-by: >>> Suggested-by: >>> Improved-by: >>> Acked-by: Jeff King <peff@peff.net> >>> Reviewed-by: >>> Tested-by: >>> Signed-off-by: Myself <myself@example.com> >>> >>> (I suppose that the sob is automatically added.) >>> >>> It would work also with "-f fix:security-bug" and would put something >>> like what you suggested: >>> >>> Fixes: 1234beef56 (Commit message summmary) >> >> Even better: Imagine "-f" (or whatever is decided) as a general >> mechanism for forwarding parameters to the prepare-commit-msg hook. >> When you run "git commit -f ack:Peff -f fix:security-bug", the -f >> arguments will be forwarded to prepare-commit-msg (as additional >> command-line args, or on stdin), and then the prepare-commit-msg hook >> can do whatever it wants with them (e.g. the things you describe >> above). > > If "git commit" processes these arguments and puts the result in the > commit message file that is passed to the > prepare-commit-msg hook, then this hook can still get them from the > file and process them however it wants. > > And in most cases the processing could be the same as what is done by > the commit-msg hook when the user changes the "Fixes: xxx" and > "Stuffed-by: yyy" lines in the editor. > > So it would probably be easier for people customizing the > prepare-commit-msg and commit-msg if "git commit" processes the > arguments instead of just passing them to the prepare-commit-msg hook. > > And it will be better for people who don't set up any *commit-msg hook. > Even if there is no commit template, "-f Acked-by:Peff" and "-f > Fixes:security-bug" could still work. > I suspect most users don't setup any hook or commit template. Hmm. I'm not sure what you argue about which part of the system should perform which function. Let's examine the above options in more detail. Roughly, the flow of events look like this git commit -f ack:Peff -f fix:security-bug | v builtin/commit.c (i.e. inside "git commit") | v prepare-commit-msg hook | v commit message template: Fixes: security-bug Acked-by: Peff | v user edits commit message (may or may not change Fixes/Acked-by lines) | v commit-msg hook | v commit message: Fixes: 1234beef56 (Commit message summmary) Acked-by: Jeff King <peff@peff.net> (The above is even a bit simplified, but I believe it's sufficient for the current discussion.) So, there are several expansions happening between the initial "git commit" and the final commit message. They are: 1. "fix" -> "Fixes: " 2. "security-bug" -> "1234beef56 (Commit message summmary)" 3. "ack" -> "Acked-by: " 4. "Peff" -> "Jeff King <peff@peff.net>" First, I think we both agree that expansions #2 and #4 MUST be done by the commit-msg hook. The reason for this is two-fold: (a) the expansion must be done (at least) after the user has edited the commit message (since the values entered by the user might require the same expansion), and (b) how (and whether) to perform the expansion is a project-specific policy question, and not something that Git can dictate. Obviously, common functionality can be made available in the default hook shipped by Git, but it's up to each project to enable and/or customize this. Second, there is #1 and #3, the expansion of "ack" -> "Acked-by:" and "fix" -> "Fixes:". Is this expansion performed by the prepare-commit-msg hook, or directly inside builtin/commit.c? If you are arguing for the latter (and I'm not sure that you are), we would need to add a dictionary to "git commit" that maps shorthand field names ("ack") to the RFC822 -style equivalent ("Acked-by: "). I would instead argue for the former, i.e. simply forwarding "ack" and "fix" as-is to the prepare-commit-msg hook, and let it deal with the appropriate expansion. The main reason for this is that if a project wants to add another shorthand expansion (e.g. "bug" -> "Related-Bugzilla-Id: "), they can do so without hacking builtin/commit.c. Certainly, we could ship a default prepare-commit-msg hook that knows how to expand the usual suspects (like "ack" and "fix"), but hardcoding this inside "git commit" is not optimal, IMHO. >> The reason I like this, is that we can now support project-specific >> conventions/rules without having to encode those directly in "git >> commit" itself. The only thing "git commit" needs to know, is how to >> forward the appropriate information to the project-specific hook. > > Supporting project specific conventions/rules would still be possible > by processing lines in the commit message file without changing "git > commit". > > If "git commit" is already able to do some processing, it only adds > power to what can be done by people writing hooks. > > We could even have git plumbing commands used by git commit to process > the -f (or whatever option) arguments and they could be reused by the > *commit-msg hooks if they find them useful. Can you walk through an example of such reusable functionality? ISTM that you want to add quite a lot of infrastructure to git for very small gains (preparing and cleaning up commit messages), when that infrastructure could instead be added by those (few?) projects that need it without complicating Git itself (it is e.g. trivially easy to share code between the prepare-commit-msg and commit-msg hooks...) >> One such project-specific convention/rule is the Signed-off-by line >> (although it has certainly spread to quite a lot of projects). I am >> not 100% comfortable with encoding this convention directly into "git >> commit", because it serves as a "slippery slope" to encode even more >> project-specific conventions/rules directly into "git commit" (the >> proposals to add command-line options for the "Change-Id" and "Fixes" >> headers are the two most recent examples), and the more we add, the >> more we bloat the "git commit" command-line interface. > > I don't think we would bloat the "git commit" command line interface. > We just add one option that could help a lot of people, even those who > want something very special. > >>>> 2. No need to add any command-line options to Git. >>> >>> This is not a good reason. If many users prefer a command line option, >>> why not let them use that? >> >> True. As explained above, what I don't want is to add another >> command-line option _every_time_ there is a useful project-specific >> convention. Adding _one_ option to rule them all is much more >> acceptable to me. :) > > Great! > >>>> 3. The whole mechanism is controlled by the project. The kernel folks >>>> can do whatever they want in their templates/hooks without needing >>>> changes to the Git project. >>> >>> The Git project already manages sob lines. It would be a good thing if >>> it could manage >>> more of this stuff to help users in a generic way while taking care of >>> user preferences. >> >> Yes, but the key word here is _generic_. It's impossible to make "git >> commit" able to solve all problems for all projects, but we can make a >> generic mechanism that helps projects solve their own problems more >> easily. > > Yeah, but as you said in your initial message, the generic mechanism > already exists with commit templates and *commit-msg hooks. The only > question left is how an additional command line option can best help. > And if this option does nearly nothing, it will not help much. But I still don't see exactly what this option should do (inside "git commit") that would end up being useful across most/all projects, and not just something that could more easily be implemented in the *commit-msg hooks for relevant projects. ...Johan -- Johan Herland, <johan@herland.net> www.herland.net ^ permalink raw reply [flat|nested] 49+ messages in thread
* Re: [PATCH] commit: Add -f, --fixes <commit> option to add Fixes: line 2013-10-28 2:46 ` Johan Herland @ 2013-10-28 22:10 ` Thomas Rast 2013-10-29 2:02 ` Jeff King 2013-10-30 17:53 ` Johan Herland 2013-10-29 6:23 ` Christian Couder 1 sibling, 2 replies; 49+ messages in thread From: Thomas Rast @ 2013-10-28 22:10 UTC (permalink / raw) To: Johan Herland Cc: Christian Couder, Josh Triplett, Michael Haggerty, Git mailing list, Dan Carpenter, Greg KH, ksummit-2013-discuss, ksummit-attendees, Linux Kernel mailing list Johan Herland <johan@herland.net> writes: > But I still don't see exactly what this option should do (inside "git > commit") that would end up being useful across most/all projects, and > not just something that could more easily be implemented in the > *commit-msg hooks for relevant projects. [Ok, admittedly I don't really know what to quote from your message, since I'm mostly responding to the overall concept.] I like the idea of putting all that in hooks, but I have two observations: * Signed-off-by: is already such a case (and was probably also added for the kernel?) that _could_ have been dealt with using {prepare-,}commit-msg, but has its own support in various git tools. * In your list > Fixes: > Reported-by: > Suggested-by: > Improved-by: > Acked-by: > Reviewed-by: > Tested-by: > Signed-off-by: and I might add Cherry-picked-from: Reverts: if one were to phrase that as a footer/pseudoheader, observe that there are only two kinds of these: footers that contain identities, and footers that contain references to commits. So why not support these use-cases? We could have something like footer.foo.* configuration, e.g. [footer "fixes"] type = commit suggest = true [footer "acked-by"] type = identity where 'suggest' (please suggest a better name) means that git-commit will put a blank one in the commit message template for you to fill in. 'commit' and 'identity' can have some elementary expansion and validation tied to them. Some easy extensiblity (hooks?) might not hurt, but then as you point out, the existing hooks already cover that. Perhaps we could also have, for Gerrit (cf. [1]): [footer "change-id"] type = uuid though admittedly I haven't investigated if it's okay to just put a random string there, or it needs to have a specific value. [1] http://thread.gmane.org/gmane.comp.version-control.git/236429 -- Thomas Rast tr@thomasrast.ch ^ permalink raw reply [flat|nested] 49+ messages in thread
* Re: [PATCH] commit: Add -f, --fixes <commit> option to add Fixes: line 2013-10-28 22:10 ` Thomas Rast @ 2013-10-29 2:02 ` Jeff King 2013-10-30 17:53 ` Johan Herland 1 sibling, 0 replies; 49+ messages in thread From: Jeff King @ 2013-10-29 2:02 UTC (permalink / raw) To: Thomas Rast Cc: Johan Herland, Christian Couder, Josh Triplett, Michael Haggerty, Git mailing list, Dan Carpenter, Greg KH, ksummit-2013-discuss, ksummit-attendees, Linux Kernel mailing list On Mon, Oct 28, 2013 at 11:10:13PM +0100, Thomas Rast wrote: > * In your list > > > Fixes: > > Reported-by: > > Suggested-by: > > Improved-by: > > Acked-by: > > Reviewed-by: > > Tested-by: > > Signed-off-by: > > and I might add > > Cherry-picked-from: > Reverts: > > if one were to phrase that as a footer/pseudoheader, observe that > there are only two kinds of these: footers that contain identities, > and footers that contain references to commits. I think people put other things in, too. For example, cross-referencing bug-tracker ids. In fact, if I saw "fixes: XXX", I would expect the latter to be a tracker id. People do this a lot with GitHub issues, because GitHub will auto-close issue 123 if a commit with "fixes #123" is pushed to master. Because of the "#", no pseudo-header is needed, but I have also seen people use the footer style (I don't have any examples on-hand, though). That being said, in your examples: > So why not support these use-cases? We could have something like > footer.foo.* configuration, e.g. > > [footer "fixes"] > type = commit > suggest = true > [footer "acked-by"] > type = identity you could easily have "type=text" to handle arbitrary text. -Peff ^ permalink raw reply [flat|nested] 49+ messages in thread
* Re: [PATCH] commit: Add -f, --fixes <commit> option to add Fixes: line 2013-10-28 22:10 ` Thomas Rast 2013-10-29 2:02 ` Jeff King @ 2013-10-30 17:53 ` Johan Herland 1 sibling, 0 replies; 49+ messages in thread From: Johan Herland @ 2013-10-30 17:53 UTC (permalink / raw) To: Thomas Rast Cc: Christian Couder, Josh Triplett, Michael Haggerty, Git mailing list, Dan Carpenter, Greg KH On Mon, Oct 28, 2013 at 11:10 PM, Thomas Rast <tr@thomasrast.ch> wrote: > Johan Herland <johan@herland.net> writes: >> But I still don't see exactly what this option should do (inside "git >> commit") that would end up being useful across most/all projects, and >> not just something that could more easily be implemented in the >> *commit-msg hooks for relevant projects. > > [Ok, admittedly I don't really know what to quote from your message, > since I'm mostly responding to the overall concept.] > > I like the idea of putting all that in hooks, but I have two > observations: > > * Signed-off-by: is already such a case (and was probably also added for > the kernel?) that _could_ have been dealt with using {prepare-,}commit-msg, > but has its own support in various git tools. Yes, and I don't like using the precedent of "Signed-off-by" as an argument to push support for more (IMHO project-specific) footers into core Git. Hence, I'd rather see the "Signed-off-by" reimplemented as a hook (obviously, the -s option for "git commit" would have to remain for backward-compatibility). > * In your list > >> Fixes: >> Reported-by: >> Suggested-by: >> Improved-by: >> Acked-by: >> Reviewed-by: >> Tested-by: >> Signed-off-by: > > and I might add > > Cherry-picked-from: > Reverts: > > if one were to phrase that as a footer/pseudoheader, observe that > there are only two kinds of these: footers that contain identities, > and footers that contain references to commits. I'm not so sure we can make those assumptions. One might conceivably imagine a "Fixes:" footer that refers to a bug ID, and not a commit. Also, projects might want to apply different rules on what may appear in which footer. E.g. one could e.g. want to enforce that the ident listed in "Reviewed-by:" or "Signed-off-by:" must always appear in a project-specific REVIEWERS.txt or AUTHORS.txt file. Since we don't really know what projects might want, we shouldn't make too many assumptions on how these footers will be used... That said, I am not (or at least no longer) opposed to generic support in core Git for processing these footers, as long as that support is flexible/generic in nature, and equally available to be reused from within hooks as from within core Git. > So why not support these use-cases? We could have something like > footer.foo.* configuration, e.g. > > [footer "fixes"] > type = commit > suggest = true > [footer "acked-by"] > type = identity > > where 'suggest' (please suggest a better name) means that git-commit > will put a blank one in the commit message template for you to fill in. > 'commit' and 'identity' can have some elementary expansion and > validation tied to them. Some easy extensiblity (hooks?) might not > hurt, but then as you point out, the existing hooks already cover that. > > Perhaps we could also have, for Gerrit (cf. [1]): > > [footer "change-id"] > type = uuid > > though admittedly I haven't investigated if it's okay to just put a > random string there, or it needs to have a specific value. > > [1] http://thread.gmane.org/gmane.comp.version-control.git/236429 How the config ends up looking is not actually that interesting to me (not at this stage, at least). My objection is to adding support for specific footers with specific interpretations tailored specifically for one (or a few) projects. Such things only open the door to more bloat. Instead, we already have the hooks for implementing such project-specific rules and conventions. This is the core of my argument. Since then, the discussion has moved towards generic and flexible support for commonly-used footers, and I don't really have a problem with that, as long as it is easily reusable (and extensible) by a project's own hooks. ...Johan -- Johan Herland, <johan@herland.net> www.herland.net ^ permalink raw reply [flat|nested] 49+ messages in thread
* Re: [PATCH] commit: Add -f, --fixes <commit> option to add Fixes: line 2013-10-28 2:46 ` Johan Herland 2013-10-28 22:10 ` Thomas Rast @ 2013-10-29 6:23 ` Christian Couder 2013-10-30 19:07 ` Johan Herland 1 sibling, 1 reply; 49+ messages in thread From: Christian Couder @ 2013-10-29 6:23 UTC (permalink / raw) To: Johan Herland Cc: Josh Triplett, Thomas Rast, Michael Haggerty, Git mailing list, Dan Carpenter, Greg KH On Mon, Oct 28, 2013 at 3:46 AM, Johan Herland <johan@herland.net> wrote: > On Sun, Oct 27, 2013 at 8:04 PM, Christian Couder <christian.couder@gmail.com> wrote: >> >> If "git commit" processes these arguments and puts the result in the >> commit message file that is passed to the >> prepare-commit-msg hook, then this hook can still get them from the >> file and process them however it wants. >> >> And in most cases the processing could be the same as what is done by >> the commit-msg hook when the user changes the "Fixes: xxx" and >> "Stuffed-by: yyy" lines in the editor. >> >> So it would probably be easier for people customizing the >> prepare-commit-msg and commit-msg if "git commit" processes the >> arguments instead of just passing them to the prepare-commit-msg hook. >> >> And it will be better for people who don't set up any *commit-msg hook. >> Even if there is no commit template, "-f Acked-by:Peff" and "-f >> Fixes:security-bug" could still work. >> I suspect most users don't setup any hook or commit template. > > Hmm. I'm not sure what you argue about which part of the system should > perform which function. Let's examine the above options in more > detail. Roughly, the flow of events look like this > > git commit -f ack:Peff -f fix:security-bug > | > v > builtin/commit.c (i.e. inside "git commit") > | > v > prepare-commit-msg hook > | > v > commit message template: > Fixes: security-bug > Acked-by: Peff Here it could already be: Fixes: 1234beef56 (Commit message summmary) Acked-by: Jeff King <peff@peff.net> Because builtin/commit.c hook could already have expanded everything. > | > v > user edits commit message (may or may not change Fixes/Acked-by lines) > | > v > commit-msg hook > | > v > commit message: > Fixes: 1234beef56 (Commit message summmary) > Acked-by: Jeff King <peff@peff.net> > > (The above is even a bit simplified, but I believe it's sufficient for > the current discussion.) So, there are several expansions happening > between the initial "git commit" and the final commit message. They > are: > > 1. "fix" -> "Fixes: " > 2. "security-bug" -> "1234beef56 (Commit message summmary)" > 3. "ack" -> "Acked-by: " > 4. "Peff" -> "Jeff King <peff@peff.net>" > > First, I think we both agree that expansions #2 and #4 MUST be done by > the commit-msg hook. The reason for this is two-fold: (a) the > expansion must be done (at least) after the user has edited the commit > message (since the values entered by the user might require the same > expansion), and (b) how (and whether) to perform the expansion is a > project-specific policy question, and not something that Git can > dictate. I don't agree. Git doesn't need to dictate anything to be able to do these expansions. Git only needs some hints to do these expansions properly and it could just look at the commit template, or the config, to get those hints. For example, if there is a "Acked-by:" line in the commit template, then Git might decide that "ack" means "Acked-by", and then that "-by" means that "Peff" should be related to an author, and then that it is probably "Jeff King <peff@peff.net>". > Obviously, common functionality can be made available in the > default hook shipped by Git, but it's up to each project to enable > and/or customize this. > > Second, there is #1 and #3, the expansion of "ack" -> "Acked-by:" and > "fix" -> "Fixes:". Is this expansion performed by the > prepare-commit-msg hook, or directly inside builtin/commit.c? > > If you are arguing for the latter (and I'm not sure that you are), we > would need to add a dictionary to "git commit" that maps shorthand > field names ("ack") to the RFC822 -style equivalent ("Acked-by: "). Yes, I am arguing that builtin/commit.c, or better a plumbing command launched by builtin/commit.c, should do it. And I don't think there is an absolute need for a dictionary. There could be such a dictionary in the config (as Junio proposed). But if there isn't, the plumbing command launched by builtin/commit.c could look at the commit template to decide that "ack" means "Acked-by:". > I would instead argue for the former, i.e. simply forwarding "ack" and > "fix" as-is to the prepare-commit-msg hook, and let it deal with the > appropriate expansion. The main reason for this is that if a project > wants to add another shorthand expansion (e.g. "bug" -> > "Related-Bugzilla-Id: "), they can do so without hacking > builtin/commit.c. I agree that there should be no need to hack builtin/commit.c. For example if "Bugzilla-Id:" is in the commit template, the plumbing command launched by builtin/commit.c would decide that "bug" means "Bugzilla-Id:" without any hack. Of course this suppose that there is no other "Bugtracker:" or "Bug:" in the commit template. But even in this case it would mean that users have to use "-f bugz:XXX" (or "--trailer bugz=XXX") instead of just "-f bug:XXX". >> Supporting project specific conventions/rules would still be possible >> by processing lines in the commit message file without changing "git >> commit". >> >> If "git commit" is already able to do some processing, it only adds >> power to what can be done by people writing hooks. >> >> We could even have git plumbing commands used by git commit to process >> the -f (or whatever option) arguments and they could be reused by the >> *commit-msg hooks if they find them useful. > > Can you walk through an example of such reusable functionality? Ok, let's call the new plumbing command "git interpret-trailers". And let's suppose that "git commit" is passed "-f ack:Peff -f fix:security-bug" (or "--trailer ack=Peff --trailer fix=security-bug"). "git commit" would then call something like: git interpret-trailers --file commit_message_template.txt 'ack:Peff' 'fix:security-bug' And this command would output: ------------------ <<<upper part of commit_message_template.txt>>> Fixes: 1234beef56 (Commit message summmary) Reported-by: Suggested-by: Improved-by: Acked-by: Jeff King <peff@peff.net> Reviewed-by: Tested-by: Signed-off-by: Myself <myself@example.com> ------------------ Because it would have looked at the commit template it is passed and filled in the blanks it could fill using the arguments it is also passed. "git commit" would then put the above lines in the file that it passes to the prepare-commit-msg hook. Then the prepare-commit-msg could just do nothing. After the user has edited the commit message, the commit-msg hook could just call: git interpret-trailers --trim-empty --file commit_message.txt so that what the user changed is interpreted again. For example if the user changed the "Reviewed-by:" line to "Reviewed-by: Johan", then the output would be: ------------------ <<<upper part of commit_message.txt>>> Fixes: 1234beef56 (Commit message summmary) Acked-by: Jeff King <peff@peff.net> Reviewed-by: Johan Herland <johan@herland.net> Signed-off-by: Myself <myself@example.com> ------------------ And that would be the final commit message in most cases. Thanks, Christian. ^ permalink raw reply [flat|nested] 49+ messages in thread
* Re: [PATCH] commit: Add -f, --fixes <commit> option to add Fixes: line 2013-10-29 6:23 ` Christian Couder @ 2013-10-30 19:07 ` Johan Herland 2013-11-02 12:54 ` Christian Couder 0 siblings, 1 reply; 49+ messages in thread From: Johan Herland @ 2013-10-30 19:07 UTC (permalink / raw) To: Christian Couder Cc: Josh Triplett, Thomas Rast, Michael Haggerty, Git mailing list, Dan Carpenter, Greg KH On Tue, Oct 29, 2013 at 7:23 AM, Christian Couder <christian.couder@gmail.com> wrote: > On Mon, Oct 28, 2013 at 3:46 AM, Johan Herland <johan@herland.net> wrote: >> On Sun, Oct 27, 2013 at 8:04 PM, Christian Couder <christian.couder@gmail.com> wrote: >>> If "git commit" processes these arguments and puts the result in the >>> commit message file that is passed to the >>> prepare-commit-msg hook, then this hook can still get them from the >>> file and process them however it wants. >>> >>> And in most cases the processing could be the same as what is done by >>> the commit-msg hook when the user changes the "Fixes: xxx" and >>> "Stuffed-by: yyy" lines in the editor. >>> >>> So it would probably be easier for people customizing the >>> prepare-commit-msg and commit-msg if "git commit" processes the >>> arguments instead of just passing them to the prepare-commit-msg hook. >>> >>> And it will be better for people who don't set up any *commit-msg hook. >>> Even if there is no commit template, "-f Acked-by:Peff" and "-f >>> Fixes:security-bug" could still work. >>> I suspect most users don't setup any hook or commit template. >> >> Hmm. I'm not sure what you argue about which part of the system should >> perform which function. Let's examine the above options in more >> detail. Roughly, the flow of events look like this >> >> git commit -f ack:Peff -f fix:security-bug >> | >> v >> builtin/commit.c (i.e. inside "git commit") >> | >> v >> prepare-commit-msg hook >> | >> v >> commit message template: >> Fixes: security-bug >> Acked-by: Peff > > Here it could already be: > > Fixes: 1234beef56 (Commit message summmary) > Acked-by: Jeff King <peff@peff.net> > > Because builtin/commit.c hook could already have expanded everything. > >> | >> v >> user edits commit message (may or may not change Fixes/Acked-by lines) >> | >> v >> commit-msg hook >> | >> v >> commit message: >> Fixes: 1234beef56 (Commit message summmary) >> Acked-by: Jeff King <peff@peff.net> >> >> (The above is even a bit simplified, but I believe it's sufficient for >> the current discussion.) So, there are several expansions happening >> between the initial "git commit" and the final commit message. They >> are: >> >> 1. "fix" -> "Fixes: " >> 2. "security-bug" -> "1234beef56 (Commit message summmary)" >> 3. "ack" -> "Acked-by: " >> 4. "Peff" -> "Jeff King <peff@peff.net>" >> >> First, I think we both agree that expansions #2 and #4 MUST be done by >> the commit-msg hook. The reason for this is two-fold: (a) the >> expansion must be done (at least) after the user has edited the commit >> message (since the values entered by the user might require the same >> expansion), and (b) how (and whether) to perform the expansion is a >> project-specific policy question, and not something that Git can >> dictate. > > I don't agree. Git doesn't need to dictate anything to be able to do > these expansions. > Git only needs some hints to do these expansions properly and it could > just look at the commit template, or the config, to get those hints. > > For example, if there is a "Acked-by:" line in the commit template, > then Git might decide that "ack" means "Acked-by", and then that "-by" > means that "Peff" should be related to an author, and then that it is > probably "Jeff King <peff@peff.net>". I don't like putting that much Magic into core Git... Especially not into builtin/commit.c. However, if we - as you suggest further below - put it into a separate helper, and we make that helper available (and usable) from elsewhere (most importantly from hooks where people/projects can add their own more specific functionality), then I don't have a problem with it. [...] >>> Supporting project specific conventions/rules would still be possible >>> by processing lines in the commit message file without changing "git >>> commit". >>> >>> If "git commit" is already able to do some processing, it only adds >>> power to what can be done by people writing hooks. >>> >>> We could even have git plumbing commands used by git commit to process >>> the -f (or whatever option) arguments and they could be reused by the >>> *commit-msg hooks if they find them useful. >> >> Can you walk through an example of such reusable functionality? > > Ok, let's call the new plumbing command "git interpret-trailers". > And let's suppose that "git commit" is passed "-f ack:Peff -f > fix:security-bug" (or "--trailer ack=Peff --trailer > fix=security-bug"). > > "git commit" would then call something like: > > git interpret-trailers --file commit_message_template.txt 'ack:Peff' > 'fix:security-bug' > > And this command would output: > > ------------------ > <<<upper part of commit_message_template.txt>>> > > Fixes: 1234beef56 (Commit message summmary) > Reported-by: > Suggested-by: > Improved-by: > Acked-by: Jeff King <peff@peff.net> > Reviewed-by: > Tested-by: > Signed-off-by: Myself <myself@example.com> > ------------------ > > Because it would have looked at the commit template it is passed and > filled in the blanks it could fill using the arguments it is also > passed. > > "git commit" would then put the above lines in the file that it passes > to the prepare-commit-msg hook. > > Then the prepare-commit-msg could just do nothing. > > After the user has edited the commit message, the commit-msg hook > could just call: > > git interpret-trailers --trim-empty --file commit_message.txt > > so that what the user changed is interpreted again. > > For example if the user changed the "Reviewed-by:" line to > "Reviewed-by: Johan", then the output would be: > > ------------------ > <<<upper part of commit_message.txt>>> > > Fixes: 1234beef56 (Commit message summmary) > Acked-by: Jeff King <peff@peff.net> > Reviewed-by: Johan Herland <johan@herland.net> > Signed-off-by: Myself <myself@example.com> > ------------------ > > And that would be the final commit message in most cases. This approach looks OK to me, as long as we make sure that this functionality is (a) optional, (b) flexible/reusable from hooks, and (c) not bound tightly to core Git (and AFAICS, your proposal is just that). As I said above, this stuff certainly does not belong in builtin/commit.c... ...Johan -- Johan Herland, <johan@herland.net> www.herland.net ^ permalink raw reply [flat|nested] 49+ messages in thread
* Re: [PATCH] commit: Add -f, --fixes <commit> option to add Fixes: line 2013-10-30 19:07 ` Johan Herland @ 2013-11-02 12:54 ` Christian Couder 0 siblings, 0 replies; 49+ messages in thread From: Christian Couder @ 2013-11-02 12:54 UTC (permalink / raw) To: Johan Herland Cc: Josh Triplett, Thomas Rast, Michael Haggerty, Git mailing list, Dan Carpenter, Greg KH On Wed, Oct 30, 2013 at 8:07 PM, Johan Herland <johan@herland.net> wrote: > On Tue, Oct 29, 2013 at 7:23 AM, Christian Couder > <christian.couder@gmail.com> wrote: >> >> I don't agree. Git doesn't need to dictate anything to be able to do >> these expansions. >> Git only needs some hints to do these expansions properly and it could >> just look at the commit template, or the config, to get those hints. >> >> For example, if there is a "Acked-by:" line in the commit template, >> then Git might decide that "ack" means "Acked-by", and then that "-by" >> means that "Peff" should be related to an author, and then that it is >> probably "Jeff King <peff@peff.net>". > > I don't like putting that much Magic into core Git... Especially not > into builtin/commit.c. However, if we - as you suggest further below - > put it into a separate helper, and we make that helper available (and > usable) from elsewhere (most importantly from hooks where > people/projects can add their own more specific functionality), then I > don't have a problem with it. Ok, great! I started working on "git interpret-trailers" and I will post an RFC patch soon. It will support both configuration as Junio suggested and reading a commit template file as you suggested. >> Ok, let's call the new plumbing command "git interpret-trailers". >> And let's suppose that "git commit" is passed "-f ack:Peff -f >> fix:security-bug" (or "--trailer ack=Peff --trailer >> fix=security-bug"). >> >> "git commit" would then call something like: >> >> git interpret-trailers --file commit_message_template.txt 'ack:Peff' >> 'fix:security-bug' >> >> And this command would output: >> >> ------------------ >> <<<upper part of commit_message_template.txt>>> >> >> Fixes: 1234beef56 (Commit message summmary) >> Reported-by: >> Suggested-by: >> Improved-by: >> Acked-by: Jeff King <peff@peff.net> >> Reviewed-by: >> Tested-by: >> Signed-off-by: Myself <myself@example.com> >> ------------------ >> >> Because it would have looked at the commit template it is passed and >> filled in the blanks it could fill using the arguments it is also >> passed. >> >> "git commit" would then put the above lines in the file that it passes >> to the prepare-commit-msg hook. >> >> Then the prepare-commit-msg could just do nothing. >> >> After the user has edited the commit message, the commit-msg hook >> could just call: >> >> git interpret-trailers --trim-empty --file commit_message.txt >> >> so that what the user changed is interpreted again. >> >> For example if the user changed the "Reviewed-by:" line to >> "Reviewed-by: Johan", then the output would be: >> >> ------------------ >> <<<upper part of commit_message.txt>>> >> >> Fixes: 1234beef56 (Commit message summmary) >> Acked-by: Jeff King <peff@peff.net> >> Reviewed-by: Johan Herland <johan@herland.net> >> Signed-off-by: Myself <myself@example.com> >> ------------------ >> >> And that would be the final commit message in most cases. > > This approach looks OK to me, as long as we make sure that this > functionality is (a) optional, (b) flexible/reusable from hooks, and > (c) not bound tightly to core Git (and AFAICS, your proposal is just > that). As I said above, this stuff certainly does not belong in > builtin/commit.c... Ok, I think it will be very easy to do all with "git interpret-trailers". Best regards, Christian. ^ permalink raw reply [flat|nested] 49+ messages in thread
* Re: [PATCH] commit: Add -f, --fixes <commit> option to add Fixes: line 2013-10-27 8:09 ` Thomas Rast 2013-10-27 9:20 ` Josh Triplett @ 2013-10-27 9:26 ` Stefan Beller 2013-10-27 16:30 ` Thomas Rast 1 sibling, 1 reply; 49+ messages in thread From: Stefan Beller @ 2013-10-27 9:26 UTC (permalink / raw) To: Thomas Rast, Josh Triplett Cc: Michael Haggerty, git, Dan Carpenter, Greg KH, ksummit-2013-discuss, ksummit-attendees, linux-kernel On 10/27/2013 09:09 AM, Thomas Rast wrote: > Josh Triplett <josh@joshtriplett.org> writes: > >> On Sun, Oct 27, 2013 at 06:42:44AM +0100, Michael Haggerty wrote: >>> But I don't think that this feature should be given the "-f" short >>> option, as (a) -f often means "force"; (b) it will increase the >>> confusion with --fixup; (c) it just doesn't strike me as being likely to >>> be such a frequently-used option (though if this changes over time the >>> "-f" option could always be granted to it later). >> >> (a) -n often means --dry-run, but for commit it means --no-verify. >> Different commands have different options, and commit doesn't have a >> --force to abbreviate as -f. >> >> (b) If anything, I think the existence of a short option will make the >> distinction more obvious, since -f and --fixup are much less similar >> than --fixes and --fixup. Most users will never type --fixes, making >> confusion unlikely. >> >> (c) Short option letters tend to be first-come first-serve unless >> there's a strong reason to do otherwise. Why reserve 'f' for some >> hypothetical future option that doesn't exist yet? > > No, lately the direction in Git has been to avoid giving options a > one-letter shorthand until they have proven so useful that people using > it in the wild start to suggest that it should have one. > > See e.g. > > http://article.gmane.org/gmane.comp.version-control.git/233998 > http://article.gmane.org/gmane.comp.version-control.git/168748 > > A much better argument would be if it was already clear from the specs > laid out for Fixes that n% of the kernel commits will end up having this > footer, and thus kernel hackers will spend x amount of time spelling out > --fixes and/or confusing it with --fixup to much headache. > I assembled an overview table, which plots the long options of git commands by the short letters. Here it is: (Best viewed with a *large* screen and monospace font) Name\short | C | B | A | G | F | E | H | O | N | L | S | R | P | W | X | c | b | a | g | f | e | d | k | i | o | n | m | l | s | r | q | p | w | v | u | t | z | x | 3 | 2 status | | | | | | | | | | | | | | | | | branch | | | | | | | | | | | | short | | | | | verbose | untracked-files | | null | | | status help | | | | | | | | | | | | | | | | | | all | guides | | | | | info | | | man | | | | | | web | | | | | | | help show | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | quiet | | | | | | | | | show revert | | | | | | | | | | | | | | | strategy-option | | | | | | edit | | | | | no-commit | mainline | | signoff | | | | | | | | | | | revert pack-objects | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | quiet | | | | | | | | | pack-objects prune-packed | | | | | | | | | | | | | | | | | | | | | | | | | | dry-run | | | | | quiet | | | | | | | | | prune-packed replace | | | | | | | | | | | | | | | | | | | | force | | delete | | | | | | list | | | | | | | | | | | | replace show-ref | | | | | | | | | | | | | | | | | | | | | | dereference | | | | | | | hash | | quiet | | | | | | | | | show-ref tag | | | | | file | | | | | | | | | | | | | annotate | | force | | delete | | | | | message | list | sign | | | | | verify | local-user | | | | | tag gc | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | quiet | | | | | | | | | gc apply | | | | | | | | | | | | reverse | | | | | | | | | | | | | | | | | | | | | | verbose | | | | | 3way | apply fsck-objects | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | verbose | | | | | | fsck-objects archive | | | | | | | | | | | | | | | | | | | | | | | | | output | | | | | | | | | | | | | | | archive merge-file | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | quiet | stdout | | | | | | | | merge-file log | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | quiet | | | | | | | | | log cherry | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | verbose | | | | | | cherry checkout-index | | | | | | | | | | | | | | | | | | all | | force | | | | | | no-create | | | | | quiet | | | | index | | | | | checkout-index check-attr | | | | | | | | | | | | | | | | | | all | | | | | | | | | | | | | | | | | | | | | | check-attr reflog | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | quiet | | | | | | | | | reflog branch | | | | | | | | | | | | | | | | | | all | | force | | delete | | | | | move | create-reflog | | remotes | quiet | | | verbose | set-upstream-to | track | | | | branch ls-tree | | | | | | | | | | | | | | | | | | | | | | | | | | | | long | | | | | | | | | | | | ls-tree rm | | | | | | | | | | | | | | | | | | | | force | | | | | | dry-run | | | | | quiet | | | | | | | | | rm config | | | | | | | | | | | | | | | | | | | | file | edit | | | | | | | list | | | | | | | | | null | | | config remote | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | verbose | | | | | | remote init-db | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | quiet | | | | | | | | | init-db merge-base | | | | | | | | | | | | | | | | | | all | | | | | | | | | | | | | | | | | | | | | | merge-base for-each-ref | | | | | | | | | | | | | | | | | | | | | | | | | | | | | shell | | | perl | | | | | | | | for-each-ref clone | | | | | | | | | | | | | | | | config | branch | | | | | | | | origin | no-checkout | | local | shared | | quiet | | | verbose | upload-pack | | | | | clone count-objects | | | | | | | human-readable | | | | | | | | | | | | | | | | | | | | | | | | | | | verbose | | | | | | count-objects fsck | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | verbose | | | | | | fsck verify-pack | | | | | | | | | | | | | | | | | | | | | | | | | | | | | stat-only | | | | | verbose | | | | | | verify-pack update-server-info | | | | | | | | | | | | | | | | | | | | force | | | | | | | | | | | | | | | | | | | | update-server-info add | | | all | | | | | | intent-to-add | | | | | | | | | | | force | edit | | | interactive | | dry-run | | | | | | patch | | verbose | update | | | | | add whatchanged | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | quiet | | | | | | | | | whatchanged cherry-pick | | | | | | | | | | | | | | | strategy-option | | | | | | edit | | | | | no-commit | mainline | | signoff | | | | | | | | | | | cherry-pick read-tree | | | | | | | | | | | | | | | | | | | | | | | | | | dry-run | | | | | | | | verbose | | | | | | read-tree format-patch | | | | | | | | | no-numbered | | | | | | | | | | | | | | keep-subject | | output-directory | numbered | | | signoff | | quiet | no-stat | | reroll-count | | | | | | format-patch stage | | | all | | | | | | intent-to-add | | | | | | | | | | | force | edit | | | interactive | | dry-run | | | | | | patch | | verbose | update | | | | | stage reset | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | quiet | patch | | | | | | | | reset check-ignore | | | | | | | | | | | | | | | | | | | | | | | | | | non-matching | | | | | quiet | | | verbose | | | | | | check-ignore grep | context | before-context | after-context | basic-regexp | fixed-strings | extended-regexp | | open-files-in-pager | | files-without-match | | | perl-regexp | function-context | | count | | text | | | | | | ignore-case | | line-number | | files-with-matches | | | quiet | show-function | word-regexp | invert-match | | | null | | | grep prune | | | | | | | | | | | | | | | | | | | | | | | | | | dry-run | | | | | | | | verbose | | | | | | prune symbolic-ref | | | | | | | | | | | | | | | | | | | | | | delete | | | | | | | | | quiet | | | | | | | | | symbolic-ref checkout | | | | | | | | | | | | | | | | | | | | force | | | | | | | merge | | | | quiet | patch | | | | track | | | theirs | ours checkout repack | | | | | | | | | | | | | | | | | | | | | | | | | | | | local | | | quiet | | | | | | | | | repack init | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | quiet | | | | | | | | | init merge | | | | | | | | | | | gpg-sign | | | | strategy-option | | | | | | edit | | | | | | message | | strategy | | quiet | | | verbose | | | | | | merge mv | | | | | | | | | | | | | | | | | | | | force | | | | | | dry-run | | | | | | | | verbose | | | | | | mv ls-files | | | | | | | | | | | | | | | exclude-from | cached | | | | | | deleted | killed | ignored | others | | modified | | stage | | | | | | unmerged | | | exclude | | ls-files clean | | | | | | | | | | | | | | | | | | | | force | exclude | | | interactive | | dry-run | | | | | quiet | | | | | | | | | clean show-branch | | | | | | | | | | | | | | | | | | all | reflog | | | | | | | | | | | remotes | | | | | | | | | | show-branch push | | | | | | | | | | | | | | | | | | | | force | | | | | | dry-run | | | | | quiet | | | verbose | set-upstream | | | | | push commit | reuse-message | | | | file | | | | | | gpg-sign | | | | | reedit-message | | all | | | edit | | | include | only | no-verify | message | | signoff | | quiet | patch | | verbose | untracked-files | template | null | | | commit verify-tag | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | verbose | | | | | | verify-tag fmt-merge-msg | | | | | file | | | | | | | | | | | | | | | | | | | | | | message | | | | | | | | | | | | | fmt-merge-msg fetch | | | | | | | | | | | | | | | | | | append | | force | | | keep | | | | multiple | | | | quiet | prune | | verbose | update-head-ok | tags | | | | fetch (In case thunderbird messes it up, here it is again http://pastebin.com/raw.php?i=JBci2Krx) As you can see, f is always --force except for git-config, where it is --file ^ permalink raw reply [flat|nested] 49+ messages in thread
* Re: [PATCH] commit: Add -f, --fixes <commit> option to add Fixes: line 2013-10-27 9:26 ` Stefan Beller @ 2013-10-27 16:30 ` Thomas Rast 2013-10-27 17:03 ` Stefan Beller 2013-10-31 23:03 ` Stefan Beller 0 siblings, 2 replies; 49+ messages in thread From: Thomas Rast @ 2013-10-27 16:30 UTC (permalink / raw) To: Stefan Beller Cc: Josh Triplett, Michael Haggerty, git, Dan Carpenter, Greg KH, ksummit-2013-discuss, ksummit-attendees, linux-kernel Stefan Beller <stefanbeller@googlemail.com> writes: > I assembled an overview table, which plots the long options of > git commands by the short letters. [...] > (In case thunderbird messes it up, here it is again http://pastebin.com/raw.php?i=JBci2Krx) > > As you can see, f is always --force except for git-config, where it is --file Woah! Impressive work. Did you autogenerate this? If so, can we have it as a small make target somewhere? If not, can you send a patch to put your table in Documentation somewhere? -- Thomas Rast tr@thomasrast.ch ^ permalink raw reply [flat|nested] 49+ messages in thread
* Re: [PATCH] commit: Add -f, --fixes <commit> option to add Fixes: line 2013-10-27 16:30 ` Thomas Rast @ 2013-10-27 17:03 ` Stefan Beller 2013-10-31 23:03 ` Stefan Beller 1 sibling, 0 replies; 49+ messages in thread From: Stefan Beller @ 2013-10-27 17:03 UTC (permalink / raw) To: Thomas Rast Cc: Josh Triplett, Michael Haggerty, git, Dan Carpenter, Greg KH, ksummit-2013-discuss, ksummit-attendees, linux-kernel On 10/27/2013 05:30 PM, Thomas Rast wrote: > Stefan Beller <stefanbeller@googlemail.com> writes: > >> I assembled an overview table, which plots the long options of >> git commands by the short letters. > [...] >> (In case thunderbird messes it up, here it is again http://pastebin.com/raw.php?i=JBci2Krx) >> >> As you can see, f is always --force except for git-config, where it is --file > > Woah! Impressive work. Did you autogenerate this? If so, can we have > it as a small make target somewhere? If not, can you send a patch to > put your table in Documentation somewhere? > I thought about generating it by parsing the man pages, but I felt it would not be reliable enough and quite time consuming to come up with a parser. Parsing the C sources however also seemed time consuming, so I decided to come up with this patch: --8<-- Subject: [PATCH] parse-options: print all options having short and long form and exit This patch basically only prints all options which have a long and a short form and then aborts the program. A typical output looks like this: ./git-add add, n, dry-run add, v, verbose add, i, interactive add, p, patch add, e, edit add, f, force add, u, update add, N, intent-to-add add, A, all --- parse-options.c | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/parse-options.c b/parse-options.c index 62e9b1c..b356ca9 100644 --- a/parse-options.c +++ b/parse-options.c @@ -500,6 +500,12 @@ int parse_options(int argc, const char **argv, const char *prefix, { struct parse_opt_ctx_t ctx; + for (; options->type != OPTION_END; options++) { + if (options->long_name && options->short_name) + printf("%s, %c, %s\n", argv[0], options->short_name, options->long_name); + } + exit(1); + parse_options_start(&ctx, argc, argv, prefix, options, flags); switch (parse_options_step(&ctx, options, usagestr)) { case PARSE_OPT_HELP: -- 1.8.4.1.605.g23c6912 Unfortunately we can only check git commands, which are written in C. You'll notice all the perl/shell written commands are missing (rebase, etc). Also a few commands written in C cannot easily be picked up, as they do stuff before calling parse_options. [typically something like "if (argc != 4) print_usage();"] These commands are also not contained. The generation of the table however was just a little python: --8<-- #!/usr/bin/python cmds="""git-add git-apply git-archive git-branch git-check-attr git-check-ignore git-check-mailmap git-checkout git-checkout-index git-cherry git-cherry-pick git-clean git-clone git-column git-commit git-config git-count-objects git-credential-cache git-credential-store git-describe git-fetch git-fmt-merge-msg git-for-each-ref git-format-patch git-fsck git-fsck-objects git-gc git-grep git-hash-object git-help git-init git-init-db git-log git-ls-files git-ls-tree git-merge git-merge-base git-merge-file git-merge-ours git-mktree git-mv git-name-rev git-notes git-pack-objects git-pack-refs git-prune git-prune-packed git-push git-read-tree git-reflog git-remote git-repack git-replace git-rerere git-reset git-revert git-rev-parse git-rm git-show git-show-branch git-show-ref git-stage git-status git-symbolic-ref git-tag git-update-index git-update-ref git-update-server-info git-verify-pack git-verify-tag git-whatchanged git-write-tree""" import subprocess shorts={} cmdoptions={} for cmd in cmds.split("\n"): p = subprocess.Popen("./"+cmd, stdout=subprocess.PIPE) p.wait() lines = p.stdout.read() for line in lines.split("\n"): if not len(line): continue name, short, long = line.split(",") if not short in shorts: shorts[short] = len(long) else: shorts[short] = max(shorts[short], len(long)) if not name in cmdoptions: cmdoptions[name] = {} cmdoptions[name][short] = long longest_cmd = 0 for cmd in cmdoptions: longest_cmd = max(longest_cmd, len(cmd)) print " "*(longest_cmd-len("Name\\short")), "Name\\short", for short in shorts: print "|" + " "*(1+shorts[short]-len(short)) + short, print for cmd in cmdoptions: print " "*(longest_cmd-len(cmd)), cmd, for short in shorts: s = "" if short in cmdoptions[cmd]: s = cmdoptions[cmd][short] print "|" + " "*(1+shorts[short]-len(s)) + s, print " ", cmd --8<-- I am not sure if we should add such code to the git code base, as it would need some cleanup. The existing table however would become outdated fast? So I do not have a good idea, how such a table could be easily incorporated and kept up to date. Thanks, Stefan ^ permalink raw reply related [flat|nested] 49+ messages in thread
* Re: [PATCH] commit: Add -f, --fixes <commit> option to add Fixes: line 2013-10-27 16:30 ` Thomas Rast 2013-10-27 17:03 ` Stefan Beller @ 2013-10-31 23:03 ` Stefan Beller 2013-10-31 23:04 ` [PATCH] Documentation: add a script to generate a (long/short) options overview Stefan Beller 1 sibling, 1 reply; 49+ messages in thread From: Stefan Beller @ 2013-10-31 23:03 UTC (permalink / raw) To: Thomas Rast; +Cc: Michael Haggerty, git On 10/27/2013 05:30 PM, Thomas Rast wrote: > Stefan Beller <stefanbeller@googlemail.com> writes: > >> I assembled an overview table, which plots the long options of >> git commands by the short letters. > [...] >> (In case thunderbird messes it up, here it is again http://pastebin.com/raw.php?i=JBci2Krx) >> >> As you can see, f is always --force except for git-config, where it is --file > > Woah! Impressive work. Did you autogenerate this? If so, can we have > it as a small make target somewhere? If not, can you send a patch to > put your table in Documentation somewhere? > [ Removing the linux related mailing lists and participants ] Would you mind to define > in Documentation somewhere a little more precise? I cannot really find a suitable place for such a table as in the main Documentation direcotry there are basically the man page informations and some git development related things, such as SubmittingPatches. The sub directories are even less fitting, so maybe Documentation/ShortOptions would be fine? Anyway, as I couldn't really come up with a reliable way for the shell commands, I just went manually through all the missing commands (be it written in shell or missing compiled commands), and added it to the script. The script itself was reworked a little, to better be able to add manual information. Any suggestions how to improve the script or the table itself is welcome. Thanks, Stefan ^ permalink raw reply [flat|nested] 49+ messages in thread
* [PATCH] Documentation: add a script to generate a (long/short) options overview 2013-10-31 23:03 ` Stefan Beller @ 2013-10-31 23:04 ` Stefan Beller 2013-10-31 23:09 ` Stefan Beller 0 siblings, 1 reply; 49+ messages in thread From: Stefan Beller @ 2013-10-31 23:04 UTC (permalink / raw) To: tr, mhagger, git; +Cc: Stefan Beller Recently a discussion started on the mailing list, which short option shall be best for a long option. (-f being always --force and therefore should not be reassigned another meaning in one particular command) See http://www.mail-archive.com/git@vger.kernel.org/msg38456.html For discussions as these we need a script to easily generate an overview of all available one letter options, and their long option equivalents. As the list of options was not retrieved fully automated, there might be minor errors or missing items. Signed-off-by: Stefan Beller <stefanbeller@googlemail.com> --- Documentation/generateShortOptions.py | 460 ++++++++++++++++++++++++++++++++++ 1 file changed, 460 insertions(+) create mode 100644 Documentation/generateShortOptions.py diff --git a/Documentation/generateShortOptions.py b/Documentation/generateShortOptions.py new file mode 100644 index 0000000..1d326f9 --- /dev/null +++ b/Documentation/generateShortOptions.py @@ -0,0 +1,460 @@ +#!/usr/bin/python +# This script generates a table, which should help you getting a +# better overview of the existing long and short options of the +# various git commands. This script actually is only suited for +# generating the table itself, as the collection of the options of +# the git commands needs to be done manually. +# For the majority of commands, which are written in C, a small patch +# such as the following helps to extract the relevant cases for this +# script. However you still need to go through the shell commands +# manually. +# diff --git a/parse-options.c b/parse-options.c +# index 62e9b1c..b356ca9 100644 +# --- a/parse-options.c +# +++ b/parse-options.c +# @@ -500,6 +500,12 @@ int parse_options(int argc, const char **argv, const char *prefix, +# { +# struct parse_opt_ctx_t ctx; +# +# + for (; options->type != OPTION_END; options++) { +# + if (options->long_name && options->short_name) +# + printf("%s, %c, %s\n", argv[0], options->short_name, options->long_name); +# + } +# + exit(1); +# + +# parse_options_start(&ctx, argc, argv, prefix, options, flags); +# switch (parse_options_step(&ctx, options, usagestr)) { +# case PARSE_OPT_HELP: +# -- + + +# Command, short option, long option +cmd_results="""add, n, dry-run +add, v, verbose +add, i, interactive +add, p, patch +add, e, edit +add, f, force +add, u, update +add, N, intent-to-add +add, A, all + +am, i, interactive +am, 3, 3way +am, q, quiet +am, s, signoff +am, u, utf8 +am, k, keep + +annotate, p, porcelain + +apply, 3, 3way +apply, R, reverse +apply, v, verbose + +archive, o, output + +blame, p, porcelain +blame, f, show-name +blame, n, show-number +blame, e, show-email + +branch, v, verbose +branch, q, quiet +branch, t, track +branch, u, set-upstream-to +branch, r, remotes +branch, a, all +branch, d, delete +branch, m, move +branch, l, create-reflog +branch, f, force + +check-attr, a, all + +check-ignore, q, quiet +check-ignore, v, verbose +check-ignore, n, non-matching + +checkout, q, quiet +checkout, t, track +checkout, 2, ours +checkout, 3, theirs +checkout, f, force +checkout, m, merge +checkout, p, patch + +checkout-index, a, all +checkout-index, f, force +checkout-index, q, quiet +checkout-index, n, no-create +checkout-index, u, index + +cherry, v, verbose + +cherry-pick, n, no-commit +cherry-pick, e, edit +cherry-pick, s, signoff +cherry-pick, m, mainline +cherry-pick, X, strategy-option + +clean, q, quiet +clean, n, dry-run +clean, f, force +clean, i, interactive +clean, e, exclude + +clone, v, verbose +clone, q, quiet +clone, n, no-checkout +clone, l, local +clone, s, shared +clone, o, origin +clone, b, branch +clone, u, upload-pack +clone, c, config + +commit, q, quiet +commit, v, verbose +commit, F, file +commit, m, message +commit, c, reedit-message +commit, C, reuse-message +commit, s, signoff +commit, t, template +commit, e, edit +commit, S, gpg-sign +commit, a, all +commit, i, include +commit, p, patch +commit, o, only +commit, n, no-verify +commit, z, null +commit, u, untracked-files + +config, f, file +config, l, list +config, e, edit +config, z, null + +count-objects, v, verbose +count-objects, H, human-readable + +diff, u, patch +diff, p, patch +diff, U, unified +diff, B, break-rewrites +diff, M, find-renames +diff, C, find-copies +diff, D, irreversible-delete +diff, a, text +diff, b, ignore-space-change +diff, w, ignore-all-space +diff, W, function-context + +diff-files, u, patch +diff-files, p, patch +diff-files, U, unified +diff-files, B, break-rewrites +diff-files, M, find-renames +diff-files, C, find-copies +diff-files, D, irreversible-delete +diff-files, a, text +diff-files, b, ignore-space-change +diff-files, w, ignore-all-space +diff-files, W, function-context +diff-files, c, cc +# diff-index and diff-tree similar, to be done + +fetch, v, verbose +fetch, q, quiet +fetch, a, append +fetch, f, force +fetch, m, multiple +fetch, t, tags +fetch, p, prune +fetch, k, keep +fetch, u, update-head-ok + +filter-branch, f, force + +fmt-merge-msg, m, message +fmt-merge-msg, F, file + +for-each-ref, s, shell +for-each-ref, p, perl + +format-patch, n, numbered +format-patch, N, no-numbered +format-patch, s, signoff +format-patch, v, reroll-count +format-patch, o, output-directory +format-patch, k, keep-subject +format-patch, p, no-stat +format-patch, q, quiet + +fsck, v, verbose + +fsck-objects, v, verbose + +gc, q, quiet + +grep, v, invert-match +grep, i, ignore-case +grep, w, word-regexp +grep, a, text +grep, E, extended-regexp +grep, G, basic-regexp +grep, F, fixed-strings +grep, P, perl-regexp +grep, n, line-number +grep, l, files-with-matches +grep, L, files-without-match +grep, z, null +grep, c, count +grep, C, context +grep, B, before-context +grep, A, after-context +grep, p, show-function +grep, W, function-context +grep, q, quiet +grep, O, open-files-in-pager + +help, a, all +help, g, guides +help, m, man +help, w, web +help, i, info + +init, q, quiet + +init-db, q, quiet + +insta-web, l, local +insta-web, d, httpd +insta-web, m, module-path +insta-web, p, port +insta-web, b, browser + +log, q, quiet + +ls-files, c, cached +ls-files, d, deleted +ls-files, m, modified +ls-files, o, others +ls-files, i, ignored +ls-files, s, stage +ls-files, k, killed +ls-files, u, unmerged +ls-files, x, exclude +ls-files, X, exclude-from + +ls-tree, l, long + +ls-remotes, h, heads +ls-remotes, t, tags +ls-remotes, u, upload-pack + +merge, e, edit +merge, s, strategy +merge, X, strategy-option +merge, m, message +merge, n, no-stat +merge, v, verbose +merge, q, quiet +merge, S, gpg-sign +merge, s, strategy +merge, X, strategy-option + +merge-base, a, all + +merge-file, p, stdout +merge-file, q, quiet + +mv, v, verbose +mv, n, dry-run +mv, f, force + +pack-objects, q, quiet + +prune, n, dry-run +prune, v, verbose + +prune-packed, n, dry-run +prune-packed, q, quiet + +pull, a, append +pull, f, force +pull, k, keep +pull, u, update-head-ok +pull, n, no-stat +pull, q, quiet +pull, v, verbose +pull, r, rebase +pull, s, strategy +pull, X, strategy-option + +push, v, verbose +push, q, quiet +push, n, dry-run +push, f, force +push, u, set-upstream + +quilt-import, n, dry-run + +rebase, f, force-rebase +rebase, i, interactive +rebase, p, preserve-merges +rebase, m, merge +rebase, n, no-stat +rebase, v, verbose +rebase, r, rebase +rebase, s, strategy +rebase, X, strategy-option +rebase, x, exec + +read-tree, v, verbose +read-tree, n, dry-run + +reflog, q, quiet + +rev-list, n, max-count +rev-list, i, regexp-ignore-case +rev-list, E, extended-regexp +rev-list, F, fixed-strings +rev-list, g, walk-reflogs + +remote, v, verbose + +repack, q, quiet +repack, l, local + +replace, l, list +replace, d, delete +replace, f, force + +reset, q, quiet +reset, p, patch + +revert, n, no-commit +revert, e, edit +revert, s, signoff +revert, m, mainline +revert, X, strategy-option + +rm, n, dry-run +rm, q, quiet +rm, f, force + +show, q, quiet + +show-branch, a, all +show-branch, r, remotes +show-branch, g, reflog + +show-ref, d, dereference +show-ref, s, hash +show-ref, q, quiet + +shortlog, n, numbered +shortlog, s, summary +shortlog, e, email + +stash, p, patch +stash, u, include-untracked +stash, a, all +stash, q, quiet + +stage, n, dry-run +stage, v, verbose +stage, i, interactive +stage, p, patch +stage, e, edit +stage, f, force +stage, u, update +stage, N, intent-to-add +stage, A, all + +status, v, verbose +status, s, short +status, b, branch +status, z, null +status, u, untracked-files + +stripspace, s, strip-comments +stripspace, c, comment-lines + +submodule, q, quiet +submodule, b, branch +submodule, f, force +submodule, n, summary-limit +submodule, N, no-fetch + +symbolic-ref, q, quiet +symbolic-ref, d, delete + +tag, l, list +tag, d, delete +tag, v, verify +tag, a, annotate +tag, m, message +tag, F, file +tag, s, sign +tag, u, local-user +tag, f, force + +update-server-info, f, force + +verify-pack, v, verbose +verify-pack, s, stat-only + +verify-tag, v, verbose + +whatchanged, q, quiet""" + +import subprocess + +column_len = {} +column_count = {} +cmdoptions={} + +for line in cmd_results.split("\n"): + if not len(line) or line.startswith('#'): + continue + name, short, long = line.split(",") + + if not short in column_len: + column_len[short] = len(long) + column_count[short] = 0 + column_len[short] = max(column_len[short], len(long)) + column_count[short] += 1 + + if not name in cmdoptions: + cmdoptions[name] = {} + cmdoptions[name][short] = long + +longest_cmd = 0 +for cmd in cmdoptions: + longest_cmd = max(longest_cmd, len(cmd)) + +print " "*(longest_cmd-len("Name\\short")), "Name\\short", + +# let's sort the columns in a way, we can see most of the options on the left hand side +columns = [] +for key, value in sorted(column_count.iteritems(), key=lambda (k,v): (-v,k)): + columns += [key] + +# print head line +for short in columns: + print "|" + " "*(1+column_len[short]-len(short)) + short, +print + +# print line for each command +for cmd in sorted(cmdoptions): + print " "*(longest_cmd-len(cmd)), cmd, + for short in columns: + s = "" + if short in cmdoptions[cmd]: + s = cmdoptions[cmd][short] + print "|" + " "*(1+column_len[short]-len(s)) + s, + print " ", cmd -- 1.8.4.1.605.g23c6912 ^ permalink raw reply related [flat|nested] 49+ messages in thread
* Re: [PATCH] Documentation: add a script to generate a (long/short) options overview 2013-10-31 23:04 ` [PATCH] Documentation: add a script to generate a (long/short) options overview Stefan Beller @ 2013-10-31 23:09 ` Stefan Beller 2013-10-31 23:45 ` brian m. carlson 0 siblings, 1 reply; 49+ messages in thread From: Stefan Beller @ 2013-10-31 23:09 UTC (permalink / raw) To: Stefan Beller, tr, mhagger, git On 11/01/2013 12:04 AM, Stefan Beller wrote: > Recently a discussion started on the mailing list, which short option > shall be best for a long option. (-f being always --force and therefore > should not be reassigned another meaning in one particular command) > See http://www.mail-archive.com/git@vger.kernel.org/msg38456.html > > For discussions as these we need a script to easily generate an > overview of all available one letter options, and their long option > equivalents. > > As the list of options was not retrieved fully automated, > there might be minor errors or missing items. > > Signed-off-by: Stefan Beller <stefanbeller@googlemail.com> > --- > Documentation/generateShortOptions.py | 460 ++++++++++++++++++++++++++++++++++ > 1 file changed, 460 insertions(+) > create mode 100644 Documentation/generateShortOptions.py > When trying to send a follow-up patch with the table itself, I got: fatal: /tmp/wHpJlnf1r5/0002-Documentation-add-table-viewing-short-long-options-f.patch: 19: patch contains a line longer than 998 characters warning: no patches were sent Is this an artifical limitation or something that actually makes sense? Anyway here is the table, updated to carry more commands and sorted: >From 7d2ba0af3500f1629783dfc80aafe218dee8618c Mon Sep 17 00:00:00 2001 From: Stefan Beller <stefanbeller@googlemail.com> Date: Fri, 1 Nov 2013 00:01:21 +0100 Subject: [PATCH 2/2] Documentation: add table viewing (short/long) options for all commands Signed-off-by: Stefan Beller <stefanbeller@googlemail.com> --- Documentation/ShortOptions.txt | 73 ++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 73 insertions(+) create mode 100644 Documentation/ShortOptions.txt diff --git a/Documentation/ShortOptions.txt b/Documentation/ShortOptions.txt new file mode 100644 index 0000000..dd76512 --- /dev/null +++ b/Documentation/ShortOptions.txt @@ -0,0 +1,73 @@ + Name\short | q | v | n | s | f | m | u | a | p | e | l | X | i | n | p | d | u | o | f | F | c | t | z | a | b | q | A | N | k | i | s | 3 | C | S | b | g | r | w | B | C | D | M | U | W | c | e | k | m | r | v | w | 2 | B | E | G | H | L | O | P | R | W | x | 3 | E | F | N | d | g | h | l | t | x + add | | verbose | dry-run | | force | | update | | patch | edit | | | interactive | | | | | | | | | | | | | | all | intent-to-add | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | add + am | | | | | | | | | | | | | | | | | utf8 | | | | | | | | | quiet | | | | interactive | signoff | | | | | | | | | | | | | | | | keep | | | | | | | | | | | | | | | | 3way | | | | | | | | | am + annotate | | | | | | | | | | | | | | | porcelain | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | annotate + apply | | verbose | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | 3way | | | | | | | | | | | | | | | | | | | | | | | | | | | | reverse | | | | | | | | | | | | apply + archive | | | | | | | | | | | | | | | | | | output | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | archive + blame | | | | | | | | | | | | | | show-number | porcelain | | | | show-name | | | | | | | | | | | | | | | | | | | | | | | | | | | show-email | | | | | | | | | | | | | | | | | | | | | | | | | | blame + branch | quiet | verbose | | | force | move | set-upstream-to | all | | | create-reflog | | | | | delete | | | | | | track | | | | | | | | | | | | | | | remotes | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | branch + check-attr | | | | | | | | all | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | check-attr + check-ignore | quiet | verbose | non-matching | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | check-ignore + checkout | quiet | | | | force | merge | | | patch | | | | | | | | | | | | | track | | | | | | | | | | theirs | | | | | | | | | | | | | | | | | | | | ours | | | | | | | | | | | | | | | | | | | | checkout + checkout-index | quiet | | no-create | | force | | index | all | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | checkout-index + cherry | | verbose | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | cherry + cherry-pick | | | no-commit | signoff | | mainline | | | | edit | | strategy-option | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | cherry-pick + clean | quiet | | dry-run | | force | | | | | exclude | | | interactive | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | clean + clone | quiet | verbose | no-checkout | shared | | | upload-pack | | | | local | | | | | | | origin | | | config | | | | | | | | | | | | | | branch | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | clone + commit | quiet | verbose | no-verify | signoff | | message | untracked-files | all | patch | edit | | | include | | | | | only | | file | reedit-message | template | null | | | | | | | | | | reuse-message | gpg-sign | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | commit + config | | | | | file | | | | | edit | list | | | | | | | | | | | | null | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | config + count-objects | | verbose | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | human-readable | | | | | | | | | | | | | | | | count-objects + diff | | | | | | | | | | | | | | | patch | | patch | | | | | | | text | ignore-space-change | | | | | | | | | | | | | | break-rewrites | find-copies | irreversible-delete | find-renames | unified | function-context | | | | | | | ignore-all-space | | | | | | | | | | | | | | | | | | | | | diff + diff-files | | | | | | | | | | | | | | | patch | | patch | | | | | | | text | ignore-space-change | | | | | | | | | | | | | | break-rewrites | find-copies | irreversible-delete | find-renames | unified | function-context | cc | | | | | | ignore-all-space | | | | | | | | | | | | | | | | | | | | | diff-files + fetch | quiet | verbose | | | force | multiple | update-head-ok | append | prune | | | | | | | | | | | | | tags | | | | | | | keep | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | fetch + filter-branch | | | | | | | | | | | | | | | | | | | force | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | filter-branch + fmt-merge-msg | | | | | | message | | | | | | | | | | | | | | file | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | fmt-merge-msg + for-each-ref | | | | shell | | | | | perl | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | for-each-ref + format-patch | quiet | reroll-count | numbered | signoff | | | | | no-stat | | | | | | | | | output-directory | | | | | | | | | | no-numbered | keep-subject | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | format-patch + fsck | | verbose | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | fsck + fsck-objects | | verbose | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | fsck-objects + gc | quiet | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | gc + grep | quiet | invert-match | line-number | | | | | text | show-function | | files-with-matches | | ignore-case | | | | | | | fixed-strings | count | | null | | | | after-context | | | | | | context | | | | | word-regexp | | | | | | | | | | | | | | | before-context | extended-regexp | basic-regexp | | files-without-match | open-files-in-pager | perl-regexp | | function-context | | | | | | | | | | | grep + help | | | | | | man | | all | | | | | info | | | | | | | | | | | | | | | | | | | | | | | guides | | web | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | help + init | quiet | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | init + init-db | quiet | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | init-db + insta-web | | | | | | | | | | | | | | | port | | | | | | | | | | browser | | | | | | | | | | | | | | | | | | | | | | | module-path | | | | | | | | | | | | | | | | | | | httpd | | | local | | insta-web + log | quiet | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | log + ls-files | | | | stage | | modified | unmerged | | | | | exclude-from | ignored | | | deleted | | others | | | cached | | | | | | | | killed | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | exclude | | | | | | | | | | ls-files + ls-remotes | | | | | | | | | | | | | | | | | upload-pack | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | heads | | tags | ls-remotes + ls-tree | | | | | | | | | | | long | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | ls-tree + merge | quiet | verbose | no-stat | strategy | | message | | | | edit | | strategy-option | | | | | | | | | | | | | | | | | | | | | | gpg-sign | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | merge + merge-base | | | | | | | | all | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | merge-base + merge-file | quiet | | | | | | | | stdout | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | merge-file + mv | | verbose | dry-run | | force | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | mv + pack-objects | quiet | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | pack-objects + prune | | verbose | dry-run | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | prune + prune-packed | quiet | | dry-run | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | prune-packed + pull | | | | strategy | | | | | | | | strategy-option | | no-stat | | | update-head-ok | | force | | | | | append | | quiet | | | | | | | | | | | | | | | | | | | | | keep | | rebase | verbose | | | | | | | | | | | | | | | | | | | | | | pull + push | quiet | verbose | dry-run | | force | | set-upstream | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | push + quilt-import | | | | | | | | | | | | | | dry-run | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | quilt-import + read-tree | | verbose | dry-run | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | read-tree + rebase | | | | strategy | | | | | | | | strategy-option | | no-stat | preserve-merges | | | | force-rebase | | | | | | | | | | | interactive | | | | | | | | | | | | | | | | | | merge | rebase | verbose | | | | | | | | | | | | | | | | | | | | | | exec rebase + reflog | quiet | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | reflog + remote | | verbose | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | remote + repack | quiet | | | | | | | | | | local | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | repack + replace | | | | | force | | | | | | list | | | | | delete | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | replace + reset | quiet | | | | | | | | patch | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | reset + rev-list | | | | | | | | | | | | | | max-count | | | | | | | | | | | | | | | | regexp-ignore-case | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | extended-regexp | fixed-strings | | | walk-reflogs | | | | rev-list + revert | | | no-commit | signoff | | mainline | | | | edit | | strategy-option | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | revert + rm | quiet | | dry-run | | force | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | rm + shortlog | | | | | | | | | | | | | | numbered | | | | | | | | | | | | | | | | | summary | | | | | | | | | | | | | | | email | | | | | | | | | | | | | | | | | | | | | | | | | | shortlog + show | quiet | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | show + show-branch | | | | | | | | all | | | | | | | | | | | | | | | | | | | | | | | | | | | | reflog | remotes | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | show-branch + show-ref | quiet | | | hash | | | | | | | | | | | | dereference | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | show-ref + stage | | verbose | dry-run | | force | | update | | patch | edit | | | interactive | | | | | | | | | | | | | | all | intent-to-add | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | stage + stash | | | | | | | | | | | | | | | patch | | include-untracked | | | | | | | all | | quiet | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | stash + status | | verbose | | short | | | untracked-files | | | | | | | | | | | | | | | | null | | | | | | | | | | | | branch | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | status + stripspace | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | strip-comments | | | | | | | | | | | | | | comment-lines | | | | | | | | | | | | | | | | | | | | | | | | | | | stripspace + submodule | | | | | | | | | | | | | | summary-limit | | | | | force | | | | | | branch | quiet | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | no-fetch | | | | | | submodule + symbolic-ref | quiet | | | | | | | | | | | | | | | delete | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | symbolic-ref + tag | | verify | | sign | force | message | local-user | annotate | | | list | | | | | delete | | | | file | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | tag + update-server-info | | | | | force | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | update-server-info + verify-pack | | verbose | | stat-only | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | verify-pack + verify-tag | | verbose | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | verify-tag + whatchanged | quiet | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | whatchanged -- 1.8.4.1.605.g23c6912 ^ permalink raw reply related [flat|nested] 49+ messages in thread
* Re: [PATCH] Documentation: add a script to generate a (long/short) options overview 2013-10-31 23:09 ` Stefan Beller @ 2013-10-31 23:45 ` brian m. carlson 2013-11-01 0:09 ` Junio C Hamano 0 siblings, 1 reply; 49+ messages in thread From: brian m. carlson @ 2013-10-31 23:45 UTC (permalink / raw) To: Stefan Beller; +Cc: tr, mhagger, git [-- Attachment #1: Type: text/plain, Size: 1784 bytes --] On Fri, Nov 01, 2013 at 12:09:10AM +0100, Stefan Beller wrote: > On 11/01/2013 12:04 AM, Stefan Beller wrote: > > Recently a discussion started on the mailing list, which short option > > shall be best for a long option. (-f being always --force and therefore > > should not be reassigned another meaning in one particular command) > > See http://www.mail-archive.com/git@vger.kernel.org/msg38456.html > > > > For discussions as these we need a script to easily generate an > > overview of all available one letter options, and their long option > > equivalents. > > > > As the list of options was not retrieved fully automated, > > there might be minor errors or missing items. > > > > Signed-off-by: Stefan Beller <stefanbeller@googlemail.com> > > --- > > Documentation/generateShortOptions.py | 460 ++++++++++++++++++++++++++++++++++ > > 1 file changed, 460 insertions(+) > > create mode 100644 Documentation/generateShortOptions.py > > > > When trying to send a follow-up patch with the table itself, I got: > fatal: /tmp/wHpJlnf1r5/0002-Documentation-add-table-viewing-short-long-options-f.patch: 19: patch contains a line longer than 998 characters > warning: no patches were sent > > Is this an artifical limitation or something that actually makes sense? RFC 5321 forbids lines exceeding 1000 octets (including CRLF). RFC 5322 forbids lines exceeding 998 characters (excluding CRLF). If you want to get around that, you need to base64-encode the content, which is generally discouraged when sending patches, I believe. -- brian m. carlson / brian with sandals: Houston, Texas, US +1 832 623 2791 | http://www.crustytoothpaste.net/~bmc | My opinion only OpenPGP: RSA v4 4096b: 88AC E9B2 9196 305B A994 7552 F1BA 225C 0223 B187 [-- Attachment #2: Digital signature --] [-- Type: application/pgp-signature, Size: 836 bytes --] ^ permalink raw reply [flat|nested] 49+ messages in thread
* Re: [PATCH] Documentation: add a script to generate a (long/short) options overview 2013-10-31 23:45 ` brian m. carlson @ 2013-11-01 0:09 ` Junio C Hamano 0 siblings, 0 replies; 49+ messages in thread From: Junio C Hamano @ 2013-11-01 0:09 UTC (permalink / raw) To: brian m. carlson; +Cc: Stefan Beller, tr, mhagger, git "brian m. carlson" <sandals@crustytoothpaste.net> writes: > RFC 5321 forbids lines exceeding 1000 octets (including CRLF). RFC 5322 > forbids lines exceeding 998 characters (excluding CRLF). If you want to > get around that, you need to base64-encode the content, which is > generally discouraged when sending patches, I believe. All true. A message like the one posted before and got a positive "wow, good work", is a good thinkg to motivate somebody to work on bringing the codebase and build procedure to aspire for producing that table from within the build procedure; I do not think this information fixed in time belongs to the source tree (iow, making it into a patch form is of no use). It will go stale over time without a way to automate the synchronization somehow. ^ permalink raw reply [flat|nested] 49+ messages in thread
* Re: [PATCH] commit: Add -f, --fixes <commit> option to add Fixes: line 2013-10-27 7:14 ` Josh Triplett 2013-10-27 8:03 ` [Ksummit-2013-discuss] " Michel Lespinasse 2013-10-27 8:09 ` Thomas Rast @ 2013-10-28 9:02 ` Michael Haggerty 2013-10-28 11:29 ` Johan Herland 2 siblings, 1 reply; 49+ messages in thread From: Michael Haggerty @ 2013-10-28 9:02 UTC (permalink / raw) To: Josh Triplett Cc: git, Dan Carpenter, Greg KH, ksummit-2013-discuss, ksummit-attendees, linux-kernel On 10/27/2013 08:14 AM, Josh Triplett wrote: > On Sun, Oct 27, 2013 at 06:42:44AM +0100, Michael Haggerty wrote: >> On 10/27/2013 02:34 AM, Josh Triplett wrote: >> [...] >> First of all, let me show my ignorance. How formalized is the use of >> metadata lines at the end of a commit message? I don't remember seeing >> documentation about such lines in general (as opposed to documentation >> about particular types of lines). Is the format defined well enough >> that tools that don't know about a particular line could nonetheless >> preserve it correctly? Is there/should there be a standard recommended >> order of metadata lines? (For example, should "Fixes:" lines always >> appear before "Signed-off-by" lines, or vice versa?) If so, is it >> documented somewhere and preserved by tools when such lines are >> added/modified? Should there be support for querying such lines? > > While it isn't very well documented in git itself, metadata lines are > quite standardized. See Documentation/SubmittingPatches and > Documentation/development-process/5.Posting in the Linux kernel, for an > explanation of "Reported-by:", "Tested-by:", "Reviewed-by:", > "Suggested-by:", and "Acked-by:". And git itself looks for a very > specific format; the has_conforming_footer function looks for a footer > consisting exclusively of rfc2822-style (email-style) header lines to > decide whether to append "Signed-off-by:" (and now "Fixes:") directly to > that block or to create a new block. It would be nice to document exactly what "rfc2822-style" means in this context (e.g., are line breaks supported? Encoding changes? etc.) so that (1) new inventors of trailer lines can make sure that they conform to what Git expects and (2) Git could someday add some generic facilities for handling these fields (e.g., adding/removing/tidying them in a commit-msg hook; grepping through them by name) and be relatively sure that it is not breaking somebody's metadata. I'm not saying that it's your job; only that it would be helpful for ideas like yours. > [...] >> I wonder if the two features could >> be combined in some way? >> >> The main difference between the two features is how they are intended to >> be used: --fixup is to fix a commit that hasn't been pushed yet (where >> the user intends to squash the commits together), whereas --fixes is to >> mark a commit as a fix to a commit that has already been pushed (where >> the commits will remain separate). But there seems to be a common >> concept here. >> >> For example, what happens if a --fixes commit is "rebase -i"ed at the >> same time as the commit that it fixes? It might make sense to do the >> autosquash thing just like with a --fixup/--squash commit. (Otherwise >> the SHA-1 in the "Fixes:" line will become invalid anyway.) > > Most definitely not, no, at least not without an explicit option to > enable that. Consider the case of backporting a series of patches and > preserving the relative history of those patches, to make it easier to > match up a set of patches. At most, it might be a good idea for > cherry-pick or similar to provide an updated Fixes tag for the new hash > of the older commit. Personally, I'd argue against doing this even with > --autosquash. I could see the argument for an --autosquash-fixes, but I > can't think of a real-world scenario where what would come up. > > Generally, if history is still editable, you should just squash in the > fix to the original commit, and if history is no longer editable (which > is the use case for "Fixes:" lines), the squash case simply won't come > up, offering little point to adding special support for that case. In your last paragraph you explain exactly why these two features are similar and why it is thinkable to make the way that they are handled depend on the context. Exactly because one would never rebase a "Fixes:" commit and the commit it is fixing at the same time, they would never be squashed together. And ISTM that in most cases whenever they *are* being rebased at the same time, then one would want to squash them together. So it might be possible to mark both types of commits the same way and then squash/not squash them depending on the context and the --autosquash option. > [...] >> I see that there a consistency check that the --fixes argument is a >> valid commit. But is there/should there be a check that it is an >> ancestor of the commit being created? Is there/should there be a check >> that both of these facts remain true if the the commit containing it is >> rebased, cherry-picked, etc? > > That sounds like a nice future enhancement, sure. I don't have any plans to > add such a check myself, though. Also note that --fixup and --squash > don't have such a check either; if you want to add one, you should add > it for all three options at once. A hook-based solution could do this. But a built-in "all-purpose" handler like "footer.Fixes.arg=commit", which was intended to be reusable, wouldn't be able to do such footer-specific extra work without having to create new special cases in git each time. Michael -- Michael Haggerty mhagger@alum.mit.edu http://softwareswirl.blogspot.com/ ^ permalink raw reply [flat|nested] 49+ messages in thread
* Re: [PATCH] commit: Add -f, --fixes <commit> option to add Fixes: line 2013-10-28 9:02 ` [PATCH] commit: Add -f, --fixes <commit> option to add Fixes: line Michael Haggerty @ 2013-10-28 11:29 ` Johan Herland 2013-10-29 2:08 ` Jeff King 0 siblings, 1 reply; 49+ messages in thread From: Johan Herland @ 2013-10-28 11:29 UTC (permalink / raw) To: Michael Haggerty Cc: Josh Triplett, Git mailing list, Dan Carpenter, Greg KH, ksummit-2013-discuss, ksummit-attendees, Linux Kernel mailing list On Mon, Oct 28, 2013 at 10:02 AM, Michael Haggerty <mhagger@alum.mit.edu> wrote: > On 10/27/2013 08:14 AM, Josh Triplett wrote: >> On Sun, Oct 27, 2013 at 06:42:44AM +0100, Michael Haggerty wrote: >>> On 10/27/2013 02:34 AM, Josh Triplett wrote: >>> I wonder if the two features could >>> be combined in some way? >>> >>> The main difference between the two features is how they are intended to >>> be used: --fixup is to fix a commit that hasn't been pushed yet (where >>> the user intends to squash the commits together), whereas --fixes is to >>> mark a commit as a fix to a commit that has already been pushed (where >>> the commits will remain separate). But there seems to be a common >>> concept here. >>> >>> For example, what happens if a --fixes commit is "rebase -i"ed at the >>> same time as the commit that it fixes? It might make sense to do the >>> autosquash thing just like with a --fixup/--squash commit. (Otherwise >>> the SHA-1 in the "Fixes:" line will become invalid anyway.) >> >> Most definitely not, no, at least not without an explicit option to >> enable that. Consider the case of backporting a series of patches and >> preserving the relative history of those patches, to make it easier to >> match up a set of patches. At most, it might be a good idea for >> cherry-pick or similar to provide an updated Fixes tag for the new hash >> of the older commit. Personally, I'd argue against doing this even with >> --autosquash. I could see the argument for an --autosquash-fixes, but I >> can't think of a real-world scenario where what would come up. >> >> Generally, if history is still editable, you should just squash in the >> fix to the original commit, and if history is no longer editable (which >> is the use case for "Fixes:" lines), the squash case simply won't come >> up, offering little point to adding special support for that case. > > In your last paragraph you explain exactly why these two features are > similar and why it is thinkable to make the way that they are handled > depend on the context. Exactly because one would never rebase a > "Fixes:" commit and the commit it is fixing at the same time, they would > never be squashed together. And ISTM that in most cases whenever they > *are* being rebased at the same time, then one would want to squash them > together. So it might be possible to mark both types of commits the > same way and then squash/not squash them depending on the context and > the --autosquash option. In general, we should be careful with introducing features that exhibit different consequences based on the context in which they are used, but in this case, I believe I agree with you. The existence of "Fixes:" in a commit should be a just as valid hint to --autosquash as a commit message starting with "fixup!" or "squash!" (obviously, the "Fixes:" commit should be handled like a "squash!" and not like a "fixup!", so that we don't haphazardly discard the commit message accompanying "Fixes:"). >>> I see that there a consistency check that the --fixes argument is a >>> valid commit. But is there/should there be a check that it is an >>> ancestor of the commit being created? Is there/should there be a check >>> that both of these facts remain true if the the commit containing it is >>> rebased, cherry-picked, etc? >> >> That sounds like a nice future enhancement, sure. I don't have any plans to >> add such a check myself, though. Also note that --fixup and --squash >> don't have such a check either; if you want to add one, you should add >> it for all three options at once. > > A hook-based solution could do this. But a built-in "all-purpose" > handler like "footer.Fixes.arg=commit", which was intended to be > reusable, wouldn't be able to do such footer-specific extra work without > having to create new special cases in git each time. Which begs the question (posed to all, not specifically to you): Why would we want solve this issue in config instead of in hooks? The hooks will always be more flexible and less dependent on making changes in git.git. (...a suitably flexible hook could even use the config options discussed above as input...) In both cases, we need the user to actively enable the functionality (either installing hooks, or setting up config), and in both cases we could bundle Git with defaults that solve the common cases, so that is not a useful differentiator between the two approaches. I would even venture to ask: If we end up solving this problem in config and not in hooks, then why do we bother having hooks in the first place? ...Johan -- Johan Herland, <johan@herland.net> www.herland.net ^ permalink raw reply [flat|nested] 49+ messages in thread
* Re: [PATCH] commit: Add -f, --fixes <commit> option to add Fixes: line 2013-10-28 11:29 ` Johan Herland @ 2013-10-29 2:08 ` Jeff King 2013-10-29 8:26 ` Matthieu Moy 2013-10-30 18:12 ` Johan Herland 0 siblings, 2 replies; 49+ messages in thread From: Jeff King @ 2013-10-29 2:08 UTC (permalink / raw) To: Johan Herland Cc: Michael Haggerty, Josh Triplett, Git mailing list, Dan Carpenter, Greg KH, ksummit-2013-discuss, ksummit-attendees, Linux Kernel mailing list On Mon, Oct 28, 2013 at 12:29:32PM +0100, Johan Herland wrote: > > A hook-based solution could do this. But a built-in "all-purpose" > > handler like "footer.Fixes.arg=commit", which was intended to be > > reusable, wouldn't be able to do such footer-specific extra work without > > having to create new special cases in git each time. > > Which begs the question (posed to all, not specifically to you): Why > would we want solve this issue in config instead of in hooks? The > hooks will always be more flexible and less dependent on making > changes in git.git. (...a suitably flexible hook could even use the > config options discussed above as input...) In both cases, we need the > user to actively enable the functionality (either installing hooks, or > setting up config), and in both cases we could bundle Git with > defaults that solve the common cases, so that is not a useful > differentiator between the two approaches. I would even venture to > ask: If we end up solving this problem in config and not in hooks, > then why do we bother having hooks in the first place? One thing that is much nicer with config vs hooks is that you can manage config for all of your repositories by tweaking ~/.gitconfig (and that is where I would expect this type of config to go). Managing hooks globally means having each repo symlink to a central hook area, and having the forethought to set up the symlink farm and use init.templatedir before cloning any repos. We could probably make this friendlier by reading from ~/.githooks and defining some semantics for multiple hooks. E.g., fall back to ~/.githooks if the repo hook is not executable, or possibly run them both (or even allow multiple instances of a hook in ~/.githooks, which can help organization), and consider the hook a failure if any of them fail. -Peff ^ permalink raw reply [flat|nested] 49+ messages in thread
* Re: [PATCH] commit: Add -f, --fixes <commit> option to add Fixes: line 2013-10-29 2:08 ` Jeff King @ 2013-10-29 8:26 ` Matthieu Moy 2013-10-30 18:12 ` Johan Herland 1 sibling, 0 replies; 49+ messages in thread From: Matthieu Moy @ 2013-10-29 8:26 UTC (permalink / raw) To: Jeff King Cc: Johan Herland, Michael Haggerty, Josh Triplett, Git mailing list, Dan Carpenter, Greg KH, ksummit-2013-discuss, ksummit-attendees, Linux Kernel mailing list Jeff King <peff@peff.net> writes: > We could probably make this friendlier by reading from ~/.githooks > and defining some semantics for multiple hooks. I'd be all for it, except I'd call this ~/.config/git/hooks/* (or $XDG_CONFIG_HOME if set). > E.g., fall back to ~/.githooks if the repo hook is not > executable, or possibly run them both I think running them both would be the best option. Otherwise, adding a (possibly trivial) hook to a repo would disable the user-wide one, that'd feel weird. -- Matthieu Moy http://www-verimag.imag.fr/~moy/ ^ permalink raw reply [flat|nested] 49+ messages in thread
* Re: [PATCH] commit: Add -f, --fixes <commit> option to add Fixes: line 2013-10-29 2:08 ` Jeff King 2013-10-29 8:26 ` Matthieu Moy @ 2013-10-30 18:12 ` Johan Herland 2013-10-31 6:28 ` Duy Nguyen 1 sibling, 1 reply; 49+ messages in thread From: Johan Herland @ 2013-10-30 18:12 UTC (permalink / raw) To: Jeff King Cc: Michael Haggerty, Josh Triplett, Git mailing list, Dan Carpenter, Greg KH, ksummit-2013-discuss, ksummit-attendees, Linux Kernel mailing list On Tue, Oct 29, 2013 at 3:08 AM, Jeff King <peff@peff.net> wrote: > On Mon, Oct 28, 2013 at 12:29:32PM +0100, Johan Herland wrote: >> > A hook-based solution could do this. But a built-in "all-purpose" >> > handler like "footer.Fixes.arg=commit", which was intended to be >> > reusable, wouldn't be able to do such footer-specific extra work without >> > having to create new special cases in git each time. >> >> Which begs the question (posed to all, not specifically to you): Why >> would we want solve this issue in config instead of in hooks? The >> hooks will always be more flexible and less dependent on making >> changes in git.git. (...a suitably flexible hook could even use the >> config options discussed above as input...) In both cases, we need the >> user to actively enable the functionality (either installing hooks, or >> setting up config), and in both cases we could bundle Git with >> defaults that solve the common cases, so that is not a useful >> differentiator between the two approaches. I would even venture to >> ask: If we end up solving this problem in config and not in hooks, >> then why do we bother having hooks in the first place? > > One thing that is much nicer with config vs hooks is that you can manage > config for all of your repositories by tweaking ~/.gitconfig (and that > is where I would expect this type of config to go). Actually, I believe the use of footers are more often guided by project conventions/rules, so I wouldn't expect such config to go into ~/.gitconfig. I would rather expect to find it in an in-project config that was included from the repo config... > Managing hooks globally means having each repo symlink to a central hook > area, and having the forethought to set up the symlink farm and use > init.templatedir before cloning any repos. We could probably make this > friendlier by reading from ~/.githooks and defining some semantics for > multiple hooks. E.g., fall back to ~/.githooks if the repo hook is not > executable, or possibly run them both (or even allow multiple instances > of a hook in ~/.githooks, which can help organization), and consider the > hook a failure if any of them fail. Yes, we do lack a good infrastructure for managing Git hooks from multiple sources. It makes people afraid to use them, because they might conflict with hooks from another source. There are (off the top of my head): - "personal" hooks ("I want this behaviour in my repo(s)") - "project" hooks ("In this project we follow these conventions") - "system" hooks ("This host runs gitolite (or whatever) which needs these hooks...") - "default" hooks (Some of the core Git code could have be implemented as hooks (e.g. "--signoff"), but is instead put into core Git) Maybe if we solved that problem, we could actually make use of hooks instead of adding "code" to our git configs (by which I mean config directives that are flexible enough to encode all kinds of semantics and behaviors that are probably better expressed in real code...). ...Johan -- Johan Herland, <johan@herland.net> www.herland.net ^ permalink raw reply [flat|nested] 49+ messages in thread
* Re: [PATCH] commit: Add -f, --fixes <commit> option to add Fixes: line 2013-10-30 18:12 ` Johan Herland @ 2013-10-31 6:28 ` Duy Nguyen 2013-10-31 17:20 ` Junio C Hamano 0 siblings, 1 reply; 49+ messages in thread From: Duy Nguyen @ 2013-10-31 6:28 UTC (permalink / raw) To: Johan Herland Cc: Jeff King, Michael Haggerty, Josh Triplett, Git mailing list, Dan Carpenter, Greg KH, Linux Kernel mailing list On Thu, Oct 31, 2013 at 1:12 AM, Johan Herland <johan@herland.net> wrote: > Yes, we do lack a good infrastructure for managing Git hooks from > multiple sources. It makes people afraid to use them, because they > might conflict with hooks from another source. There are (off the top > of my head): > > - "personal" hooks ("I want this behaviour in my repo(s)") > - "project" hooks ("In this project we follow these conventions") > - "system" hooks ("This host runs gitolite (or whatever) which needs > these hooks...") > - "default" hooks (Some of the core Git code could have be > implemented as hooks (e.g. "--signoff"), but is instead put into core > Git) > > Maybe if we solved that problem, we could actually make use of hooks > instead of adding "code" to our git configs (by which I mean config > directives that are flexible enough to encode all kinds of semantics > and behaviors that are probably better expressed in real code...). OK how about, if $GIT_DIR/hooks/something is a directory, then the directory must contain a file named "index", listing all the hooks of type "something". All the hooks in "index" will be executed in the listing order. There could be directories inside .git/hooks/something to help categorize the scripts, so project hooks stay in "project" subdirectory and so on. With this we could provide "git hook" command to manipulate hooks and test out the new combination of hooks. We could even select what scripts not to run for a particular run, say you don't want the s-o-b hook active when you commit this thing, you could run git commit --exclude-hooks=pre-commit-msg/s-o-b You could exclude hooks by pattern as well git commit --exclude-hooks="pre-commit-msg/projects/*" Or run an unsinstalled hook just one time git commit --include-hooks=/path/to/my/hook Hooks like "Fixes" may need input from the user. The hook could bail out if the required input is not given. But it maybe a good idea for git to check and reject before running hooks, if the input is not specified (e.g. from command line). I guess those extra info has to be in .git/config and be added to .git/config by "git hook" command, unless we have some convention to express those without running the hook. For old Git versions that does not support this scheme, as directories usually have u+x, the hook directory should be mistaken as an executable and rejected when executed (permission denied in my test), which gives user a good warning that this repo should not be used with this git version. -- Duy ^ permalink raw reply [flat|nested] 49+ messages in thread
* Re: [PATCH] commit: Add -f, --fixes <commit> option to add Fixes: line 2013-10-31 6:28 ` Duy Nguyen @ 2013-10-31 17:20 ` Junio C Hamano 2013-10-31 23:52 ` Duy Nguyen 2013-11-01 0:16 ` Johan Herland 0 siblings, 2 replies; 49+ messages in thread From: Junio C Hamano @ 2013-10-31 17:20 UTC (permalink / raw) To: Duy Nguyen Cc: Johan Herland, Jeff King, Michael Haggerty, Josh Triplett, Git mailing list, Dan Carpenter, Greg KH, Linux Kernel mailing list Duy Nguyen <pclouds@gmail.com> writes: > OK how about, if $GIT_DIR/hooks/something is a directory, then the > directory must contain a file named "index", listing all the hooks of > type "something". All the hooks in "index" will be executed in the > listing order. Hooks that take arbitrary amount of information from the body read their standard input. How are your multiple hooks supposed to interact? Hooks that prevent you from doing something stupid signal allow/deny with their exit code. Do you fail a commit if any of your pre-commit hook fails, or is it OK to commit as long as one of them says so? If the former, do all the hooks described in the index still run, or does the first failure short-cut the remainder? ^ permalink raw reply [flat|nested] 49+ messages in thread
* Re: [PATCH] commit: Add -f, --fixes <commit> option to add Fixes: line 2013-10-31 17:20 ` Junio C Hamano @ 2013-10-31 23:52 ` Duy Nguyen 2013-11-01 0:16 ` Johan Herland 1 sibling, 0 replies; 49+ messages in thread From: Duy Nguyen @ 2013-10-31 23:52 UTC (permalink / raw) To: Junio C Hamano Cc: Johan Herland, Jeff King, Michael Haggerty, Josh Triplett, Git mailing list, Dan Carpenter, Greg KH, Linux Kernel mailing list On Fri, Nov 1, 2013 at 12:20 AM, Junio C Hamano <gitster@pobox.com> wrote: > Duy Nguyen <pclouds@gmail.com> writes: > >> OK how about, if $GIT_DIR/hooks/something is a directory, then the >> directory must contain a file named "index", listing all the hooks of >> type "something". All the hooks in "index" will be executed in the >> listing order. > > Hooks that take arbitrary amount of information from the body read > their standard input. How are your multiple hooks supposed to > interact? If each only needs to read a few lines from stdin, they can do so in order. If two hooks need to read till the end of stdin, they are incompatible. If we support some sort of hook signature, we could warn the user when they combine the two. If not, the second's failing (because stdin is already closed) may show the incompatibility. "git hook" should support dry-run mode to test out new combinations. > Hooks that prevent you from doing something stupid signal allow/deny > with their exit code. Do you fail a commit if any of your pre-commit > hook fails, or is it OK to commit as long as one of them says so? > If the former, do all the hooks described in the index still run, or > does the first failure short-cut the remainder? One failed hook fails the commit and stops the remaining from executing. You can skip the hook if you want with --exclude-hooks. -- Duy ^ permalink raw reply [flat|nested] 49+ messages in thread
* Re: [PATCH] commit: Add -f, --fixes <commit> option to add Fixes: line 2013-10-31 17:20 ` Junio C Hamano 2013-10-31 23:52 ` Duy Nguyen @ 2013-11-01 0:16 ` Johan Herland 1 sibling, 0 replies; 49+ messages in thread From: Johan Herland @ 2013-11-01 0:16 UTC (permalink / raw) To: Junio C Hamano Cc: Duy Nguyen, Jeff King, Michael Haggerty, Josh Triplett, Git mailing list, Dan Carpenter, Greg KH, Linux Kernel mailing list On Thu, Oct 31, 2013 at 6:20 PM, Junio C Hamano <gitster@pobox.com> wrote: > Duy Nguyen <pclouds@gmail.com> writes: >> OK how about, if $GIT_DIR/hooks/something is a directory, then the >> directory must contain a file named "index", listing all the hooks of >> type "something". All the hooks in "index" will be executed in the >> listing order. > > Hooks that take arbitrary amount of information from the body read > their standard input. How are your multiple hooks supposed to > interact? As an example, at $dayjob we have a "dispatcher" post-receive hook running on our Git server that captures the current environment, and reads all of stdin. It then iterates through a (configurable) sequence of "subhooks" providing them each with a copy of the data that was passed to it. The "subhooks" may perform duties such as notifying automated build and test systems, triggering updates of mirrors, updating bug trackers, formatting and sending commit emails to mailing lists, etc. Some of them are run synchronously (redirecting their output back to the push client), and some are run asynchronously (redirecting their output to logs). The nice thing is that each of the "subhooks" use the same post-receive hook interface, and is therefore a fully capable stand-alone hook by itself (often implemented in different languages, some of them are not even written by us), and also fully independent of the other "subhooks". It is therefore relatively straightforward to add, remove and mix hooks. > Hooks that prevent you from doing something stupid signal allow/deny > with their exit code. Do you fail a commit if any of your pre-commit > hook fails, or is it OK to commit as long as one of them says so? > If the former, do all the hooks described in the index still run, or > does the first failure short-cut the remainder? This clearly needs to be configurable, as there are valid use cases for all the behaviors you mention. That said, I believe that a sane default would be for a single hook failure to cause the entire chain-of-hooks to fail, including short-cutting the remainder of the hooks (at least for the hooks where the exit code determines the outcome of the entire operation). For example, one could envision a sequence of pre-commit hooks being configured something like this: [hook "pre-commit.check-whitespace"] run = /path/to/whitespace-checker on-error = fail-later [hook "pre-commit.check-valid-ident"] run = /path/to/ident-checker on-error = fail-later [hook "pre-commit.run-testsuite"] run = "/path/to/testsuite --with --arguments" on-error = fail-later The hooks would be run in sequence. The hook.pre-commit.*.run variable specifies how to execute the hook (it is assumed that each of the configured hooks behaves according to the pre-commit hook interface). The hook.pre-commit.*.on-error variable specifies how to handle a non-zero exit code from the hook. Possible values would be "abort" (abort the remaining hooks and return failure immediately), "fail-later" (keep running the remainder of the hooks, but make sure we do return failure in the end), or "ignore" (always pretend the hook returns successfully). The default on-error behavior should IMHO be "abort", but in this case, we don't want to abort on the first failure, as we'd rather report errors from _multiple_ hooks to the user in a single go. Similarly, a sequence of post-receive hooks could be configure like this: [hook "post-receive.trigger-buildbot"] run = /path/to/buildbot-trigger-hook [hook "post-receive.update-bugtracker"] run = /path/to/bugtracker-update-hook [hook "post-receive.trigger-mirror-update"] run = /path/to/mirror-update-hook async = true redirect-output = /var/log/mirror-update-hook.log [hook "post-receive.send-commit-emails"] run = /path/to/commit-emailer async = true Here, the .on-error variable is probably less than useful, since post-receive hooks cannot affect the outcome of the push operation (and having one post-receive hook abort the running of another is probably uncommon). Instead, the .async variable (default: false) is used to indicate which hooks should be run asynchronously (i.e. the client does not have to wait for these hooks to complete). On a server with many repos, you could even store the above in the global git config, to have the hooks available to all repos, and then use hook.post-receive.*.enabled = true/false to turn hooks on/off for individual repos. (A nice side-effect of putting this stuff in the config is that it makes is easy to add/remove/manage hooks through our Gitolite setup - which already has support for managing per-repo config options in the Gitolite config.) This is just some initial thoughts about a possible config format. A more important point though, is that we don't really need to add anything to core Git to support this. All we need to do is to implement a set of "dispatcher" hooks that read the relevant configuration and perform the job accordingly. Although these "dispatcher" hooks could certainly be developed as a separate project - more or less independent from git.git, I do believe there would be considerable value in distributing them along with Git and easily enabling them (maybe even enabling them by default, as without the config options they would just be no-ops). Otherwise, it would be hard to make them used/accepted widely enough to actually replace current ad hoc solutions. ...Johan -- Johan Herland, <johan@herland.net> www.herland.net ^ permalink raw reply [flat|nested] 49+ messages in thread
* Re: [PATCH] commit: Add -f, --fixes <commit> option to add Fixes: line 2013-10-27 1:34 ` [PATCH] commit: Add -f, --fixes <commit> option to add Fixes: line Josh Triplett 2013-10-27 5:42 ` Michael Haggerty @ 2013-10-27 8:33 ` Duy Nguyen 2013-10-27 9:13 ` Josh Triplett 2013-10-28 0:49 ` Jim Hill ` (2 subsequent siblings) 4 siblings, 1 reply; 49+ messages in thread From: Duy Nguyen @ 2013-10-27 8:33 UTC (permalink / raw) To: Josh Triplett Cc: Git Mailing List, Dan Carpenter, Greg KH, ksummit-2013-discuss, ksummit-attendees, Linux Kernel On Sun, Oct 27, 2013 at 8:34 AM, Josh Triplett <josh@joshtriplett.org> wrote: > Add a command line option for git commit to automatically construct the > "Fixes:" line for a commit. This avoids the need to manually construct > that line by copy-pasting the commit hash and subject. But you still have to copy/paste the hash in command line. I wonder if we should approach it differently: the user writes "Fixes: <hash>" in the commit message, then git detects these lines and expands them using a user-configured format. For the kernel circle, the format would be "%h ('%s')" (I'll need to think how to let the user say "minimum 12 chars"). Other projects need to refer to old commits sometimes in commit messages too and this could be extended further to expand inline abbrev sha-1s, but to not break the text alignment badly, maybe footnotes will be created to store subjects and stuff, rather than do inline expansion. For example, commit 1232343 breaks something..... becomes comit 1232343 [1] breaks something.... [1] 123234332131 (do something wrong - at this date) -- Duy ^ permalink raw reply [flat|nested] 49+ messages in thread
* Re: [PATCH] commit: Add -f, --fixes <commit> option to add Fixes: line 2013-10-27 8:33 ` Duy Nguyen @ 2013-10-27 9:13 ` Josh Triplett 0 siblings, 0 replies; 49+ messages in thread From: Josh Triplett @ 2013-10-27 9:13 UTC (permalink / raw) To: Duy Nguyen Cc: Git Mailing List, Dan Carpenter, Greg KH, ksummit-2013-discuss, ksummit-attendees, Linux Kernel On Sun, Oct 27, 2013 at 03:33:19PM +0700, Duy Nguyen wrote: > On Sun, Oct 27, 2013 at 8:34 AM, Josh Triplett <josh@joshtriplett.org> wrote: > > Add a command line option for git commit to automatically construct the > > "Fixes:" line for a commit. This avoids the need to manually construct > > that line by copy-pasting the commit hash and subject. > > But you still have to copy/paste the hash in command line. I wonder if > we should approach it differently: the user writes "Fixes: <hash>" in > the commit message, then git detects these lines and expands them Then you have to copy/paste the hash into the commit message; either way you're not getting around that. However, note that you can pass a ref instead of a commit hash, if you happen to have saved a tag pointing to the broken ref. (Or, for instance, if you have it from a bisection.) I could imagine supporting that approach in addition (via a commit-msg hook, for instance), but I'd still like to have the command-line option to git commit. > using a user-configured format. For the kernel circle, the format > would be "%h ('%s')" (I'll need to think how to let the user say > "minimum 12 chars"). I considered making the format configurable, and that's easy enough to do, but I wanted to start out with the simplest patch that achieved the goal, on the theory that it's easy to add configurability later if anyone actually needs it. > Other projects need to refer to old commits sometimes in commit > messages too and this could be extended further to expand inline > abbrev sha-1s, but to not break the text alignment badly, maybe > footnotes will be created to store subjects and stuff, rather than do > inline expansion. For example, > > commit 1232343 breaks something..... > > becomes > > comit 1232343 [1] breaks something.... > > [1] 123234332131 (do something wrong - at this date) Easily done via a commit-msg hook, if you want that. - Josh Triplett ^ permalink raw reply [flat|nested] 49+ messages in thread
* Re: [PATCH] commit: Add -f, --fixes <commit> option to add Fixes: line 2013-10-27 1:34 ` [PATCH] commit: Add -f, --fixes <commit> option to add Fixes: line Josh Triplett 2013-10-27 5:42 ` Michael Haggerty 2013-10-27 8:33 ` Duy Nguyen @ 2013-10-28 0:49 ` Jim Hill 2013-10-28 1:52 ` Junio C Hamano 2013-10-30 17:28 ` Tony Luck 4 siblings, 0 replies; 49+ messages in thread From: Jim Hill @ 2013-10-28 0:49 UTC (permalink / raw) To: Josh Triplett, git Cc: Dan Carpenter, Greg KH, ksummit-2013-discuss, ksummit-attendees, linux-kernel On 10/26/13 18:34, Josh Triplett wrote: > Linux Kernel ... "Fixes:" line ... containing an abbreviated commit hash <!-- --> > This helps people (or automated tools) determine how far to backport I beg pardon if I'm rehearsing an old debate, but it seems to me it would be better and worthwhile to bring more of git to bear by adding `reference` links as follows from considering this proposed sequence: # ...G---B---... history-with-bug-at-B Gprime=`git commit-tree --reference G` Bprime=`git commit-tree --reference B -p $Gprime` # ...G---B---... history-with-bug-at-B # : : # <-- `:`'s are `reference` links # G'--B' $Bprime is a mergeable cherry-pick for B `reference` links have no enforced semantics. Teach all current logic to ignore them (fetch doesn't fetch through them, fsck doesn't care, etc.). Elaborating some of the good parts: * If the author and committer data are left untouched when `commit-tree`'s tree and message arguments are defaulted, as above, to the referenced commit's tree and message, the resulting commit is unique. * Bullet-proof cherry-pick creation becomes easy and idempotent: git-make-cherry-pick() { local picked=$1 set -- `git rev-list --parents $picked^!` shift local parents local parent local p2 for parent; do p2="$p2 -p `git commit-tree --reference $parent`" done git commit-tree --reference $picked $parents` } * Which makes the created commit id a fully-implemented _change-id_ for the referenced commit: git merge $(git-make-cherry-pick $B) can be done from anywhere, merge won't have to rely on patch-id's to detect cherry-picks done this way. * A bugged commit gets fixed by fixing its reference commit and merging normally, worry-free: ...G---B ... -F Merge fix X for a bug in B : : / G'--B'---X X's commit message is the `Fixes:` equivalent Bugfix commit X can be safely merged anywhere. Worst case, `git merge -s ours --no-commit X` and do whatever you would have done otherwise. `merge` might usefully be updated to warn about merging from a commit with only a reference parent, I think merging from `G'` would probably be a mistake. --- So, this is as far as I've gotten with this, is there reason to think it should or shouldn't be pursued? ^ permalink raw reply [flat|nested] 49+ messages in thread
* Re: [PATCH] commit: Add -f, --fixes <commit> option to add Fixes: line 2013-10-27 1:34 ` [PATCH] commit: Add -f, --fixes <commit> option to add Fixes: line Josh Triplett ` (2 preceding siblings ...) 2013-10-28 0:49 ` Jim Hill @ 2013-10-28 1:52 ` Junio C Hamano 2013-10-28 7:16 ` Josh Triplett 2013-10-28 9:08 ` Junio C Hamano 2013-10-30 17:28 ` Tony Luck 4 siblings, 2 replies; 49+ messages in thread From: Junio C Hamano @ 2013-10-28 1:52 UTC (permalink / raw) To: Josh Triplett Cc: git, Dan Carpenter, Greg KH, ksummit-2013-discuss, ksummit-attendees, linux-kernel There are unbound number of kinds of trailers people would want to add, depending on their projects' needs. We should not have to add a specific support for a tailer like this one, before thinking through to see if we can add generic support for adding arbitrary trailers to avoid code and interface bloat. Think of the existing --signoff as a historical mistake. Such a generic "adding arbitrary trailers" support, when done properly, should be able to express what "--signoff" does, and we should be able to redo "--signoff" as a special case of that generic "adding arbitrary trailers" support, and at that point, "Fixes:" trailer the kernel project wants to use should fall out as a natural consequence. ^ permalink raw reply [flat|nested] 49+ messages in thread
* Re: [PATCH] commit: Add -f, --fixes <commit> option to add Fixes: line 2013-10-28 1:52 ` Junio C Hamano @ 2013-10-28 7:16 ` Josh Triplett 2013-10-28 8:27 ` Michael Haggerty 2013-10-28 8:59 ` [ksummit-attendees] " Christoph Hellwig 2013-10-28 9:08 ` Junio C Hamano 1 sibling, 2 replies; 49+ messages in thread From: Josh Triplett @ 2013-10-28 7:16 UTC (permalink / raw) To: Junio C Hamano Cc: git, Dan Carpenter, Greg KH, ksummit-2013-discuss, ksummit-attendees, linux-kernel On Sun, Oct 27, 2013 at 06:52:18PM -0700, Junio C Hamano wrote: > There are unbound number of kinds of trailers people would want to > add, depending on their projects' needs. We should not have to add > a specific support for a tailer like this one, before thinking > through to see if we can add generic support for adding arbitrary > trailers to avoid code and interface bloat. > > Think of the existing --signoff as a historical mistake. Such a > generic "adding arbitrary trailers" support, when done properly, > should be able to express what "--signoff" does, and we should be > able to redo "--signoff" as a special case of that generic "adding > arbitrary trailers" support, and at that point, "Fixes:" trailer the > kernel project wants to use should fall out as a natural consequence. Well, the add_signoff_extra function I added makes it easy to add any kind of trailing data you want to a commit; the question just becomes what the UI looks like to drive that. Would you be OK with a solution that pushes the specific supported footer lines into git's configuration, and then supplies default configuration for common cases such as Fixes? The option could become -f/--footer, and the configuration would specify how to parse various arguments of -f and turn them into something. For example: [footer "Fixes"] abbrev = f arg = commit format = %h ('%s') git commit -f Cc:stable@vger.kernel.org -f f:bad-commit ... The Cc line there would go unparsed since there's no specific support for it, while the 'f:bad-commit' would get expanded by the configuration above to parse bad-commit as a committish and format it using the specified pretty format. Look reasonable? I could start out by adding support for footer lines that take commits as arguments and format them using arbitrary pretty strings, and leave room for future expansion to support footers that reference idents (given some way to expand idents from some shorter form, otherwise there's no point). - Josh Triplett ^ permalink raw reply [flat|nested] 49+ messages in thread
* Re: [PATCH] commit: Add -f, --fixes <commit> option to add Fixes: line 2013-10-28 7:16 ` Josh Triplett @ 2013-10-28 8:27 ` Michael Haggerty 2013-10-28 8:59 ` [ksummit-attendees] " Christoph Hellwig 1 sibling, 0 replies; 49+ messages in thread From: Michael Haggerty @ 2013-10-28 8:27 UTC (permalink / raw) To: Josh Triplett, Junio C Hamano Cc: git, Dan Carpenter, Greg KH, ksummit-2013-discuss, ksummit-attendees, linux-kernel On 10/28/2013 08:16 AM, Josh Triplett wrote: > On Sun, Oct 27, 2013 at 06:52:18PM -0700, Junio C Hamano wrote: >> There are unbound number of kinds of trailers people would want to >> add, depending on their projects' needs. We should not have to add >> a specific support for a tailer like this one, before thinking >> through to see if we can add generic support for adding arbitrary >> trailers to avoid code and interface bloat. >> >> Think of the existing --signoff as a historical mistake. Such a >> generic "adding arbitrary trailers" support, when done properly, >> should be able to express what "--signoff" does, and we should be >> able to redo "--signoff" as a special case of that generic "adding >> arbitrary trailers" support, and at that point, "Fixes:" trailer the >> kernel project wants to use should fall out as a natural consequence. > > Well, the add_signoff_extra function I added makes it easy to add any > kind of trailing data you want to a commit; the question just becomes > what the UI looks like to drive that. > > Would you be OK with a solution that pushes the specific supported > footer lines into git's configuration, and then supplies default > configuration for common cases such as Fixes? The option could become > -f/--footer, and the configuration would specify how to parse various > arguments of -f and turn them into something. For example: > > [footer "Fixes"] > abbrev = f > arg = commit > format = %h ('%s') It could be even more decoupled, for example like this: [footer "Fixes"] type = pipe cmd = awk '{ print $1 }' | git log --stdin --no-walk --abbrev=12 --pretty=format:\"Fixes: %h ('%s')\" Note that the command is written to be idempotent; that way git could re-pipe the old value(s) of the footer though the command if necessary. And it can handle multiple lines, since some callback scripts might want to see all of them at once. Michael -- Michael Haggerty mhagger@alum.mit.edu http://softwareswirl.blogspot.com/ ^ permalink raw reply [flat|nested] 49+ messages in thread
* Re: [ksummit-attendees] [PATCH] commit: Add -f, --fixes <commit> option to add Fixes: line 2013-10-28 7:16 ` Josh Triplett 2013-10-28 8:27 ` Michael Haggerty @ 2013-10-28 8:59 ` Christoph Hellwig 2013-10-28 23:09 ` Benjamin Herrenschmidt 1 sibling, 1 reply; 49+ messages in thread From: Christoph Hellwig @ 2013-10-28 8:59 UTC (permalink / raw) To: Josh Triplett Cc: Junio C Hamano, ksummit-2013-discuss, linux-kernel, ksummit-attendees, git Btw, can we please take away this discussion from ksummit-attendees? It's got absolutely nothing to do with kernel summit and is getting fairly annoying. Thanks! ^ permalink raw reply [flat|nested] 49+ messages in thread
* Re: [ksummit-attendees] [PATCH] commit: Add -f, --fixes <commit> option to add Fixes: line 2013-10-28 8:59 ` [ksummit-attendees] " Christoph Hellwig @ 2013-10-28 23:09 ` Benjamin Herrenschmidt 2013-10-28 23:38 ` Russell King - ARM Linux 2013-10-28 23:41 ` Russell King - ARM Linux 0 siblings, 2 replies; 49+ messages in thread From: Benjamin Herrenschmidt @ 2013-10-28 23:09 UTC (permalink / raw) To: Christoph Hellwig Cc: Josh Triplett, git, ksummit-2013-discuss, ksummit-attendees, linux-kernel, Junio C Hamano On Mon, 2013-10-28 at 09:59 +0100, Christoph Hellwig wrote: > Btw, can we please take away this discussion from ksummit-attendees? It's got > absolutely nothing to do with kernel summit and is getting fairly annoying. Ack. Additionally, iirc, we had decided that - We don't cross post multiple lists - We drop the annoying subject tags As is, all I see is some attempt at doing an lkml dup, which is pointless Ben. ^ permalink raw reply [flat|nested] 49+ messages in thread
* Re: [ksummit-attendees] [PATCH] commit: Add -f, --fixes <commit> option to add Fixes: line 2013-10-28 23:09 ` Benjamin Herrenschmidt @ 2013-10-28 23:38 ` Russell King - ARM Linux 2013-10-28 23:41 ` Russell King - ARM Linux 1 sibling, 0 replies; 49+ messages in thread From: Russell King - ARM Linux @ 2013-10-28 23:38 UTC (permalink / raw) To: Benjamin Herrenschmidt Cc: Christoph Hellwig, ksummit-2013-discuss, linux-kernel, ksummit-attendees, Junio C Hamano, git On Tue, Oct 29, 2013 at 10:09:53AM +1100, Benjamin Herrenschmidt wrote: > On Mon, 2013-10-28 at 09:59 +0100, Christoph Hellwig wrote: > > Btw, can we please take away this discussion from ksummit-attendees? It's got > > absolutely nothing to do with kernel summit and is getting fairly annoying. > > Ack. Additionally, iirc, we had decided that > > - We don't cross post multiple lists > > - We drop the annoying subject tags > > As is, all I see is some attempt at doing an lkml dup, which is > pointless I agree too. This whole thread seems to be about noise, and I too thought there was something about not cross-posting between this list and any other list. ^ permalink raw reply [flat|nested] 49+ messages in thread
* Re: [ksummit-attendees] [PATCH] commit: Add -f, --fixes <commit> option to add Fixes: line 2013-10-28 23:09 ` Benjamin Herrenschmidt 2013-10-28 23:38 ` Russell King - ARM Linux @ 2013-10-28 23:41 ` Russell King - ARM Linux 1 sibling, 0 replies; 49+ messages in thread From: Russell King - ARM Linux @ 2013-10-28 23:41 UTC (permalink / raw) To: Benjamin Herrenschmidt Cc: Christoph Hellwig, ksummit-2013-discuss, linux-kernel, ksummit-attendees, Junio C Hamano, git On Tue, Oct 29, 2013 at 10:09:53AM +1100, Benjamin Herrenschmidt wrote: > On Mon, 2013-10-28 at 09:59 +0100, Christoph Hellwig wrote: > > Btw, can we please take away this discussion from ksummit-attendees? It's got > > absolutely nothing to do with kernel summit and is getting fairly annoying. > > Ack. Additionally, iirc, we had decided that > > - We don't cross post multiple lists > > - We drop the annoying subject tags > > As is, all I see is some attempt at doing an lkml dup, which is > pointless I agree too. This whole thread seems to be about noise, and I too thought there was something about not cross-posting between this list and any other list. ^ permalink raw reply [flat|nested] 49+ messages in thread
* Re: [PATCH] commit: Add -f, --fixes <commit> option to add Fixes: line 2013-10-28 1:52 ` Junio C Hamano 2013-10-28 7:16 ` Josh Triplett @ 2013-10-28 9:08 ` Junio C Hamano 2013-10-29 4:45 ` Christian Couder 1 sibling, 1 reply; 49+ messages in thread From: Junio C Hamano @ 2013-10-28 9:08 UTC (permalink / raw) To: Josh Triplett Cc: git, Dan Carpenter, Greg KH, ksummit-2013-discuss, ksummit-attendees, linux-kernel Junio C Hamano <gitster@pobox.com> writes: > There are unbound number of kinds of trailers people would want to > add, depending on their projects' needs. We should not have to add > a specific support for a tailer like this one, before thinking > through to see if we can add generic support for adding arbitrary > trailers to avoid code and interface bloat. > > Think of the existing --signoff as a historical mistake. Such a > generic "adding arbitrary trailers" support, when done properly, > should be able to express what "--signoff" does, and we should be > able to redo "--signoff" as a special case of that generic "adding > arbitrary trailers" support, and at that point, "Fixes:" trailer the > kernel project wants to use should fall out as a natural consequence. Thinking aloud further, what I had in mind was along the lines of the following. * The most generic external interface would be spelled as --trailer <token>[=<param>] where <token> can be things like "signoff", "closes", "acked-by", "change-id", "fixes", etc.; they can be taken from an unbounded set. The historical "--signoff" can become a short-hand for "--trailer signoff". More than one "--trailer" option can be given on a single command line. * The token is used to look into the configuration, e.g., [commitTrailer "signoff"] style = append-norepeat trailer = Signed-off-by command = echo "$GIT_COMMITTER_NAME <$GIT_COMMITTER_EMAIL>"' [commitTrailer "change-id"] style = append-only-if-missing trailer = Change-Id command = 'git hash-object -t commit --stdin <$GIT_PROTO_COMMIT' [commitTrailer "fixes"] style = overwrite trailer = Fixes command = 'git log -1 --oneline --format="%h (%s)" --abbrev-commit=14 $ARG' where - "commitTrailer.<token>.style" defines the interaction with existing trailer of the same kind (e.g. S-o-b: accumulates by appending, but we try not to repeat the same sign-off twice which would show you forwarding your own message you are the last person in the Sign-off chain; Fixes: if there is already one will remove the old one and replaces; etc.); - "commitTrailer.<token>.trailer" defines the trailer label at the beginning of the trailer line; - "commitTrailer.<token>.command" gives the command to run to obtain the payload after the "trailer" label. A handful obvious and useful variables are exported for the command to use, and <param> is exported as $ARG, if present. With the most generic syntax, with the above commitTrailer.fixes.* configuration, I would imagine that you can say something like: git commit --trailer fixes="v2.6.12^{/^i386: tweak frobnitz}" to say that the first commit you find traversing the history of v2.6.12 whose title is "i386: tweak frobnitz" was faulty, and you are creating a commit that corrects its mistake. Giving some default configuration to often used trailer types (e.g. configuration for "--trailer signoff") and promoting some commonly used ones into a separate built-in option (e.g. an option "--signoff" that does not have to say "--trailer signoff") are entirely separate issues, and only time can nudge us into evaluating individual types of trailers. ^ permalink raw reply [flat|nested] 49+ messages in thread
* Re: [PATCH] commit: Add -f, --fixes <commit> option to add Fixes: line 2013-10-28 9:08 ` Junio C Hamano @ 2013-10-29 4:45 ` Christian Couder 2013-10-29 19:54 ` Junio C Hamano 0 siblings, 1 reply; 49+ messages in thread From: Christian Couder @ 2013-10-29 4:45 UTC (permalink / raw) To: Junio C Hamano; +Cc: Josh Triplett, git, Dan Carpenter, Greg KH On Mon, Oct 28, 2013 at 10:08 AM, Junio C Hamano <gitster@pobox.com> wrote: > > Thinking aloud further, what I had in mind was along the lines of > the following. > > * The most generic external interface would be spelled as > > --trailer <token>[=<param>] > > where <token> can be things like "signoff", "closes", "acked-by", > "change-id", "fixes", etc.; they can be taken from an unbounded > set. The historical "--signoff" can become a short-hand for > "--trailer signoff". More than one "--trailer" option can be > given on a single command line. Ok, and maybe the <token> could also be the full trailer like "Signed-off-by". > * The token is used to look into the configuration, e.g., > > [commitTrailer "signoff"] > style = append-norepeat > trailer = Signed-off-by > command = echo "$GIT_COMMITTER_NAME <$GIT_COMMITTER_EMAIL>"' > > [commitTrailer "change-id"] > style = append-only-if-missing > trailer = Change-Id > command = 'git hash-object -t commit --stdin <$GIT_PROTO_COMMIT' > > [commitTrailer "fixes"] > style = overwrite > trailer = Fixes > command = 'git log -1 --oneline --format="%h (%s)" --abbrev-commit=14 $ARG' > > where > > - "commitTrailer.<token>.style" defines the interaction with > existing trailer of the same kind (e.g. S-o-b: accumulates by > appending, but we try not to repeat the same sign-off twice > which would show you forwarding your own message you are the > last person in the Sign-off chain; Fixes: if there is already > one will remove the old one and replaces; etc.); > > - "commitTrailer.<token>.trailer" defines the trailer label at > the beginning of the trailer line; > > - "commitTrailer.<token>.command" gives the command to run to > obtain the payload after the "trailer" label. A handful > obvious and useful variables are exported for the command to > use, and <param> is exported as $ARG, if present. > > With the most generic syntax, with the above commitTrailer.fixes.* > configuration, I would imagine that you can say something like: > > git commit --trailer fixes="v2.6.12^{/^i386: tweak frobnitz}" > > to say that the first commit you find traversing the history of > v2.6.12 whose title is "i386: tweak frobnitz" was faulty, and you > are creating a commit that corrects its mistake. > > Giving some default configuration to often used trailer types > (e.g. configuration for "--trailer signoff") and promoting some > commonly used ones into a separate built-in option (e.g. an option > "--signoff" that does not have to say "--trailer signoff") are > entirely separate issues, and only time can nudge us into evaluating > individual types of trailers. Ok, and maybe, if there is no configuration for a trailer token, we could look at the commit template. Thanks, Christian. ^ permalink raw reply [flat|nested] 49+ messages in thread
* Re: [PATCH] commit: Add -f, --fixes <commit> option to add Fixes: line 2013-10-29 4:45 ` Christian Couder @ 2013-10-29 19:54 ` Junio C Hamano 0 siblings, 0 replies; 49+ messages in thread From: Junio C Hamano @ 2013-10-29 19:54 UTC (permalink / raw) To: Christian Couder; +Cc: Josh Triplett, git, Dan Carpenter, Greg KH Christian Couder <christian.couder@gmail.com> writes: > On Mon, Oct 28, 2013 at 10:08 AM, Junio C Hamano <gitster@pobox.com> wrote: >> >> Thinking aloud further, what I had in mind was along the lines of >> the following. >> >> * The most generic external interface would be spelled as >> >> --trailer <token>[=<param>] >> >> where <token> can be things like "signoff", "closes", "acked-by", >> "change-id", "fixes", etc.; they can be taken from an unbounded >> set. The historical "--signoff" can become a short-hand for >> "--trailer signoff". More than one "--trailer" option can be >> given on a single command line. > > Ok, and maybe the <token> could also be the full trailer like "Signed-off-by". Yeah, between these two: [commitTrailer "Signed-off-by"] style = append-norepeat shorthand = signoff command = echo "$GIT_COMMITTER_NAME <$GIT_COMMITTER_EMAIL>"' [commitTrailer "signoff"] style = append-norepeat trailer = Signed-off-by command = echo "$GIT_COMMITTER_NAME <$GIT_COMMITTER_EMAIL>"' I do not have strong preference either way. One of these two sets of configuration will have to become a built-in default (i.e. still allowing people from other development community conventions to redefine how S-o-b: works), so there will be no user-visible difference either way at the highest-level Porcelain anyway. Oh, also, it seems people prefer to call them "footers", judging by the messages in this thread. I do not have a problem with that word, either; I suspect we may have to update existing documentation that calls them "trailers", if we go that way, though. ^ permalink raw reply [flat|nested] 49+ messages in thread
* Re: [PATCH] commit: Add -f, --fixes <commit> option to add Fixes: line 2013-10-27 1:34 ` [PATCH] commit: Add -f, --fixes <commit> option to add Fixes: line Josh Triplett ` (3 preceding siblings ...) 2013-10-28 1:52 ` Junio C Hamano @ 2013-10-30 17:28 ` Tony Luck 2013-10-30 18:33 ` Junio C Hamano 4 siblings, 1 reply; 49+ messages in thread From: Tony Luck @ 2013-10-30 17:28 UTC (permalink / raw) To: Josh Triplett Cc: Git Mailing List, Dan Carpenter, Greg KH, ksummit-2013-discuss, ksummit-attendees, Linux Kernel Mailing List On Sat, Oct 26, 2013 at 6:34 PM, Josh Triplett <josh@joshtriplett.org> wrote: > + format_commit_message(commit, "Fixes: %h ('%s')\n", sb, &ctx); What is the value of double wrapping the commit message inside '...' and then ('...')? -Tony ^ permalink raw reply [flat|nested] 49+ messages in thread
* Re: [PATCH] commit: Add -f, --fixes <commit> option to add Fixes: line 2013-10-30 17:28 ` Tony Luck @ 2013-10-30 18:33 ` Junio C Hamano 0 siblings, 0 replies; 49+ messages in thread From: Junio C Hamano @ 2013-10-30 18:33 UTC (permalink / raw) To: Tony Luck; +Cc: Josh Triplett, Git Mailing List, Dan Carpenter, Greg KH Tony Luck <tony.luck@gmail.com> writes: > On Sat, Oct 26, 2013 at 6:34 PM, Josh Triplett <josh@joshtriplett.org> wrote: > >> + format_commit_message(commit, "Fixes: %h ('%s')\n", sb, &ctx); > > What is the value of double wrapping the commit message inside '...' > and then ('...')? Good point ;-) ^ permalink raw reply [flat|nested] 49+ messages in thread
end of thread, other threads:[~2013-11-02 12:55 UTC | newest] Thread overview: 49+ messages (download: mbox.gz / follow: Atom feed) -- links below jump to the message on this page -- [not found] <20131024122255.GI9378@mwanda> [not found] ` <20131024122512.GB9534@mwanda> [not found] ` <20131026181709.GB10488@kroah.com> 2013-10-27 1:34 ` [PATCH] commit: Add -f, --fixes <commit> option to add Fixes: line Josh Triplett 2013-10-27 5:42 ` Michael Haggerty 2013-10-27 6:37 ` Theodore Ts'o 2013-10-27 7:14 ` Josh Triplett 2013-10-27 8:03 ` [Ksummit-2013-discuss] " Michel Lespinasse 2013-10-27 9:23 ` Josh Triplett 2013-10-27 8:09 ` Thomas Rast 2013-10-27 9:20 ` Josh Triplett 2013-10-27 10:59 ` Johan Herland 2013-10-27 19:10 ` Christian Couder 2013-10-28 2:46 ` Johan Herland 2013-10-28 22:10 ` Thomas Rast 2013-10-29 2:02 ` Jeff King 2013-10-30 17:53 ` Johan Herland 2013-10-29 6:23 ` Christian Couder 2013-10-30 19:07 ` Johan Herland 2013-11-02 12:54 ` Christian Couder 2013-10-27 9:26 ` Stefan Beller 2013-10-27 16:30 ` Thomas Rast 2013-10-27 17:03 ` Stefan Beller 2013-10-31 23:03 ` Stefan Beller 2013-10-31 23:04 ` [PATCH] Documentation: add a script to generate a (long/short) options overview Stefan Beller 2013-10-31 23:09 ` Stefan Beller 2013-10-31 23:45 ` brian m. carlson 2013-11-01 0:09 ` Junio C Hamano 2013-10-28 9:02 ` [PATCH] commit: Add -f, --fixes <commit> option to add Fixes: line Michael Haggerty 2013-10-28 11:29 ` Johan Herland 2013-10-29 2:08 ` Jeff King 2013-10-29 8:26 ` Matthieu Moy 2013-10-30 18:12 ` Johan Herland 2013-10-31 6:28 ` Duy Nguyen 2013-10-31 17:20 ` Junio C Hamano 2013-10-31 23:52 ` Duy Nguyen 2013-11-01 0:16 ` Johan Herland 2013-10-27 8:33 ` Duy Nguyen 2013-10-27 9:13 ` Josh Triplett 2013-10-28 0:49 ` Jim Hill 2013-10-28 1:52 ` Junio C Hamano 2013-10-28 7:16 ` Josh Triplett 2013-10-28 8:27 ` Michael Haggerty 2013-10-28 8:59 ` [ksummit-attendees] " Christoph Hellwig 2013-10-28 23:09 ` Benjamin Herrenschmidt 2013-10-28 23:38 ` Russell King - ARM Linux 2013-10-28 23:41 ` Russell King - ARM Linux 2013-10-28 9:08 ` Junio C Hamano 2013-10-29 4:45 ` Christian Couder 2013-10-29 19:54 ` Junio C Hamano 2013-10-30 17:28 ` Tony Luck 2013-10-30 18:33 ` Junio C Hamano
Code repositories for project(s) associated with this public inbox https://80x24.org/mirrors/git.git This is a public inbox, see mirroring instructions for how to clone and mirror all data and code used for this inbox; as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).