<para>If <filename>shazam</filename> is a file, this will print a

          <emphasis>header</emphasis> with information about this file, such

          as where in the repository this file is stored, which revision is

          the <literal>HEAD</literal> for this file, what branches this file

          is in, and any tags that are valid for this file.  Then, for each

          revision of this file, a log message is printed.  This includes

          the date and time of the commit, who did the commit, how many lines

          were added and/or deleted, and finally the log message that the

          committer who did the change wrote.</para>

        <para>If <filename>shazam</filename> is a directory, then the log

          information described above is printed for each file in the

          directory in turn.  Unless you give the <option>-l</option> to

          <literal>log</literal>, the log for all subdirectories of

          <filename>shazam</filename> is printed too, in a recursive

          manner.</para>

        <para>Use the <literal>log</literal> command to view the history of

          one or more files, as it's stored in the CVS repository.  You can

          even use it to view the log message of a specific revision, if you

          add the <option>-r<replaceable>rev</replaceable></option> to the

          <literal>log</literal> command:</para>

        <screen>&prompt.user; <userinput>cvs log -r1.2 shazam</userinput></screen>

        <para>This will print only the log message for revision

          <literal>1.2</literal> of file <filename>shazam</filename> if it is

          a file, or the log message for revision <literal>1.2</literal> of

          each file under <filename>shazam</filename> if it is a

          directory.</para>