TEXT::TEMPLATE VERSION 0.1 beta 25 January, 1996 COPYRIGHT The Text::Template module is Copyright 1996 Mark-Jason Dominus. You may use, modify, copy, and distribute it under the same terms as Perl itself. DESCRIPTION This module is for filling in templates. A template is a regular piece of text with tiny perl programs embedded in it. When a template is filled in, the perl programs are evaluated, and replaced with their values. This is useful for generating all sorts of program output, including HTML pages and error messages. Templates can reside in files external to the program that is filling them in, and they can be modified and maintained by persons unfamiliar with Perl, because the Perl parts of a template are encapsulated. PREREQUISITES Exporter. HOW TO BUILD AND INSTALL perl Makefile.PL make make test If it pases the tests, do make install RECENT CHANGES This is a BETA release. Future changes are very likely. Future incompatible changes are likely. Changes from 0.1 alpha: * All reported bugs fixed. * You can now apply `fill_in' to the same template object more than once and get a useful result. If the `source' of the template is a file or filehandle, `fill_in' will rewind the file, if possible. * Some changes and small fixes to documentation. * Default `broken' function is now a little nicer. * Added small test program. TODO This package should fill in templates in a `Safe' compartment. The callback function that `fill_in' calls when a template contains an error should be eble to return an error message to the rest of the program. `my' variables in `fill_in' are still susceptible to being clobbered by template evaluation. Perhaps it will be safer to make them `local' variables. Perhaps there should be a utility method for emptying out a package. BUGS TO Mark-Jason Dominus, Plover Systems mjd@pobox.com