Hi, Phil Steitz wrote:
> On Tue, Dec 21, 2010 at 7:48 PM, sebb <seb...@gmail.com> wrote: > >> On 22 December 2010 00:11, Phil Steitz <phil.ste...@gmail.com> wrote: >> > On Tue, Dec 21, 2010 at 7:00 PM, Ralph Goers >> > <ralph.go...@dslextreme.com >> >wrote: >> > >> >> >> >> On Dec 21, 2010, at 2:55 PM, sebb wrote: >> >> >> >> > On 21 December 2010 05:21, Ralph Goers <ralph.go...@dslextreme.com> >> >> wrote >> >> > >> >> >> I have not included release notes in the src zip since my >> understanding >> >> is the src zip should contain the directories pretty much as they >> >> exist >> in >> >> SVN. Instead I have added a README.txt that tells a user how to >> generate >> >> the announcement file. >> >> > >> >> > I would prefer to see the release notes generated and checked into >> >> > SVN; they can then be included in both source and binary archives. >> >> > >> >> > See for example MATH and NET (2.0) >> >> >> >> I looked at net/trunk. I would prefer that the release notes be >> generated >> >> during mvn release:prepare instead of requiring a manual mvn >> >> invocation >> to >> >> create the release notes and then a commit. I have that working for >> >> the binary distribution but I don't want to do it for the source >> distribution >> >> since they shouldn't be included if they aren't in svn and, in my >> >> view, >> they >> >> shouldn't be in svn because they will generally be out of sync with >> >> changes.xml in trunk. >> >> >> >> I would say that is up to the RM :) >> > >> > I personally don't have a problem with the out-of-synch condition. >> > What >> is >> > important is, like changes.xml or any other file, what gets tagged and >> > released. >> >> +1 >> >> I think it's vital that the release notes are included in the source >> release. >> >> The user should not be required to run a command to create the release >> notes. >> >> But the RM should definitely *look at* the generated release notes and, > IMO, intentionally committing them is a good thing. Nothing generated > directly from maven has ever met my expectations in terms of formatting > and > content, so I have always ended up tweaking the generated files. I don't > see this as onerous, personally. Then why not generating it directly before the release manually, "finalize" it and commit it? After a release it can be deleted again in svn. All we need then is a verification that the file exists while releasing. This can be done by the verifier plugin (best to bind the goal to the validation phase) in the release profile. - Jörg --------------------------------------------------------------------- To unsubscribe, e-mail: dev-unsubscr...@commons.apache.org For additional commands, e-mail: dev-h...@commons.apache.org