|
qlog (see also)You use qlog to show QVCS archive and revision information contained within a QVCS archive. qlog is the quick way to look inside QVCS archives. The Command Template
where:
|
| mm/dd/yyyy:mm/dd/yyyy | for a range between two fixed dates. The first date must precede the second date. This date range is fully inclusive; i.e., all revisions on the beginning and ending dates are displayed in addition to those on the dates in between. |
| *:mm/dd/yyyy | for all revisions preceding midnight of the specified date. |
| mm/dd/-yyyy:* | for all revisions created on or following the given date. |
| mm/dd/yyyy | for all revisions created on the given date. |
where dd is the day of the month, mm is the month, and yyyy is the year. You should use the date format defined for your locale.
-r REVISIONRANGE (optional, cannot be used with -d, -label, -afterlabel, or -betweenlabels)
Specifies the revision or range of revisions for which information is to be displayed. The format for the revision or revision range is:
| Major.Minor... | to display a single revision. This can be a wildcard revision, in which case, all revisions matching the wildcard will be displayed. For example 1.* would match all revisions with a major number of 1; 1.1.* would match all branch revisions that are attached to the trunk at revision 1.1. |
| LowMajor.LowMinor...:HiMajor.HiMinor... | to display information for all revisions between the low and hi revisions (inclusive). These also may contain wildcard characters. |
| *:HiMajor.HiMinor... | to display all revisions up to and including the hi revision. |
| LowMajor.LowMinor...:* | to display all revisions newer than and including the low revision. |
-label LABEL (optional, cannot be used with -d, -r, -afterlabel, or -betweenlabels)
Displays log header information and revision information for the revision associated with the given LABEL. If the label string is more than one word, it should be enclosed in single or double quotes.
-afterlabel LABEL (optional, cannot be used with -d, -r, -label, or -betweenlabels)
Displays information for those revisions made after the given LABEL. This makes it easy to see what changes have been made after a given LABEL. If the label string is more than one word, it should be enclosed in single or double quotes.
-betweenlabels LABEL1 LABEL2 (optional, cannot be used with -d, -r, -label, or -afterlabel)
Displays information for those revisions that were made after LABEL1 and before or up to LABEL2. This makes it easy to see what changes have been made between two labels. If either label string is more than one word, it should be enclosed in single or double quotes.
filename (required)
The work file associated with the QVCS archive whose information you wish to view.
The filename can make use of the wildcard character * in order to perform the operation on all applicable files in the current directory, all files of a certain extension (e.g. *.cpp), etc.
Examples
qlog -l *
shows the filenames and user ID's of all locked revisions in QVCS archives accessible from the current directory.
qlog -r 1.0:1.5 foobar.c
displays header and revision information for revisions 1.0 through 1.5 from foobar.c's QVCS archive, including any branch revisions that may occur within that range of trunk revisions.
qlog -label 'Version 1' foobar.c
displays header and revision information for the revision associated with the 'Version 1' label string in foobar.c's QVCS archive.
qlog -afterlabel 960330 *.cpp
displays revision information for all .cpp files that have a QVCS archive with revisions made after the 960330 label was applied.
qlog -betweenlabels 960102 960330 *.cpp
displays revision information for all .cpp files that have a QVCS archive with revisions made after the 960102 label, up to and including revisions made before the 960330 label was applied.
qlog -author JohnSmith -betweenlabels 960102 960330 *.cpp
displays revision information for all .cpp files that have a QVCS archive with revisions made after the 960102 label, up to and including revisions made before the 960330 label was applied; show only revisions in that range of revisions that were checked in by JohnSmith.
qlog -d 21-aug-2005:30-aug-2006 *.c
displays header and revision information for all revisions created between one second after midnight, August 21, 2005, and midnight August 30, 2006 (inclusive) for all QVCS archives accessible from the current directory that have a work file extension of .c.
qlog Output
When displaying information about a QVCS archive, qlog begins by showing the information that it finds in the QVCS archive header. Its output includes fields for each element contained in the QVCS archive header. These fields have the following meanings:
| QVCS Archive: | Shows the relative path name of the QVCS archive from which the information is being displayed. |
| Checked out to: | If anyone has a lock on the QVCS archive, this shows the full work file path for the person holding the most recent lock. If there are no locks, this line isn't displayed. |
| Owner ID: | Shows the owner of the QVCS archive. This is the QVCS_ID of the individual who first created the QVCS archive. |
| Revision Count: | Shows the total number of revisions contained in the QVCS archive. This includes all trunk revisions, as well as any branch revisions. |
| Default Branch: | Shows the QVCS archive's default branch. If the default branch is the trunk, this will be displayed as TRUNK. A branch is shown as the major.minor pairs up to the last major.minor pair, with the last minor revision number omitted. The branch containing revision 1.2.1.7, for example, would be displayed as 1.2.1. |
| Latest Trunk Rev: | Shows the revision number of the newest trunk revision. |
| Lock Count: | Shows the total number of locked revisions in the QVCS archive. |
| Comment Prefix: | Shows the comment prefix string surrounded by single quote characters. This is the string that's used in expanding the $Log$ and $LogX$ keywords. |
| Access List: | Shows the access list for the QVCS archive. |
| Modifier List: | Shows the modifier list for the QVCS archive. Note that the access list is a subset of the modifier list. |
| Attributes: | The seven QVCS archive attributes are shown beneath the Attributes label. If the attribute is disabled, it is prefixed by "NO". |
| Labels: | If there are any version labels in the QVCS archive, they are shown immediately following the QVCS archive attributes. The labels show the revision of the label and the version label that is associated with that particular revision. Labels are shown newest to oldest. |
| Description: | This is followed by the module description. |
After the header information, qlog displays information about individual revisions. Revisions are displayed in newest to oldest order, except for branches, which are displayed in oldest to newest order; in other words, qlog displays revision information in the same order that it appears within the QVCS archive.
| qdelrev | qdiff | qedit | qget | qident | qlock | qlog | qmerge | qmodhdr | qmodrev | qput | qstamp | qunlock | qunstamp | qrecurse |
See also: QWin displays file and revision information in the information pane on the lower right of the window.
| ||
| © Copyright 2004-2007 Quma Software, Inc. All Rights Reserved. | ||
