Downloading and Caching Your Repository’s History

The good thing about historical data is that it doesn’t change and this makes it an excellent candidate for caching.

Cornerstone can download and cache your repository’s log to greatly speed up browsing and querying activities.

However, this behavior may not always be appropriate. For example, downloading huge repositories (e.g. the Apache.org repository has over 1.7 million revisions) may not be feasible. Or you may not intend to repeatedly browse a repository’s history and want to avoid the overhead of caching the log on your Mac’s hard drive.

For whatever reason, you may not want Cornerstone to cache your repository’s log.

Caching Options

Cornerstone notices when a repository’s log is accessed for the first time and asks how the log should be accessed. The possible responses are:

A repository’s caching behavior can be changed at any time:

  1. Select a repository in the source list.
  2. Right click to display the repository’s context menu.
  3. Select the Caching... command.
  4. The repository’s caching options are displayed.

The Rebuild... button can be used to rebuild a repository’s log cache. This may be necessary if the server’s log is changed using the svnadmin command line tool.

Cache Disk Usage

On average, each revision will take between 1KB and 2.5KB of disk space, depending on the verbosity of the log messages and change set size (i.e. number of files committed with each revision).

Small repositories with up to 5,000 revisions generally require less than 10MB of space.

Larger repositories with tens of thousands of revisions can consume significant disk space. There is no upper limit on the size the cache may grow to.

You can determine how must disk space a repository’s cache is consuming using the Caching... command.