Skip to contentSkip to conversation

remove main CHANGELOG file

PATCH New Kim Phillips 6 participants 20 messages Apr 14, 2010 – Jul 16, 2010

lore
Share & tools
lore
#0 lore raw

PATCH 2/2 remove main CHANGELOG file

CHANGELOG is a duplicate of the u-boot project's git log: remove it.

It is assumed that this file's only purpose is to serve non-git users downloading u-boot project source in the form of a tarball release. If that is the case, then the generation of the CHANGELOG file should occur at tarball release generation time, and not consume duplicate history, slowing things down and polluting grep match results for u-boot developers using git.

u-boot project git history goes back to before u-boot 0.1.0, so remove CHANGELOG-before-U-Boot-1.1.5 file too.

---
 CHANGELOG                     |83736 -----------------------------------------
 CHANGELOG-before-U-Boot-1.1.5 | 5607 ---
 2 files changed, 0 insertions(+), 89343 deletions(-)
 delete mode 100644 CHANGELOG
 delete mode 100644 CHANGELOG-before-U-Boot-1.1.5
CHANGELOG deleted +0 -6
deleted file mode 100644
index d4cd8f1..0000000
@@ -1,83736 +0,0 @@
-commit 8e64d6efd8d778a5f83d8bff9cd273a86dcc182f
-Author: Heiko Schocher <[email protected]>
-Date:	Wed Mar 31 08:34:51 2010 +0200
-
-    net, doc: How to setup MAC address correctly
-

<deleted rest of patch due to excessive size, but something like this should do it:

git am <this-message>; git rm CHANGELOG*; git add -u; git commit

Quoted 1 line
#1 lore raw

PATCH 2/2 remove main CHANGELOG file

Dear Kim Phillips,

Quoted 1 line · In message <[email protected]> you wrote:

CHANGELOG is a duplicate of the u-boot project's git log: remove it.

No. Please re-read the archive why this file is kept.

Quoted 6 lines

It is assumed that this file's only purpose is to serve non-git users downloading u-boot project source in the form of a tarball release. If that is the case, then the generation of the CHANGELOG file should occur at tarball release generation time, and not consume duplicate history, slowing things down and polluting grep match results for u-boot developers using git.

Slowing things down? C'me on.

Polluting grep results? Then exclude this file from grepping...

Quoted 2 lines

u-boot project git history goes back to before u-boot 0.1.0, so remove CHANGELOG-before-U-Boot-1.1.5 file too.

NAK. My position about these files has not changed.

Best regards,

Wolfgang Denk

Signature · 5 lines
DENX Software Engineering GmbH,     MD: Wolfgang Denk & Detlev Zundel
HRB 165235 Munich, Office: Kirchenstr.5, D-82194 Groebenzell, Germany
Phone: (+49)-8142-66989-10 Fax: (+49)-8142-66989-80 Email: wd at denx.de
The only thing necessary for the triumph of evil is for good  men  to
do nothing.                                            - Edmund Burke
#2 lore raw

PATCH 2/2 remove main CHANGELOG file

Quoted 6 lines · On Tue, 4 May 2010 23:41:40 +0200 Wolfgang Denk <[email protected]> wrote:

Dear Kim Phillips,

Quoted 1 line · In message <[email protected]> you wrote:

CHANGELOG is a duplicate of the u-boot project's git log: remove it.

No. Please re-read the archive why this file is kept.

looking in the u-boot archives, found this very old thread (which I assume is the result of CHANGELOG causing a merge conflict way back when):

Subject: [U-Boot-Users] Proposed CHANGELOG Generation Helpers
Date: Thu, 12 Oct 2006 20:14:30 -0500

and in Message-Id: <[email protected]>, you write:

Quoted 3 lines

So since I seem to be the only person on this planet who likes to have this CHANGELOG file, and it has caused so much trouble already I suggest the following procedure:

...

Quoted 7 lines

(2) rename CHANGELOG into CHANGELOG.OLD, and start a new CHANGELOG which gets automatically generated using the command above or a variation thereof.

Note: nobody needs to take care of this file. It is purely for my own private needs, and I will manage it on my own. Everybody else can just ignore the existence of this file.

which doesn't do a good job of explaining why you keep this file.

More interestingly, in this message:

http://article.gmane.org/gmane.comp.version-control.git/28785

you write:

Quoted 3 lines

True, as long as you can work within the SCM. The changelog file I'm talking about is mostly for people who just work with exported trees (for example, when they download a tarball).

which almost supports what I write in the commit message:

Quoted 4 lines
Quoted 4 lines

It is assumed that this file's only purpose is to serve non-git users downloading u-boot project source in the form of a tarball release. If that is the case, then the generation of the CHANGELOG file should occur at tarball release generation time, and not consume duplicate history,

