diff --git a/Changes b/Changes index 72d5ef063..ff964652a 100644 --- a/Changes +++ b/Changes @@ -3,7 +3,7 @@ # Changes # # DESCRIPTION -# Revision history for the Template Toolkit version 2.07a, detailing +# Revision history for the Template Toolkit version 2.07b, detailing # significant changes between versions, most recent first. Some # way down the file you'll find a section detailing major changes from # version 1.* to 2.* and a list of "Gotchas!" that you might have to @@ -23,7 +23,17 @@ #======================================================================== #------------------------------------------------------------------------ -# Version 2.07a - ## DEVELOPER RELEASE ## +# Version 2.07b - July 7th 2002 ## DEVELOPER RELEASE ## +#------------------------------------------------------------------------ + +* Added the CONSTANTS, CONSTANTS_NAMESPACE and NAMESPACE options, the + Template::Namespace::Constants module, documentation and t/constants.t + test suite. This adds support for compile-time constant folding and + other custom namespace handlers. + + +#------------------------------------------------------------------------ +# Version 2.07a - July 5th 2002 ## DEVELOPER RELEASE ## #------------------------------------------------------------------------ * Changed the Perl and XS stashes to automatically promote a scalar diff --git a/HACKING b/HACKING index fd275ff65..170f216b9 100644 --- a/HACKING +++ b/HACKING @@ -1,9 +1,9 @@ Template Toolkit - Version 2.07a + Version 2.07b - 05 July 2002 + 07 July 2002 Copyright (C) 1996-2002 Andy Wardley. All Rights Reserved Copyright (C) 1998-2002 Canon Research Centre Europe Ltd. diff --git a/INSTALL b/INSTALL index 056a03a9c..767058067 100644 --- a/INSTALL +++ b/INSTALL @@ -1,9 +1,9 @@ Template Toolkit - Version 2.07a + Version 2.07b - 05 July 2002 + 07 July 2002 Copyright (C) 1996-2002 Andy Wardley. All Rights Reserved Copyright (C) 1998-2002 Canon Research Centre Europe Ltd. @@ -42,8 +42,8 @@ need to install them. They're all available from CPAN if you do. To install the Template Toolkit: - tar zxf Template-Toolkit-2.07a.tar.gz - cd Template-Toolkit-2.07a + tar zxf Template-Toolkit-2.07b.tar.gz + cd Template-Toolkit-2.07b perl Makefile.PL make make test @@ -129,19 +129,19 @@ The Template Toolkit is distributed as a gzipped tar archive file: Template-Toolkit-.tar.gz -where represents the current version number, e.g. 2.07a. +where represents the current version number, e.g. 2.07b. To install the Template Toolkit, unpack the distribution archive to create an installation directory. Something like this: - tar zxf Template-Toolkit-2.07a.tar.gz + tar zxf Template-Toolkit-2.07b.tar.gz or - gunzip Template-Toolkit-2.07a.tar.gz - tar xf Template-Toolkit-2.07a.tar + gunzip Template-Toolkit-2.07b.tar.gz + tar xf Template-Toolkit-2.07b.tar You can then 'cd' into the directory created, - cd Template-Toolkit-2.07a + cd Template-Toolkit-2.07b and perform the usual Perl installation procedure: diff --git a/MANIFEST b/MANIFEST index 475773848..9d45f517d 100644 --- a/MANIFEST +++ b/MANIFEST @@ -51,6 +51,7 @@ docs/src/Modules/Template/Document.html docs/src/Modules/Template/Exception.html docs/src/Modules/Template/Filters.html docs/src/Modules/Template/Iterator.html +docs/src/Modules/Template/Namespace/Constants.html docs/src/Modules/Template/Parser.html docs/src/Modules/Template/Plugin.html docs/src/Modules/Template/Plugin/Autoformat.html @@ -388,6 +389,7 @@ lib/Template/Manual/Syntax.pod lib/Template/Manual/Variables.pod lib/Template/Manual/Views.pod lib/Template/Modules.pod +lib/Template/Namespace/Constants.pm lib/Template/Parser.pm lib/Template/Plugin.pm lib/Template/Plugin/Autoformat.pm @@ -462,10 +464,12 @@ t/compile3.t t/compile4.t t/compile5.t t/config.t +t/constants.t t/context.t t/datafile.t t/date.t t/dbi.t +t/debug.t t/directive.t t/directry.t t/document.t diff --git a/MANIFEST.SKIP b/MANIFEST.SKIP index 320420ea2..ee6bd40b2 100644 --- a/MANIFEST.SKIP +++ b/MANIFEST.SKIP @@ -5,6 +5,7 @@ ^Template-Toolkit-\d\.\d+\.tar\.gz$ ~$ \.old$ +\.\# \.ttc$ \.gz$ \.defaults\.cfg @@ -12,6 +13,7 @@ ^blib/ ^clib/ ^docsrc/ +^docset/ ^project/ ^todo/ ^junk/ diff --git a/README b/README index 738edb149..4afc05b55 100644 --- a/README +++ b/README @@ -1,9 +1,9 @@ Template Toolkit - Version 2.07a + Version 2.07b - 05 July 2002 + 07 July 2002 Copyright (C) 1996-2002 Andy Wardley. All Rights Reserved Copyright (C) 1998-2002 Canon Research Centre Europe Ltd. @@ -43,8 +43,8 @@ need to install them. They're all available from CPAN if you do. To install the Template Toolkit: - tar zxf Template-Toolkit-2.07a.tar.gz - cd Template-Toolkit-2.07a + tar zxf Template-Toolkit-2.07b.tar.gz + cd Template-Toolkit-2.07b perl Makefile.PL make make test @@ -103,7 +103,15 @@ appropriate sex, then you can always return it for a full refund. :-) WHAT'S NEW? ----------- -The most exciting new feature in version 2.05 is Doug Steinwand's +Version 2.08 adds compile time constant folding which can result in a +significant performance boost when processing templates. It also +offers several other minor enhancements and bug fixes. + +Version 2.07 was a major maintenance release, fixing numerous minor bugs +and smoothing out various rough edges. Version 2.06 was a very minor +bug release version. + +The most exciting new feature in version 2.05 was Doug Steinwand's high-speed drop-in replacement for Template::Stash written in Perl XS. With this in place, the Template Toolkit typically runs twice as fast as before! @@ -111,7 +119,7 @@ twice as fast as before! Pretty much everything else in 2.05 and 2.04 before it consisted of minor bug fixes and improvements. -Version 2.03 includes Craig Barratt's 'latex' filter and GD plugins +Version 2.03 included Craig Barratt's 'latex' filter and GD plugins and Dave Cross's tutorial on using the Template Toolkit for creating and reusing XML data files. @@ -336,7 +344,7 @@ VERSION COMPATABILITY --------------------- In terms of the template language and features available, versions -2.01 through to 2.07a should be fully backwardly compatible with +2.01 through to 2.07b should be fully backwardly compatible with version 2.00. Version 2.00 is backwardly compatible with version 1 in all but a few diff --git a/TODO b/TODO index 70ee221f6..313d2a9e2 100644 --- a/TODO +++ b/TODO @@ -3,7 +3,7 @@ # TODO # # DESCRIPTION -# TODO list for the Template Toolkit version 2.07a, containing +# TODO list for the Template Toolkit version 2.07b, containing # known bugs, limitations, planned enhancements, long term visions # and a few whacky ideas. # diff --git a/bin/tpage b/bin/tpage index ef30b87b7..dda273916 100755 --- a/bin/tpage +++ b/bin/tpage @@ -112,8 +112,8 @@ L =head1 VERSION -2.49, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.50, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002. =head1 COPYRIGHT diff --git a/bin/ttree b/bin/ttree index ef892b5a4..86a273799 100755 --- a/bin/ttree +++ b/bin/ttree @@ -635,8 +635,8 @@ L =head1 VERSION -2.49, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.50, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002. =head1 COPYRIGHT diff --git a/docs/lib/docset/config b/docs/lib/docset/config index 54762e160..6daf7529c 100644 --- a/docs/lib/docset/config +++ b/docs/lib/docset/config @@ -248,7 +248,7 @@ docset => { prev => 'Manual', next => 'Library', - pagelist => [ 'Template', 'Base', 'Config', 'Constants', 'Context', 'Document', 'Exception', 'Filters', 'Iterator', 'Parser', 'Plugin', 'Plugins', 'Provider', 'Service', 'Stash', 'Stash_Context', 'Stash_XS', 'Test', 'Plugin_Autoformat', 'Plugin_CGI', 'Plugin_DBI', 'Plugin_Datafile', 'Plugin_Date', 'Plugin_Directory', 'Plugin_Dumper', 'Plugin_File', 'Plugin_Filter', 'Plugin_Format', 'Plugin_GD_Image', 'Plugin_GD_Polygon', 'Plugin_GD_Constants', 'Plugin_GD_Text', 'Plugin_GD_Text_Align', 'Plugin_GD_Text_Wrap', 'Plugin_GD_Graph_lines', 'Plugin_GD_Graph_lines3d', 'Plugin_GD_Graph_bars', 'Plugin_GD_Graph_bars3d', 'Plugin_GD_Graph_points', 'Plugin_GD_Graph_linespoints', 'Plugin_GD_Graph_area', 'Plugin_GD_Graph_mixed', 'Plugin_GD_Graph_pie', 'Plugin_GD_Graph_pie3d', 'Plugin_HTML', 'Plugin_Iterator', 'Plugin_Pod', 'Plugin_String', 'Plugin_Table', 'Plugin_URL', 'Plugin_View', 'Plugin_Wrap', 'Plugin_XML_DOM', 'Plugin_XML_RSS', 'Plugin_XML_Simple', 'Plugin_XML_Style', 'Plugin_XML_XPath' ], + pagelist => [ 'Template', 'Base', 'Config', 'Constants', 'Context', 'Document', 'Exception', 'Filters', 'Iterator', 'Namespace_Constants', 'Parser', 'Plugin', 'Plugins', 'Provider', 'Service', 'Stash', 'Stash_Context', 'Stash_XS', 'Test', 'Plugin_Autoformat', 'Plugin_CGI', 'Plugin_DBI', 'Plugin_Datafile', 'Plugin_Date', 'Plugin_Directory', 'Plugin_Dumper', 'Plugin_File', 'Plugin_Filter', 'Plugin_Format', 'Plugin_GD_Image', 'Plugin_GD_Polygon', 'Plugin_GD_Constants', 'Plugin_GD_Text', 'Plugin_GD_Text_Align', 'Plugin_GD_Text_Wrap', 'Plugin_GD_Graph_lines', 'Plugin_GD_Graph_lines3d', 'Plugin_GD_Graph_bars', 'Plugin_GD_Graph_bars3d', 'Plugin_GD_Graph_points', 'Plugin_GD_Graph_linespoints', 'Plugin_GD_Graph_area', 'Plugin_GD_Graph_mixed', 'Plugin_GD_Graph_pie', 'Plugin_GD_Graph_pie3d', 'Plugin_HTML', 'Plugin_Iterator', 'Plugin_Pod', 'Plugin_String', 'Plugin_Table', 'Plugin_URL', 'Plugin_View', 'Plugin_Wrap', 'Plugin_XML_DOM', 'Plugin_XML_RSS', 'Plugin_XML_Simple', 'Plugin_XML_Style', 'Plugin_XML_XPath' ], pages => { Template => { @@ -366,6 +366,19 @@ docset => { about => 'Data iterator used by the FOREACH directive', prev => 'Filters', + next => 'Namespace_Constants', + }, + Namespace_Constants => { + id => 'Namespace_Constants', + name => 'Template::Namespace::Constants', + title => 'Template::Namespace::Constants', + podname => 'Template::Namespace::Constants', + url => 'Modules/Template/Namespace/Constants.html', + uplink => '../../..', + author => 'abw', + about => 'Compile time constant folding', + + prev => 'Iterator', next => 'Parser', }, Parser => { @@ -378,7 +391,7 @@ docset => { author => 'abw', about => 'LALR(1) parser for compiling template documents', - prev => 'Iterator', + prev => 'Namespace_Constants', next => 'Plugin', }, Plugin => { @@ -1299,6 +1312,7 @@ docset => { 'Template::Exception' => 'Modules/Template/Exception.html', 'Template::Filters' => 'Modules/Template/Filters.html', 'Template::Iterator' => 'Modules/Template/Iterator.html', + 'Template::Namespace::Constants' => 'Modules/Template/Namespace/Constants.html', 'Template::Parser' => 'Modules/Template/Parser.html', 'Template::Plugin' => 'Modules/Template/Plugin.html', 'Template::Plugins' => 'Modules/Template/Plugins.html', diff --git a/docs/src/FAQ/FAQ.html b/docs/src/FAQ/FAQ.html index f6bf215a3..c9f0f99e5 100644 --- a/docs/src/FAQ/FAQ.html +++ b/docs/src/FAQ/FAQ.html @@ -319,8 +319,8 @@ [% WRAPPER section title="VERSION" -%]

