This is the mail archive of the libc-alpha@sourceware.org mailing list for the glibc project.


Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]
Other format: [Raw text]

Re: Update copyright dates not handled by scripts/update-copyrights [committed]


On Mon, 2017-01-02 at 15:23 +0000, Joseph Myers wrote:
> On Mon, 2 Jan 2017, Torvald Riegel wrote:
> 
> > On Sun, 2017-01-01 at 04:57 -0500, Mike Frysinger wrote:
> > > even better: let's delete them and be done.
> > 
> > Yes, please.
> 
> The old logs are routinely useful for identifying the logical changesets 
> for changes before the move to git.

That's true.  My hate for them was a little strong it seems ;)  The old
logs should not be removed.

> The newer logs are a matter of the GNU Coding Standards.  That is, if you 
> don't want to maintain information about "what" changed in that particular 
> form, you should be persuading the GCS maintainers to allow just logging 
> descriptions of what and why changed at the logical level rather than the 
> level of individual files and functions (in the case where a version 
> control system provides tracking of the "what" ... not all GNU packages 
> have public version control).

Are you saying that from your point of view, GCS is the only significant
reason for maintaining changelogs?

In my opinion, the coding standards need to serve the projects.  If we
can find consensus in glibc that it does not give us a net win, then it
doesn't serve us.  One could still argue that it may serve
users/developers that are not interacting with the glibc community
directly (in which case they'd be told to just use git, please...);
However, beyond grouping changes (ie, "logical change sets" as you write
above), the changelogs aren't really useful IMO: they details vary a lot
regarding "what", and "why is mostly not covered at all.  Thus,
developers outside of the glibc developer community would still have to
consult libc-alpha or the git logs, so I see no significant benefit of
the changelogs.

> Absent such a GCS change, we can still move 
> to automatic generation but that requires various infrastructure work such 
> as I outlined.

Yes, and just to be clear, I think something like what you outline would
be a benefit over the existing situation.  However, I'd much prefer for
you (or/and everyone else) to not have to spend the effort on that
infrastructure work and just get rid of changelogs.

Maybe we should just announce that we'll stop doing changelogs and see
whether anybody complains.  If people complain, it would be interesting
to see whether they can show that what they perceive as a loss when not
having changelogs is larger than the win for the glibc developers (and
thus all of glibc's users, indirectly).




Index Nav: [Date Index] [Subject Index] [Author Index] [Thread Index]
Message Nav: [Date Prev] [Date Next] [Thread Prev] [Thread Next]