[[PageOutline(2-5,Contents,pullout)]]

= Pull Requests

== Description

Track the status of pull requests.

This plugin adds a new admin panel that lists all pull requests.

A special `<command> PR: [arg]` syntax is introduced to create and control pull requests from ticket comments.

=== Create Pull Request
A new pull request is automatically created when a ticket comment contains the command `open PR: <link>`.

Examples:
* `open PR: changeset:123/MyForkedRepositoryName`
* `open PR: log:MyForkedRepositoryName@bookmark_name`
* `open PR: [https://www.example.com/git/branches/123 Branch 123]`

The pull request ''number'' is automatically inserted into the ticket comment.

=== Change Status
The status of a pull request is automatically changed when a ticket commend contains the command `<newstatus> PR:<number>`.

Examples:
* `reviewed PR:3`
* `merged PR:7`
* `rejected PR:123`


== !Bugs/Feature Requests

Existing bugs and feature requests for PullRequestsPlugin are 
[report:9?COMPONENT=PullRequestsPlugin here].

If you have any issues, create a 
[/newticket?component=PullRequestsPlugin new ticket].

[[TicketQuery(component=PullRequestsPlugin&group=type,format=progress)]]

== Download

Download the zipped source from [export:pullrequestsplugin here].

== Source

You can check out PullRequestsPlugin from [http://trac-hacks.org/svn/pullrequestsplugin here] using Subversion, or [source:pullrequestsplugin browse the source] with Trac.

== Installation

General instructions on installing Trac plugins can be found on the [TracPlugins#InstallingaTracplugin TracPlugins] page.

== Recent Changes

[[ChangeLog(pullrequestsplugin, 3)]]

== !Author/Contributors

**Author:** [wiki:lucid] [[BR]]
**Maintainer:** [[Maintainer]] [[BR]]
**Contributors:**