..which was already suggested to you by Josef Weidendorfer:

http://article.gmane.org/gmane.comp.version-control.git/28790

and further reinforced by Linus Torvalds, here:

http://article.gmane.org/gmane.comp.version-control.git/28789

Quoted 4 lines
Quoted 2 lines

slowing things down and polluting grep match results for u-boot developers using git.

Slowing things down? C'me on.

maybe not git grep performance-wise (yet), but on a frequently-occurring search term, when we have to visually sift through and page down through a large number of CHANGELOG hits (that invariably show up first), then yes, I consider that a development-time barrier.

Quoted 1 line

Polluting grep results? Then exclude this file from grepping...

that's a PITA, and besides, that's what this patch does, and, afaict, at no loss on your part.

Quoted 4 lines
Quoted 2 lines

u-boot project git history goes back to before u-boot 0.1.0, so remove CHANGELOG-before-U-Boot-1.1.5 file too.

NAK. My position about these files has not changed.

Please reconsider: u-boot has no need to be 'special' in this area, and this file's continued existence is a lingering harassment for developers such as myself.

Best regards,

Kim

#3 lore raw

PATCH 2/2 remove main CHANGELOG file

Dear Kim Phillips,

Quoted 5 lines · In message <[email protected]> you wrote:
Quoted 5 lines
Quoted 5 lines

It is assumed that this file's only purpose is to serve non-git users downloading u-boot project source in the form of a tarball release. If that is the case, then the generation of the CHANGELOG file should occur at tarball release generation time, and not consume duplicate history,

Can you recommend a way how such auto-generation / inclusion would be done?

Currently I'm using something like this:

	$ V=2010.03
	$ PREFIX=u-boot-${V}
	$ git archive --format=tar --prefix=${PREFIX}/ v${V} | \
	> bzip2 -v9 >~/tmp/${PREFIX}.tar.bz2

How could this be made to include a non-git-controlled CHANGELOG?

Quoted 6 lines
Quoted 1 line

Slowing things down? C'me on.

maybe not git grep performance-wise (yet), but on a frequently-occurring search term, when we have to visually sift through and page down through a large number of CHANGELOG hits (that invariably show up first), then yes, I consider that a development-time barrier.

So what about git performance? A "grep foobar CHANGELOG" is significantly faster than a "git log --grep=foobar", isn't it?

Quoted 5 lines
Quoted 1 line

NAK. My position about these files has not changed.

Please reconsider: u-boot has no need to be 'special' in this area, and this file's continued existence is a lingering harassment for developers such as myself.

Harassment? Strong words. I am seriously listening to your arguments, but so far I feel that there is a lot of emotion in your message but only few arguments I can follow.

I can understand that you see little use in this file, and even that occasionally it comes into your way.

On the other hand, I regularly use this file, because it speeds up my work.

In addition to the arguments already mentioned here is another reason why I would like to keep this file in place: Quite often we have to work with copies of the U-Boot source tree that do not contain any good information about which version they might have been derived from; the CHANGELOG at least gives an idea about the time frame.

How would you try such identification?

Best regards,

Wolfgang Denk

Signature · 5 lines
DENX Software Engineering GmbH,     MD: Wolfgang Denk & Detlev Zundel
HRB 165235 Munich, Office: Kirchenstr.5, D-82194 Groebenzell, Germany
Phone: (+49)-8142-66989-10 Fax: (+49)-8142-66989-80 Email: wd at denx.de
Respect is a rational process
	-- McCoy, "The Galileo Seven", stardate 2822.3
#4 lore raw

PATCH 2/2 remove main CHANGELOG file

Dne St 5. kv?tna 2010 08:54:01 Wolfgang Denk napsal(a):

Quoted 9 lines

Dear Kim Phillips,

Quoted 5 lines · In message <[email protected]> you wrote:
Quoted 5 lines
Quoted 5 lines

It is assumed that this file's only purpose is to serve non-git users downloading u-boot project source in the form of a tarball release. If that is the case, then the generation of the CHANGELOG file should occur at tarball release generation time, and not consume duplicate history,

Quoted 7 lines

Can you recommend a way how such auto-generation / inclusion would be done?

Currently I'm using something like this:

	$ V=2010.03
	$ PREFIX=u-boot-${V}

git log > CHANGELOG

Quoted 2 lines
	$ git archive --format=tar --prefix=${PREFIX}/ v${V} | \

tar -r CHANGELOG or something ?

Quoted 16 lines
	> bzip2 -v9 >~/tmp/${PREFIX}.tar.bz2

How could this be made to include a non-git-controlled CHANGELOG?

Quoted 6 lines
Quoted 1 line

Slowing things down? C'me on.

