Template Toolkit Release

Changes

Tutorial ][ Manual ][ Modules ][ Library ][ Tools ][ FAQ ][ Release ]

<-[ INSTALL ][ TODO ]->

Change history
#========================================================================
#
# Changes 
#
# DESCRIPTION
#   Revision history for the Template Toolkit version 2.19, 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 
#   look out for when upgrading between major versions.
#
# AUTHOR
#   Andy Wardley   <abw@wardley.org>
#
# NOTE
#   This file is b you'll ne scale very well, particularly with global variables
clashing all over the place.  My plan is that this will become a
view-based system and will no doubt be a test-bed for the
implementation of the view facility.

To include:

* Variable management for storing metadata relating to an
  interface/view, protected from the rest of template space.

* Also, style management for defining different styles (e.g. plain,
  fancy,  icecold, whitehot) for different interface elements (e.g.
  bars, borders, menu text) in different modes (e.g. selected, unselected),
  or under different, possibly custom conditions (e.g. user preferences,
  guest or logged in, etc.).

* Clearly define API for different elements, allowing people to write
  apps to the API which run across different conformant widget sets.

* support themes which define a set of styles

* May be wise to move Splash out to a separate distribution.

Randal Schwartz highlighted some problems with non-compliant HTML
being generated.  These include:

* no DOCTYPE declaration (added to html/header)

* ALT attribute missing from many <img> tags

* <font ...><table>...</table></font> is illegal (not sure where this
  gets done)

* <tr> shouldn't have HEIGHT attribute

* <H3> block element inside inline element

* <A> not allowed here (not sure)


#------------------------------------------------------------------------
# Test Suite
#------------------------------------------------------------------------

* t/file.t and t/directry.t are currently disable on Win32 until I get
  a chance to fix a couple of minor bugs relating to '/' vs '\' file
  separators.



<-[ Changes ][ HACKING ]->
./usr/share/doc/libtemplate-perl-doc/html/Release/HACKING.html0000644000000000000000000000654011013663225022660 0ustar rootroot Template Toolkit Release

Template Toolkit Release

HACKING

Tutorial ][ Manual ][ Modules ][ Library ][ Tools ][ FAQ ][ Release ]

<-[ TODO ]

Pointers for people wishing to hack on TT

                            Template Toolkit

                              Version 2.19

                             27 April 2007

        Copyright (C) 1996-2007 Andy Wardley.  All Rights Reserved

          This is free software; you can redistribute it and/or
             modify it under the same terms as Perl itself.

HACKER'S GUIDE
--------------

Please hack on the Template Toolkit.  It has been designed to be
extensible and has literally dozens of programmer hooks that you can
tap into to do all sorts of cool things.  The object oriented
architecture allows you to create your own subclassed modules to
implement your own services, providers, filters, plugins, and so on.

The Template::Manual::Internals document gives a brief overview of the
architecture.  Unfortunately, it's not as complete as it could be,
but the code is well documented and generally easy to follow.  Don't
be afraid to use the source, Luke.

The internals document also contains information about preparing and
applying patches, updating the documentation and various other 
useful tips.

The documentation is all built from source templates in the 'docsrc'
directory.  This includes the 'README', 'INSTALL', 'HACKING' and
'Changes' files which can be found in the 'docsrc/src/Release'
directory.  The 'docsrc' bundle is a separate distribution available
from the TT web site.  The 'docsrc/bin' directory contains scripts for
rebuilding the documentation.  See the 'docsrc/README' file for info.

If you're in the business of building a distribution (that usually
means me, but hey, you never know) then you'll need to have the latest
CVS sources which includes the 'bin/release' script.  This rebuilds
the documentation, runs the tests, fixes up the Template/Config.pm
file to a sane state and builds the distribution archive.  The
'bin/docsrc' script builds the docsrc.tar.gz distribution for the
latest release.

This document will be integrated with Template::Manual::Internals
at some point, probably as a separate hacking tutorial or something
similar.


AUTHOR
------

The Template Toolkit was written by Andy Wardley <abw@wardley.org>
with the invaluable assistance and contributions from many other
people.  See Template::Manual::Credits for details.


COPYRIGHT
---------

Copyright (C) 1996-2007 Andy Wardley.  All Rights Reserved.

This is free software; you can redistribute it and/or modify it under
the same terms as Perl itself.



<-[ TODO ]
./usr/share/doc/libtemplate-perl-doc/html/Release/Changes.html0000644000000000000000000045423711013663226023177 0ustar rootroot Template Toolkit Release

Template Toolkit Release

Changes

Tutorial ][ Manual ][ Modules ][ Library ][ Tools ][ FAQ ][ Release ]

<-[ INSTALL ][ TODO ]->

Change history
#========================================================================
#
# Changes 
#
# DESCRIPTION
#   Revision history for the Template Toolkit version 2.19, 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 
#   look out for when upgrading between major versions.
#
# AUTHOR
#   Andy Wardley   <abw@wardley.org>
#
# NOTE
#   This file is b you'll ne scale very well, particularly with global variables
clashing all over the place.  My plan is that this will become a
view-based system and will no doubt be a test-bed for the
implementation of the view facility.

To include:

* Variable management for storing metadata relating to an
  interface/view, protected from the rest of template space.

* Also, style management for defining different styles (e.g. plain,
  fancy,  icecold, whitehot) for different interface elements (e.g.
  bars, borders, menu text) in different modes (e.g. selected, unselected),
  or under different, possibly custom conditions (e.g. user preferences,
  guest or logged in, etc.).

* Clearly define API for different elements, allowing people to write
  apps to the API which run across different conformant widget sets.

* support themes which define a set of styles

* May be wise to move Splash out to a separate distribution.

Randal Schwartz highlighted some problems with non-compliant HTML
being generated.  These include:

* no DOCTYPE declaration (added to html/header)

* ALT attribute missing from many <img> tags

* <font ...><table>...</table></font> is illegal (not sure where this
  gets done)

* <tr> shouldn't have HEIGHT attribute

* <H3> block element inside inline element

* <A> not allowed here (not sure)


#------------------------------------------------------------------------
# Test Suite
#------------------------------------------------------------------------

* t/file.t and t/directry.t are currently disable on Win32 until I get
  a chance to fix a couple of minor bugs relating to '/' vs '\' file
  separators.



<-[ Changes ][ HACKING ]->
./usr/share/doc/libtemplate-perl-doc/html/Release/HACKING.html0000644000000000000000000000654011013663225022660 0ustar rootroot Template Toolkit Release

Template Toolkit Release

HACKING

Tutorial ][ Manual ][ Modules ][ Library ][ Tools ][ FAQ ][ Release ]

<-[ TODO ]

Pointers for people wishing to hack on TT

                            Template Toolkit

                              Version 2.19

                             27 April 2007

        Copyright (C) 1996-2007 Andy Wardley.  All Rights Reserved

          This is free software; you can redistribute it and/or
             modify it under the same terms as Perl itself.

HACKER'S GUIDE
--------------

Please hack on the Template Toolkit.  It has been designed to be
extensible and has literally dozens of programmer hooks that you can
tap into to do all sorts of cool things.  The object oriented
architecture allows you to create your own subclassed modules to
implement your own services, providers, filters, plugins, and so on.

The Template::Manual::Internals document gives a brief overview of the
architecture.  Unfortunately, it's not as complete as it could be,
but the code is well documented and generally easy to follow.  Don't
be afraid to use the source, Luke.

The internals document also contains information about preparing and
applying patches, updating the documentation and various other 
useful tips.

The documentation is all built from source templates in the 'docsrc'
directory.  This includes the 'README', 'INSTALL', 'HACKING' and
'Changes' files which can be found in the 'docsrc/src/Release'
directory.  The 'docsrc' bundle is a separate distribution available
from the TT web site.  The 'docsrc/bin' directory contains scripts for
rebuilding the documentation.  See the 'docsrc/README' file for info.

If you're in the business of building a distribution (that usually
means me, but hey, you never know) then you'll need to have the latest
CVS sources which includes the 'bin/release' script.  This rebuilds
the documentation, runs the tests, fixes up the Template/Config.pm
file to a sane state and builds the distribution archive.  The
'bin/docsrc' script builds the docsrc.tar.gz distribution for the
latest release.

This document will be integrated with Template::Manual::Internals
at some point, probably as a separate hacking tutorial or something
similar.


AUTHOR
------

The Template Toolkit was written by Andy Wardley <abw@wardley.org>
with the invaluable assistance and contributions from many other
people.  See Template::Manual::Credits for details.


COPYRIGHT
---------

Copyright (C) 1996-2007 Andy Wardley.  All Rights Reserved.

This is free software; you can redistribute it and/or modify it under
the same terms as Perl itself.



<-[ TODO ]
./usr/share/doc/libtemplate-perl-doc/html/Release/Changes.html0000644000000000000000000045423711013663226023177 0ustar rootroot Template Toolkit Release

Template Toolkit Release

Changes

Tutorial ][ Manual ][ Modules ][ Library ][ Tools ][ FAQ ][ Release ]

<-[ INSTALL ][ TODO ]->

Change history
#========================================================================
#
# Changes 
#
# DESCRIPTION
#   Revision history for the Template Toolkit version 2.19, 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 
#   look out for when upgrading between major versions.
#
# AUTHOR
#   Andy Wardley   <abw@wardley.org>
#
# NOTE
#   This file is b you'll ne scale very well, particularly with global variables
clashing all over the place.  My plan is that this will become a
view-based system and will no doubt be a test-bed for the
implementation of the view facility.

To include:

* Variable management for storing metadata relating to an
  interface/view, protected from the rest of template space.

* Also, style management for defining different styles (e.g. plain,
  fancy,  icecold, whitehot) for different interface elements (e.g.
  bars, borders, menu text) in different modes (e.g. selected, unselected),
  or under different, possibly custom conditions (e.g. user preferences,
  guest or logged in, etc.).

* Clearly define API for different elements, allowing people to write
  apps to the API which run across different conformant widget sets.

* support themes which define a set of styles

* May be wise to move Splash out to a separate distribution.

Randal Schwartz highlighted some problems with non-compliant HTML
being generated.  These include:

* no DOCTYPE declaration (added to html/header)

* ALT attribute missing from many <img> tags

* <font ...><table>...</table></font> is illegal (not sure where this
  gets done)

* <tr> shouldn't have HEIGHT attribute

* <H3> block element inside inline element

