Path: usenet.cise.ufl.edu!newsfeeds.nerdc.ufl.edu!news.magicnet.net!news.maxwell.syr.edu!newsfeed.corridex.com!nntp2.savvis.net!inetarena.com!not-for-mail
From: Gareth Rees <garethr@cre.canon.co.uk>
Newsgroups: comp.lang.perl.announce,comp.lang.perl.modules
Subject: ANNOUNCE: HTML::FromText
Followup-To: comp.lang.perl.modules
Date: 27 Dec 1998 17:02:23 GMT
Organization: Canon Research Centre Europe
Lines: 54
Approved: merlyn@stonehenge.com (comp.lang.perl.announce)
Message-ID: <765p6v$36o$1@play.inetarena.com>
NNTP-Posting-Host: halfdome.holdit.com
X-Disclaimer: The "Approved" header verifies header information for article transmission and does not imply approval of content.
Xref: usenet.cise.ufl.edu comp.lang.perl.announce:205 comp.lang.perl.modules:7194

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