.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" 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
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    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
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "LOCALE::PO4A::RUBYDOC.3PM 1"
.TH LOCALE::PO4A::RUBYDOC.3PM 1 2024-06-26 "perl v5.38.2" "User Contributed Perl Documentation"
.\" 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::RubyDoc \-\-Convierte datos de Ruby Document desde/a ficheros PO
.SH DESCRIPCIÓN
.IX Header "DESCRIPCIÓN"
El objetivo del proyecto po4a («PO for anything», PO para todo) es facilitar la traducción (y más interesante, el mantenimiento de las traducciones) usando las herramientas de gettext en ámbitos dónde no previstos, como la documentación.
.PP
Locale::Po4a::RubyDoc es un módulo que asiste en la traducción de documentación en formato Ruby Document (RD) (el lenguaje usado para documentar Ruby) a otros lenguajes [humanos].
.SH "ESTADO DE ESTE MODULO"
.IX Header "ESTADO DE ESTE MODULO"
Este módulo ha sido probado con éxito en archivos Ruby Document sencillos que cubren buena parte de la sintaxis del formato.
.PP
Una limitación conocida es que no reconoce correctamente la estructura apilada del Documento Ruby de entrada: esto implica que cuando, por ejemplo, un EnumListItem consta de más de un Bloque, solo el primer Bloque se reconoce realmente como EnumListItem, mientras que los siguientes se consideran simplemente como TextBlocks...
.SH "OPCIONES ACEPTADAS POR ESTE MODULO"
.IX Header "OPCIONES ACEPTADAS POR ESTE MODULO"
Este módulo es compatible con la siguiente opción:
.IP \fBpuredoc\fR 4
.IX Item "puredoc"
Maneja archivos formados íntegramente por texto con formato Ruby Document (sin ninguna línea "=begin").
.Sp
Por defecto, este módulo sólo maneja el texto con formato Ruby Document entre las líneas "=begin" y "=end" (por lo que ignora, entre otras cosas, todo lo que precede a la primera línea "=begin").
.SH "VÉASE TAMBIÉN"
.IX Header "VÉASE TAMBIÉN"
\&\fBLocale::Po4a::TransTractor\fR\|(3pm)
.SH AUTORES
.IX Header "AUTORES"
Francesco Poli <invernomuto@paranoici.org>
.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"
.Vb 1
\& Copyright © 2016\-2017 Francesco Poli <invernomuto@paranoici.org>
.Ve
.PP
Este trabajo es software libre; puede redistribuirlo y/o modificarlo bajo los términos de la Licencia Pública General GNU publicada por la Free Software Foundation; ya sea la versión 2 de la Licencia, o (a su elección) cualquier versión posterior.
.PP
Este trabajo se distribuye con la esperanza de que sea útil, pero SIN NINGUNA GARANTÍA; ni siquiera la garantía implícita de COMERCIABILIDAD o IDONEIDAD PARA UN PROPÓSITO PARTICULAR. Consulte la Licencia Pública General GNU para más detalles.
.PP
Debería haber recibido una copia de la Licencia Pública General GNU junto con esta obra; si no es así, escriba a la Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110\-1301 EE.UU.
.PP
Partes del código (como muchas expresiones regulares) fueron adaptadas del código fuente de rdtool, bajo los términos de la Licencia Pública General GNU, versión 2 o posterior. Estas partes son originalmente:
.PP
.Vb 2
\& Copyright © 2004      MoonWolf <moonwolf@moonwolf.com>
\& Copyright © 2011\-2012 Youhei SASAKI <uwabami@gfd\-dennou.org>
.Ve
.PP
El código de inicialización fue adaptado del código fuente de Locale::Po4a::Text, bajo los términos de la Licencia Pública General GNU, versión 2 o posterior. Este código era originalmente:
.PP
.Vb 1
\& Copyright © 2005\-2008 Nicolas FRANÇOIS <nicolas.francois@centraliens.net>
.Ve