* <A> not allowed here (not sure)


#------------------------------------------------------------------------
# Test Suite
#------------------------------------------------------------------------

* t/file.t and t/directry.t are currently disable on Win32 until I get
  a chance to fix a couple of minor bugs relating to '/' vs '\' file
  separators.



<-[ Changes ][ HACKING ]->
./usr/share/doc/libtemplate-perl-doc/html/Release/HACKING.html0000644000000000000000000000654011013663225022660 0ustar rootroot Template Toolkit Release

Template Toolkit Release

HACKING

Tutorial ][ Manual ][ Modules ][ Library ][ Tools ][ FAQ ][ Release ]

<-[ TODO ]

Pointers for people wishing to hack on TT

                            Template Toolkit

                              Version 2.19

                             27 April 2007

        Copyright (C) 1996-2007 Andy Wardley.  All Rights Reserved

          This is free software; you can redistribute it and/or
             modify it under the same terms as Perl itself.

HACKER'S GUIDE
--------------

Please hack on the Template Toolkit.  It has been designed to be
extensible and has literally dozens of programmer hooks that you can
tap into to do all sorts of cool things.  The object oriented
architecture allows you to create your own subclassed modules to
implement your own services, providers, filters, plugins, and so on.

The Template::Manual::Internals document gives a brief overview of the
architecture.  Unfortunately, it's not as complete as it could be,
but the code is well documented and generally easy to follow.  Don't
be afraid to use the source, Luke.

The internals document also contains information about preparing and
applying patches, updating the documentation and various other 
useful tips.

The documentation is all built from source templates in the 'docsrc'
directory.  This includes the 'README', 'INSTALL', 'HACKING' and
'Changes' files which can be found in the 'docsrc/src/Release'
directory.  The 'docsrc' bundle is a separate distribution available
from the TT web site.  The 'docsrc/bin' directory contains scripts for
rebuilding the documentation.  See the 'docsrc/README' file for info.

If you're in the business of building a distribution (that usually
means me, but hey, you never know) then you'll need to have the latest
CVS sources which includes the 'bin/release' script.  This rebuilds
the documentation, runs the tests, fixes up the Template/Config.pm
file to a sane state and builds the distribution archive.  The
'bin/docsrc' script builds the docsrc.tar.gz distribution for the
latest release.

This document will be integrated with Template::Manual::Internals
at some point, probably as a separate hacking tutorial or something
similar.


AUTHOR
------

The Template Toolkit was written by Andy Wardley <abw@wardley.org>
with the invaluable assistance and contributions from many other
people.  See Template::Manual::Credits for details.


COPYRIGHT
---------

Copyright (C) 1996-2007 Andy Wardley.  All Rights Reserved.

This is free software; you can redistribute it and/or modify it under
the same terms as Perl itself.



<-[ TODO ]
./usr/share/doc/libtemplate-perl-doc/html/Release/Changes.html0000644000000000000000000045423711013663226023177 0ustar rootroot Template Toolkit Release

Template Toolkit Release

Changes

Tutorial ][ Manual ][ Modules ][ Library ][ Tools ][ FAQ ][ Release ]

<-[ INSTALL ][ TODO ]->

Change history
#========================================================================
#
# Changes 
#
# DESCRIPTION
#   Revision history for the Template Toolkit version 2.19, 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 
#   look out for when upgrading between major versions.
#
# AUTHOR
#   Andy Wardley   <abw@wardley.org>
#
# NOTE
#   This file is b you'll ne scale very well, particularly with global variables
clashing all over the place.  My plan is that this will become a
view-based system and will no doubt be a test-bed for the
implementation of the view facility.

To include:

* Variable management for storing metadata relating to an
  interface/view, protected from the rest of template space.

* Also, style management for defining different styles (e.g. plain,
  fancy,  icecold, whitehot) for different interface elements (e.g.
  bars, borders, menu text) in different modes (e.g. selected, unselected),
  or under different, possibly custom conditions (e.g. user preferences,
  guest or logged in, etc.).

* Clearly define API for different elements, allowing people to write
  apps to the API which run across different conformant widget sets.

* support themes which define a set of styles

* May be wise to move Splash out to a separate distribution.

Randal Schwartz highlighted some problems with non-compliant HTML
being generated.  These include:

* no DOCTYPE declaration (added to html/header)

* ALT attribute missing from many <img> tags

* <font ...><table>...</table></font> is illegal (not sure where this
  gets done)

* <tr> shouldn't have HEIGHT attribute

* <H3> block element inside inline element

* <A> not allowed here (not sure)


#------------------------------------------------------------------------
# Test Suite
#------------------------------------------------------------------------

* t/file.t and t/directry.t are currently disable on Win32 until I get
  a chance to fix a couple of minor bugs relating to '/' vs '\' file
  separators.



<-[ Changes ][ HACKING ]->
./usr/share/doc/libtemplate-perl-doc/html/Release/HACKING.html0000644000000000000000000000654011013663225022660 0ustar rootroot Template Toolkit Release

Template Toolkit Release

HACKING

Tutorial ][ Manual ][ Modules ][ Library ][ Tools ][ FAQ ][ Release ]

<-[ TODO ]

Pointers for people wishing to hack on TT

                            Template Toolkit

                              Version 2.19

                             27 April 2007

        Copyright (C) 1996-2007 Andy Wardley.  All Rights Reserved

          This is free software; you can redistribute it and/or
             modify it under the same terms as Perl itself.

HACKER'S GUIDE
--------------

Please hack on the Template Toolkit.  It has been designed to be
extensible and has literally dozens of programmer hooks that you can
tap into to do all sorts of cool things.  The object oriented
architecture allows you to create your own subclassed modules to
implement your own services, providers, filters, plugins, and so on.

The Template::Manual::Internals document gives a brief overview of the
architecture.  Unfortunately, it's not as complete as it could be,
but the code is well documented and generally easy to follow.  Don't
be afraid to use the source, Luke.

The internals document also contains information about preparing and
applying patches, updating the documentation and various other 
useful tips.

The documentation is all built from source templates in the 'docsrc'
directory.  This includes the 'README', 'INSTALL', 'HACKING' and
'Changes' files which can be found in the 'docsrc/src/Release'
directory.  The 'docsrc' bundle is a separate distribution available
from the TT web site.  The 'docsrc/bin' directory contains scripts for
rebuilding the documentation.  See the 'docsrc/README' file for info.

If you're in the business of building a distribution (that usually
means me, but hey, you never know) then you'll need to have the latest
CVS sources which includes the 'bin/release' script.  This rebuilds
the documentation, runs the tests, fixes up the Template/Config.pm
file to a sane state and builds the distribution archive.  The
'bin/docsrc' script builds the docsrc.tar.gz distribution for the
latest release.

This document will be integrated with Template::Manual::Internals
at some point, probably as a separate hacking tutorial or something
similar.


AUTHOR
------

The Template Toolkit was written by Andy Wardley <abw@wardley.org>
with the invaluable assistance and contributions from many other
people.  See Template::Manual::Credits for details.


COPYRIGHT
---------

Copyright (C) 1996-2007 Andy Wardley.  All Rights Reserved.

This is free software; you can redistribute it and/or modify it under
the same terms as Perl itself.



<-[ TODO ]
./usr/share/doc/libtemplate-perl-doc/html/Release/Changes.html0000644000000000000000000045423711013663226023177 0ustar rootroot Template Toolkit Release

Template Toolkit Release

Changes

Tutorial ][ Manual ][ Modules ][ Library ][ Tools ][ FAQ ][ Release ]

<-[ INSTALL ][ TODO ]->

Change history
#========================================================================
#
# Changes 
#
# DESCRIPTION
#   Revision history for the Template Toolkit version 2.19, 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 
#   look out for when upgrading between major versions.
#
# AUTHOR
#   Andy Wardley   <abw@wardley.org>
#
# NOTE
#   This file is b you'll ne scale very well, particularly with global variables
clashing all over the place.  My plan is that this will become a
view-based system and will no doubt be a test-bed for the
implementation of the view facility.

To include:

* Variable management for storing metadata relating to an
  interface/view, protected from the rest of template space.

* Also, style management for defining different styles (e.g. plain,
  fancy,  icecold, whitehot) for different interface elements (e.g.
  bars, borders, menu text) in different modes (e.g. selected, unselected),
  or under different, possibly custom conditions (e.g. user preferences,
  guest or logged in, etc.).

* Clearly define API for different elements, allowing people to write
  apps to the API which run across different conformant widget sets.

* support themes which define a set of styles

* May be wise to move Splash out to a separate distribution.

Randal Schwartz highlighted some problems with non-compliant HTML
being generated.  These include:

* no DOCTYPE declaration (added to html/header)

* ALT attribute missing from many <img> tags

* <font ...><table>...</table></font> is illegal (not sure where this
  gets done)

* <tr> shouldn't have HEIGHT attribute

* <H3> block element inside inline element

* <A> not allowed here (not sure)


#------------------------------------------------------------------------
# Test Suite
#------------------------------------------------------------------------

* t/file.t and t/directry.t are currently disable on Win32 until I get
  a chance to fix a couple of minor bugs relating to '/' vs '\' file
  separators.



<-[ Changes ][ HACKING ]->
./usr/share/doc/libtemplate-perl-doc/html/Release/HACKING.html0000644000000000000000000000654011013663225022660 0ustar rootroot Template Toolkit Release

Template Toolkit Release

HACKING

Tutorial ][ Manual ][ Modules ][ Library ][ Tools ][ FAQ ][ Release ]

<-[ TODO ]

Pointers for people wishing to hack on TT

                            Template Toolkit

                              Version 2.19

                             27 April 2007

        Copyright (C) 1996-2007 Andy Wardley.  All Rights Reserved

          This is free software; you can redistribute it and/or
             modify it under the same terms as Perl itself.

HACKER'S GUIDE
--------------

Please hack on the Template Toolkit.  It has been designed to be
extensible and has literally dozens of programmer hooks that you can
tap into to do all sorts of cool things.  The object oriented
architecture allows you to create your own subclassed modules to
implement your own services, providers, filters, plugins, and so on.

The Template::Manual::Internals document gives a brief overview of the
architecture.  Unfortunately, it's not as complete as it could be,
but the code is well documented and generally easy to follow.  Don't
be afraid to use the source, Luke.

The internals document also contains information about preparing and
applying patches, updating the documentation and various other 
useful tips.

