NAME

OODoc::Text::SubSection - collects the text of one subsection within a section

INHERITANCE

OODoc::Text::SubSection
  is an OODoc::Text::Structure
  is an OODoc::Text
  is an OODoc::Object

SYNOPSIS

my $section = $subsection->section;
my $chapter = $subsection->chapter;

DESCRIPTION

A subsection (or head3) is the third level of refining document hierarchies. A subsection must be a part of a section, which is part of a chapter.

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
 container    OODoc::Text             new(section)
 description  OODoc::Text             <empty string>
 level        OODoc::Text::Structure  3
 linenr       OODoc::Text             <required>
 name         OODoc::Text             undef
 section                              <required>
 type         OODoc::Text             'Subsection'
container => OBJECT
description => STRING
level => INTEGER
linenr => INTEGER
name => STRING
section => OBJECT

The section in which this sub-section lives.

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 subsection.

$obj->findEntry($name)

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

$obj->path()

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

$obj->section()

Returns the section object for this subsection.

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

Subsubsections

$obj->subsubsection($name|$object)

With a $name, the subsubsection within this subsection with that name is returned. With an $object (which must be a OODoc::Text::SubSubSection), a new subsubsection is added to the end of the list.

$obj->subsubsections( [$subsubsections] )

Returns a list of all subsubsections 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.