maybe not git grep performance-wise (yet), but on a frequently-occurring search term, when we have to visually sift through and page down through a large number of CHANGELOG hits (that invariably show up first), then yes, I consider that a development-time barrier.

So what about git performance? A "grep foobar CHANGELOG" is significantly faster than a "git log --grep=foobar", isn't it?

Quoted 2 lines
Quoted 1 line

NAK. My position about these files has not changed.

Quoted 7 lines
Quoted 3 lines

Please reconsider: u-boot has no need to be 'special' in this area, and this file's continued existence is a lingering harassment for developers such as myself.

Harassment? Strong words. I am seriously listening to your arguments, but so far I feel that there is a lot of emotion in your message but only few arguments I can follow.

Yup

Quoted 18 lines

I can understand that you see little use in this file, and even that occasionally it comes into your way.

On the other hand, I regularly use this file, because it speeds up my work.

In addition to the arguments already mentioned here is another reason why I would like to keep this file in place: Quite often we have to work with copies of the U-Boot source tree that do not contain any good information about which version they might have been derived from; the CHANGELOG at least gives an idea about the time frame.

How would you try such identification?

Best regards,

Wolfgang Denk

#5 lore raw

PATCH 2/2 remove main CHANGELOG file

Dear Marek,

Quoted 6 lines · In message <[email protected]> you wrote:
Quoted 6 lines

Can you recommend a way how such auto-generation / inclusion would be done?

Currently I'm using something like this:

Quoted 8 lines
Quoted 2 lines
	$ V=2010.03
	$ PREFIX=u-boot-${V}

git log > CHANGELOG

Quoted 2 lines
	$ git archive --format=tar --prefix=${PREFIX}/ v${V} | \

tar -r CHANGELOG or something ?

Using a plain "CHANGELOG" here a misses the "${PREFIX}/" part, so I would have to create this directory first [and probably a tmp directory to put it in first to avoid potential name conflicts], then create the CHANGELOG file there, then append it to the archive, then clean everything up.

Is there a more elegant way?

Best regards,

Wolfgang Denk

Signature · 5 lines
DENX Software Engineering GmbH,     MD: Wolfgang Denk & Detlev Zundel
HRB 165235 Munich, Office: Kirchenstr.5, D-82194 Groebenzell, Germany
Phone: (+49)-8142-66989-10 Fax: (+49)-8142-66989-80 Email: wd at denx.de
"Love your country but never trust its government."
- from a hand-painted road sign in central Pennsylvania
#6 lore raw

PATCH 2/2 remove main CHANGELOG file

Quoted 5 lines · Wolfgang Denk

Using a plain "CHANGELOG" here a misses the "${PREFIX}/" part, so I would have to create this directory first [and probably a tmp directory to put it in first to avoid potential name conflicts], then create the CHANGELOG file there, then append it to the archive, then clean everything up.

I can't say if there is a more elegant way of doing this, but if there isn't, can't you automate the above steps with a script?

I agree with Kim. Is there anyone besides you who uses CHANGELOG? If not, then maybe it should be deleted from the repository. I don't see why you can't run a script to regenerate it when you need it.

Signature · 2 lines
Timur Tabi
Linux kernel developer at Freescale
#7 lore raw

PATCH 2/2 remove main CHANGELOG file

Dear Timur Tabi,

Quoted 4 lines · In message <[email protected]>…

I agree with Kim. Is there anyone besides you who uses CHANGELOG? If not, then maybe it should be deleted from the repository. I don't see why you can't run a script to regenerate it when you need it.

The thing is that I use it all the time. grepping there is often more efficient for me then using git log --grep.

Does it hurt you?

Best regards,

Wolfgang Denk

Signature · 5 lines
DENX Software Engineering GmbH,     MD: Wolfgang Denk & Detlev Zundel
HRB 165235 Munich, Office: Kirchenstr.5, D-82194 Groebenzell, Germany
Phone: (+49)-8142-66989-10 Fax: (+49)-8142-66989-80 Email: wd at denx.de
I wish I had a bronze torc for every user who didn't read the manual.
                             - Terry Pratchett, _The Light Fantastic_
#8 lore raw

PATCH 2/2 remove main CHANGELOG file

Hi Wolfgang,

Quoted 8 lines
Quoted 4 lines · In message <[email protected]>…

I agree with Kim. Is there anyone besides you who uses CHANGELOG? If not, then maybe it should be deleted from the repository. I don't see why you can't run a script to regenerate it when you need it.

The thing is that I use it all the time. grepping there is often more efficient for me then using git log --grep.

Could you describe what you use CHANGELOG for? I often look at logs, but 99% of the time its a log of a specific file or directory to trace a bug, see why feature X was added, etc. I rarely look at the repositories entire log, and if I do, I use 'git log'. Although 'git log' takes longer, its guaranteed to be accurate, unlike CHANGELOG which may be slightly out of date.

