Path: usenet.cise.ufl.edu!usenet.eel.ufl.edu!news.mathworks.com!news.maxwell.syr.edu!supernews.com!uunet!in3.uu.net!192.108.254.3!news.teleport.com!not-for-mail
From: Eryq <eryq@enteract.com>
Newsgroups: comp.lang.perl.announce,comp.lang.perl.modules
Subject: ANNOUNCE: HTML::Stream 1.32 now available on the CPAN
Followup-To: comp.lang.perl.modules
Date: 13 Jan 1997 16:12:45 GMT
Organization: Little or none...
Lines: 95
Sender:  -yp- @gadget.cscaper.com
Approved: merlyn@stonehenge.com (comp.lang.perl.announce)
Message-ID: <5bdmtt$kp$1@nadine.teleport.com>
NNTP-Posting-Host: gadget.cscaper.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:90 comp.lang.perl.modules:1333

The latest version of HTML::Stream (1.32) has been uploaded to the CPAN in the
authors/Eryq directory.  Major news: "html2perlstream" utility now included,
which parses HTML files and generates HTML::Stream code from them.  See below.
  
You can also get a copy from
 
	http://www.enteract.com/~eryq/CPAN/

----

NAME

    HTML::Stream - HTML output stream class, and some markup utilities

DESCRIPTION

    The HTML::Stream Perl5 module provides you with an object-oriented 
    (and subclassable) way of outputting HTML.  Basically, you open up 
    an "HTML stream" on an existing filehandle, and then do all of your 
    output to the HTML stream.  You can intermix HTML-stream-output and 
    ordinary-print-output, if you like.

    Here's small sample of the different ways you can use this module:

        use HTML::Stream qw(:funcs);
        $HTML = new HTML::Stream \*STDOUT;
      
        # The vanilla interface...
        $HTML->tag('A', HREF=>"$href");
        $HTML->tag('IMG', SRC=>"logo.gif", ALT=>"LOGO");
        $HTML->text($caption);
        $HTML->tag('_A');
             
        # The chocolate interface (with whipped cream)...
        $HTML -> A(HREF=>"$href")
              -> IMG(SRC=>"logo.gif", ALT=>"LOGO")
              -> t($caption)
              -> _A;
       
        # The strawberry interface...
        output $HTML [A, HREF=>"$href"], 
                     [IMG, SRC=>"logo.gif", ALT=>"LOGO"],
                     $caption,
                     [_A];

    Please see the HTML::Stream module for full details.

KIT CONTAINS

    HTML::Stream
	The Perl module itself.

    html2perlstream	(in the ./bin directory)
	New! A Perl program for generating HTML::Stream code from HTML.
	You give the HTML you want to generate, and it spits out a .pl
	file.
  
REQUIREMENTS AND INSTALLATION

    HTML::Stream
        None for basic functionality, although you will need HTML::Entities
        if you want to do some of the fancier Latin-1 escaping/unescaping.
	
    html2perlstream
	You'll need to have HTML::Parser (and anything it depends on, probably
        HTML::Entities) installed.  

  * POSSIBLY-OLD COPIES OF HTML::Entities AND HTML::Parser HAVE BEEN PLACED
    IN THE ./etc DIRECTORY FOR YOUR CONVENIENCE.  However, they will *not*
    be installed during this toolkit's installation process, and I STRONGLY
    urge you to get fresh, up-to-date copies from the CPAN 
    (http://www.perl.com/perl).


WHERE TO GET IT

    Any CPAN site, in directory authors/Eryq.
    Go to http://www.perl.com/perl for details.

AUTHOR

    Eryq, 11 Jan 1997
    eryq@enteract.com  
   



-- 
  ___  _ _ _   _  ___ _   Eryq (eryq@enteract.com)
 / _ \| '_| | | |/ _ ' /  Hughes STX, NASA/Goddard Space Flight Cntr.
|  __/| | | |_| | |_| |   http://www.mcs.net/~eryq
 \___||_|  \__, |\__, |__ 
           |___/    |___/ My signature exceeds the recommended 4 lines!