NAME

Text::Wrap - line wrapping to form simple paragraphs

SYNOPSIS

use Text::Wrap

print wrap($initial_tab, $subsequent_tab, @text);

use Text::Wrap qw(wrap $columns $huge);

$columns = 132;
$huge = 'die';
$huge = 'wrap';

DESCRIPTION

Text::Wrap::wrap() is a very simple paragraph formatter. It formats a single paragraph at a time by breaking lines at word boundries. Indentation is controlled for the first line ($initial_tab) and all subsquent lines ($subsequent_tab) independently.

Lines are wrapped at $Text::Wrap::columns columns. $Text::Wrap::columns should be set to the full width of your output device.

When words that are longer than $columns are encountered, they are broken up. Previous versions of wrap() die()ed instead. To restore the old (dying) behavior, set $Text::Wrap::huge to 'die'.

EXAMPLE

print wrap("\t","","This is a bit of text that forms 
	a normal book-style paragraph");

AUTHOR

David Muir Sharnoff <muir@idiom.com> with help from Tim Pierce and many others.