rBuilder Online:Repository Browser
From rPath Wiki
|
rBuilder Online provides a Repository Browser as part of its web interface. All users, registered and unregistered, can browse the contents of any project repository. To browse a project's repository, navigate to the project and click Browse Repository from the Project Resources menu. The sections on this page outline the Repository Browser features.
 | rBuilder Online describes repository contents as troves, which include groups, packages, and components. |
Repository Browser Index
Repository contents are indexed by trove name. After clicking Browse Repository for a project, use the linked letters at the top of the index to list all troves that start with that letter. (Note that group troves all start with the group- prefix and are listed in the "G" section of the repository browser.) Click a linked trove name to view that trove's information.
Trove Information Pages
The information pages for each trove provide a summary of information for the trove and links to obtain more detailed information. See the following sections for an outline of the trove information for different types of troves.
Trove Information for Packages
The trove information for a package includes:
- The package name
- The version information for the package
- Click the arrow beside the version to toggle between the full version string and the default abbreviated view.
- When applicable, the version of the package from which it was shadowed or cloned
- Click the arrow beside the original package from which the current package was shadowed or cloned to toggle between its full version string and the default abbreviated view.
- If the originating package is in rBuilder Online, click its linked version to view its complete trove information.
- The source trove from which the package is built
- Click the linked source trove name to view its component information.
- A linked list of the components that make up the package
- Click a linked component to view the source trove from which it was built (may differ from the package itself)
- The flavors in which the trove was cooked
- Click the arrow beside a flavor to toggle between the entire flavor and its default abbreviated view.
- A Show Contents link for displaying the list of files that make up the package
- In the list of files, note those shown in blue indicating files that were shadowed and modified on the current branch.
- An All Versions display, showing a tree of labels and revisions on each label
- Click a linked revision to change the information page to the trove matching that label and revision
Trove Information for Groups
The trove information for a group includes:
- The group name
- The version information for the group
- Click the arrow beside the version to toggle between the full version string and the default abbreviated view.
- When applicable, the version of the group from which it was shadowed or cloned
- Click the arrow beside the original group from which the current group was shadowed or cloned to toggle between its full version string and the default abbreviated view.
- If the originating group is in rBuilder Online, click its linked version to view its complete trove information.
- The source trove from which the group is built
- Click the linked source trove name to view its component information.
- The flavors in which the trove was cooked
- Click the arrow beside a flavor to toggle between the entire flavor and its default abbreviated view.
- A Show Contents link for displaying the list of troves that make up the group
- In the list of troves, click the arrow beside a trove's version to see its full version string.
- In the list of troves, click the linked trove name to view the files that make up that trove. Note files shown in blue indicating files that were shadowed and modified on the current branch.
- An All Versions display, showing a tree of labels and revisions on each label
- Click a linked revision to change the information page to the trove matching that label and revision
Trove Information for Source Components
Source components are troves that contain the source from which a package or group is built. Click the linked :source component name in the Built from source section of a package or group information page to view information about the source component. The trove information for a source component includes:
- The component name
- The version information for the source
- Click the arrow beside the version to toggle between the full version string and the default abbreviated view.
- When applicable, the version of the source component from which it was shadowed or cloned
- Click the arrow beside the original component from which the current component was shadowed or cloned to toggle between its full version string and the default abbreviated view.
- If the originating component is in rBuilder Online, click its linked version to view its complete trove information.
- The change log (commit message) submitted at the time the source version was committed to the repository, along with the timestamp and developer information for that commit
- A Show Files link for displaying the list of files that were committed as source for the package or group
- In the list of troves, note the recipe file among the committed files.
- In the list of troves, click the linked file name to download the file. Note that this is a convenient way to view a recipe without checking out the source trove.
- An All Versions display, showing a tree of labels and revisions on each label
- Click a linked revision to change the information page to the trove matching that label and revision
Compare Trove Versions
When a trove has been shadowed from a parent branch and modified on the current branch, the Repository Browser includes a feature to compare the differences between a file on the parent and the same file on the shadow. To see these differences:
- Navigate to the list of files in the shadowed trove.
- Click Calculate Diff beside the file listing.
- Scroll the result page to see the differences between the parent version (on the left) and the current version (on the right).
In the following cases, the diff results vary:
- When a file exists on the current branch and not on the parent branch, the results include the entire file on the current branch.
- When a file's metadata has changed, but the file contents have not changed, the results include a message indicating this.