Review Board 7.1 alpha 0 (dev)

Usage: rbt post [options] [revisions]

Uploads diffs to create and update review requests.

Options:

  -d, --debug           display debug output

  Posting Options:

    Controls the behavior of a post, including what review request gets

    posted and how, and what happens after it is posted.

    -r ID, --review-request-id=ID

                        Specifies the existing review request ID to update.

    -u, --update        Automatically determines the existing review request

                        to update.

    -p, --publish       Immediately publishes the review request after

                        posting.

    -o, --open          Opens a web browser to the review request after

                        posting.

    --submit-as=USERNAME

                        The user name to use as the author of the review

                        request, instead of the logged in user.

    --change-only       Updates fields from the change description, but does

                        not upload a new diff (Perforce/Plastic only).

    --diff-only         Uploads a new diff, but does not update fields from

                        the change description (Perforce/Plastic only).

  Review Board Server Options:

    Options necessary to communicate and authenticate with a Review Board

    server.

    --server=SERVER     Specifies the Review Board server to use.

    --disable-proxy     Prevents requests from going through a proxy server.

    --username=USERNAME

                        The user name to be supplied to the Review Board

                        server.

    --password=PASSWORD

                        The password to be supplied to the Review Board

                        server.

  Repository Options:

    --repository=REPOSITORY_NAME

                        The name of the repository configured on Review Board

                        that matches the local repository.

    --repository-url=REPOSITORY_URL

                        The URL for a repository, used for creating a diff

                        outside of a working copy (currently only supported by

                        Subversion with specific revisions or --diff-filename

                        and ClearCase with relative paths outside the view).

                        For git, this specifies the origin url of the current

                        repository, overriding the origin URL supplied by the

                        git client.

    --repository-type=REPOSITORY_TYPE

                        The type of repository in the current directory. In

                        most cases this should be detected automatically, but

                        some directory structures containing multiple

                        repositories require this option to select the proper

                        type. The `rbt list-repo-types` command can be used to

                        list the supported values.

  Review Request Field Options:

    Options for setting the contents of fields in the review request.

    -g, --guess-fields  Short-hand for --guess-summary --guess-description.

    --guess-summary     Generates the Summary field based on the commit

                        messages (Bazaar/Git/Mercurial only).

    --guess-description

                        Generates the Description field based on the commit

                        messages (Bazaar/Git/Mercurial only).

    --change-description=CHANGE_DESCRIPTION

                        A description of what changed in this update of the

                        review request. This is ignored for new review

                        requests.

    --summary=SUMMARY   The new contents for the Summary field.

    --description=DESCRIPTION

                        The new contents for the Description field.

    --description-file=FILENAME

                        A text file containing the new contents for the

                        Description field.

    --testing-done=TESTING_DONE

                        The new contents for the Testing Done field.

    --testing-done-file=FILENAME

                        A text file containing the new contents for the

                        Testing Done field.

    --branch=BRANCH     The branch the change will be committed on.

    --bugs-closed=BUGS_CLOSED

                        The comma-separated list of bug IDs closed.

    --target-groups=TARGET_GROUPS

                        The names of the groups that should perform the

                        review.

    --target-people=TARGET_PEOPLE

                        The usernames of the people who should perform the

                        review.

    --markdown          Specifies if the summary and description should be

                        interpreted as Markdown-formatted text (Review Board

                        2.0+ only).

  Diff Generation Options:

    Options for choosing what gets included in a diff, and how the diff is

    generated.

    --revision-range=REVISION_RANGE

                        Generates a diff for the given revision range.

                        [DEPRECATED]

    -I INCLUDE_FILES, --include=INCLUDE_FILES

                        Includes only the given file in the diff. This can be

                        used multiple times to specify multiple files.

    --parent=BRANCH     The parent branch this diff should be generated

                        against (Bazaar/Git/Mercurial only).

    --diff-filename=FILENAME

                        Uploads an existing diff file, instead of generating a

                        new diff.

  Git Options:

    Git-specific options for selecting revisions for diff generation.

    --tracking-branch=BRANCH

                        The remote tracking branch from which your local

                        branch is derived (defaults to origin/master).

  Perforce Options:

    Perforce-specific options for selecting the Perforce client and

    communicating with the repository.

    --p4-client=CLIENT_NAME

                        The Perforce client name for the repository.

    --p4-port=PORT      The IP address for the Perforce server.

    --p4-passwd=PASSWORD

                        The Perforce password or ticket of the user in the

                        P4USER environment variable.

  Subversion Options:

    Subversion-specific options for controlling diff generation.

    --basedir=PATH      The path within the repository where the diff was

                        generated. This overrides the detected path. Often

                        used when passing --diff-filename.

    --svn-show-copies-as-adds=y/n

                        Treat copied or moved files as new files.

    --svn-changelist=ID

                        Generates the diff for review based on a local

                        changelist. [DEPRECATED]