-2.49, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.50, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002.

[%- END %] [% WRAPPER section diff --git a/docs/src/Library/HTML.html b/docs/src/Library/HTML.html index 9eeed8097..b58cf9830 100644 --- a/docs/src/Library/HTML.html +++ b/docs/src/Library/HTML.html @@ -292,8 +292,8 @@ [% WRAPPER section title="VERSION" -%]

-2.49, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.50, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002.

[%- END %] [% WRAPPER section diff --git a/docs/src/Library/PostScript.html b/docs/src/Library/PostScript.html index c7d3f8d18..dac847ae6 100644 --- a/docs/src/Library/PostScript.html +++ b/docs/src/Library/PostScript.html @@ -47,8 +47,8 @@ [% WRAPPER section title="VERSION" -%]

-2.49, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.50, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002.

[%- END %] [% WRAPPER section diff --git a/docs/src/Library/Splash.html b/docs/src/Library/Splash.html index d7b768ac2..e699820bc 100644 --- a/docs/src/Library/Splash.html +++ b/docs/src/Library/Splash.html @@ -892,8 +892,8 @@ [% WRAPPER section title="VERSION" -%]

-2.49, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.50, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002.

[%- END %] [% WRAPPER section diff --git a/docs/src/Manual/Config.html b/docs/src/Manual/Config.html index 432a89345..9e7069841 100644 --- a/docs/src/Manual/Config.html +++ b/docs/src/Manual/Config.html @@ -473,6 +473,105 @@ }, }; +
  • CONSTANTS
    +

    +The CONSTANTS option can be used to specify a hash array of template +variables that are compile-time constants. These variables are +resolved once when the template is compiled, and thus don't require +further resolution at runtime. This results in significantly faster +processing of the compiled templates and can be used for variables that +don't change from one request to the next. +

    +
        my $template = Template->new({
+	CONSTANTS => {
+	    title   => 'A Demo Page',
+	    author  => 'Joe Random Hacker',
+	    version => 3.14,
+	},
+    };
    + +
  • CONSTANT_NAMESPACE
    +

    +Constant variables are accessed via the 'constants' namespace by +default. +

    +
        [% tt_start_tag %] constants.title [% tt_end_tag %]
    +

    +The CONSTANTS_NAMESPACE option can be set to specify an alternate +namespace. +

    +
        my $template = Template->new({
+	CONSTANTS => {
+	    title   => 'A Demo Page',
+	    # ...etc...
+	},
+	CONSTANTS_NAMESPACE => 'const',
+    };
    +

    +In this case the constants would then be accessed as: +

    +
        [% tt_start_tag %] const.title [% tt_end_tag %]
    + +
  • NAMESPACE
    +

    +The constant folding mechanism described above is an example of a +namespace handler. Namespace handlers can be defined to provide +alternate parsing mechanisms for variables in different namespaces. +

    +

    +Under the hood, the Template module converts a constructor configuration +such as: +

    +
        my $template = Template->new({
+	CONSTANTS => {
+	    title   => 'A Demo Page',
+	    # ...etc...
+	},
+	CONSTANTS_NAMESPACE => 'const',
+    };
    +

    +into one like: +

    +
        my $template = Template->new({
+	NAMESPACE => {
+	    const => Template:::Namespace::Constants->new({
+		title   => 'A Demo Page',
+		# ...etc...
+	    }),
+	},
+    };
    +

    +You can use this mechanism to define multiple constant namespaces, or +to install custom handlers of your own. +

    +
        my $template = Template->new({
+	NAMESPACE => {
+	    site => Template:::Namespace::Constants->new({
+		title   => "Wardley's Widgets",
+		version => 2.718,
+	    }),
+	    author => Template:::Namespace::Constants->new({
+		name  => 'Andy Wardley',
+		email => 'abw@andywardley.com',
+	    }),
+	    voodoo => My::Namespace::Handler->new( ... ),
+	},
+    };
    +

    +Now you have 2 constant namespaces, for example: +

    +
        [% tt_start_tag %] site.title [% tt_end_tag %]
+    [% tt_start_tag %] author.name [% tt_end_tag %]
    +

    +as well as your own custom namespace handler installed for the 'voodoo' +namespace. +

    +
        [% tt_start_tag %] voodoo.magic [% tt_end_tag %]
    +

    +See [% ttlink('Template::Namespace::Constants', 'Template::Namespace::Constants') -%] +for an example of what a namespace handler looks like on the inside. +

    + [%- END %] [% WRAPPER subsection @@ -1490,7 +1589,7 @@ [% WRAPPER section title="VERSION" -%]

    -Template Toolkit version 2.07a, released on 05 July 2002. +Template Toolkit version 2.07b, released on 07 July 2002.

    [%- END %] [% WRAPPER section diff --git a/docs/src/Manual/Credits.html b/docs/src/Manual/Credits.html index ae69a2f80..6d46436dd 100644 --- a/docs/src/Manual/Credits.html +++ b/docs/src/Manual/Credits.html @@ -156,7 +156,7 @@ [% WRAPPER section title="VERSION" -%]

    -Template Toolkit version 2.07a, released on 05 July 2002. +Template Toolkit version 2.07b, released on 07 July 2002.

    [%- END %] [% WRAPPER section diff --git a/docs/src/Manual/Directives.html b/docs/src/Manual/Directives.html index 2671da93f..2613cffdc 100644 --- a/docs/src/Manual/Directives.html +++ b/docs/src/Manual/Directives.html @@ -1948,7 +1948,7 @@ [% WRAPPER section title="VERSION" -%]

    -Template Toolkit version 2.07a, released on 05 July 2002. +Template Toolkit version 2.07b, released on 07 July 2002.

    [%- END %] [% WRAPPER section diff --git a/docs/src/Manual/Filters.html b/docs/src/Manual/Filters.html index 92ab0dfeb..3bc8a231c 100644 --- a/docs/src/Manual/Filters.html +++ b/docs/src/Manual/Filters.html @@ -513,7 +513,7 @@ [% WRAPPER section title="VERSION" -%]

    -Template Toolkit version 2.07a, released on 05 July 2002. +Template Toolkit version 2.07b, released on 07 July 2002.

    [%- END %] [% WRAPPER section diff --git a/docs/src/Manual/Internals.html b/docs/src/Manual/Internals.html index c5b96ec97..d23cea497 100644 --- a/docs/src/Manual/Internals.html +++ b/docs/src/Manual/Internals.html @@ -544,7 +544,7 @@ [% WRAPPER section title="VERSION" -%]

    -Template Toolkit version 2.07a, released on 05 July 2002. +Template Toolkit version 2.07b, released on 07 July 2002.

    [%- END %] [% WRAPPER section diff --git a/docs/src/Manual/Intro.html b/docs/src/Manual/Intro.html index d44631177..965b2ea42 100644 --- a/docs/src/Manual/Intro.html +++ b/docs/src/Manual/Intro.html @@ -267,7 +267,7 @@ [% WRAPPER section title="VERSION" -%]

    -Template Toolkit version 2.07a, released on 05 July 2002. +Template Toolkit version 2.07b, released on 07 July 2002.

    [%- END %] [% WRAPPER section diff --git a/docs/src/Manual/Plugins.html b/docs/src/Manual/Plugins.html index 73548599f..4d574ea48 100644 --- a/docs/src/Manual/Plugins.html +++ b/docs/src/Manual/Plugins.html @@ -567,7 +567,7 @@ [% WRAPPER section title="VERSION" -%]

    -Template Toolkit version 2.07a, released on 05 July 2002. +Template Toolkit version 2.07b, released on 07 July 2002.

    [%- END %] [% WRAPPER section diff --git a/docs/src/Manual/Refs.html b/docs/src/Manual/Refs.html index c977385f7..2c588f35d 100644 --- a/docs/src/Manual/Refs.html +++ b/docs/src/Manual/Refs.html @@ -128,7 +128,7 @@ [% WRAPPER section title="VERSION" -%]

    -Template Toolkit version 2.07a, released on 05 July 2002. +Template Toolkit version 2.07b, released on 07 July 2002.

    [%- END %] [% WRAPPER section diff --git a/docs/src/Manual/Syntax.html b/docs/src/Manual/Syntax.html index 0e65a046b..8669ea42f 100644 --- a/docs/src/Manual/Syntax.html +++ b/docs/src/Manual/Syntax.html @@ -285,7 +285,7 @@ [% WRAPPER section title="VERSION" -%]

    -Template Toolkit version 2.07a, released on 05 July 2002. +Template Toolkit version 2.07b, released on 07 July 2002.

    [%- END %] [% WRAPPER section diff --git a/docs/src/Manual/Variables.html b/docs/src/Manual/Variables.html index ab22d3c4c..3d4d92044 100644 --- a/docs/src/Manual/Variables.html +++ b/docs/src/Manual/Variables.html @@ -28,6 +28,7 @@ "Compound Variables", "Variable Interpolation", "Local and Global Variables", + "Compile Time Constant Folding", "Special Variables" ]; PROCESS tocitem @@ -808,13 +809,13 @@ The upshot is that you can continue to use existing Perl modules or code that returns lists of items, without having to refactor it just to keep the Template Toolkit happy (by returning references -to list). Class::DBI module is just one example of a paricularly +to list). Class::DBI module is just one example of a particularly useful module which returns values this way.

    If only a single item is returned from a subroutine then the Template Toolkit assumes it meant to return a single item (rather -than a list of 1 items) and leaves it well alone, returning the +than a list of 1 item) and leaves it well alone, returning the single value as it is. If you're executing a database query, for example, you might get 1 item returned, or perhaps many items which are then folded into a list. @@ -838,8 +839,8 @@ [% tt_start_tag %] something.reverse.join(', ') [% tt_end_tag %]

    Note that this is very much a last-ditch behaviour. If the single -item return is an object with a 'first' method, then that will be -called, as expected, in preference to the list virtual method. +item return is an object with a 'first' method, for example, then that +will be called, as expected, in preference to the list virtual method.

    [%- END %] [% WRAPPER subsection @@ -1000,6 +1001,85 @@ 

        [% tt_start_tag %] global.version = 123 [% tt_end_tag %]
    [%- END %] +[% WRAPPER subsection + title = "Compile Time Constant Folding" +-%]

    +In addition to variables that get resolved each time a template is +processed, you can also define variables that get resolved just once +when the template is compiled. This generally results in templates +processing faster because there is less work to be done. +

    +

    +To define compile-time constants, specify a CONSTANTS hash as a +constructor item as per VARIABLES. The CONSTANTS hash can contain any +kind of complex, nested, or dynamic data structures, just like regular +variables. +

    +
        my $tt = Template->new({
+	CONSTANTS => {
+	    version => 3.14,
+	    release => 'skyrocket',
+	    col     => {
+		back => '#ffffff',
+		fore => '#000000',
+	    },
+	    myobj => My::Object->new(),
+	    mysub => sub { ... },
+	    joint => ', ',
+	},
+    });
    +

    +Within a template, you access these variables using the 'constants' +namespace prefix. +

    +
        Version [% tt_start_tag %] constants.version [% tt_end_tag %] ([% tt_start_tag %] constants.release [% tt_end_tag %])
    +
        Background: [% tt_start_tag %] constants.col.back [% tt_end_tag %]
    +

    +When the template is compiled, these variable references are replaced +with the corresponding value. No further variable lookup is then +required when the template is processed. +

    +

    +You can call subroutines, object methods, and even virtual methods on +constant variables. +

    +
        [% tt_start_tag %] constants.mysub(10, 20) [% tt_end_tag %]
+    [% tt_start_tag %] constants.myobj(30, 40) [% tt_end_tag %]
+    [% tt_start_tag %] constants.col.keys.sort.join(', ') [% tt_end_tag %]
    +

    +One important proviso is that any arguments you pass to subroutines +or methods must also be literal values or compile time constants. +

    +

    +For example, these are both fine: +

    +
        # literal argument
+    [% tt_start_tag %] constants.col.keys.sort.join(', ') [% tt_end_tag %]
    +
        # constant argument
+    [% tt_start_tag %] constants.col.keys.sort.join(constants.joint) [% tt_end_tag %]
    +

    +But this next example will raise an error at parse time because +'joint' is a runtime variable and cannot be determined at compile +time. +

    +
        # ERROR: runtime variable argument!
+    [% tt_start_tag %] constants.col.keys.sort.join(joint) [% tt_end_tag %]
    +

    +The CONSTANTS_NAMESPACE option can be used to provide a different +namespace prefix for constant variables. For example: +

    +
        my $tt = Template->new({
+	CONSTANTS => {
+	    version => 3.14,
+	    # ...etc...
+	},
+	CONSTANTS_NAMESPACE => 'const',
+    });
    +

    +Constants would then be referenced in templates as: +

    +
        [% tt_start_tag %] const.version [% tt_end_tag %]
    +[%- END %] [% WRAPPER subsection title = "Special Variables" -%]

    @@ -1109,7 +1189,7 @@ [% WRAPPER section title="VERSION" -%]

    -Template Toolkit version 2.07a, released on 05 July 2002. +Template Toolkit version 2.07b, released on 07 July 2002.

    [%- END %] [% WRAPPER section diff --git a/docs/src/Manual/Views.html b/docs/src/Manual/Views.html index 1df96cb50..b10ffd1fc 100644 --- a/docs/src/Manual/Views.html +++ b/docs/src/Manual/Views.html @@ -617,7 +617,7 @@ [% WRAPPER section title="VERSION" -%]

    -Template Toolkit version 2.07a, released on 05 July 2002. +Template Toolkit version 2.07b, released on 07 July 2002.

    [%- END %] [% WRAPPER section diff --git a/docs/src/Modules/Template.html b/docs/src/Modules/Template.html index dd567cb32..97016c617 100644 --- a/docs/src/Modules/Template.html +++ b/docs/src/Modules/Template.html @@ -768,7 +768,7 @@ [% WRAPPER section title="VERSION" -%]

    -Template Toolkit version 2.07a, released on 05 July 2002. +Template Toolkit version 2.07b, released on 07 July 2002.

    [%- END %] [% WRAPPER section diff --git a/docs/src/Modules/Template/Base.html b/docs/src/Modules/Template/Base.html index 4de4b2d5e..be419084e 100644 --- a/docs/src/Modules/Template/Base.html +++ b/docs/src/Modules/Template/Base.html @@ -114,8 +114,8 @@ [% WRAPPER section title="VERSION" -%]

    -2.49, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.50, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002.

    [%- END %] [% WRAPPER section diff --git a/docs/src/Modules/Template/Config.html b/docs/src/Modules/Template/Config.html index c7c9ffdbc..69e9492a7 100644 --- a/docs/src/Modules/Template/Config.html +++ b/docs/src/Modules/Template/Config.html @@ -160,8 +160,8 @@ [% WRAPPER section title="VERSION" -%]

    -2.48, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.50, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002.

    [%- END %] [% WRAPPER section diff --git a/docs/src/Modules/Template/Constants.html b/docs/src/Modules/Template/Constants.html index f65d9af5d..d9f71c63e 100644 --- a/docs/src/Modules/Template/Constants.html +++ b/docs/src/Modules/Template/Constants.html @@ -103,8 +103,8 @@ [% WRAPPER section title="VERSION" -%]

    -2.48, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.49, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002.

    [%- END %] [% WRAPPER section diff --git a/docs/src/Modules/Template/Context.html b/docs/src/Modules/Template/Context.html index c20b153f1..aa487a15d 100644 --- a/docs/src/Modules/Template/Context.html +++ b/docs/src/Modules/Template/Context.html @@ -632,8 +632,8 @@ [% WRAPPER section title="VERSION" -%]

    -2.60, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.61, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002.

    [%- END %] [% WRAPPER section diff --git a/docs/src/Modules/Template/Document.html b/docs/src/Modules/Template/Document.html index acf1b04fa..3b32035ec 100644 --- a/docs/src/Modules/Template/Document.html +++ b/docs/src/Modules/Template/Document.html @@ -212,8 +212,8 @@ [% WRAPPER section title="VERSION" -%]

    -2.50, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.51, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002.

    [%- END %] [% WRAPPER section diff --git a/docs/src/Modules/Template/Exception.html b/docs/src/Modules/Template/Exception.html index d3cf197ee..eab84809f 100644 --- a/docs/src/Modules/Template/Exception.html +++ b/docs/src/Modules/Template/Exception.html @@ -91,8 +91,8 @@ [% WRAPPER section title="VERSION" -%]

    -2.45, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.46, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002.

    [%- END %] [% WRAPPER section diff --git a/docs/src/Modules/Template/Filters.html b/docs/src/Modules/Template/Filters.html index c08715baf..45f21fbb7 100644 --- a/docs/src/Modules/Template/Filters.html +++ b/docs/src/Modules/Template/Filters.html @@ -703,8 +703,8 @@ [% WRAPPER section title="VERSION" -%]

    -2.53, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.54, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002.

    [%- END %] [% WRAPPER section diff --git a/docs/src/Modules/Template/Iterator.html b/docs/src/Modules/Template/Iterator.html index 10c591141..a749b5caf 100644 --- a/docs/src/Modules/Template/Iterator.html +++ b/docs/src/Modules/Template/Iterator.html @@ -241,8 +241,8 @@ [% WRAPPER section title="VERSION" -%]

    -2.47, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.48, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002.

    [%- END %] [% WRAPPER section diff --git a/docs/src/Modules/Template/Parser.html b/docs/src/Modules/Template/Parser.html index 229c13ed6..c7fb095cb 100644 --- a/docs/src/Modules/Template/Parser.html +++ b/docs/src/Modules/Template/Parser.html @@ -452,8 +452,8 @@ [% WRAPPER section title="VERSION" -%]

    -2.58, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.61, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002.
    [%- END %] diff --git a/docs/src/Modules/Template/Plugin.html b/docs/src/Modules/Template/Plugin.html index 4bf8f98b9..27ce407f0 100644 --- a/docs/src/Modules/Template/Plugin.html +++ b/docs/src/Modules/Template/Plugin.html @@ -242,8 +242,8 @@ [% WRAPPER section title="VERSION" -%]

    -2.48, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.49, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002.

    [%- END %] [% WRAPPER section diff --git a/docs/src/Modules/Template/Plugin/Autoformat.html b/docs/src/Modules/Template/Plugin/Autoformat.html index 9b9eebb73..dbd4d8137 100644 --- a/docs/src/Modules/Template/Plugin/Autoformat.html +++ b/docs/src/Modules/Template/Plugin/Autoformat.html @@ -154,8 +154,8 @@ [% WRAPPER section title="VERSION" -%]

    -2.47, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.48, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002.

    [%- END %] [% WRAPPER section diff --git a/docs/src/Modules/Template/Plugin/CGI.html b/docs/src/Modules/Template/Plugin/CGI.html index 35378de36..e91c2410d 100644 --- a/docs/src/Modules/Template/Plugin/CGI.html +++ b/docs/src/Modules/Template/Plugin/CGI.html @@ -82,8 +82,8 @@ [% WRAPPER section title="VERSION" -%]

    -2.46, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.47, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002.

    [%- END %] [% WRAPPER section diff --git a/docs/src/Modules/Template/Plugin/DBI.html b/docs/src/Modules/Template/Plugin/DBI.html index ccf698399..b45f97862 100644 --- a/docs/src/Modules/Template/Plugin/DBI.html +++ b/docs/src/Modules/Template/Plugin/DBI.html @@ -443,8 +443,8 @@ [% WRAPPER section title="VERSION" -%]

    -2.43, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.44, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002.

    [%- END %] [% WRAPPER section diff --git a/docs/src/Modules/Template/Plugin/Datafile.html b/docs/src/Modules/Template/Plugin/Datafile.html index 57ec181f1..9e1919ce9 100644 --- a/docs/src/Modules/Template/Plugin/Datafile.html +++ b/docs/src/Modules/Template/Plugin/Datafile.html @@ -104,8 +104,8 @@ [% WRAPPER section title="VERSION" -%]

    -2.49, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.50, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002.

    [%- END %] [% WRAPPER section diff --git a/docs/src/Modules/Template/Plugin/Date.html b/docs/src/Modules/Template/Plugin/Date.html index 1b6cdae30..b2a0d4666 100644 --- a/docs/src/Modules/Template/Plugin/Date.html +++ b/docs/src/Modules/Template/Plugin/Date.html @@ -155,8 +155,8 @@ [% WRAPPER section title="VERSION" -%]

    -2.49, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.50, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002.

    [%- END %] [% WRAPPER section diff --git a/docs/src/Modules/Template/Plugin/Directory.html b/docs/src/Modules/Template/Plugin/Directory.html index 4d04d2d0c..dce22fdc3 100644 --- a/docs/src/Modules/Template/Plugin/Directory.html +++ b/docs/src/Modules/Template/Plugin/Directory.html @@ -246,8 +246,8 @@ [% WRAPPER section title="VERSION" -%]

    -2.46, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.47, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002.

    [%- END %] [% WRAPPER section diff --git a/docs/src/Modules/Template/Plugin/Dumper.html b/docs/src/Modules/Template/Plugin/Dumper.html index d7e70bf8b..b6fe2942e 100644 --- a/docs/src/Modules/Template/Plugin/Dumper.html +++ b/docs/src/Modules/Template/Plugin/Dumper.html @@ -103,8 +103,8 @@ [% WRAPPER section title="VERSION" -%]

    -2.46, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.47, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002.

    [%- END %] [% WRAPPER section diff --git a/docs/src/Modules/Template/Plugin/File.html b/docs/src/Modules/Template/Plugin/File.html index 15ffbb362..2830dba30 100644 --- a/docs/src/Modules/Template/Plugin/File.html +++ b/docs/src/Modules/Template/Plugin/File.html @@ -267,8 +267,8 @@ [% WRAPPER section title="VERSION" -%]

    -2.46, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.47, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002.

    [%- END %] [% WRAPPER section diff --git a/docs/src/Modules/Template/Plugin/Format.html b/docs/src/Modules/Template/Plugin/Format.html index b8e90562c..ef6b9ceac 100644 --- a/docs/src/Modules/Template/Plugin/Format.html +++ b/docs/src/Modules/Template/Plugin/Format.html @@ -61,8 +61,8 @@ [% WRAPPER section title="VERSION" -%]

    -2.47, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.48, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002.

    [%- END %] [% WRAPPER section diff --git a/docs/src/Modules/Template/Plugin/GD/Constants.html b/docs/src/Modules/Template/Plugin/GD/Constants.html index 85834f072..57d43b059 100644 --- a/docs/src/Modules/Template/Plugin/GD/Constants.html +++ b/docs/src/Modules/Template/Plugin/GD/Constants.html @@ -80,8 +80,8 @@ [% WRAPPER section title="VERSION" -%]

    -1.38, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +1.39, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002.

    [%- END %] [% WRAPPER section diff --git a/docs/src/Modules/Template/Plugin/GD/Graph/area.html b/docs/src/Modules/Template/Plugin/GD/Graph/area.html index f287eab35..0fe7914c4 100644 --- a/docs/src/Modules/Template/Plugin/GD/Graph/area.html +++ b/docs/src/Modules/Template/Plugin/GD/Graph/area.html @@ -84,8 +84,8 @@ [% WRAPPER section title="VERSION" -%]

    -1.38, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +1.39, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002.

    [%- END %] [% WRAPPER section diff --git a/docs/src/Modules/Template/Plugin/GD/Graph/bars.html b/docs/src/Modules/Template/Plugin/GD/Graph/bars.html index 0944cd686..cb4d620a4 100644 --- a/docs/src/Modules/Template/Plugin/GD/Graph/bars.html +++ b/docs/src/Modules/Template/Plugin/GD/Graph/bars.html @@ -120,8 +120,8 @@ [% WRAPPER section title="VERSION" -%]

    -1.38, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +1.39, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002.

    [%- END %] [% WRAPPER section diff --git a/docs/src/Modules/Template/Plugin/GD/Graph/bars3d.html b/docs/src/Modules/Template/Plugin/GD/Graph/bars3d.html index 1a9a67e2e..bc419bacc 100644 --- a/docs/src/Modules/Template/Plugin/GD/Graph/bars3d.html +++ b/docs/src/Modules/Template/Plugin/GD/Graph/bars3d.html @@ -101,8 +101,8 @@ [% WRAPPER section title="VERSION" -%]

    -1.38, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +1.39, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002.

    [%- END %] [% WRAPPER section diff --git a/docs/src/Modules/Template/Plugin/GD/Graph/lines.html b/docs/src/Modules/Template/Plugin/GD/Graph/lines.html index 6d480adeb..ac85a2317 100644 --- a/docs/src/Modules/Template/Plugin/GD/Graph/lines.html +++ b/docs/src/Modules/Template/Plugin/GD/Graph/lines.html @@ -109,8 +109,8 @@ [% WRAPPER section title="VERSION" -%]

    -1.38, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +1.39, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002.

    [%- END %] [% WRAPPER section diff --git a/docs/src/Modules/Template/Plugin/GD/Graph/lines3d.html b/docs/src/Modules/Template/Plugin/GD/Graph/lines3d.html index 2500f86ab..6c053e891 100644 --- a/docs/src/Modules/Template/Plugin/GD/Graph/lines3d.html +++ b/docs/src/Modules/Template/Plugin/GD/Graph/lines3d.html @@ -101,8 +101,8 @@ [% WRAPPER section title="VERSION" -%]

    -1.38, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +1.39, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002.

    [%- END %] [% WRAPPER section diff --git a/docs/src/Modules/Template/Plugin/GD/Graph/linespoints.html b/docs/src/Modules/Template/Plugin/GD/Graph/linespoints.html index 5468b8b47..6da91f25b 100644 --- a/docs/src/Modules/Template/Plugin/GD/Graph/linespoints.html +++ b/docs/src/Modules/Template/Plugin/GD/Graph/linespoints.html @@ -94,8 +94,8 @@ [% WRAPPER section title="VERSION" -%]

    -1.38, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +1.39, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002.

    [%- END %] [% WRAPPER section diff --git a/docs/src/Modules/Template/Plugin/GD/Graph/mixed.html b/docs/src/Modules/Template/Plugin/GD/Graph/mixed.html index 166291f9a..9a4b3b249 100644 --- a/docs/src/Modules/Template/Plugin/GD/Graph/mixed.html +++ b/docs/src/Modules/Template/Plugin/GD/Graph/mixed.html @@ -109,8 +109,8 @@ [% WRAPPER section title="VERSION" -%]

    -1.38, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +1.39, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002.

    [%- END %] [% WRAPPER section diff --git a/docs/src/Modules/Template/Plugin/GD/Graph/pie.html b/docs/src/Modules/Template/Plugin/GD/Graph/pie.html index 5d737beb0..70d79a3fb 100644 --- a/docs/src/Modules/Template/Plugin/GD/Graph/pie.html +++ b/docs/src/Modules/Template/Plugin/GD/Graph/pie.html @@ -82,8 +82,8 @@ [% WRAPPER section title="VERSION" -%]

    -1.38, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +1.39, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002.

    [%- END %] [% WRAPPER section diff --git a/docs/src/Modules/Template/Plugin/GD/Graph/pie3d.html b/docs/src/Modules/Template/Plugin/GD/Graph/pie3d.html index 9375cb283..64921e8b4 100644 --- a/docs/src/Modules/Template/Plugin/GD/Graph/pie3d.html +++ b/docs/src/Modules/Template/Plugin/GD/Graph/pie3d.html @@ -87,8 +87,8 @@ [% WRAPPER section title="VERSION" -%]

    -1.38, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +1.39, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002.

    [%- END %] [% WRAPPER section diff --git a/docs/src/Modules/Template/Plugin/GD/Graph/points.html b/docs/src/Modules/Template/Plugin/GD/Graph/points.html index 551690acf..c1518fc87 100644 --- a/docs/src/Modules/Template/Plugin/GD/Graph/points.html +++ b/docs/src/Modules/Template/Plugin/GD/Graph/points.html @@ -91,8 +91,8 @@ [% WRAPPER section title="VERSION" -%]

    -1.38, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +1.39, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002.

    [%- END %] [% WRAPPER section diff --git a/docs/src/Modules/Template/Plugin/GD/Image.html b/docs/src/Modules/Template/Plugin/GD/Image.html index 0c80009e7..17377b068 100644 --- a/docs/src/Modules/Template/Plugin/GD/Image.html +++ b/docs/src/Modules/Template/Plugin/GD/Image.html @@ -128,8 +128,8 @@ [% WRAPPER section title="VERSION" -%]

    -1.38, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +1.39, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002.

    [%- END %] [% WRAPPER section diff --git a/docs/src/Modules/Template/Plugin/GD/Polygon.html b/docs/src/Modules/Template/Plugin/GD/Polygon.html index 78d260301..87a9161d4 100644 --- a/docs/src/Modules/Template/Plugin/GD/Polygon.html +++ b/docs/src/Modules/Template/Plugin/GD/Polygon.html @@ -100,8 +100,8 @@ [% WRAPPER section title="VERSION" -%]

    -1.38, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +1.39, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002.

    [%- END %] [% WRAPPER section diff --git a/docs/src/Modules/Template/Plugin/GD/Text.html b/docs/src/Modules/Template/Plugin/GD/Text.html index e45cf206b..bd3ca7a90 100644 --- a/docs/src/Modules/Template/Plugin/GD/Text.html +++ b/docs/src/Modules/Template/Plugin/GD/Text.html @@ -81,8 +81,8 @@ [% WRAPPER section title="VERSION" -%]

    -1.38, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +1.39, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002.

    [%- END %] [% WRAPPER section diff --git a/docs/src/Modules/Template/Plugin/GD/Text/Align.html b/docs/src/Modules/Template/Plugin/GD/Text/Align.html index 4a37522a0..1c374cda7 100644 --- a/docs/src/Modules/Template/Plugin/GD/Text/Align.html +++ b/docs/src/Modules/Template/Plugin/GD/Text/Align.html @@ -86,8 +86,8 @@ [% WRAPPER section title="VERSION" -%]

    -1.38, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +1.39, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002.

    [%- END %] [% WRAPPER section diff --git a/docs/src/Modules/Template/Plugin/GD/Text/Wrap.html b/docs/src/Modules/Template/Plugin/GD/Text/Wrap.html index c144ac655..b648fb218 100644 --- a/docs/src/Modules/Template/Plugin/GD/Text/Wrap.html +++ b/docs/src/Modules/Template/Plugin/GD/Text/Wrap.html @@ -123,8 +123,8 @@ [% WRAPPER section title="VERSION" -%]

    -1.38, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +1.39, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002.

    [%- END %] [% WRAPPER section diff --git a/docs/src/Modules/Template/Plugin/HTML.html b/docs/src/Modules/Template/Plugin/HTML.html index 6889e5127..20e0ea996 100644 --- a/docs/src/Modules/Template/Plugin/HTML.html +++ b/docs/src/Modules/Template/Plugin/HTML.html @@ -119,8 +119,8 @@ [% WRAPPER section title="VERSION" -%]

    -2.39, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.40, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002.

    [%- END %] [% WRAPPER section diff --git a/docs/src/Modules/Template/Plugin/Iterator.html b/docs/src/Modules/Template/Plugin/Iterator.html index 253dccb08..66ba4fcc9 100644 --- a/docs/src/Modules/Template/Plugin/Iterator.html +++ b/docs/src/Modules/Template/Plugin/Iterator.html @@ -63,8 +63,8 @@ [% WRAPPER section title="VERSION" -%]

    -2.45, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.46, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002.

    [%- END %] [% WRAPPER section diff --git a/docs/src/Modules/Template/Plugin/Pod.html b/docs/src/Modules/Template/Plugin/Pod.html index 4762c9ce5..8495cda6f 100644 --- a/docs/src/Modules/Template/Plugin/Pod.html +++ b/docs/src/Modules/Template/Plugin/Pod.html @@ -61,8 +61,8 @@ [% WRAPPER section title="VERSION" -%]

    -2.44, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.45, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002.

    [%- END %] [% WRAPPER section diff --git a/docs/src/Modules/Template/Plugin/Table.html b/docs/src/Modules/Template/Plugin/Table.html index b68c8333f..5b4178f3d 100644 --- a/docs/src/Modules/Template/Plugin/Table.html +++ b/docs/src/Modules/Template/Plugin/Table.html @@ -218,8 +218,8 @@ [% WRAPPER section title="VERSION" -%]

    -2.47, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.48, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002.

    [%- END %] [% WRAPPER section diff --git a/docs/src/Modules/Template/Plugin/URL.html b/docs/src/Modules/Template/Plugin/URL.html index 1bcb719bd..cbb2b3420 100644 --- a/docs/src/Modules/Template/Plugin/URL.html +++ b/docs/src/Modules/Template/Plugin/URL.html @@ -130,8 +130,8 @@ [% WRAPPER section title="VERSION" -%]

    -2.47, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.48, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002.

    [%- END %] [% WRAPPER section diff --git a/docs/src/Modules/Template/Plugin/View.html b/docs/src/Modules/Template/Plugin/View.html index e543e57f3..db906171c 100644 --- a/docs/src/Modules/Template/Plugin/View.html +++ b/docs/src/Modules/Template/Plugin/View.html @@ -67,8 +67,8 @@ [% WRAPPER section title="VERSION" -%]

    -2.46, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.47, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002.

    [%- END %] [% WRAPPER section diff --git a/docs/src/Modules/Template/Plugin/Wrap.html b/docs/src/Modules/Template/Plugin/Wrap.html index b6c5c1815..9736621b1 100644 --- a/docs/src/Modules/Template/Plugin/Wrap.html +++ b/docs/src/Modules/Template/Plugin/Wrap.html @@ -100,8 +100,8 @@ [% WRAPPER section title="VERSION" -%]

    -2.46, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.47, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002.

    [%- END %] [% WRAPPER section diff --git a/docs/src/Modules/Template/Plugin/XML/DOM.html b/docs/src/Modules/Template/Plugin/XML/DOM.html index a63ffd693..a577e9987 100644 --- a/docs/src/Modules/Template/Plugin/XML/DOM.html +++ b/docs/src/Modules/Template/Plugin/XML/DOM.html @@ -419,7 +419,7 @@ title="VERSION" -%]

    2.6, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +Template Toolkit version 2.07b, released on 07 July 2002.

    [%- END %] [% WRAPPER section diff --git a/docs/src/Modules/Template/Plugin/XML/RSS.html b/docs/src/Modules/Template/Plugin/XML/RSS.html index 71c6fcd79..efbaac473 100644 --- a/docs/src/Modules/Template/Plugin/XML/RSS.html +++ b/docs/src/Modules/Template/Plugin/XML/RSS.html @@ -137,8 +137,8 @@ [% WRAPPER section title="VERSION" -%]

    -2.46, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.47, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002.

    [%- END %] [% WRAPPER section diff --git a/docs/src/Modules/Template/Plugin/XML/Simple.html b/docs/src/Modules/Template/Plugin/XML/Simple.html index 46c4eedbd..4d705a497 100644 --- a/docs/src/Modules/Template/Plugin/XML/Simple.html +++ b/docs/src/Modules/Template/Plugin/XML/Simple.html @@ -69,8 +69,8 @@ [% WRAPPER section title="VERSION" -%]

    -2.44, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.45, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002.

    [%- END %] [% WRAPPER section diff --git a/docs/src/Modules/Template/Plugin/XML/XPath.html b/docs/src/Modules/Template/Plugin/XML/XPath.html index dfad330d7..cf253288f 100644 --- a/docs/src/Modules/Template/Plugin/XML/XPath.html +++ b/docs/src/Modules/Template/Plugin/XML/XPath.html @@ -119,8 +119,8 @@ [% WRAPPER section title="VERSION" -%]

    -2.49, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.50, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002.

    [%- END %] [% WRAPPER section diff --git a/docs/src/Modules/Template/Plugins.html b/docs/src/Modules/Template/Plugins.html index de4239df6..e0740a588 100644 --- a/docs/src/Modules/Template/Plugins.html +++ b/docs/src/Modules/Template/Plugins.html @@ -779,8 +779,8 @@ [% WRAPPER section title="VERSION" -%]

    -2.52, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.53, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002.

    [%- END %] [% WRAPPER section diff --git a/docs/src/Modules/Template/Provider.html b/docs/src/Modules/Template/Provider.html index 8dddacb3b..b2a6ca332 100644 --- a/docs/src/Modules/Template/Provider.html +++ b/docs/src/Modules/Template/Provider.html @@ -374,8 +374,8 @@ [% WRAPPER section title="VERSION" -%]

    -2.53, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.54, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002.

    [%- END %] [% WRAPPER section diff --git a/docs/src/Modules/Template/Service.html b/docs/src/Modules/Template/Service.html index 7fa0761da..787a80d27 100644 --- a/docs/src/Modules/Template/Service.html +++ b/docs/src/Modules/Template/Service.html @@ -443,8 +443,8 @@ [% WRAPPER section title="VERSION" -%]

    -2.53, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.54, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002.

    [%- END %] [% WRAPPER section diff --git a/docs/src/Modules/Template/Stash.html b/docs/src/Modules/Template/Stash.html index 1dd4bce81..782637bfd 100644 --- a/docs/src/Modules/Template/Stash.html +++ b/docs/src/Modules/Template/Stash.html @@ -182,8 +182,8 @@ [% WRAPPER section title="VERSION" -%]

    -2.58, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.59, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002.

    [%- END %] [% WRAPPER section diff --git a/docs/src/Modules/Template/Stash/Context.html b/docs/src/Modules/Template/Stash/Context.html index 66049ffc3..00cafce77 100644 --- a/docs/src/Modules/Template/Stash/Context.html +++ b/docs/src/Modules/Template/Stash/Context.html @@ -116,8 +116,8 @@ [% WRAPPER section title="VERSION" -%]

    -1.41, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +1.42, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002.

    [%- END %] [% WRAPPER section diff --git a/docs/src/Modules/Template/Stash/XS.html b/docs/src/Modules/Template/Stash/XS.html index cc0250817..10640e331 100644 --- a/docs/src/Modules/Template/Stash/XS.html +++ b/docs/src/Modules/Template/Stash/XS.html @@ -141,7 +141,7 @@ [% WRAPPER section title="VERSION" -%]

    -Template Toolkit version 2.07a, released on 05 July 2002. +Template Toolkit version 2.07b, released on 07 July 2002.

    [%- END %] [% WRAPPER section diff --git a/docs/src/Modules/Template/Test.html b/docs/src/Modules/Template/Test.html index 8ac14ada4..d34fcdff0 100644 --- a/docs/src/Modules/Template/Test.html +++ b/docs/src/Modules/Template/Test.html @@ -296,8 +296,8 @@ [% WRAPPER section title="VERSION" -%]

    -2.49, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.50, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002.

    [%- END %] [% WRAPPER section diff --git a/docs/src/Modules/index.html b/docs/src/Modules/index.html index 894f1d7bb..3da4662b3 100644 --- a/docs/src/Modules/index.html +++ b/docs/src/Modules/index.html @@ -90,6 +90,14 @@ [% END %] +[% WRAPPER ndxitem + link = '../Modules/Template/Namespace/Constants.html' + name = 'Template::Namespace::Constants' + title = 'Compile time constant folding' +-%] + +[% END %] + [% WRAPPER ndxitem link = '../Modules/Template/Parser.html' name = 'Template::Parser' diff --git a/docs/src/Release/Changes.html b/docs/src/Release/Changes.html index ce01664d2..146a45326 100644 --- a/docs/src/Release/Changes.html +++ b/docs/src/Release/Changes.html @@ -7,7 +7,7 @@ # Changes # # DESCRIPTION -# Revision history for the Template Toolkit version 2.07a, detailing +# Revision history for the Template Toolkit version 2.07b, detailing # significant changes between versions, most recent first. Some # way down the file you'll find a section detailing major changes from # version 1.* to 2.* and a list of "Gotchas!" that you might have to @@ -27,7 +27,17 @@ #======================================================================== #------------------------------------------------------------------------ -# Version 2.07a - ## DEVELOPER RELEASE ## +# Version 2.07b - July 7th 2002 ## DEVELOPER RELEASE ## +#------------------------------------------------------------------------ + +* Added the CONSTANTS, CONSTANTS_NAMESPACE and NAMESPACE options, the + Template::Namespace::Constants module, documentation and t/constants.t + test suite. This adds support for compile-time constant folding and + other custom namespace handlers. + + +#------------------------------------------------------------------------ +# Version 2.07a - July 5th 2002 ## DEVELOPER RELEASE ## #------------------------------------------------------------------------ * Changed the Perl and XS stashes to automatically promote a scalar diff --git a/docs/src/Release/HACKING.html b/docs/src/Release/HACKING.html index f3a101bdc..b7dc904f3 100644 --- a/docs/src/Release/HACKING.html +++ b/docs/src/Release/HACKING.html @@ -5,9 +5,9 @@ Template Toolkit - Version 2.07a + Version 2.07b - 05 July 2002 + 07 July 2002 Copyright (C) 1996-2002 Andy Wardley. All Rights Reserved Copyright (C) 1998-2002 Canon Research Centre Europe Ltd. diff --git a/docs/src/Release/INSTALL.html b/docs/src/Release/INSTALL.html index 6e71d606d..e1ea917a4 100644 --- a/docs/src/Release/INSTALL.html +++ b/docs/src/Release/INSTALL.html @@ -5,9 +5,9 @@ Template Toolkit - Version 2.07a + Version 2.07b - 05 July 2002 + 07 July 2002 Copyright (C) 1996-2002 Andy Wardley. All Rights Reserved Copyright (C) 1998-2002 Canon Research Centre Europe Ltd. @@ -46,8 +46,8 @@ To install the Template Toolkit: - tar zxf Template-Toolkit-2.07a.tar.gz - cd Template-Toolkit-2.07a + tar zxf Template-Toolkit-2.07b.tar.gz + cd Template-Toolkit-2.07b perl Makefile.PL make make test @@ -133,19 +133,19 @@ Template-Toolkit-<version>.tar.gz -where <version> represents the current version number, e.g. 2.07a. +where <version> represents the current version number, e.g. 2.07b. To install the Template Toolkit, unpack the distribution archive to create an installation directory. Something like this: - tar zxf Template-Toolkit-2.07a.tar.gz + tar zxf Template-Toolkit-2.07b.tar.gz or - gunzip Template-Toolkit-2.07a.tar.gz - tar xf Template-Toolkit-2.07a.tar + gunzip Template-Toolkit-2.07b.tar.gz + tar xf Template-Toolkit-2.07b.tar You can then 'cd' into the directory created, - cd Template-Toolkit-2.07a + cd Template-Toolkit-2.07b and perform the usual Perl installation procedure: diff --git a/docs/src/Release/README.html b/docs/src/Release/README.html index 4ca03b58d..493b07e1e 100644 --- a/docs/src/Release/README.html +++ b/docs/src/Release/README.html @@ -5,9 +5,9 @@ Template Toolkit - Version 2.07a + Version 2.07b - 05 July 2002 + 07 July 2002 Copyright (C) 1996-2002 Andy Wardley. All Rights Reserved Copyright (C) 1998-2002 Canon Research Centre Europe Ltd. @@ -47,8 +47,8 @@ To install the Template Toolkit: - tar zxf Template-Toolkit-2.07a.tar.gz - cd Template-Toolkit-2.07a + tar zxf Template-Toolkit-2.07b.tar.gz + cd Template-Toolkit-2.07b perl Makefile.PL make make test @@ -107,7 +107,15 @@ WHAT'S NEW? ----------- -The most exciting new feature in version 2.05 is Doug Steinwand's +Version 2.08 adds compile time constant folding which can result in a +significant performance boost when processing templates. It also +offers several other minor enhancements and bug fixes. + +Version 2.07 was a major maintenance release, fixing numerous minor bugs +and smoothing out various rough edges. Version 2.06 was a very minor +bug release version. + +The most exciting new feature in version 2.05 was Doug Steinwand's high-speed drop-in replacement for Template::Stash written in Perl XS. With this in place, the Template Toolkit typically runs twice as fast as before! @@ -115,7 +123,7 @@ Pretty much everything else in 2.05 and 2.04 before it consisted of minor bug fixes and improvements. -Version 2.03 includes Craig Barratt's 'latex' filter and GD plugins +Version 2.03 included Craig Barratt's 'latex' filter and GD plugins and Dave Cross's tutorial on using the Template Toolkit for creating and reusing XML data files. @@ -340,7 +348,7 @@ --------------------- In terms of the template language and features available, versions -2.01 through to 2.07a should be fully backwardly compatible with +2.01 through to 2.07b should be fully backwardly compatible with version 2.00. Version 2.00 is backwardly compatible with version 1 in all but a few diff --git a/docs/src/Release/TODO.html b/docs/src/Release/TODO.html index eaa98a921..91f8c5473 100644 --- a/docs/src/Release/TODO.html +++ b/docs/src/Release/TODO.html @@ -7,7 +7,7 @@ # TODO # # DESCRIPTION -# TODO list for the Template Toolkit version 2.07a, containing +# TODO list for the Template Toolkit version 2.07b, containing # known bugs, limitations, planned enhancements, long term visions # and a few whacky ideas. # diff --git a/docs/src/Tools/tpage.html b/docs/src/Tools/tpage.html index 6dfde9882..0a8be7918 100644 --- a/docs/src/Tools/tpage.html +++ b/docs/src/Tools/tpage.html @@ -73,8 +73,8 @@ [% WRAPPER section title="VERSION" -%]

    -2.49, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.50, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002.

    [%- END %] [% WRAPPER section diff --git a/docs/src/Tools/ttree.html b/docs/src/Tools/ttree.html index bfeb49689..7f096dd3f 100644 --- a/docs/src/Tools/ttree.html +++ b/docs/src/Tools/ttree.html @@ -124,8 +124,8 @@ [% WRAPPER section title="VERSION" -%]

    -2.49, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.50, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002.

    [%- END %] [% WRAPPER section diff --git a/docs/src/Tutorial/Datafile.html b/docs/src/Tutorial/Datafile.html index 5ac6f31c1..7ab33af00 100644 --- a/docs/src/Tutorial/Datafile.html +++ b/docs/src/Tutorial/Datafile.html @@ -440,7 +440,7 @@ [% WRAPPER section title="VERSION" -%]

    -Template Toolkit version 2.07a, released on 05 July 2002. +Template Toolkit version 2.07b, released on 07 July 2002.

    [%- END %] [% WRAPPER section diff --git a/docs/src/Tutorial/Web.html b/docs/src/Tutorial/Web.html index fb2c57ba1..d84696415 100644 --- a/docs/src/Tutorial/Web.html +++ b/docs/src/Tutorial/Web.html @@ -783,7 +783,7 @@ [% WRAPPER section title="VERSION" -%]

    -Template Toolkit version 2.07a, released on 05 July 2002. +Template Toolkit version 2.07b, released on 07 July 2002.

    [%- END %] [% WRAPPER section diff --git a/docsrc/pod/Template.pod b/docsrc/pod/Template.pod index ebd547522..254a4043e 100644 --- a/docsrc/pod/Template.pod +++ b/docsrc/pod/Template.pod @@ -705,7 +705,7 @@ L =head1 VERSION -Template Toolkit version 2.07a, released on 05 July 2002. +Template Toolkit version 2.07b, released on 07 July 2002. =head1 COPYRIGHT diff --git a/lib/Template.pm b/lib/Template.pm index 375c6bf96..a693ea320 100644 --- a/lib/Template.pm +++ b/lib/Template.pm @@ -898,7 +898,7 @@ L =head1 VERSION -Template Toolkit version 2.07a, released on 05 July 2002. +Template Toolkit version 2.07b, released on 07 July 2002. =head1 COPYRIGHT diff --git a/lib/Template/Base.pm b/lib/Template/Base.pm index e022ac996..2982c3477 100644 --- a/lib/Template/Base.pm +++ b/lib/Template/Base.pm @@ -215,8 +215,8 @@ L =head1 VERSION -2.49, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.50, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002. =head1 COPYRIGHT diff --git a/lib/Template/Config.pm b/lib/Template/Config.pm index 95585f3db..c9674569a 100644 --- a/lib/Template/Config.pm +++ b/lib/Template/Config.pm @@ -414,8 +414,8 @@ L =head1 VERSION -2.48, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.50, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002. =head1 COPYRIGHT @@ -427,4 +427,4 @@ modify it under the same terms as Perl itself. =head1 SEE ALSO -L +L \ No newline at end of file diff --git a/lib/Template/Constants.pm b/lib/Template/Constants.pm index f37c285b6..551f6b455 100644 --- a/lib/Template/Constants.pm +++ b/lib/Template/Constants.pm @@ -162,8 +162,8 @@ L =head1 VERSION -2.48, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.49, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002. =head1 COPYRIGHT diff --git a/lib/Template/Context.pm b/lib/Template/Context.pm index a2690c65e..9265f4261 100644 --- a/lib/Template/Context.pm +++ b/lib/Template/Context.pm @@ -1439,8 +1439,8 @@ L =head1 VERSION -2.60, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.61, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002. =head1 COPYRIGHT @@ -1452,4 +1452,4 @@ modify it under the same terms as Perl itself. =head1 SEE ALSO -L, L, L, L, L, L, L, L \ No newline at end of file +L, L, L, L, L, L, L, L diff --git a/lib/Template/Document.pm b/lib/Template/Document.pm index 3c6ceec3b..abfcb3351 100644 --- a/lib/Template/Document.pm +++ b/lib/Template/Document.pm @@ -466,8 +466,8 @@ L =head1 VERSION -2.50, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.51, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002. =head1 COPYRIGHT diff --git a/lib/Template/Exception.pm b/lib/Template/Exception.pm index 198897ea3..d47a6e6b4 100644 --- a/lib/Template/Exception.pm +++ b/lib/Template/Exception.pm @@ -228,8 +228,8 @@ L =head1 VERSION -2.45, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.46, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002. =head1 COPYRIGHT diff --git a/lib/Template/FAQ.pod b/lib/Template/FAQ.pod index 8cb0353a4..49f73a853 100644 --- a/lib/Template/FAQ.pod +++ b/lib/Template/FAQ.pod @@ -18,7 +18,7 @@ # modify it under the same terms as Perl itself. # # REVISION -# 2.49 +# 2.50 # #======================================================================== @@ -294,8 +294,8 @@ L =head1 VERSION -2.49, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.50, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002. =head1 COPYRIGHT diff --git a/lib/Template/Filters.pm b/lib/Template/Filters.pm index 5a3ada3a2..99a738c64 100644 --- a/lib/Template/Filters.pm +++ b/lib/Template/Filters.pm @@ -1340,8 +1340,8 @@ L =head1 VERSION -2.53, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.54, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002. =head1 COPYRIGHT diff --git a/lib/Template/Iterator.pm b/lib/Template/Iterator.pm index 5d616f5b6..af277337d 100644 --- a/lib/Template/Iterator.pm +++ b/lib/Template/Iterator.pm @@ -430,8 +430,8 @@ L =head1 VERSION -2.47, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.48, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002. =head1 COPYRIGHT diff --git a/lib/Template/Library/HTML.pod b/lib/Template/Library/HTML.pod index f91acc3a5..f4a32fb3f 100644 --- a/lib/Template/Library/HTML.pod +++ b/lib/Template/Library/HTML.pod @@ -17,7 +17,7 @@ # modify it under the same terms as Perl itself. # # REVISION -# 2.49 +# 2.50 # #======================================================================== @@ -290,8 +290,8 @@ L =head1 VERSION -2.49, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.50, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002. =head1 COPYRIGHT diff --git a/lib/Template/Library/PostScript.pod b/lib/Template/Library/PostScript.pod index a0c937ee8..f80def3ab 100644 --- a/lib/Template/Library/PostScript.pod +++ b/lib/Template/Library/PostScript.pod @@ -17,7 +17,7 @@ # modify it under the same terms as Perl itself. # # REVISION -# 2.49 +# 2.50 # #======================================================================== @@ -54,8 +54,8 @@ L =head1 VERSION -2.49, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.50, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002. =head1 COPYRIGHT diff --git a/lib/Template/Library/Splash.pod b/lib/Template/Library/Splash.pod index 534b9419c..c2487c1c3 100644 --- a/lib/Template/Library/Splash.pod +++ b/lib/Template/Library/Splash.pod @@ -18,7 +18,7 @@ # modify it under the same terms as Perl itself. # # REVISION -# 2.49 +# 2.50 # #======================================================================== @@ -1004,8 +1004,8 @@ L =head1 VERSION -2.49, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.50, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002. =head1 COPYRIGHT diff --git a/lib/Template/Manual.pod b/lib/Template/Manual.pod index 2de22a674..4110f428d 100644 --- a/lib/Template/Manual.pod +++ b/lib/Template/Manual.pod @@ -148,7 +148,7 @@ L =head1 VERSION -Template Toolkit version 2.07a, released on 05 July 2002. +Template Toolkit version 2.07b, released on 07 July 2002. =head1 COPYRIGHT diff --git a/lib/Template/Manual/Config.pod b/lib/Template/Manual/Config.pod index 99b82167d..7b6322a52 100644 --- a/lib/Template/Manual/Config.pod +++ b/lib/Template/Manual/Config.pod @@ -536,6 +536,108 @@ or + +=item CONSTANTS + +The CONSTANTS option can be used to specify a hash array of template +variables that are compile-time constants. These variables are +resolved once when the template is compiled, and thus don't require +further resolution at runtime. This results in significantly faster +processing of the compiled templates and can be used for variables that +don't change from one request to the next. + + my $template = Template->new({ + CONSTANTS => { + title => 'A Demo Page', + author => 'Joe Random Hacker', + version => 3.14, + }, + }; + +=item CONSTANT_NAMESPACE + +Constant variables are accessed via the 'constants' namespace by +default. + + [% constants.title %] + +The CONSTANTS_NAMESPACE option can be set to specify an alternate +namespace. + + my $template = Template->new({ + CONSTANTS => { + title => 'A Demo Page', + # ...etc... + }, + CONSTANTS_NAMESPACE => 'const', + }; + +In this case the constants would then be accessed as: + + [% const.title %] + +=item NAMESPACE + +The constant folding mechanism described above is an example of a +namespace handler. Namespace handlers can be defined to provide +alternate parsing mechanisms for variables in different namespaces. + +Under the hood, the Template module converts a constructor configuration +such as: + + my $template = Template->new({ + CONSTANTS => { + title => 'A Demo Page', + # ...etc... + }, + CONSTANTS_NAMESPACE => 'const', + }; + +into one like: + + my $template = Template->new({ + NAMESPACE => { + const => Template:::Namespace::Constants->new({ + title => 'A Demo Page', + # ...etc... + }), + }, + }; + +You can use this mechanism to define multiple constant namespaces, or +to install custom handlers of your own. + + my $template = Template->new({ + NAMESPACE => { + site => Template:::Namespace::Constants->new({ + title => "Wardley's Widgets", + version => 2.718, + }), + author => Template:::Namespace::Constants->new({ + name => 'Andy Wardley', + email => 'abw@andywardley.com', + }), + voodoo => My::Namespace::Handler->new( ... ), + }, + }; + +Now you have 2 constant namespaces, for example: + + [% site.title %] + [% author.name %] + +as well as your own custom namespace handler installed for the 'voodoo' +namespace. + + [% voodoo.magic %] + +See L +for an example of what a namespace handler looks like on the inside. + + + + + =back =head2 Runtime Processing Options @@ -1648,7 +1750,7 @@ L =head1 VERSION -Template Toolkit version 2.07a, released on 05 July 2002. +Template Toolkit version 2.07b, released on 07 July 2002. =head1 COPYRIGHT diff --git a/lib/Template/Manual/Credits.pod b/lib/Template/Manual/Credits.pod index 00f91010a..591a7df9b 100644 --- a/lib/Template/Manual/Credits.pod +++ b/lib/Template/Manual/Credits.pod @@ -154,7 +154,7 @@ L =head1 VERSION -Template Toolkit version 2.07a, released on 05 July 2002. +Template Toolkit version 2.07b, released on 07 July 2002. =head1 COPYRIGHT diff --git a/lib/Template/Manual/Directives.pod b/lib/Template/Manual/Directives.pod index fe656f5b8..7230e71b5 100644 --- a/lib/Template/Manual/Directives.pod +++ b/lib/Template/Manual/Directives.pod @@ -2095,7 +2095,7 @@ L =head1 VERSION -Template Toolkit version 2.07a, released on 05 July 2002. +Template Toolkit version 2.07b, released on 07 July 2002. =head1 COPYRIGHT diff --git a/lib/Template/Manual/Filters.pod b/lib/Template/Manual/Filters.pod index a6d8919e1..25fed32fe 100644 --- a/lib/Template/Manual/Filters.pod +++ b/lib/Template/Manual/Filters.pod @@ -467,7 +467,7 @@ L =head1 VERSION -Template Toolkit version 2.07a, released on 05 July 2002. +Template Toolkit version 2.07b, released on 07 July 2002. =head1 COPYRIGHT diff --git a/lib/Template/Manual/Internals.pod b/lib/Template/Manual/Internals.pod index 8d1db0a06..f45ad6edf 100644 --- a/lib/Template/Manual/Internals.pod +++ b/lib/Template/Manual/Internals.pod @@ -533,7 +533,7 @@ L =head1 VERSION -Template Toolkit version 2.07a, released on 05 July 2002. +Template Toolkit version 2.07b, released on 07 July 2002. =head1 COPYRIGHT diff --git a/lib/Template/Manual/Intro.pod b/lib/Template/Manual/Intro.pod index d2d404ce2..c6c7964ac 100644 --- a/lib/Template/Manual/Intro.pod +++ b/lib/Template/Manual/Intro.pod @@ -272,7 +272,7 @@ L =head1 VERSION -Template Toolkit version 2.07a, released on 05 July 2002. +Template Toolkit version 2.07b, released on 07 July 2002. =head1 COPYRIGHT diff --git a/lib/Template/Manual/Plugins.pod b/lib/Template/Manual/Plugins.pod index 46d16a185..45d0b1d43 100644 --- a/lib/Template/Manual/Plugins.pod +++ b/lib/Template/Manual/Plugins.pod @@ -529,7 +529,7 @@ L =head1 VERSION -Template Toolkit version 2.07a, released on 05 July 2002. +Template Toolkit version 2.07b, released on 07 July 2002. =head1 COPYRIGHT diff --git a/lib/Template/Manual/Refs.pod b/lib/Template/Manual/Refs.pod index da42f89b4..285b3476b 100644 --- a/lib/Template/Manual/Refs.pod +++ b/lib/Template/Manual/Refs.pod @@ -133,7 +133,7 @@ L =head1 VERSION -Template Toolkit version 2.07a, released on 05 July 2002. +Template Toolkit version 2.07b, released on 07 July 2002. =head1 COPYRIGHT diff --git a/lib/Template/Manual/Syntax.pod b/lib/Template/Manual/Syntax.pod index d57dc0196..0f577e941 100644 --- a/lib/Template/Manual/Syntax.pod +++ b/lib/Template/Manual/Syntax.pod @@ -283,7 +283,7 @@ L =head1 VERSION -Template Toolkit version 2.07a, released on 05 July 2002. +Template Toolkit version 2.07b, released on 07 July 2002. =head1 COPYRIGHT diff --git a/lib/Template/Manual/Variables.pod b/lib/Template/Manual/Variables.pod index 954686e9e..942f6deed 100644 --- a/lib/Template/Manual/Variables.pod +++ b/lib/Template/Manual/Variables.pod @@ -809,12 +809,12 @@ a list. The upshot is that you can continue to use existing Perl modules or code that returns lists of items, without having to refactor it just to keep the Template Toolkit happy (by returning references -to list). Class::DBI module is just one example of a paricularly +to list). Class::DBI module is just one example of a particularly useful module which returns values this way. If only a single item is returned from a subroutine then the Template Toolkit assumes it meant to return a single item (rather -than a list of 1 items) and leaves it well alone, returning the +than a list of 1 item) and leaves it well alone, returning the single value as it is. If you're executing a database query, for example, you might get 1 item returned, or perhaps many items which are then folded into a list. @@ -837,8 +837,8 @@ only get one item returned. For example: [% something.reverse.join(', ') %] Note that this is very much a last-ditch behaviour. If the single -item return is an object with a 'first' method, then that will be -called, as expected, in preference to the list virtual method. +item return is an object with a 'first' method, for example, then that +will be called, as expected, in preference to the list virtual method. =head2 Compound Variables @@ -997,6 +997,83 @@ hash are visible across all templates. [% global.version = 123 %] +=head2 Compile Time Constant Folding + +In addition to variables that get resolved each time a template is +processed, you can also define variables that get resolved just once +when the template is compiled. This generally results in templates +processing faster because there is less work to be done. + +To define compile-time constants, specify a CONSTANTS hash as a +constructor item as per VARIABLES. The CONSTANTS hash can contain any +kind of complex, nested, or dynamic data structures, just like regular +variables. + + my $tt = Template->new({ + CONSTANTS => { + version => 3.14, + release => 'skyrocket', + col => { + back => '#ffffff', + fore => '#000000', + }, + myobj => My::Object->new(), + mysub => sub { ... }, + joint => ', ', + }, + }); + +Within a template, you access these variables using the 'constants' +namespace prefix. + + Version [% constants.version %] ([% constants.release %]) + + Background: [% constants.col.back %] + +When the template is compiled, these variable references are replaced +with the corresponding value. No further variable lookup is then +required when the template is processed. + +You can call subroutines, object methods, and even virtual methods on +constant variables. + + [% constants.mysub(10, 20) %] + [% constants.myobj(30, 40) %] + [% constants.col.keys.sort.join(', ') %] + +One important proviso is that any arguments you pass to subroutines +or methods must also be literal values or compile time constants. + +For example, these are both fine: + + # literal argument + [% constants.col.keys.sort.join(', ') %] + + # constant argument + [% constants.col.keys.sort.join(constants.joint) %] + +But this next example will raise an error at parse time because +'joint' is a runtime variable and cannot be determined at compile +time. + + # ERROR: runtime variable argument! + [% constants.col.keys.sort.join(joint) %] + +The CONSTANTS_NAMESPACE option can be used to provide a different +namespace prefix for constant variables. For example: + + my $tt = Template->new({ + CONSTANTS => { + version => 3.14, + # ...etc... + }, + CONSTANTS_NAMESPACE => 'const', + }); + +Constants would then be referenced in templates as: + + [% const.version %] + =head2 Special Variables A number of special variables are automatically defined by the Template @@ -1102,7 +1179,7 @@ L =head1 VERSION -Template Toolkit version 2.07a, released on 05 July 2002. +Template Toolkit version 2.07b, released on 07 July 2002. =head1 COPYRIGHT diff --git a/lib/Template/Manual/Views.pod b/lib/Template/Manual/Views.pod index ef7e18c11..29502bef1 100644 --- a/lib/Template/Manual/Views.pod +++ b/lib/Template/Manual/Views.pod @@ -619,7 +619,7 @@ L =head1 VERSION -Template Toolkit version 2.07a, released on 05 July 2002. +Template Toolkit version 2.07b, released on 07 July 2002. =head1 COPYRIGHT diff --git a/lib/Template/Modules.pod b/lib/Template/Modules.pod index 70918ed16..ac55fff04 100644 --- a/lib/Template/Modules.pod +++ b/lib/Template/Modules.pod @@ -98,6 +98,12 @@ Data iterator used by the FOREACH directive +=item L + +Compile time constant folding + + + =item L LALR(1) parser for compiling template documents @@ -401,7 +407,7 @@ L =head1 VERSION -Template Toolkit version 2.07a, released on 05 July 2002. +Template Toolkit version 2.07b, released on 07 July 2002. =head1 COPYRIGHT diff --git a/lib/Template/Namespace/Constants.pm b/lib/Template/Namespace/Constants.pm index b01bf5d6e..3c808b3a1 100644 --- a/lib/Template/Namespace/Constants.pm +++ b/lib/Template/Namespace/Constants.pm @@ -86,3 +86,93 @@ sub ident { __END__ + +#------------------------------------------------------------------------ +# IMPORTANT NOTE +# This documentation is generated automatically from source +# templates. Any changes you make here may be lost. +# +# The 'docsrc' documentation source bundle is available for download +# from http://www.template-toolkit.org/docs.html and contains all +# the source templates, XML files, scripts, etc., from which the +# documentation for the Template Toolkit is built. +#------------------------------------------------------------------------ + +=head1 NAME + +Template::Namespace::Constants - Compile time constant folding + +=head1 SYNOPSIS + + # easy way to define constants + use Template; + + my $tt = Template->new({ + CONSTANTS => { + pi => 3.14, + e => 2.718, + }, + }); + + # nitty-gritty, hands-dirty way + use Template::Namespace::Constants; + + my $tt = Template->new({ + NAMESPACE => { + constants => Template::Namespace::Constants->new({ + pi => 3.14, + e => 2.718, + }, + }, + }); + +=head1 DESCRIPTION + +The Template::Namespace::Constants module implements a namespace handler +which is plugged into the Template::Directive compiler module. This then +performs compile time constant folding of variables in a particular namespace. + +=head1 PUBLIC METHODS + +=head2 new(\%constants) + +The new() constructor method creates and returns a reference to a new +Template::Namespace::Constants object. This creates an internal stash +to store the constant variable definitions passed as arguments. + + my $handler = Template::Namespace::Constants->new({ + pi => 3.14, + e => 2.718, + }); + +=head2 ident(\@ident) + +Method called to resolve a variable identifier into a compiled form. In this +case, the method fetches the corresponding constant value from its internal +stash and returns it. + +=head1 AUTHOR + +Andy Wardley Eabw@kfs.orgE + +L + + + + +=head1 VERSION + +1.02, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002. + +=head1 COPYRIGHT + + Copyright (C) 1996-2002 Andy Wardley. All Rights Reserved. + Copyright (C) 1998-2002 Canon Research Centre Europe Ltd. + +This module is free software; you can redistribute it and/or +modify it under the same terms as Perl itself. + +=head1 SEE ALSO + +L \ No newline at end of file diff --git a/lib/Template/Parser.pm b/lib/Template/Parser.pm index b11a53e32..a754646f0 100644 --- a/lib/Template/Parser.pm +++ b/lib/Template/Parser.pm @@ -1338,8 +1338,8 @@ L =head1 VERSION -2.58, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.61, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002. diff --git a/lib/Template/Plugin.pm b/lib/Template/Plugin.pm index 6c983b42c..672a62c23 100644 --- a/lib/Template/Plugin.pm +++ b/lib/Template/Plugin.pm @@ -383,8 +383,8 @@ L =head1 VERSION -2.48, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.49, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002. =head1 COPYRIGHT diff --git a/lib/Template/Plugin/Autoformat.pm b/lib/Template/Plugin/Autoformat.pm index b0bec6145..8c3d447c8 100644 --- a/lib/Template/Plugin/Autoformat.pm +++ b/lib/Template/Plugin/Autoformat.pm @@ -224,8 +224,8 @@ module (in his copious spare time :-) which does all the clever stuff. =head1 VERSION -2.47, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.48, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002. diff --git a/lib/Template/Plugin/CGI.pm b/lib/Template/Plugin/CGI.pm index 2bfe06ea6..4a99ff867 100644 --- a/lib/Template/Plugin/CGI.pm +++ b/lib/Template/Plugin/CGI.pm @@ -107,8 +107,8 @@ L =head1 VERSION -2.46, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.47, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002. =head1 COPYRIGHT diff --git a/lib/Template/Plugin/DBI.pm b/lib/Template/Plugin/DBI.pm index c44e25990..70bcd71f3 100755 --- a/lib/Template/Plugin/DBI.pm +++ b/lib/Template/Plugin/DBI.pm @@ -930,8 +930,8 @@ Andy Wardley, Craig Barratt, Dave Hodgkinson and Rafael Kitover. =head1 VERSION -2.43, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.44, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002. diff --git a/lib/Template/Plugin/Datafile.pm b/lib/Template/Plugin/Datafile.pm index 3a6c3cdbf..789015355 100644 --- a/lib/Template/Plugin/Datafile.pm +++ b/lib/Template/Plugin/Datafile.pm @@ -172,8 +172,8 @@ L =head1 VERSION -2.49, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.50, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002. =head1 COPYRIGHT diff --git a/lib/Template/Plugin/Date.pm b/lib/Template/Plugin/Date.pm index 527fc5bbd..b475cb76f 100644 --- a/lib/Template/Plugin/Date.pm +++ b/lib/Template/Plugin/Date.pm @@ -301,8 +301,8 @@ fixups/enhancements, a test script and documentation. =head1 VERSION -2.49, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.50, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002. diff --git a/lib/Template/Plugin/Directory.pm b/lib/Template/Plugin/Directory.pm index 9bd5eb166..683aeb7a7 100644 --- a/lib/Template/Plugin/Directory.pm +++ b/lib/Template/Plugin/Directory.pm @@ -394,8 +394,8 @@ for VIEW support, and made a few other minor tweaks. =head1 VERSION -2.46, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.47, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002. diff --git a/lib/Template/Plugin/Dumper.pm b/lib/Template/Plugin/Dumper.pm index 5feb953d5..95897a269 100644 --- a/lib/Template/Plugin/Dumper.pm +++ b/lib/Template/Plugin/Dumper.pm @@ -159,8 +159,8 @@ Simon Matthews Esam@knowledgepool.comE =head1 VERSION -2.46, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.47, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002. diff --git a/lib/Template/Plugin/File.pm b/lib/Template/Plugin/File.pm index 2b46e94ff..6c9bd69ea 100644 --- a/lib/Template/Plugin/File.pm +++ b/lib/Template/Plugin/File.pm @@ -400,8 +400,8 @@ for VIEW support, and made a few other minor tweaks. =head1 VERSION -2.46, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.47, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002. diff --git a/lib/Template/Plugin/Filter.pm b/lib/Template/Plugin/Filter.pm index 0bb8a1f24..7097358b9 100644 --- a/lib/Template/Plugin/Filter.pm +++ b/lib/Template/Plugin/Filter.pm @@ -409,8 +409,8 @@ L =head1 VERSION -1.13, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +1.14, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002. =head1 COPYRIGHT diff --git a/lib/Template/Plugin/Format.pm b/lib/Template/Plugin/Format.pm index 1bb5fb849..7a981e1dd 100644 --- a/lib/Template/Plugin/Format.pm +++ b/lib/Template/Plugin/Format.pm @@ -98,8 +98,8 @@ L =head1 VERSION -2.47, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.48, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002. =head1 COPYRIGHT diff --git a/lib/Template/Plugin/GD/Constants.pm b/lib/Template/Plugin/GD/Constants.pm index b3baeca84..2724b916e 100644 --- a/lib/Template/Plugin/GD/Constants.pm +++ b/lib/Template/Plugin/GD/Constants.pm @@ -110,8 +110,8 @@ Lincoln D. Stein wrote the GD.pm interface to the GD library. =head1 VERSION -1.38, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +1.39, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002. =head1 COPYRIGHT diff --git a/lib/Template/Plugin/GD/Graph/area.pm b/lib/Template/Plugin/GD/Graph/area.pm index 0d3f5d7dd..9980b6bfd 100644 --- a/lib/Template/Plugin/GD/Graph/area.pm +++ b/lib/Template/Plugin/GD/Graph/area.pm @@ -112,8 +112,8 @@ The GD::Graph module was written by Martien Verbruggen. =head1 VERSION -1.38, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +1.39, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002. =head1 COPYRIGHT diff --git a/lib/Template/Plugin/GD/Graph/bars.pm b/lib/Template/Plugin/GD/Graph/bars.pm index 435eb73fc..37e8bac28 100644 --- a/lib/Template/Plugin/GD/Graph/bars.pm +++ b/lib/Template/Plugin/GD/Graph/bars.pm @@ -155,8 +155,8 @@ The GD::Graph module was written by Martien Verbruggen. =head1 VERSION -1.38, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +1.39, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002. =head1 COPYRIGHT diff --git a/lib/Template/Plugin/GD/Graph/bars3d.pm b/lib/Template/Plugin/GD/Graph/bars3d.pm index d40f80320..12a577756 100644 --- a/lib/Template/Plugin/GD/Graph/bars3d.pm +++ b/lib/Template/Plugin/GD/Graph/bars3d.pm @@ -130,8 +130,8 @@ The GD::Graph3d module was written by Jeremy Wadsack. =head1 VERSION -1.38, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +1.39, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002. =head1 COPYRIGHT diff --git a/lib/Template/Plugin/GD/Graph/lines.pm b/lib/Template/Plugin/GD/Graph/lines.pm index e954a7339..78c58c2b6 100644 --- a/lib/Template/Plugin/GD/Graph/lines.pm +++ b/lib/Template/Plugin/GD/Graph/lines.pm @@ -142,8 +142,8 @@ The GD::Graph module was written by Martien Verbruggen. =head1 VERSION -1.38, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +1.39, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002. =head1 COPYRIGHT diff --git a/lib/Template/Plugin/GD/Graph/lines3d.pm b/lib/Template/Plugin/GD/Graph/lines3d.pm index a763d9ac5..0042fa450 100644 --- a/lib/Template/Plugin/GD/Graph/lines3d.pm +++ b/lib/Template/Plugin/GD/Graph/lines3d.pm @@ -130,8 +130,8 @@ The GD::Graph3d module was written by Jeremy Wadsack. =head1 VERSION -1.38, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +1.39, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002. =head1 COPYRIGHT diff --git a/lib/Template/Plugin/GD/Graph/linespoints.pm b/lib/Template/Plugin/GD/Graph/linespoints.pm index fe4a6e04f..87ac48670 100644 --- a/lib/Template/Plugin/GD/Graph/linespoints.pm +++ b/lib/Template/Plugin/GD/Graph/linespoints.pm @@ -122,8 +122,8 @@ The GD::Graph module was written by Martien Verbruggen. =head1 VERSION -1.38, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +1.39, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002. =head1 COPYRIGHT diff --git a/lib/Template/Plugin/GD/Graph/mixed.pm b/lib/Template/Plugin/GD/Graph/mixed.pm index bdc7850b5..5e792a145 100644 --- a/lib/Template/Plugin/GD/Graph/mixed.pm +++ b/lib/Template/Plugin/GD/Graph/mixed.pm @@ -140,8 +140,8 @@ The GD::Graph module was written by Martien Verbruggen. =head1 VERSION -1.38, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +1.39, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002. =head1 COPYRIGHT diff --git a/lib/Template/Plugin/GD/Graph/pie.pm b/lib/Template/Plugin/GD/Graph/pie.pm index 0025df03c..5e00bd615 100644 --- a/lib/Template/Plugin/GD/Graph/pie.pm +++ b/lib/Template/Plugin/GD/Graph/pie.pm @@ -113,8 +113,8 @@ The GD::Graph module was written by Martien Verbruggen. =head1 VERSION -1.38, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +1.39, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002. =head1 COPYRIGHT diff --git a/lib/Template/Plugin/GD/Graph/pie3d.pm b/lib/Template/Plugin/GD/Graph/pie3d.pm index 2e89c9da1..77b822935 100644 --- a/lib/Template/Plugin/GD/Graph/pie3d.pm +++ b/lib/Template/Plugin/GD/Graph/pie3d.pm @@ -117,8 +117,8 @@ The GD::Graph3d module was written by Jeremy Wadsack. The GD::Graph module was w =head1 VERSION -1.38, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +1.39, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002. =head1 COPYRIGHT diff --git a/lib/Template/Plugin/GD/Graph/points.pm b/lib/Template/Plugin/GD/Graph/points.pm index fe18d3894..8338a1418 100644 --- a/lib/Template/Plugin/GD/Graph/points.pm +++ b/lib/Template/Plugin/GD/Graph/points.pm @@ -119,8 +119,8 @@ The GD::Graph module was written by Martien Verbruggen. =head1 VERSION -1.38, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +1.39, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002. =head1 COPYRIGHT diff --git a/lib/Template/Plugin/GD/Image.pm b/lib/Template/Plugin/GD/Image.pm index e10f05fba..07f3e1fe0 100644 --- a/lib/Template/Plugin/GD/Image.pm +++ b/lib/Template/Plugin/GD/Image.pm @@ -156,8 +156,8 @@ Lincoln D. Stein wrote the GD.pm interface to the GD library. =head1 VERSION -1.38, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +1.39, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002. =head1 COPYRIGHT diff --git a/lib/Template/Plugin/GD/Polygon.pm b/lib/Template/Plugin/GD/Polygon.pm index 5425b747a..5ee313877 100644 --- a/lib/Template/Plugin/GD/Polygon.pm +++ b/lib/Template/Plugin/GD/Polygon.pm @@ -127,8 +127,8 @@ Lincoln D. Stein wrote the GD.pm interface to the GD library. =head1 VERSION -1.38, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +1.39, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002. =head1 COPYRIGHT diff --git a/lib/Template/Plugin/GD/Text.pm b/lib/Template/Plugin/GD/Text.pm index 2a0130b66..563a20631 100644 --- a/lib/Template/Plugin/GD/Text.pm +++ b/lib/Template/Plugin/GD/Text.pm @@ -112,8 +112,8 @@ The GD::Text module was written by Martien Verbruggen. =head1 VERSION -1.38, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +1.39, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002. =head1 COPYRIGHT diff --git a/lib/Template/Plugin/GD/Text/Align.pm b/lib/Template/Plugin/GD/Text/Align.pm index 39f724ed5..5eb57731e 100644 --- a/lib/Template/Plugin/GD/Text/Align.pm +++ b/lib/Template/Plugin/GD/Text/Align.pm @@ -119,8 +119,8 @@ The GD::Text module was written by Martien Verbruggen. =head1 VERSION -1.38, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +1.39, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002. =head1 COPYRIGHT diff --git a/lib/Template/Plugin/GD/Text/Wrap.pm b/lib/Template/Plugin/GD/Text/Wrap.pm index d587b4c98..d27f650bc 100644 --- a/lib/Template/Plugin/GD/Text/Wrap.pm +++ b/lib/Template/Plugin/GD/Text/Wrap.pm @@ -155,8 +155,8 @@ The GD::Text module was written by Martien Verbruggen. =head1 VERSION -1.38, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +1.39, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002. =head1 COPYRIGHT diff --git a/lib/Template/Plugin/HTML.pm b/lib/Template/Plugin/HTML.pm index 4c992adec..9b65ac57f 100644 --- a/lib/Template/Plugin/HTML.pm +++ b/lib/Template/Plugin/HTML.pm @@ -171,8 +171,8 @@ L =head1 VERSION -2.39, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.40, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002. =head1 COPYRIGHT diff --git a/lib/Template/Plugin/Iterator.pm b/lib/Template/Plugin/Iterator.pm index 2ef0de321..4ddb48c3f 100644 --- a/lib/Template/Plugin/Iterator.pm +++ b/lib/Template/Plugin/Iterator.pm @@ -92,8 +92,8 @@ L =head1 VERSION -2.45, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.46, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002. =head1 COPYRIGHT diff --git a/lib/Template/Plugin/Pod.pm b/lib/Template/Plugin/Pod.pm index 8d01a7416..bdd063dac 100644 --- a/lib/Template/Plugin/Pod.pm +++ b/lib/Template/Plugin/Pod.pm @@ -89,8 +89,8 @@ L =head1 VERSION -2.44, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.45, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002. =head1 COPYRIGHT diff --git a/lib/Template/Plugin/String.pm b/lib/Template/Plugin/String.pm index 4122f0cd6..4305a7089 100644 --- a/lib/Template/Plugin/String.pm +++ b/lib/Template/Plugin/String.pm @@ -770,8 +770,8 @@ L =head1 VERSION -2.15, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.16, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002. =head1 COPYRIGHT diff --git a/lib/Template/Plugin/Table.pm b/lib/Template/Plugin/Table.pm index 0629c2d33..748eaff27 100644 --- a/lib/Template/Plugin/Table.pm +++ b/lib/Template/Plugin/Table.pm @@ -438,8 +438,8 @@ L =head1 VERSION -2.47, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.48, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002. =head1 COPYRIGHT diff --git a/lib/Template/Plugin/URL.pm b/lib/Template/Plugin/URL.pm index 2c6c6e283..889c95ff8 100644 --- a/lib/Template/Plugin/URL.pm +++ b/lib/Template/Plugin/URL.pm @@ -210,8 +210,8 @@ L =head1 VERSION -2.47, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.48, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002. =head1 COPYRIGHT diff --git a/lib/Template/Plugin/View.pm b/lib/Template/Plugin/View.pm index 1475bad8b..810f136b1 100644 --- a/lib/Template/Plugin/View.pm +++ b/lib/Template/Plugin/View.pm @@ -101,8 +101,8 @@ L =head1 VERSION -2.46, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.47, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002. =head1 COPYRIGHT diff --git a/lib/Template/Plugin/Wrap.pm b/lib/Template/Plugin/Wrap.pm index ee8dfff6e..8e7bd3045 100644 --- a/lib/Template/Plugin/Wrap.pm +++ b/lib/Template/Plugin/Wrap.pm @@ -145,8 +145,8 @@ others. =head1 VERSION -2.46, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.47, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002. =head1 COPYRIGHT diff --git a/lib/Template/Plugin/XML/DOM.pm b/lib/Template/Plugin/XML/DOM.pm index 4e91c1d99..66cf59e16 100644 --- a/lib/Template/Plugin/XML/DOM.pm +++ b/lib/Template/Plugin/XML/DOM.pm @@ -801,7 +801,7 @@ library. =head1 VERSION 2.6, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +Template Toolkit version 2.07b, released on 07 July 2002. diff --git a/lib/Template/Plugin/XML/RSS.pm b/lib/Template/Plugin/XML/RSS.pm index 5405e5125..84c9b0c8b 100644 --- a/lib/Template/Plugin/XML/RSS.pm +++ b/lib/Template/Plugin/XML/RSS.pm @@ -168,8 +168,8 @@ Eeisen@pobox.comE. =head1 VERSION -2.46, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.47, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002. =head1 COPYRIGHT diff --git a/lib/Template/Plugin/XML/Simple.pm b/lib/Template/Plugin/XML/Simple.pm index 45311cfc7..3697a0c73 100644 --- a/lib/Template/Plugin/XML/Simple.pm +++ b/lib/Template/Plugin/XML/Simple.pm @@ -107,8 +107,8 @@ was written by Grant McLean Egrantm@web.co.nzE. =head1 VERSION -2.44, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.45, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002. =head1 COPYRIGHT diff --git a/lib/Template/Plugin/XML/Style.pm b/lib/Template/Plugin/XML/Style.pm index ebf640ea5..a7db75a03 100644 --- a/lib/Template/Plugin/XML/Style.pm +++ b/lib/Template/Plugin/XML/Style.pm @@ -331,8 +331,8 @@ L =head1 VERSION -2.17, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.18, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002. =head1 COPYRIGHT diff --git a/lib/Template/Plugin/XML/XPath.pm b/lib/Template/Plugin/XML/XPath.pm index 0923253eb..2ccc62ceb 100644 --- a/lib/Template/Plugin/XML/XPath.pm +++ b/lib/Template/Plugin/XML/XPath.pm @@ -257,8 +257,8 @@ The XML::XPath module is by Matt Sergeant Ematt@sergeant.orgE. =head1 VERSION -2.49, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.50, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002. =head1 COPYRIGHT diff --git a/lib/Template/Plugins.pm b/lib/Template/Plugins.pm index dd160994d..6e5c92a75 100644 --- a/lib/Template/Plugins.pm +++ b/lib/Template/Plugins.pm @@ -994,8 +994,8 @@ L =head1 VERSION -2.52, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.53, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002. =head1 COPYRIGHT diff --git a/lib/Template/Provider.pm b/lib/Template/Provider.pm index 2ddc26781..579510ccf 100644 --- a/lib/Template/Provider.pm +++ b/lib/Template/Provider.pm @@ -1261,8 +1261,8 @@ L =head1 VERSION -2.53, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.54, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002. =head1 COPYRIGHT diff --git a/lib/Template/Service.pm b/lib/Template/Service.pm index 2a6ca1d77..3fb5d3d38 100644 --- a/lib/Template/Service.pm +++ b/lib/Template/Service.pm @@ -710,8 +710,8 @@ L =head1 VERSION -2.53, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.54, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002. =head1 COPYRIGHT diff --git a/lib/Template/Stash.pm b/lib/Template/Stash.pm index 5465245ef..262f15f68 100644 --- a/lib/Template/Stash.pm +++ b/lib/Template/Stash.pm @@ -877,8 +877,8 @@ L =head1 VERSION -2.58, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.59, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002. =head1 COPYRIGHT diff --git a/lib/Template/Stash/Context.pm b/lib/Template/Stash/Context.pm index a9acae65b..dfd7b0e63 100644 --- a/lib/Template/Stash/Context.pm +++ b/lib/Template/Stash/Context.pm @@ -765,8 +765,8 @@ L =head1 VERSION -1.41, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +1.42, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002. =head1 COPYRIGHT diff --git a/lib/Template/Stash/XS.pm b/lib/Template/Stash/XS.pm index c630018da..d1302ab3e 100644 --- a/lib/Template/Stash/XS.pm +++ b/lib/Template/Stash/XS.pm @@ -156,7 +156,7 @@ Doug Steinwand Edsteinwand@citysearch.comE =head1 VERSION -Template Toolkit version 2.07a, released on 05 July 2002. +Template Toolkit version 2.07b, released on 07 July 2002. diff --git a/lib/Template/Test.pm b/lib/Template/Test.pm index 70beaa816..39e6ddeda 100644 --- a/lib/Template/Test.pm +++ b/lib/Template/Test.pm @@ -657,8 +657,8 @@ L =head1 VERSION -2.49, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.50, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002. =head1 COPYRIGHT diff --git a/lib/Template/Tools/tpage.pod b/lib/Template/Tools/tpage.pod index fc50118d6..3c9be1b62 100644 --- a/lib/Template/Tools/tpage.pod +++ b/lib/Template/Tools/tpage.pod @@ -50,8 +50,8 @@ L =head1 VERSION -2.49, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.50, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002. =head1 COPYRIGHT diff --git a/lib/Template/Tools/ttree.pod b/lib/Template/Tools/ttree.pod index e420fd2f7..feaf9419e 100644 --- a/lib/Template/Tools/ttree.pod +++ b/lib/Template/Tools/ttree.pod @@ -97,8 +97,8 @@ L =head1 VERSION -2.49, distributed as part of the -Template Toolkit version 2.07a, released on 05 July 2002. +2.50, distributed as part of the +Template Toolkit version 2.07b, released on 07 July 2002. =head1 COPYRIGHT diff --git a/lib/Template/Tutorial.pod b/lib/Template/Tutorial.pod index ee3c0fcee..20ed0c352 100644 --- a/lib/Template/Tutorial.pod +++ b/lib/Template/Tutorial.pod @@ -86,7 +86,7 @@ L =head1 VERSION -Template Toolkit version 2.07a, released on 05 July 2002. +Template Toolkit version 2.07b, released on 07 July 2002. =head1 COPYRIGHT diff --git a/lib/Template/Tutorial/Datafile.pod b/lib/Template/Tutorial/Datafile.pod index 1e0226f36..0c936771c 100644 --- a/lib/Template/Tutorial/Datafile.pod +++ b/lib/Template/Tutorial/Datafile.pod @@ -438,7 +438,7 @@ Dave Cross Edave@dave.org.ukE =head1 VERSION -Template Toolkit version 2.07a, released on 05 July 2002. +Template Toolkit version 2.07b, released on 07 July 2002. =head1 COPYRIGHT diff --git a/lib/Template/Tutorial/Web.pod b/lib/Template/Tutorial/Web.pod index 7c6703729..a5905cf16 100644 --- a/lib/Template/Tutorial/Web.pod +++ b/lib/Template/Tutorial/Web.pod @@ -778,7 +778,7 @@ L =head1 VERSION -Template Toolkit version 2.07a, released on 05 July 2002. +Template Toolkit version 2.07b, released on 07 July 2002. =head1 COPYRIGHT