Locale::Po4a::RubyDoc -- Convert Ruby Document data from/to PO files

       Francesco Poli <invernomuto@paranoici.org>

        Copyright © 2016-2017 Francesco Poli <invernomuto@paranoici.org>

       This work is free software; you can redistribute it and/or modify it under the terms of the  GNU  General
       Public License as published by the Free Software Foundation; either version 2 of the License, or (at your
       option) any later version.

       This  work  is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the
       implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.   See  the  GNU  General  Public
       License for more details.

       You  should have received a copy of the GNU General Public License along with this work; if not, write to
       the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.

       Parts of the code (such as many regular expressions) were adapted from the source of  rdtool,  under  the
       terms of the GNU General Public License, version 2 or later.  These parts are originally:

        Copyright © 2004      MoonWolf <moonwolf@moonwolf.com>
        Copyright © 2011-2012 Youhei SASAKI <uwabami@gfd-dennou.org>

       The initialize code was adapted from the source of Locale::Po4a::Text, under the terms of the GNU General
       Public License, version 2 or later.  This code was originally:

        Copyright © 2005-2008 Nicolas FRANÇOIS <nicolas.francois@centraliens.net>

perl v5.38.2                                       2024-08-28                       LOCALE::PO4A::RUBYDOC.3PM(1)

       The po4a (PO for anything) project goal is to ease translations (and more interestingly, the maintenance
       of translations) using gettext tools on areas where they were not expected like documentation.

       Locale::Po4a::RubyDoc is a module to help the translation of documentation in the Ruby Document (RD)
       format (a language used to document Ruby) into other [human] languages.

       Locale::Po4a::RubyDoc -- Convert Ruby Document data from/to PO files

       This module supports the following option:

       puredoc
           Handle files entirely made of Ruby Document formatted text (without any "=begin" line).

           By  default,  this module only handles Ruby Document formatted text between "=begin" and "=end" lines
           (hence ignoring, among other things, everything that precedes the first "=begin" line).

Locale::Po4a::TransTractor(3pm)

       This module has been successfully tested on simple Ruby Document files covering a good part of the format
       syntax.

       A known limitation is that it fails to properly recognize the stacked structure of input Ruby Document:
       this implies that when, for instance, an EnumListItem consists of more than one Block, only the first
       Block is actually recognized as EnumListItem, while the subsequent ones are considered just as
       TextBlocks...