View on
MetaCPAN is shutting down
For details read Perl NOC. After June 25th this page will redirect to
Philip Crow > Bigtop > docs/keyword_cookbook/app_literal/Location/discussion


Annotate this POD


New  3
Open  1
View/Report Bugs


Location literals dump output into the app's root location in docs/httpd.conf files, which are used for mod_perl deployment. There is an analogous literal at the controller level.

While you can put anything in a Location literal, PerlSetVars are best handled in other ways*. This literal is really for things like

    require valid-user

*Either allow the HttpdConf Gantry backend to create PerlSetVars based on config block parameter/value pairs, or (better) use Gantry::Conf.


To see an example, build:

    bigtop -c example.bigtop all

Look for require valid-user in docs/httpd.conf. Also note the use of the PerlTop literal to add a use statement for Your::Authen::Handler to the Perl block.

See how the example so cleverly controls indentation so readers never have to know the output was generated?

syntax highlighting: