On Thu, 20 Sep 2012 23:43:36 +0200 Vincent Torri <[email protected]> said:

> On Thu, Sep 20, 2012 at 7:53 PM, Lucas De Marchi
> <[email protected]> wrote:
> > On Thu, Sep 20, 2012 at 2:30 PM, Vincent Torri <[email protected]>
> > wrote:
> >> On Thu, Sep 20, 2012 at 7:26 PM, Lucas De Marchi
> >> <[email protected]> wrote:
> >>> On Thu, Sep 20, 2012 at 2:20 PM, Vincent Torri <[email protected]>
> >>> wrote:
> >>>> On Thu, Sep 20, 2012 at 6:27 PM, Eduardo Lima (Etrunko)
> >>>> <[email protected]> wrote:
> >>>>>>> that's what the commit message is for. When it does all automatically,
> >>>>>>> then it's an option.
> >>>>>>
> >>>>>> did you look at the Evil's changeLog ? You'll see why the commit
> >>>>>> message is not sufficient
> >>>>>>
> >>>>>
> >>>>> If you are talking about the list of files changed, it is just plain
> >>>>> useless. There is a --verbose option of svn log that will also output
> >>>>> the changed files.
> >>>>
> >>>> you're stupid or what ? We are not talking about the content of a
> >>>> changelog but of its layout  !
> >>>
> >>>
> >>> It seems everybody except you agree the ChangeLog file is just plain
> >>> useless.
> >>
> >> ultra funny. It's just profusion guys who want to drop changelog
> >
> > Eduardo doesn't work here:
> >
> > Excerpt from the README file in libabc
> > (https://git.kernel.org/?p=linux/kernel/git/kay/libabc.git;a=blob;f=README;h=b4bed51b0403f0f55f4e8bb4706cd97e23c4858c;hb=HEAD):
> >
> >  Update NEWS to let developers know what has changed
> >    - It's the history of the project, stuff that packagers need to know
> >      when putting a new version in the distro. The interesting changes
> >      or added/removed functionality from version to version. This is
> >      not a commit changelog.
> >    - If you want to provide ChangeLog, use the one generated
> >      by git, do not maintain your own.
> 
> so what ? counter-example:
> 
> http://www.gnu.org/prep/standards/html_node/Change-Logs.html
> 
> > kernel doesn't use a ChangeLog file
> > systemd doesn't use a ChangeLog file
> > bluez doesn't use a ChangeLog file
> > connman doesn't use a ChangeLog file
> > kernel doesn't use a ChangeLog file
> > node doesn't use a ChangeLog file
> > go doesn't use a ChangeLog file
> > pulseaudio doesn't use a ChangeLog file
> >
> > v8 uses a ChangeLog file that's really a NEWS file
> > webkit uses a semi-automated ChangeLog file, creating the commit
> > message from the changelog. And it's stupid. Been there.
> 
> and i'm sure i can find HUNDREDS of libs with changelog. I have as
> many arguments as you have.
> 
> > And WE are back to 90's maintaining that stupid files ourselves
> 
> to be clear : I don't like our NEWS file. For me:
> 
> ChangeLog should contain exactly what its name means : log of changes.
> Not all of changes of course.
> 
> NEWS means what's new : that is, entries for the release, API
> additions, deprecations, and eventually the mention of a big
> improvement or a fix of a really big bug. That is, all the
> improvements part should go away, as  I agree that it duplicates what
> is in ChangeLog. raster and others add that part, i accepted it. But I
> don't like it. And that's not the only stuff that I don't like but
> that i have accpeted in that project.

i agree with vincent here fyi. the actual git or svn or cvs or whatever log is
footwork. it isn't publishable data beyond being useful for day-to-day hunting
of who did what.

changelog is "useful publishable changes" just in the order they are done.

news is something you can just blindly copy & paste into a release publication
and is a summary of the  important stuff.

this is the convention for most cases of these files that i have seen.
changelog is kind of old as it comes from a time when people mostly didnt use
scms, but it got repurposed as above. eg the first time u add a feature u add
it to changelog. if u then spend the next week patching and fixing the feature
and maturing it, you just commit. your changelog doesnt change. neither does
news as both these files are intended for digestion at the next release.

you could argue that changelog as a whole is obsolete. one could argue INSTALL
should be removed as frankly README handles that and it doesnt add much more
info (though it is static thus no one notices). hell there is an ABOUT-NLS
event that is there that we never commit but autotools insists should be there.

> >
> > And Vincent, please stop taking it personal and insulting the others.
> > Use "stupid" for ideas. Not people.
> 
> the conversation is heated, that's all. I'm from south of France and
> we are not calm people, there. His answer upset me because what he
> said was almost an insult to what I did in Evil's ChangeLog. But
> nobody noted that. So I won't apologize.
> 
> Vincent
> 
> ------------------------------------------------------------------------------
> Everyone hates slow websites. So do we.
> Make your web apps faster with AppDynamics
> Download AppDynamics Lite for free today:
> http://ad.doubleclick.net/clk;258768047;13503038;j?
> http://info.appdynamics.com/FreeJavaPerformanceDownload.html
> _______________________________________________
> enlightenment-devel mailing list
> [email protected]
> https://lists.sourceforge.net/lists/listinfo/enlightenment-devel
> 


-- 
------------- Codito, ergo sum - "I code, therefore I am" --------------
The Rasterman (Carsten Haitzler)    [email protected]


------------------------------------------------------------------------------
Everyone hates slow websites. So do we.
Make your web apps faster with AppDynamics
Download AppDynamics Lite for free today:
http://ad.doubleclick.net/clk;258768047;13503038;j?
http://info.appdynamics.com/FreeJavaPerformanceDownload.html
_______________________________________________
enlightenment-devel mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/enlightenment-devel

Reply via email to