---
name: "Dist::Zilla::App::Command::msg_scan"
section: "3pm"
platform: "linux"
package: "libdist-zilla-localetextdomain-perl"
version: "0.91-3"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/Dist::Zilla::App::Command::msg_scan"
---

# Dist::Zilla::App::Command::msg\_scan(3pm)

Scan localization strings into a translation template

## Name

Dist::Zilla::App::Command::msg\_scan - Scan localization strings into a translation template

## Synopsis

In *dist.ini*:

```
  [LocaleTextDomain]
  textdomain = My-App
  lang_dir = po
```

On the command line:

```
  dzil msg-scan
```

## Description

This command scans your distribution's Perl modules and creates or updates a GNU gettext \<http://www.gnu.org/software/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.

### Options

*"--xgettext"*

The location of the `"xgettext"` program, which is distributed with GNU gettext \<http://www.gnu.org/software/gettext/\>. Defaults to just `"xgettext"`, 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 write to. Defaults to `"$lang_dir/$textdomain.pot"`.

*"--copyright-holder"*

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

*"--bugs-email"*

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

## 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.