Log::Report::Minimal::Domain(3pm)

Log::Report::Minimal::Domain3pm

Administer one text-domain

Usage

  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.

Overview

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()

Releases

7 releases since Debian 8 (Jessie); the text changed 5 times.

  1. 8
  2. 9
  3. 10
  4. 11
  5. 12–13
  6. Arch

License

For contributors see file ChangeLog.

This software is copyright (c) 2013-2025 by Mark Overmeer.

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

From perl-log-report-optional 1.08-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.