If you do prefer the speed of looking at a CHANGELOG file, its easy to generate one when you require it.

Quoted 1 line

Does it hurt you?

'hurt' is a strong word, but it certainly annoys me too. Eg:
- Every time someone greps they have to visually ignore the CHANGELOG file hits, or alternately make a grep wrapper script specific to u-boot that strips out CHANGELOG hits.
- Its a duplication of data that's already stored in the repository history. Who likes duplicated data?
- For any change that is automated via a script/grep/sed/etc one needs to filter out the CHANGELOG files.

I don't know if this is much cleaner, but:

$ V=2010.03
$ PREFIX=u-boot-${V}
$ git archive --format=tar --prefix=${PREFIX}/ v${V} | tar -xC ~/tmp
$ git log > ~/tmp/${PREFIX}/CHANGELOG
$ tar -cj -f ~/tmp/${PREFIX}.tar.bz2 -C ~/tmp/ ${PREFIX}
$ rm -fr ~/tmp/${PREFIX}

We could also follow Linux's lead and upload the CHANGELOG as a separate file from the source. eg there would be a CHANGELOG-{V} for each released U-Boot version detailing only what changed since the last release (www.kernel.org/pub/linux/kernel/v2.6/), or alternatively one mega-CHANGELOG like we're doing now if people prefer.

Best,
Peter

#9 lore raw

PATCH 2/2 remove main CHANGELOG file

Dear Peter Tyser,

Quoted 7 lines · In message <[email protected]> you wrote:

Could you describe what you use CHANGELOG for? I often look at logs, but 99% of the time its a log of a specific file or directory to trace a bug, see why feature X was added, etc. I rarely look at the repositories entire log, and if I do, I use 'git log'. Although 'git log' takes longer, its guaranteed to be accurate, unlike CHANGELOG which may be slightly out of date.

Most frequently I use it in combination with some form of grep command (grep, agrep etc.); sometimes I use it in vi/view for manual searching / reading.

Here are a few reasons where I prefer accessing the CHANGELOG over running "git log --grep":

1) it's faster:

	-> time grep foobar CHANGELOG

	real    0m0.005s
	user    0m0.004s
	sys 0m0.001s

	-> time git log --grep=foobar >/dev/null

	real    0m0.240s
	user    0m0.219s
	sys 0m0.021s

2) it's more efficient:

	-> strace -f grep foobar CHANGELOG 2>&1 >/dev/null | wc -l
	143
	-> strace -f git log --grep=foobar 2>&1 >/dev/null | wc -l
	2494

3) it delivers only the lines I cactually search for, while "git log --grep" always spills out the whole commit message:

	-> grep MPC512x CHANGELOG | wc -l
	24
	-> git log --grep=MPC512x | wc -l
	272

4) I can use arbitrary grep options. I am not aware of a git equivalent to, say:

   	-> grep -C2 --color string CHANGELOG

5) I can use other tools to process the messages, like agrep for fuzzy searching; I frequently use this when checking if a specific patch has been applied - too many times a plain text search does not work because the committer manually edited the commit message to fix typos etc. I am not aware of a git equivalent to, say:

-> agrep -2 -i string CHANGELOG

This is probably my most frequently used command

Quoted 2 lines

If you do prefer the speed of looking at a CHANGELOG file, its easy to generate one when you require it.

Yes, I know. But I also want it available to those who don't use git, so it should to be included in the release tarball, and in the auto-generated tarballs when using the "snapshot" links on the web interface; for example try:

	-> wget -O u-boot.tgz 'http://git.denx.de/?p=u-boot.git;a=snapshot;sf=tgz'
Quoted 6 lines
Quoted 1 line

Does it hurt you?

'hurt' is a strong word, but it certainly annoys me too. Eg:
- Every time someone greps they have to visually ignore the CHANGELOG file hits, or alternately make a grep wrapper script specific to u-boot that strips out CHANGELOG hits.

Strange. If I ever run into such a problem then so infrequently that I don't notice it. I guess this is because I usually only grep in specific file types (like "*.[Sch]" or so).

Quoted 2 lines

- Its a duplication of data that's already stored in the repository history. Who likes duplicated data?

In the strict sense, all the checked out files are duplicated data.

Quoted 2 lines

- For any change that is automated via a script/grep/sed/etc one needs to filter out the CHANGELOG files.

You probably need to exclude a number of other files as well?

Quoted 5 lines

We could also follow Linux's lead and upload the CHANGELOG as a separate file from the source. eg there would be a CHANGELOG-{V} for each released U-Boot version detailing only what changed since the last release (www.kernel.org/pub/linux/kernel/v2.6/), or alternatively one mega-CHANGELOG like we're doing now if people prefer.