The documentation is all built from source templates in the 'docsrc'
directory.  This includes the 'README', 'INSTALL', 'HACKING' and
'Changes' files which can be found in the 'docsrc/src/Release'
directory.  The 'docsrc' bundle is a separate distribution available
from the TT web site.  The 'docsrc/bin' directory contains scripts for
rebuilding the documentation.  See the 'docsrc/README' file for info.

If you're in the business of building a distribution (that usually
means me, but hey, you never know) then you'll need to have the latest
CVS sources which includes the 'bin/release' script.  This rebuilds
the documentation, runs the tests, fixes up the Template/Config.pm
file to a sane state and builds the distribution archive.  The
'bin/docsrc' script builds the docsrc.tar.gz distribution for the
latest release.

This document will be integrated with Template::Manual::Internals
at some point, probably as a separate hacking tutorial or something
similar.


AUTHOR
------

The Template Toolkit was written by Andy Wardley <abw@wardley.org>
with the invaluable assistance and contributions from many other
people.  See Template::Manual::Credits for details.


COPYRIGHT
---------

Copyright (C) 1996-2007 Andy Wardley.  All Rights Reserved.

This is free software; you can redistribute it and/or modify it under
the same terms as Perl itself.



<-[ TODO ]
./usr/share/doc/libtemplate-perl-doc/html/Release/Changes.html0000644000000000000000000045423711013663226023177 0ustar rootroot Template Toolkit Release

Template Toolkit Release

Changes

Tutorial ][ Manual ][ Modules ][ Library ][ Tools ][ FAQ ][ Release ]

<-[ INSTALL ][ TODO ]->

Change history
#========================================================================
#
# Changes 
#
# DESCRIPTION
#   Revision history for the Template Toolkit version 2.19, 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 
#   look out for when upgrading between major versions.
#
# AUTHOR
#   Andy Wardley   <abw@wardley.org>
#
# NOTE
#   This file is b you'll ne scale very well, particularly with global variables
clashing all over the place.  My plan is that this will become a
view-based system and will no doubt be a test-bed for the
implementation of the view facility.

To include:

* Variable management for storing metadata relating to an
  interface/view, protected from the rest of template space.

* Also, style management for defining different styles (e.g. plain,
  fancy,  icecold, whitehot) for different interface elements (e.g.
  bars, borders, menu text) in different modes (e.g. selected, unselected),
  or under different, possibly custom conditions (e.g. user preferences,
  guest or logged in, etc.).

* Clearly define API for different elements, allowing people to write
  apps to the API which run across different conformant widget sets.

* support themes which define a set of styles

* May be wise to move Splash out to a separate distribution.

Randal Schwartz highlighted some problems with non-compliant HTML
being generated.  These include:

* no DOCTYPE declaration (added to html/header)

* ALT attribute missing from many <img> tags

* <font ...><table>...</table></font> is illegal (not sure where this
  gets done)

* <tr> shouldn't have HEIGHT attribute

* <H3> block element inside inline element

* <A> not allowed here (not sure)


#------------------------------------------------------------------------
# Test Suite
#------------------------------------------------------------------------

* t/file.t and t/directry.t are currently disable on Win32 until I get
  a chance to fix a couple of minor bugs relating to '/' vs '\' file
  separators.



<-[ Changes ][ HACKING ]->
./usr/share/doc/libtemplate-perl-doc/html/Release/HACKING.html0000644000000000000000000000654011013663225022660 0ustar rootroot Template Toolkit Release

Template Toolkit Release

HACKING

Tutorial ][ Manual ][ Modules ][ Library ][ Tools ][ FAQ ][ Release ]

<-[ TODO ]

Pointers for people wishing to hack on TT

                            Template Toolkit

                              Version 2.19

                             27 April 2007

        Copyright (C) 1996-2007 Andy Wardley.  All Rights Reserved

          This is free software; you can redistribute it and/or
             modify it under the same terms as Perl itself.

HACKER'S GUIDE
--------------

Please hack on the Template Toolkit.  It has been designed to be
extensible and has literally dozens of programmer hooks that you can
tap into to do all sorts of cool things.  The object oriented
architecture allows you to create your own subclassed modules to
implement your own services, providers, filters, plugins, and so on.

The Template::Manual::Internals document gives a brief overview of the
architecture.  Unfortunately, it's not as complete as it could be,
but the code is well documented and generally easy to follow.  Don't
be afraid to use the source, Luke.

The internals document also contains information about preparing and
applying patches, updating the documentation and various other 
useful tips.

The documentation is all built from source templates in the 'docsrc'
directory.  This includes the 'README', 'INSTALL', 'HACKING' and
'Changes' files which can be found in the 'docsrc/src/Release'
directory.  The 'docsrc' bundle is a separate distribution available
from the TT web site.  The 'docsrc/bin' directory contains scripts for
rebuilding the documentation.  See the 'docsrc/README' file for info.

If you're in the business of building a distribution (that usually
means me, but hey, you never know) then you'll need to have the latest
CVS sources which includes the 'bin/release' script.  This rebuilds
the documentation, runs the tests, fixes up the Template/Config.pm
file to a sane state and builds the distribution archive.  The
'bin/docsrc' script builds the docsrc.tar.gz distribution for the
latest release.

This document will be integrated with Template::Manual::Internals
at some point, probably as a separate hacking tutorial or something
similar.


AUTHOR
------

The Template Toolkit was written by Andy Wardley <abw@wardley.org>
with the invaluable assistance and contributions from many other
people.  See Template::Manual::Credits for details.


COPYRIGHT
---------

Copyright (C) 1996-2007 Andy Wardley.  All Rights Reserved.

This is free software; you can redistribute it and/or modify it under
the same terms as Perl itself.



<-[ TODO ]
./usr/share/doc/libtemplate-perl-doc/html/Release/Changes.html0000644000000000000000000045423711013663226023177 0ustar rootroot Template Toolkit Release

Template Toolkit Release

Changes

Tutorial ][ Manual ][ Modules ][ Library ][ Tools ][ FAQ ][ Release ]

<-[ INSTALL ][ TODO ]->

Change history
#========================================================================
#
# Changes 
#
# DESCRIPTION
#   Revision history for the Template Toolkit version 2.19, 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 
#   look out for when upgrading between major versions.
#
# AUTHOR
#   Andy Wardley   <abw@wardley.org>
#
# NOTE
#   This file is b you'll ne scale very well, particularly with global variables
clashing all over the place.  My plan is that this will become a
view-based system and will no doubt be a test-bed for the
implementation of the view facility.

To include:

* Variable management for storing metadata relating to an
  interface/view, protected from the rest of template space.

* Also, style management for defining different styles (e.g. plain,
  fancy,  icecold, whitehot) for different interface elements (e.g.
  bars, borders, menu text) in different modes (e.g. selected, unselected),
  or under different, possibly custom conditions (e.g. user preferences,
  guest or logged in, etc.).

* Clearly define API for different elements, allowing people to write
  apps to the API which run across different conformant widget sets.

* support themes which define a set of styles

* May be wise to move Splash out to a separate distribution.

Randal Schwartz highlighted some problems with non-compliant HTML
being generated.  These include:

* no DOCTYPE declaration (added to html/header)

* ALT attribute missing from many <img> tags

* <font ...><table>...</table></font> is illegal (not sure where this
  gets done)

* <tr> shouldn't have HEIGHT attribute

* <H3> block element inside inline element

* <A> not allowed here (not sure)


#------------------------------------------------------------------------
# Test Suite
#------------------------------------------------------------------------

* t/file.t and t/directry.t are currently disable on Win32 until I get
  a chance to fix a couple of minor bugs relating to '/' vs '\' file
  separators.



<-[ Changes ][ HACKING ]->
./usr/share/doc/libtemplate-perl-doc/html/Release/HACKING.html0000644000000000000000000000654011013663225022660 0ustar rootroot Template Toolkit Release

Template Toolkit Release

HACKING

Tutorial ][ Manual ][ Modules ][ Library ][ Tools ][ FAQ ][ Release ]

<-[ TODO ]

Pointers for people wishing to hack on TT

                            Template Toolkit

                              Version 2.19

                             27 April 2007

        Copyright (C) 1996-2007 Andy Wardley.  All Rights Reserved

          This is free software; you can redistribute it and/or
             modify it under the same terms as Perl itself.

HACKER'S GUIDE
--------------

Please hack on the Template Toolkit.  It has been designed to be
extensible and has literally dozens of programmer hooks that you can
tap into to do all sorts of cool things.  The object oriented
architecture allows you to create your own subclassed modules to
implement your own services, providers, filters, plugins, and so on.

The Template::Manual::Internals document gives a brief overview of the
architecture.  Unfortunately, it's not as complete as it could be,
but the code is well documented and generally easy to follow.  Don't
be afraid to use the source, Luke.

The internals document also contains information about preparing and
applying patches, updating the documentation and various other 
useful tips.

The documentation is all built from source templates in the 'docsrc'
directory.  This includes the 'README', 'INSTALL', 'HACKING' and
'Changes' files which can be found in the 'docsrc/src/Release'
directory.  The 'docsrc' bundle is a separate distribution available
from the TT web site.  The 'docsrc/bin' directory contains scripts for
rebuilding the documentation.  See the 'docsrc/README' file for info.

If you're in the business of building a distribution (that usually
means me, but hey, you never know) then you'll need to have the latest
CVS sources which includes the 'bin/release' script.  This rebuilds
the documentation, runs the tests, fixes up the Template/Config.pm
file to a sane state and builds the distribution archive.  The
'bin/docsrc' script builds the docsrc.tar.gz distribution for the
latest release.

This document will be integrated with Template::Manual::Internals
at some point, probably as a separate hacking tutorial or something
similar.


AUTHOR
------

The Template Toolkit was written by Andy Wardley <abw@wardley.org>
with the invaluable assistance and contributions from many other
people.  See Template::Manual::Credits for details.


COPYRIGHT
---------

Copyright (C) 1996-2007 Andy Wardley.  All Rights Reserved.

This is free software; you can redistribute it and/or modify it under
the same terms as Perl itself.



<-[ TODO ]
./usr/share/doc/libtemplate-perl-doc/html/Release/Changes.html0000644000000000000000000045423711013663226023177 0ustar rootroot Template Toolkit Release

Template Toolkit Release

Changes

Tutorial ][ Manual ][ Modules ][ Library ][ Tools ][ FAQ ][ Release ]

