* Re: *** empty log message *** is a no-no
1999-11-12 20:04 ` Per Abrahamsen
@ 1999-11-15 7:39 ` Steinar Bang
1999-11-15 8:39 ` Per Abrahamsen
1999-11-17 13:35 ` Jan Vroonhof
` (6 subsequent siblings)
7 siblings, 1 reply; 33+ messages in thread
From: Steinar Bang @ 1999-11-15 7:39 UTC (permalink / raw)
>>>>> Per Abrahamsen <abraham@dina.kvl.dk>:
> Lars Magne Ingebrigtsen <larsi@gnus.org> writes:
>> Shirley this can't be an unusual way of working?
> Nope. I also dislike commiting before testing the whole system, and
> uses ChangeLogs rather than commit logs for the projects I'm involved
> in. So the current Gnus setup fits me perfectly ;-)
With "the current Gnus setup" you mean "empty log messages"...?
^ permalink raw reply [flat|nested] 33+ messages in thread
* Re: *** empty log message *** is a no-no
1999-11-15 7:39 ` Steinar Bang
@ 1999-11-15 8:39 ` Per Abrahamsen
1999-11-15 10:02 ` Steinar Bang
0 siblings, 1 reply; 33+ messages in thread
From: Per Abrahamsen @ 1999-11-15 8:39 UTC (permalink / raw)
Steinar Bang <sb@metis.no> writes:
> >>>>> Per Abrahamsen <abraham@dina.kvl.dk>:
>
> > Lars Magne Ingebrigtsen <larsi@gnus.org> writes:
> >> Shirley this can't be an unusual way of working?
>
> > Nope. I also dislike commiting before testing the whole system, and
> > uses ChangeLogs rather than commit logs for the projects I'm involved
> > in. So the current Gnus setup fits me perfectly ;-)
>
> With "the current Gnus setup" you mean "empty log messages"...?
I mean where the content of log messages aren't important, the
significant place where everything should be stated is the ChangeLog.
^ permalink raw reply [flat|nested] 33+ messages in thread
* Re: *** empty log message *** is a no-no
1999-11-15 8:39 ` Per Abrahamsen
@ 1999-11-15 10:02 ` Steinar Bang
1999-11-15 16:32 ` Per Abrahamsen
0 siblings, 1 reply; 33+ messages in thread
From: Steinar Bang @ 1999-11-15 10:02 UTC (permalink / raw)
>>>>> Per Abrahamsen <abraham@dina.kvl.dk>:
> I mean where the content of log messages aren't important,
For the record: I disagree deeply.
> the significant place where everything should be stated is the
> ChangeLog.
^ permalink raw reply [flat|nested] 33+ messages in thread
* Re: *** empty log message *** is a no-no
1999-11-15 10:02 ` Steinar Bang
@ 1999-11-15 16:32 ` Per Abrahamsen
1999-11-16 8:51 ` Steinar Bang
0 siblings, 1 reply; 33+ messages in thread
From: Per Abrahamsen @ 1999-11-15 16:32 UTC (permalink / raw)
Steinar Bang <sb@metis.no> writes:
> >>>>> Per Abrahamsen <abraham@dina.kvl.dk>:
>
> > I mean where the content of log messages aren't important,
> > the significant place where everything should be stated is the
> > ChangeLog.
[ I don't want the above sentense being split. Log messages are
important, but I find them most useful in the ChangeLog. ]
> For the record: I disagree deeply.
What is your Gnus work pattern that makes finding the relevant
information in the ChangeLog deeply disagreeable?
^ permalink raw reply [flat|nested] 33+ messages in thread
* Re: *** empty log message *** is a no-no
1999-11-15 16:32 ` Per Abrahamsen
@ 1999-11-16 8:51 ` Steinar Bang
1999-11-16 16:05 ` Per Abrahamsen
0 siblings, 1 reply; 33+ messages in thread
From: Steinar Bang @ 1999-11-16 8:51 UTC (permalink / raw)
>>>>> Per Abrahamsen <abraham@dina.kvl.dk>:
> What is your Gnus work pattern that makes finding the relevant
> information in the ChangeLog deeply disagreeable?
C-x v l
in a CVS versioned file, to quickly find out what the last changes
were about.
^ permalink raw reply [flat|nested] 33+ messages in thread
* Re: *** empty log message *** is a no-no
1999-11-16 8:51 ` Steinar Bang
@ 1999-11-16 16:05 ` Per Abrahamsen
1999-11-17 8:02 ` Steinar Bang
0 siblings, 1 reply; 33+ messages in thread
From: Per Abrahamsen @ 1999-11-16 16:05 UTC (permalink / raw)
Steinar Bang <sb@metis.no> writes:
> >>>>> Per Abrahamsen <abraham@dina.kvl.dk>:
>
> > What is your Gnus work pattern that makes finding the relevant
> > information in the ChangeLog deeply disagreeable?
>
> C-x v l
> in a CVS versioned file, to quickly find out what the last changes
> were about.
Well, it ought to be possible to write a command that shows the last
ChangeLog entries for the current file...
^ permalink raw reply [flat|nested] 33+ messages in thread
* Re: *** empty log message *** is a no-no
1999-11-16 16:05 ` Per Abrahamsen
@ 1999-11-17 8:02 ` Steinar Bang
1999-11-17 12:42 ` Denys Duchier
0 siblings, 1 reply; 33+ messages in thread
From: Steinar Bang @ 1999-11-17 8:02 UTC (permalink / raw)
>>>>> Per Abrahamsen <abraham@dina.kvl.dk>:
> Steinar Bang <sb@metis.no> writes:
>> >>>>> Per Abrahamsen <abraham@dina.kvl.dk>:
>>
>> > What is your Gnus work pattern that makes finding the relevant
>> > information in the ChangeLog deeply disagreeable?
>>
>> C-x v l
>> in a CVS versioned file, to quickly find out what the last changes
>> were about.
> Well, it ought to be possible to write a command that shows the last
> ChangeLog entries for the current file...
Yes. But I use CVS for completely different source code where I don't
wish to have it look for a ChangeLog, because there isn't one.
^ permalink raw reply [flat|nested] 33+ messages in thread
* Re: *** empty log message *** is a no-no
1999-11-17 8:02 ` Steinar Bang
@ 1999-11-17 12:42 ` Denys Duchier
1999-11-17 14:38 ` Kai Großjohann
0 siblings, 1 reply; 33+ messages in thread
From: Denys Duchier @ 1999-11-17 12:42 UTC (permalink / raw)
Steinar Bang <sb@metis.no> writes:
> > Well, it ought to be possible to write a command that shows the last
> > ChangeLog entries for the current file...
>
> Yes. But I use CVS for completely different source code where I don't
> wish to have it look for a ChangeLog, because there isn't one.
`C-x v a' will create a ChangeLog file for you from the cvs log
entries. There is no reason to _maintain_ a ChangeLog file,
especially since it contains less precise information than the cvs log
(e.g. time stamps).
Cheers,
--
Dr. Denys Duchier Denys.Duchier@ps.uni-sb.de
Forschungsbereich Programmiersysteme (Programming Systems Lab)
Universitaet des Saarlandes, Geb. 45 http://www.ps.uni-sb.de/~duchier
Postfach 15 11 50 Phone: +49 681 302 5618
66041 Saarbruecken, Germany Fax: +49 681 302 5615
^ permalink raw reply [flat|nested] 33+ messages in thread
* Re: *** empty log message *** is a no-no
1999-11-17 12:42 ` Denys Duchier
@ 1999-11-17 14:38 ` Kai Großjohann
0 siblings, 0 replies; 33+ messages in thread
From: Kai Großjohann @ 1999-11-17 14:38 UTC (permalink / raw)
Denys Duchier <Denys.Duchier@ps.uni-sb.de> writes:
> `C-x v a' will create a ChangeLog file for you from the cvs log
> entries. There is no reason to _maintain_ a ChangeLog file,
> especially since it contains less precise information than the cvs log
> (e.g. time stamps).
Jan is right, I think. Having the function name in there is a good
thing. WIBNI there was a way to have that information in the CVS log,
too?
Jan, you're free to type C-x v v, then do some editing, then add stuff
to the *vc-log* buffer, then do some more editing, then finish the log
entry, then C-c C-c. Though I've never tried...
kai
--
This gubblick contains many nonsklarkish English flutzpahs,
but the overall pluggandisp can be glorked from context. -- David Moser
^ permalink raw reply [flat|nested] 33+ messages in thread
* Re: *** empty log message *** is a no-no
1999-11-12 20:04 ` Per Abrahamsen
1999-11-15 7:39 ` Steinar Bang
@ 1999-11-17 13:35 ` Jan Vroonhof
[not found] ` <whg0y8430s.fsf@viffe <byogctgs0h.fsf@urysohn.math.ethz.ch>
` (5 subsequent siblings)
7 siblings, 0 replies; 33+ messages in thread
From: Jan Vroonhof @ 1999-11-17 13:35 UTC (permalink / raw)
Denys Duchier <Denys.Duchier@ps.uni-sb.de> writes:
> `C-x v a' will create a ChangeLog file for you from the cvs log
> entries. There is no reason to _maintain_ a ChangeLog file,
> especially since it contains less precise information than the cvs log
> (e.g. time stamps).
The advantage of Changelogs is that you can write them at the time the
change is made, not at the time of commit. In addition Changelogs
contain the function/variable affected by the change and there is
support from Emacs to add them automatically.
Is there a way to have the same for CVS logs? What do typically do
when using CVS to document changes? use free format?
Is the resolution on the time stamps that important?
Jan
^ permalink raw reply [flat|nested] 33+ messages in thread
[parent not found: <whg0y8430s.fsf@viffe <byogctgs0h.fsf@urysohn.math.ethz.ch>]
* Re: *** empty log message *** is a no-no
[not found] ` <whg0y8430s.fsf@viffe <byogctgs0h.fsf@urysohn.math.ethz.ch>
@ 1999-11-17 14:17 ` Denys Duchier
1999-11-17 21:37 ` Russ Allbery
1999-11-17 19:20 ` Lee Cantey
1 sibling, 1 reply; 33+ messages in thread
From: Denys Duchier @ 1999-11-17 14:17 UTC (permalink / raw)
Jan Vroonhof <vroonhof@math.ethz.ch> writes:
> The advantage of Changelogs is that you can write them at the time the
> change is made, not at the time of commit.
Yes, that's a nice feature. However, the ChangeLog idea is not really
appropriate for concurrent development (the record of changes only
becomes meaningful when it is synchronized with the repository,
i.e. at commit points). I like the idea of being able to take notes
between commits, and it would be nice if appropriate default log
messages could be automatically computed from these notes. Any
takers?
> What do typically do when using CVS to document changes? use free
> format?
`C-x v =' to diff with the committed version. Then I document the
changes in fairly free format. Typically, I have also added comments
in the file documenting the new stuff, or making clear the invariants
that should not be violated, etc... I also include these comments in
the log entry.
> Is the resolution on the time stamps that important?
I find it quite convenient, especially when you need to track down why
something no longer works which used to work fine before (maybe just
minutes ago). I use `C-x v l' to get the log history, and, on the
basis of that information I use `C-x v ~' to compare with an earlier
version. When you have lots of developers all concurrently modifying
the same files, timestamp precision can really help. Of course, you
still have that precision in the cvs anyway, but the log messages help
you decide what to look at.
Cheers,
--
Dr. Denys Duchier Denys.Duchier@ps.uni-sb.de
Forschungsbereich Programmiersysteme (Programming Systems Lab)
Universitaet des Saarlandes, Geb. 45 http://www.ps.uni-sb.de/~duchier
Postfach 15 11 50 Phone: +49 681 302 5618
66041 Saarbruecken, Germany Fax: +49 681 302 5615
^ permalink raw reply [flat|nested] 33+ messages in thread
* Re: *** empty log message *** is a no-no
1999-11-17 14:17 ` Denys Duchier
@ 1999-11-17 21:37 ` Russ Allbery
0 siblings, 0 replies; 33+ messages in thread
From: Russ Allbery @ 1999-11-17 21:37 UTC (permalink / raw)
Denys Duchier <Denys.Duchier@ps.uni-sb.de> writes:
> Jan Vroonhof <vroonhof@math.ethz.ch> writes:
>> What do typically do when using CVS to document changes? use free
>> format?
> `C-x v =' to diff with the committed version. Then I document the
> changes in fairly free format. Typically, I have also added comments in
> the file documenting the new stuff, or making clear the invariants that
> should not be violated, etc... I also include these comments in the log
> entry.
As someone who uses both ChangeLogs *and* CVS commit messages for at least
one project, I actually put different information in both. The ChangeLog
gets the typical per-function brief change message; the CVS commit log
gets a free-form chatty description of what I changed and why from more of
an overall perspective.
When using CVS, I don't find the traditional ChangeLog format all that
overly useful, and if I drop one, I'll usually drop the ChangeLog in favor
of the CVS commit history and just generate the ChangeLog automatically
from the commit history. I find the noting of what functions changed in a
file to be considerably less useful than cvs annotate.
But a lot of this is driven by what sort of software one is writing.
--
Russ Allbery (rra@stanford.edu) <URL:http://www.eyrie.org/~eagle/>
^ permalink raw reply [flat|nested] 33+ messages in thread
* Re: *** empty log message *** is a no-no
[not found] ` <whg0y8430s.fsf@viffe <byogctgs0h.fsf@urysohn.math.ethz.ch>
1999-11-17 14:17 ` Denys Duchier
@ 1999-11-17 19:20 ` Lee Cantey
1 sibling, 0 replies; 33+ messages in thread
From: Lee Cantey @ 1999-11-17 19:20 UTC (permalink / raw)
Jan Vroonhof <vroonhof@math.ethz.ch> writes:
> The advantage of Changelogs is that you can write them at the time the
> change is made, not at the time of commit.
This is exactly what I do.
> In addition Changelogs contain the function/variable affected by the
> change and there is support from Emacs to add them automatically.
Yes, very useful.
> Is there a way to have the same for CVS logs? What do typically do
> when using CVS to document changes? use free format?
Here's the beauty. I use ChangeLogs when doing development, then just
use those entries for the CVS commit. It works pretty darn well.
You might want to look at PCL-CVS which automates quote a bit of this
for you.
Lee.
^ permalink raw reply [flat|nested] 33+ messages in thread
* Re: *** empty log message *** is a no-no
1999-11-12 20:04 ` Per Abrahamsen
` (2 preceding siblings ...)
[not found] ` <whg0y8430s.fsf@viffe <byogctgs0h.fsf@urysohn.math.ethz.ch>
@ 1999-11-17 14:39 ` Jan Vroonhof
[not found] ` <whg0y8430s.fsf@viffe <byemdpi3na.fsf@urysohn.math.ethz.ch>
` (3 subsequent siblings)
7 siblings, 0 replies; 33+ messages in thread
From: Jan Vroonhof @ 1999-11-17 14:39 UTC (permalink / raw)
Denys Duchier <Denys.Duchier@ps.uni-sb.de> writes:
> Yes, that's a nice feature. However, the ChangeLog idea is not really
> appropriate for concurrent development (the record of changes only
> becomes meaningful when it is synchronized with the repository,
> i.e. at commit points).
No they are very useful for concurrent development. However I think
you mean concurrent development where everybody commits often.
I am thinking of shared development over the internet where typically
one commits complete bits of work. If they than also first submitted
for general review in the form of Patches, changelogs come in very handy.
> `C-x v =' to diff with the committed version. Then I document the
> changes in fairly free format. Typically, I have also added comments
> in the file documenting the new stuff, or making clear the invariants
> that should not be violated, etc... I also include these comments in
> the log entry.
I like the fact that ChangeLog entries have a strict format that
includes the function names. I use them as a kind of CVS
annotate that is function based and not line based.
In addition in shared internet project you have the problem that CVS
annotate does not work over anonymous CVS.
> > Is the resolution on the time stamps that important?
In internet based collaborative effort timescales are of the order of
days anyway, so the resolution of one day is sufficient.
Jan
^ permalink raw reply [flat|nested] 33+ messages in thread
[parent not found: <whg0y8430s.fsf@viffe <byemdpi3na.fsf@urysohn.math.ethz.ch>]
* Re: *** empty log message *** is a no-no
[not found] ` <whg0y8430s.fsf@viffe <byemdpi3na.fsf@urysohn.math.ethz.ch>
@ 1999-11-17 16:06 ` Denys Duchier
0 siblings, 0 replies; 33+ messages in thread
From: Denys Duchier @ 1999-11-17 16:06 UTC (permalink / raw)
Jan Vroonhof <vroonhof@math.ethz.ch> writes:
> No they are very useful for concurrent development.
useful, but not appropriate. what ultimately matters is the record of
committed changes.
> However I think you mean concurrent development where everybody
> commits often. I am thinking of shared development over the
> internet where typically one commits complete bits of work.
My experience also comes from `internet' development projects. Our
main project involves groups in germany, sweden and belgium. We do
commit often (especially when responding to bug reports). Personally,
I have several projects in computational linguistics that involve
multiple sites and a number of students modifying and extending a code
base that I provide and maintain. And then, there are papers and
course material to be co-authored, documentation to be collaboratively
written, tools to be maintained, databases to be updated, etc... I
don't know if my case is atypical; maybe you're right.
> > > Is the resolution on the time stamps that important?
>
> In internet based collaborative effort timescales are of the order of
> days anyway, so the resolution of one day is sufficient.
well, not in my experience, but I guess your mileage may vary. My
main beef with this is that empty log messages just don't help me any.
And saying "see ChangeLog file" also does not help (see what?). I
want `C-x v l' to give me an informative log history of the file.
Second, empty log messages (or "see ChangeLog file") in the cvs
newsgroup are totally useless. They defeat the purpose of having such
a newsgroup.
However, not being a gnus developer myself, my opinion is hardly the
one that really matters here.
Cheers,
--
Dr. Denys Duchier Denys.Duchier@ps.uni-sb.de
Forschungsbereich Programmiersysteme (Programming Systems Lab)
Universitaet des Saarlandes, Geb. 45 http://www.ps.uni-sb.de/~duchier
Postfach 15 11 50 Phone: +49 681 302 5618
66041 Saarbruecken, Germany Fax: +49 681 302 5615
^ permalink raw reply [flat|nested] 33+ messages in thread
* Re: *** empty log message *** is a no-no
1999-11-12 20:04 ` Per Abrahamsen
` (4 preceding siblings ...)
[not found] ` <whg0y8430s.fsf@viffe <byemdpi3na.fsf@urysohn.math.ethz.ch>
@ 1999-11-17 20:47 ` Jan Vroonhof
1999-11-18 12:55 ` Jan Vroonhof
[not found] ` <whg0y8430s.fsf@viffe <byr9hoq7qk.fsf@bolzano.math.ethz.ch>
7 siblings, 0 replies; 33+ messages in thread
From: Jan Vroonhof @ 1999-11-17 20:47 UTC (permalink / raw)
Denys Duchier <Denys.Duchier@ps.uni-sb.de> writes:
> > No they are very useful for concurrent development.
>
> useful, but not appropriate. what ultimately matters is the record of
> committed changes.
I don't quite understand what you mean here. If you commit the new
ChangeLog entries with the changes they refer to the ChangeLogs also
only record commited changes?
> written, tools to be maintained, databases to be updated, etc... I
> don't know if my case is atypical; maybe you're right.
I think it is more the other way around. It is Gnus (or in my case
XEmacs) that are atypical.
> well, not in my experience, but I guess your mileage may vary. My
> main beef with this is that empty log messages just don't help me any.
> And saying "see ChangeLog file" also does not help (see what?). I
> want `C-x v l' to give me an informative log history of the file.
Indeed. I was never arguing for that. In fact I think making sure the
log messages get populated from ChangeLogs is a very good idea.
XEmacs currently has CVS logs of the style "Martin's patch" or "Some
patches for 21.1.19" which is highly annoying.
I am just arguing that currently CVS logs cannot ChangeLogs replace
ChangeLogs, because the
1. The ChangeLogs have a logical grouping and this is more or less
enforced. The changes explicitly name the functional unit involved.
2. ChangeLogs can be distributed easily with the tarballs.
What I would really want is a better VC system than CVS.
> However, not being a gnus developer myself, my opinion is hardly the
> one that really matters here.
I think input about issues, coming from experience, is just good a
contribution as coding.
Jan
^ permalink raw reply [flat|nested] 33+ messages in thread
* Re: *** empty log message *** is a no-no
1999-11-12 20:04 ` Per Abrahamsen
` (5 preceding siblings ...)
1999-11-17 20:47 ` Jan Vroonhof
@ 1999-11-18 12:55 ` Jan Vroonhof
[not found] ` <whg0y8430s.fsf@viffe <byr9hoq7qk.fsf@bolzano.math.ethz.ch>
7 siblings, 0 replies; 33+ messages in thread
From: Jan Vroonhof @ 1999-11-18 12:55 UTC (permalink / raw)
Russ Allbery <rra@stanford.edu> writes:
> from the commit history. I find the noting of what functions changed in a
> file to be considerably less useful than cvs annotate.
>
> But a lot of this is driven by what sort of software one is writing.
And how.. For instance CVS annotate does not work for anonymous CVS
:-(
Jan
^ permalink raw reply [flat|nested] 33+ messages in thread
[parent not found: <whg0y8430s.fsf@viffe <byr9hoq7qk.fsf@bolzano.math.ethz.ch>]