homepage

This issue tracker has been migrated to GitHub , and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author r.david.murray
Recipients brett.cannon, dstufft, ezio.melotti, georg.brandl, larry, lemburg, ncoghlan, pitrou, r.david.murray, sbt, terry.reedy, tshepang, zach.ware
Date 2015年09月25日.15:24:13
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1443194653.79.0.842364150227.issue18967@psf.upfronthosting.co.za>
In-reply-to
Content
Because the two summaries should be *different* in most cases. The first line of the checkin should ideally be a single sentence of less than 80 characters, while the NEWS item will almost always be longer. The NEWS item should be a complete summary, while the first checkin line is a 'summary in context' (ie: it can assume the reader knows the files that were changed, since log -v will show you that). This obviously requires that the succeeding paragraphs expand on that minimal summary (in most cases) in a way that doesn't look like a NEWS entry.
Now, this is obviously my preferred style and others may have different styles and/or disagree, but I'd like that style to be supported.
Note also that a big part of putting the NEWS entries in the tracker is so that they can be *edited*. Populating them initially from the checkin message is OK, but I predict that the actual workflow will be to create the NEWS entry in the tracker as part of getting the patch to the 'commit ready' point, which means that having a tool that pre-populates the commit message from the tracker NEWS entry will probably be more useful to most people. (And yeah, I'm sure that means a lot of commits will just have the NEWS entry as the commit message, which will make me sad, but oh well :)
History
Date User Action Args
2015年09月25日 15:24:13r.david.murraysetrecipients: + r.david.murray, lemburg, brett.cannon, georg.brandl, terry.reedy, ncoghlan, pitrou, larry, ezio.melotti, tshepang, sbt, zach.ware, dstufft
2015年09月25日 15:24:13r.david.murraysetmessageid: <1443194653.79.0.842364150227.issue18967@psf.upfronthosting.co.za>
2015年09月25日 15:24:13r.david.murraylinkissue18967 messages
2015年09月25日 15:24:13r.david.murraycreate

AltStyle によって変換されたページ (->オリジナル) /