Re: cvs.1: document annotate command
On Thu, Nov 05, 2015 at 11:26:19AM -0700, Todd C. Miller wrote: > On Thu, 05 Nov 2015 17:12:28 +, Jason McIntyre wrote: > > > however it's generated, we don;t have local changes in this file (as far > > as i'm aware). if gnu cvs have some doc bugs, you can ping them. if not, > > then our doc is out of date. but i doubt anyone will work on updating > > this page independently. > > We are never going to update GNU cvs from upstream and we do actually > have quite a few local changes to cvs.1 in the tree. > > - todd i had guessed the former, but am shocked by the latter. with the exception of a couple tweaks to make the man macros play nicely, no one has updated this file for 7 years. anyway, i stand corrected. apologies to the original poster. but for the record, i won;t be touching this page. so the diff is up for any other developer to take/comment on. jmc
Re: cvs.1: document annotate command
On Thu, 05 Nov 2015 17:12:28 +, Jason McIntyre wrote: > however it's generated, we don;t have local changes in this file (as far > as i'm aware). if gnu cvs have some doc bugs, you can ping them. if not, > then our doc is out of date. but i doubt anyone will work on updating > this page independently. We are never going to update GNU cvs from upstream and we do actually have quite a few local changes to cvs.1 in the tree. - todd
Re: cvs.1: document annotate command
On Thu, Nov 05, 2015 at 04:59:21PM +0100, Frederic Nowak wrote: > > On 05 November 2015 at 16:08 Jason McIntyre wrote: > > > > > > On Thu, Nov 05, 2015 at 03:11:38PM +0100, Frederic Nowak wrote: > > > Hi there, > > > > > > it seems the documentation for cvs(1) is missing a few commands: > > > annotate, edit, editors, login, logout, pserver, rannotate, rlog, > > > server, version, watch, watchers, unedit > > > The patch below adds a description for annotate. > > > > > > Cheers, > > > Frederic > > > > > > Index: gnu/usr.bin/cvs/man/cvs.1 > > > === > > > > please mail doc fixes for gnu cvs to that project. you probably want > > to > > check any issues are not present in the latest version before you do > > so. > > > > jmc > > > > But it seems that cvs.1 is maintained independently of the gnu > version. gnu autogenerates cvs.1 from cvs.texinfo, which contains the > missing commands, but is in a completely different style. > > Frederic > however it's generated, we don;t have local changes in this file (as far as i'm aware). if gnu cvs have some doc bugs, you can ping them. if not, then our doc is out of date. but i doubt anyone will work on updating this page independently. jmc
Re: cvs.1: document annotate command
> On 05 November 2015 at 16:08 Jason McIntyre wrote: > > > On Thu, Nov 05, 2015 at 03:11:38PM +0100, Frederic Nowak wrote: > > Hi there, > > > > it seems the documentation for cvs(1) is missing a few commands: > > annotate, edit, editors, login, logout, pserver, rannotate, rlog, > > server, version, watch, watchers, unedit > > The patch below adds a description for annotate. > > > > Cheers, > > Frederic > > > > Index: gnu/usr.bin/cvs/man/cvs.1 > > === > > please mail doc fixes for gnu cvs to that project. you probably want > to > check any issues are not present in the latest version before you do > so. > > jmc > But it seems that cvs.1 is maintained independently of the gnu version. gnu autogenerates cvs.1 from cvs.texinfo, which contains the missing commands, but is in a completely different style. Frederic > > RCS file: /cvs/src/gnu/usr.bin/cvs/man/cvs.1,v > > retrieving revision 1.12 > > diff -u -p -r1.12 cvs.1 > > --- gnu/usr.bin/cvs/man/cvs.1 3 Jun 2013 17:02:36 - 1.12 > > +++ gnu/usr.bin/cvs/man/cvs.1 5 Nov 2015 14:07:04 - > > @@ -308,6 +333,10 @@ Execute > > control functions on the source repository. (Changes > > repository directly; uses working directory without changing it.) > > .TP > > +.B annotate > > +For each line of a file, show its last revision, the author's name, > > +and the date of the change. > > +.TP > > .B checkout > > Make a working directory of source files for editing. (Creates or > > changes > > working directory.) > > @@ -437,7 +466,7 @@ same date (unless you explicitly overrid > > the \fBupdate\fP command). > > .B \-D > > is available with the > > -.BR checkout ", " diff ", " history ", " export ", " > > +.BR annotate ", " checkout ", " diff ", " history ", " export ", " > > .BR rdiff ", " rtag ", and " > > .B update > > commands. > > @@ -467,7 +496,7 @@ files retrieved even when there is no ma > > most recent version is used in this situation.) > > .B \-f > > is available with these commands: > > -.BR checkout ", " export ", " > > +.BR annotate ", " checkout ", " export ", " > > .BR rdiff ", " rtag ", and " update . > > .TP > > \fB\-k\fP \fIkflag\fP > > @@ -493,7 +522,7 @@ at some other site. > > .B \-l > > Local; run only in current working directory, rather than recurring > > through > > subdirectories. Available with the following commands: > > -.BR checkout ", " commit ", " diff ", " > > +.BR annotate ", " checkout ", " commit ", " diff ", " > > .BR export ", " remove ", " rdiff ", " rtag ", " > > .BR status ", " tag ", and " update . > > .I Warning: > > @@ -584,7 +613,7 @@ command option is often useful, to suppr > > file does not contain the specified tag. > > .B \-r > > is available with the > > -.BR checkout ", " commit ", " diff ", " > > +.BR annotate ", " checkout ", " commit ", " diff ", " > > .BR history ", " export ", " > > .BR rdiff ", " rtag ", and " update > > commands. > > @@ -756,6 +785,27 @@ facilities, similar to > > .BR rcs ( 1 ). > > This command works recursively, so extreme care should be > > used. > > +.TP > > +\fBannotate\fP [\fB-flR\fP] [\fB-r\fP \fItag\fP | \fB-D\fP > > \fIdate\fP] > > [\fIfiles...\fP] > > +.I Requires: > > +repository. > > +.br > > +.I Changes: > > +nothing. > > +.br > > +.I Synonyms: > > +.BR ann ", " blame > > +.br > > +Print information about the last modification of each line in > > +.IR files . > > +The information includes the revision number, the author's name, > > and > > +the date of the revision. > > +By default (or if the \fB-R\fP option is used), > > +.B annotate > > +will print information about files in sub-directories; the \fB-l\fP > > +option can be used to disable this recursion. > > +The standard options \fB-f\fP, \fB-r\fP and \fB-D\fP can be used to > > +annotate specific revisions. > > .TP > > \fBcheckout\fP [\fBoptions\fP] \fImodules\fP.\|.\|. > > .I Requires: > > >
Re: cvs.1: document annotate command
On Thu, Nov 05, 2015 at 03:11:38PM +0100, Frederic Nowak wrote: > Hi there, > > it seems the documentation for cvs(1) is missing a few commands: > annotate, edit, editors, login, logout, pserver, rannotate, rlog, > server, version, watch, watchers, unedit > The patch below adds a description for annotate. > > Cheers, > Frederic > > Index: gnu/usr.bin/cvs/man/cvs.1 > === please mail doc fixes for gnu cvs to that project. you probably want to check any issues are not present in the latest version before you do so. jmc > RCS file: /cvs/src/gnu/usr.bin/cvs/man/cvs.1,v > retrieving revision 1.12 > diff -u -p -r1.12 cvs.1 > --- gnu/usr.bin/cvs/man/cvs.1 3 Jun 2013 17:02:36 - 1.12 > +++ gnu/usr.bin/cvs/man/cvs.1 5 Nov 2015 14:07:04 - > @@ -308,6 +333,10 @@ Execute > control functions on the source repository. (Changes > repository directly; uses working directory without changing it.) > .TP > +.B annotate > +For each line of a file, show its last revision, the author's name, > +and the date of the change. > +.TP > .B checkout > Make a working directory of source files for editing. (Creates or > changes > working directory.) > @@ -437,7 +466,7 @@ same date (unless you explicitly overrid > the \fBupdate\fP command). > .B \-D > is available with the > -.BR checkout ", " diff ", " history ", " export ", " > +.BR annotate ", " checkout ", " diff ", " history ", " export ", " > .BR rdiff ", " rtag ", and " > .B update > commands. > @@ -467,7 +496,7 @@ files retrieved even when there is no ma > most recent version is used in this situation.) > .B \-f > is available with these commands: > -.BR checkout ", " export ", " > +.BR annotate ", " checkout ", " export ", " > .BR rdiff ", " rtag ", and " update . > .TP > \fB\-k\fP \fIkflag\fP > @@ -493,7 +522,7 @@ at some other site. > .B \-l > Local; run only in current working directory, rather than recurring > through > subdirectories. Available with the following commands: > -.BR checkout ", " commit ", " diff ", " > +.BR annotate ", " checkout ", " commit ", " diff ", " > .BR export ", " remove ", " rdiff ", " rtag ", " > .BR status ", " tag ", and " update . > .I Warning: > @@ -584,7 +613,7 @@ command option is often useful, to suppr > file does not contain the specified tag. > .B \-r > is available with the > -.BR checkout ", " commit ", " diff ", " > +.BR annotate ", " checkout ", " commit ", " diff ", " > .BR history ", " export ", " > .BR rdiff ", " rtag ", and " update > commands. > @@ -756,6 +785,27 @@ facilities, similar to > .BR rcs ( 1 ). > This command works recursively, so extreme care should be > used. > +.TP > +\fBannotate\fP [\fB-flR\fP] [\fB-r\fP \fItag\fP | \fB-D\fP \fIdate\fP] > [\fIfiles...\fP] > +.I Requires: > +repository. > +.br > +.I Changes: > +nothing. > +.br > +.I Synonyms: > +.BR ann ", " blame > +.br > +Print information about the last modification of each line in > +.IR files . > +The information includes the revision number, the author's name, and > +the date of the revision. > +By default (or if the \fB-R\fP option is used), > +.B annotate > +will print information about files in sub-directories; the \fB-l\fP > +option can be used to disable this recursion. > +The standard options \fB-f\fP, \fB-r\fP and \fB-D\fP can be used to > +annotate specific revisions. > .TP > \fBcheckout\fP [\fBoptions\fP] \fImodules\fP.\|.\|. > .I Requires: >
cvs.1: document annotate command
Hi there, it seems the documentation for cvs(1) is missing a few commands: annotate, edit, editors, login, logout, pserver, rannotate, rlog, server, version, watch, watchers, unedit The patch below adds a description for annotate. Cheers, Frederic Index: gnu/usr.bin/cvs/man/cvs.1 === RCS file: /cvs/src/gnu/usr.bin/cvs/man/cvs.1,v retrieving revision 1.12 diff -u -p -r1.12 cvs.1 --- gnu/usr.bin/cvs/man/cvs.1 3 Jun 2013 17:02:36 - 1.12 +++ gnu/usr.bin/cvs/man/cvs.1 5 Nov 2015 14:07:04 - @@ -308,6 +333,10 @@ Execute control functions on the source repository. (Changes repository directly; uses working directory without changing it.) .TP +.B annotate +For each line of a file, show its last revision, the author's name, +and the date of the change. +.TP .B checkout Make a working directory of source files for editing. (Creates or changes working directory.) @@ -437,7 +466,7 @@ same date (unless you explicitly overrid the \fBupdate\fP command). .B \-D is available with the -.BR checkout ", " diff ", " history ", " export ", " +.BR annotate ", " checkout ", " diff ", " history ", " export ", " .BR rdiff ", " rtag ", and " .B update commands. @@ -467,7 +496,7 @@ files retrieved even when there is no ma most recent version is used in this situation.) .B \-f is available with these commands: -.BR checkout ", " export ", " +.BR annotate ", " checkout ", " export ", " .BR rdiff ", " rtag ", and " update . .TP \fB\-k\fP \fIkflag\fP @@ -493,7 +522,7 @@ at some other site. .B \-l Local; run only in current working directory, rather than recurring through subdirectories. Available with the following commands: -.BR checkout ", " commit ", " diff ", " +.BR annotate ", " checkout ", " commit ", " diff ", " .BR export ", " remove ", " rdiff ", " rtag ", " .BR status ", " tag ", and " update . .I Warning: @@ -584,7 +613,7 @@ command option is often useful, to suppr file does not contain the specified tag. .B \-r is available with the -.BR checkout ", " commit ", " diff ", " +.BR annotate ", " checkout ", " commit ", " diff ", " .BR history ", " export ", " .BR rdiff ", " rtag ", and " update commands. @@ -756,6 +785,27 @@ facilities, similar to .BR rcs ( 1 ). This command works recursively, so extreme care should be used. +.TP +\fBannotate\fP [\fB-flR\fP] [\fB-r\fP \fItag\fP | \fB-D\fP \fIdate\fP] [\fIfiles...\fP] +.I Requires: +repository. +.br +.I Changes: +nothing. +.br +.I Synonyms: +.BR ann ", " blame +.br +Print information about the last modification of each line in +.IR files . +The information includes the revision number, the author's name, and +the date of the revision. +By default (or if the \fB-R\fP option is used), +.B annotate +will print information about files in sub-directories; the \fB-l\fP +option can be used to disable this recursion. +The standard options \fB-f\fP, \fB-r\fP and \fB-D\fP can be used to +annotate specific revisions. .TP \fBcheckout\fP [\fBoptions\fP] \fImodules\fP.\|.\|. .I Requires:
