
Rudesind::Captioned - A role for things with captions

use Class::Roles does => 'Rudesind::Captioned'; $self->caption

This module provides a role for objects which are captioned, galleries and images. Any class that uses it must provide a _caption_file() method.
It provides the following methods:
Returns a boolean indicating whether or not the object has an existing caption.
Returns the object's caption. Returns a false value if no caption exists.
Given a string, this method saves the caption. If the argument given is undefined or the empty string, it deletes the object's caption file entirely.
Calls Rudesind::UI::text_to_html() to turn the object's caption into HTML.