podweaver - Run Pod::Weaver on a file or distribution.
version 1.00
podweaver [options]
Options: -v, --verbose increase verbosity --new write to *.new files rather than overwriting existing --no_backup skip generating *.bak files when editing files --antispam=str replace @ in author emails with 'str'. --help brief help message --man full documentation --version display version information and exit
Write the modified version of a file to a new file based on the original filename with a .new extension, rather than the default behaviour of overwriting the original.
.new
When --new is supplied, no *.bak backup of the original is created (since the original is left untouched.)
Skips the production of *.bak backups for any changed files. Be warned, this could result in loss of the file contents if anything goes wrong, use with caution. (Or better still, use with your changes safely commited to the VCS of your choice.)
Replaces the @ in author email addresses with the supplied string as an anti-spam measure. Given that the original email is still within the META.yml, this will not prevent all spam harvesting, but it may at least help.
Increases the level of messages displayed.
Print a brief help message and exits.
Prints the manual page and exits.
Prints version information and the location of the config file and exits.
podweaver will run Pod::Weaver across all files in a distribution, editing them in place and leaving a backup of the original in original.bak.
This was designed to run with the Pod::Weaver::PluginBundle::ReplaceBoilerplate plugin, so you can run podweaver as part of your release process to update the boilerplate and other automatically generated POD in your source files, rather than the default Pod::Weaver behaviour of appending.
To use podweaver it is suggested you place a weaver.ini file in the root of your distribution with contents similar to:
weaver.ini
[@ReplaceBoilerplate]
If no weaver.ini is provided then the default Pod::Weaver settings are used, which will continuously append duplicate sections each time you run podweaver.
podweaver expects to be run in the root of your distribution, and will look for a META.json or META.yml file to extract details such as the author, licence and version. If no META file is found then it will issue a warning, but still run, which may result in some sections being missing from the final POD, it is recommended that you run podweaver again after you've generated your META file.
Currently podweaver looks in the lib, bin and script dirs for modules or scripts that should be woven. This should probably be configurable.
lib
bin
script
Please see the documentation in App::podweaver for bugs and issues.
If you find yourself using the same command-line options repeatedly you can set them as defaults in an application configuration file.
This file is located in $HOME/.app_podweaver/podweaver.ini for UNIX-based operating systems, and ~/Local Settings/Application Data/App-podweaver/podweaver.ini under Windows.
$HOME/.app_podweaver/podweaver.ini
~/Local Settings/Application Data/App-podweaver/podweaver.ini
You can find the exact location of your configuration file using the --version option.
The configuration file follows Config::Tiny style .ini format and consists of command-line option names for keys, for example:
antispam = BLAHBLAH no_backup = 1 verbose = 2
This would be as if you provided --antispam=BLAHBLAH --no_baackup -vv on the command-line.
--antispam=BLAHBLAH --no_baackup -vv
Any options supplied on the command-line will override those supplied within the configuration file.
Pod::Weaver, App::podweaver.
Sam Graham <libapp-podweaver-perl BLAHBLAH illusori.co.uk>
This software is copyright (c) 2010-2011 by Sam Graham <libapp-podweaver-perl BLAHBLAH illusori.co.uk>.
This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.
To install App::podweaver, copy and paste the appropriate command in to your terminal.
cpanm
cpanm App::podweaver
CPAN shell
perl -MCPAN -e shell install App::podweaver
For more information on module installation, please visit the detailed CPAN module installation guide.