Changes between Version 10 and Version 11 of PullRequestsPlugin

Timestamp:

Aug 31, 2019, 9:56:34 AM (5 years ago)

Author:

lucid

Comment:

--

PullRequestsPlugin

@@ -11 +11 @@
 }}}
 
-A special `<command> PR: [arg]` syntax is introduced to create and control pull requests from ticket comments.
-
 {{{#!rbox width=320px
 = Example of PRs created, reviewed and closed in ticket.
@@ -18 +16 @@
 }}}
 
-This plugin also adds a macro that lists the queried pull requests, and it also adds a new admin panel, that lists all pull requests.
+By default the PR status can be "open", "reviewed" or "closed". The available status values can be [#Configuration configured].
+
+Ticket comments containing a `<command> PR: [arg]` can [#CreatePullRequest create a PR] or [#ChangeStatusofaPullRequest change its status].
+
+This plugin also adds a [#PRQueryMacro macro that lists the queried pull requests], and it also adds a new admin panel, that lists all pull requests.
 
 {{{#!rbox width=320px
@@ -30 +32 @@
 
 Examples:
-* `open PR: changeset:123/MyForkedRepositoryName`
-* `open PR: log:MyForkedRepositoryName@bookmark_name`
-* `open PR: [https://www.example.com/git/branches/123 Branch 123]`
+* `open PR: changeset:123/ForkRepoName`
+* `open PR: log:ForkRepoName@branch`
+* `open PR: [https://www.example.com/git/branches/x BranchX]`
 
-The pull request ''number'' is automatically inserted into the ticket comment.
-
-The trac.ini option `[pullrequests] create_commands` can be changed to allow multiple or different commands that create pull requests in different states. The status of a created pull request is always the same as the command that was used to create it.
+The pull request ''number'' is automatically assigned and inserted into the ticket comment.
 
 === Change Status of a Pull Request
@@ -46 +46 @@
 * `closed PR:7`
 
-The trac.ini option `[pullrequests] update_commands` can be changed to allow different commands that change the pull request statuses. The next status of a pull request is always the same as the command that was used to change status.
+=== Configuration
+
+The trac.ini option `[pullrequests] create_commands` can be changed to allow multiple or different commands that [#CreatePullRequest create pull requests] in different states. The status of a created pull request is always the same as the command that was used to create it.
+
+The trac.ini option `[pullrequests] update_commands` can be changed to allow different commands that [ChangeStatusofaPullRequets change the pull request status]. The next status of a pull request is always the same as the command that was used to change status.
+
+Example configuration:
+{{{#!ini
+[pullrequests]
+create_commands = open, draft, prototype, sketch
+update_commands = closed, reviewed, accepted, rejected, withdrawn, deferred, superseded, updated, verified, tested, suspended
+}}}
 
 === PRQuery Macro
@@ -58 +69 @@
 * `[[PRQuery(status=reviewed, author=joe)]]`
 * `[[PRQuery(status=open, author=!joe)]]`
+
+This allows creating overview wiki pages listing all relevant PRs.
 
 == !Bugs/Feature Requests
@@ -77 +90 @@
 You can check out PullRequestsPlugin from [/svn/pullrequestsplugin here] using Subversion, or [source:pullrequestsplugin browse the source] with Trac.
 
+||= Trac =||= Plugin =||
+|| >=1.4 || [source:pullrequestsplugin/trunk trunk] ||
+|| >=1.2 || [source:pullrequestsplugin/tags/pullrequestsplugin-1.1 1.1] ||
+
 == Installation