Locale::Po4a::Common(3) 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

  • show_version($)

    Affiche la version courante du script, et un court message de copyright. Il prend le nom du script comme paramètre.

  • wrap_msg($@)

    Cette fonction affiche un message de la même façon que sprintf(), mais met en plus le résultat en forme de telle sorte qu'il soit bien mis en forme sur un terminal.

  • 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 une espace à gauche du message.

  • 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 une espace à gauche du message.

Encapsulateur pour d'autres modules

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 à 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.

  • bindtextdomain($$)
  • textdomain($)
  • gettext($)
  • dgettext($$)

AUTEURS

 Jordi Vilalta <[email protected]>

TRADUCTION

 Martin Quinson (mquinson#debian.org)

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