Re: Structured Changelog?
On Monday 29 June 2009 02:49:53 Chris Dolan wrote: Josh, I participated in a previous thread on this topic, but I couldn't find it (maybe it was blog comments?) Maybe you're referring to: http://use.perl.org/~hex/journal/34864 ? Regards, Shlomi Fish From memory, I think we concluded that, no, there was no formal spec and that it would be too painful to build one broad enough for everyone's taste. So, we dropped the idea. My own ad-hoc syntax looks like this example: http://cpansearch.perl.org/src/CDOLAN/Fuse-PDF-0.09/Changes In retrospect, I may have gotten a little carried away with too much detail... For my own syntax, I wrote an author unit test that checks that all versions have a summary and a release date. I never got around to writing the test that ensured the .pm's current version number had an entry in the changelog. Chris On Jun 27, 2009, at 10:42 AM, Joshua ben Jore wrote: Last year I started seeing change logs in perl modules that looked more YAMLish. Is there any spec out there on this? I'm currently just copying input from `git log --pretty=oneline' into my Changes file and as of this moment, including the git repo URL. Is there any external standard or pattern I can conform to? Revision history for Perl extension App::Perldoc::Search at http://github.com/jbenjore/App-Perldoc-Search/commits/master. 0.02 Sat Jun 27 08:33:00 2009 304a4464b38b71f10f34c8866da7e3bab1369d3e Clean up dependency list 0.01 Fri Jun 26 01:10:54 2009 9e60c318ebd5543bb342725f7f4834b2502e65f5 Add META.yml c69869d09c07115b04120ce0d294011940d76321 0.01 Josh -- - Shlomi Fish http://www.shlomifish.org/ http://www.shlomifish.org/humour/ways_to_do_it.html God gave us two eyes and ten fingers so we will type five times as much as we read.
Re: Structured Changelog?
Chris Dolan ch...@chrisdolan.net writes: I never got around to writing the test that ensured the .pm's current version number had an entry in the changelog. Maybe Test::CheckChanges, though I found myself putting an empty entry to satisfy it for making a trial dist, which defeats the purpose of a check of course. (Have to flag somehow when doing a prospective release as against a work-in-progress check build.)
Re: Structured Changelog?
use $ENV{RELEASE_TESTING} as that flag? (That's what's done to hide the l..o..n..g.. tests in Perl::Dist and Perl::Dist::WiX that take hours, as opposed to seconds, to complete, so that I only do those tests when I'm ready to release.) --Curtis On Tue, 30 Jun 2009 06:49 +1000, Kevin Ryde use...@zip.com.au wrote: Chris Dolan ch...@chrisdolan.net writes: I never got around to writing the test that ensured the .pm's current version number had an entry in the changelog. Maybe Test::CheckChanges, though I found myself putting an empty entry to satisfy it for making a trial dist, which defeats the purpose of a check of course. (Have to flag somehow when doing a prospective release as against a work-in-progress check build.) -- Curtis Jewell swords...@csjewell.fastmail.us %DCL-E-MEM-BAD, bad memory -VMS-F-PDGERS, pudding between the ears [I use PC-Alpine, which deliberately does not display colors and pictures in HTML mail]
Re: Structured Changelog?
Josh, I participated in a previous thread on this topic, but I couldn't find it (maybe it was blog comments?) From memory, I think we concluded that, no, there was no formal spec and that it would be too painful to build one broad enough for everyone's taste. So, we dropped the idea. My own ad-hoc syntax looks like this example: http://cpansearch.perl.org/src/CDOLAN/Fuse-PDF-0.09/Changes In retrospect, I may have gotten a little carried away with too much detail... For my own syntax, I wrote an author unit test that checks that all versions have a summary and a release date. I never got around to writing the test that ensured the .pm's current version number had an entry in the changelog. Chris On Jun 27, 2009, at 10:42 AM, Joshua ben Jore wrote: Last year I started seeing change logs in perl modules that looked more YAMLish. Is there any spec out there on this? I'm currently just copying input from `git log --pretty=oneline' into my Changes file and as of this moment, including the git repo URL. Is there any external standard or pattern I can conform to? Revision history for Perl extension App::Perldoc::Search at http://github.com/jbenjore/App-Perldoc-Search/commits/master. 0.02 Sat Jun 27 08:33:00 2009 304a4464b38b71f10f34c8866da7e3bab1369d3e Clean up dependency list 0.01 Fri Jun 26 01:10:54 2009 9e60c318ebd5543bb342725f7f4834b2502e65f5 Add META.yml c69869d09c07115b04120ce0d294011940d76321 0.01 Josh
Re: Structured Changelog?
On Sat, Jun 27, 2009 at 8:42 AM, Joshua ben Joretwi...@gmail.com wrote: Last year I started seeing change logs in perl modules that looked more YAMLish. Is there any spec out there on this? I'm currently just copying input from `git log --pretty=oneline' into my Changes file and as of this moment, including the git repo URL. Is there any external standard or pattern I can conform to? Thanks!
Structured Changelog?
Last year I started seeing change logs in perl modules that looked more YAMLish. Is there any spec out there on this? I'm currently just copying input from `git log --pretty=oneline' into my Changes file and as of this moment, including the git repo URL. Is there any external standard or pattern I can conform to? Revision history for Perl extension App::Perldoc::Search at http://github.com/jbenjore/App-Perldoc-Search/commits/master. 0.02 Sat Jun 27 08:33:00 2009 304a4464b38b71f10f34c8866da7e3bab1369d3e Clean up dependency list 0.01 Fri Jun 26 01:10:54 2009 9e60c318ebd5543bb342725f7f4834b2502e65f5 Add META.yml c69869d09c07115b04120ce0d294011940d76321 0.01 Josh