Wrapper(3p)

NAME
Text::Wrapper - Simple word wrapping routine

SYNOPSIS
    require Text::Wrapper;
    $wrapper = Text::Wrapper->new(columns => 60, body_start => '    ');
    print $wrapper->wrap($text);

DESCRIPTION
Text::Wrapper provides simple word wrapping. It breaks long lines, but does not alter spacing or remove existing line breaks. If you're looking for more sophisticated text formatting, try the Text::Format module.

Reasons to use Text::Wrapper instead of Text::Format:

•   Text::Wrapper is significantly smaller.

•   It does not alter existing whitespace or combine short lines. It only breaks long lines.

Again, if Text::Wrapper doesn't meet your needs, try Text::Format.

  Methods

$wrapper = Text::Wrapper->new( [options] )
    Constructs a new Text::Wrapper object. The options are specified by key and value. The keys are:

     body_start  The text that begins the second and following lines of
                 a paragraph.  (Default '')

     columns     The number of columns to use.  This includes any text
                 in body_start or par_start.  (Default 70)

     par_start   The text that begins the first line of each paragraph.
                 (Default '')

$wrapper->body_start( [$value] )
$wrapper->columns( [$value] )
$wrapper->par_start( [$value] )
    If $value is supplied, sets the option and returns the previous value. If omitted, just returns the current value.

$wrapper->wrap($text)
    Returns a word wrapped copy of $text. The original is not altered.

BUGS
Does not handle tabs (they're treated just like spaces).

Does not break words that can't fit on one line.

AUTHOR
Christopher J. Madsen <chris_madsen@geocities.com>

POD ERRORS
Hey! The above document had some coding errors, which are explained below:

Around line 187:
    You forgot a '=back' before '=head1'