<-[ INSTALL ][ TODO ]->

Change history
#========================================================================
#
# Changes 
#
# DESCRIPTION
#   Revision history for the Template Toolkit version 2.19, 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 
#   look out for when upgrading between major versions.
#
# AUTHOR
#   Andy Wardley   <abw@wardley.org>
#
# NOTE
#   This file is b you'll ne scale very well, particularly with global variables
clashing all over the place.  My plan is that this will become a
view-based system and will no doubt be a test-bed for the
implementation of the view facility.

To include:

* Variable management for storing metadata relating to an
  interface/view, protected from the rest of template space.

* Also, style management for defining different styles (e.g. plain,
  fancy,  icecold, whitehot) for different interface elements (e.g.
  bars, borders, menu text) in different modes (e.g. selected, unselected),
  or under different, possibly custom conditions (e.g. user preferences,
  guest or logged in, etc.).

* Clearly define API for different elements, allowing people to write
  apps to the API which run across different conformant widget sets.

* support themes which define a set of styles

* May be wise to move Splash out to a separate distribution.

Randal Schwartz highlighted some problems with non-compliant HTML
being generated.  These include:

* no DOCTYPE declaration (added to html/header)

* ALT attribute missing from many <img> tags

* <font ...><table>...</table></font> is illegal (not sure where this
  gets done)

* <tr> shouldn't have HEIGHT attribute

* <H3> block element inside inline element

* <A> not allowed here (not sure)


#------------------------------------------------------------------------
# Test Suite
#------------------------------------------------------------------------

* t/file.t and t/directry.t are currently disable on Win32 until I get
  a chance to fix a couple of minor bugs relating to '/' vs '\' file
  separators.



<-[ Changes ][ HACKING ]->
./usr/share/doc/libtemplate-perl-doc/html/Release/HACKING.html0000644000000000000000000000654011013663225022660 0ustar rootroot Template Toolkit Release

Template Toolkit Release

HACKING

Tutorial ][ Manual ][ Modules ][ Library ][ Tools ][ FAQ ][ Release ]

<-[ TODO ]

Pointers for people wishing to hack on TT

                            Template Toolkit

                              Version 2.19

                             27 April 2007

        Copyright (C) 1996-2007 Andy Wardley.  All Rights Reserved

          This is free software; you can redistribute it and/or
             modify it under the same terms as Perl itself.

HACKER'S GUIDE
--------------

Please hack on the Template Toolkit.  It has been designed to be
extensible and has literally dozens of programmer hooks that you can
tap into to do all sorts of cool things.  The object oriented
architecture allows you to create your own subclassed modules to
implement your own services, providers, filters, plugins, and so on.

The Template::Manual::Internals document gives a brief overview of the
architecture.  Unfortunately, it's not as complete as it could be,
but the code is well documented and generally easy to follow.  Don't
be afraid to use the source, Luke.

The internals document also contains information about preparing and
applying patches, updating the documentation and various other 
useful tips.

The documentation is all built from source templates in the 'docsrc'
directory.  This includes the 'README', 'INSTALL', 'HACKING' and
'Changes' files which can be found in the 'docsrc/src/Release'
directory.  The 'docsrc' bundle is a separate distribution available
from the TT web site.  The 'docsrc/bin' directory contains scripts for
rebuilding the documentation.  See the 'docsrc/README' file for info.

If you're in the business of building a distribution (that usually
means me, but hey, you never know) then you'll need to have the latest
CVS sources which includes the 'bin/release' script.  This rebuilds
the documentation, runs the tests, fixes up the Template/Config.pm
file to a sane state and builds the distribution archive.  The
'bin/docsrc' script builds the docsrc.tar.gz distribution for the
latest release.

This document will be integrated with Template::Manual::Internals
at some point, probably as a separate hacking tutorial or something
similar.


AUTHOR
------

The Template Toolkit was written by Andy Wardley <abw@wardley.org>
with the invaluable assistance and contributions from many other
people.  See Template::Manual::Credits for details.


COPYRIGHT
---------

Copyright (C) 1996-2007 Andy Wardley.  All Rights Reserved.

This is free software; you can redistribute it and/or modify it under
the same terms as Perl itself.



<-[ TODO ]
./usr/share/doc/libtemplate-perl-doc/html/Release/Changes.html0000644000000000000000000045423711013663226023177 0ustar rootroot Template Toolkit Release

Template Toolkit Release

Changes

Tutorial ][ Manual ][ Modules ][ Library ][ Tools ][ FAQ ][ Release ]

<-[ INSTALL ][ TODO ]->

Change history
#========================================================================
#
# Changes 
#
# DESCRIPTION
#   Revision history for the Template Toolkit version 2.19, 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 
#   look out for when upgrading between major versions.
#
# AUTHOR
#   Andy Wardley   <abw@wardley.org>
#
# NOTE
#   This file is b you'll ne scale very well, particularly with global variables
clashing all over the place.  My plan is that this will become a
view-based system and will no doubt be a test-bed for the
implementation of the view facility.

To include:

* Variable management for storing metadata relating to an
  interface/view, protected from the rest of template space.

* Also, style management for defining different styles (e.g. plain,
  fancy,  icecold, whitehot) for different interface elements (e.g.
  bars, borders, menu text) in different modes (e.g. selected, unselected),
  or under different, possibly custom conditions (e.g. user preferences,
  guest or logged in, etc.).

* Clearly define API for different elements, allowing people to write
  apps to the API which run across different conformant widget sets.

* support themes which define a set of styles

* May be wise to move Splash out to a separate distribution.

Randal Schwartz highlighted some problems with non-compliant HTML
being generated.  These include:

* no DOCTYPE declaration (added to html/header)

* ALT attribute missing from many <img> tags

* <font ...><table>...</table></font> is illegal (not sure where this
  gets done)

* <tr> shouldn't have HEIGHT attribute

* <H3> block element inside inline element

* <A> not allowed here (not sure)


#------------------------------------------------------------------------
# Test Suite
#------------------------------------------------------------------------

* t/file.t and t/directry.t are currently disable on Win32 until I get
  a chance to fix a couple of minor bugs relating to '/' vs '\' file
  separators.



<-[ Changes ][ HACKING ]->
./usr/share/doc/libtemplate-perl-doc/html/Release/HACKING.html0000644000000000000000000000654011013663225022660 0ustar rootroot Template Toolkit Release

Template Toolkit Release

HACKING

Tutorial ][ Manual ][ Modules ][ Library ][ Tools ][ FAQ ][ Release ]

<-[ TODO ]

Pointers for people wishing to hack on TT

                            Template Toolkit

                              Version 2.19

                             27 April 2007

        Copyright (C) 1996-2007 Andy Wardley.  All Rights Reserved

          This is free software; you can redistribute it and/or
             modify it under the same terms as Perl itself.

HACKER'S GUIDE
--------------

Please hack on the Template Toolkit.  It has been designed to be
extensible and has literally dozens of programmer hooks that you can
tap into to do all sorts of cool things.  The object oriented
architecture allows you to create your own subclassed modules to
implement your own services, providers, filters, plugins, and so on.

The Template::Manual::Internals document gives a brief overview of the
architecture.  Unfortunately, it's not as complete as it could be,
but the code is well documented and generally easy to follow.  Don't
be afraid to use the source, Luke.

The internals document also contains information about preparing and
applying patches, updating the documentation and various other 
useful tips.

The documentation is all built from source templates in the 'docsrc'
directory.  This includes the 'README', 'INSTALL', 'HACKING' and
'Changes' files which can be found in the 'docsrc/src/Release'
directory.  The 'docsrc' bundle is a separate distribution available
from the TT web site.  The 'docsrc/bin' directory contains scripts for
rebuilding the documentation.  See the 'docsrc/README' file for info.

If you're in the business of building a distribution (that usually
means me, but hey, you never know) then you'll need to have the latest
CVS sources which includes the 'bin/release' script.  This rebuilds
the documentation, runs the tests, fixes up the Template/Config.pm
file to a sane state and builds the distribution archive.  The
'bin/docsrc' script builds the docsrc.tar.gz distribution for the
latest release.

This document will be integrated with Template::Manual::Internals
at some point, probably as a separate hacking tutorial or something
similar.


AUTHOR
------

The Template Toolkit was written by Andy Wardley <abw@wardley.org>
with the invaluable assistance and contributions from many other
people.  See Template::Manual::Credits for details.


COPYRIGHT
---------

Copyright (C) 1996-2007 Andy Wardley.  All Rights Reserved.

This is free software; you can redistribute it and/or modify it under
the same terms as Perl itself.



<-[ TODO ]
./usr/share/doc/libtemplate-perl-doc/html/Release/Changes.html0000644000000000000000000045423711013663226023177 0ustar rootroot Template Toolkit Release

Template Toolkit Release

Changes

Tutorial ][ Manual ][ Modules ][ Library ][ Tools ][ FAQ ][ Release ]

<-[ INSTALL ][ TODO ]->

Change history
#========================================================================
#
# Changes 
#
# DESCRIPTION
#   Revision history for the Template Toolkit version 2.19, 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 
#   look out for when upgrading between major versions.
#
# AUTHOR
#   Andy Wardley   <abw@wardley.org>
#
# NOTE
#   This file is b you'll ne scale very well, particularly with global variables
clashing all over the place.  My plan is that this will become a
view-based system and will no doubt be a test-bed for the
implementation of the view facility.

To include:

* Variable management for storing metadata relating to an
  interface/view, protected from the rest of template space.

* Also, style management for defining different styles (e.g. plain,
  fancy,  icecold, whitehot) for different interface elements (e.g.
  bars, borders, menu text) in different modes (e.g. selected, unselected),
  or under different, possibly custom conditions (e.g. user preferences,
  guest or logged in, etc.).

* Clearly define API for different elements, allowing people to write
  apps to the API which run across different conformant widget sets.

* support themes which define a set of styles

* May be wise to move Splash out to a separate distribution.

Randal Schwartz highlighted some problems with non-compliant HTML
being generated.  These include:

* no DOCTYPE declaration (added to html/header)

* ALT attribute missing from many <img> tags

* <font ...><table>...</table></font> is illegal (not sure where this
  gets done)

* <tr> shouldn't have HEIGHT attribute

* <H3> block element inside inline element

* <A> not allowed here (not sure)


#------------------------------------------------------------------------
# Test Suite
#------------------------------------------------------------------------

