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.
  • If I have a comment that I want to stand out I use the shebang rule to my advantage (dark blue instead of cyan).
    #!# A very important comment that want everyone to notice
    • I am color weak so that is hard for me to tell so I just use # XXX to have something stand out.

      • Heh. I also use that trick from time to time. That reminds me, I need to modify my Vim config to make '# BUG' stand out in red.
        • I copied the perl syntax file to my .vim directory and tweaked it to highlight bug comments differently. 'BUG' gets colored white on red and the rest of the comment in the normal cyan (if you use the default color scheme).

          [mmusgrove@test perl]$ diff /usr/share/vim/vim70/syntax/perl.vim ~/.vim/syntax/perl.vim
          125a126
          > syn keyword perlBug                     BUG contained
          371c372
          < syn match  perlComment           

  • In this:

        $root->findnodes(qq[
          //ATTRIBUTE[($NAME="$bckwrd_wf" or $NAME="$bckwrd_ses") and $VALUE="NO"]/$VALUE |
          //TASKINSTANCE[$FPDNR="NO"]/$FPDNR |
          //TASKINSTANCE[$FPIF="NO"]/$FPIF
        ])

    VS. this:

        $root->findnodes("
          //ATTRIBUTE[($NAME="$bckwrd_wf" or $NAME="$bckwrd_ses") and $VALUE="NO"]/$VALUE |
          //TASKINSTANCE[$FPDNR="NO"]/$FPDNR |
          //TASKINSTAN

  • The YAML mode in emacs cannot cope with comments containing apostrophes. So I don't write "don't" or "isn't", but "do not" or "is not" ...
  • I've thought about this a lot. For a long time, I avoided chained method calls, like:

    $foo->bar->baz(123, "abc");

    or:

    $foo->{bar}->baz(123);

    because only the first method was highlighted as such. Some day I discovered perl-mauke.vim [1] which made lots of things better. However, there are still some things I avoid because of Vim. However, that's probably just me. I also avoid modules with names that are not correctly camel-cased (in my understanding), or methods that start with an uppercase letter.

  • A huge pain in the ass for me is that literal barewords for fat commas are falsely shown as keywords.

    foo( reset => 1 );

    Another big one, for me at least, is that all POD blocks should start with =pod, otherwise the relatively simple comment checker in Ultraedit can't handle it.

    • Using a keyword as a bareword is what causes this. I haven't looked into fixing it as I see it as a feature. Try

      foo( bar => 1 );

      and you'll see that bar is treated like quoted text.