| | 1 | == What is Trac and how do I use it? == |
| | 2 | |
| | 3 | '''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. |
| | 4 | |
| | 5 | At this point, we expect general usage questions to continue to be posted to the [http://www.myroms.org/forum ROMS/TOMS forum]. In time, the tickets may be used to generate a FAQ and augment the documentation. |
| | 6 | |
| | 7 | Here are two ways to initiate a '''New Ticket''': |
| | 8 | |
| | 9 | * Go to [https://www.myroms.org/projects/src https://www.myroms.org/project/src] and click '''New Ticket''' |
| | 10 | * or [https://www.myroms.org/projects/src/newticket click here to make a new ticket] |
| | 11 | |
| | 12 | Examining changes to the code is also possible with '''trac''': |
| | 13 | |
| | 14 | * Click the '''Browse Source''' tab on the top navigation bar |
| | 15 | * Click '''trunk''' |
| | 16 | * Click '''makefile''', and the contents of makefile are displayed |
| | 17 | * Click '''Last Change''' located in the top right corner, and a color coded version shows what was last modified |
| | 18 | * 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! |
| | 19 | |
| | 20 | [wiki:WikiStart Return] to the ROMS/TOMS trac start page |