* t/file.t and t/directry.t are currently disable on Win32 until I get
  a chance to fix a couple of minor bugs relating to '/' vs '\' file
  separators.



<-[ Changes ][ HACKING ]->
./usr/share/doc/libtemplate-perl-doc/html/Release/HACKING.html0000644000000000000000000000654011013663225022660 0ustar rootroot Template Toolkit Release

Template Toolkit Release

HACKING

Tutorial ][ Manual ][ Modules ][ Library ][ Tools ][ FAQ ][ Release ]

<-[ TODO ]

Pointers for people wishing to hack on TT

                            Template Toolkit

                              Version 2.19

                             27 April 2007

        Copyright (C) 1996-2007 Andy Wardley.  All Rights Reserved

          This is free software; you can redistribute it and/or
             modify it under the same terms as Perl itself.

HACKER'S GUIDE
--------------

Please hack on the Template Toolkit.  It has been designed to be
extensible and has literally dozens of programmer hooks that you can
tap into to do all sorts of cool things.  The object oriented
architecture allows you to create your own subclassed modules to
implement your own services, providers, filters, plugins, and so on.

The Template::Manual::Internals document gives a brief overview of the
architecture.  Unfortunately, it's not as complete as it could be,
but the code is well documented and generally easy to follow.  Don't
be afraid to use the source, Luke.

The internals document also contains information about preparing and
applying patches, updating the documentation and various other 
useful tips.

The documentation is all built from source templates in the 'docsrc'
directory.  This includes the 'README', 'INSTALL', 'HACKING' and
'Changes' files which can be found in the 'docsrc/src/Release'
directory.  The 'docsrc' bundle is a separate distribution available
from the TT web site.  The 'docsrc/bin' directory contains scripts for
rebuilding the documentation.  See the 'docsrc/README' file for info.

If you're in the business of building a distribution (that usually
means me, but hey, you never know) then you'll need to have the latest
CVS sources which includes the 'bin/release' script.  This rebuilds
the documentation, runs the tests, fixes up the Template/Config.pm
file to a sane state and builds the distribution archive.  The
'bin/docsrc' script builds the docsrc.tar.gz distribution for the
latest release.

This document will be integrated with Template::Manual::Internals
at some point, probably as a separate hacking tutorial or something
similar.


AUTHOR
------

The Template Toolkit was written by Andy Wardley <abw@wardley.org>
with the invaluable assistance and contributions from many other
people.  See Template::Manual::Credits for details.


COPYRIGHT
---------

Copyright (C) 1996-2007 Andy Wardley.  All Rights Reserved.

This is free software; you can redistribute it and/or modify it under
the same terms as Perl itself.



<-[ TODO ]
./usr/share/doc/libtemplate-perl-doc/html/Release/Changes.html0000644000000000000000000045423711013663226023177 0ustar rootroot Template Toolkit Release

Template Toolkit Release

Changes

Tutorial ][ Manual ][ Modules ][ Library ][ Tools ][ FAQ ][ Release ]

<-[ INSTALL ][ TODO ]->

Change history
#========================================================================
#
# Changes 
#
# DESCRIPTION
#   Revision history for the Template Toolkit version 2.19, 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 
#   look out for when upgrading between major versions.
#
# AUTHOR
#   Andy Wardley   <abw@wardley.org>
#
# NOTE
#   This file is b you'll ne scale very well, particularly with global variables
clashing all over the place.  My plan is that this will become a
view-based system and will no doubt be a test-bed for the
implementation of the view facility.

To include:

* Variable management for storing metadata relating to an
  interface/view, protected from the rest of template space.

* Also, style management for defining different styles (e.g. plain,
  fancy,  icecold, whitehot) for different interface elements (e.g.
  bars, borders, menu text) in different modes (e.g. selected, unselected),
  or under different, possibly custom conditions (e.g. user preferences,
  guest or logged in, etc.).

* Clearly define API for different elements, allowing people to write
  apps to the API which run across different conformant widget sets.

* support themes which define a set of styles

* May be wise to move Splash out to a separate distribution.

Randal Schwartz highlighted some problems with non-compliant HTML
being generated.  These include:

* no DOCTYPE declaration (added to html/header)

* ALT attribute missing from many <img> tags

* <font ...><table>...</table></font> is illegal (not sure where this
  gets done)

* <tr> shouldn't have HEIGHT attribute

* <H3> block element inside inline element

* <A> not allowed here (not sure)


#------------------------------------------------------------------------
# Test Suite
#------------------------------------------------------------------------

* t/file.t and t/directry.t are currently disable on Win32 until I get
  a chance to fix a couple of minor bugs relating to '/' vs '\' file
  separators.



<-[ Changes ][ HACKING ]->
./usr/share/doc/libtemplate-perl-doc/html/Release/HACKING.html0000644000000000000000000000654011013663225022660 0ustar rootroot Template Toolkit Release

Template Toolkit Release

HACKING

Tutorial ][ Manual ][ Modules ][ Library ][ Tools ][ FAQ ][ Release ]

<-[ TODO ]

Pointers for people wishing to hack on TT

                            Template Toolkit

                              Version 2.19

                             27 April 2007

        Copyright (C) 1996-2007 Andy Wardley.  All Rights Reserved

          This is free software; you can redistribute it and/or
             modify it under the same terms as Perl itself.

HACKER'S GUIDE
--------------

Please hack on the Template Toolkit.  It has been designed to be
extensible and has literally dozens of programmer hooks that you can
tap into to do all sorts of cool things.  The object oriented
architecture allows you to create your own subclassed modules to
implement your own services, providers, filters, plugins, and so on.

The Template::Manual::Internals document gives a brief overview of the
architecture.  Unfortunately, it's not as complete as it could be,
but the code is well documented and generally easy to follow.  Don't
be afraid to use the source, Luke.

The internals document also contains information about preparing and
applying patches, updating the documentation and various other 
useful tips.

The documentation is all built from source templates in the 'docsrc'
directory.  This includes the 'README', 'INSTALL', 'HACKING' and
'Changes' files which can be found in the 'docsrc/src/Release'
directory.  The 'docsrc' bundle is a separate distribution available
from the TT web site.  The 'docsrc/bin' directory contains scripts for
rebuilding the documentation.  See the 'docsrc/README' file for info.

If you're in the business of building a distribution (that usually
means me, but hey, you never know) then you'll need to have the latest
CVS sources which includes the 'bin/release' script.  This rebuilds
the documentation, runs the tests, fixes up the Template/Config.pm
file to a sane state and builds the distribution archive.  The
'bin/docsrc' script builds the docsrc.tar.gz distribution for the
latest release.

This document will be integrated with Template::Manual::Internals
at some point, probably as a separate hacking tutorial or something
similar.


AUTHOR
------

The Template Toolkit was written by Andy Wardley <abw@wardley.org>
with the invaluable assistance and contributions from many other
people.  See Template::Manual::Credits for details.


COPYRIGHT
---------

Copyright (C) 1996-2007 Andy Wardley.  All Rights Reserved.

This is free software; you can redistribute it and/or modify it under
the same terms as Perl itself.



<-[ TODO ]
./usr/share/doc/libtemplate-perl-doc/html/Release/Changes.html0000644000000000000000000045423711013663226023177 0ustar rootroot Template Toolkit Release

Template Toolkit Release

Changes

Tutorial ][ Manual ][ Modules ][ Library ][ Tools ][ FAQ ][ Release ]

<-[ INSTALL ][ TODO ]->

Change history
#========================================================================
#
# Changes 
#
# DESCRIPTION
#   Revision history for the Template Toolkit version 2.19, 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 
#   look out for when upgrading between major versions.
#
# AUTHOR
#   Andy Wardley   <abw@wardley.org>
#
# NOTE
#   This file is b you'll ne scale very well, particularly with global variables
clashing all over the place.  My plan is that this will become a
view-based system and will no doubt be a test-bed for the
implementation of the view facility.

To include:

* Variable management for storing metadata relating to an
  interface/view, protected from the rest of template space.

* Also, style management for defining different styles (e.g. plain,
  fancy,  icecold, whitehot) for different interface elements (e.g.
  bars, borders, menu text) in different modes (e.g. selected, unselected),
  or under different, possibly custom conditions (e.g. user preferences,
  guest or logged in, etc.).

* Clearly define API for different elements, allowing people to write
  apps to the API which run across different conformant widget sets.

* support themes which define a set of styles

* May be wise to move Splash out to a separate distribution.

Randal Schwartz highlighted some problems with non-compliant HTML
being generated.  These include:

* no DOCTYPE declaration (added to html/header)

* ALT attribute missing from many <img> tags

* <font ...><table>...</table></font> is illegal (not sure where this
  gets done)

* <tr> shouldn't have HEIGHT attribute

* <H3> block element inside inline element

* <A> not allowed here (not sure)


#------------------------------------------------------------------------
# Test Suite
#------------------------------------------------------------------------

* t/file.t and t/directry.t are currently disable on Win32 until I get
  a chance to fix a couple of minor bugs relating to '/' vs '\' file
  separators.



<-[ Changes ][ HACKING ]->
./usr/share/doc/libtemplate-perl-doc/html/Release/HACKING.html0000644000000000000000000000654011013663225022660 0ustar rootroot Template Toolkit Release

Template Toolkit Release

HACKING

Tutorial ][ Manual ][ Modules ][ Library ][ Tools ][ FAQ ][ Release ]

<-[ TODO ]

Pointers for people wishing to hack on TT

                            Template Toolkit

                              Version 2.19

                             27 April 2007

        Copyright (C) 1996-2007 Andy Wardley.  All Rights Reserved

          This is free software; you can redistribute it and/or
             modify it under the same terms as Perl itself.

HACKER'S GUIDE
--------------

Please hack on the Template Toolkit.  It has been designed to be
extensible and has literally dozens of programmer hooks that you can
tap into to do all sorts of cool things.  The object oriented
architecture allows you to create your own subclassed modules to
implement your own services, providers, filters, plugins, and so on.

The Template::Manual::Internals document gives a brief overview of the
architecture.  Unfortunately, it's not as complete as it could be,
but the code is well documented and generally easy to follow.  Don't
be afraid to use the source, Luke.

The internals document also contains information about preparing and
applying patches, updating the documentation and various other 
useful tips.

