Re: gnu/82484: [patch] for misleading man cvs

[Mark D. Baushke]

Hi Julian,

Julian Stacey <jhs@berklix.org> writes:

> Reference:
> > From:               "Garrett Cooper" <yanefbsd@gmail.com> 
> > Date:               Fri, 20 Jun 2008 19:51:54 -0700 
> > Message-id: <7d6fde3d0806201951j4f3a85e9r19d119433dff4867@mail.gmail.com> 
> 
> "Garrett Cooper" wrote:
> > This should be filed as a documentation bug upstream to the CVS folks...
> > -Garrett
> 
> OK Thanks, who should do that ?
> Does FreeBSD have cenral liason point to CVS project ?

Well, both deo@freebsd.org and I work for the same employer.
(This may or may not be considered a liason point. :-)

> Or should I make contact ? In case, I cc'd info-cvs@gnu.org

Email to bug-cvs@nongnu.org would be a place to ask about getting bug
fixes into CVS sources rather than info-cvs@gnu.org.
 
> I see /usr/src/contrib/cvs/BUGS -> cvs.texinfo
> /usr/src/contrib/cvs/doc/cvs.texinfo
> 
> Ref.
> http://www.freebsd.org/cgi/query-pr.cgi?pr=82484
> http://berklis.com/~jhs/src/bsd/fixes/FreeBSD/src/gen/contrib/gnu/usr.bin/cvs/cvs.1.REL=ALL.diff

Bug reports for CVS should be submitted via the web to:
https://savannah.nongnu.org/bugs/?func=additem&group=cvs

Note: I was unable to use the
http://berklis.com/~jhs/src/bsd/fixes/FreeBSD/src/gen/contrib/gnu/usr.bin/cvs/cvs.1.REL=ALL.diff
link.

I have updated the cvs 1.11.x documentation to try to clarify things.

Note: cvs 1.12.x is moving toward -r rev:date rather than -r rev -D date,
and CVS clients may use this notation if the servers are at 1.12.x.

        Enjoy!
        -- Mark

 ------- archive message -------
To: cvs-cvs@nongnu.org
From: "Mark D. Baushke" <mdb@gnu.org>
Date: Mon, 23 Jun 2008 20:35:22 +0000
Subject: [Cvs-cvs] ccvs/doc ChangeLog cvs.1 cvs.texinfo stamp-vti ...
        [cvs1-11-x-branch]

CVSROOT:        /cvsroot/cvs
Module name:    ccvs
Branch:         cvs1-11-x-branch
Changes by:     Mark D. Baushke <mdb>   08/06/23 20:35:22

Modified files:
        doc            : ChangeLog cvs.1 cvs.texinfo stamp-vti 
                         version.texi 

Log message:
        * cvs.texinfo (export): Clarify the use of both -r rev and -D date
        on the same command line.
        * cvs.1, stamp-vti, version.texi: Regenerated.

CVSWeb URLs:
http://cvs.savannah.gnu.org/viewcvs/ccvs/doc/ChangeLog?cvsroot=cvs&only_with_tag=cvs1-11-x-branch&r1=1.721.2.135&r2=1.721.2.136
http://cvs.savannah.gnu.org/viewcvs/ccvs/doc/cvs.1?cvsroot=cvs&only_with_tag=cvs1-11-x-branch&r1=1.1.2.28&r2=1.1.2.29
http://cvs.savannah.gnu.org/viewcvs/ccvs/doc/cvs.texinfo?cvsroot=cvs&only_with_tag=cvs1-11-x-branch&r1=1.545.2.76&r2=1.545.2.77
http://cvs.savannah.gnu.org/viewcvs/ccvs/doc/stamp-vti?cvsroot=cvs&only_with_tag=cvs1-11-x-branch&r1=1.19.2.105&r2=1.19.2.106
http://cvs.savannah.gnu.org/viewcvs/ccvs/doc/version.texi?cvsroot=cvs&only_with_tag=cvs1-11-x-branch&r1=1.20.2.105&r2=1.20.2.106

Patches:
Index: ChangeLog
===================================================================
RCS file: /cvsroot/cvs/ccvs/doc/ChangeLog,v
retrieving revision 1.721.2.135
retrieving revision 1.721.2.136
diff -u -b -r1.721.2.135 -r1.721.2.136
--- ChangeLog   29 Mar 2008 23:09:34 -0000      1.721.2.135
+++ ChangeLog   23 Jun 2008 20:35:20 -0000      1.721.2.136
@@ -1,3 +1,9 @@
+2008-06-23  Mark D. Baushke  <mdb@gnu.org>
+
+       * cvs.texinfo (export): Clarify the use of both -r rev and -D date
+       on the same command line.
+       * cvs.1: Regenerated.
+
 2008-03-29  Larry Jones  <lawrence.jones@siemens.com>
 
        * cvs.texinfo (import options): Add -d.

