Text::MagicTemplate README File
===============================


Description
-----------

MagicTemplate is a "magic" interface between programming and design. It makes
"magically" available all the runtime values - stored in your variables or
returned by your subroutines - inside a static template file. Usually no need to
assign values to the object.


Structure
---------

This is the general three of the Text::MagicTemplate system

    Bundle::Text::MagicTemplate  a bundle to install everything in one step
    Text::MagicTemplate          the main module
    Text::MagicTemplate::Zone    defines the zone object
    HTML::MagicTemplate          handlers useful in HTML environment

    
Installation
------------

0.  Prerequisites:
- Perl version 5.005 or more recent.


1. CPAN installation
- if you want to install Text::MagicTemplate plus all related extensions
(Text::MagicTemplateX::HTML and prerequisites), all in one easy step:

    perl -MCPAN -e 'install Bundle::Text::MagicTemplate'


2. Standard installation
- from the directory where this file is located, type:

        perl Makefile.PL
        make
        make test
        make install

        
Uninstallation of obsolete modules
----------------------------------

If you have installed some 2.xx version you could want to uninstall the obsolete files from that installation. You should manually unlink (delete) the following files and directories (sorry, no automatic uninstallation yet):

    Text/MagicTemplate/Tutorial.pm
    Text/MagicTemplate/Utilities.pm
    Text/MagicTemplateX.pm
    Text/MagicTemplateX directory including all its content

--
Domizio Demichelis <dd@4pro.net>
2003-10-14
