.\" -*- 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 NOME
.IX Header "NOME"
Locale::Po4a::RubyDoc \- Xonverte dados de Ruby Document de/para arquivos PO
.SH DESCRIÇÃO
.IX Header "DESCRIÇÃO"
O objetivo do projeto po4a (PO for anything, ou PO para qualquer coisa) é facilitar traduções (e o mais interessante, a manutenção das traduções) usando as ferramentas do gettext em áreas em que não se esperava, como documentação.
.PP
Locale::Po4a::RubyDoc é um módulo para ajudar a tradução de documentação no formato Ruby Document (Rad) (a linguagem usada para documentar Ruby) para outros idiomas.
.SH "ESTADO DESTE MÓDULO"
.IX Header "ESTADO DESTE MÓDULO"
Este módulo foi testado com sucesso em arquivos de Ruby Document simples cobrindo uma boa parte da sintaxe do formato.
.PP
Uma limitação conhecida é que ele falha em reconhecer adequadamente a estrutura empilhada do Documento Ruby de entrada: isso implica que quando, por exemplo, um EnumListItem consiste em mais de um Bloco, apenas o primeiro Bloco é realmente reconhecido como EnumListItem, enquanto os subsequentes são considerados apenas como TextBlocks...
.SH "OPÇÕES ACEITAS POR ESTE MÓDULO"
.IX Header "OPÇÕES ACEITAS POR ESTE MÓDULO"
Este módulo tem suporte à seguinte opção:
.IP \fBpuredoc\fR 4
.IX Item "puredoc"
Manipula arquivos inteiramente feitos de texto formatado de Ruby Document (sem nenhuma linha "=begin").
.Sp
Por padrão, este módulo manipula apenas texto formatado de Ruby Document entre as linhas "=begin" e "=end" (portanto, ignorando, entre outras coisas, tudo o que precede a primeira linha "=begin").
.SH "VEJA TAMBÉM"
.IX Header "VEJA TAMBÉM"
\&\fBLocale::Po4a::TransTractor\fR\|(3pm)
.SH AUTORES
.IX Header "AUTORES"
Francesco Poli <invernomuto@paranoici.org>
.SH "COPYRIGHT E LICENÇA"
.IX Header "COPYRIGHT E LICENÇA"
.Vb 1
\& Copyright © 2016\-2017 Francesco Poli <invernomuto@paranoici.org>
.Ve
.PP
Est obra é um software livre; você pode redistribuí\-la e/ou modificá\-la sob os termos da Licença Pública Geral GNU conforme publicada pela Free Software Foundation; tanto a versão 2 da Licença, ou (por sua opção) qualquer versão posterior.
.PP
Esta obra é distribuída na esperança de que seja útil, mas SEM NENHUMA GARANTIA; sem mesmo a garantia implícita de COMERCIALIZAÇÃO ou ADEQUAÇÃO A UM DETERMINADO FIM. Veja a Licença Pública Geral GNU para mais detalhes.
.PP
Você deve ter recebido uma cópia da Licença Pública Geral GNU junto com este trabalho; se não, escreva para Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110\-1301 USA.
.PP
Partes do código (como muitas expressões regulares) foram adaptadas do código\-fonte do rdtool, sob os termos da Licença Pública Geral GNU, versão 2 ou posterior. Essas partes são originalmente:
.PP
.Vb 2
\& Copyright © 2004      MoonWolf <moonwolf@moonwolf.com>
\& Copyright © 2011\-2012 Youhei SASAKI <uwabami@gfd\-dennou.org>
.Ve
.PP
O código de inicialização foi adaptado do código\-fonte de Locale::Po4a::Text, nos termos da Licença Pública Geral GNU, versão 2 ou posterior. Este código era originalmente:
.PP
.Vb 1
\& Copyright © 2005\-2008 Nicolas FRANÇOIS <nicolas.francois@centraliens.net>
.Ve