NAME
OODoc::Text::Section - collects the text of one section within a chapter
INHERITANCE
OODoc::Text::Section
is a OODoc::Text::Structure
is a OODoc::Text
is a OODoc::ObjectSYNOPSIS
my $chapter = $section->chapter;
my @subsect = $section->subsections;
my $index = $section->subsection('INDEX'); # returns subsection
my $index = OODoc::Text::SubSection->new(...);
$section->subsection($index); # set subsectionDESCRIPTION
OVERLOADED
overload: '""' (stringification)
overload: '==' and '!='
overload: 'cmp' (string comparison)
METHODS
Initiation
$obj->emptyExtension(CONTAINER)
OODoc::Text::Section->new(OPTIONS)
Option Defined in Default
chapter <required>
container OODoc::Text <chapter>
description OODoc::Text ''
level OODoc::Text::Structure 2
linenr OODoc::Text <required>
name OODoc::Text C<undef>
type OODoc::Text <required>. chapter OBJECT
. container OBJECT
. description STRING
. level INTEGER
. linenr INTEGER
. name STRING
. type STRING
Attributes
$obj->container([OBJECT])
$obj->description
$obj->level
$obj->name
$obj->niceName
$obj->type
Location
$obj->manual
$obj->path
$obj->unique
$obj->where
Collected
$obj->all(METHOD, PARAMETERS)
$obj->example(OBJECT)
$obj->examples
$obj->extends([OBJECT])
$obj->findDescriptionObject
$obj->openDescription
Subroutines
$obj->addSubroutine(OBJECTS)
$obj->setSubroutines(ARRAY)
$obj->subroutine(NAME)
$obj->subroutines
Commonly used functions
$obj->filenameToPackage(FILENAME)
OODoc::Text::Section->filenameToPackage(FILENAME)
$obj->mkdirhier(DIRECTORY)
OODoc::Text::Section->mkdirhier(DIRECTORY)
Manual Repository
$obj->addManual(MANUAL)
$obj->mainManual(NAME)
$obj->manuals
$obj->manualsForPackage(NAME)
$obj->packageNames
Subsections
$obj->subsection(NAME|OBJECT)
With a NAME, the subsection within this section with that name is returned. With an OBJECT (which must be a OODoc::Text::SubSection), a new subsection is added to the end of the list.
$obj->subsections([SUBSECTIONS])
Returns a list of all sections in this chapter.
Container
$obj->chapter
Returns the chapter object for this section.
Collecting Information
$obj->allExamples
Returns a list of all example, which are OODoc::Text::Example objects, enclosed in the section and its subsections.
DIAGNOSTICS
Error: manual definition requires manual object
A call to addManual() expects a new manual object (a OODoc::Manual), however an incompatible thing was passed. Usually, intended was a call to manualsForPackage() or mainManual().
REFERENCES
See the OODoc website at http://perl.overmeer.net/oodoc/ for more details.
COPYRIGHTS
Module version 0.04. Written by Mark Overmeer (mark@overmeer.net). See the ChangeLog for other contributors.
Copyright (c) 2003 by the author(s). All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.