Path: usenet.cise.ufl.edu!huron.eel.ufl.edu!usenet.eel.ufl.edu!uky.edu!atl-news-feed1.bbnplanet.com!washdc3-snh1.gtei.net!su-news-hub1.bbnplanet.com!news.gtei.net!newsfeed.corridex.com!nntp2.savvis.net!inetarena.com!not-for-mail
From: Gareth Rees <[email protected]>
Newsgroups: comp.lang.perl.announce,comp.lang.perl.modules
Subject: ANNOUNCE: HTML::FromText 1.003
Followup-To: comp.lang.perl.modules
Date: 3 May 1999 15:24:22 GMT
Organization: Canon Research Centre Europe
Lines: 85
Approved: [email protected] (comp.lang.perl.announce)
Message-ID: <[email protected]>
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:296 comp.lang.perl.modules:10888

NAME
    HTML::FromText - mark up text as HTML

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

DESCRIPTION
    The text2html function marks up plain text as HTML.  By
    default it converts HTML metacharacters into the
    corresponding entities.  More sophisticated transformations,
    such as splitting the text into paragraphs or marking up
    bulleted lists, can be carried out by setting the
    appropriate options.

    The following transformations are available:

    * 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

HISTORY
    1.001  Original CPAN release.

    1.002  Much improved recognition of e-mail addresses with special
           characters, as specified by RFC822.

           When 'urls' is supplied, the prefix mailto: on email
           addresses is preserved.

           New option 'pre' wraps text in <PRE>...</PRE>.

           When anchor text is in fixed-width font, the <A> element is
           inside the <TT> element, as required by the HTML DTD.

    1.003  Recognize '&' in email addresses, as specified by RFC822.

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

AUTHOR
    Gareth Rees <[email protected]>.

AVAILABLE FROM
    http://www.cpan.org/authors/id/G/GD/GDR/HTML-FromText-1.003.tar.gz

COPYRIGHT
    Copyright (c) 1999 Canon Research Centre Europe. All rights
    reserved.  This module is free software; you can
    redistribute it and/or modify it under the same terms as
    Perl itself.

--
Gareth Rees

You are viewing proxied material from ftp.icm.edu.pl. The copyright of proxied material belongs to its original authors. Any comments or complaints in relation to proxied material should be directed to the original authors of the content concerned. Please see the disclaimer for more details.