What is Trac and how do I use it?

Trac is a tool that allows developers to keep track of bugs, fixes, feature requests, etc for a software development project. A trac site is associated with a subversion repository to integrate the tasks of documentation and project management with the code development. One big part of trac is the Wiki, where you're reading this documentation. Feel free to add to it or modify the content as needed. Another key element is the ticket system. Users and developers can employ tickets to report errors or ask usage related questions by clicking on the tabs to view make new tickets. One can access the features of trac using the bar at the top of the page: each tab links to the named function. To look at the exisiting tickets, click the View Tickets tab.

At this point, we expect general usage questions to continue to be posted to the ROMS/TOMS forum. In time, the tickets may be used to generate a FAQ and augment the documentation.

Here are two ways to initiate a New Ticket:

• Go to ​https://www.myroms.org/project/Models and click New Ticket
• or ​click here to make a new ticket

Examining changes to the code is also possible with trac:

• Click the Browse Source tab on the top navigation bar
• Click trunk
• Click makefile, and the contents of makefile are displayed
• Click Last Change located in the top right corner, and a color coded version shows what was last modified
• If you go back to trunk/ROMS and click Last Change, ALL the programs that were modified prior to the last commit are displayed with the modified code highlighted. The last previous version of each file is also listed. Powerful stuff!

Return to the ROMS/TOMS trac start page