Peter Lavender > Padre-0.96 > Padre::Locale::T

Download:
Padre-0.96.tar.gz

Dependencies

Annotate this POD

Website

View/Report Bugs
Module Version: 0.96   Source   Latest Release: Padre-1.00

NAME ^

Padre::Locale::T - Provides _T for declaring translatable strings

SYNOPSIS ^

  use Padre::Locale::T;
  
  my $string = _T('This is a test');

DESCRIPTION ^

Padre uses a function called _T to declare strings which should be translated by the translation team, but which should not be immediately localised in memory.

This is done primarily because the active language may change between when a string is initially stored in memory and when it is show to a user.

The reason we use _T is that most translation tools in the wild that scan the code for a program detect the use of a C macro calls _T that does immediate translation.

By creating a null pass through function called _T and the linguistic similarity of Perl to C, we can take advantage of the way translation tools detect translatable strings while keeping the proper Wx::gettext function for strings which do need to be translated immediately.

The _T function used to live in Padre::Util, but as that module gradually bloated it was increasing the code of getting the _T function dramatically.

Padre::Locale::T declares only this one function, and will only ever do so.

Because of this, it also exports by default (although you are still welcome to declare the import if you wish.

FUNCTIONS ^

_T

The _T function is used for strings that you do not want to translate immediately, but you will be translating later (multiple times).

The only reason this function needs to exist at all is so that the translation tools can identify the string it refers to as something that needs to be translated.

Functionally, this function is just a direct pass-through with no effect.

COPYRIGHT ^

Copyright 2008-2012 The Padre development team as listed in Padre.pm.

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

The full text of the license can be found in the LICENSE file included with this module.

syntax highlighting: