The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.
 / 
HTML-Mason-1.14
River stage two • 41 direct dependents • 76 total dependents
13 ++

Changes for version 1.14

  • BACKWARDS COMPATIBILITY
  • Added compatibility layer for 1.0x cache API. It is now possible to use $m->cache and $m->cache_self in the old way by setting the data_cache_api parameter to '1.0'.
  • Added back $comp->create_time, which was renamed as $comp->load_time in 1.09_02, as a deprecated method.
  • Added back $interp->time and $m->current_time, which were removed in
  • 1.09_01, as deprecated methods.
    • ENHANCEMENTS
    • Implemented the long requested user-defined escapes feature. It is now possible to define your own escape flags, as well as overriding Mason's own 'h' and 'u' flags.
    • Implemented expire_if and busy_lock options in new $m->cache->get API. These retain the essence of the 1.0x options although both work a little differently.
    • Added new module to implement caching extensions, HTML::Mason::Cache::BaseCache, with accompanying documentation.
    • Enhanced Params.pod with TOC and full descriptions of all parameters. Standardized rest of documentation to link to Params.pod when referring to a parameter.
    • When a component path is not found, but that path matches a file on disk, we now print an extra warning, because this indicates that the user does not understand the distinction between component paths and filesystem paths.
    • The Request object's redirect() method now accepts an optional additional argument, allowing users to use a status code other than 302 for the redirect.
    • Mason should now work on a box with a fresh mod_perl 2/Apache 2 install. Previously, Mason unconditionally tried to load Apache::Status, which comes with mod_perl 1.x, but not (yet?) with mod_perl 2.
      • BUG FIXES
    • Installation was failing when Exception::Class wasn't installed.
    • Calling <%def> subcomponents no longer changes base_comp, which is important in autohandlers. (reported by Ian Robertson)
    • The documentation incorrectly indicated that you could create an ApacheHandler object during server startup without providing a component root. This will also shown incorrectly in the sample handler.pl in the eg/ directory.
    • Reduced Mason's memory usage when compiling and serving components. This is particularly noticeable with very large components (1-2MB or greater). Work on this will continue for future versions. (reported by Todd Holbrook)
    • %ARGS and <%shared> variables could not be accessed from <%filter>. (reported by Adam Roth)
    • Switch.pm did not work in file-based components. (reported by Gert Thiel)
    • use_strict could not be turned off. (reported by Viacheslav Voytovich)
    • $m->clear_buffer (and $m->redirect) did not work inside a component call with content. (reported by Manuel Capinha)
    • Some tests were failing on Windows, because they assumed Unix style filesystem paths. This was a problem with the tests, not the core code, but still worth fixing. (reported by Adam Rinehart).
    • $m->caller() was inadvertently left out of the documentation - fixed.
    • Fixed a small documentation error about what kinds of things are valid keys in <%flags> and <%attr> blocks.
    • Configuring multiple component roots via the httpd.conf file failed silently (as opposed to releases 1.10 - 1.12, where this failed with an error).
    • Unreadable component source files caused the confusing error message "source callback returned no source". This will now throw a much more helpful exception.
    • Errors occuring in subrequests would cause error output to be mixed with regular output when the error_mode was "output" (the default with ApacheHandler and CGIHandler). Errors in subrequests should now look the same as errors in the top request.

Documentation

HTML::Mason::Admin
Mason Administrator's Manual
HTML::Mason::Devel
Mason Developer's Manual
HTML::Mason::Params
Mason configuration parameters
HTML::Mason::Subclassing
Documentation on Subclassing Internal Mason classes

Modules

Bundle::HTML::Mason
A bundle to install the HTML::Mason package
HTML::Mason
High-performance, dynamic web site authoring system
HTML::Mason::ApacheHandler
Mason/mod_perl interface
HTML::Mason::Buffer
Objects for Handling Component Output
HTML::Mason::CGIHandler
Use Mason in a CGI environment
HTML::Mason::Cache::BaseCache
Base cache object
HTML::Mason::Compiler
Compile Mason component source
HTML::Mason::Compiler::ToObject
A Compiler subclass that generates Mason object code
HTML::Mason::Component
Mason Component Class
HTML::Mason::ComponentSource
represents information about an component
HTML::Mason::Escapes
Functions to escape text for Mason
HTML::Mason::Exceptions
Exception objects thrown by Mason
HTML::Mason::Interp
Mason Component Interpreter
HTML::Mason::Lexer
Generates events based on component source lexing
HTML::Mason::MethodMaker
Used to create simple get & get/set methods in other classes
HTML::Mason::Parser
Old module for compiling components
HTML::Mason::Request
Mason Request Class
HTML::Mason::Resolver
Component path resolver base class
HTML::Mason::Resolver::File
Component path resolver for file-based components
HTML::Mason::Resolver::Null
a do-nothing resolver
HTML::Mason::Tests
Test harness for testing Mason
HTML::Mason::Tools
Function library used internally in Mason
HTML::Mason::Utils
Publically available functions useful outside of Mason

Provides

Apache::Mason
in lib/Apache/Mason.pm
HTML::Mason::Component::FileBased
in lib/HTML/Mason/Component/FileBased.pm
HTML::Mason::Component::Subcomponent
in lib/HTML/Mason/Component/Subcomponent.pm
HTML::Mason::Exception
in lib/HTML/Mason/Exceptions.pm
HTML::Mason::Exception::Compilation
in lib/HTML/Mason/Exceptions.pm
HTML::Mason::Exception::Syntax
in lib/HTML/Mason/Exceptions.pm
HTML::Mason::FakeApache
in lib/HTML/Mason/CGIHandler.pm
HTML::Mason::Request::ApacheHandler
in lib/HTML/Mason/ApacheHandler.pm
HTML::Mason::Request::CGI
in lib/HTML/Mason/CGIHandler.pm
HTML::Mason::Resolver::File::ApacheHandler
in lib/HTML/Mason/ApacheHandler.pm

Examples

Other files