/ 
OODoc-3.02
River stage zero No dependents
/ OODoc::Text::Section

NAME

OODoc::Text::Section - collects the text of one section within a chapter

INHERITANCE

OODoc::Text::Section
  is an OODoc::Text::Structure
  is an OODoc::Text
  is an OODoc::Object

SYNOPSIS

my $chapter = $section->chapter;
my @subsect = $section->subsections;

my $index   = $section->subsection('INDEX');

my $index   = OODoc::Text::SubSection->new(...);
$section->subsection($index);           # add subsection

DESCRIPTION

Extends "DESCRIPTION" in OODoc::Text::Structure.

OVERLOADED

Extends "OVERLOADED" in OODoc::Text::Structure.

overload: '""' (stringification)

Inherited, see "OVERLOADED" in OODoc::Text

overload: '==' and '!=' (numeric comparison)

Inherited, see "OVERLOADED" in OODoc::Object

overload: 'bool'

Inherited, see "OVERLOADED" in OODoc::Object

overload: 'cmp' (string comparison)

Inherited, see "OVERLOADED" in OODoc::Text

METHODS

Extends "METHODS" in OODoc::Text::Structure.

Constructors

Extends "Constructors" in OODoc::Text::Structure.

$obj->emptyExtension($container)

Inherited, see "Constructors" in OODoc::Text::Structure

$class->new(%options)

Inherited, see "Constructors" in OODoc::Object

-Option     --Defined in            --Default
 chapter                              <required>
 container    OODoc::Text             new(chapter)
 description  OODoc::Text             <empty string>
 level        OODoc::Text::Structure  2
 linenr       OODoc::Text             <required>
 name         OODoc::Text             undef
 type         OODoc::Text             'Section'
chapter => OBJECT
container => OBJECT
description => STRING
level => INTEGER
linenr => INTEGER
name => STRING
type => STRING

Attributes

Extends "Attributes" in OODoc::Text::Structure.

$obj->container( [$object] )

Inherited, see "Attributes" in OODoc::Text

$obj->description()

Inherited, see "Attributes" in OODoc::Text

$obj->extends( [$object] )

Inherited, see "Attributes" in OODoc::Text

$obj->level()

Inherited, see "Attributes" in OODoc::Text::Structure

$obj->linenr()

Inherited, see "Attributes" in OODoc::Text

$obj->manual()

Inherited, see "Attributes" in OODoc::Text

$obj->name()

Inherited, see "Attributes" in OODoc::Text

$obj->niceName()

Inherited, see "Attributes" in OODoc::Text::Structure

$obj->type()

Inherited, see "Attributes" in OODoc::Text

$obj->unique()

Inherited, see "Attributes" in OODoc::Object

$obj->where()

Inherited, see "Attributes" in OODoc::Text

Manual Repository

Extends "Manual Repository" in OODoc::Text::Structure.

$obj->addManual($manual)

Inherited, see "Manual Repository" in OODoc::Object

$obj->findManual($name)

Inherited, see "Manual Repository" in OODoc::Object

$obj->mainManual($name)

Inherited, see "Manual Repository" in OODoc::Object

$obj->manuals()

Inherited, see "Manual Repository" in OODoc::Object

$obj->manualsForPackage($name)

Inherited, see "Manual Repository" in OODoc::Object

$obj->packageNames()

Inherited, see "Manual Repository" in OODoc::Object

$obj->publicationIndex()

Inherited, see "Manual Repository" in OODoc::Object

$obj->publish(\%options)

Inherited, see "Manual Repository" in OODoc::Object

Location

Extends "Location" in OODoc::Text::Structure.

$obj->chapter()

Returns the chapter object for this section.

$obj->findEntry($name)

Inherited, see "Location" in OODoc::Text::Structure

$obj->path()

Inherited, see "Location" in OODoc::Text::Structure

Collected

Extends "Collected" in OODoc::Text::Structure.

$obj->addExample($object)

Inherited, see "Collected" in OODoc::Text

$obj->all($method, \%parameters)

Inherited, see "Collected" in OODoc::Text::Structure

$obj->examples()

Inherited, see "Collected" in OODoc::Text

$obj->findDescriptionObject()

Inherited, see "Collected" in OODoc::Text

$obj->isEmpty()

Inherited, see "Collected" in OODoc::Text::Structure

$obj->openDescription()

Inherited, see "Collected" in OODoc::Text

Subroutines

Extends "Subroutines" in OODoc::Text::Structure.

$obj->addSubroutine($objects)

Inherited, see "Subroutines" in OODoc::Text::Structure

$obj->setSubroutines(\@subs)

Inherited, see "Subroutines" in OODoc::Text::Structure

$obj->subroutine($name)

Inherited, see "Subroutines" in OODoc::Text::Structure

$obj->subroutines()

Inherited, see "Subroutines" in OODoc::Text::Structure

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 subsections in this chapter.

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().

SEE ALSO

This module is part of OODoc version 3.02, built on August 15, 2025. Website: https://perl.overmeer.net/oodoc/

LICENSE

For contributors see file ChangeLog.

This software is copyright (c) 2003-2025 by Mark Overmeer.

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