Dist::Zilla::App::Command::msg_scan - Scan localization strings into a translation template


In dist.ini:

  textdomain = My-App
  lang_dir = po

On the command line:

  dzil msg-scan


This command scans your distribution's Perl modules and creates or updates a GNU gettext-style language translation template. It relies on the settings from the LocaleTextDomain plugin for its settings, and requires that the GNU gettext utilities be available.



The location of the xgettext program, which is distributed with GNU gettext. Defaults to just xgettext, which should work if it's in your path.


The encoding to assume the Perl modules are encoded in. Defaults to UTF-8.


The name of the template file to write to. Defaults to $lang_dir/$textdomain.pot.

Name of the application copyright holder. Defaults to the copyright holder defined in dist.ini.


Email address to which translation bug reports should be sent. Defaults to the email address of the first distribution author, if available.


David E. Wheeler <>


Charles McGarvey <>

Copyright and License

This software is copyright (c) 2012-2017 by David E. Wheeler.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.