NAME¶

Locale::Po4a::Common - allgemeine Teile von Po4a-Skripten und -Werkzeugen

BESCHREIBUNG¶

Locale::Po4a::Common enthält allgemeine Teile der Po4a-Skripte und einige nützliche Funktionen, die von den anderen Modulen verwandt werden. Um Locale::Po4a programmatisch zu verwenden, sollte die Verwendung von Text::WrapI18N deaktiviert werden, indem z.B.

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

geschrieben wird, anstelle von

    use Locale::Po4a::Text;

Die Reihenfolge ist hier wichtig: da die meisten Locale::Po4a-Module selbst Locale::Po4a::Common laden, wird beim ersten Laden des Moduls entschieden, ob Text::WrapI18N verwandt wird.

FUNKTIONEN¶

Zeigt Ausgabenachrichten an¶

•

show_version($)

 

Zeigt die aktuelle Version des Skriptes und eine kurze Copyright-Nachricht an. Es erwartet den Namen des Skriptes als Argument.

•

wrap_msg($@)

 

Diese Funktion zeigt eine Nachricht genauso an, wie das sprintf() macht, fügt aber einen Zeilenumbruch hinzu, so dass sie auf einem Terminal gut aussieht.

•

wrap_mod($$@)

 

Diese Funktion funktioniert wie wrap_msg(), erwartet aber den Modulnamen als erstes Argument und lässt links der Nachricht noch ein Leerzeichen.

•

wrap_ref_mod($$$@)

 

Diese Funktion funktioniert wie wrap_msg(), erwartet aber eine file:line-Referenz als erstes Argument, einen Modulnamen als zweites und lässt links der Nachricht noch ein Leerzeichen.

Wrapper (Adpater) für andere Module¶

•

Locale::Gettext

 

Wenn das Modul Locale::Gettext nicht geladen werden kann, stellt dieses Modul eine Pseudo- (leere) Implementierung der im Folgenden aufgeführten Funktionen dar. In diesem Fall werden die Nachrichten nicht durch Po4a übersetzt, aber das Programm wird weiterhin funktionieren.

 

Falls Locale::gettext vorhanden ist, ruft dieser Adapter auch setlocale(LC_MESSAGES, "") auf, so dass Aufrufende nicht auch vom POSIX-Modul abhängen müssen.

AUTOREN¶

 Jordi Vilalta <jvprat@gmail.com>

URHEBERRECHT UND LIZENZ¶

Copyright 2005 SPI, Inc. Dieses Programm ist freie Software; Sie können es unter den Bedingungen der GPL (siehe die Datei COPYING) vertreiben und/oder verändern.