From d94123855cc4eff8b45384f4d13286fc12cf4467 Mon Sep 17 00:00:00 2001 From: Andy Wardley Date: Tue, 21 Aug 2001 17:46:37 +0000 Subject: [PATCH] prep 2.4d git-svn-id: svn://svn.tt2.org/tt/Template2/trunk@157 d5a88997-0a34-4036-9ed2-92fb5d660d91 --- Changes | 9 +- MANIFEST | 1 + Makefile.PL | 14 +-- README | 103 +++++------------- TODO | 17 +-- bin/tpage | 2 +- bin/ttree | 2 +- docs/lib/docset/config | 16 ++- docs/src/FAQ/FAQ.html | 2 +- docs/src/Library/HTML.html | 2 +- docs/src/Library/PostScript.html | 2 +- docs/src/Library/Splash.html | 2 +- docs/src/Modules/Template/Base.html | 2 +- docs/src/Modules/Template/Config.html | 2 +- docs/src/Modules/Template/Constants.html | 2 +- docs/src/Modules/Template/Context.html | 2 +- docs/src/Modules/Template/Document.html | 2 +- docs/src/Modules/Template/Exception.html | 2 +- docs/src/Modules/Template/Filters.html | 2 +- docs/src/Modules/Template/Iterator.html | 2 +- docs/src/Modules/Template/Parser.html | 2 +- docs/src/Modules/Template/Plugin.html | 2 +- .../Modules/Template/Plugin/Autoformat.html | 2 +- docs/src/Modules/Template/Plugin/CGI.html | 2 +- .../src/Modules/Template/Plugin/Datafile.html | 2 +- docs/src/Modules/Template/Plugin/Date.html | 2 +- .../Modules/Template/Plugin/Directory.html | 2 +- docs/src/Modules/Template/Plugin/Dumper.html | 2 +- docs/src/Modules/Template/Plugin/File.html | 2 +- docs/src/Modules/Template/Plugin/Format.html | 2 +- .../src/Modules/Template/Plugin/Iterator.html | 2 +- docs/src/Modules/Template/Plugin/Pod.html | 2 +- docs/src/Modules/Template/Plugin/Table.html | 2 +- docs/src/Modules/Template/Plugin/URL.html | 2 +- docs/src/Modules/Template/Plugin/View.html | 2 +- docs/src/Modules/Template/Plugin/Wrap.html | 2 +- docs/src/Modules/Template/Plugin/XML/RSS.html | 2 +- .../Modules/Template/Plugin/XML/Simple.html | 2 +- .../Modules/Template/Plugin/XML/XPath.html | 2 +- docs/src/Modules/Template/Plugins.html | 2 +- docs/src/Modules/Template/Provider.html | 2 +- docs/src/Modules/Template/Service.html | 2 +- docs/src/Modules/Template/Stash.html | 2 +- docs/src/Modules/Template/Test.html | 2 +- docs/src/Modules/index.html | 8 ++ docs/src/Release/Changes.html | 9 +- docs/src/Release/README.html | 103 +++++------------- docs/src/Release/TODO.html | 17 +-- docs/src/Tools/tpage.html | 2 +- docs/src/Tools/ttree.html | 2 +- docsrc/src/Release/Changes.tt2 | 9 +- docsrc/src/Release/README.tt2 | 103 +++++------------- docsrc/src/Release/TODO.tt2 | 17 +-- docsrc/xml/ttdocs.xml | 8 ++ lib/Template/Base.pm | 2 +- lib/Template/Config.pm | 6 +- lib/Template/Constants.pm | 2 +- lib/Template/Context.pm | 2 +- lib/Template/Document.pm | 2 +- lib/Template/Exception.pm | 2 +- lib/Template/FAQ.pod | 4 +- lib/Template/Filters.pm | 2 +- lib/Template/Iterator.pm | 2 +- lib/Template/Library/HTML.pod | 4 +- lib/Template/Library/PostScript.pod | 4 +- lib/Template/Library/Splash.pod | 4 +- lib/Template/Modules.pod | 6 + lib/Template/Parser.pm | 2 +- lib/Template/Plugin.pm | 2 +- lib/Template/Plugin/Autoformat.pm | 2 +- lib/Template/Plugin/CGI.pm | 2 +- lib/Template/Plugin/Datafile.pm | 2 +- lib/Template/Plugin/Date.pm | 2 +- lib/Template/Plugin/Directory.pm | 2 +- lib/Template/Plugin/Dumper.pm | 2 +- lib/Template/Plugin/File.pm | 2 +- lib/Template/Plugin/Format.pm | 2 +- lib/Template/Plugin/GD/Constants.pm | 2 +- lib/Template/Plugin/GD/Graph/area.pm | 2 +- lib/Template/Plugin/GD/Graph/bars.pm | 2 +- lib/Template/Plugin/GD/Graph/bars3d.pm | 2 +- lib/Template/Plugin/GD/Graph/lines.pm | 2 +- lib/Template/Plugin/GD/Graph/lines3d.pm | 2 +- lib/Template/Plugin/GD/Graph/linespoints.pm | 2 +- lib/Template/Plugin/GD/Graph/mixed.pm | 2 +- lib/Template/Plugin/GD/Graph/pie.pm | 2 +- lib/Template/Plugin/GD/Graph/pie3d.pm | 2 +- lib/Template/Plugin/GD/Graph/points.pm | 2 +- lib/Template/Plugin/GD/Image.pm | 2 +- lib/Template/Plugin/GD/Polygon.pm | 2 +- lib/Template/Plugin/GD/Text.pm | 2 +- lib/Template/Plugin/GD/Text/Align.pm | 2 +- lib/Template/Plugin/GD/Text/Wrap.pm | 2 +- lib/Template/Plugin/HTML.pm | 9 +- lib/Template/Plugin/Iterator.pm | 2 +- lib/Template/Plugin/Pod.pm | 2 +- lib/Template/Plugin/Table.pm | 2 +- lib/Template/Plugin/URL.pm | 2 +- lib/Template/Plugin/View.pm | 2 +- lib/Template/Plugin/Wrap.pm | 2 +- lib/Template/Plugin/XML/RSS.pm | 2 +- lib/Template/Plugin/XML/Simple.pm | 2 +- lib/Template/Plugin/XML/XPath.pm | 2 +- lib/Template/Plugins.pm | 2 +- lib/Template/Provider.pm | 2 +- lib/Template/Service.pm | 2 +- lib/Template/Stash.pm | 2 +- lib/Template/Stash/Context.pm | 2 +- lib/Template/Stash/XS.pm | 47 ++++++-- lib/Template/Test.pm | 2 +- lib/Template/Tools/tpage.pod | 2 +- lib/Template/Tools/ttree.pod | 2 +- 112 files changed, 315 insertions(+), 383 deletions(-) diff --git a/Changes b/Changes index e320d834f..e86adfe47 100644 --- a/Changes +++ b/Changes @@ -17,13 +17,20 @@ #======================================================================== #------------------------------------------------------------------------ -# Version 2.04d - 15 Aug 2001 ## DEVELOPER RELEASE ## +# Version 2.04d - 29 Aug 2001 ## DEVELOPER RELEASE ## #------------------------------------------------------------------------ +* Incorporated Doug Steinwand's XS Stash. This adds the files in the + 'xs' directory, t/stash-xs.t, bin/tt-bench.pl and includes some work + on the Makefile.PL to incorporate the required prompting, etc. + * Added gt, ge, lt and le as comparison operators which map directly to their Perl counterparts. Added tests to t/stash.t and relevant documentation to the IF directive. +* Applied some patches from Leon and Doug to enhance the coverage of + the test suite. + * Added 'sorted' as a flag to the HTML plugin to return attributes in sorted order. Mainly for debugging purposes, as used in t/html.t. diff --git a/MANIFEST b/MANIFEST index 200277c3d..bd438d518 100644 --- a/MANIFEST +++ b/MANIFEST @@ -92,6 +92,7 @@ docs/src/Modules/Template/Provider.html docs/src/Modules/Template/Service.html docs/src/Modules/Template/Stash.html docs/src/Modules/Template/Stash/Context.html +docs/src/Modules/Template/Stash/XS.html docs/src/Modules/Template/Test.html docs/src/Modules/index.html docs/src/Release/Changes.html diff --git a/Makefile.PL b/Makefile.PL index 31061dd10..37428e486 100644 --- a/Makefile.PL +++ b/Makefile.PL @@ -238,7 +238,6 @@ my %opts = ( 'dist' => { 'COMPRESS' => 'gzip', 'SUFFIX' => 'gz', -# 'PREOP' => build_docs(), }, ); @@ -463,11 +462,9 @@ EOF $TT_XS_DEFAULT = (ttprompt('Do you want to use the XS Stash for all Templates?', $TT_XS_DEFAULT) =~ /^y/i); - if ($TT_XS_DEFAULT) { - fix_file('lib/Template/Config.pm', - '$STASH', - 'Template::Stash::XS'); - } + fix_file('lib/Template/Config.pm', + '$STASH', + $TT_XS_DEFAULT ? 'Template::Stash::XS' : 'Template::Stash'); } } @@ -528,7 +525,7 @@ EOF # $TT_PDFLATEX_PATH = $TT_LATEX_PATH = $TT_DVIPS_PATH = ""; } - + fix_file('lib/Template/Config.pm', '$PDFLATEX_PATH', $TT_PDFLATEX_PATH); fix_file('lib/Template/Config.pm', '$LATEX_PATH', $TT_LATEX_PATH); fix_file('lib/Template/Config.pm', '$DVIPS_PATH', $TT_DVIPS_PATH); @@ -644,6 +641,7 @@ EOF $TT_IMAGES = ttprompt('URL base for TT2 images?', $TT_IMAGES || $IMAGES); $TT_IMAGES =~ s[/$][]g; # just in case + fix_file('templates/splash/config', 'images', "$TT_IMAGES/splash"); } @@ -1047,7 +1045,7 @@ EOF # fix_file($file, $find, $fix) # # Fixes a variable definition in a file. e.g. -# fix_file('lib/Template/Config.pm', '$INSTDIR', '/usr/local/tt2') +# fix_file('templates/splash/config', 'images', '/tt2/splash') #------------------------------------------------------------------------ sub fix_file { diff --git a/README b/README index 3e441a238..fcf2096db 100644 --- a/README +++ b/README @@ -95,87 +95,31 @@ appropriate sex, then you can always return it for a full refund. :-) WHAT'S NEW? ----------- -Version 2.04 is mainly a bug fixing version. +The most exciting new feature in version 2.05 is 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! -Version 2.03 includes Craig Barratt's 'latex' filter and GD plugins. -The latex filter allow you to create PostScript/PDF/DVI output from -LaTeX source templates. The GD plugins allow you to access the GD::* -modules to create dynamic images using template. +Pretty much everything else in 2.05 and 2.04 before it consisted +of minor bug fixes and improvements. -There have been some improvements to VIEWs and they now work -harmoniously with the XML::XPath and XML::DOM plugins for doing -template based transformations of XML to other formats. The HTML -plugin is new (but currently very basic) and some of the Splash! and -HTML library templates have been updated and some new components added. +Version 2.03 includes 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. -There's a new tutorial from Dave Cross on using the Template Toolkit for -creating and reusing data files. There's various other updates to the -documentation, numerous minor bug fixes and other general improvements. +Version 2.02 was another bugfix release, following shortly on after +version 2.01. This was a major release which contained some of +the following: -Version 2.02 followed shortly on the heels of version 2.01, fixing up -some of the minor installation bugs and other problems that came to -light. Here's a quick summary of what's new since version 2.00. -See the Changes file for more details. + * total overhaul of the documtation -Documentation + * additional of template libraries: POD, HTML, Splash! - * Total overhaul of the documentation: existing content reorganised - into several different sections, documentation added for new - features, a FAQ and also a section on internals. Now also - available in user-customisable HTML format, in addition to POD. + * various new language features including VIEWs -Libraries + * new filters and plugins - * The Template Toolkit now includes template libraries for - generating HTML, PostScript and converting POD to HTML (and other - formats). The Splash! library is a powerful HTML widget set for - generating stylish user interfaces. Includes components for - elements like tables, menu buttons, panels with borders and - header/footer bars, edged boxes with index tabs, etc. - -Language - - * Multiple templates can be specified to directives using '+' - - [% PROCESS header + menu + body + footer - title = "Hello World" - %] - - * Template variables for INCLUDE, etc., can now be full expressions. - - [% INCLUDE header - title = my_title or your_title or default_title - bgcol = (style == 'dark' ? '#000000' : '#ffffff') - %] - - * Namespace prefixes can be used to bind templates to a particular - provider. - - [% INCLUDE file:header + database:header %] - [% INCLUDE http://foo.com/bar %] # alas no 'http' provider...yet - - * Powerful new (but experimental) VIEW directive and/or plugin to - provide dynamic view objects. These can be used to implement - "skins" and other general purpose objects to manage user interface - elements and present views of user data. See Template::Manual::Views - manpage for further details. - - * Various other language enhancements: CHOMP_COLLAPSE option, - 'import=myhash' as magical variable for INCLUDE, etc. - - * New filters: indent, trim and collapse - - * New plugins: File and Directory plugins for file/directory - information. Pod plugin interfaces to Pod::POM for converting - Pod to other formats (e.g. HTML). - -Internals - - * Template::Plugin base class no longer implements AUTOLOAD method. - - * Numerous bugs fixed including some troublesome memory leaks. - - * Various other minor internal improvements. +For more information please consult the Changes file. GENERAL FEATURES @@ -358,6 +302,19 @@ the relevant database. Please ensure that your database server is running and that the database you specify exists before executing 'make test' (otherwise, expect a failure for the t/dbi.t test). +The Template Toolkit now boast a high-speed implementation of +Template::Stash written in XS. You can choose to build this as +an optional module for using explicitly as an alternative to +the regular pure-perl stash module. In additional, you can opt +to use the XS Stash as the default, typically making the Template +Toolkit run twice as fast! + +When prompted, answer 'y' or 'n' to build and optionally use +the XS Stash module by default: + + Do you want to build the XS Stash module? [y] + Do you want to use the XS Stash for all Templates? [n] + The latex filter, new to release 2.03, allows you to generate PostScript, PDF and DVI files directly from LaTeX source templates. It relies on 3 external programs which the Makefile.PL script diff --git a/TODO b/TODO index 576540e7b..a213a2837 100644 --- a/TODO +++ b/TODO @@ -169,7 +169,9 @@ * Stas Bekman raised the issue of the Stash not being able to correctly differentiate between scalar/list context and in particular, the - cgi.param examples not working as expected. + cgi.param examples not working as expected. This is fixed in v3 and + in Craig's Stash/Context.pm which does the right lookahead to allow + 'scalar' and 'list' postfix operators. e.g. cgi.param.list * Richard Tietjen's patch for stash replace. Allows back references (e.g. $1) but it would be nice to find a rock-solid way to implement @@ -178,19 +180,6 @@ * Have stash, etc., add current template name/line when reporting errors. (may be tricky under the current implementation) -* I've written a version of Template::Stash in XS which should give a - significant speedup to the runtime processing. It's 95% complete - (but hasn't been updated to keep up with more recent changes to the - stash) and just needs some minor debugging and testing. The new - Template::Stash will automatically load the existing Perl version if - you don't have a C compiler on your platform (shame on you!). - -* And I'm now working on Yet Another Brand New Stash which should - implement all the functionality of Craig's latest patches, rationalise - all sorts of stuff, improve debugging, *AND* run slightly faster. - Furthermore, the new architecture should be much easier to extend - and implement in XS. Watch the mailing list for further details. - #------------------------------------------------------------------------ # Parser diff --git a/bin/tpage b/bin/tpage index 66b64ce4a..2b37ce84d 100755 --- a/bin/tpage +++ b/bin/tpage @@ -112,7 +112,7 @@ L =head1 VERSION -2.18, distributed as part of the +2.19, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001. =head1 COPYRIGHT diff --git a/bin/ttree b/bin/ttree index a7f121dd3..48e2601a7 100755 --- a/bin/ttree +++ b/bin/ttree @@ -627,7 +627,7 @@ L =head1 VERSION -2.18, distributed as part of the +2.19, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001. =head1 COPYRIGHT diff --git a/docs/lib/docset/config b/docs/lib/docset/config index 4286eb4a2..87df8374f 100644 --- a/docs/lib/docset/config +++ b/docs/lib/docset/config @@ -424,6 +424,18 @@ docset => { author => 'abw', about => 'Experimetal stash allowing list/scalar context definition', prev => 'Stash', + next => 'Stash_XS', + }, + Stash_XS => { + id => 'Stash_XS', + name => 'Template::Stash::XS', + title => 'Template::Stash::XS', + podname => 'Template::Stash::XS', + url => 'Modules/Template/Stash/XS.html', + uplink => '../../..', + author => 'abw', + about => 'Experimetal high-speed stash written in XS', + prev => 'Stash_Context', next => 'Test', }, Test => { @@ -435,7 +447,7 @@ docset => { uplink => '../..', author => 'abw', about => 'Module for automating TT2 test scripts', - prev => 'Stash_Context', + prev => 'Stash_XS', next => 'Plugin_Autoformat', }, Plugin_Autoformat => { @@ -898,6 +910,7 @@ docset => { 'Service', 'Stash', 'Stash_Context', + 'Stash_XS', 'Test', 'Plugin_Autoformat', 'Plugin_CGI', @@ -1196,6 +1209,7 @@ docset => { 'Template::Service' => 'Modules/Template/Service.html', 'Template::Stash' => 'Modules/Template/Stash.html', 'Template::Stash::Context' => 'Modules/Template/Stash/Context.html', + 'Template::Stash::XS' => 'Modules/Template/Stash/XS.html', 'Template::Test' => 'Modules/Template/Test.html', 'Template::Plugin::Autoformat' => 'Modules/Template/Plugin/Autoformat.html', 'Template::Plugin::CGI' => 'Modules/Template/Plugin/CGI.html', diff --git a/docs/src/FAQ/FAQ.html b/docs/src/FAQ/FAQ.html index 614758702..6d1cd3343 100644 --- a/docs/src/FAQ/FAQ.html +++ b/docs/src/FAQ/FAQ.html @@ -207,7 +207,7 @@ [% WRAPPER section title="VERSION" -%]