The documentation is all built from source templates in the 'docsrc'
directory.  This includes the 'README', 'INSTALL', 'HACKING' and
'Changes' files which can be found in the 'docsrc/src/Release'
directory.  The 'docsrc' bundle is a separate distribution available
from the TT web site.  The 'docsrc/bin' directory contains scripts for
rebuilding the documentation.  See the 'docsrc/README' file for info.

If you're in the business of building a distribution (that usually
means me, but hey, you never know) then you'll need to have the latest
CVS sources which includes the 'bin/release' script.  This rebuilds
the documentation, runs the tests, fixes up the Template/Config.pm
file to a sane state and builds the distribution archive.  The
'bin/docsrc' script builds the docsrc.tar.gz distribution for the
latest release.

This document will be integrated with Template::Manual::Internals
at some point, probably as a separate hacking tutorial or something
similar.


AUTHOR
------

The Template Toolkit was written by Andy Wardley <abw@wardley.org>
with the invaluable assistance and contributions from many other
people.  See Template::Manual::Credits for details.


COPYRIGHT
---------

Copyright (C) 1996-2007 Andy Wardley.  All Rights Reserved.

This is free software; you can redistribute it and/or modify it under
the same terms as Perl itself.



<-[ TODO ]
./usr/share/doc/libtemplate-perl-doc/html/Release/Changes.html0000644000000000000000000045423711013663226023177 0ustar rootroot Template Toolkit Release

Template Toolkit Release

Changes

Tutorial ][ Manual ][ Modules ][ Library ][ Tools ][ FAQ ][ Release ]

<-[ INSTALL ][ TODO ]->

Change history
#========================================================================
#
# Changes 
#
# DESCRIPTION
#   Revision history for the Template Toolkit version 2.19, 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 
#   look out for when upgrading between major versions.
#
# AUTHOR
#   Andy Wardley   <abw@wardley.org>
#
# NOTE
#   This file is b you'll ne scale very well, particularly with global variables
clashing all over the place.  My plan is that this will become a
view-based system and will no doubt be a test-bed for the
implementation of the view facility.

To include:

* Variable management for storing metadata relating to an
  interface/view, protected from the rest of template space.

* Also, style management for defining different styles (e.g. plain,
  fancy,  icecold, whitehot) for different interface elements (e.g.
  bars, borders, menu text) in different modes (e.g. selected, unselected),
  or under different, possibly custom conditions (e.g. user preferences,
  guest or logged in, etc.).

* Clearly define API for different elements, allowing people to write
  apps to the API which run across different conformant widget sets.

* support themes which define a set of styles

* May be wise to move Splash out to a separate distribution.

Randal Schwartz highlighted some problems with non-compliant HTML
being generated.  These include:

* no DOCTYPE declaration (added to html/header)

* ALT attribute missing from many <img> tags

* <font ...><table>...</table></font> is illegal (not sure where this
  gets done)

* <tr> shouldn't have HEIGHT attribute

* <H3> block element inside inline element

* <A> not allowed here (not sure)


#------------------------------------------------------------------------
# Test Suite
#------------------------------------------------------------------------

* t/file.t and t/directry.t are currently disable on Win32 until I get
  a chance to fix a couple of minor bugs relating to '/' vs '\' file
  separators.



<-[ Changes ][ HACKING ]->
./usr/share/doc/libtemplate-perl-doc/html/Release/HACKING.html0000644000000000000000000000654011013663225022660 0ustar rootroot Template Toolkit Release

Template Toolkit Release

HACKING

Tutorial ][ Manual ][ Modules ][ Library ][ Tools ][ FAQ ][ Release ]

<-[ TODO ]

Pointers for people wishing to hack on TT

                            Template Toolkit

                              Version 2.19

                             27 April 2007

        Copyright (C) 1996-2007 Andy Wardley.  All Rights Reserved

          This is free software; you can redistribute it and/or
             modify it under the same terms as Perl itself.

HACKER'S GUIDE
--------------

Please hack on the Template Toolkit.  It has been designed to be
extensible and has literally dozens of programmer hooks that you can
tap into to do all sorts of cool things.  The object oriented
architecture allows you to create your own subclassed modules to
implement your own services, providers, filters, plugins, and so on.

The Template::Manual::Internals document gives a brief overview of the
architecture.  Unfortunately, it's not as complete as it could be,
but the code is well documented and generally easy to follow.  Don't
be afraid to use the source, Luke.

The internals document also contains information about preparing and
applying patches, updating the documentation and various other 
useful tips.

The documentation is all built from source templates in the 'docsrc'
directory.  This includes the 'README', 'INSTALL', 'HACKING' and
'Changes' files which can be found in the 'docsrc/src/Release'
directory.  The 'docsrc' bundle is a separate distribution available
from the TT web site.  The 'docsrc/bin' directory contains scripts for
rebuilding the documentation.  See the 'docsrc/README' file for info.

If you're in the business of building a distribution (that usually
means me, but hey, you never know) then you'll need to have the latest
CVS sources which includes the 'bin/release' script.  This rebuilds
the documentation, runs the tests, fixes up the Template/Config.pm
file to a sane state and builds the distribution archive.  The
'bin/docsrc' script builds the docsrc.tar.gz distribution for the
latest release.

This document will be integrated with Template::Manual::Internals
at some point, probably as a separate hacking tutorial or something
similar.


AUTHOR
------

The Template Toolkit was written by Andy Wardley <abw@wardley.org>
with the invaluable assistance and contributions from many other
people.  See Template::Manual::Credits for details.


COPYRIGHT
---------

Copyright (C) 1996-2007 Andy Wardley.  All Rights Reserved.

This is free software; you can redistribute it and/or modify it under
the same terms as Perl itself.



<-[ TODO ]
./usr/share/doc/libtemplate-perl-doc/html/Release/Changes.html0000644000000000000000000045423711013663226023177 0ustar rootroot Template Toolkit Release

Template Toolkit Release

Changes

Tutorial ][ Manual ][ Modules ][ Library ][ Tools ][ FAQ ][ Release ]

<-[ INSTALL ][ TODO ]->

Change history
#========================================================================
#
# Changes 
#
# DESCRIPTION
#   Revision history for the Template Toolkit version 2.19, 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 
#   look out for when upgrading between major versions.
#
# AUTHOR
#   Andy Wardley   <abw@wardley.org>
#
# NOTE
#   This file is b you'll ne scale very well, particularly with global variables
clashing all over the place.  My plan is that this will become a
view-based system and will no doubt be a test-bed for the
implementation of the view facility.

To include:

* Variable management for storing metadata relating to an
  interface/view, protected from the rest of template space.

* Also, style management for defining different styles (e.g. plain,
  fancy,  icecold, whitehot) for different interface elements (e.g.
  bars, borders, menu text) in different modes (e.g. selected, unselected),
  or under different, possibly custom conditions (e.g. user preferences,
  guest or logged in, etc.).

* Clearly define API for different elements, allowing people to write
  apps to the API which run across different conformant widget sets.

* support themes which define a set of styles

* May be wise to move Splash out to a separate distribution.

Randal Schwartz highlighted some problems with non-compliant HTML
being generated.  These include:

* no DOCTYPE declaration (added to html/header)

* ALT attribute missing from many <img> tags

* <font ...><table>...</table></font> is illegal (not sure where this
  gets done)

* <tr> shouldn't have HEIGHT attribute

* <H3> block element inside inline element

* <A> not allowed here (not sure)


#------------------------------------------------------------------------
# Test Suite
#------------------------------------------------------------------------

* t/file.t and t/directry.t are currently disable on Win32 until I get
  a chance to fix a couple of minor bugs relating to '/' vs '\' file
  separators.



<-[ Changes ][ HACKING ]->
./usr/share/doc/libtemplate-perl-doc/html/Release/HACKING.html0000644000000000000000000000654011013663225022660 0ustar rootroot Template Toolkit Release

Template Toolkit Release

HACKING

Tutorial ][ Manual ][ Modules ][ Library ][ Tools ][ FAQ ][ Release ]

<-[ TODO ]

Pointers for people wishing to hack on TT

                            Template Toolkit

                              Version 2.19

                             27 April 2007

        Copyright (C) 1996-2007 Andy Wardley.  All Rights Reserved

          This is free software; you can redistribute it and/or
             modify it under the same terms as Perl itself.

HACKER'S GUIDE
--------------

Please hack on the Template Toolkit.  It has been designed to be
extensible and has literally dozens of programmer hooks that you can
tap into to do all sorts of cool things.  The object oriented
architecture allows you to create your own subclassed modules to
implement your own services, providers, filters, plugins, and so on.

The Template::Manual::Internals document gives a brief overview of the
architecture.  Unfortunately, it's not as complete as it could be,
but the code is well documented and generally easy to follow.  Don't
be afraid to use the source, Luke.

The internals document also contains information about preparing and
applying patches, updating the documentation and various other 
useful tips.

The documentation is all built from source templates in the 'docsrc'
directory.  This includes the 'README', 'INSTALL', 'HACKING' and
'Changes' files which can be found in the 'docsrc/src/Release'
directory.  The 'docsrc' bundle is a separate distribution available
from the TT web site.  The 'docsrc/bin' directory contains scripts for
rebuilding the documentation.  See the 'docsrc/README' file for info.

If you're in the business of building a distribution (that usually
means me, but hey, you never know) then you'll need to have the latest
CVS sources which includes the 'bin/release' script.  This rebuilds
the documentation, runs the tests, fixes up the Template/Config.pm
file to a sane state and builds the distribution archive.  The
'bin/docsrc' script builds the docsrc.tar.gz distribution for the
latest release.

This document will be integrated with Template::Manual::Internals
at some point, probably as a separate hacking tutorial or something
similar.


AUTHOR
------

The Template Toolkit was written by Andy Wardley <abw@wardley.org>
with the invaluable assistance and contributions from many other
people.  See Template::Manual::Credits for details.


COPYRIGHT
---------

Copyright (C) 1996-2007 Andy Wardley.  All Rights Reserved.

This is free software; you can redistribute it and/or modify it under
the same terms as Perl itself.



<-[ TODO ]
./usr/share/doc/libtemplate-perl-doc/html/Release/Changes.html0000644000000000000000000045423711013663226023177 0ustar rootroot Template Toolkit Release

Template Toolkit Release

Changes

Tutorial ][ Manual ][ Modules ][ Library ][ Tools ][ FAQ ][ Release ]

<-[ INSTALL ][ TODO ]->

