Locale::Po4a::RubyDocSection: Po4a Tools (3pm)
Index Return to Main Contents
NAMELocale::Po4a::RubyDoc -- Convert Ruby Document data from/to PO files
DESCRIPTIONThe 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.
STATUS OF THIS MODULEThis 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...
OPTIONS ACCEPTED BY THIS MODULEThis module supports the following option:
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).
AUTHORSFrancesco Poli <firstname.lastname@example.org>
COPYRIGHT AND LICENSE
Copyright (c) 2016-2017 by Francesco Poli <email@example.com>
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 (c) 2004 by MoonWolf <firstname.lastname@example.org> Copyright (c) 2011-2012 by Youhei SASAKI <email@example.com>
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 (c) 2005-2008 by Nicolas FRANÇOIS <firstname.lastname@example.org>
- STATUS OF THIS MODULE
- OPTIONS ACCEPTED BY THIS MODULE
- SEE ALSO
- COPYRIGHT AND LICENSE
This document was created by using the manual pages.
Time: 07:36:26 GMT, September 10, 2017