NAME

Log::Report::Minimal::Domain - administer one text-domain

SYNOPSIS

use Log::Report::Minimal::Domain;
my $domain = Log::Report::Minimal::Domain->new(name => $name);
# normal usage
use Log::Report::Optional;       # or Log::Report itself
my $domain = textdomain $name;   # find config
textdomain $name, %configure;    # set config, only once.

DESCRIPTION

Read Log::Report::Domain.

METHODS

Constructors

$class->new(%options)

-Option--Default
 name    <required>

name => STRING: The name of the textdomain is used in its invocation, but also as (part of) the translation file names, hence please keep it simple and short.

example: textdomain name choice

A good choice is to use Perl's distribution name for the domain name. For instance, the domain name for this module would be set this way:

use Log::Report 'log-report-optional';
use Log::Report 'log-report-opt';

Attributes

$obj->configure(%options)

-Option--Default
 where   <required>

where => ARRAY: Specifies the location of the configuration. It is not allowed to configure a domain on more than one location.

$obj->isConfigured()
$obj->name()

Translating

$obj->interpolate( $msgid, [$args] ): Interpolate the keys used in $msgid from the values in $args. This is handled by the formatter, by default a String::Print instance.

DIAGNOSTICS

Error: illegal formatter `$name' at $fn line $line: Cast by configure()

LICENSE

For contributors see file ChangeLog.

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

2025-12-12

perl v5.42.0