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

use Perl Log In

Log In

[ Create a new account ]

masak (6289)

masak
  (email not shown publicly)
http://masak.org/carl

Been programming Perl since 2001. Found Perl 6 somewhere around 2004, and fell in love. Now developing November (a Perl 6 wiki), Druid (a Perl 6 board game), pls (a Perl 6 project installer), GGE (a regex engine), and Yapsi (a Perl 6 implementation). Heavy user of and irregular committer to Rakudo.

Journal of masak (6289)

Wednesday September 03, 2008
01:51 PM

Comments

[ #37341 ]

November is still a young project, but we already have a few nice coding habits. For example, we're pretty quick at marking as TODO: the things that merit a revisit at some point in the future. Right now, there are 8 TODO: comments in the master branch.

Another markup we have adopted is the RAKUDO: tag, essentially flagging all idioms that are the result of Rakudo not quite being Perl 6 yet. :) As of this writing, there are 27 such comments in the master branch.

For those RAKUDO: comments which have a corresponding RT ticket, the ticket number is added for easy searching. (This habit also seems to make us report more bugs.)

Here's a little taste of what it looks like:

# RAKUDO: Chained trinary operators do not do what we mean yet.
# RAKUDO: Would be nicer to use map and [~].
# RAKUDO: Poor man's CATCH.
# RAKUDO: Need to match again inside while loop. [perl #58352]

But what's this?

# TODO: Довести до ума, чтобы корректно работало с
#       существующими но неопределенными $key
#       (Make code work properly with an existing but
#       undefined $key)

# RAKUDO: Hash.:exists еще не реализован (Hash.:exists not
#         implemented yet)

[Update 2008-09-16: Fixed spelling errors noted by esobchenko++]

Our first two international comments, from ihrd++ of Vladivostok.pm. We hope to see more comments in the future in languages other than English. The programming world is English-speaking to such a large extent nowadays, that we tend to forget all those who weren't fortunate enough to grow up with every-day exposure to the language — a significant fraction of programmers out there.

So, from now on, another habit of ours is: comment liberally, in a language you're comfortable with. Be proud! Express yourself in the language you're at home with.

Maybe your language will be the next one adorning the November source?

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.
  • - "неопределенными", not "не определенными" in this case; - "реализоваÐ
    • Thank you -- fixed.

      (Oh, and Slash [slashcode.com], you know this i18n boat everyone's talking about, the one that supposedly would allow foreign people using your commenting system together with their funny letters and characters? You're not on it.)

  • The .exists method now works on Hash (r30739), but I didn't see a full spec for .:exists yet.