The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.

NAME

OODoc::Text::Chapter - collects the information of one chapter

INHERITANCE

 OODoc::Text::Chapter
   is a OODoc::Text::Structure
   is a OODoc::Text
   is a OODoc::Object

SYNOPSIS

DESCRIPTION

OVERLOADED

overload: '""' (stringification)

overload: '==' and '!='

overload: 'cmp' (string comparison)

METHODS

Constructors

$obj->emptyExtension(CONTAINER)

OODoc::Text::Chapter->new(OPTIONS)

     Option       Defined in       Default                                      
     container    L<OODoc::Text>   L<new(manual)|OODoc::Text::Chapter/"METHODS">
     description  L<OODoc::Text>   C<''>                                        
     level        L<OODoc::Text::Structure>  C<1>                                         
     linenr       L<OODoc::Text>   <required>                                   
     manual                        undef                                        
     name         L<OODoc::Text>   undef                                        
     type         L<OODoc::Text>   C<'Chapter'>                                 

    . container OBJECT

    . description STRING

    . level INTEGER

    . linenr INTEGER

    . manual OBJECT

      The manual in which this chapter is described.

    . name STRING

    . type STRING

Inheritance knowledge

$obj->extends([OBJECT])

Attributes

$obj->container([OBJECT])

$obj->description

$obj->level

$obj->name

$obj->niceName

$obj->type

Location

$obj->findEntry(NAME)

$obj->manual([NAME])

$obj->path

$obj->unique

$obj->where

Collected

$obj->all(METHOD, PARAMETERS)

$obj->example(OBJECT)

$obj->examples

$obj->findDescriptionObject

$obj->isEmpty

$obj->openDescription

Subroutines

$obj->addSubroutine(OBJECTS)

$obj->setSubroutines(ARRAY)

$obj->subroutine(NAME)

$obj->subroutines

Commonly used functions

$obj->filenameToPackage(FILENAME)

OODoc::Text::Chapter->filenameToPackage(FILENAME)

$obj->mkdirhier(DIRECTORY)

OODoc::Text::Chapter->mkdirhier(DIRECTORY)

Manual Repository

$obj->addManual(MANUAL)

$obj->mainManual(NAME)

$obj->manuals

$obj->manualsForPackage(NAME)

$obj->packageNames

Sections

A chapters consists of a list of sections, which may contain subsections.

$obj->section(NAME|OBJECT)

    With a NAME, the section within this chapter with that name is returned. With an OBJECT (which must be a OODoc::Text::Section), a new section is added to the end of the list.

$obj->sections([SECTIONS])

    Returns a list of all sections 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().

REFERENCES

See the OODoc website at http://perl.overmeer.net/oodoc/ for more details.

COPYRIGHTS

Module version 0.06. 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.