=head1 NAME

Log::Report::Translator::Gettext - the GNU gettext infrastructure

=head1 INHERITANCE

 Log::Report::Translator::Gettext
   is a Log::Report::Translator

=head1 SYNOPSIS

 # normal use (end-users view)

 use Log::Report 'my-domain'
   , translator => Log::Report::Translator::Gettext->new;

 print __"Hello World\n";  # language determined by environment

 # internal use

 my $msg = Log::Report::Message->new
   ( _msgid      => "Hello World\n"
   , _textdomain => 'my-domain'
   );

 print Log::Report::Translator::Gettext->new
     ->translate('nl-BE', $msg);

=head1 DESCRIPTION

UNTESTED!!!  PLEASE CONTRIBUTE!!!
Translate a message using the GNU gettext infrastructure.

Guido Flohr reports:
be aware that Locale::gettext is only a binding for the C library
libintl and depends on its features.  That means that your module will
effectively only run on GNU systems and maybe on Solaris (depending
on the exact version), because only these systems provide the plural
handling functions ngettext(), dngettext() and dcngettext().  Sooner or
later you will probably also need bind_textdomain_codeset() which is
also only available on certain systems.

=head1 METHODS

=head2 Constructors

Log::Report::Translator::Gettext-E<gt>B<new>(OPTIONS)

=over 4

See L<Log::Report::Translator/"Constructors">

=back

=head2 Accessors

$obj-E<gt>B<charset>

=over 4

See L<Log::Report::Translator/"Accessors">

=back

$obj-E<gt>B<lexicons>

=over 4

See L<Log::Report::Translator/"Accessors">

=back

=head2 Translating

$obj-E<gt>B<load>(DOMAIN, LOCALE)

=over 4

See L<Log::Report::Translator/"Translating">

=back

$obj-E<gt>B<translate>(MESSAGE)

=over 4

See L<Log::Report::Translator/"Translating">

=back

=head1 SEE ALSO

This module is part of Log-Report distribution version 0.23,
built on April 24, 2009. Website: F<http://perl.overmeer.net/log-report/>

=head1 LICENSE

Copyrights 2007-2009 by Mark Overmeer. For other contributors see ChangeLog.

This program is free software; you can redistribute it and/or modify it
under the same terms as Perl itself.
See F<http://www.perl.com/perl/misc/Artistic.html>