I would like to keep the CHANGELOG as part of tarballs, including auto-generated ones.

Best regards,

Wolfgang Denk

Signature · 5 lines
DENX Software Engineering GmbH,     MD: Wolfgang Denk & Detlev Zundel
HRB 165235 Munich, Office: Kirchenstr.5, D-82194 Groebenzell, Germany
Phone: (+49)-8142-66989-10 Fax: (+49)-8142-66989-80 Email: wd at denx.de
Speculation is always more interesting than facts.
                                    - Terry Pratchett, _Making_Money_
#10 lore raw

PATCH 2/2 remove main CHANGELOG file

Quoted 20 lines · Wolfgang Denk

Dear Peter Tyser,

Quoted 7 lines · In message<[email protected]> you wrote:

Could you describe what you use CHANGELOG for? I often look at logs, but 99% of the time its a log of a specific file or directory to trace a bug, see why feature X was added, etc. I rarely look at the repositories entire log, and if I do, I use 'git log'. Although 'git log' takes longer, its guaranteed to be accurate, unlike CHANGELOG which may be slightly out of date.

Most frequently I use it in combination with some form of grep command (grep, agrep etc.); sometimes I use it in vi/view for manual searching / reading.

Here are a few reasons where I prefer accessing the CHANGELOG over running "git log --grep":

1) it's faster:

Quoted 11 lines
	->  time grep foobar CHANGELOG

	real    0m0.005s
	user    0m0.004s
	sys 0m0.001s

	->  time git log --grep=foobar>/dev/null

	real    0m0.240s
	user    0m0.219s
	sys 0m0.021s

Surely the extra quarter second is not too significant compared to the time it takes to formulate the query and examine the results.

Quoted 6 lines

2) it's more efficient:

	->  strace -f grep foobar CHANGELOG 2>&1>/dev/null | wc -l
	143
	->  strace -f git log --grep=foobar 2>&1>/dev/null | wc -l
	2494

It also requires that a cache be maintained just for this purpose.

Quoted 7 lines

3) it delivers only the lines I cactually search for, while "git log

    --grep" always spills out the whole commit message:

	->  grep MPC512x CHANGELOG | wc -l
	24
	->  git log --grep=MPC512x | wc -l
	272
$ git log | grep MPC512x | wc -l
24

Likewise for grep options and alternate tools.

Or if you really want, you could do this locally, and put CHANGELOG in .gitignore:

$ time git log > CHANGELOG

real 0m0.453s
user 0m0.350s
sys 0m0.050s

You could even have a cron job keep it up to date. :-)

-Scott

#11 lore raw

PATCH 2/2 remove main CHANGELOG file

Dear Scott Wood,

Quoted 3 lines · In message <[email protected]> you wrote:

Surely the extra quarter second is not too significant compared to the time it takes to formulate the query and examine the results.

The requests are often generated by some script, and there may be tens of them - enough that the 'git log' versions takes several seconds.

Quoted 8 lines
Quoted 6 lines

2) it's more efficient:

	->  strace -f grep foobar CHANGELOG 2>&1>/dev/null | wc -l
	143
	->  strace -f git log --grep=foobar 2>&1>/dev/null | wc -l
	2494

It also requires that a cache be maintained just for this purpose.

I can't parse that.

Quoted 1 line

You could even have a cron job keep it up to date. :-)

Agreed. There are many, many possibilities.

Best regards,

Wolfgang Denk

Signature · 5 lines
DENX Software Engineering GmbH,     MD: Wolfgang Denk & Detlev Zundel
HRB 165235 Munich, Office: Kirchenstr.5, D-82194 Groebenzell, Germany
Phone: (+49)-8142-66989-10 Fax: (+49)-8142-66989-80 Email: wd at denx.de
Perl itself is  usually  pretty  good  about  telling  you  what  you
shouldn't do. :-)     - Larry Wall in <[email protected]>
#12 lore raw

PATCH 2/2 remove main CHANGELOG file

In reply to Wolfgang Denk

Hi Wolfgang,

Quoted 10 lines
Quoted 6 lines

Could you describe what you use CHANGELOG for? I often look at logs, but 99% of the time its a log of a specific file or directory to trace a bug, see why feature X was added, etc. I rarely look at the repositories entire log, and if I do, I use 'git log'. Although 'git log' takes longer, its guaranteed to be accurate, unlike CHANGELOG which may be slightly out of date.

Most frequently I use it in combination with some form of grep command (grep, agrep etc.); sometimes I use it in vi/view for manual searching / reading.

I still don't grasp what the common use of looking at U-Boot's entire changelog is. What are some common tasks that require grepping U-Boot's
entire changelog? Are these tasks performed frequently enough that the
extra <1 second 'git log' requires is bothersome?

