Name

       Dist::Zilla::App::Command::msg_merge - Merge localization strings into translation catalogs

Synopsis

       In dist.ini:

         [LocaleTextDomain]
         textdomain = My-App
         lang_dir = po

       On the command line:

         dzil msg-init fr de

       Later, after adding or modifying localizations strings:

         dzil msg-merge

Description

       This command merges localization strings into translation catalog files. The strings are merged from a
       GNU gettext <http://www.gnu.org/software/gettext/>-style language translation template, which can be
       created by the "msg-scan" command. If no template file is found or can be found, the Perl sources will be
       scanned to create a temporary one.

       This command relies on the settings from the "LocaleTextDomain" plugin for its settings, and requires
       that the GNU gettext utilities be available.

   Options
       "--xgettext"

       The location of the "xgettext" program, which is distributed with GNU gettext
       <http://www.gnu.org/software/gettext/>. Defaults to just "xgettext" (or "xgettext.exe" on Windows), which
       should work if it's in your path. Not used if "--pot-file" is specified.

       "--msgmerge"

       The location of the "msgmerge" program, which is distributed with GNU gettext
       <http://www.gnu.org/software/gettext/>. Defaults to just "msgmerge" (or "msgmerge.exe" on Windows), which
       should work if it's in your path.

       "--encoding"

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

       "--pot-file"

       The name of the template file to use to merge the message catalogs. If not specified,
       "$lang_dir/$textdomain.pot" will be used if it exists. Otherwise, a temporary template file will be
       created by scanning the Perl sources.

       "--copyright-holder"

       Name of the application copyright holder. Defaults to the copyright holder defined in dist.ini. Used only
       to generate a temporary template file.

       "--bugs-email"

       Email address to which translation bug reports should be sent. Defaults to the email address of the first
       distribution author, if available. Used only to generate a temporary template file.

       "--backup"

       Back up each language file before merging it. The backup files will have the suffix ~.

Author

       David E. Wheeler <david@justatheory.com>

Contributor

       Charles McGarvey <ccm@cpan.org>

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.