NOM
Locale::Po4a::Common - utilitaires et parties communes des scripts po4a
DESCRIPTION
Locale::Po4a::Common comprend les parties communes des scripts po4a et
quelques fonctions utiles pour certains modules.
Pour utiliser Locale::Po4a dans un programme, on peut désactiver
l'utilisation de Text::WrapI18N, en utilisant par exemple :
use Locale::Po4a::Common qw(nowrapi18n);
use Locale::Po4a::Text;
au lieu de:
use Locale::Po4a::Text;
L'ordre est important ici puisque la plupart des modules Locale::Po4a
chargent eux-même Locale::Po4a::Common et que la première fois que ce
module est chargé détermine si Text::WrapI18N est utilisé.
FONCTIONS
Affichage de messages
o show_version($)
Affiche la version courante du script et un court message de
copyright. Il prend le nom du script comme paramètre.
o wrap_msg($@)
Cette fonction affiche un message de la même façon que sprintf(),
mais met de plus le résultat en forme, de telle sorte qu'il soit
bien mis en forme sur un terminal.
o wrap_mod($$@)
Cette fonction fonctionne de la même façon que wrap_msg() mais elle
prend le nom d'un module comme premier paramètre, et ajoute un
espace à la gauche du message.
o wrap_ref_mod($$$@)
Cette fonction fonctionne comme wrap_msg(), mais elle prend une
référence de la forme fichier:ligne comme premier paramètre, un nom
de module comme second paramètre et ajoute un espace à la gauche du
message.
Encapsulateur pour d'autres modules
o Locale::Gettext
Quand le module Locale::Gettext ne peut pas être chargé, ce module
fournit une fausse implémentation (vide) pour les fonctions
suivantes. Dans ce cas, les messages ne seront pas traduits, mais
le programme continuera de fonctionner.
Si Locale::gettext est présent, cette encapsulation appellera
setlocale(LC_MESSAGES, "") de telle sorte que les appelants ne
dépendent pas non plus du module POSIX.
o bindtextdomain($$)
o textdomain($)
o gettext($)
o dgettext($$)
AUTEURS
Jordi Vilalta <jvprat@gmail.com>
COPYRIGHT ET LICENCE
Copyright 2005 par SPI, inc.
Ce programme est un logiciel libre ; vous pouvez le copier et / ou le
modifier sous les termes de la GPL (voir le fichier COPYING).