NAZWA

       Locale::Po4a::Common - wspólne części narzędzi i użytków po4a

OPIS

       Locale::Po4a::Common zawiera części wspólne wszystkich skryptów po4a i kilka użytecznych
       funkcji używanych przez inne moduły.

       Aby używać Po4a we własnych programach, najprawdopodobniej należy wyłączyć moduł
       Text::WrapI18N, na przykład pisząc coś w stylu:

           use Locale::Po4a::Common qw(nowrapi18n);
           use Locale::Po4a::Text;

       zamiast:

           use Locale::Po4a::Text;

       Kolejność ma znaczenie: większość modułów Locale::Po4a samodzielnie ładuje
       Locale::Po4a::Common, który przy swoim pierwszym załadowaniu określa, czy używać
       Text::WrapI18N.

FUNKCJE

   Pokazywanie komunikatów wyjściowych
       •   show_version($)

           Wyświetla bieżącą wersję skryptu i krótką informację o prawach autorskich. Pobiera
           nazwę skryptu jako argument.

       •   wrap_msg($@)

           Ta funkcja wyświetla wiadomość w ten sam sposób, co sprnitf(), jednakże zawija ją tak,
           żeby ładnie wyglądała na terminalu.

       •   wrap_mod($$@)

           Funkcja działa tak jak wrap_msg(), ale jako pierwszy argument pobiera nazwę modułu i
           pozostawia spację z lewej strony komunikatu.

       •   wrap_ref_mod($$$@)

           Funkcja działa tak jak wrap_msg(), ale jako pierwszy argument pobiera odnośnik
           plik:linia, jako drugi - nazwę modułu i pozostawia spację z lewej strony komunikatu.

   Moduły opakowujące ("wrappers") inne moduły
       •   Locale::Gettext

           Jeżeli moduł Locale::Gettext nie może zostać załadowany, to ten moduł udostępnia
           fałszywe (puste) implementacje następujących funkcji. Dziki temu program będzie
           działać, chociaż wiadomości po4a nie będą przetłumaczone.

           Jeżeli Locale::gettext jest obecny ten moduł opakowujący wywoła także
           setlocale(LC_MESSAGES, ""), tak żeby funkcje korzystające z modułu nie musiały zależeć
           od modułu POSIX.

           •   bindtextdomain($$)

           •   textdomain($)

           •   gettext($)

           •   dgettext($$)

AUTORZY

        Jordi Vilalta <jvprat@gmail.com>

TŁUMACZENIE

        Robert Luberda <robert@debian.org>

PRAWA AUTORSKIE I LICENCJA

       Copyright © 2005 SPI, Inc.

       Program jest wolnym oprogramowaniem; można go redystrybuować i/lub modyfikować zgodnie z
       warunkami licencji GPL (patrz plik COPYING).