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


Zen-Koans documentation  | view source Contained in the Zen-Koans distribution.

Index


NAME

Top

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

SYNOPSIS

Top

  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

Top

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

Top

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

Top

An open mind.

BUGS AND LIMITATIONS

Top

Provides no analysis of the meanings of these koans.

AUTHORS

Top

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

Top

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


Zen-Koans documentation  | view source Contained in the Zen-Koans distribution.