IceCube Trac System

What is Trac?

Trac is a graphical representation of our software repository. You can:

  • Browse the source code tree
  • View change logs
  • See diffs spanning multiple changes
  • View and create tickets

Trac can be found at:

http://code.icecube.wisc.edu

What is Trac?

_images/index.png

Login

The first step to interacting with trac is to log in:

_images/login.png

Browse the Source Code

Opening the source code browser, the first thing we see is that IceCube has two repositories:

  • IceCube - most things go here
  • IceTray - core software that is shared with other collaborations
_images/browse_root.png

IceCube

We will focus on the IceCube repository, which is subdivided into a few key sections:

_images/browse_icecube.png

Browse the Source Code

  • Attic - where old code goes to die

  • meta-projects - your key software bundles:

    _images/browse_metaprojects.png

Browse the Source Code

  • papers - save all your paper drafts here

  • projects - all official projects:

    _images/browse_projects.png

Browse the Source Code

  • sandbox: Your personal scratch directories

    _images/browse_sandbox.png

Project Example - clsim

Notice the structure of trunk, releases, and branches.

_images/browse_clsim.png

Revision Log

The easiest way to see revisions is to go to the "revision log" in the code browser:

_images/revision_select.png

Revision Log

The revision log is exactly what it sounds like. It shows the revision history for the current path.

_images/revision_log.png

Revision Log

To view a single revision, also known as a "changeset," click the icon next to the revision:

_images/revision_single.png

Revision Log

To view differences over multiple revisions select the revision range that you want and click "View changes"

_images/revision_multiple.png

Changeset

A changeset will show all files and lines that have changed.

_images/changeset_intro.png

Changeset

Here, we see that a line was commented out:

_images/changeset_diff.png

Timeline

The timeline shows the latest history for the entire repository.

_images/timeline.png

Tickets

If you find a problem, please file a ticket. It is quick and easy, and we won't punish you if you enter bad tickets, we promise.

_images/ticket.png

Preferences

Change things like your name, email address, and password here.

_images/preferences.png