<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML
><HEAD
><TITLE
>Browsing the history</TITLE
><META
NAME="GENERATOR"
CONTENT="Modular DocBook HTML Stylesheet Version 1.59"><LINK
REL="HOME"
TITLE="Cervisia Manual"
HREF="index.html"><LINK
REL="UP"
TITLE="Obtaining information about files"
HREF="obtaininginformation.html"><LINK
REL="PREVIOUS"
TITLE="Obtaining information about files"
HREF="obtaininginformation.html"><LINK
REL="NEXT"
TITLE="Watching differences between revisions"
HREF="diff.html"><META
HTTP-EQUIV="Content-Style-Type"
CONTENT="text/css"><META
NAME="Generator"
CONTENT="KDE DBMSS Customisation $Revision: 1.65 $"><LINK
REL="stylesheet"
HREF="common/kde-common.css"
TYPE="text/css"><META
HTTP-EQUIV="Content-Type"
CONTENT="text/html; charset=iso-8859-1"><META
HTTP-EQUIV="Content-Language"
CONTENT="en"><LINK
REL="stylesheet"
HREF="common/kde-localised.css"
TYPE="text/css"
TITLE="KDE-English"><LINK
REL="stylesheet"
HREF="common/kde-default.css"
TYPE="text/css"
TITLE="KDE-Default"></HEAD
><BODY
CLASS="SECT1"
BGCOLOR="#FFFFFF"
TEXT="#000000"
LINK="#AA0000"
VLINK="#AA0055"
ALINK="#AA0000"
STYLE="font-family: sans-serif; position:absolute; left: 0px; top: 0px; right: 0px; bottom: 0px;"
><TABLE
CLASS="navheader"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
CLASS="bulb"
><IMG
SRC="common/doctop1.png"
ALT=""
WIDTH="150"
HEIGHT="85"></TD
><TD
COLSPAN="2"
HEIGHT="85"
CLASS="headline"
><H1
><SPAN
CLASS="APPLICATION"
>Cervisia</SPAN
> Manual</H1
></TD
></TR
><TR
STYLE="background-color: #515151;"
CLASS="navrow"
><TD
ALIGN="left"
CLASS="left"
HEIGHT="25"
><A
HREF="obtaininginformation.html"
>Prev</A
></TD
><TD
ALIGN="center"
CLASS="center"
HEIGHT="25"
>Chapter 3. Obtaining information about files </TD
><TD
ALIGN="right"
CLASS="right"
HEIGHT="25"
><A
HREF="diff.html"
>Next</A
></TD
></TR
><TR
><TD
COLSPAN="3"
CLASS="shadow"
><IMG
WIDTH="100%"
SRC="common/shadow.png"
ALT=""
HEIGHT="14"></TD
></TR
></TABLE
><DIV
CLASS="SECT1"
><H1
CLASS="SECT1"
><A
NAME="BROWSINGHISTORY"
>3.2. Browsing the history</A
></H1
><P
> If the used repository has logging enabled, <SPAN
CLASS="APPLICATION"
>Cervisia</SPAN
> can present you a history
of certain events like checkouts, commits, rtags, updates and releases.
Choose <SPAN
CLASS="GUIMENUITEM"
>History</SPAN
> from the <SPAN
CLASS="GUIMENU"
>View</SPAN
> menu,
and <SPAN
CLASS="APPLICATION"
>Cervisia</SPAN
> will issue the command
</P
><P
> <TABLE
BORDER="0"
BGCOLOR="#E0E0E0"
WIDTH="100%"
><TR
><TD
><PRE
CLASS="SCREEN"
> <B
CLASS="COMMAND"
>cvs history -e -a</B
></PRE
></TD
></TR
></TABLE
>
</P
><DIV
CLASS="NOTE"
><TABLE
CLASS="NOTE"
WIDTH="100%"
BORDER="0"
><TR
><TD
WIDTH="25"
ALIGN="CENTER"
VALIGN="TOP"
><IMG
SRC="common/note.png"
HSPACE="5"
ALT="Note"></TD
><TD
ALIGN="LEFT"
VALIGN="TOP"
><P
> This fetches the complete logging file from the server, i.e. a list of
the events for all users and all modules. This can be a huge amount of data!
</P
></TD
></TR
></TABLE
></DIV
><P
> Now you can see the list of events, sorted by date. In the second column, the
type of the event is shown:
</P
><P
> <UL
><LI
><P
> Checkout - The user who is displayed in the 'Author' column
has checked out a module
</P
></LI
><LI
><P
> Tag - A user has used the command <B
CLASS="COMMAND"
>cvs rtag</B
>. Note
that the usage of <B
CLASS="COMMAND"
>cvs tag</B
> (as done by <SPAN
CLASS="APPLICATION"
>Cervisia</SPAN
>'s
<SPAN
CLASS="GUIMENU"
>Advanced</SPAN
>-><SPAN
CLASS="GUIMENUITEM"
>Tag/Branch...</SPAN
>
command) is not recorded in the history database. This has historical
reasons (see the CVS FAQ).
</P
></LI
><LI
><P
> Release - A user has released a module. Actually, this command
is rarely used and not of much value.
</P
></LI
><LI
><P
> Update, Deleted - A user has made an update on a file which was
deleted in the repository. As a consequence, the file was
deleted in his working copy.
</P
></LI
><LI
><P
> Update, Copied - A user has made an update on a file. A new
version was copied into working directory.
</P
></LI
><LI
><P
> Update, Merged - A user has made an update on a file. The
modifications in the repository version on the file were
merged into his working copy.
</P
></LI
><LI
><P
> Update, Conflict - A user has made an update on a file,
and a conflict with his own modifications was detected.
</P
></LI
><LI
><P
> Commit, Modified - A user commited a modified file.
</P
></LI
><LI
><P
> Commit, Added - A user added a file and commited it.
</P
></LI
><LI
><P
> Commit, Removed - A user removed a file and commited it.
</P
></LI
></UL
>
</P
><DIV
CLASS="FIGURE"
><HR><A
NAME="SCREENSHOT-HISTORY"
></A
><P
><B
>Figure 3-2. A screenshot of <SPAN
CLASS="APPLICATION"
>Cervisia</SPAN
>'s history dialog</B
></P
><DIV
CLASS="MEDIAOBJECT"
><P
><IMG
SRC="history.png"
></IMG
></P
></DIV
><HR></DIV
><P
> You can sort the list by other criteria simply by clicking on the respective
column header. In order to sort out the history entries you are interested
in, there are various filter options activated by check boxes:
<UL
><LI
><P
>Show commit events - shows commits</P
></LI
><LI
><P
>Show checkout events - shows checkouts</P
></LI
><LI
><P
>Show tag events - shows taggings</P
></LI
><LI
><P
>Show other events - shows events not included in the above</P
></LI
><LI
><P
>Only user - shows only events caused by a certain usere</P
></LI
><LI
><P
>Only filenames matching - filters file names by a regular expression</P
></LI
><LI
><P
>Only dirnames matching - filters directory names by a regular expression</P
></LI
></UL
>
Special characters recognized by the regular expression matcher are:
<UL
><LI
><P
> <TT
CLASS="LITERAL"
>x*</TT
> matches any number of occurences of the character
<TT
CLASS="LITERAL"
>x</TT
>.
</P
></LI
><LI
><P
> <TT
CLASS="LITERAL"
>x+</TT
> matches one or more of occurences of the character
<TT
CLASS="LITERAL"
>x</TT
>.
</P
></LI
><LI
><P
> <TT
CLASS="LITERAL"
>x?</TT
> matches zero or one occurences of the character
<TT
CLASS="LITERAL"
>x</TT
>.
</P
></LI
><LI
><P
> <TT
CLASS="LITERAL"
>^</TT
> matches the start of the string.
</P
></LI
><LI
><P
> <TT
CLASS="LITERAL"
>$</TT
> matches the end of the string.
</P
></LI
><LI
><P
> <TT
CLASS="LITERAL"
>[a-cx-z]</TT
> matches a set of characters,
e.g. here the set consisting of a,b,c,x,y,z.
</P
></LI
></UL
>
</P
></DIV
><DIV
CLASS="NAVFOOTER"
><TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><COLGROUP
><COL
WIDTH="*"><COL
WIDTH="227"></COLGROUP
><TBODY
><TR
><TD
CLASS="end"
WIDTH="100%"
><IMG
SRC="common/bottom1.png"
ALT=""
HEIGHT="59"></TD
><TD
><A
HREF="http://www.kde.org/"
><IMG
SRC="common/bottom2.png"
ALT="KDE Logo"
WIDTH="227"
BORDER="0"
HEIGHT="59"></A
></TD
></TR
><TR
><TD
HEIGHT="50"
COLSPAN="2"
> </TD
></TR
></TBODY
></TABLE
><TABLE
WIDTH="100%"
BORDER="0"
CELLPADDING="0"
CELLSPACING="0"
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
><A
HREF="obtaininginformation.html"
>Prev</A
></TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="index.html"
>Home</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
><A
HREF="diff.html"
>Next</A
></TD
></TR
><TR
><TD
WIDTH="33%"
ALIGN="left"
VALIGN="top"
>Obtaining information about files</TD
><TD
WIDTH="34%"
ALIGN="center"
VALIGN="top"
><A
HREF="obtaininginformation.html"
>Up</A
></TD
><TD
WIDTH="33%"
ALIGN="right"
VALIGN="top"
>Watching differences between revisions</TD
></TR
></TABLE
></DIV
></BODY
></HTML
>
