I've pushed an initial release of XML::Atom::Ext::OpenSearch to CPAN. It's a pretty simple add-on to XML::Atom that will lead you read and write OpenSearch enabled Atom feeds. This module has been in the works for nearly a year. I've been working with jshirley and miyagawa and with the release of XML::Atom 0.28, all of the bugs seem to be ironed out.
In the distribution, I've included a Changes file which is YAML-compatible. NB: I've also copied the file to Changes.yml as one cannot expect every Changes file to be YAML. For the purpose of discussion, here it is inline:
# Revision history for Perl extension XML::Atom::Ext::OpenSearch.
0.01:
date: Wed, 07 Nov 2007 08:39:38 -0400
maintainer: Brian Cassidy <bricas@cpan.org>
urgency: low
changes:
- original version
I've basically pilfered the ideas from the debian changelog specs. It's simple enough that it could be hand-generated, but at the same time parts could be auto-generated. Comments?
Incidentally, I've just released Module-Changes as a sort of working discussion basis for machine-readble Changes files.
Re:Just use debian changelog format directly?
LTjake on 2007-11-09T17:22:34
I chose YAML simply to compliment the standard META.yml file. It just means that you only need one type of base-loader to load the two files.
I like the look of debian changelogs. There's an existing standard with some base tools to go along with it -- it just doesn't compliment the existing meta information we have.
But maybe that's not a big deal...