Change history
#========================================================================
#
# Changes 
#
# DESCRIPTION
#   Revision history for the Template Toolkit version 2.19, 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 
#   look out for when upgrading between major versions.
#
# AUTHOR
#   Andy Wardley   <abw@wardley.org>
#
# NOTE
#   This file is b you'll ne scale very well, particularly with global variables
clashing all over the place.  My plan is that this will become a
view-based system and will no doubt be a test-bed for the
implementation of the view facility.

To include:

* Variable management for storing metadata relating to an
  interface/view, protected from the rest of template space.

* Also, style management for defining different styles (e.g. plain,
  fancy,  icecold, whitehot) for different interface elements (e.g.
  bars, borders, menu text) in different modes (e.g. selected, unselected),
  or under different, possibly custom conditions (e.g. user preferences,
  guest or logged in, etc.).

* Clearly define API for different elements, allowing people to write
  apps to the API which run across different conformant widget sets.

* support themes which define a set of styles

* May be wise to move Splash out to a separate distribution.

Randal Schwartz highlighted some problems with non-compliant HTML
being generated.  These include:

* no DOCTYPE declaration (added to html/header)

* ALT attribute missing from many <img> tags

* <font ...><table>...</table></font> is illegal (not sure where this
  gets done)

* <tr> shouldn't have HEIGHT attribute

* <H3> block element inside inline element

* <A> not allowed here (not sure)


#------------------------------------------------------------------------
# Test Suite
#------------------------------------------------------------------------

* t/file.t and t/directry.t are currently disable on Win32 until I get
  a chance to fix a couple of minor bugs relating to '/' vs '\' file
  separators.



<-[ Changes ][ HACKING ]->
./usr/share/doc/libtemplate-perl-doc/html/Release/HACKING.html0000644000000000000000000000654011013663225022660 0ustar rootroot Template Toolkit Release

Template Toolkit Release

HACKING

Tutorial ][ Manual ][ Modules ][ Library ][ Tools ][ FAQ ][ Release ]

<-[ TODO ]

Pointers for people wishing to hack on TT

                            Template Toolkit

                              Version 2.19

                             27 April 2007

        Copyright (C) 1996-2007 Andy Wardley.  All Rights Reserved

          This is free software; you can redistribute it and/or
             modify it under the same terms as Perl itself.

HACKER'S GUIDE
--------------

Please hack on the Template Toolkit.  It has been designed to be
extensible and has literally dozens of programmer hooks that you can
tap into to do all sorts of cool things.  The object oriented
architecture allows you to create your own subclassed modules to
implement your own services, providers, filters, plugins, and so on.

The Template::Manual::Internals document gives a brief overview of the
architecture.  Unfortunately, it's not as complete as it could be,
but the code is well documented and generally easy to follow.  Don't
be afraid to use the source, Luke.

The internals document also contains information about preparing and
applying patches, updating the documentation and various other 
useful tips.

The documentation is all built from source templates in the 'docsrc'
directory.  This includes the 'README', 'INSTALL', 'HACKING' and
'Changes' files which can be found in the 'docsrc/src/Release'
directory.  The 'docsrc' bundle is a separate distribution available
from the TT web site.  The 'docsrc/bin' directory contains scripts for
rebuilding the documentation.  See the 'docsrc/README' file for info.

If you're in the business of building a distribution (that usually
means me, but hey, you never know) then you'll need to have the latest
CVS sources which includes the 'bin/release' script.  This rebuilds
the documentation, runs the tests, fixes up the Template/Config.pm
file to a sane state and builds the distribution archive.  The
'bin/docsrc' script builds the docsrc.tar.gz distribution for the
latest release.

This document will be integrated with Template::Manual::Internals
at some point, probably as a separate hacking tutorial or something
similar.


AUTHOR
------

The Template Toolkit was written by Andy Wardley <abw@wardley.org>
with the invaluable assistance and contributions from many other
people.  See Template::Manual::Credits for details.


COPYRIGHT
---------

Copyright (C) 1996-2007 Andy Wardley.  All Rights Reserved.

This is free software; you can redistribute it and/or modify it under
the same terms as Perl itself.



<-[ TODO ]
./usr/share/doc/libtemplate-perl-doc/html/Release/Changes.html0000644000000000000000000045423711013663226023177 0ustar rootroot Template Toolkit Release

Template Toolkit Release

Changes

Tutorial ][ Manual ][ Modules ][ Library ][ Tools ][ FAQ ][ Release ]

<-[ INSTALL ][ TODO ]->

Change history
#========================================================================
#
# Changes 
#
# DESCRIPTION
#   Revision history for the Template Toolkit version 2.19, 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 
#   look out for when upgrading between major versions.
#
# AUTHOR
#   Andy Wardley   <abw@wardley.org>
#
# NOTE
#   This file is b you'll ne scale very well, particularly with global variables
clashing all over the place.  My plan is that this will become a
view-based system and will no doubt be a test-bed for the
implementation of the view facility.

To include:

* Variable management for storing metadata relating to an
  interface/view, protected from the rest of template space.

* Also, style management for defining different styles (e.g. plain,
  fancy,  icecold, whitehot) for different interface elements (e.g.
  bars, borders, menu text) in different modes (e.g. selected, unselected),
  or under different, possibly custom conditions (e.g. user preferences,
  guest or logged in, etc.).

* Clearly define API for different elements, allowing people to write
  apps to the API which run across different conformant widget sets.

* support themes which define a set of styles

* May be wise to move Splash out to a separate distribution.

Randal Schwartz highlighted some problems with non-compliant HTML
being generated.  These include:

* no DOCTYPE declaration (added to html/header)

* ALT attribute missing from many <img> tags

* <font ...><table>...</table></font> is illegal (not sure where this
  gets done)

* <tr> shouldn't have HEIGHT attribute

* <H3> block element inside inline element

* <A> not allowed here (not sure)


#------------------------------------------------------------------------
# Test Suite
#------------------------------------------------------------------------

* t/file.t and t/directry.t are currently disable on Win32 until I get
  a chance to fix a couple of minor bugs relating to '/' vs '\' file
  separators.



<-[ Changes ][ HACKING ]->
./usr/share/doc/libtemplate-perl-doc/html/Release/HACKING.html0000644000000000000000000000654011013663225022660 0ustar rootroot Template Toolkit Release

Template Toolkit Release

HACKING

Tutorial ][ Manual ][ Modules ][ Library ][ Tools ][ FAQ ][ Release ]

<-[ TODO ]

Pointers for people wishing to hack on TT

                            Template Toolkit

                              Version 2.19

                             27 April 2007

        Copyright (C) 1996-2007 Andy Wardley.  All Rights Reserved

          This is free software; you can redistribute it and/or
             modify it under the same terms as Perl itself.

HACKER'S GUIDE
--------------

Please hack on the Template Toolkit.  It has been designed to be
extensible and has literally dozens of programmer hooks that you can
tap into to do all sorts of cool things.  The object oriented
architecture allows you to create your own subclassed modules to
implement your own services, providers, filters, plugins, and so on.

The Template::Manual::Internals document gives a brief overview of the
architecture.  Unfortunately, it's not as complete as it could be,
but the code is well documented and generally easy to follow.  Don't
be afraid to use the source, Luke.

The internals document also contains information about preparing and
applying patches, updating the documentation and various other 
useful tips.

The documentation is all built from source templates in the 'docsrc'
directory.  This includes the 'README', 'INSTALL', 'HACKING' and
'Changes' files which can be found in the 'docsrc/src/Release'
directory.  The 'docsrc' bundle is a separate distribution available
from the TT web site.  The 'docsrc/bin' directory contains scripts for
rebuilding the documentation.  See the 'docsrc/README' file for info.

If you're in the business of building a distribution (that usually
means me, but hey, you never know) then you'll need to have the latest
CVS sources which includes the 'bin/release' script.  This rebuilds
the documentation, runs the tests, fixes up the Template/Config.pm
file to a sane state and builds the distribution archive.  The
'bin/docsrc' script builds the docsrc.tar.gz distribution for the
latest release.

This document will be integrated with Template::Manual::Internals
at some point, probably as a separate hacking tutorial or something
similar.


AUTHOR
------

The Template Toolkit was written by Andy Wardley <abw@wardley.org>
with the invaluable assistance and contributions from many other
people.  See Template::Manual::Credits for details.


COPYRIGHT
---------

Copyright (C) 1996-2007 Andy Wardley.  All Rights Reserved.

This is free software; you can redistribute it and/or modify it under
the same terms as Perl itself.



<-[ TODO ]
./usr/share/doc/libtemplate-perl-doc/html/Release/Changes.html0000644000000000000000000045423711013663226023177 0ustar rootroot Template Toolkit Release

Template Toolkit Release

Changes

Tutorial ][ Manual ][ Modules ][ Library ][ Tools ][ FAQ ][ Release ]

<-[ INSTALL ][ TODO ]->

Change history
#========================================================================
#
# Changes 
#
# DESCRIPTION
#   Revision history for the Template Toolkit version 2.19, 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 
#   look out for when upgrading between major versions.
#
# AUTHOR
#   Andy Wardley   <abw@wardley.org>
#
# NOTE
#   This file is b you'll ne scale very well, particularly with global variables
clashing all over the place.  My plan is that this will become a
view-based system and will no doubt be a test-bed for the
implementation of the view facility.

To include:

* Variable management for storing metadata relating to an
  interface/view, protected from the rest of template space.

* Also, style management for defining different styles (e.g. plain,
  fancy,  icecold, whitehot) for different interface elements (e.g.
  bars, borders, menu text) in different modes (e.g. selected, unselected),
  or under different, possibly custom conditions (e.g. user preferences,
  guest or logged in, etc.).

* Clearly define API for different elements, allowing people to write
  apps to the API which run across different conformant widget sets.

* support themes which define a set of styles

* May be wise to move Splash out to a separate distribution.

Randal Schwartz highlighted some problems with non-compliant HTML
being generated.  These include:

* no DOCTYPE declaration (added to html/header)

* ALT attribute missing from many <img> tags

* <font ...><table>...</table></font> is illegal (not sure where this
  gets done)

* <tr> shouldn't have HEIGHT attribute

* <H3> block element inside inline element

* <A> not allowed here (not sure)


#------------------------------------------------------------------------
# Test Suite
#------------------------------------------------------------------------

* t/file.t and t/directry.t are currently disable on Win32 until I get
  a chance to fix a couple of minor bugs relating to '/' vs '\' file
  separators.