-2.18, distributed as part of the +2.19, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001.

[%- END %] diff --git a/docs/src/Library/HTML.html b/docs/src/Library/HTML.html index f2e6c7595..3435a3173 100644 --- a/docs/src/Library/HTML.html +++ b/docs/src/Library/HTML.html @@ -307,7 +307,7 @@ [% WRAPPER section title="VERSION" -%]

-2.18, distributed as part of the +2.19, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001.

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

-2.18, distributed as part of the +2.19, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001.

[%- END %] diff --git a/docs/src/Library/Splash.html b/docs/src/Library/Splash.html index 21a4fe998..92d8ecec6 100644 --- a/docs/src/Library/Splash.html +++ b/docs/src/Library/Splash.html @@ -980,7 +980,7 @@ [% WRAPPER section title="VERSION" -%]

-2.18, distributed as part of the +2.19, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001.

[%- END %] diff --git a/docs/src/Modules/Template/Base.html b/docs/src/Modules/Template/Base.html index bf87fdff5..de2a75965 100644 --- a/docs/src/Modules/Template/Base.html +++ b/docs/src/Modules/Template/Base.html @@ -98,7 +98,7 @@ [% WRAPPER section title="VERSION" -%]

-2.21, distributed as part of the +2.22, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001.

[%- END %] diff --git a/docs/src/Modules/Template/Config.html b/docs/src/Modules/Template/Config.html index 101f14247..18046b4f8 100644 --- a/docs/src/Modules/Template/Config.html +++ b/docs/src/Modules/Template/Config.html @@ -137,7 +137,7 @@ [% WRAPPER section title="VERSION" -%]

