git/list[1] front-page[2] threads[3] people[4] search[5] about
 

Re: [PATCH] Adding list of p4 jobs to git commit message

From
Luke Diamand <luke@diamand.org>
Date
Apr 15, 2016, 22:10 UTC
Message-ID
<CAE5ih79hV-76SxjW0NHjD+WsvO1s6rthM=pvqyrh10zbrFi2rQ@mail.gmail.com>
In-Reply-To
<xmqq4mb2bot7.fsf@gitster.mtv.corp.google.com>
On 15 April 2016 at 21:27, Junio C Hamano <gitster@pobox.com> wrote:
Show 35 quoted lines
> Jan Durovec <jan.durovec@gmail.com> writes:
>
>> ---
>
> A few issues.  Please:
>
>  (1) Sign-off your work.
>
>  (2) Try to find those who are familiar with the area and Cc them.
>
>      "git shortlog -s -n --since=18.months --no-merges git-p4.py"
>      may help.
>
>  (3) Follow the style of existing commits when giving a title to
>      your patch.
>
>      "git shortlog --since=18.months --no-merges git-p4.py" may
>      help you notice "git-p4: do this thing" is the common way to
>      title "git p4" patches.
>
>  (4) Justify why your change is a good thing in your log message.
>      What you did, i.e. "list p4 jobs when making a commit", can be
>      seen by the patch, but readers cannot guess why you thought it
>      is a good idea to extract "job%d" out of the P4 commit and to
>      record them in the resulting Git commit, unless you explain
>      things like:
>
>      - what goes wrong if you don't?
>      - when would "job%d" appear in P4 commit?
>      - is it sane to assume "job0", "job1",... appear consecutively?
>
>  (5) Describe what your change does clearly.  "Adding list" is not
>      quite clear.  Where in the "git commit message" are you adding
>      the list, and why is that location in the message the most
>      appropriate place to add it?

Additionally, it would be very useful to add a test case (see t/t98*). There are quite a few test cases for git-p4, and they make maintenance a lot easier.

Some documentation (Documentation/git-p4.txt) would also be useful.

Thanks Luke

Previous: Junio C HamanoNext: Jan Durovec
Message 3 of 5 in “Adding list of p4 jobs to git commit message”
  1. Adding list of p4 jobs to git commit messageJan Durovec, Apr 15, 2016
  2. Junio C HamanoApr 15, 2016
  3. Luke DiamandApr 15, 2016
  4. Jan DurovecApr 16, 2016
  5. Lars SchneiderApr 16, 2016

Read the whole thread, see it on lore, or plain text.

$ cat FOOTERMessages come from the public archive at lore.kernel.org/git, fetched every hour. The front page is chosen and written each morning by an AI editor and can be wrong; the threads themselves are the record. About and API. For agents: an MCP server at https://gitlist.dev/mcp, and any thread, story or person page as Markdown by adding .md to its URL (or sending Accept: text/markdown). Details in /llms.txt.