use Perl

• Some comments ... (Score:2)

  by drhyde (1683)

  I prefer single characters instead of words; + and - for additions and removals (like diff); removal and other changes should be distinct because removal does *not* imply incompatible (see the example below).

  Any thoughts on how to deal with long text for any entry? I suggest that if a line starts with whitespace, it is assumed to be a continuation of the previous line:

  -: removed the dependency on Foo::Bar, which fails its tests on some platforms.
   It is now optional, and without it fr
  • Re: (Score:2)

    by Juerd (1796)

    That kind of removed is not the kind of removed I was thinking of. Such confusion is another reason to remove "removed" from the list.
    
    However, it does uncover a missing part of the changelog spec: a keyword for changes that are neither bugfixes nor incompatible, like backend changes (removed dependencies) and performance optimizations. I suggest "change" because it is nicely neutral. (I was thinking of "improvement" first, but it is too long and internals changes can be done for other reasons too.)
    • Re:Some comments ... (Score:1)

      by hex (3272) on 2007.11.13 16:37 (#59021) Homepage Journal

      Actually, the first draft spec had "c" for "change" in it, and I think I dropped it by mistake when drawing up this new one. I agree that it should go back in.

      Reply to This

      Parent