-2.19, distributed as part of the +2.21, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001.

[%- END %] diff --git a/docs/src/Modules/Template/Constants.html b/docs/src/Modules/Template/Constants.html index 4bf475290..660b32cb3 100644 --- a/docs/src/Modules/Template/Constants.html +++ b/docs/src/Modules/Template/Constants.html @@ -89,7 +89,7 @@ [% WRAPPER section title="VERSION" -%]

-2.20, distributed as part of the +2.21, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001.

[%- END %] diff --git a/docs/src/Modules/Template/Context.html b/docs/src/Modules/Template/Context.html index 6ee7d3111..974d782a4 100644 --- a/docs/src/Modules/Template/Context.html +++ b/docs/src/Modules/Template/Context.html @@ -612,7 +612,7 @@ [% WRAPPER section title="VERSION" -%]

-2.26, distributed as part of the +2.27, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001.

[%- END %] diff --git a/docs/src/Modules/Template/Document.html b/docs/src/Modules/Template/Document.html index 167ea40d4..253540cf0 100644 --- a/docs/src/Modules/Template/Document.html +++ b/docs/src/Modules/Template/Document.html @@ -190,7 +190,7 @@ [% WRAPPER section title="VERSION" -%]

-2.21, distributed as part of the +2.22, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001.

[%- END %] diff --git a/docs/src/Modules/Template/Exception.html b/docs/src/Modules/Template/Exception.html index 23022ea97..9b0eda749 100644 --- a/docs/src/Modules/Template/Exception.html +++ b/docs/src/Modules/Template/Exception.html @@ -79,7 +79,7 @@ [% WRAPPER section title="VERSION" -%]

-2.17, distributed as part of the +2.18, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001.

[%- END %] diff --git a/docs/src/Modules/Template/Filters.html b/docs/src/Modules/Template/Filters.html index 2590ed173..7683f5202 100644 --- a/docs/src/Modules/Template/Filters.html +++ b/docs/src/Modules/Template/Filters.html @@ -600,7 +600,7 @@ [% WRAPPER section title="VERSION" -%]

-2.22, distributed as part of the +2.23, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001.

[%- END %] diff --git a/docs/src/Modules/Template/Iterator.html b/docs/src/Modules/Template/Iterator.html index 3e8754fed..53c4e19ad 100644 --- a/docs/src/Modules/Template/Iterator.html +++ b/docs/src/Modules/Template/Iterator.html @@ -215,7 +215,7 @@ [% WRAPPER section title="VERSION" -%]

-2.19, distributed as part of the +2.20, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001.

[%- END %] diff --git a/docs/src/Modules/Template/Parser.html b/docs/src/Modules/Template/Parser.html index 97a685fb6..32462db73 100644 --- a/docs/src/Modules/Template/Parser.html +++ b/docs/src/Modules/Template/Parser.html @@ -444,7 +444,7 @@ [% WRAPPER section title="VERSION" -%]

-2.25, distributed as part of the +2.26, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001.

 
diff --git a/docs/src/Modules/Template/Plugin.html b/docs/src/Modules/Template/Plugin.html index 908914f49..7546a61e8 100644 --- a/docs/src/Modules/Template/Plugin.html +++ b/docs/src/Modules/Template/Plugin.html @@ -228,7 +228,7 @@ [% WRAPPER section title="VERSION" -%]

-2.20, distributed as part of the +2.21, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001.

[%- END %] diff --git a/docs/src/Modules/Template/Plugin/Autoformat.html b/docs/src/Modules/Template/Plugin/Autoformat.html index 0c1b99cb5..9f8eb435d 100644 --- a/docs/src/Modules/Template/Plugin/Autoformat.html +++ b/docs/src/Modules/Template/Plugin/Autoformat.html @@ -140,7 +140,7 @@ [% WRAPPER section title="VERSION" -%]

-2.19, distributed as part of the +2.20, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001.

[%- END %] diff --git a/docs/src/Modules/Template/Plugin/CGI.html b/docs/src/Modules/Template/Plugin/CGI.html index dec031536..f5ccd7923 100644 --- a/docs/src/Modules/Template/Plugin/CGI.html +++ b/docs/src/Modules/Template/Plugin/CGI.html @@ -70,7 +70,7 @@ [% WRAPPER section title="VERSION" -%]

-2.18, distributed as part of the +2.19, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001.

[%- END %] diff --git a/docs/src/Modules/Template/Plugin/Datafile.html b/docs/src/Modules/Template/Plugin/Datafile.html index 68deebb49..cb371aada 100644 --- a/docs/src/Modules/Template/Plugin/Datafile.html +++ b/docs/src/Modules/Template/Plugin/Datafile.html @@ -90,7 +90,7 @@ [% WRAPPER section title="VERSION" -%]

-2.20, distributed as part of the +2.21, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001.

[%- END %] diff --git a/docs/src/Modules/Template/Plugin/Date.html b/docs/src/Modules/Template/Plugin/Date.html index b480981cc..ec8663778 100644 --- a/docs/src/Modules/Template/Plugin/Date.html +++ b/docs/src/Modules/Template/Plugin/Date.html @@ -132,7 +132,7 @@ [% WRAPPER section title="VERSION" -%]

-2.18, distributed as part of the +2.19, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001.

[%- END %] diff --git a/docs/src/Modules/Template/Plugin/Directory.html b/docs/src/Modules/Template/Plugin/Directory.html index fe3dc69b6..2c9dfcfb9 100644 --- a/docs/src/Modules/Template/Plugin/Directory.html +++ b/docs/src/Modules/Template/Plugin/Directory.html @@ -232,7 +232,7 @@ [% WRAPPER section title="VERSION" -%]

-2.18, distributed as part of the +2.19, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001.

[%- END %] diff --git a/docs/src/Modules/Template/Plugin/Dumper.html b/docs/src/Modules/Template/Plugin/Dumper.html index be284875e..250b64326 100644 --- a/docs/src/Modules/Template/Plugin/Dumper.html +++ b/docs/src/Modules/Template/Plugin/Dumper.html @@ -87,7 +87,7 @@ [% WRAPPER section title="VERSION" -%]

-2.18, distributed as part of the +2.19, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001.

[%- END %] diff --git a/docs/src/Modules/Template/Plugin/File.html b/docs/src/Modules/Template/Plugin/File.html index 4705c6902..89b793ef6 100644 --- a/docs/src/Modules/Template/Plugin/File.html +++ b/docs/src/Modules/Template/Plugin/File.html @@ -263,7 +263,7 @@ [% WRAPPER section title="VERSION" -%]

-2.18, distributed as part of the +2.19, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001.

[%- END %] diff --git a/docs/src/Modules/Template/Plugin/Format.html b/docs/src/Modules/Template/Plugin/Format.html index 3b25ec8ac..281899321 100644 --- a/docs/src/Modules/Template/Plugin/Format.html +++ b/docs/src/Modules/Template/Plugin/Format.html @@ -49,7 +49,7 @@ [% WRAPPER section title="VERSION" -%]

-2.19, distributed as part of the +2.20, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001.

[%- END %] diff --git a/docs/src/Modules/Template/Plugin/Iterator.html b/docs/src/Modules/Template/Plugin/Iterator.html index 470e8941a..b92c80944 100644 --- a/docs/src/Modules/Template/Plugin/Iterator.html +++ b/docs/src/Modules/Template/Plugin/Iterator.html @@ -51,7 +51,7 @@ [% WRAPPER section title="VERSION" -%]

-2.17, distributed as part of the +2.18, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001.

[%- END %] diff --git a/docs/src/Modules/Template/Plugin/Pod.html b/docs/src/Modules/Template/Plugin/Pod.html index 114207ad7..f81833722 100644 --- a/docs/src/Modules/Template/Plugin/Pod.html +++ b/docs/src/Modules/Template/Plugin/Pod.html @@ -49,7 +49,7 @@ [% WRAPPER section title="VERSION" -%]

