.\" Automatically generated by Pod::Man 4.07 (Pod::Simple 3.32)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.if !\nF .nr F 0
.if \nF>0 \{\
.    de IX
.    tm Index:\\$1\t\\n%\t"\\$2"
..
.    if !\nF==2 \{\
.        nr % 0
.        nr F 2
.    \}
.\}
.\" ========================================================================
.\"
.IX Title "Locale::Po4a::Common 3pm"
.TH Locale::Po4a::Common 3pm "2018-12-17" "Herramientas de po4a" "Herramientas de po4a"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NOMBRE"
.IX Header "NOMBRE"
Locale::Po4a::Common \- Partes comunes de los scripts de po4a y herramientas
.SH "DESCRIPCIÓN"
.IX Header "DESCRIPCIÓN"
Locale::Po4a::Common contiene partes comunes a los scripts de po4a y algunas
funciones útiles usadas por los otros módulos.
.PP
Para poder usar Locale::Po4a programáticamente, puede que desee desactivar
el uso de Text::WrapI18N introduciendo, por ejemplo:
.PP
.Vb 2
\&    use Locale::Po4a::Common qw(nowrapi18n);
\&    use Locale::Po4a::Text;
.Ve
.PP
en lugar de:
.PP
.Vb 1
\&    use Locale::Po4a::Text;
.Ve
.PP
El orden aquí es importante: ya que la mayoría de los módulos Locale::Po4a
cargan también Locale::Po4a::Common. La primera vez se carga el módulo
determina si se usa Text::WrapI18N.
.SH "FUNCIONES"
.IX Header "FUNCIONES"
.SS "Muestra mensajes de salida"
.IX Subsection "Muestra mensajes de salida"
.IP "\(bu" 4
show_version($)
.Sp
Muestra la versión actual del script, y un breve mensaje de derechos de
autor. Toma el nombre del script como argumento.
.IP "\(bu" 4
wrap_msg($@)
.Sp
Esta función muestra un mensaje de la misma manera que lo hace \fIsprintf()\fR,
pero justifica el resultado para que se vea bien en la terminal.
.IP "\(bu" 4
wrap_mod($$@)
.Sp
Esta función funciona como \fIwrap_msg()\fR, pero toma un nombre de módulo como
primer argumento, y deja un espacio a la izquierda del mensaje.
.IP "\(bu" 4
wrap_ref_mod($$$@)
.Sp
Esta función funciona como \fIwrap_msg()\fR, pero toma una referencia
fichero:línea como primer argumento, un nombre de módulo como segundo, y
deja un espacio a la izquierda del mensaje.
.SS "Patrones de diseño («wrappers») para otros módulos"
.IX Subsection "Patrones de diseño («wrappers») para otros módulos"
.IP "\(bu" 4
Locale::Gettext
.Sp
Este módulo proporciona una integración vacía («dummy») de las siguientes
funciones en caso de que no se pueda cargar el módulo Locale::Gettext. De
ser así, los mensajes de po4a no se traducirán pero el programa seguirá
funcionando.
.Sp
Si Locale::gettext está presente, este «wrapper» también invoca setlocale
(\s-1LC_MESSAGES, ""\s0), para que aquello que lo invoca tampoco dependa del módulo
de \s-1POSIX.\s0
.RS 4
.IP "\(bu" 4
bindtextdomain($$)
.IP "\(bu" 4
textdomain($)
.IP "\(bu" 4
gettext($)
.IP "\(bu" 4
dgettext($$)
.RE
.RS 4
.RE
.SH "AUTORES"
.IX Header "AUTORES"
.Vb 1
\& Jordi Vilalta <jvprat@gmail.com>
.Ve
.SH "TRADUCCION"
.IX Header "TRADUCCION"
.Vb 2
\& Jordi Vilalta <jvprat@gmail.com>
\& Omar Campagne <ocampagne@gmail.com>
.Ve
.SH "DERECHO DE COPIA Y LICENCIA"
.IX Header "DERECHO DE COPIA Y LICENCIA"
Copyright © 2005 \s-1SPI,\s0 Inc.
.PP
Esto es software libre; puede redistribuirlo y/o modificarlo bajo las
condiciones de la licencia \s-1GPL \s0(consulte el fichero \s-1COPYING\s0).