<snip>

Quoted 3 lines

3) it delivers only the lines I cactually search for, while "git log
4) I can use arbitrary grep options. I am not aware of a git
5) I can use other tools to process the messages, like agrep for fuzzy

As Scott mentioned, these can be solved via 'git grep | <cmd>'.

Quoted 9 lines
Quoted 2 lines

If you do prefer the speed of looking at a CHANGELOG file, its easy to generate one when you require it.

Yes, I know. But I also want it available to those who don't use git, so it should to be included in the release tarball, and in the auto-generated tarballs when using the "snapshot" links on the web interface; for example try:

	-> wget -O u-boot.tgz 'http://git.denx.de/?p=u-boot.git;a=snapshot;sf=tgz'

For snapshots, the CHANGELOG file is going to be out of date though. It'll only list the changes that occurred up to the previous release. This seems worse than not having a CHANGELOG at all as its actively misleading people as to what changes their source code has.

<snip>

Quoted 4 lines
Quoted 2 lines

- For any change that is automated via a script/grep/sed/etc one needs to filter out the CHANGELOG files.

You probably need to exclude a number of other files as well?

I think in general you'd want to update all files other than CHANGELOG. As a concrete example, the following is a snippet from a script used for the recent directory reorganization:

git grep lib_$ARCH | grep -v CHANGELOG | sed s/:.*$// | uniq | xargs perl -pi -e "s/lib_$ARCH/arch\/$ARCH\/lib/"

I'll quit whining, just wanted to give my +1 for removing the changelog.

Best,
Peter

#13 lore raw

PATCH 2/2 remove main CHANGELOG file

Dear Peter Tyser,

Quoted 5 lines · In message <[email protected]> you wrote:

I still don't grasp what the common use of looking at U-Boot's entire changelog is. What are some common tasks that require grepping U-Boot's
entire changelog? Are these tasks performed frequently enough that the
extra <1 second 'git log' requires is bothersome?

I'm trying to maintain some awareness of open patches. For example, when I receive a pull request I mark all included patches as processed; sometimes this includes tracking down older versions of the patches, or commit messages that have been changed on the way. And yes, the <1 second delay is bothersome when doing this frequently enough.

Quoted 6 lines
Quoted 1 line
	-> wget -O u-boot.tgz 'http://git.denx.de/?p=u-boot.git;a=snapshot;sf=tgz'

For snapshots, the CHANGELOG file is going to be out of date though. It'll only list the changes that occurred up to the previous release. This seems worse than not having a CHANGELOG at all as its actively misleading people as to what changes their source code has.

I disagree here. I find myself quite frequently in the situation that I have to identify the exact version some source tree has been derived from. Companies who maintain out-of-tree ports usually don't include any SCM information either. To me, the CHANGELOG is an extremely useful resource in such cases.

Quoted 1 line

I'll quit whining, just wanted to give my +1 for removing the changelog.

I don't consider you whining. I am listening to the arguments. I am not convinced yet, though.

Best regards,

Wolfgang Denk

Signature · 5 lines
DENX Software Engineering GmbH,     MD: Wolfgang Denk & Detlev Zundel
HRB 165235 Munich, Office: Kirchenstr.5, D-82194 Groebenzell, Germany
Phone: (+49)-8142-66989-10 Fax: (+49)-8142-66989-80 Email: wd at denx.de
The human race is faced with a cruel choice: work  or  daytime  tele-
vision.
#14 lore raw

PATCH 2/2 remove main CHANGELOG file

Quoted 4 lines
Quoted 1 line

I'll quit whining, just wanted to give my +1 for removing the changelog.

I don't consider you whining. I am listening to the arguments. I am not convinced yet, though.

Well in that case, I'll chime in again:)

Quoted 11 lines
Quoted 4 lines

I still don't grasp what the common use of looking at U-Boot's entire changelog is. What are some common tasks that require grepping U-Boot's
entire changelog? Are these tasks performed frequently enough that the
extra <1 second 'git log' requires is bothersome?

I'm trying to maintain some awareness of open patches. For example, when I receive a pull request I mark all included patches as processed; sometimes this includes tracking down older versions of the patches, or commit messages that have been changed on the way. And yes, the <1 second delay is bothersome when doing this frequently enough.

I see, makes sense. This seems like a problem that is unique to you, as well as potentially a few other maintainers. I imagine the vast majority of developers rarely use the CHANGELOG file though. Would having maintainers create their own CHANGELOG files and/or use something like patchwork be acceptable?

Quoted 7 lines
Quoted 6 lines
Quoted 1 line
	-> wget -O u-boot.tgz 'http://git.denx.de/?p=u-boot.git;a=snapshot;sf=tgz'