<-[ Changes ][ HACKING ]->
./usr/share/doc/libtemplate-perl-doc/html/Release/HACKING.html0000644000000000000000000000654011013663225022660 0ustar rootroot Template Toolkit Release

Template Toolkit Release

HACKING

Tutorial ][ Manual ][ Modules ][ Library ][ Tools ][ FAQ ][ Release ]

<-[ TODO ]

Pointers for people wishing to hack on TT

                            Template Toolkit

                              Version 2.19

                             27 April 2007

        Copyright (C) 1996-2007 Andy Wardley.  All Rights Reserved

          This is free software; you can redistribute it and/or
             modify it under the same terms as Perl itself.

HACKER'S GUIDE
--------------

Please hack on the Template Toolkit.  It has been designed to be
extensible and has literally dozens of programmer hooks that you can
tap into to do all sorts of cool things.  The object oriented
architecture allows you to create your own subclassed modules to
implement your own services, providers, filters, plugins, and so on.

The Template::Manual::Internals document gives a brief overview of the
architecture.  Unfortunately, it's not as complete as it could be,
but the code is well documented and generally easy to follow.  Don't
be afraid to use the source, Luke.

The internals document also contains information about preparing and
applying patches, updating the documentation and various other 
useful tips.

The documentation is all built from source templates in the 'docsrc'
directory.  This includes the 'README', 'INSTALL', 'HACKING' and
'Changes' files which can be found in the 'docsrc/src/Release'
directory.  The 'docsrc' bundle is a separate distribution available
from the TT web site.  The 'docsrc/bin' directory contains scripts for
rebuilding the documentation.  See the 'docsrc/README' file for info.

If you're in the business of building a distribution (that usually
means me, but hey, you never know) then you'll need to have the latest
CVS sources which includes the 'bin/release' script.  This rebuilds
the documentation, runs the tests, fixes up the Template/Config.pm
file to a sane state and builds the distribution archive.  The
'bin/docsrc' script builds the docsrc.tar.gz distribution for the
latest release.

This document will be integrated with Template::Manual::Internals
at some point, probably as a separate hacking tutorial or something
similar.


AUTHOR
------

The Template Toolkit was written by Andy Wardley <abw@wardley.org>
with the invaluable assistance and contributions from many other
people.  See Template::Manual::Credits for details.


COPYRIGHT
---------

Copyright (C) 1996-2007 Andy Wardley.  All Rights Reserved.

This is free software; you can redistribute it and/or modify it under
the same terms as Perl itself.



<-[ TODO ]
./usr/share/doc/libtemplate-perl-doc/html/Release/Changes.html0000644000000000000000000045423711013663226023177 0ustar rootroot Template Toolkit Release

Template Toolkit Release

Changes

Tutorial ][ Manual ][ Modules ][ Library ][ Tools ][ FAQ ][ Release ]

<-[ INSTALL ][ TODO ]->

Change history
#========================================================================
#
# Changes 
#
# DESCRIPTION
#   Revision history for the Template Toolkit version 2.19, 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 
#   look out for when upgrading between major versions.
#
# AUTHOR
#   Andy Wardley   <abw@wardley.org>
#
# NOTE
#   This file is b you'll ne scale very well, particularly with global variables
clashing all over the place.  My plan is that this will become a
view-based system and will no doubt be a test-bed for the
implementation of the view facility.

To include:

* Variable management for storing metadata relating to an
  interface/view, protected from the rest of template space.

* Also, style management for defining different styles (e.g. plain,
  fancy,  icecold, whitehot) for different interface elements (e.g.
  bars, borders, menu text) in different modes (e.g. selected, unselected),
  or under different, possibly custom conditions (e.g. user preferences,
  guest or logged in, etc.).

* Clearly define API for different elements, allowing people to write
  apps to the API which run across different conformant widget sets.

* support themes which define a set of styles

* May be wise to move Splash out to a separate distribution.

Randal Schwartz highlighted some problems with non-compliant HTML
being generated.  These include:

* no DOCTYPE declaration (added to html/header)

* ALT attribute missing from many <img> tags

* <font ...><table>...</table></font> is illegal (not sure where this
  gets done)

* <tr> shouldn't have HEIGHT attribute

* <H3> block element inside inline element

* <A> not allowed here (not sure)


#------------------------------------------------------------------------
# Test Suite
#------------------------------------------------------------------------

* t/file.t and t/directry.t are currently disable on Win32 until I get
  a chance to fix a couple of minor bugs relating to '/' vs '\' file
  separators.



<-[ Changes ][ HACKING ]->
./usr/share/doc/libtemplate-perl-doc/html/Release/HACKING.html0000644000000000000000000000654011013663225022660 0ustar rootroot Template Toolkit Release

Template Toolkit Release

HACKING

Tutorial ][ Manual ][ Modules ][ Library ][ Tools ][ FAQ ][ Release ]

<-[ TODO ]

Pointers for people wishing to hack on TT

                            Template Toolkit

                              Version 2.19

                             27 April 2007

        Copyright (C) 1996-2007 Andy Wardley.  All Rights Reserved

          This is free software; you can redistribute it and/or
             modify it under the same terms as Perl itself.

HACKER'S GUIDE
--------------

Please hack on the Template Toolkit.  It has been designed to be
extensible and has literally dozens of programmer hooks that you can
tap into to do all sorts of cool things.  The object oriented
architecture allows you to create your own subclassed modules to
implement your own services, providers, filters, plugins, and so on.

The Template::Manual::Internals document gives a brief overview of the
architecture.  Unfortunately, it's not as complete as it could be,
but the code is well documented and generally easy to follow.  Don't
be afraid to use the source, Luke.

The internals document also contains information about preparing and
applying patches, updating the documentation and various other 
useful tips.

The documentation is all built from source templates in the 'docsrc'
directory.  This includes the 'README', 'INSTALL', 'HACKING' and
'Changes' files which can be found in the 'docsrc/src/Release'
directory.  The 'docsrc' bundle is a separate distribution available
from the TT web site.  The 'docsrc/bin' directory contains scripts for
rebuilding the documentation.  See the 'docsrc/README' file for info.

If you're in the business of building a distribution (that usually
means me, but hey, you never know) then you'll need to have the latest
CVS sources which includes the 'bin/release' script.  This rebuilds
the documentation, runs the tests, fixes up the Template/Config.pm
file to a sane state and builds the distribution archive.  The
'bin/docsrc' script builds the docsrc.tar.gz distribution for the
latest release.

This document will be integrated with Template::Manual::Internals
at some point, probably as a separate hacking tutorial or something
similar.


AUTHOR
------

The Template Toolkit was written by Andy Wardley <abw@wardley.org>
with the invaluable assistance and contributions from many other
people.  See Template::Manual::Credits for details.


COPYRIGHT
---------

Copyright (C) 1996-2007 Andy Wardley.  All Rights Reserved.

This is free software; you can redistribute it and/or modify it under
the same terms as Perl itself.



<-[ TODO ]
./usr/share/doc/libtemplate-perl-doc/html/Release/Changes.html0000644000000000000000000045423711013663226023177 0ustar rootroot Template Toolkit Release

Template Toolkit Release

Changes

Tutorial ][ Manual ][ Modules ][ Library ][ Tools ][ FAQ ][ Release ]

<-[ INSTALL ][ TODO ]->

Change history
#========================================================================
#
# Changes 
#
# DESCRIPTION
#   Revision history for the Template Toolkit version 2.19, 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 
#   look out for when upgrading between major versions.
#
# AUTHOR
#   Andy Wardley   <abw@wardley.org>
#
# NOTE
#   This file is b you'll ne scale very well, particularly with global variables
clashing all over the place.  My plan is that this will become a
view-based system and will no doubt be a test-bed for the
implementation of the view facility.

To include:

* Variable management for storing metadata relating to an
  interface/view, protected from the rest of template space.

* Also, style management for defining different styles (e.g. plain,
  fancy,  icecold, whitehot) for different interface elements (e.g.
  bars, borders, menu text) in different modes (e.g. selected, unselected),
  or under different, possibly custom conditions (e.g. user preferences,
  guest or logged in, etc.).

* Clearly define API for different elements, allowing people to write
  apps to the API which run across different conformant widget sets.

* support themes which define a set of styles

* May be wise to move Splash out to a separate distribution.

Randal Schwartz highlighted some problems with non-compliant HTML
being generated.  These include:

* no DOCTYPE declaration (added to html/header)

* ALT attribute missing from many <img> tags

* <font ...><table>...</table></font> is illegal (not sure where this
  gets done)

* <tr> shouldn't have HEIGHT attribute

* <H3> block element inside inline element

* <A> not allowed here (not sure)


#------------------------------------------------------------------------
# Test Suite
#------------------------------------------------------------------------

* t/file.t and t/directry.t are currently disable on Win32 until I get
  a chance to fix a couple of minor bugs relating to '/' vs '\' file
  separators.



<-[ Changes ][ HACKING ]->
./usr/share/doc/libtemplate-perl-doc/html/Release/HACKING.html0000644000000000000000000000654011013663225022660 0ustar rootroot Template Toolkit Release

Template Toolkit Release

HACKING

Tutorial ][ Manual ][ Modules ][ Library ][ Tools ][ FAQ ][ Release ]

<-[ TODO ]

Pointers for people wishing to hack on TT

                            Template Toolkit

                              Version 2.19

                             27 April 2007

        Copyright (C) 1996-2007 Andy Wardley.  All Rights Reserved

          This is free software; you can redistribute it and/or
             modify it under the same terms as Perl itself.

HACKER'S GUIDE
--------------

Please hack on the Template Toolkit.  It has been designed to be
extensible and has literally dozens of programmer hooks that you can
tap into to do all sorts of cool things.  The object oriented
architecture allows you to create your own subclassed modules to
implement your own services, providers, filters, plugins, and so on.

The Template::Manual::Internals document gives a brief overview of the
architecture.  Unfortunately, it's not as complete as it could be,
but the code is well documented and generally easy to follow.  Don't
be afraid to use the source, Luke.

The internals document also contains information about preparing and
applying patches, updating the documentation and various other 
useful tips.

The documentation is all built from source templates in the 'docsrc'
directory.  This includes the 'README', 'INSTALL', 'HACKING' and
'Changes' files which can be found in the 'docsrc/src/Release'
directory.  The 'docsrc' bundle is a separate d