From c8bae7493d2f2910b57f13ded012e86bdcfb0532 Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Sun, 7 Apr 2024 16:47:53 +0200 Subject: Adding upstream version 1:2.39.2. Signed-off-by: Daniel Baumann --- Documentation/git-request-pull.txt | 79 ++++++++++++++++++++++++++++++++++++++ 1 file changed, 79 insertions(+) create mode 100644 Documentation/git-request-pull.txt (limited to 'Documentation/git-request-pull.txt') diff --git a/Documentation/git-request-pull.txt b/Documentation/git-request-pull.txt new file mode 100644 index 0000000..fa5a426 --- /dev/null +++ b/Documentation/git-request-pull.txt @@ -0,0 +1,79 @@ +git-request-pull(1) +=================== + +NAME +---- +git-request-pull - Generates a summary of pending changes + +SYNOPSIS +-------- +[verse] +'git request-pull' [-p] [] + +DESCRIPTION +----------- + +Generate a request asking your upstream project to pull changes into +their tree. The request, printed to the standard output, +begins with the branch description, summarizes +the changes and indicates from where they can be pulled. + +The upstream project is expected to have the commit named by +`` and the output asks it to integrate the changes you made +since that commit, up to the commit named by ``, by visiting +the repository named by ``. + + +OPTIONS +------- +-p:: + Include patch text in the output. + +:: + Commit to start at. This names a commit that is already in + the upstream history. + +:: + The repository URL to be pulled from. + +:: + Commit to end at (defaults to HEAD). This names the commit + at the tip of the history you are asking to be pulled. ++ +When the repository named by `` has the commit at a tip of a +ref that is different from the ref you have locally, you can use the +`:` syntax, to have its local name, a colon `:`, and +its remote name. + + +EXAMPLES +-------- + +Imagine that you built your work on your `master` branch on top of +the `v1.0` release, and want it to be integrated to the project. +First you push that change to your public repository for others to +see: + + git push https://git.ko.xz/project master + +Then, you run this command: + + git request-pull v1.0 https://git.ko.xz/project master + +which will produce a request to the upstream, summarizing the +changes between the `v1.0` release and your `master`, to pull it +from your public repository. + +If you pushed your change to a branch whose name is different from +the one you have locally, e.g. + + git push https://git.ko.xz/project master:for-linus + +then you can ask that to be pulled with + + git request-pull v1.0 https://git.ko.xz/project master:for-linus + + +GIT +--- +Part of the linkgit:git[1] suite -- cgit v1.2.3