]> git.ipfire.org Git - thirdparty/git.git/blame_incremental - Documentation/git-request-pull.txt
Merge branch 'hi/gpg-mintrustlevel'
[thirdparty/git.git] / Documentation / git-request-pull.txt
... / ...
CommitLineData
1git-request-pull(1)
2===================
3
4NAME
5----
6git-request-pull - Generates a summary of pending changes
7
8SYNOPSIS
9--------
10[verse]
11'git request-pull' [-p] <start> <url> [<end>]
12
13DESCRIPTION
14-----------
15
16Generate a request asking your upstream project to pull changes into
17their tree. The request, printed to the standard output,
18begins with the branch description, summarizes
19the changes and indicates from where they can be pulled.
20
21The upstream project is expected to have the commit named by
22`<start>` and the output asks it to integrate the changes you made
23since that commit, up to the commit named by `<end>`, by visiting
24the repository named by `<url>`.
25
26
27OPTIONS
28-------
29-p::
30 Include patch text in the output.
31
32<start>::
33 Commit to start at. This names a commit that is already in
34 the upstream history.
35
36<url>::
37 The repository URL to be pulled from.
38
39<end>::
40 Commit to end at (defaults to HEAD). This names the commit
41 at the tip of the history you are asking to be pulled.
42+
43When the repository named by `<url>` has the commit at a tip of a
44ref that is different from the ref you have locally, you can use the
45`<local>:<remote>` syntax, to have its local name, a colon `:`, and
46its remote name.
47
48
49EXAMPLES
50--------
51
52Imagine that you built your work on your `master` branch on top of
53the `v1.0` release, and want it to be integrated to the project.
54First you push that change to your public repository for others to
55see:
56
57 git push https://git.ko.xz/project master
58
59Then, you run this command:
60
61 git request-pull v1.0 https://git.ko.xz/project master
62
63which will produce a request to the upstream, summarizing the
64changes between the `v1.0` release and your `master`, to pull it
65from your public repository.
66
67If you pushed your change to a branch whose name is different from
68the one you have locally, e.g.
69
70 git push https://git.ko.xz/project master:for-linus
71
72then you can ask that to be pulled with
73
74 git request-pull v1.0 https://git.ko.xz/project master:for-linus
75
76
77GIT
78---
79Part of the linkgit:git[1] suite