From owner-freebsd-doc  Fri Jul  6  5:50:18 2001
Delivered-To: freebsd-doc@freebsd.org
Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21])
	by hub.freebsd.org (Postfix) with ESMTP id 0416C37B40A
	for <freebsd-doc@freebsd.org>; Fri,  6 Jul 2001 05:50:05 -0700 (PDT)
	(envelope-from gnats@FreeBSD.org)
Received: (from gnats@localhost)
	by freefall.freebsd.org (8.11.3/8.11.3) id f66Co4S12376;
	Fri, 6 Jul 2001 05:50:04 -0700 (PDT)
	(envelope-from gnats)
Date: Fri, 6 Jul 2001 05:50:04 -0700 (PDT)
Message-Id: <200107061250.f66Co4S12376@freefall.freebsd.org>
To: freebsd-doc@freebsd.org
Cc: 
From: Dima Dorfman <dima@unixfreak.org>
Subject: Re: docs/28730: request for addition of a few more details on 'cvs log' usage to the text of articles/committers-guide 
Reply-To: Dima Dorfman <dima@unixfreak.org>
Sender: owner-freebsd-doc@FreeBSD.ORG
Precedence: bulk
List-ID: <freebsd-doc.FreeBSD.ORG>
List-Archive: <http://docs.freebsd.org/mail/> (Web Archive)
List-Help: <mailto:majordomo?subject=help> (List Instructions)
List-Subscribe: <mailto:majordomo?subject=subscribe%20freebsd-doc>
List-Unsubscribe: <mailto:majordomo?subject=unsubscribe%20freebsd-doc>
X-Loop: FreeBSD.org

The following reply was made to PR docs/28730; it has been noted by GNATS.

From: Dima Dorfman <dima@unixfreak.org>
To: Giorgos Keramidas <keramida@ceid.upatras.gr>
Cc: FreeBSD-gnats-submit@freebsd.org
Subject: Re: docs/28730: request for addition of a few more details on 'cvs log' usage to the text of articles/committers-guide 
Date: Fri, 06 Jul 2001 05:47:54 -0700

 Giorgos Keramidas <keramida@ceid.upatras.gr> writes:
 > @@ -582,6 +582,37 @@
 >  
 >          <!-- XXX needs more details -->
 
 This can probably go now :-).
 
 >          <screen>&prompt.user; <userinput>cvs log shazam</userinput></screen>
 > +
 > +        <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
 
 <command>, please.
 
 > +          <filename>shazam</filename> is printed too, in a recursive
 > +          manner.</para>
 > +
 > +        <para>Use the <literal>log</literal> command to view the history of
 
 Ditto.
 
 > +          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>
 
 Ditto.
 
 > +
 > +        <screen>&prompt.user; <userinput>cvs log -r1.2 shazam</userinput></screen>
 
 I would write this like so:
 
 <screen>&prompt.user; <userinput><command>cvs</command> log <option>-r1.2</option> <filename>shazam</filename></userinput></screen>
 
 Other than that, looks great.  Thanks!
 
 					Dima Dorfman
 					dima@unixfreak.org

To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-doc" in the body of the message