-2.16, distributed as part of the +2.17, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001.

[%- END %] diff --git a/docs/src/Modules/Template/Plugin/Table.html b/docs/src/Modules/Template/Plugin/Table.html index da25f2e52..30bca5d6c 100644 --- a/docs/src/Modules/Template/Plugin/Table.html +++ b/docs/src/Modules/Template/Plugin/Table.html @@ -192,7 +192,7 @@ [% WRAPPER section title="VERSION" -%]

-2.19, distributed as part of the +2.20, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001.

[%- END %] diff --git a/docs/src/Modules/Template/Plugin/URL.html b/docs/src/Modules/Template/Plugin/URL.html index b205f65e6..bdd549005 100644 --- a/docs/src/Modules/Template/Plugin/URL.html +++ b/docs/src/Modules/Template/Plugin/URL.html @@ -118,7 +118,7 @@ [% WRAPPER section title="VERSION" -%]

-2.19, distributed as part of the +2.20, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001.

[%- END %] diff --git a/docs/src/Modules/Template/Plugin/View.html b/docs/src/Modules/Template/Plugin/View.html index a12777ee8..fd73dd440 100644 --- a/docs/src/Modules/Template/Plugin/View.html +++ b/docs/src/Modules/Template/Plugin/View.html @@ -55,7 +55,7 @@ [% WRAPPER section title="VERSION" -%]

-2.18, distributed as part of the +2.19, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001.

[%- END %] diff --git a/docs/src/Modules/Template/Plugin/Wrap.html b/docs/src/Modules/Template/Plugin/Wrap.html index 7520d5810..1d8f0bf05 100644 --- a/docs/src/Modules/Template/Plugin/Wrap.html +++ b/docs/src/Modules/Template/Plugin/Wrap.html @@ -88,7 +88,7 @@ [% WRAPPER section title="VERSION" -%]

-2.18, distributed as part of the +2.19, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001.

[%- END %] diff --git a/docs/src/Modules/Template/Plugin/XML/RSS.html b/docs/src/Modules/Template/Plugin/XML/RSS.html index a18045944..42c287025 100644 --- a/docs/src/Modules/Template/Plugin/XML/RSS.html +++ b/docs/src/Modules/Template/Plugin/XML/RSS.html @@ -123,7 +123,7 @@ [% WRAPPER section title="VERSION" -%]

-2.17, distributed as part of the +2.18, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001.

[%- END %] diff --git a/docs/src/Modules/Template/Plugin/XML/Simple.html b/docs/src/Modules/Template/Plugin/XML/Simple.html index aee95165e..7d335f20b 100644 --- a/docs/src/Modules/Template/Plugin/XML/Simple.html +++ b/docs/src/Modules/Template/Plugin/XML/Simple.html @@ -55,7 +55,7 @@ [% WRAPPER section title="VERSION" -%]

-2.16, distributed as part of the +2.17, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001.

[%- END %] diff --git a/docs/src/Modules/Template/Plugin/XML/XPath.html b/docs/src/Modules/Template/Plugin/XML/XPath.html index b846f1942..bbf125044 100644 --- a/docs/src/Modules/Template/Plugin/XML/XPath.html +++ b/docs/src/Modules/Template/Plugin/XML/XPath.html @@ -92,7 +92,7 @@ [% WRAPPER section title="VERSION" -%]

-2.18, distributed as part of the +2.19, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001.

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

-2.22, distributed as part of the +2.23, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001.

[%- END %] diff --git a/docs/src/Modules/Template/Provider.html b/docs/src/Modules/Template/Provider.html index 9b4d28877..351cfdb79 100644 --- a/docs/src/Modules/Template/Provider.html +++ b/docs/src/Modules/Template/Provider.html @@ -367,7 +367,7 @@ [% WRAPPER section title="VERSION" -%]

-2.20, distributed as part of the +2.21, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001.

[%- END %] diff --git a/docs/src/Modules/Template/Service.html b/docs/src/Modules/Template/Service.html index e5e080e68..69a6823ff 100644 --- a/docs/src/Modules/Template/Service.html +++ b/docs/src/Modules/Template/Service.html @@ -430,7 +430,7 @@ [% WRAPPER section title="VERSION" -%]

-2.20, distributed as part of the +2.21, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001.

[%- END %] diff --git a/docs/src/Modules/Template/Stash.html b/docs/src/Modules/Template/Stash.html index 995117ab4..1c5254529 100644 --- a/docs/src/Modules/Template/Stash.html +++ b/docs/src/Modules/Template/Stash.html @@ -158,7 +158,7 @@ [% WRAPPER section title="VERSION" -%]

-2.27, distributed as part of the +2.28, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001.

[%- END %] diff --git a/docs/src/Modules/Template/Test.html b/docs/src/Modules/Template/Test.html index 0e4a6a605..c7b153635 100644 --- a/docs/src/Modules/Template/Test.html +++ b/docs/src/Modules/Template/Test.html @@ -280,7 +280,7 @@ [% WRAPPER section title="VERSION" -%]

-2.19, distributed as part of the +2.20, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001.

