|
Journal Changes (JOURNALFILE)The JOURNALFILE attribute tells QVCS whether modifications to a QVCS archive should be "journaled." If JOURNALFILE is enabled for an archive file, then any change to that file will add a line to the active journal file indicating the name of the QVCS archive, the name of the person making the change, the date, the time, and the command line used to make the change. If the change is made with the QWin application, then the name of the command has an "_w" appended to it. If the change is made through an IDE and the SCC interface, then the name of the command is appended with an "_scc". Some actions include additional information as well. For example, storing a new revision includes the revision comment. If JOURNALFILE is off, the journal file is not used at all. Journaling helps you keep track of the changes you make to all the files associated with your project. It can serve as a project log. Instead of having to check through a lot of different directories and different QVCS archives, the journal file gives you a single place to look to track down any changes. Since it's chronological, it automatically keeps track of what changes occurred when. QVCS never purges the journal file. As a consequence, it can grow to be quite large. It's just a regular text file, and you can edit it at your discretion to delete older entries. QVCS only ever writes to the journal file; it never reads from it. The purpose of the journal file is to provide a humanly readable record of all the activities that have caused QVCS archives to change. QVCS also supports a "global" journal file. If the Global Journal File Name project setting is defined, any change to a QVCS archive will be logged in both the standard QVCS journal file and to the global journal file. This allows you to have a single journal file that tracks all changes to all files in a project, and separate journal files that track just those changes in a single directory. The format of the global journal file is different from the format of the local journal file. The local journal file is formatted to make it easy to read using a text editor (like Notepad). The global journal file puts the entire journal entry onto a single line, with key elements of the entry separated by commas. It's designed to be imported into a database tool, with which you can produce reports on those changes captured for the entire project. The default name of the local journal file is qvcs.jou. The defaults for both journal files can be changed on the Settings tab of the Project→Edit Settings... dialog.
|
| ||
| © Copyright 2004-2007 Quma Software, Inc. All Rights Reserved. | ||
