gnu/82484: patch for misleading man cvs

[jhs at berklix.org]

>Number:         82484
>Category:       gnu
>Synopsis:       patch for misleading man cvs
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-bugs
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Tue Jun 21 13:30:02 GMT 2005
>Closed-Date:
>Last-Modified:
>Originator:     jhs at berklix.com
>Release:        FreeBSD 5.3-RELEASE i386
>Organization:
http://berklix.com
>Environment:
System: FreeBSD fire.jhs.private 5.3-RELEASE FreeBSD 5.3-RELEASE #0: Tue Jun 7 10:40:30 CEST 2005 jhs at fire.jhs.private:/usr1/5.3-RELEASE/src/sys/i386/compile/FIRE32.small i386


	
>Description:
	
Quoting man cvs` line
        export [-flNnQq] -r rev|-D date [-d dir] [-k kflag] module...
The pipe symbol implied to me that -r & -D were mutually exclusive
on export, but they're Not.  Neither are -r & -D mutually exclusive
on co = checkout = get, so I checked export function too & thankfully
they're not mutually exclusive on export either.

man cvs line should omit the | symbol & add [] twice, thus:
        export [-flNnQq] [-r rev] [-D date] [-d dir] [-k kflag] module...

>How-To-Repeat:
	
                cd a
                cvs -R export  -D "1-Aug-2004" sys
                du -s
                86114
        ------
                cd b
                cvs -R export -r RELENG_5 -D "1-Aug-2004" sys
                du -s
                65964
>Fix:

	

man cvs > ~/tmp/cvs.man1
cd /usr/src ; patch -p 1 << EOF
*** 5.3-RELEASE/contrib/cvs/man/cvs.1.orig	Tue Jun 21 12:59:11 2005
--- new/contrib/cvs/man/cvs.1	Tue Jun 21 14:33:18 2005
***************
*** 1129,1135 ****
  .I you
  have changed), or that differ from the revision specified.
  .TP
! \fBexport\fP [\-\fBf\|lNnQq\fP] \fB\-r\fP \fIrev\fP\||\|\fB\-D\fP \fIdate\fP [\fB\-d\fP \fIdir\fP] [\fB\-k\fP \fIkflag\fP] \fImodule\fP.\|.\|.
  .I Requires:
  repository.
  .br
--- 1129,1136 ----
  .I you
  have changed), or that differ from the revision specified.
  .TP
! .\" \fBexport\fP [\-\fBf\|lNnQq\fP] \fB\-r\fP \fIrev\fP\||\|\fB\-D\fP \fIdate\fP [\fB\-d\fP \fIdir\fP] [\fB\-k\fP \fIkflag\fP] \fImodule\fP.\|.\|.
! \fBexport\fP [\-\fBf\|lNnQq\fP] [\fB\-r\fP \fIrev\fP\|] [\|\fB\-D\fP \fIdate\fP] [\fB\-d\fP \fIdir\fP] [\fB\-k\fP \fIkflag\fP] \fImodule\fP.\|.\|.
  .I Requires:
  repository.
  .br
EOF
cd /usr/src/gnu/usr.bin/cvs; make install; man cvs > ~/tmp/cvs.man2
diff -c ~/tmp/cvs.man[12]; rm ~/tmp/cvs.man[12]

!        export [-flNnQq] -r rev|-D date [-d dir] [-k kflag] module...
!        export [-flNnQq] [-r rev] [-D date] [-d dir] [-k kflag] module...



>Release-Note:
>Audit-Trail:
>Unformatted: