NAME

Text::Tradition::Collation::Reading - represents a reading (usually a word) in a collation.

DESCRIPTION

Text::Tradition is a library for representation and analysis of collated texts, particularly medieval ones. A 'reading' refers to a unit of text, usually a word, that appears in one or more witnesses (manuscripts) of the tradition; the text of a given witness is composed of a set of readings in a particular sequence

METHODS

new

Creates a new reading in the given collation with the given attributes. Options include:

collation - The Text::Tradition::Collation object to which this reading belongs. Required.

id - A unique identifier for this reading. Required.

text - The word or other text of the reading.

is_start - The reading is the starting point for the collation.

is_end - The reading is the ending point for the collation.

is_lacuna - The 'reading' represents a known gap in the text.

is_ph - A temporary placeholder for apparatus parsing purposes. Do not use unless you know what you are doing.

rank - The sequence number of the reading. This should probably not be set manually.

One of 'text', 'is_start', 'is_end', or 'is_lacuna' is required.

collation

id

text

is_start

is_end

is_lacuna

rank

Accessor methods for the given attributes.

is_meta

A meta attribute (ha ha), which should be true if any of our 'special' booleans are true. Implies that the reading does not represent a bit of text found in a witness.

Convenience methods

related_readings

Calls Collation's related_readings with $self as the first argument.

witnesses

Calls Collation's reading_witnesses with $self as the first argument.

predecessors

Returns a list of Reading objects that immediately precede $self in the collation.

successors

Returns a list of Reading objects that immediately follow $self in the collation.

set_identical( $other_reading)

Backwards compatibility method, to add a transposition relationship between $self and $other_reading. Don't use this.