Page MenuHomeFreeBSD

Porter's handbook: Mention git-format-patch(1) in using git to make patches
ClosedPublic

Authored by lwhsu on Oct 13 2021, 5:08 PM.
Tags
None
Referenced Files
Unknown Object (File)
Tue, Apr 16, 9:55 AM
Unknown Object (File)
Tue, Apr 2, 4:44 PM
Unknown Object (File)
Feb 20 2024, 4:31 PM
Unknown Object (File)
Jan 12 2024, 2:22 PM
Unknown Object (File)
Dec 22 2023, 5:05 AM
Unknown Object (File)
Dec 20 2023, 3:53 AM
Unknown Object (File)
Dec 1 2023, 9:03 PM
Unknown Object (File)
Nov 9 2023, 9:42 AM

Diff Detail

Repository
R9 FreeBSD doc repository
Lint
No Lint Coverage
Unit
No Test Coverage
Build Status
Buildable 42251
Build 39139: arc lint + arc unit

Event Timeline

lwhsu requested review of this revision.Oct 13 2021, 5:08 PM
lwhsu created this revision.
This revision is now accepted and ready to land.Oct 13 2021, 5:11 PM

Maybe worth mentioning context lines (-U9999) and only generating a patch for the requested commit itself (-1)

ygy added inline comments.
documentation/content/en/books/porters-handbook/upgrading/_index.adoc
183
diizzy added inline comments.
documentation/content/en/books/porters-handbook/upgrading/_index.adoc
122

This is only true if you use format-patch?

This is only true if you use format-patch?

I believe you need to use git-am(1) to get the metadata (author, timestamps, et cetera) applied.

documentation/content/en/books/porters-handbook/upgrading/_index.adoc
120โ€“122

Shouldn't git-am(1) be mentioned for git-format-patch?

122

This is only true if you use format-patch?

A few minor nits.

documentation/content/en/books/porters-handbook/upgrading/_index.adoc
120โ€“122
122

Or alternatively, "method for submitting".

This revision now requires review to proceed.Oct 19 2021, 8:52 AM

Looks good to me, but let's hear from other reviewers involved here as well.

This revision is now accepted and ready to land.Oct 19 2021, 8:17 PM
imp added inline comments.
documentation/content/en/books/porters-handbook/upgrading/_index.adoc
182

"Where foo is replaced with the first line of the commit message."

183

I'd suggest that "Once the patch is accepted upstream" here. There's no harm in keeping branches around and it's a pain in the butt to try to reconstruct the branch from the hashes in the diffs (which aren't the commit hash, but the object hash).

This revision now requires review to proceed.Oct 22 2021, 4:05 AM
This revision is now accepted and ready to land.Oct 29 2021, 4:51 AM