use Perl

• remove/delete (Score:2)

  by bart (450)

  Looking at your list of abbreviations, it makes a lot of sense to me, except for one detail: the "d". I believe I'm not the only one to expect the "d" to mean "delete". Instead, "d" is for docs, "r" is for remove. So you've solved it by choosing another word instead of "delete"...
  
  But I'm sure mistakes are bound to be made. That people accidentally use "d" instead of "r".
  
  Instead I'd prefer to use another letter for "documentation", but I can't think of any other word.
  • Re:remove/delete (Score:1)

    by hex (3272) on 2007.11.10 9:19 (#58970) Homepage Journal

    Hmm. "d" for "delete" is a good point, however I find the phrasing "I deleted a feature" a little awkward.

    How about we take a leaf out of diff -u's book and circumvent the issue of which word to use?

    -  removed something
    +  added something

    There's no ambiguity in that...

    Reply to This

    Parent

    • Re: (Score:1)

      by Eric Wilhelm (6389)

      I find the alphabetical codes rather unreadable. They mix too much with the text. Having tags for version number and date seems redundant when those two items are essential (and currently standard anyway.) In my rendition, the version and date are a non-indented header over a set of indented paragraphs which start with sigils.
      
      v0.1.1 2007-11-10
      
          + added new thing() method
      
          - removed old deal() method
      
          * fixed bug #12578
      
          % changed code for blah()
      
       
      • Re: (Score:1)

        by Aristotle (5147)

        I thought the metaphor for the maintainer symbol was that someone changed their “hat” (as in “putting on my group leader hat, I say that […]”). That seemed funnily apt to me.