Index: cvs.1
===================================================================
RCS file: /cvsroot/cvs/ccvs/doc/cvs.1,v
retrieving revision 1.1.2.28
retrieving revision 1.1.2.29
diff -u -b -r1.1.2.28 -r1.1.2.29
--- cvs.1       29 Mar 2008 23:09:35 -0000      1.1.2.28
+++ cvs.1       23 Jun 2008 20:35:21 -0000      1.1.2.29
@@ -2566,7 +2566,7 @@
 .IX "export (subcommand)"
 .SP
 .IP "\(bu" 2
-Synopsis: export [-flNnR] [-r rev|-D date] [-k subst] [-d dir] module\&...
+Synopsis: export [-flNnR] (-r rev [-D date] | -D date) [-k subst] [-d dir] 
module\&...
 .IP "\(bu" 2
 Requires: repository.
 .IP "\(bu" 2
@@ -2628,7 +2628,10 @@
 .IP "" 0
 \fB-r \fItag\fB\fR
 .IP "" 2
-Use revision \fItag\fR.
+Export the revision specified by \fItag\fR or, when
+\fB-D\fR \fIdate\fR is specified and \fItag\fR is a
+branch tag, the version from the branch \fItag\fR as it
+existed on \fIdate\fR.
 .SP
 In addition, these options (that are common to
 \fBcheckout\fR and \fBexport\fR) are also supported:

Index: cvs.texinfo
===================================================================
RCS file: /cvsroot/cvs/ccvs/doc/cvs.texinfo,v
retrieving revision 1.545.2.76
retrieving revision 1.545.2.77
diff -u -b -r1.545.2.76 -r1.545.2.77
--- cvs.texinfo 29 Mar 2008 23:09:35 -0000      1.545.2.76
+++ cvs.texinfo 23 Jun 2008 20:35:21 -0000      1.545.2.77
@@ -9933,7 +9933,7 @@
 
 @itemize @bullet
 @item
-Synopsis: export [-flNnR] [-r rev|-D date] [-k subst] [-d dir] module@dots{}
+Synopsis: export [-flNnR] (-r rev [-D date] | -D date) [-k subst] [-d dir] 
module@dots{}
 @item
 Requires: repository.
 @item
@@ -9991,7 +9991,10 @@
 Export directories recursively.  This is on by default.
 
 @item -r @var{tag}
-Use revision @var{tag}.
+Export the revision specified by @var{tag} or, when
+@code{-D} @var{date} is specified and @var{tag} is a
+branch tag, the version from the branch @var{tag} as it
+existed on @var{date}.
 @end table
 
 In addition, these options (that are common to

Index: stamp-vti
===================================================================
RCS file: /cvsroot/cvs/ccvs/doc/stamp-vti,v
retrieving revision 1.19.2.105
retrieving revision 1.19.2.106
diff -u -b -r1.19.2.105 -r1.19.2.106
--- stamp-vti   8 May 2008 05:01:38 -0000       1.19.2.105
+++ stamp-vti   23 Jun 2008 20:35:22 -0000      1.19.2.106
@@ -1,4 +1,4 @@
-@set UPDATED 6 May 2008
-@set UPDATED-MONTH May 2008
+@set UPDATED 23 June 2008
+@set UPDATED-MONTH June 2008
 @set EDITION 1.11.23.1
 @set VERSION 1.11.23.1

Index: version.texi
===================================================================
RCS file: /cvsroot/cvs/ccvs/doc/version.texi,v
retrieving revision 1.20.2.105
retrieving revision 1.20.2.106
diff -u -b -r1.20.2.105 -r1.20.2.106
--- version.texi        8 May 2008 05:01:38 -0000       1.20.2.105
+++ version.texi        23 Jun 2008 20:35:22 -0000      1.20.2.106
@@ -1,4 +1,4 @@
-@set UPDATED 6 May 2008
-@set UPDATED-MONTH May 2008
+@set UPDATED 23 June 2008
+@set UPDATED-MONTH June 2008
 @set EDITION 1.11.23.1
 @set VERSION 1.11.23.1


_______________________________________________
Cvs-cvs mailing list
Cvs-cvs@nongnu.org
http://lists.nongnu.org/mailman/listinfo/cvs-cvs