NAME

  http://www.masonhq.com/docs/manual/0.8/Interp.html#standalone_mode
  > I believe this is related to the underlying XML
  > parsing with Expat. It's a namespace collision
  > (apparently). The solution is to rebuild your
  > Apache with --disable-rules=EXPAT. There
  > is more information on the AxKit page on how
  > to do this: http://axkit.org/faq.xml
  > If "strings `which httpd` | grep -i xml"
  > returns anything, you have this problem.
  http://www.masonhq.com/docs/manual/0.8/Admin.html#external_modules
  my $foo = sub {...};
  my $query = new CGI('');
  <% $query->radio_group(...) %>
  http://www.masonhq.com/docs/manual/0.8/Devel.html#sending_http_headers
  === redirect.pl ===
  <%perl>
    $m->clear_buffer;
    # The next two lines are necessary to stop Apache from re-reading
    # POSTed data.
    $r->method('GET');
    $r->headers_in->unset('Content-length');
    $r->content_type('text/html');
    $r->header_out('Location' => $location);
    $m->abort(301);
  </%perl>
  %
  <%args>
    $location
  </%args>
  ===================
  sub handler {
    my $r = shift;
    $ah->handle_request($r);
  }
  http://www.masonhq.com/docs/manual/0.8/Request.html#item_abort_return_value_
  <!-- temporarily comment out
  <& FetchAd &>
  -->
  % if (0) {
    ...
  % }
  http://www.masonhq.com/docs/manual/0.8/Request.html#item_scomp
  package HTML::Mason::Commands;
  use vars qw(...);
  http://www.masonhq.com/docs/manual/Admin.html#using_global_variables
  use_strict => 0
  $m->cache(..., expire_if=>sub { (stat($m->source_file))[9] > $_[0] } )
  http://www.masonhq.com/docs/manual/Admin.html#out_mode
  http://www.masonhq.com/docs/manual/Request.html#item_out_string
  Try doing this in your handler.pl (or somewhere):

  use CGI qw(-private_tempfiles);

  You must do this _before_ you do:

  use HTML::Mason;

  or

  use HTML::Mason::ApacheHandler;

  That may change which directories CGI tries to use.

  I think the other hack is to do:

  $CGI::TempFile::TMPDIRECTORY = '/tmp';

  during startup.

  The root of the problem is probably that the temp directory is being
  chosen when the module loads during server startup while its still root.
  It sees it can write to /usr/tmp and is happy.  Then when actually running
  as nobody it dies.

  I bet Lincoln would welcome a patch (hint, hint, someone other than me).
  One solution would be to check if you're running under mod_perl and you're
  root.  If so, then check Apache- server- uid and see if that id can write
  to the temp directory too.

  Or something like that.
  my $subr = $r->lookup_file($file);
  return 404 unless -f $file and $subr->status == 200;
  $r->content_type($subr->content_type);
  $r->send_http_header;
  return 200 if $r->header_only;
  $subr->run;
  $m->abort;
  return -1 if defined($r->content_type) && $r->content_type !~ m|^text/|io;
  <Location /plain>
    SetHandler default-handler
  </Location>
   <FilesMatch  "\.html$">
     SetHandler perl-script
     PerlHandler HTML::Mason
   </FilesMatch>
  return -1 if $r->uri() =~ m|^/plain|;
  DefaultType text/html
  http://www.masonhq.com/docs/manual/0.8/Admin.html#component_roots_multiple_
  <%once>
  use DBI;
  </%once>
  <%init>
  my $dbh = DBI->connect ( blah, blah );
  ...
  </%init>
  You can connect in the handler.pl - I find it convenient to setup a
  global $dbh in it.  You just need to make sure you connect inside
  the handler subroutine (using Apache::DBI of course).  This way a)
  each httpd gets it's own connection and b) each httpd reconnects if
  the database is recycled.
  # List of modules that you want to use from components (see Admin
  # manual for details)
  {
     package HTML::Mason::Commands;
     use Apache::DBI;
     # use'ing Apache::DBI here lets us connect from inside components
     # if we need to.
     # --
     # declare global variables, like $dbh, here as well.
   }
  # Configure database connection stuff
  my $datasource = "DBI:blah:blah";
  my $username = "user";
  my $password = "pass";
  my $attr = { RaiseError=>1 ,AutoCommit=>1 }; 
  Apache::DBI->connect_on_init($datasource, $username, $password, $attr);
  Apache::DBI->setPingTimeOut($datasource, 0);