NAME

Religion::Bible::Reference - canonicalize shorthand bible references

VERSION

version 0.00_01

$Id$

SYNOPSIS

use Religion::Bible::Reference;

my $quote = bibref("jn8:32");

print "($quote)";   # (John 8:32)
print $quote->book; # John

DESCRIPTION

This module converts simple text descriptions of bible references and ranges into objects that stringify into a canonical form.

FUNCTIONS

bibref($ref_string)

This function is exported by default, and constructs a new Religion::Bible::Reference

METHODS

Religion::Bible::Reference->new($ref_string)

This method acts just like the exported bibref function.

$self->stringify

This method returns a string representing the reference, using the canonical book name.

$class->canonicalize_book($book_abbrev)

If possible, this method returns the canonical name of the book whose abbreviation was passed.

$class->parse_range($range_string)

This method returns a hash reference describing the range described in the passed string.

AUTHOR

Ricardo Signes, <rjbs@cpan.org>

TODO

• validate ranges against book/chapter lengths

• clean up regex/lists

• create (un)loadable modules of books and abbreviations

BUGS

Please report any bugs or feature requests to bug-religion-bible-reference@rt.cpan.org, or through the web interface at http://rt.cpan.org. I will be notified, and then you'll automatically be notified of progress on your bug as I make changes.

COPYRIGHT

Copyright 2005 Ricardo Signes, All Rights Reserved.

This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.