DocPerl::Config - Details on the configuration setting for the DocPerl application
This documentation refers to DocPerl::Config version 1.0.0.
DocPerl's configuration is stored in the file docperl.conf which is an ini style file which is broken into several sections.
This sets parameters of the local section, these files not found in the @INC path usually setup to be your local working POD files.
- A colon seperated list of directories to search for files
- A colon seperated list of directories to exclude from the search path.
- A regular expression to decide which files to include in the list. If not specified it will be created from the suffixes option.
- Specifies file suffixes that can be to search for specific files. To
specify more that one suffix repeat the suffixes option multiple tiems e.g.
suffixes: pm suffixes: pod suffixes: pl
The system wide perl modules section. IncFilders is similar to the LocalFolders execpt Path is added to the global @INC path. Also any module/file starting with pod:: is put into the Perl section on the list page.
Sets parameters to be sent to Template Toolkit.
- Sets the search path for templates.
- See Template Toolkit documentation.
This allows you to set general parameters that are passed to all templates.
This section sets up parameters that are used for running DocPerl.
- Specifies the location of the data directory where templates and the cache are stored.
- The location of ther perl executable (used when creating POD files).
- Allows you to turn off caching, which can be usefull you do not have
permissions to write to the disk.
'on' or not set Turns on the cache 'off' turns off caching
- Allows a user of the web interface to clear the cache (which is usefull when
new modules are installed and the list page is cached and becomes out of
'on' turns on this feature anything else turns this off
Note: You probably should not turn this on for publicly available sites as this could cause a lot of extra load on your server.
Here is a summary of the url parameters.
- This effectivly sets which template is to be used as well as what processing needs to be done. Some more important values are:
- Sets the perl module to be displaied. This can be represented in one of two forms: either standard perl form (Config::Std) or as a path from the list page (inc__c__Config__Std). In path from location does not need to be specified.
- The file on the file system.
- The section that the file is from (inc,local or perl).
- The relative perl file path (relative to search paths).
- Instructs DocPerl to clear it's cache (if allowed).
- Alters the link taget on the list page so that when the list page is used for a firefox sidebar it displays the pages in the correct place.