NAME

Zen::Koans - Library containing over 100 Zen Koans.

SYNOPSIS

  use Zen::Koans qw(num_koans get_koan dump_fortune);

  print num_koans();

  my $first = get_koan(1);
  print $first->as_html;

  print $fortune_fh dump_fortune();

DESCRIPTION

A koan (pronounced /ko.an/) is a story, dialog, question, or statement in the history and lore of Chan (Zen) Buddhism, generally containing aspects that are inaccessible to rational understanding, yet that may be accessible to intuition.

This module contains over 100 Zen Koans, all taken from Ashidakim Zen Koans here: <http://www.ashidakim.com/zenkoans/zenindex.html>

INTERFACE

Zen::Koans provides two functions:

num_koans: The number of koans available.
get_koan( $koan_number ): Returns a "Zen::Koan" object or croaks if any arguments are not correct.
dump_fortunes: Returns a scalar containing a valid fortune file suitable for using with the strfile utility.

DEPENDENCIES

An open mind.

BUGS AND LIMITATIONS

Provides no analysis of the meanings of these koans.

AUTHORS

Luke Closs <lukec@cpan.org> is the author of this module, but not of the Koans. Luke also checked the koans for errors and fixed many small typos.

Thanks to Jennifer Roger for her help with spellchecking.

Thanks to Lech Baczynski for dump_fortunes.

DISCLAIMER OF WARRANTY

This module can only offer you so much. It is up to you to make the most of it.