Loads more documentation hacking.

[maypole.git] / doc / Request.pod

diff --git a/doc/Request.pod b/doc/Request.pod
index 80e4037cd9bd216f3bf707880efa213327ff456f..96f7c552ae954e378d696f61bfaf507654ed2211 100644 (file)
--- a/doc/Request.pod
+++ b/doc/Request.pod
@@ -50,6 +50,24 @@ These hacks deal primarily with the presentation of data to the user,
 modifying the C<view> template or changing the way that the results of
 particular actions are displayed.
 
+=head3 Null Action
+
+You need an "action" which doesn't really do anything, but just formats
+up a template.
+
+B<Solution>: There are two ways to do this, depending on what precisely
+you need. If you just need to display a template, C<Apache::Template>
+style, with no Maypole objects in it, then you don't need to write any
+code; just create your template, and it will be available in the usual
+way.
+
+If, on the other hand, you want to display some data, and what you're
+essentially doing is a variant of the C<view> action, then you need to
+ensure that you have an exported action, as described in
+L<StandardTemplates.pod>:
+
+    sub my_view :Exported { }
+
 =head3 Template Switcheroo
 
 An action doesn't have any data of its own to display, but needs to display