Jump to >

Reviewing File Attachments

New in version 1.6.

File attachments can be reviewed using Review Board. Some file types, such as images, have special interfaces for doing reviews. For image files, see Reviewing Images. For Markdown files, see Reviewing Markdown Files. For other text files, see Reviewing Text Files.

For other files, reviewers can download the files, and add comments to the attachment as a whole.

../../../_images/file-attachments1.png

The file attachment box provides a Add Comment button. Clicking this button pops up a comment dialog that works exactly like the dialog you get when reviewing diffs.

../../../_images/comment-box.png

Comments support rich text using the Markdown language. See Using Markdown for more information.

The file attachment comment dialog supports issue tracking. See the section on Issue Tracking for more information.

As of Review Board 1.6.0, there’s no visual indication of an existing comment on the file attachment. However, you can see your comment and edit it by clicking Add Comment again.

Viewing Other File Revisions

New in version 2.5.

Every public revision of a file attachment is available for review. The file attachment revision selector allows you to look at previous versions of the change. To browse old revisions, set the handle on the left to No Diff and the handle on the right to the revision you want to look at.

../../../_images/file-revision-selector.png

The file attachment viewer also allows you to do comparisons between diff revisions (called interdiffs). In other words, it lets you see what changes the developer has made since the previous version of the file you looked at.

To view an interdiff between two file attachment revisions, set the two handles to the revisions you want to compare.

The behaviour of the file attachment revision selector is the same as the diff revision selector. See Reviewing Diffs for more information.