Stories
Slash Boxes
Comments
NOTE: use Perl; is on undef hiatus. You can read content, but you can't post it. More info will be forthcoming forthcomingly.

All the Perl that's Practical to Extract and Report

The Fine Print: The following comments are owned by whoever posted them. We are not responsible for them in any way.
 Full
 Abbreviated
 Hidden
More | Login | Reply
Loading... please wait.
  • .conf seems like a bad choice. The summary of changes is not configuration. The .conf extension does not tell you how the file is formatted, but rather what it is for. A changelog is not for configuration. Why not ChangeLog.ini or something like that? The filename makes the content purpose clear and the extension makes the type clear.

    I don't see the value in the top-level section for version-date pairs. Presumably the file will always be written out to place the sections in a useful order, and anyone who wants to re-order the sections or deal with them logically will read them in, and can then sort by any field he likes, rather than needing a redundant index in the file.

    INI files do not by default have good semantics for multi-value entries. While IniFiles might add it, that means that dealing with these files requires dealing with some bespoke data format. (Well, more bespoke than INI files are to begin with.) At least YAML has a spec and grammar, and multiple implementations across many languages.

    Whatever super-awesome changelog format is used should be something that people can use outside of Perl. There *is* life out there.
    --
    rjbs
    • Hmmm, you make some good points.

      I would argue that a change log supplies config info pertaining to each version, so the choice is not that bad. But I'll certainly reconsider. After all, nothing is cast in Perl-based stone just yet.

      I would like an extension which definitively indicated the format, a la yml and xml, but without the format being known, that's not so easy.

      Changelog.ini is reasonable. That sort of feedback is the point of posting in the first place.

      The date can easily be a per-section entry, and