aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorDrew DeVault <sir@cmpwn.com>2018-09-30 09:58:34 -0400
committerDrew DeVault <sir@cmpwn.com>2018-09-30 09:58:34 -0400
commit0fdbc0daadb0027761bb74cecb7c992adf171f15 (patch)
tree2519d1b8e1df55731118e5b5e2b5bee3cc1c3a47
parentd88f888dc598b5b4fb3bcb7a7f34b4a756c66103 (diff)
downloadsr.ht-docs-0fdbc0daadb0027761bb74cecb7c992adf171f15.tar.gz
Update send-email guide
-rw-r--r--git.sr.ht/send-email.md17
1 files changed, 17 insertions, 0 deletions
diff --git a/git.sr.ht/send-email.md b/git.sr.ht/send-email.md
index b45d49b..9e6e6a9 100644
--- a/git.sr.ht/send-email.md
+++ b/git.sr.ht/send-email.md
@@ -130,6 +130,23 @@ submit the next version of your patches, use `git send-email` normally, except:
[amend]: https://www.git-scm.com/docs/git-commit#git-commit---amend
[git-rebase]: https://www.git-scm.com/docs/git-rebase
+## Pulling from upstream
+
+As you continue to work, you may want to pull from the upstream, and you
+almost certainly don't want to create a merge commit when you have WIP or
+unmerged patches in your history. To this end, you should generally use `git
+pull --rebase` to fetch the latest changes from upstream.
+
+If you get a conflict, read the information git prints. You have two choices -
+skip the patch or fix it. If your patch has already been merged, the maintainer
+likely made some minor changes that prevents git from detecting it's the same
+commit you have locally - in this case, just `git rebase --skip` the patch. If
+your patch still hasn't been merged upstream, you should resolve the conflicts
+in your editor, using `git add some/file.c` to mark the conflicts as resolved,
+and then using `git rebase --continue` to move on. You will probably want to
+send a `-v2` patch upstream when you're done - any conflicts you resolved, your
+maintainer will have to address, too. Save them the time!
+
## Extra tips
Here are a few extra tricks you might find useful with `git send-email`.