Luke Closs > Zen-Koans > Zen::Koans

Download:
Zen-Koans-0.05.tar.gz

Dependencies

Annotate this POD

View/Report Bugs
Module Version: 0.05   Source  

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.

syntax highlighting: