Subject: ANNOUNCE: HTML::FromText
From: Gareth Rees <[email-masked]>
Date: 27 Dec 1998 17:02:23 GMT
Newsgroups: comp.lang.perl.announce,comp.lang.perl.modules

See http://www.perl.com/CPAN/authors/id/G/GD/GDR/HTML-FromText-1.000.tar.gz

  NAME
	HTML::FromText - flexibly mark up plain text as HTML

  SYNOPSIS
	use HTML::FromText 'text2html';
	print text2html($text, paras => 1, urls => 1);

  DESCRIPTION
	The function `text2html' converts plain text to HTML.  It can
	apply the follow transformations (each transformation is
	selected by passing the appropriate flag as an argument):

	* Turn HTML metacharacters into HTML entities.

	* Spot URLs and convert them to links.

	* Spot e-mail addresses and convert them to `mailto:' links.

	* Preserve line breaks.

	* Expand tabs and preserve spaces throughout the text.

	* Mark up words surrounded with *asterisks* as bold.

	* Mark up words surrounded with _underscores_ as underlined.

	* Format the text as paragraphs.

	* Spot paragraphs where every line begins with whitespace, and
	  mark them up as block quotes.

	* Spot bulleted paragraphs and mark them up as an unordered
          list.

	* Spot numbered paragraphs and marks them up as an ordered list.

	* Spot headings (paragraphs starting with numbers) and mark them
	  up as headings of the appropriate level.

	* Format the first paragraph of the text as a first-level
          heading.

  INSTALLATION
	perl Makefile.PL && make && make test && make install

  BUGS
	* There are lots of transformations it doesn't do.

-- 
Gareth Rees