NAME ^

Parrot::Docs::Group - Group of documentation items

SYNOPSIS ^

        use Parrot::Docs::Group;

DESCRIPTION ^

A documentation group is a number of items with some optional descriptive text.

Parrot::Docs::Group is a subclass of Parrot::Docs::Item.

Class Methods ^

new_group($name, $text, @items)
Returns a new group.Use this when creating groups within a Parrot::Docs::Section subclass's new() method.
new($name, $text, @contents)
Returns a new group.$name and $text are required, though the text can be an empty string. @contents is one or more Parrot::Docs::Item instances, or relative paths.

Instance Methods ^

name()
Returns the name of the group.
html_link()
Groups have no HTML link. This method returns an empty string which will be discarded when building the navigation bar.
write_html($source, $target, $silent)
write_html() is called on each item in the group.Some HTML-formatted text describing the files linked to is returned.
write_contents_html($source, $target, $silent)
Iterates over the group's contents and calls write_html() on each one.Some HTML-formatted text describing the files linked to is returned.
contents_relative_to_source($source)
Returns the contents of the group interpreted relative to the source directory.

SEE ALSO ^

Parrot::Docs::Section
Parrot::Docs::Item


parrot