[%- END %] diff --git a/docs/src/Modules/index.html b/docs/src/Modules/index.html index e7d51a71b..251a8fe39 100644 --- a/docs/src/Modules/index.html +++ b/docs/src/Modules/index.html @@ -146,6 +146,14 @@ [% END %] +[% WRAPPER ndxitem + link='../Modules/Template/Stash/XS.html' + name='Template::Stash::XS' + title='Experimetal high-speed stash written in XS' +-%] + +[% END %] + [% WRAPPER ndxitem link='../Modules/Template/Test.html' name='Template::Test' diff --git a/docs/src/Release/Changes.html b/docs/src/Release/Changes.html index 06d55dd4a..6d6688492 100644 --- a/docs/src/Release/Changes.html +++ b/docs/src/Release/Changes.html @@ -21,13 +21,20 @@ #======================================================================== #------------------------------------------------------------------------ -# Version 2.04d - 15 Aug 2001 ## DEVELOPER RELEASE ## +# Version 2.04d - 29 Aug 2001 ## DEVELOPER RELEASE ## #------------------------------------------------------------------------ +* Incorporated Doug Steinwand's XS Stash. This adds the files in the + 'xs' directory, t/stash-xs.t, bin/tt-bench.pl and includes some work + on the Makefile.PL to incorporate the required prompting, etc. + * Added gt, ge, lt and le as comparison operators which map directly to their Perl counterparts. Added tests to t/stash.t and relevant documentation to the IF directive. +* Applied some patches from Leon and Doug to enhance the coverage of + the test suite. + * Added 'sorted' as a flag to the HTML plugin to return attributes in sorted order. Mainly for debugging purposes, as used in t/html.t. diff --git a/docs/src/Release/README.html b/docs/src/Release/README.html index 139004715..0f9c90e69 100644 --- a/docs/src/Release/README.html +++ b/docs/src/Release/README.html @@ -99,87 +99,31 @@ WHAT'S NEW? ----------- -Version 2.04 is mainly a bug fixing version. +The most exciting new feature in version 2.05 is 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! -Version 2.03 includes Craig Barratt's 'latex' filter and GD plugins. -The latex filter allow you to create PostScript/PDF/DVI output from -LaTeX source templates. The GD plugins allow you to access the GD::* -modules to create dynamic images using template. +Pretty much everything else in 2.05 and 2.04 before it consisted +of minor bug fixes and improvements. -There have been some improvements to VIEWs and they now work -harmoniously with the XML::XPath and XML::DOM plugins for doing -template based transformations of XML to other formats. The HTML -plugin is new (but currently very basic) and some of the Splash! and -HTML library templates have been updated and some new components added. +Version 2.03 includes 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. -There's a new tutorial from Dave Cross on using the Template Toolkit for -creating and reusing data files. There's various other updates to the -documentation, numerous minor bug fixes and other general improvements. +Version 2.02 was another bugfix release, following shortly on after +version 2.01. This was a major release which contained some of +the following: -Version 2.02 followed shortly on the heels of version 2.01, fixing up -some of the minor installation bugs and other problems that came to -light. Here's a quick summary of what's new since version 2.00. -See the Changes file for more details. + * total overhaul of the documtation -Documentation + * additional of template libraries: POD, HTML, Splash! - * Total overhaul of the documentation: existing content reorganised - into several different sections, documentation added for new - features, a FAQ and also a section on internals. Now also - available in user-customisable HTML format, in addition to POD. + * various new language features including VIEWs -Libraries + * new filters and plugins - * The Template Toolkit now includes template libraries for - generating HTML, PostScript and converting POD to HTML (and other - formats). The Splash! library is a powerful HTML widget set for - generating stylish user interfaces. Includes components for - elements like tables, menu buttons, panels with borders and - header/footer bars, edged boxes with index tabs, etc. - -Language - - * Multiple templates can be specified to directives using '+' - - [% tt_start_tag %] PROCESS header + menu + body + footer - title = "Hello World" - [% tt_end_tag %] - - * Template variables for INCLUDE, etc., can now be full expressions. - - [% tt_start_tag %] INCLUDE header - title = my_title or your_title or default_title - bgcol = (style == 'dark' ? '#000000' : '#ffffff') - [% tt_end_tag %] - - * Namespace prefixes can be used to bind templates to a particular - provider. - - [% tt_start_tag %] INCLUDE file:header + database:header [% tt_end_tag %] - [% tt_start_tag %] INCLUDE http://foo.com/bar [% tt_end_tag %] # alas no 'http' provider...yet - - * Powerful new (but experimental) VIEW directive and/or plugin to - provide dynamic view objects. These can be used to implement - "skins" and other general purpose objects to manage user interface - elements and present views of user data. See Template::Manual::Views - manpage for further details. - - * Various other language enhancements: CHOMP_COLLAPSE option, - 'import=myhash' as magical variable for INCLUDE, etc. - - * New filters: indent, trim and collapse - - * New plugins: File and Directory plugins for file/directory - information. Pod plugin interfaces to Pod::POM for converting - Pod to other formats (e.g. HTML). - -Internals - - * Template::Plugin base class no longer implements AUTOLOAD method. - - * Numerous bugs fixed including some troublesome memory leaks. - - * Various other minor internal improvements. +For more information please consult the Changes file. GENERAL FEATURES @@ -362,6 +306,19 @@ running and that the database you specify exists before executing 'make test' (otherwise, expect a failure for the t/dbi.t test). +The Template Toolkit now boast a high-speed implementation of +Template::Stash written in XS. You can choose to build this as +an optional module for using explicitly as an alternative to +the regular pure-perl stash module. In additional, you can opt +to use the XS Stash as the default, typically making the Template +Toolkit run twice as fast! + +When prompted, answer 'y' or 'n' to build and optionally use +the XS Stash module by default: + + Do you want to build the XS Stash module? [y] + Do you want to use the XS Stash for all Templates? [n] + The latex filter, new to release 2.03, allows you to generate PostScript, PDF and DVI files directly from LaTeX source templates. It relies on 3 external programs which the Makefile.PL script diff --git a/docs/src/Release/TODO.html b/docs/src/Release/TODO.html index 995dcad10..24b3830b8 100644 --- a/docs/src/Release/TODO.html +++ b/docs/src/Release/TODO.html @@ -173,7 +173,9 @@ * Stas Bekman raised the issue of the Stash not being able to correctly differentiate between scalar/list context and in particular, the - cgi.param examples not working as expected. + cgi.param examples not working as expected. This is fixed in v3 and + in Craig's Stash/Context.pm which does the right lookahead to allow + 'scalar' and 'list' postfix operators. e.g. cgi.param.list * Richard Tietjen's patch for stash replace. Allows back references (e.g. $1) but it would be nice to find a rock-solid way to implement @@ -182,19 +184,6 @@ * Have stash, etc., add current template name/line when reporting errors. (may be tricky under the current implementation) -* I've written a version of Template::Stash in XS which should give a - significant speedup to the runtime processing. It's 95% complete - (but hasn't been updated to keep up with more recent changes to the - stash) and just needs some minor debugging and testing. The new - Template::Stash will automatically load the existing Perl version if - you don't have a C compiler on your platform (shame on you!). - -* And I'm now working on Yet Another Brand New Stash which should - implement all the functionality of Craig's latest patches, rationalise - all sorts of stuff, improve debugging, *AND* run slightly faster. - Furthermore, the new architecture should be much easier to extend - and implement in XS. Watch the mailing list for further details. - #------------------------------------------------------------------------ # Parser diff --git a/docs/src/Tools/tpage.html b/docs/src/Tools/tpage.html index 67569a712..1f02654a9 100644 --- a/docs/src/Tools/tpage.html +++ b/docs/src/Tools/tpage.html @@ -61,7 +61,7 @@ [% WRAPPER section title="VERSION" -%]

-2.18, distributed as part of the +2.19, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001.

[%- END %] diff --git a/docs/src/Tools/ttree.html b/docs/src/Tools/ttree.html index 696415ed5..850ee2f00 100644 --- a/docs/src/Tools/ttree.html +++ b/docs/src/Tools/ttree.html @@ -112,7 +112,7 @@ [% WRAPPER section title="VERSION" -%]

-2.18, distributed as part of the +2.19, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001.

[%- END %] diff --git a/docsrc/src/Release/Changes.tt2 b/docsrc/src/Release/Changes.tt2 index 3e6803b1b..41db03ca0 100644 --- a/docsrc/src/Release/Changes.tt2 +++ b/docsrc/src/Release/Changes.tt2 @@ -18,13 +18,20 @@ #======================================================================== #------------------------------------------------------------------------ -# Version 2.04d - 15 Aug 2001 ## DEVELOPER RELEASE ## +# Version 2.04d - 29 Aug 2001 ## DEVELOPER RELEASE ## #------------------------------------------------------------------------ +* Incorporated Doug Steinwand's XS Stash. This adds the files in the + 'xs' directory, t/stash-xs.t, bin/tt-bench.pl and includes some work + on the Makefile.PL to incorporate the required prompting, etc. + * Added gt, ge, lt and le as comparison operators which map directly to their Perl counterparts. Added tests to t/stash.t and relevant documentation to the IF directive. +* Applied some patches from Leon and Doug to enhance the coverage of + the test suite. + * Added 'sorted' as a flag to the HTML plugin to return attributes in sorted order. Mainly for debugging purposes, as used in t/html.t. diff --git a/docsrc/src/Release/README.tt2 b/docsrc/src/Release/README.tt2 index 16669048b..a32ad8d5a 100644 --- a/docsrc/src/Release/README.tt2 +++ b/docsrc/src/Release/README.tt2 @@ -91,87 +91,31 @@ appropriate sex, then you can always return it for a full refund. :-) WHAT'S NEW? ----------- -Version 2.04 is mainly a bug fixing version. +The most exciting new feature in version 2.05 is 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! -Version 2.03 includes Craig Barratt's 'latex' filter and GD plugins. -The latex filter allow you to create PostScript/PDF/DVI output from -LaTeX source templates. The GD plugins allow you to access the GD::* -modules to create dynamic images using template. +Pretty much everything else in 2.05 and 2.04 before it consisted +of minor bug fixes and improvements. -There have been some improvements to VIEWs and they now work -harmoniously with the XML::XPath and XML::DOM plugins for doing -template based transformations of XML to other formats. The HTML -plugin is new (but currently very basic) and some of the Splash! and -HTML library templates have been updated and some new components added. +Version 2.03 includes 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. -There's a new tutorial from Dave Cross on using the Template Toolkit for -creating and reusing data files. There's various other updates to the -documentation, numerous minor bug fixes and other general improvements. +Version 2.02 was another bugfix release, following shortly on after +version 2.01. This was a major release which contained some of +the following: -Version 2.02 followed shortly on the heels of version 2.01, fixing up -some of the minor installation bugs and other problems that came to -light. Here's a quick summary of what's new since version 2.00. -See the Changes file for more details. + * total overhaul of the documtation -Documentation + * additional of template libraries: POD, HTML, Splash! - * Total overhaul of the documentation: existing content reorganised - into several different sections, documentation added for new - features, a FAQ and also a section on internals. Now also - available in user-customisable HTML format, in addition to POD. + * various new language features including VIEWs -Libraries + * new filters and plugins - * The Template Toolkit now includes template libraries for - generating HTML, PostScript and converting POD to HTML (and other - formats). The Splash! library is a powerful HTML widget set for - generating stylish user interfaces. Includes components for - elements like tables, menu buttons, panels with borders and - header/footer bars, edged boxes with index tabs, etc. - -Language - - * Multiple templates can be specified to directives using '+' - - [% PROCESS header + menu + body + footer - title = "Hello World" - %] - - * Template variables for INCLUDE, etc., can now be full expressions. - - [% INCLUDE header - title = my_title or your_title or default_title - bgcol = (style == 'dark' ? '#000000' : '#ffffff') - %] - - * Namespace prefixes can be used to bind templates to a particular - provider. - - [% INCLUDE file:header + database:header %] - [% INCLUDE http://foo.com/bar %] # alas no 'http' provider...yet - - * Powerful new (but experimental) VIEW directive and/or plugin to - provide dynamic view objects. These can be used to implement - "skins" and other general purpose objects to manage user interface - elements and present views of user data. See Template::Manual::Views - manpage for further details. - - * Various other language enhancements: CHOMP_COLLAPSE option, - 'import=myhash' as magical variable for INCLUDE, etc. - - * New filters: indent, trim and collapse - - * New plugins: File and Directory plugins for file/directory - information. Pod plugin interfaces to Pod::POM for converting - Pod to other formats (e.g. HTML). - -Internals - - * Template::Plugin base class no longer implements AUTOLOAD method. - - * Numerous bugs fixed including some troublesome memory leaks. - - * Various other minor internal improvements. +For more information please consult the Changes file. GENERAL FEATURES @@ -354,6 +298,19 @@ the relevant database. Please ensure that your database server is running and that the database you specify exists before executing 'make test' (otherwise, expect a failure for the t/dbi.t test). +The Template Toolkit now boast a high-speed implementation of +Template::Stash written in XS. You can choose to build this as +an optional module for using explicitly as an alternative to +the regular pure-perl stash module. In additional, you can opt +to use the XS Stash as the default, typically making the Template +Toolkit run twice as fast! + +When prompted, answer 'y' or 'n' to build and optionally use +the XS Stash module by default: + + Do you want to build the XS Stash module? [y] + Do you want to use the XS Stash for all Templates? [n] + The latex filter, new to release 2.03, allows you to generate PostScript, PDF and DVI files directly from LaTeX source templates. It relies on 3 external programs which the Makefile.PL script diff --git a/docsrc/src/Release/TODO.tt2 b/docsrc/src/Release/TODO.tt2 index b67af14dc..da3dc9380 100644 --- a/docsrc/src/Release/TODO.tt2 +++ b/docsrc/src/Release/TODO.tt2 @@ -170,7 +170,9 @@ * Stas Bekman raised the issue of the Stash not being able to correctly differentiate between scalar/list context and in particular, the - cgi.param examples not working as expected. + cgi.param examples not working as expected. This is fixed in v3 and + in Craig's Stash/Context.pm which does the right lookahead to allow + 'scalar' and 'list' postfix operators. e.g. cgi.param.list * Richard Tietjen's patch for stash replace. Allows back references (e.g. $1) but it would be nice to find a rock-solid way to implement @@ -179,19 +181,6 @@ * Have stash, etc., add current template name/line when reporting errors. (may be tricky under the current implementation) -* I've written a version of Template::Stash in XS which should give a - significant speedup to the runtime processing. It's 95% complete - (but hasn't been updated to keep up with more recent changes to the - stash) and just needs some minor debugging and testing. The new - Template::Stash will automatically load the existing Perl version if - you don't have a C compiler on your platform (shame on you!). - -* And I'm now working on Yet Another Brand New Stash which should - implement all the functionality of Craig's latest patches, rationalise - all sorts of stuff, improve debugging, *AND* run slightly faster. - Furthermore, the new architecture should be much easier to extend - and implement in XS. Watch the mailing list for further details. - #------------------------------------------------------------------------ # Parser diff --git a/docsrc/xml/ttdocs.xml b/docsrc/xml/ttdocs.xml index 321ebdac5..bd7a074fc 100644 --- a/docsrc/xml/ttdocs.xml +++ b/docsrc/xml/ttdocs.xml @@ -324,6 +324,14 @@ module="1" seealso="Template::Stash"/> + + + =head1 VERSION -2.21, distributed as part of the +2.22, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001. =head1 COPYRIGHT diff --git a/lib/Template/Config.pm b/lib/Template/Config.pm index a5406cd4b..5ac5c9c5c 100644 --- a/lib/Template/Config.pm +++ b/lib/Template/Config.pm @@ -42,10 +42,10 @@ $PARSER = 'Template::Parser'; $PLUGINS = 'Template::Plugins'; $PROVIDER = 'Template::Provider'; $SERVICE = 'Template::Service'; -$STASH = 'Template::Stash::XS'; +$STASH = 'Template::Stash'; # the following is set at installation time by the Makefile.PL -$INSTDIR = '/usr/local/tt2'; +$INSTDIR = ''; # LaTeX executable paths set at installation time by the Makefile.PL # Empty strings cause the latex(pdf|dvi|ps) filters to throw an error. @@ -392,7 +392,7 @@ L =head1 VERSION -2.19, distributed as part of the +2.21, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001. =head1 COPYRIGHT diff --git a/lib/Template/Constants.pm b/lib/Template/Constants.pm index aa215fced..126663ccd 100644 --- a/lib/Template/Constants.pm +++ b/lib/Template/Constants.pm @@ -162,7 +162,7 @@ L =head1 VERSION -2.20, distributed as part of the +2.21, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001. =head1 COPYRIGHT diff --git a/lib/Template/Context.pm b/lib/Template/Context.pm index 7458dc418..7f64e1d12 100644 --- a/lib/Template/Context.pm +++ b/lib/Template/Context.pm @@ -1419,7 +1419,7 @@ L =head1 VERSION -2.26, distributed as part of the +2.27, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001. =head1 COPYRIGHT diff --git a/lib/Template/Document.pm b/lib/Template/Document.pm index a13a3c7aa..0d02b2893 100644 --- a/lib/Template/Document.pm +++ b/lib/Template/Document.pm @@ -450,7 +450,7 @@ L =head1 VERSION -2.21, distributed as part of the +2.22, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001. =head1 COPYRIGHT diff --git a/lib/Template/Exception.pm b/lib/Template/Exception.pm index f92d39d2f..97d9d0884 100644 --- a/lib/Template/Exception.pm +++ b/lib/Template/Exception.pm @@ -228,7 +228,7 @@ L =head1 VERSION -2.17, distributed as part of the +2.18, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001. =head1 COPYRIGHT diff --git a/lib/Template/FAQ.pod b/lib/Template/FAQ.pod index b4b6bc6dc..839d05a43 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.18 +# 2.19 # #======================================================================== @@ -202,7 +202,7 @@ L =head1 VERSION -2.18, distributed as part of the +2.19, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001. =head1 COPYRIGHT diff --git a/lib/Template/Filters.pm b/lib/Template/Filters.pm index f91bb9a7b..f173318e2 100644 --- a/lib/Template/Filters.pm +++ b/lib/Template/Filters.pm @@ -1208,7 +1208,7 @@ L =head1 VERSION -2.22, distributed as part of the +2.23, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001. =head1 COPYRIGHT diff --git a/lib/Template/Iterator.pm b/lib/Template/Iterator.pm index 89d992b9e..8c190e44b 100644 --- a/lib/Template/Iterator.pm +++ b/lib/Template/Iterator.pm @@ -430,7 +430,7 @@ L =head1 VERSION -2.19, distributed as part of the +2.20, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001. =head1 COPYRIGHT diff --git a/lib/Template/Library/HTML.pod b/lib/Template/Library/HTML.pod index f4c454e74..b81fbe5b9 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.18 +# 2.19 # #======================================================================== @@ -290,7 +290,7 @@ L =head1 VERSION -2.18, distributed as part of the +2.19, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001. =head1 COPYRIGHT diff --git a/lib/Template/Library/PostScript.pod b/lib/Template/Library/PostScript.pod index 59983e0d8..9335c16c2 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.18 +# 2.19 # #======================================================================== @@ -54,7 +54,7 @@ L =head1 VERSION -2.18, distributed as part of the +2.19, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001. =head1 COPYRIGHT diff --git a/lib/Template/Library/Splash.pod b/lib/Template/Library/Splash.pod index 9ed9e2b80..1c3285a5d 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.18 +# 2.19 # #======================================================================== @@ -1004,7 +1004,7 @@ L =head1 VERSION -2.18, distributed as part of the +2.19, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001. =head1 COPYRIGHT diff --git a/lib/Template/Modules.pod b/lib/Template/Modules.pod index 4baa4d472..3b1760f59 100644 --- a/lib/Template/Modules.pod +++ b/lib/Template/Modules.pod @@ -140,6 +140,12 @@ Experimetal stash allowing list/scalar context definition +=item L + +Experimetal high-speed stash written in XS + + + =item L Module for automating TT2 test scripts diff --git a/lib/Template/Parser.pm b/lib/Template/Parser.pm index 1cdc1bed7..4dbdbda70 100644 --- a/lib/Template/Parser.pm +++ b/lib/Template/Parser.pm @@ -1268,7 +1268,7 @@ L =head1 VERSION -2.25, distributed as part of the +2.26, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001. diff --git a/lib/Template/Plugin.pm b/lib/Template/Plugin.pm index 76dee74d9..68cdc2bb5 100644 --- a/lib/Template/Plugin.pm +++ b/lib/Template/Plugin.pm @@ -383,7 +383,7 @@ L =head1 VERSION -2.20, distributed as part of the +2.21, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001. =head1 COPYRIGHT diff --git a/lib/Template/Plugin/Autoformat.pm b/lib/Template/Plugin/Autoformat.pm index 0b76937ff..e86b16f0d 100644 --- a/lib/Template/Plugin/Autoformat.pm +++ b/lib/Template/Plugin/Autoformat.pm @@ -224,7 +224,7 @@ module (in his copious spare time :-) which does all the clever stuff. =head1 VERSION -2.19, distributed as part of the +2.20, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001. diff --git a/lib/Template/Plugin/CGI.pm b/lib/Template/Plugin/CGI.pm index 1e6ed8f37..ee6885413 100644 --- a/lib/Template/Plugin/CGI.pm +++ b/lib/Template/Plugin/CGI.pm @@ -107,7 +107,7 @@ L =head1 VERSION -2.18, distributed as part of the +2.19, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001. =head1 COPYRIGHT diff --git a/lib/Template/Plugin/Datafile.pm b/lib/Template/Plugin/Datafile.pm index ca7e7624d..e8d4ca4f2 100644 --- a/lib/Template/Plugin/Datafile.pm +++ b/lib/Template/Plugin/Datafile.pm @@ -169,7 +169,7 @@ L =head1 VERSION -2.20, distributed as part of the +2.21, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001. =head1 COPYRIGHT diff --git a/lib/Template/Plugin/Date.pm b/lib/Template/Plugin/Date.pm index 7984a1441..ea73b35d7 100644 --- a/lib/Template/Plugin/Date.pm +++ b/lib/Template/Plugin/Date.pm @@ -280,7 +280,7 @@ fixups/enhancements, a test script and documentation. =head1 VERSION -2.18, distributed as part of the +2.19, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001. diff --git a/lib/Template/Plugin/Directory.pm b/lib/Template/Plugin/Directory.pm index 320321d44..077aea79a 100644 --- a/lib/Template/Plugin/Directory.pm +++ b/lib/Template/Plugin/Directory.pm @@ -394,7 +394,7 @@ for VIEW support, and made a few other minor tweaks. =head1 VERSION -2.18, distributed as part of the +2.19, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001. diff --git a/lib/Template/Plugin/Dumper.pm b/lib/Template/Plugin/Dumper.pm index 3111960bb..8e0c05a85 100644 --- a/lib/Template/Plugin/Dumper.pm +++ b/lib/Template/Plugin/Dumper.pm @@ -159,7 +159,7 @@ Simon Matthews Esam@knowledgepool.comE =head1 VERSION -2.18, distributed as part of the +2.19, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001. diff --git a/lib/Template/Plugin/File.pm b/lib/Template/Plugin/File.pm index 160c2de44..e9d906653 100644 --- a/lib/Template/Plugin/File.pm +++ b/lib/Template/Plugin/File.pm @@ -400,7 +400,7 @@ for VIEW support, and made a few other minor tweaks. =head1 VERSION -2.18, distributed as part of the +2.19, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001. diff --git a/lib/Template/Plugin/Format.pm b/lib/Template/Plugin/Format.pm index 7620fc68a..1601efa12 100644 --- a/lib/Template/Plugin/Format.pm +++ b/lib/Template/Plugin/Format.pm @@ -94,7 +94,7 @@ L =head1 VERSION -2.19, distributed as part of the +2.20, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001. =head1 COPYRIGHT diff --git a/lib/Template/Plugin/GD/Constants.pm b/lib/Template/Plugin/GD/Constants.pm index 105d7b28a..9e29de894 100644 --- a/lib/Template/Plugin/GD/Constants.pm +++ b/lib/Template/Plugin/GD/Constants.pm @@ -110,7 +110,7 @@ Lincoln D. Stein wrote the GD.pm interface to the GD library. =head1 VERSION -1.10, distributed as part of the +1.11, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001. =head1 COPYRIGHT diff --git a/lib/Template/Plugin/GD/Graph/area.pm b/lib/Template/Plugin/GD/Graph/area.pm index 4e1e5c0c0..fb287cd7e 100644 --- a/lib/Template/Plugin/GD/Graph/area.pm +++ b/lib/Template/Plugin/GD/Graph/area.pm @@ -112,7 +112,7 @@ The GD::Graph module was written by Martien Verbruggen. =head1 VERSION -1.10, distributed as part of the +1.11, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001. =head1 COPYRIGHT diff --git a/lib/Template/Plugin/GD/Graph/bars.pm b/lib/Template/Plugin/GD/Graph/bars.pm index 457ef1ad6..6cab3545c 100644 --- a/lib/Template/Plugin/GD/Graph/bars.pm +++ b/lib/Template/Plugin/GD/Graph/bars.pm @@ -155,7 +155,7 @@ The GD::Graph module was written by Martien Verbruggen. =head1 VERSION -1.10, distributed as part of the +1.11, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001. =head1 COPYRIGHT diff --git a/lib/Template/Plugin/GD/Graph/bars3d.pm b/lib/Template/Plugin/GD/Graph/bars3d.pm index 4300be6bc..b4fda774c 100644 --- a/lib/Template/Plugin/GD/Graph/bars3d.pm +++ b/lib/Template/Plugin/GD/Graph/bars3d.pm @@ -130,7 +130,7 @@ The GD::Graph3d module was written by Jeremy Wadsack. =head1 VERSION -1.10, distributed as part of the +1.11, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001. =head1 COPYRIGHT diff --git a/lib/Template/Plugin/GD/Graph/lines.pm b/lib/Template/Plugin/GD/Graph/lines.pm index bbd58148a..ac1ad776a 100644 --- a/lib/Template/Plugin/GD/Graph/lines.pm +++ b/lib/Template/Plugin/GD/Graph/lines.pm @@ -142,7 +142,7 @@ The GD::Graph module was written by Martien Verbruggen. =head1 VERSION -1.10, distributed as part of the +1.11, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001. =head1 COPYRIGHT diff --git a/lib/Template/Plugin/GD/Graph/lines3d.pm b/lib/Template/Plugin/GD/Graph/lines3d.pm index 7b7ceef53..c402844aa 100644 --- a/lib/Template/Plugin/GD/Graph/lines3d.pm +++ b/lib/Template/Plugin/GD/Graph/lines3d.pm @@ -130,7 +130,7 @@ The GD::Graph3d module was written by Jeremy Wadsack. =head1 VERSION -1.10, distributed as part of the +1.11, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001. =head1 COPYRIGHT diff --git a/lib/Template/Plugin/GD/Graph/linespoints.pm b/lib/Template/Plugin/GD/Graph/linespoints.pm index 5a305747e..be648800e 100644 --- a/lib/Template/Plugin/GD/Graph/linespoints.pm +++ b/lib/Template/Plugin/GD/Graph/linespoints.pm @@ -122,7 +122,7 @@ The GD::Graph module was written by Martien Verbruggen. =head1 VERSION -1.10, distributed as part of the +1.11, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001. =head1 COPYRIGHT diff --git a/lib/Template/Plugin/GD/Graph/mixed.pm b/lib/Template/Plugin/GD/Graph/mixed.pm index 120f36c88..cb05eb2ff 100644 --- a/lib/Template/Plugin/GD/Graph/mixed.pm +++ b/lib/Template/Plugin/GD/Graph/mixed.pm @@ -140,7 +140,7 @@ The GD::Graph module was written by Martien Verbruggen. =head1 VERSION -1.10, distributed as part of the +1.11, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001. =head1 COPYRIGHT diff --git a/lib/Template/Plugin/GD/Graph/pie.pm b/lib/Template/Plugin/GD/Graph/pie.pm index c42ef5e94..9828652bd 100644 --- a/lib/Template/Plugin/GD/Graph/pie.pm +++ b/lib/Template/Plugin/GD/Graph/pie.pm @@ -113,7 +113,7 @@ The GD::Graph module was written by Martien Verbruggen. =head1 VERSION -1.10, distributed as part of the +1.11, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001. =head1 COPYRIGHT diff --git a/lib/Template/Plugin/GD/Graph/pie3d.pm b/lib/Template/Plugin/GD/Graph/pie3d.pm index 2fd00924d..7c1abd4d6 100644 --- a/lib/Template/Plugin/GD/Graph/pie3d.pm +++ b/lib/Template/Plugin/GD/Graph/pie3d.pm @@ -117,7 +117,7 @@ The GD::Graph3d module was written by Jeremy Wadsack. The GD::Graph module was w =head1 VERSION -1.10, distributed as part of the +1.11, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001. =head1 COPYRIGHT diff --git a/lib/Template/Plugin/GD/Graph/points.pm b/lib/Template/Plugin/GD/Graph/points.pm index ff7e309a0..8f0d85dee 100644 --- a/lib/Template/Plugin/GD/Graph/points.pm +++ b/lib/Template/Plugin/GD/Graph/points.pm @@ -119,7 +119,7 @@ The GD::Graph module was written by Martien Verbruggen. =head1 VERSION -1.10, distributed as part of the +1.11, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001. =head1 COPYRIGHT diff --git a/lib/Template/Plugin/GD/Image.pm b/lib/Template/Plugin/GD/Image.pm index 4ff4ca866..8e72f6912 100644 --- a/lib/Template/Plugin/GD/Image.pm +++ b/lib/Template/Plugin/GD/Image.pm @@ -156,7 +156,7 @@ Lincoln D. Stein wrote the GD.pm interface to the GD library. =head1 VERSION -1.10, distributed as part of the +1.11, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001. =head1 COPYRIGHT diff --git a/lib/Template/Plugin/GD/Polygon.pm b/lib/Template/Plugin/GD/Polygon.pm index 2a7695638..a2057e381 100644 --- a/lib/Template/Plugin/GD/Polygon.pm +++ b/lib/Template/Plugin/GD/Polygon.pm @@ -127,7 +127,7 @@ Lincoln D. Stein wrote the GD.pm interface to the GD library. =head1 VERSION -1.10, distributed as part of the +1.11, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001. =head1 COPYRIGHT diff --git a/lib/Template/Plugin/GD/Text.pm b/lib/Template/Plugin/GD/Text.pm index 2ee076d05..bfb166e65 100644 --- a/lib/Template/Plugin/GD/Text.pm +++ b/lib/Template/Plugin/GD/Text.pm @@ -112,7 +112,7 @@ The GD::Text module was written by Martien Verbruggen. =head1 VERSION -1.10, distributed as part of the +1.11, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001. =head1 COPYRIGHT diff --git a/lib/Template/Plugin/GD/Text/Align.pm b/lib/Template/Plugin/GD/Text/Align.pm index 83bbc1579..ecbc1a1e3 100644 --- a/lib/Template/Plugin/GD/Text/Align.pm +++ b/lib/Template/Plugin/GD/Text/Align.pm @@ -119,7 +119,7 @@ The GD::Text module was written by Martien Verbruggen. =head1 VERSION -1.10, distributed as part of the +1.11, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001. =head1 COPYRIGHT diff --git a/lib/Template/Plugin/GD/Text/Wrap.pm b/lib/Template/Plugin/GD/Text/Wrap.pm index 593b4f3ff..494b43262 100644 --- a/lib/Template/Plugin/GD/Text/Wrap.pm +++ b/lib/Template/Plugin/GD/Text/Wrap.pm @@ -155,7 +155,7 @@ The GD::Text module was written by Martien Verbruggen. =head1 VERSION -1.10, distributed as part of the +1.11, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001. =head1 COPYRIGHT diff --git a/lib/Template/Plugin/HTML.pm b/lib/Template/Plugin/HTML.pm index 4a70f3bf2..55db2697c 100644 --- a/lib/Template/Plugin/HTML.pm +++ b/lib/Template/Plugin/HTML.pm @@ -153,6 +153,13 @@ it is useful to have attributes generated in a deterministic order rather than whatever order the hash happened to feel like returning the keys in. + [% USE HTML(sorted=1) %] + [% HTML.element( foo => { charlie => 1, bravo => 2, alpha => 3 } ) %] + +generates: + + + =head1 AUTHOR Andy Wardley Eabw@kfs.orgE @@ -164,7 +171,7 @@ L =head1 VERSION -2.11, distributed as part of the +2.12, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001. =head1 COPYRIGHT diff --git a/lib/Template/Plugin/Iterator.pm b/lib/Template/Plugin/Iterator.pm index b3900f6dc..2dec73c5f 100644 --- a/lib/Template/Plugin/Iterator.pm +++ b/lib/Template/Plugin/Iterator.pm @@ -92,7 +92,7 @@ L =head1 VERSION -2.17, distributed as part of the +2.18, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001. =head1 COPYRIGHT diff --git a/lib/Template/Plugin/Pod.pm b/lib/Template/Plugin/Pod.pm index 15b856be7..0d9842061 100644 --- a/lib/Template/Plugin/Pod.pm +++ b/lib/Template/Plugin/Pod.pm @@ -89,7 +89,7 @@ L =head1 VERSION -2.16, distributed as part of the +2.17, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001. =head1 COPYRIGHT diff --git a/lib/Template/Plugin/Table.pm b/lib/Template/Plugin/Table.pm index 3b4396d78..4a065e826 100644 --- a/lib/Template/Plugin/Table.pm +++ b/lib/Template/Plugin/Table.pm @@ -423,7 +423,7 @@ L =head1 VERSION -2.19, distributed as part of the +2.20, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001. =head1 COPYRIGHT diff --git a/lib/Template/Plugin/URL.pm b/lib/Template/Plugin/URL.pm index efa6d7cbc..73b215155 100644 --- a/lib/Template/Plugin/URL.pm +++ b/lib/Template/Plugin/URL.pm @@ -199,7 +199,7 @@ L =head1 VERSION -2.19, distributed as part of the +2.20, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001. =head1 COPYRIGHT diff --git a/lib/Template/Plugin/View.pm b/lib/Template/Plugin/View.pm index f78005665..a4bb39211 100644 --- a/lib/Template/Plugin/View.pm +++ b/lib/Template/Plugin/View.pm @@ -101,7 +101,7 @@ L =head1 VERSION -2.18, distributed as part of the +2.19, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001. =head1 COPYRIGHT diff --git a/lib/Template/Plugin/Wrap.pm b/lib/Template/Plugin/Wrap.pm index aac37ce3e..c1bc3f67b 100644 --- a/lib/Template/Plugin/Wrap.pm +++ b/lib/Template/Plugin/Wrap.pm @@ -145,7 +145,7 @@ others. =head1 VERSION -2.18, distributed as part of the +2.19, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001. =head1 COPYRIGHT diff --git a/lib/Template/Plugin/XML/RSS.pm b/lib/Template/Plugin/XML/RSS.pm index dbe5e259d..dd6f30e94 100644 --- a/lib/Template/Plugin/XML/RSS.pm +++ b/lib/Template/Plugin/XML/RSS.pm @@ -168,7 +168,7 @@ Eeisen@pobox.comE. =head1 VERSION -2.17, distributed as part of the +2.18, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001. =head1 COPYRIGHT diff --git a/lib/Template/Plugin/XML/Simple.pm b/lib/Template/Plugin/XML/Simple.pm index a9aa604cc..bbaaa580b 100644 --- a/lib/Template/Plugin/XML/Simple.pm +++ b/lib/Template/Plugin/XML/Simple.pm @@ -107,7 +107,7 @@ was written by Grant McLean Egrantm@web.co.nzE. =head1 VERSION -2.16, distributed as part of the +2.17, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001. =head1 COPYRIGHT diff --git a/lib/Template/Plugin/XML/XPath.pm b/lib/Template/Plugin/XML/XPath.pm index 6752ba22b..d6985bc8e 100644 --- a/lib/Template/Plugin/XML/XPath.pm +++ b/lib/Template/Plugin/XML/XPath.pm @@ -222,7 +222,7 @@ The XML::XPath module is by Matt Sergeant Ematt@sergeant.orgE. =head1 VERSION -2.18, distributed as part of the +2.19, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001. =head1 COPYRIGHT diff --git a/lib/Template/Plugins.pm b/lib/Template/Plugins.pm index c71fb046d..a2938d3c0 100644 --- a/lib/Template/Plugins.pm +++ b/lib/Template/Plugins.pm @@ -883,7 +883,7 @@ L =head1 VERSION -2.22, distributed as part of the +2.23, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001. =head1 COPYRIGHT diff --git a/lib/Template/Provider.pm b/lib/Template/Provider.pm index c0c5d892d..685649bcb 100644 --- a/lib/Template/Provider.pm +++ b/lib/Template/Provider.pm @@ -1236,7 +1236,7 @@ L =head1 VERSION -2.20, distributed as part of the +2.21, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001. =head1 COPYRIGHT diff --git a/lib/Template/Service.pm b/lib/Template/Service.pm index 67ac2d743..55151937a 100644 --- a/lib/Template/Service.pm +++ b/lib/Template/Service.pm @@ -709,7 +709,7 @@ L =head1 VERSION -2.20, distributed as part of the +2.21, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001. =head1 COPYRIGHT diff --git a/lib/Template/Stash.pm b/lib/Template/Stash.pm index 19d1a8eb7..10396a547 100644 --- a/lib/Template/Stash.pm +++ b/lib/Template/Stash.pm @@ -810,7 +810,7 @@ L =head1 VERSION -2.27, distributed as part of the +2.28, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001. =head1 COPYRIGHT diff --git a/lib/Template/Stash/Context.pm b/lib/Template/Stash/Context.pm index ec246079a..f4a3ad0a8 100644 --- a/lib/Template/Stash/Context.pm +++ b/lib/Template/Stash/Context.pm @@ -867,7 +867,7 @@ L =head1 VERSION -1.10, distributed as part of the +1.11, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001. =head1 COPYRIGHT diff --git a/lib/Template/Stash/XS.pm b/lib/Template/Stash/XS.pm index 7f7644151..ee21148a5 100644 --- a/lib/Template/Stash/XS.pm +++ b/lib/Template/Stash/XS.pm @@ -51,17 +51,29 @@ sub AUTOLOAD { __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::Stash::XS - Experimental high-speed stash +Template::Stash::XS - Experimetal high-speed stash written in XS =head1 SYNOPSIS - use Template::Stash; - use Template::Stash::XS; + use Template; + use Template::Stash::XS; - my $stash = Template::Stash::XS->new(); - my $tt = Template->new({ STASH => $stash }); + my $stash = Template::Stash::XS->new(\%vars); + my $tt2 = Template->new({ STASH => $stash }); =head1 DESCRIPTION @@ -88,7 +100,6 @@ object: $Template::Config::STASH = 'Template::Stash::XS'; - To use the original, pure-perl version restore this line in Template/Config.pm: @@ -98,18 +109,38 @@ Or in your code: $Template::Config::STASH = 'Template::Stash'; +You can elect to have this performed once for you at installation +time by answering 'y' or 'n' to the question that asks if you want +to make the XS Stash the default. =head1 BUGS Please report bugs to the Template Toolkit mailing list templates@template-toolkit.org +=head1 AUTHORS + +Andy Wardley Eabw@tt2.orgE + +Doug Steinwand Edsteinwand@citysearch.comE + =head1 VERSION -$Id$ +Template Toolkit version 2.04d, released on 29 August 2001. + + + +=head1 COPYRIGHT + + Copyright (C) 1996-2001 Andy Wardley. All Rights Reserved. + Copyright (C) 1998-2001 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 - diff --git a/lib/Template/Test.pm b/lib/Template/Test.pm index 9fca433ea..2db6fb60e 100644 --- a/lib/Template/Test.pm +++ b/lib/Template/Test.pm @@ -616,7 +616,7 @@ L =head1 VERSION -2.19, distributed as part of the +2.20, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001. =head1 COPYRIGHT diff --git a/lib/Template/Tools/tpage.pod b/lib/Template/Tools/tpage.pod index 69035405c..bd80e2314 100644 --- a/lib/Template/Tools/tpage.pod +++ b/lib/Template/Tools/tpage.pod @@ -50,7 +50,7 @@ L =head1 VERSION -2.18, distributed as part of the +2.19, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001. =head1 COPYRIGHT diff --git a/lib/Template/Tools/ttree.pod b/lib/Template/Tools/ttree.pod index cecca95d4..047ba81ab 100644 --- a/lib/Template/Tools/ttree.pod +++ b/lib/Template/Tools/ttree.pod @@ -97,7 +97,7 @@ L =head1 VERSION -2.18, distributed as part of the +2.19, distributed as part of the Template Toolkit version 2.04d, released on 29 August 2001. =head1 COPYRIGHT