view release on metacpan or  search on metacpan

lib/Acme/Takahashi/Method.pm  view on Meta::CPAN

__END__
# Below is stub documentation for your module. You'd better edit it!

=head1 NAME

Acme::Takahashi::Method - turns your script into slides accordingly to the Takahashi Method

=head1 SYNOPSIS

  use Acme::Takahashi::Method;
  # and the rest of your codes.

=head1 DESCRIPTION

The Takahashi Method L<http://www.rubycolor.org/takahashi/> is a
strong, powerful and impressive method that makes your presentation
something unforgettable.  This module makes your script as impressive
as those presentations.

Seeing is believing.  try

  cp eg/fact.pl
  perl -Ilib fact.pl 10

and see what I mean.

=head2 IMPORT DIRECTIVES

This module supports directives below.  You can set as many directives
as you like as follows;

  use Acme::Takahashi::Method columns => 132, rows => 50, noxec => 1;

=over 2

=item columns

Default is 80.  If you have larger terminals try

  use Acme::Takahashi::Method columns => 132;

or something.

=item rows

Default is 24.  If you have larger terminals try

  use Acme::Takahashi::Method columns => 50;

or something.

=item noslideshow

By default, this module plays a slide show before it executes.  If you
only need to make slides, turn this on as

  use Acme::Takahashi::Method noslideshow => 1;

=item noclobber

By default, this module clobbers your original script.  If you don't want this kind of tragedy, 

  use Acme::Takahashi::Method noclobber => 1;

You still get nice slides.

=item noexec

If you just want to make slides and don't want to run scripts, do

  use Acme::Takahashi::Method noexec => 1;

=back

=head2 EXPORT

Are you kidding ?

=head1 CAVEATS

=over 2

=item no branches

Hey, you are making slides and slides are not suppose to branch!

=item no loops

Hey, don't make slides boring by repeating over and over.
If you need to EXECUTE loops use labels and C<goto>.  Here is an example.

  loop: 
  $result *= $n--;
  goto loop unless $n <= 1;

=item no braces that spans beyond lines

Natually a slide that only contains C<{> and C<}> are boring as hell.
If you need braces make it fit into one line.

  do { stuff } while(cond); # ok

  do {
    stuff;
  }
  while(cond);              # perfectly NG

=back

=head1 SEE ALSO

The Takahashi Method (Japanese)
L<http://www.rubycolor.org/takahashi/>

L<Acme>

=head1 AUTHOR

Dan Kogai, E<lt>dankogai@dan.co.jpE<gt>

=head1 COPYRIGHT AND LICENSE