For snapshots, the CHANGELOG file is going to be out of date though. It'll only list the changes that occurred up to the previous release. This seems worse than not having a CHANGELOG at all as its actively misleading people as to what changes their source code has.

Quoted 5 lines

I disagree here. I find myself quite frequently in the situation that I have to identify the exact version some source tree has been derived from. Companies who maintain out-of-tree ports usually don't include any SCM information either. To me, the CHANGELOG is an extremely useful resource in such cases.

The CHANGELOG in a company's source tree won't provide any more information than the VERSION, PATCHLEVEL, and EXTRAVERSION in the Makefile though, right? Ie the CHANGELOG is only updated when the VERSION, PATCHLEVEL, and EXTRAVERSION are updated. Either way, it seems like an inexact method to determine the revision of the source code, and there should be a better solution so that you don't have to be a detective every time you get another vendor's source tree.

It seems bad to have an inaccurate CHANGELOG. For example if someone got a snapshot tarball a week before the last release, their CHANGELOG would be missing over 500 changes. In this case the CHANGELOG clearly isn't serving its intended purpose and could actually mislead someone, eg "I know commit XYZ introduces a bug, but the changelog says I don't have commit XYZ in my tree, so I'm bug free!". In reality there have been 500 commits the user is unaware of, including potentially commit XYZ they were trying to avoid.

OK, its a stretch, but I don't get the purpose of an inaccurate CHANGELOG in any case. Other than when the 1 commit that correlates to a tagged release is the the top-of-tree, the CHANGELOG is *never* up to date. It can only be believed if someone downloads an officially released tarball - otherwise it is most likely wrong.

Best,
Peter

#15 lore raw

PATCH 2/2 remove main CHANGELOG file

Dear Peter Tyser,

Quoted 6 lines · In message <[email protected]> you wrote:

I see, makes sense. This seems like a problem that is unique to you, as well as potentially a few other maintainers. I imagine the vast majority of developers rarely use the CHANGELOG file though. Would having maintainers create their own CHANGELOG files and/or use something like patchwork be acceptable?

As far as the patch processing is concerned, a dynamically generated file is perfectly good enough for me. If we can keep the "CHANGELOG" make target I have all I need here.

Quoted 6 lines
Quoted 5 lines

I disagree here. I find myself quite frequently in the situation that I have to identify the exact version some source tree has been derived from. Companies who maintain out-of-tree ports usually don't include any SCM information either. To me, the CHANGELOG is an extremely useful resource in such cases.

Quoted 7 lines

The CHANGELOG in a company's source tree won't provide any more information than the VERSION, PATCHLEVEL, and EXTRAVERSION in the Makefile though, right? Ie the CHANGELOG is only updated when the VERSION, PATCHLEVEL, and EXTRAVERSION are updated. Either way, it seems like an inexact method to determine the revision of the source code, and there should be a better solution so that you don't have to be a detective every time you get another vendor's source tree.

Thats's not quite right. I used to update CHANGELOG more frequently in the past.

Quoted 3 lines

It seems bad to have an inaccurate CHANGELOG. For example if someone got a snapshot tarball a week before the last release, their CHANGELOG would be missing over 500 changes. In this case the CHANGELOG clearly

Agreed. It was never perfect, but the best we (well, I) had.

Quoted 5 lines

OK, its a stretch, but I don't get the purpose of an inaccurate CHANGELOG in any case. Other than when the 1 commit that correlates to a tagged release is the the top-of-tree, the CHANGELOG is *never* up to date. It can only be believed if someone downloads an officially released tarball - otherwise it is most likely wrong.

Right. Well, Kim's pointer to gitattributes is probably the solution to this issue. Please allow me for some time to let this sink in.

Best regards,

Wolfgang Denk

--
DENX Software Engineering GmbH, MD: Wolfgang Denk & Detlev Zundel
HRB 165235 Munich, Office: Kirchenstr.5, D-82194 Groebenzell, Germany
Phone: (+49)-8142-66989-10 Fax: (+49)-8142-66989-80 Email: wd at denx.de He is truly wise who gains wisdom from another's mishap.

#16 lore raw

PATCH 2/2 remove main CHANGELOG file

Quoted 2 lines · On Wed, 5 May 2010 23:51:25 +0200 Wolfgang Denk <[email protected]> wrote:

Right. Well, Kim's pointer to gitattributes is probably the solution to this issue. Please allow me for some time to let this sink in.

ping - it's been two months.

Kim

#17 lore raw

PATCH 2/2 remove main CHANGELOG file

In reply to Wolfgang Denk
Quoted 12 lines · On Wed, 5 May 2010 08:54:01 +0200 Wolfgang Denk <[email protected]> wrote:

Dear Kim Phillips,

Quoted 5 lines · In message <[email protected]> you wrote:
Quoted 5 lines
Quoted 5 lines

