Glossary¶

context diff¶

A type of diff file that represents changes to a file using before/after sections. These are not well supported by Review Board.

Context diffs indicate a changed region of a file by showing before and after versions of a group of lines. The changed lines in that before and after region are indicated by beginning the lines with an exclamation point (!). Changes that only add lines only show one section.

diff file¶

A file representing changes to one or more files. Common diff formats are unified diffs and context diffs.

post-commit hook¶

A script that is executed after a commit is made to a repository. See Automating rbt post for ways to use post-commit hooks to automate submitting review requests to Review Board.

post-commit review¶

A form of code review where code is reviewed after it is submitted to a repository, usually in a development branch.

pre-commit review¶

A form of code review where code is reviewed before it ever gets checked into a repository. This is generally a more strict way to handle code review, which can lead to fewer problems in the codebase.

private review requests¶

A review request that can only be accessed by users meeting certain criteria, such as being on an access list for a group or repository. See Access Control for more information.

topological sort¶

An ordering of a set of items that depend on one another such that no item will be ordered before its dependencies. For more information, see the Wikipedia article on topological sorting.

unified diff¶

A type of diff file designed to be easy to parse and easy to read by humans. This is the format supported by Review Board.

Unified diffs indicate the changed region of a file by showing some unchanged lines of context, then lines beginning with a minus sign (-) to show removed lines or a plus sign (+) to show added lines. Replaced lines are shown by a remove line followed by an add line.