Message ID | pull.465.v2.git.1573828978.gitgitgadget@gmail.com (mailing list archive) |
---|---|
Headers | show |
Series | Feature: New Variable git-p4.p4program | expand |
"Ben Keene via GitGitGadget" <gitgitgadget@gmail.com> writes: > Ben Keene (3): > Cast byte strings to unicode strings in python3 > Added general variable git-p4.binary and added a default for windows > of 'P4.EXE' > Changed the name of the parameter from git-p4.binary to > git-p4.p4program That's rather poor organization. In the larger picture, nobody wants to even know jthat you used to call git-p4.p4program with a different name or what that different name was. They do not even need to know why the new name is an improvement (but you do not even discuss to justify the name change in the proposed log message of 3/3, which is even worse X-<). When presenting your work to the public, Git lets you pretend to be a perfect human who never made mistake while preparing it and built the series as a logical progression with perfect foresight. That is how "git rebase -i" is useful. Learn to take advantage of that ;-) As to individual patches, our local (read: project specific) convention around here is to state the are the patch touches (in the case of these patches, "git-p4" is the appropriate area name), colon, and then a one-line summary of what the step is about (the last one is done without initial capitalization). The summary is written with the focus more on why and what than how. Thanks.
Junio C Hamano <gitster@pobox.com> writes: > As to individual patches, our local (read: project specific) > convention around here is to state the are the patch touches (in the > case of these patches, "git-p4" is the appropriate area name), colon, > and then a one-line summary of what the step is about (the last one > is done without initial capitalization). The summary is written with > the focus more on why and what than how. Sorry for a late typofix. "to state the AREA the patch touches" was what I meant. So I would expect all patches to this file (which is the only component of 'git-p4' subsystem) to begin with "git-p4: " prefix. Thanks.
On 11/17/2019 8:15 PM, Junio C Hamano wrote: > Junio C Hamano <gitster@pobox.com> writes: > >> As to individual patches, our local (read: project specific) >> convention around here is to state the are the patch touches (in the >> case of these patches, "git-p4" is the appropriate area name), colon, >> and then a one-line summary of what the step is about (the last one >> is done without initial capitalization). The summary is written with >> the focus more on why and what than how. > > Sorry for a late typofix. "to state the AREA the patch touches" was > what I meant. So I would expect all patches to this file (which is > the only component of 'git-p4' subsystem) to begin with "git-p4: " > prefix. > > Thanks. I was having email trouble trying to reply to your suggestions. (Downloaded yet another mail client, and this seems to work) I'll make those changes.