Documentation / git-request-pull.txton commit regex: use regexec_buf() (b7d36ff)
   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
  49EXAMPLE
  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