On 2019-10-16 11:01:34 +0900, Junio C Hamano wrote:
> Doan Tran Cong Danh <congdan...@gmail.com> writes:
>
> > The target objects for copying notes was defaulted to HEAD from very
> > early stage of git-notes.
> >
> > However, that default was limited by commit bbb1b8a35a, ("notes: check
> > number of parameters to "git notes copy"", 2010-06-28).
>
> Sorry, I don't quite get the above. The said commit made sure 'git
> notes copy' gets the right number of arguments, saying """Otherwise
> we may segfault with too few parameters.""" I take that as a sign
> that before that commit it was not defaulting to HEAD but attempting
> to access the missing argv[2] (or whatever the index the <to-object>
> should be at) and dereferencing a NULL?
>
> ... goes and digs ...
>
> I think v1.6.6.1-458-g74884b524e is the commit that made the command
> line parsing into the current shape, i.e. one parse_options() call
> in each of the subcommand that gets dispatched, and you are right
> that with that version a single argument given on the command line
> is taken as the <from-object> and <to-object> defaults to HEAD.
>
> So... what happend between that vesrion and v1.7.1-200-gbbb1b8a35a?
>
> ... goes and looks at bbb1b8a35a again ...
>
> Ah, I think there is an off-by-one. When not from-stdin and not
> using rewrite-cmd, before that patch, we did not even check if
> from-obj exists, so in that sense, the commit had a right idea that
> it must check for "too few parameters", but it shouldn't have
> insisted that we have at least two. It is OK to have just one,
> i.e. only the from-obj, for our purpose.
Yes, this is my intention.
> > diff --git a/t/t3301-notes.sh b/t/t3301-notes.sh
> > index d3fa298c6a..a8f9a0f36c 100755
> > --- a/t/t3301-notes.sh
> > +++ b/t/t3301-notes.sh
> > @@ -908,6 +908,10 @@ test_expect_success 'allow overwrite with "git notes
> > copy -f"' '
> > git notes copy -f HEAD~2 HEAD &&
> > git log -1 >actual &&
> > test_cmp expect actual &&
> > + test "$(git notes list HEAD)" = "$(git notes list HEAD~2)" &&
> > + git notes copy -f HEAD~2 &&
> > + git log -1 >actual &&
> > + test_cmp expect actual &&
> > test "$(git notes list HEAD)" = "$(git notes list HEAD~2)"
> > '
>
> This I am not sure is a good test to add to, especially as a fix to
I was writing this patch just before my bed time, just to get some
comments on the directions, e.g:
- loosen the argc requirements; or
- do the code cleanup
> bbb1b8a, which added this test:
>
> diff --git a/t/t3301-notes.sh b/t/t3301-notes.sh
> index 64f32ad94d..2d67a40fc1 100755
> --- a/t/t3301-notes.sh
> +++ b/t/t3301-notes.sh
> @@ -1044,4 +1044,10 @@ test_expect_success 'GIT_NOTES_REWRITE_REF overrides
> config' '
> git log -1 > output &&
> test_cmp expect output
> '
> +
> +test_expect_success 'git notes copy diagnoses too many or too few
> parameters' '
> + test_must_fail git notes copy &&
> + test_must_fail git notes copy one two three
> +'
> +
> test_done
>
> The lack of testing that "git notes copy <from-obj>" succeeding is
> why the off-by-one bug was not noticed, so I think that test (which
> still exists to this day) is the right place to add a test to
> protect this fix.
I don't think this is a good place to add this test either,
since the test description specificaly said it diagnoses too many or
too few parameters.
Anyway, the test `git notes copy one two three` still fails if we
accidentally allow 3 arguments since one two three isn't valid ref.
I'm gonna add a statement to assert the diagnose message.
Since I don't want to update the commit id (e.g. 10th, 11th, etc..)
of other test cases, I think it'd be better to modify the current test:
- for the test case without '-f' flag, remove HEAD if it's the target,
and add a test-case to copy to somewhere else. Well, all of our current
test cases only test with HEAD as target-object.
- for the test case with '-f' flag, I think I'll keep my current
approach.
>
> As to the log message, here is how I would explain/justify the
> change, if I were writing it.
I'll update the commit message.
--
Danh
