Merge commit '2.11+2.111' into HEAD

[maypole.git] / lib / Maypole / Manual / View.pod

diff --git a/lib/Maypole/Manual/View.pod b/lib/Maypole/Manual/View.pod
index 01745ed8a5f6c6c15778f9fea03a4572c6917794..fe46edd60c9db6e9ed9161f57d502593bc8d1f7f 100644 (file)
--- a/lib/Maypole/Manual/View.pod
+++ b/lib/Maypole/Manual/View.pod
@@ -1,4 +1,8 @@
-=head1 Maypole View Classes
+=head1 NAME
+
+Maypole::Manual::View - Maypole View Classes
+
+=head1 DESCRIPTION
 
 In a large application, you will almost certainly want to customize the
 layout and design of the output pages. This task may even be the purview
@@ -381,10 +385,6 @@ that class. That is, for the C<beer> table, C<classmetadata.cgi.style>
 should be a C<HTML::Element> object containing a drop-down list of
 beer styles.
 
-TODO =item C<description>
-TODO
-TODO This is the human-readable description provided by a class.
-
 =item C<related_accessors>
 
 This is a list of accessors which can be called on an object to get
@@ -408,6 +408,23 @@ C<template_args> hash in the request object, and supply its value:
 You can also override the value of any of the standard variables by
 giving their name as the key.
 
+=head2 Accessing other classes
+
+When building a frontpage, login or other template that isn't directly
+linked to a particular table, (and therefore it's class,) that you wish to
+use, you can access the classes directly.
+
+When using C<Maypole::View::TT> you are reccomended to use Richard Clamp's
+incredibly useful Template::Plugin::Class -- see the and Template::Plugin::Class
+and C<Maypole::View::TT> documentation for details.
+
+Mason and MasonX views also allow you to pull in arbitary classes, see
+the relevent Mason and Plugin/View documentation for details.
+
+If you are using HTML::Template you are out of luck on this front due
+to philosophy and architecture this templating system cannot call code,
+and only reads the data provided when the template is processed.
+
 =head2 Other view classes
 
 Please note that these template variables, C<config>, C<classmetadata>,
@@ -551,3 +568,5 @@ Patches are always welcome!
 L<Contents|Maypole::Manual>,
 Next L<Standard Templates and Actions|Maypole::Manual::StandardTemplates>,
 Previous L<Maypole Model Classes|Maypole::Manual::Model>,
+
+=cut