It is assumed that this file's only purpose is to serve non-git users downloading u-boot project source in the form of a tarball release. If that is the case, then the generation of the CHANGELOG file should occur at tarball release generation time, and not consume duplicate history,

Can you recommend a way how such auto-generation / inclusion would be done?

Quoted 8 lines

Currently I'm using something like this:

	$ V=2010.03
	$ PREFIX=u-boot-${V}
	$ git archive --format=tar --prefix=${PREFIX}/ v${V} | \
	> bzip2 -v9 >~/tmp/${PREFIX}.tar.bz2

How could this be made to include a non-git-controlled CHANGELOG?

(see below)

Quoted 9 lines
Quoted 6 lines
Quoted 1 line

Slowing things down? C'me on.

maybe not git grep performance-wise (yet), but on a frequently-occurring search term, when we have to visually sift through and page down through a large number of CHANGELOG hits (that invariably show up first), then yes, I consider that a development-time barrier.

So what about git performance? A "grep foobar CHANGELOG" is significantly faster than a "git log --grep=foobar", isn't it?

true, but I find that git log runs well after it is run once and everything is loaded in the cache.

Also, if I'm git grepping in the u-boot git tree, I want to grep the source, not the git log.

Quoted 9 lines
Quoted 5 lines
Quoted 1 line

NAK. My position about these files has not changed.

Please reconsider: u-boot has no need to be 'special' in this area, and this file's continued existence is a lingering harassment for developers such as myself.

Harassment? Strong words. I am seriously listening to your arguments, but so far I feel that there is a lot of emotion in your message but only few arguments I can follow.

you are right; bad choice of words; I meant something milder - more along the lines of 'annoyance'.

Quoted 7 lines

In addition to the arguments already mentioned here is another reason why I would like to keep this file in place: Quite often we have to work with copies of the U-Boot source tree that do not contain any good information about which version they might have been derived from; the CHANGELOG at least gives an idea about the time frame.

How would you try such identification?

it appears that the granularity of CHANGELOG updates is equal to that of VERSION, PATCHLEVEL, and EXTRAVERSION assignments in the root Makefile; so presumably one can refer to those instead.

For exact per-export granularity, one can do something like this:

cd u-boot
echo '$Format:%H$' > snapshot.commit
git add snapshot.commit && git commit -m 'add snapshot.commit file' echo 'snapshot.commit' > .git/info/attributes
git archive --format=tar --prefix=${PREFIX}/ <commit> ...

...the resultant tarball's snapshot.commit file will contain the value of the sha id representing commit <commit>.

for more info, see the gitattributes manpage and the list of placeholders in the PRETTY FORMATS section of the git log manpage.

Kim

#18 lore raw

PATCH 2/2 remove main CHANGELOG file

Dear Kim Phillips,

Quoted 6 lines · In message <[email protected]> you wrote:
Quoted 2 lines

How would you try such identification?

it appears that the granularity of CHANGELOG updates is equal to that of VERSION, PATCHLEVEL, and EXTRAVERSION assignments in the root Makefile; so presumably one can refer to those instead.

This doesn't workl reliably. Too often companies insert their own version information there, which sometimes is completely unrelated to what we use.

Quoted 8 lines

For exact per-export granularity, one can do something like this:

cd u-boot
echo '$Format:%H$' > snapshot.commit
git add snapshot.commit && git commit -m 'add snapshot.commit file' echo 'snapshot.commit' > .git/info/attributes
git archive --format=tar --prefix=${PREFIX}/ <commit> ...

Quoted 5 lines

...the resultant tarball's snapshot.commit file will contain the value of the sha id representing commit <commit>.

for more info, see the gitattributes manpage and the list of placeholders in the PRETTY FORMATS section of the git log manpage.

Ah! That's interesting. Another git feature I didn't know yet.

/me is reading the documentation.

Thanks a lot for this interesting tip!

Best regards,

Wolfgang Denk

Signature · 7 lines
DENX Software Engineering GmbH,     MD: Wolfgang Denk & Detlev Zundel
HRB 165235 Munich, Office: Kirchenstr.5, D-82194 Groebenzell, Germany
Phone: (+49)-8142-66989-10 Fax: (+49)-8142-66989-80 Email: wd at denx.de
Mandrell: "You know what I think?"
Doctor:   "Ah, ah that's a catch question. With a brain your size you
          don't think, right?"
                - Dr. Who
#19 lore raw

PATCH 2/2 remove main CHANGELOG file

In reply to Kim Phillips
Quoted 1 line · On Wed, 5 May 2010 16:06:07 -0500 Kim Phillips <[email protected]>…

echo 'snapshot.commit' > .git/info/attributes

make that:

echo 'snapshot.commit export-subst' > .git/info/attributes

Kim