[%#
  # 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.
-%]
[% META book = 'Modules'
        page = 'Toolkit'
%]
[%  WRAPPER toc;
	PROCESS tocitem 
	        title ="SYNOPSIS"
                subs  = [];
	PROCESS tocitem 
	        title ="DESCRIPTION"
                subs  = [];
	PROCESS tocitem 
	        title ="AUTHOR"
                subs  = [];
	PROCESS tocitem 
	        title ="VERSION"
                subs  = [];
	PROCESS tocitem 
	        title ="COPYRIGHT"
                subs  = [];
	PROCESS tocitem 
	        title ="SEE ALSO"
                subs  = [];
    END
%]
<!-- Pod to HTML conversion by the Template Toolkit version 2 -->
[% WRAPPER section
    title="SYNOPSIS"
-%]<pre>    $ perldoc Template              # docs for the Template Perl module</pre>
<pre>    $ perldoc Template::Manual      # Template Toolkit manual</pre>
[%- END %]
[% WRAPPER section
    title="DESCRIPTION"
-%]<p>
The Template Toolkit is a collection of Perl modules which implement a
fast, flexible, powerful and extensible template processing system.
</p>
<p>
It was originally designed and remains primarily useful for generating
dynamic web content.  Howver it can be used equally well for
processing any other kind of text based documents including HTML, XML,
POD, PostScript, LaTeX and plain old text.
</p>
<p>
The Template::Manual documentation contains further information about
the Template Toolkit and a full reference of all the features,
directives, configuration options and so on.
</p>
<pre>    $ perldoc Template::Manual</pre>
<p>
The Template module is the front-end to the Template Toolkit for Perl
programmers.  The documentation for that module relates specifically
to using the module from Perl programs.  
</p>
<pre>    $ perldoc Template</pre>
<p>
Please note that there is no Template::Toolkit Perl module, just this
documentation pointing people to the right place.  
</p>
<p>
You're welcome to refer to TT as &quot;Template Toolkit&quot; or
&quot;Template::Toolkit&quot; if you prefer.  The official line is that we talk
about the &quot;Template Toolkit&quot; software and the &quot;Template&quot; Perl module.
But we're not the kind of officials who would get all official on you.
</p>
<p>
You don't need to be a Perl programmer to use the Template Toolkit.
The <file>tpage</file> and <file>ttree</file> scripts allow you to process templates from
the command line.  See the documentation for those scripts for further
information.
</p>
<pre>    $ perldoc tpage
    $ perldoc ttree</pre>
<p>
Finally, don't forget to check out the Template Toolkit web site.
</p>
<pre>    http://template-toolkit.org/</pre>
<p>
Yes, we know it doesn't look very pretty and should use CSS instead of
tables for layout.  We'll have a shiny new web site when TT3 is
released.  In case you're wondering, that'll be on Tuesday some time
shortly after lunch...
</p>
[%- END %]
[% WRAPPER section
    title="AUTHOR"
-%]<p>
Andy Wardley &lt;abw@wardley.org&gt;
</p>
<p>
[% ttlink('http://wardley.org/', 'http://wardley.org/') -%]
</p>
[%- END %]
[% WRAPPER section
    title="VERSION"
-%]<p>
2.75, distributed as part of the
Template Toolkit version 2.19, released on 27 April 2007.
</p>
[%- END %]
[% WRAPPER section
    title="COPYRIGHT"
-%]<pre>  Copyright (C) 1996-2007 Andy Wardley.  All Rights Reserved.</pre>
<p>
This module is free software; you can redistribute it and/or
modify it under the same terms as Perl itself.
</p>
[%- END %]
[% WRAPPER section
    title="SEE ALSO"
-%]<p>
[% ttlink('Template', 'Template') -%], [% ttlink('Template::Manual', 'Template::Manual') -%]
</p>
[%- END %]