• Get Review Board
  • What's New
  • Products
  • Review Board Code review, image review, and document review
  • Documentation
  • Release Notes
  • Power Pack Enterprise integrations, reports, and enhanced document review
  • Try for 60 Days
  • Purchase
  • RBCommons Review Board as a Service, hosted by us
  • Pricing
  • RBTools Command line tools and Python API for Review Board
  • Documentation
  • Release Notes
  • Review Bot Automated code review, connecting tools you already use
  • Documentation
  • Release Notes
  • RB Gateway Manage Git and Mercurial repositories in your network
  • Documentation
  • Release Notes
  • Learn and Explore
  • What is Code Review?
  • Documentation
  • Frequently Asked Questions
  • Support Options
  • Third-Party Integrations
  • Demo
  • Review Board RBTools Power Pack Review Bot Djblets RB Gateway
    1. RBTools 0.6
    2. Version 5.x
    3. Version 4.x
    4. Version 3.x
    5. Version 2.0
    6. Version 1.0
    7. Version 0.7
    8. Version 0.6
    9. Version 0.5
    10. rbt Commands
    11. diff
  • Home
  • Configuration
  • rbt Commands
  • api-get
  • attach
  • close
  • diff
  • list-repo-types
  • patch
  • post
  • publish
  • setup-repo
  • status
  • Overview of the Python API Client
  • Tutorial
  • Resource-Specific Functionality
  • General Index
  • Release Notes
  • This documentation covers RBTools 0.6. You can select a version above or view the latest documentation.

    diff¶

    rbt diff is similar to rbt post, but will only print the diff to standard out instead of creating a review request for it.

    Usage:

    $ rbt diff [options] [revisions]
    

    Default Options¶

    A number of options to rbt diff can be set by default in .reviewboardrc. These can go either in the repository’s or the user’s .reviewboardrc.

    The options include:

    • DEBUG (-d)
    • REVIEWBOARD_URL (--server)
    • USERNAME (--username)
    • PASSWORD (--password)
    • REPOSITORY_TYPE (--repository-type)

    Options¶

    -d, –debug¶

    Display debug output.

    The default can be set in DEBUG in .reviewboardrc.

    –server¶

    Specify a different Review Board server to use.

    The default can be set in REVIEWBOARD_URL in .reviewboardrc.

    –parent¶

    The parent branch this diff should be against (only available if your repository supports parent diffs).

    -I <file>, –include <file>¶

    Include only the specified file in the diff. This argument can be passed in multiple times to include multiple files. This is only available with some SCM backends (Bazaar, CVS, Git, Mercurial, Perforce, and SVN).

    –tracking-branch¶

    Tracking branch from which your branch is derived (Git only, defaults to origin/master)

    –svn-changelist¶

    Generate the diff for review based on a local SVN changelist.

    –repository¶

    The name of the repository to look up when posting the change. This is the same name shown on the New Review Request page or in the repository configuration page.

    The default can be set in REPOSITORY in .reviewboardrc.

    –repository-url¶

    The url for a repository 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.

    The default can be set in REPOSITORY_URL in .reviewboardrc.

    Note that versions of RBTools prior to 0.6 used the REPOSITORY setting in .reviewboardrc, and allowed a repository name to be passed to --repository-url. This is no longer supported in 0.6 and higher. You may need to update your configuration and scripts appropriately.

    –username¶

    Username to be supplied to the Review Board server.

    The default can be set in USERNAME in .reviewboardrc.

    –password¶

    Password to be supplied to the Review Board server.

    The default can be set in PASSWORD in .reviewboardrc.

    –repository-type¶

    Specifies 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.

    The default can be set in REPOSITORY_TYPE in .reviewboardrc.

    –p4-client¶

    The Perforce client name that the review is in.

    The default can be set in P4_CLIENT in .reviewboardrc.

    –p4-port¶

    The Perforce servers IP address that the review is on.

    The default can be set in P4_PORT in .reviewboardrc.

    –p4-passwd¶

    The Perforce password or ticket of the user in the P4USER environment variable.

    The default can be set in P4_PASSWD in .reviewboardrc.

    Keep up with the latest Review Board releases, security updates, and helpful information.

    About
    News
    Demo
    RBCommons Hosting
    Integrations
    Happy Users
    Support Options
    Documentation
    FAQ
    User Manual
    RBTools
    Administration Guide
    Power Pack
    Release Notes
    Downloads
    Review Board
    RBTools
    Djblets
    Power Pack
    Package Store
    PGP Signatures
    Contributing
    Bug Tracker
    Submit Patches
    Development Setup
    Wiki
    Follow Us
    Mailing Lists
    Reddit
    Twitter
    Mastodon
    Facebook
    YouTube

    Copyright © 2006-2025 Beanbag, Inc. All rights reserved.

    Terms of Service — Privacy Policy — AI Ethics Policy — Branding

    On this page

    • [Top]
    • Default Options
    • Options