----------------------------------------------------------------------------- Text::Merge Version 0.36 last revised: March 1st, 2004 Copyright (c) 1997-2001 by Steven D. Harris. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself. ----------------------------------------------------------------------------- CONTENTS -------- This package contains the following files which should share the same version number: Text/Merge.pm - basic text/data merge package Text/Merge/Lists.pm - extension to support display of list references There are HTML formatted manuals in the docs/ directory of the archive if you want to extract just those to read them. DESCRIPTION ----------- The Text::Merge module provides a set of methods for merging text display templates with data sets. It is extended to include support for list of items of various types, displayed individually in context. The interface is designed to be as easy to use as possible while providing extensibility into various contexts and applications on a sophisticated level. You can begin by using the basic template markup and work your way to conditionals. Programmers can master the template processing methods in minutes. This set of functions has been very useful to me in scores of various contexts in my CGI programs and installers. I am publishing them in the hope that they may benefit others as well, and in the hopes that I can get enough feedback to continue to improve them. PREREQUISITES ------------- Before you can build the Text::Merge:: packages you need to have the following installed on your system: * Perl 5.005 or better BUILDING AND INSTALLING THE MODULES ----------------------------------- Assuming you have met all the prerequisites, building the modules should be relatively straightforward. The modules can now be built and installed using this sequence of commands: perl Makefile.PL make make test make install ----------------------------------------------------------------------------- If you would like to assist in development of this module or wish to contact the author, . ----------------------------------------------------------------------------- --SDH