Formatters

h1. Testing Formatters

=toc

h2. IRC

=irc 10:47 <@marcus> it's just not supported in the json spec 10:47 <@rjbs> marcus: right, so you break anybody using json.ext.js for example 10:47 <@nothingmuch> marcus: i'm sure marc would happily accept a patch 10:47 <@rjbs> JSON::XS already support comments. 10:48 -!- Channel #moose created Thu Mar 16 13:41:41 2006 10:48 <@ash> marcus: an using eval to parse json is a bad idea :) =irc

Comments: This irc log was copied from irssi. Here are some comments. * Time is not shown (maybe OK). * User names get wrapped in [[ ]] which is kind of strange to me. Would prefer they were left as <@marcus>. * The 'Channel created' line didn't wrap. * Some color?

Alternative: Using good old <pre>

10:47 @marcus> it's just not supported in the json spec
10:47 @rjbs> marcus: right, so you break anybody using json.ext.js for example
10:47 @nothingmuch> marcus: i'm sure marc would happily accept a patch
10:47 @rjbs> JSON::XS already support comments.
10:48 -!- Channel #moose created Thu Mar 16 13:41:41 2006
10:48 @ash> marcus: an using eval to parse json is a bad idea :)

Rating: irc formatter is not better than using pre in this example.

h2. Perl

#!/usr/bin/perl
use strict;
print "Hola el meu fill.\n";
while (my $person = $people->next) {
    shave_head($person);
    print $person->name, " just became a skinhead.\n";
    $person->smokes_peace_pipe();
    print $person->name, " just became another skinhead for peace.\n";
}

Rating: It works! Now if we just had an syntax checker, tidier and extractor so I can do literate programming directly from MojoMojo...

h2. POD

=pod

=head1 Killer App

This is a killer app.

=head2 kill_function

This function will kill your app.

=pod

Comments: * The heading levels all link to the same place: #__top. Maybe a defect of Pod::Simple::HTML, but it warrants investigation.

Rating: With intra-page links, I don't find it so useful.

h2. Comments

=comments

h2. Include

This seems to under development, or at least doesn't play well with edits yet.

Rating: Caution using it, results can be undesirable.

h2. Redirect

I want demonstrate it here since, well, you'd be redirect. It has been test and works fine though.

Rating: Usable.