summaryrefslogtreecommitdiffstats
path: root/po/pod/hu.po
diff options
context:
space:
mode:
authorDaniel Baumann <daniel.baumann@progress-linux.org>2024-06-17 11:26:17 +0000
committerDaniel Baumann <daniel.baumann@progress-linux.org>2024-06-17 11:26:17 +0000
commit5df6c2aefebe3d2abcc939a88e294876d59f03ca (patch)
tree63fb332a0f21ddb91cb789c80cf64e134d373463 /po/pod/hu.po
parentInitial commit. (diff)
downloadpo4a-5df6c2aefebe3d2abcc939a88e294876d59f03ca.tar.xz
po4a-5df6c2aefebe3d2abcc939a88e294876d59f03ca.zip
Adding upstream version 0.72.upstream/0.72
Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>
Diffstat (limited to 'po/pod/hu.po')
-rw-r--r--po/pod/hu.po10058
1 files changed, 10058 insertions, 0 deletions
diff --git a/po/pod/hu.po b/po/pod/hu.po
new file mode 100644
index 0000000..1427509
--- /dev/null
+++ b/po/pod/hu.po
@@ -0,0 +1,10058 @@
+# SOME DESCRIPTIVE TITLE
+# Copyright (C) YEAR Free Software Foundation, Inc.
+# This file is distributed under the same license as the po4a package.
+# Balázs Úr <balazs@urbalazs.hu>, 2020.
+msgid ""
+msgstr ""
+"Project-Id-Version: po4a 0.56\n"
+"Report-Msgid-Bugs-To: devel@lists.po4a.org\n"
+"POT-Creation-Date: 2024-05-26 00:33+0200\n"
+"PO-Revision-Date: 2020-05-05 23:11+0000\n"
+"Last-Translator: Balázs Úr <balazs@urbalazs.hu>\n"
+"Language-Team: Hungarian <https://hosted.weblate.org/projects/po4a/po4a-doc/"
+"hu/>\n"
+"Language: hu\n"
+"MIME-Version: 1.0\n"
+"Content-Type: text/plain; charset=UTF-8\n"
+"Content-Transfer-Encoding: 8bit\n"
+"Plural-Forms: nplurals=2; plural=n != 1;\n"
+"X-Generator: Weblate 4.1-dev\n"
+
+#. type: Attribute 'xml:lang' of: <refentry>
+#: share/doc/po4a-display-man.xml:1 share/doc/po4a-display-pod.xml:1
+msgid "en"
+msgstr "hu"
+
+#. type: Content of: <refentry><refentryinfo>
+#: share/doc/po4a-display-man.xml:2
+msgid "<date>2006-04-08</date>"
+msgstr "<date>2006-04-08</date>"
+
+#. type: Content of: <refentry><refmeta><refentrytitle>
+#: share/doc/po4a-display-man.xml:3
+#, fuzzy
+#| msgid "PO4AMAN-DISPLAY-PO"
+msgid "PO4A-DISPLAY-MAN"
+msgstr "PO4AMAN-DISPLAY-PO"
+
+#. type: Content of: <refentry><refmeta><manvolnum>
+#: share/doc/po4a-display-man.xml:4 share/doc/po4a-display-pod.xml:4
+msgid "1"
+msgstr "1"
+
+#. type: Content of: <refentry><refmeta><refmiscinfo>
+#: share/doc/po4a-display-man.xml:5
+msgid "2020-04-19"
+msgstr "2020-04-19"
+
+#. type: Content of: <refentry><refmeta><refmiscinfo>
+#: share/doc/po4a-display-man.xml:6 share/doc/po4a-display-man.xml:7
+#: share/doc/po4a-display-pod.xml:6 share/doc/po4a-display-pod.xml:7
+msgid "Po4a Tools"
+msgstr "Po4a eszközök"
+
+#. type: Content of: <refentry><refnamediv><refname>
+#: share/doc/po4a-display-man.xml:8
+#, fuzzy
+#| msgid "po4aman-display-po"
+msgid "po4a-display-man"
+msgstr "po4aman-display-po"
+
+#. type: Content of: <refentry><refnamediv><refpurpose>
+#: share/doc/po4a-display-man.xml:9
+msgid "display a translated man page according to a PO"
+msgstr "lefordított kézikönyvoldal megjelenítése egy PO fájl alapján"
+
+#. type: Content of: <refentry><refsynopsisdiv><cmdsynopsis>
+#: share/doc/po4a-display-man.xml:10
+#, fuzzy
+#| msgid ""
+#| "<command>po4aman-display-po</command> <arg choice='plain'><option>-p</"
+#| "option> </arg> <arg choice='plain'><replaceable>PO_FILE</replaceable></"
+#| "arg> <arg choice='opt'><arg choice='plain'><option>-m</option> </arg><arg "
+#| "choice='plain'><replaceable>MASTER_FILE</replaceable></arg></arg> <arg "
+#| "choice='opt'><arg choice='plain'><option>-o</option> </arg><arg "
+#| "choice='plain'><replaceable>PO4A_OPT</replaceable></arg></arg>"
+msgid ""
+"<command>po4a-display-man</command> <arg choice='plain'><option>-p</option> "
+"</arg> <arg choice='plain'><replaceable>PO_FILE</replaceable></arg> <arg "
+"choice='opt'><arg choice='plain'><option>-m</option> </arg><arg "
+"choice='plain'><replaceable>MASTER_FILE</replaceable></arg></arg> <arg "
+"choice='opt'><arg choice='plain'><option>-o</option> </arg><arg "
+"choice='plain'><replaceable>PO4A_OPT</replaceable></arg></arg>"
+msgstr ""
+"<command>po4aman-display-po</command> <arg choice='plain'><option>-p</"
+"option> </arg> <arg choice='plain'><replaceable>PO_FÁJL</replaceable></arg> "
+"<arg choice='opt'><arg choice='plain'><option>-m</option> </arg><arg "
+"choice='plain'><replaceable>MESTERFÁJL</replaceable></arg></arg> <arg "
+"choice='opt'><arg choice='plain'><option>-o</option> </arg><arg "
+"choice='plain'><replaceable>PO4A_KAPCSOLÓ</replaceable></arg></arg>"
+
+#. type: =head1
+#: share/doc/po4a-display-man.xml:11 share/doc/po4a-display-pod.xml:11 po4a:5
+#: po4a-gettextize:6 po4a-normalize:5 po4a-translate:6 po4a-updatepo:6
+#: msguntypot:5 lib/Locale/Po4a/AsciiDoc.pm:3 lib/Locale/Po4a/BibTeX.pm:3
+#: lib/Locale/Po4a/Chooser.pm:3 lib/Locale/Po4a/Common.pm:3
+#: lib/Locale/Po4a/Dia.pm:3 lib/Locale/Po4a/Docbook.pm:3
+#: lib/Locale/Po4a/Guide.pm:3 lib/Locale/Po4a/Halibut.pm:3
+#: lib/Locale/Po4a/Ini.pm:3 lib/Locale/Po4a/KernelHelp.pm:3
+#: lib/Locale/Po4a/LaTeX.pm:3 lib/Locale/Po4a/Man.pm:3 lib/Locale/Po4a/Po.pm:9
+#: lib/Locale/Po4a/Pod.pm:7 lib/Locale/Po4a/RubyDoc.pm:3
+#: lib/Locale/Po4a/Sgml.pm:3 lib/Locale/Po4a/TeX.pm:3
+#: lib/Locale/Po4a/Texinfo.pm:3 lib/Locale/Po4a/Text.pm:3
+#: lib/Locale/Po4a/TransTractor.pm:3 lib/Locale/Po4a/Wml.pm:3
+#: lib/Locale/Po4a/Xhtml.pm:3 lib/Locale/Po4a/Xml.pm:3
+#: lib/Locale/Po4a/Yaml.pm:3
+msgid "DESCRIPTION"
+msgstr "LEÍRÁS"
+
+#. type: Content of: <refentry><refsect1><para>
+#: share/doc/po4a-display-man.xml:12
+msgid ""
+"Translators can use <command>po4a-display-man</command> to see how their "
+"translation of a man page will be rendered to the end users, without "
+"recompiling and reinstalling the whole project."
+msgstr ""
+
+#. type: Content of: <refentry><refsect1><para>
+#: share/doc/po4a-display-man.xml:13
+msgid ""
+"This script only works with man pages written directly in <emphasis "
+"remap='I'>nroff</emphasis> and handled by the po4a's <emphasis "
+"remap='I'>man</emphasis> module. Manual pages generated from other formats, "
+"like DocBook or POD, are not supported. See "
+"<citerefentry><refentrytitle>po4a-display-pod</refentrytitle><manvolnum>1</"
+"manvolnum></citerefentry> for an equivalent supporting <emphasis "
+"remap='I'>POD</emphasis> documents."
+msgstr ""
+
+#. type: =head1
+#: share/doc/po4a-display-man.xml:14 share/doc/po4a-display-pod.xml:13 po4a:28
+#: po4a-gettextize:11 po4a-normalize:9 po4a-translate:9 po4a-updatepo:11
+msgid "OPTIONS"
+msgstr ""
+
+#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
+#: share/doc/po4a-display-man.xml:15 share/doc/po4a-display-pod.xml:14
+msgid "<option>-p </option><replaceable>PO_FILE</replaceable>"
+msgstr ""
+
+#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
+#: share/doc/po4a-display-man.xml:16 share/doc/po4a-display-pod.xml:15
+msgid "The PO file containing the translations."
+msgstr ""
+
+#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
+#: share/doc/po4a-display-man.xml:17
+msgid "<option>-m </option><replaceable>MASTER_FILE</replaceable>"
+msgstr ""
+
+#. .br
+#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
+#: share/doc/po4a-display-man.xml:18
+msgid ""
+"The original man page. It can be the absolute or relative path to the "
+"original man page (gzipped or not), the name of the man page or the name and "
+"section of the man page (using the man.section format). When the master "
+"document is not provided with the <option>-m</option> option, <command>po4a-"
+"display-man</command> tries to find the original man page based on the line "
+"reference of the first string in the PO."
+msgstr ""
+
+#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
+#: share/doc/po4a-display-man.xml:19 share/doc/po4a-display-pod.xml:18
+msgid "<option>-o </option><replaceable>PO4A_OPT</replaceable>"
+msgstr ""
+
+#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
+#: share/doc/po4a-display-man.xml:20 share/doc/po4a-display-pod.xml:19
+msgid ""
+"Some options to pass to <citerefentry><refentrytitle>po4a-translate</"
+"refentrytitle><manvolnum>1</manvolnum></citerefentry>."
+msgstr ""
+
+#. type: =head1
+#: share/doc/po4a-display-man.xml:21 share/doc/po4a-display-pod.xml:20 po4a:189
+#: po4a-gettextize:76 po4a-normalize:36 po4a-translate:50 po4a-updatepo:53
+#: msguntypot:29 doc/po4a.7.pod:190 lib/Locale/Po4a/Chooser.pm:7
+#: lib/Locale/Po4a/Dia.pm:12 lib/Locale/Po4a/Docbook.pm:15
+#: lib/Locale/Po4a/Guide.pm:10 lib/Locale/Po4a/Halibut.pm:14
+#: lib/Locale/Po4a/Ini.pm:8 lib/Locale/Po4a/KernelHelp.pm:7
+#: lib/Locale/Po4a/LaTeX.pm:8 lib/Locale/Po4a/Man.pm:107
+#: lib/Locale/Po4a/Pod.pm:21 lib/Locale/Po4a/RubyDoc.pm:14
+#: lib/Locale/Po4a/TeX.pm:118 lib/Locale/Po4a/Texinfo.pm:14
+#: lib/Locale/Po4a/Xhtml.pm:15 lib/Locale/Po4a/Xml.pm:187
+#: lib/Locale/Po4a/Yaml.pm:15
+msgid "SEE ALSO"
+msgstr ""
+
+#. type: Content of: <refentry><refsect1><para>
+#: share/doc/po4a-display-man.xml:22
+msgid ""
+"<citerefentry> <refentrytitle>po4a-display-pod</refentrytitle><manvolnum>1</"
+"manvolnum> </citerefentry>"
+msgstr ""
+
+#. type: Content of: <refentry><refsect1><title>
+#: share/doc/po4a-display-man.xml:23 share/doc/po4a-display-pod.xml:22
+msgid "AUTHOR"
+msgstr ""
+
+#. type: Content of: <refentry><refsect1><para>
+#: share/doc/po4a-display-man.xml:24
+msgid "Thomas Huriaux"
+msgstr ""
+
+#. type: Content of: <refentry><refentryinfo>
+#: share/doc/po4a-display-pod.xml:2
+msgid "<date>2009-03-16</date>"
+msgstr ""
+
+#. type: Content of: <refentry><refmeta><refentrytitle>
+#: share/doc/po4a-display-pod.xml:3
+#, fuzzy
+#| msgid "PO4AMAN-DISPLAY-PO"
+msgid "PO4A-DISPLAY-POD"
+msgstr "PO4AMAN-DISPLAY-PO"
+
+#. type: Content of: <refentry><refmeta><refmiscinfo>
+#: share/doc/po4a-display-pod.xml:5
+msgid "2009-03-16"
+msgstr ""
+
+#. type: Content of: <refentry><refnamediv><refname>
+#: share/doc/po4a-display-pod.xml:8
+#, fuzzy
+#| msgid "po4aman-display-po"
+msgid "po4a-display-pod"
+msgstr "po4aman-display-po"
+
+#. type: Content of: <refentry><refnamediv><refpurpose>
+#: share/doc/po4a-display-pod.xml:9
+#, fuzzy
+#| msgid "display a translated man page according to a PO"
+msgid "display of a translated POD file according to a PO"
+msgstr "lefordított kézikönyvoldal megjelenítése egy PO fájl alapján"
+
+#. type: Content of: <refentry><refsynopsisdiv><cmdsynopsis>
+#: share/doc/po4a-display-pod.xml:10
+msgid ""
+"<command>po4a-display-pod</command> <arg choice='plain'><option>-p </"
+"option></arg> <arg choice='plain'><replaceable>PO_FILE</replaceable></arg> "
+"<arg choice='plain'><option>-m </option></arg> <arg "
+"choice='plain'><replaceable>POD_FILE</replaceable></arg> <arg "
+"choice='opt'><arg choice='plain'><option>-o </option></arg><arg "
+"choice='plain'><replaceable>PO4A_OPT</replaceable></arg></arg>"
+msgstr ""
+"<command>po4a-display-pod</command> <arg choice='plain'><option>-p </"
+"option></arg> <arg choice='plain'><replaceable>PO_FÁJL</replaceable></arg> "
+"<arg choice='plain'><option>-m </option></arg> <arg "
+"choice='plain'><replaceable>POD_FÁJL</replaceable></arg> <arg "
+"choice='opt'><arg choice='plain'><option>-o </option></arg><arg "
+"choice='plain'><replaceable>PO4A_KAPCSOLÓ</replaceable></arg></arg>"
+
+#. type: Content of: <refentry><refsect1><para>
+#: share/doc/po4a-display-pod.xml:12
+msgid ""
+"Translators can use <command>po4a-display-pod</command> to see how their "
+"translation of a man page will be rendered to the end users, without "
+"recompiling and reinstalling the whole project. Most of the time, the POD "
+"file is only available in source package or embedded in Perl script."
+msgstr ""
+
+#. type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
+#: share/doc/po4a-display-pod.xml:16
+msgid "<option>-m </option><replaceable>POD_FILE</replaceable>"
+msgstr ""
+
+#. type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
+#: share/doc/po4a-display-pod.xml:17
+msgid "The original POD file used by po4a to generate PO file."
+msgstr ""
+
+#. type: Content of: <refentry><refsect1><para>
+#: share/doc/po4a-display-pod.xml:21
+msgid ""
+"<citerefentry> <refentrytitle>po4a-display-man</refentrytitle><manvolnum>1</"
+"manvolnum> </citerefentry>"
+msgstr ""
+
+#. type: Content of: <refentry><refsect1><para>
+#: share/doc/po4a-display-pod.xml:23
+msgid "Florentin Duneau"
+msgstr ""
+
+#. type: =head1
+#: po4a:1 po4a-gettextize:1 po4a-normalize:1 po4a-translate:1 po4a-updatepo:1
+#: msguntypot:1 doc/po4a.7.pod:1 lib/Locale/Po4a/AsciiDoc.pm:1
+#: lib/Locale/Po4a/BibTeX.pm:1 lib/Locale/Po4a/Chooser.pm:1
+#: lib/Locale/Po4a/Common.pm:1 lib/Locale/Po4a/Dia.pm:1
+#: lib/Locale/Po4a/Docbook.pm:1 lib/Locale/Po4a/Guide.pm:1
+#: lib/Locale/Po4a/Halibut.pm:1 lib/Locale/Po4a/Ini.pm:1
+#: lib/Locale/Po4a/KernelHelp.pm:1 lib/Locale/Po4a/LaTeX.pm:1
+#: lib/Locale/Po4a/Man.pm:1 lib/Locale/Po4a/Po.pm:1 lib/Locale/Po4a/Pod.pm:1
+#: lib/Locale/Po4a/RubyDoc.pm:1 lib/Locale/Po4a/Sgml.pm:1
+#: lib/Locale/Po4a/TeX.pm:1 lib/Locale/Po4a/Texinfo.pm:1
+#: lib/Locale/Po4a/Text.pm:1 lib/Locale/Po4a/TransTractor.pm:1
+#: lib/Locale/Po4a/Wml.pm:1 lib/Locale/Po4a/Xhtml.pm:1 lib/Locale/Po4a/Xml.pm:1
+#: lib/Locale/Po4a/Yaml.pm:1
+msgid "NAME"
+msgstr ""
+
+#. type: textblock
+#: po4a:2
+msgid "po4a - update both the PO files and translated documents in one shot"
+msgstr ""
+
+#. type: =head1
+#: po4a:3 po4a-gettextize:3 po4a-normalize:3 po4a-translate:3 po4a-updatepo:3
+#: msguntypot:3 lib/Locale/Po4a/Po.pm:3 lib/Locale/Po4a/Pod.pm:3
+#: lib/Locale/Po4a/TransTractor.pm:24
+msgid "SYNOPSIS"
+msgstr ""
+
+#. type: textblock
+#: po4a:4
+msgid "B<po4a> [I<options>] I<config_file>"
+msgstr ""
+
+#. type: textblock
+#: po4a:6 po4a-gettextize:7
+msgid ""
+"po4a (PO for anything) eases the maintenance of documentation translation "
+"using the classical gettext tools. The main feature of po4a is that it "
+"decouples the translation of content from its document structure. Please "
+"refer to the page L<po4a(7)> for a gentle introduction to this project."
+msgstr ""
+
+#. type: textblock
+#: po4a:7
+msgid ""
+"Upon execution, B<po4a> parses all documentation files specified in its "
+"configuration file. It updates the PO files (containing the translation) to "
+"reflect any change to the documentation, and produce a translated "
+"documentation by injecting the content's translation (found in the PO files) "
+"into the structure of the original master document."
+msgstr ""
+
+#. type: textblock
+#: po4a:8
+msgid ""
+"At first, the PO files only contain the strings to translate from the "
+"original documentation. This file format allows the translators to manually "
+"provide a translation for each paragraph extracted by B<po4a>. If the "
+"documentation is modified after translation, B<po4a> marks the corresponding "
+"translations as \"fuzzy\" in the PO file to request a manual review by the "
+"translators. The translators can also provide so-called \"addendum\", that "
+"are extra content stating for example who did the translation and how to "
+"report bugs."
+msgstr ""
+
+#. type: verbatim
+#: po4a:9
+#, no-wrap
+msgid ""
+" master documents ---+---->-------->---------+\n"
+" (doc authoring) | |\n"
+" V (po4a executions) >-----+--> translated\n"
+" | | | documents\n"
+" existing PO files -->--> updated PO files >-+ |\n"
+" ^ | |\n"
+" | V |\n"
+" +----------<---------<-------+ ^\n"
+" (manual translation process) |\n"
+" |\n"
+" addendum -->--------------------------------------+\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: po4a:10
+msgid ""
+"The workflow of B<po4a> is asynchronous, as suited to open-source projects. "
+"The documentation writers author the master documents at their own pace. The "
+"translators review and update the translations in the PO files. The "
+"maintainers rerun B<po4a> on need, to reflect any change to the original "
+"documentation to the PO files, and to produce updated documentation "
+"translations, by injecting the latest translation into the latest document "
+"structure."
+msgstr ""
+
+#. type: textblock
+#: po4a:11
+msgid ""
+"By default, a given translated document is produced when at least 80% of its "
+"content is translated. The untranslated text is kept in the original "
+"language. The produced documentation thus mixes languages if the "
+"translation is not complete. You can change the 80% threshold with the I<--"
+"keep> option described below. Note however that discarding translations as "
+"soon as they are not 100% may be discouraging for the translators whose work "
+"will almost never be shown to the users, while showing \"translations\" that "
+"are too incomplete may be troubling for the end users."
+msgstr ""
+
+#. type: textblock
+#: po4a:12
+msgid ""
+"Storing the translated documentation files in the version control system is "
+"probably a bad idea, since they are automatically generated. The precious "
+"files are the PO files, that contain the hard work of your fellow "
+"translators. Also, some people find it easier to interact with the "
+"translators through an online platform such as S<weblate>, but this is "
+"naturally fully optional."
+msgstr ""
+
+#. type: =head2
+#: po4a:13
+msgid "Quick start tutorial"
+msgstr ""
+
+#. type: textblock
+#: po4a:14
+msgid ""
+"Let's assume you maintain a program named B<foo> which has a man page F<man/"
+"foo.1> written in English (the bridge language in most open-source projects, "
+"but B<po4a> can be used from or to any language). Some times ago, someone "
+"provided a German translation named F<man/foo.de.1> and disappeared. This "
+"is a problem because you just got a bug report saying that your "
+"documentation contains a gravely misleading information that must be fixed "
+"in all languages, but you don't speak German so you can only modify the "
+"original, not the translation. Now, another contributor wants to contribute "
+"a translation to Japanese, a language that you don't master either."
+msgstr ""
+
+#. type: textblock
+#: po4a:15
+msgid ""
+"It is time to convert your documentation to B<po4a> to solve your "
+"documentation maintenance nightmares. You want to update the doc when "
+"needed, you want to ease the work of your fellow translators, and you want "
+"to ensure that your users never see any outdated and thus misleading "
+"documentation."
+msgstr ""
+
+#. type: textblock
+#: po4a:16
+msgid ""
+"The conversion includes two steps: setup the po4a infrastructure, and "
+"convert the previous German translation to salvage the previous work. This "
+"latter part is done using S<po4a-gettextize>, as follows. As detailed in the "
+"documentation of L<po4a-gettextize(1)>, this process rarely fully automatic, "
+"but once it's done, the B<de.po> file containing the German translation can "
+"be integrated in your po4a workflow."
+msgstr ""
+
+#. type: verbatim
+#: po4a:17
+#, no-wrap
+msgid ""
+" po4a-gettextize --format man --master foo.1 --localized foo.de.1 --po de.po\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: po4a:18
+msgid ""
+"Let's now configure po4a. With the appropriate file layout, your "
+"configuration file could be as simple as this:"
+msgstr ""
+
+#. type: verbatim
+#: po4a:19
+#, no-wrap
+msgid ""
+" [po_directory] man/po4a/\n"
+"\n"
+msgstr ""
+
+#. type: verbatim
+#: po4a:20
+#, no-wrap
+msgid ""
+" [type: man] man/foo.1 $lang:man/translated/foo.$lang.1\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: po4a:21
+msgid ""
+"It specifies that all PO files (containing the work of the translators) are "
+"in the F<man/po4a/> directory, and that you have only one master file, F<man/"
+"foo.1>. If you had several master files, you would have several lines "
+"similar to the second one. Each such line also specify where to write the "
+"corresponding translation files. Here, the German translation of F<man/"
+"foo.1> is in F<man/translated/foo.de.1>."
+msgstr ""
+
+#. type: textblock
+#: po4a:22
+msgid ""
+"The last thing we need to complete the configuration of B<po4a> is a POT "
+"file containing the template material that should be used to start a new "
+"translation. Simply create an empty file with the S<.pot> extension in the "
+"specified S<po_directory> (e.g. F<man/po4a/foo.pot>), and B<po4a> will fill "
+"it with the expected content."
+msgstr ""
+
+#. type: textblock
+#: po4a:23
+msgid "Here is a recap of the files in this setup:"
+msgstr ""
+
+#. type: verbatim
+#: po4a:24
+#, no-wrap
+msgid ""
+" ├── man/\n"
+" │ ├── foo.1 <- The original man page, in English\n"
+" │ ├── po4a/\n"
+" │ │ ├── de.po <- The German PO translation, from gettextization\n"
+" │ │ └── foo.pot <- The POT template of future translations (empty at first)\n"
+" │ └── translated/ <- Directory where the translations will be created\n"
+" └── po4a.cfg <- The configuration file\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: po4a:25
+msgid ""
+"Once setup, executing B<po4a> will parse your documentation, update the POT "
+"template file, use it to update the PO translation files, and use them to "
+"update the documentation translation files. All in one command:"
+msgstr ""
+
+#. type: verbatim
+#: po4a:26
+#, no-wrap
+msgid ""
+" po4a --verbose po4a.cfg\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: po4a:27
+msgid ""
+"This is it. B<po4a> is now fully configured. Once you've fixed your error in "
+"F<man/foo.1>, the offending paragraph in the German translation will be "
+"replaced by the fixed text in English. Mixing languages is not optimal, but "
+"it's the only way to remove errors in translations that you don't even "
+"understand, and ensure that the content presented to the users is never "
+"misleading. Updating the German translation is also much easier in the "
+"corresponding PO file, so the language mix-up may not last long. Finally, "
+"when a Japanese translator wants to contribute a new translation, she should "
+"rename the S<foo.pot> into S<ja.po> and complete the translation. Once you "
+"have this file, just drop it in F<man/po4a/po/>. A translated page will "
+"appear as F<man/translated/foo.ja.1> (provided that enough content is "
+"translated) when you run B<po4a> again."
+msgstr ""
+
+#. type: =item
+#: po4a:29 po4a-translate:28
+msgid "B<-k>, B<--keep>"
+msgstr ""
+
+#. type: textblock
+#: po4a:30
+msgid ""
+"Minimal threshold for translation percentage to keep (i.e. write) the "
+"resulting file (default: 80). I.e. by default, files have to be translated "
+"at least at 80% to be written on disk."
+msgstr ""
+
+#. type: =item
+#: po4a:31 po4a-normalize:12 po4a-translate:30
+msgid "B<-w>, B<--width>"
+msgstr ""
+
+#. type: textblock
+#: po4a:32 po4a-normalize:13 po4a-translate:31
+msgid ""
+"Column at which we should wrap the resulting file if the format supports it "
+"(default: 76)."
+msgstr ""
+
+#. type: =item
+#: po4a:33 po4a-gettextize:26 po4a-normalize:22 po4a-translate:32
+#: po4a-updatepo:28
+msgid "B<-h>, B<--help>"
+msgstr ""
+
+#. type: textblock
+#: po4a:34 po4a-gettextize:27 po4a-normalize:23 po4a-translate:33
+#: po4a-updatepo:29
+msgid "Show a short help message."
+msgstr ""
+
+#. type: =item
+#: po4a:35 po4a-gettextize:16 po4a-normalize:28 po4a-translate:18
+#: po4a-updatepo:16
+msgid "B<-M>, B<--master-charset>"
+msgstr ""
+
+#. type: textblock
+#: po4a:36
+msgid ""
+"Charset of the files containing the documents to translate. Note that all "
+"master documents must use the same charset."
+msgstr ""
+
+#. type: =item
+#: po4a:37 po4a-gettextize:20 po4a-translate:22
+msgid "B<-L>, B<--localized-charset>"
+msgstr ""
+
+#. type: textblock
+#: po4a:38
+msgid ""
+"Charset of the files containing the localized documents. Note that all "
+"translated documents will use the same charset."
+msgstr ""
+
+#. type: =item
+#: po4a:39 po4a-translate:14
+msgid "B<-A>, B<--addendum-charset>"
+msgstr ""
+
+#. type: textblock
+#: po4a:40 po4a-translate:15
+msgid ""
+"Charset of the addenda. Note that all the addenda should be in the same "
+"charset."
+msgstr ""
+
+#. type: =item
+#: po4a:41 po4a-gettextize:32 po4a-normalize:34 po4a-translate:36
+#: po4a-updatepo:32
+msgid "B<-V>, B<--version>"
+msgstr ""
+
+#. type: textblock
+#: po4a:42 po4a-gettextize:33 po4a-normalize:35 po4a-translate:37
+#: po4a-updatepo:33
+msgid "Display the version of the script and exit."
+msgstr ""
+
+#. type: =item
+#: po4a:43 po4a-gettextize:34 po4a-translate:38 po4a-updatepo:34
+msgid "B<-v>, B<--verbose>"
+msgstr ""
+
+#. type: textblock
+#: po4a:44 po4a-gettextize:35 po4a-translate:39 po4a-updatepo:35
+msgid "Increase the verbosity of the program."
+msgstr ""
+
+#. type: =item
+#: po4a:45
+msgid "B<-q>, B<--quiet>"
+msgstr ""
+
+#. type: textblock
+#: po4a:46
+msgid "Decrease the verbosity of the program."
+msgstr ""
+
+#. type: =item
+#: po4a:47 po4a-gettextize:36 po4a-translate:40 po4a-updatepo:36
+msgid "B<-d>, B<--debug>"
+msgstr ""
+
+#. type: textblock
+#: po4a:48 po4a-gettextize:37 po4a-translate:41 po4a-updatepo:37
+msgid "Output some debugging information."
+msgstr ""
+
+#. type: =item
+#: po4a:49 po4a-gettextize:24 po4a-normalize:10 po4a-translate:26
+#: po4a-updatepo:20
+msgid "B<-o>, B<--option>"
+msgstr ""
+
+#. type: textblock
+#: po4a:50 po4a-gettextize:25 po4a-normalize:11 po4a-translate:27
+#: po4a-updatepo:21
+msgid ""
+"Extra option(s) to pass to the format plugin. See the documentation of each "
+"plugin for more information about the valid options and their meanings. For "
+"example, you could pass '-o tablecells' to the AsciiDoc parser, while the "
+"text parser would accept '-o tabs=split'."
+msgstr ""
+
+#. type: =item
+#: po4a:51
+msgid "B<-f>, B<--force>"
+msgstr ""
+
+#. type: textblock
+#: po4a:52
+msgid ""
+"Always generate the POT and PO files, even if B<po4a> considers it is not "
+"necessary."
+msgstr ""
+
+#. type: textblock
+#: po4a:53
+msgid ""
+"The default behavior (when B<--force> is not specified) is the following:"
+msgstr ""
+
+#. type: textblock
+#: po4a:54
+msgid ""
+"If the POT file already exists, it is regenerated if a master document or "
+"the configuration file is more recent (unless B<--no-update> is provided). "
+"The POT file is also written in a temporary document and B<po4a> verifies "
+"that the changes are really needed."
+msgstr ""
+
+#. type: textblock
+#: po4a:55
+msgid ""
+"Also, a translation is regenerated only if its master document, the PO file, "
+"one of its addenda or the configuration file is more recent. To avoid "
+"trying to regenerate translations which do not pass the threshold test (see "
+"B<--keep>), a file with the F<.po4a-stamp> extension can be created (see B<--"
+"stamp>)."
+msgstr ""
+
+#. type: textblock
+#: po4a:56
+msgid ""
+"If a master document includes files, you should use the B<--force> flag "
+"because the modification time of these included files are not taken into "
+"account."
+msgstr ""
+
+#. type: textblock
+#: po4a:57
+msgid ""
+"The PO files are always re-generated based on the POT with B<msgmerge -U>."
+msgstr ""
+
+#. type: =item
+#: po4a:58
+msgid "B<--stamp>"
+msgstr ""
+
+#. type: textblock
+#: po4a:59
+msgid ""
+"Tells B<po4a> to create stamp files when a translation is not generated "
+"because it does not reach the threshold. These stamp files are named "
+"according to the expected translated document, with the F<.po4a-stamp> "
+"extension."
+msgstr ""
+
+#. type: textblock
+#: po4a:60
+msgid ""
+"Note: This only activates the creation of the F<.po4a-stamp> files. The "
+"stamp files are always used if they exist, and they are removed with B<--rm-"
+"translations> or when the file is finally translated."
+msgstr ""
+
+#. type: =item
+#: po4a:61
+msgid "B<--no-translations>"
+msgstr ""
+
+#. type: textblock
+#: po4a:62
+msgid ""
+"Do not generate the translated documents, only update the POT and PO files."
+msgstr ""
+
+#. type: =item
+#: po4a:63
+msgid "B<--no-update>"
+msgstr ""
+
+#. type: textblock
+#: po4a:64
+msgid ""
+"Do not change the POT and PO files, only the translation may be updated."
+msgstr ""
+
+#. type: =item
+#: po4a:65
+msgid "B<--keep-translations>"
+msgstr ""
+
+#. type: textblock
+#: po4a:66
+msgid ""
+"Keeps the existing translation files even if the translation doesn't meet "
+"the threshold specified by B<--keep>. This option does not create new "
+"translation files with few content, but it will save existing translations "
+"which decay because of changes to the master files."
+msgstr ""
+
+#. type: textblock
+#: po4a:67
+msgid ""
+"WARNING: This flag changes the po4a behavior in a rather drastic way: your "
+"translated files will not get updated at all until the translation improves. "
+"Only use this flag if you prefer shipping an outdated translated "
+"documentation rather than only shipping an accurate untranslated "
+"documentation."
+msgstr ""
+
+#. type: =item
+#: po4a:68
+msgid "B<--rm-translations>"
+msgstr ""
+
+#. type: textblock
+#: po4a:69
+msgid "Remove the translated files (implies B<--no-translations>)."
+msgstr ""
+
+#. type: =item
+#: po4a:70
+msgid "B<--no-backups>"
+msgstr ""
+
+#. type: textblock
+#: po4a:71 po4a:73
+msgid ""
+"This flag does nothing since 0.41, and may be removed in later releases."
+msgstr ""
+
+#. type: =item
+#: po4a:72
+msgid "B<--rm-backups>"
+msgstr ""
+
+#. type: =item
+#: po4a:74
+msgid "B<--translate-only> I<translated-file>"
+msgstr ""
+
+#. type: textblock
+#: po4a:75
+msgid ""
+"Translate only the specified file. It may be useful to speed up processing "
+"if a configuration file contains a lot of files. Note that this option does "
+"not update PO and POT files. This option can be used multiple times."
+msgstr ""
+
+#. type: =item
+#: po4a:76
+msgid "B<--variable> I<var>B<=>I<value>"
+msgstr ""
+
+#. type: textblock
+#: po4a:77
+msgid ""
+"Define a variable that will be expanded in the B<po4a> configuration file. "
+"Every occurrence of I<$(var)> will be replaced by I<value>. This option can "
+"be used multiple times."
+msgstr ""
+
+#. type: =item
+#: po4a:78
+msgid "B<--srcdir> I<SRCDIR>"
+msgstr ""
+
+#. type: textblock
+#: po4a:79
+msgid ""
+"Set the base directory for all input documents specified in the B<po4a> "
+"configuration file."
+msgstr ""
+
+#. type: textblock
+#: po4a:80
+msgid ""
+"If both I<destdir> and I<srcdir> are specified, input files are searched in "
+"the following directories, in order: I<destdir>, the current directory and "
+"I<srcdir>. Output files are written to I<destdir> if specified, or to the "
+"current directory."
+msgstr ""
+
+#. type: =item
+#: po4a:81
+msgid "B<--destdir> I<DESTDIR>"
+msgstr ""
+
+#. type: textblock
+#: po4a:82
+msgid ""
+"Set the base directory for all the output documents specified in the B<po4a> "
+"configuration file (see B<--srcdir> above)."
+msgstr ""
+
+#. type: =head2
+#: po4a:83
+msgid "Options modifying the POT header"
+msgstr ""
+
+#. type: =item
+#: po4a:84 lib/Locale/Po4a/Po.pm:14
+msgid "B<--porefs> I<type>"
+msgstr ""
+
+#. type: textblock
+#: po4a:85 po4a-translate:43 po4a-updatepo:39 lib/Locale/Po4a/Po.pm:15
+msgid ""
+"Specify the reference format. Argument I<type> can be one of B<never> to not "
+"produce any reference, B<file> to only specify the file without the line "
+"number, B<counter> to replace line number by an increasing counter, and "
+"B<full> to include complete references (default: full)."
+msgstr ""
+
+#. type: =item
+#: po4a:86 po4a-updatepo:41 lib/Locale/Po4a/Po.pm:16
+msgid "B<--wrap-po> B<no>|B<newlines>|I<number> (default: 76)"
+msgstr ""
+
+#. type: textblock
+#: po4a:87 po4a-updatepo:42 lib/Locale/Po4a/Po.pm:17
+msgid ""
+"Specify how the po file should be wrapped. This gives the choice between "
+"either files that are nicely wrapped but could lead to git conflicts, or "
+"files that are easier to handle automatically, but harder to read for humans."
+msgstr ""
+
+#. type: textblock
+#: po4a:88 lib/Locale/Po4a/Po.pm:18
+msgid ""
+"Historically, the gettext suite has reformatted the po files at the 77th "
+"column for cosmetics. This option specifies the behavior of po4a. If set to "
+"a numerical value, po4a will wrap the po file after this column and after "
+"newlines in the content. If set to B<newlines>, po4a will only split the "
+"msgid and msgstr after newlines in the content. If set to B<no>, po4a will "
+"not wrap the po file at all. The reference comments are always wrapped by "
+"the gettext tools that we use internally."
+msgstr ""
+
+#. type: textblock
+#: po4a:89 po4a-updatepo:44 lib/Locale/Po4a/Po.pm:19
+msgid ""
+"Note that this option has no impact on how the msgid and msgstr are wrapped, "
+"i.e. on how newlines are added to the content of these strings."
+msgstr ""
+
+#. type: =item
+#: po4a:90
+msgid "B<--master-language>"
+msgstr ""
+
+#. type: textblock
+#: po4a:91
+msgid ""
+"Language of the source files containing the documents to translate. Note "
+"that all master documents must use the same language."
+msgstr ""
+
+#. type: =item
+#: po4a:92 po4a-gettextize:38 po4a-updatepo:45 lib/Locale/Po4a/Po.pm:20
+msgid "B<--msgid-bugs-address> I<email@address>"
+msgstr ""
+
+#. type: textblock
+#: po4a:93 po4a-gettextize:39 po4a-updatepo:46 lib/Locale/Po4a/Po.pm:21
+msgid ""
+"Set the report address for msgid bugs. By default, the created POT files "
+"have no Report-Msgid-Bugs-To fields."
+msgstr ""
+
+#. type: =item
+#: po4a:94 po4a-gettextize:40 po4a-updatepo:47 lib/Locale/Po4a/Po.pm:22
+msgid "B<--copyright-holder> I<string>"
+msgstr ""
+
+#. type: textblock
+#: po4a:95 po4a-gettextize:41 po4a-updatepo:48 lib/Locale/Po4a/Po.pm:23
+msgid ""
+"Set the copyright holder in the POT header. The default value is \"Free "
+"Software Foundation, Inc.\""
+msgstr ""
+
+#. type: =item
+#: po4a:96 po4a-gettextize:42 po4a-updatepo:49 lib/Locale/Po4a/Po.pm:24
+msgid "B<--package-name> I<string>"
+msgstr ""
+
+#. type: textblock
+#: po4a:97 po4a-gettextize:43 po4a-updatepo:50 lib/Locale/Po4a/Po.pm:25
+msgid "Set the package name for the POT header. The default is \"PACKAGE\"."
+msgstr ""
+
+#. type: =item
+#: po4a:98 po4a-gettextize:44 po4a-updatepo:51 lib/Locale/Po4a/Po.pm:26
+msgid "B<--package-version> I<string>"
+msgstr ""
+
+#. type: textblock
+#: po4a:99 po4a-gettextize:45 po4a-updatepo:52 lib/Locale/Po4a/Po.pm:27
+msgid "Set the package version for the POT header. The default is \"VERSION\"."
+msgstr ""
+
+#. type: =head2
+#: po4a:100
+msgid "Options to modify the PO files"
+msgstr ""
+
+#. type: =item
+#: po4a:101 po4a-updatepo:26
+msgid "B<--msgmerge-opt> I<options>"
+msgstr ""
+
+#. type: textblock
+#: po4a:102 po4a-updatepo:27
+msgid "Extra options for B<msgmerge>(1)."
+msgstr ""
+
+#. type: textblock
+#: po4a:103
+msgid "Note: B<$lang> will be extended to the current language."
+msgstr ""
+
+#. type: =item
+#: po4a:104 po4a-updatepo:22
+msgid "B<--no-previous>"
+msgstr ""
+
+#. type: textblock
+#: po4a:105
+msgid ""
+"This option removes B<--previous> from the options passed to B<msgmerge>. "
+"This is necessary to support versions of B<gettext> earlier than 0.16."
+msgstr ""
+
+#. type: =item
+#: po4a:106 po4a-updatepo:24
+msgid "B<--previous>"
+msgstr ""
+
+#. type: textblock
+#: po4a:107 po4a-updatepo:25
+msgid ""
+"This option adds B<--previous> to the options passed to B<msgmerge>. It "
+"requires B<gettext> 0.16 or later, and is activated by default."
+msgstr ""
+
+#. type: =head1
+#: po4a:108
+msgid "CONFIGURATION FILE"
+msgstr ""
+
+#. type: textblock
+#: po4a:109
+msgid ""
+"po4a expects a configuration file as argument. This file must contain the "
+"following elements:"
+msgstr ""
+
+#. type: textblock
+#: po4a:110
+msgid ""
+"The path to the PO files and the list of languages existing in the project;"
+msgstr ""
+
+#. type: textblock
+#: po4a:111
+msgid ""
+"Optionally, some global options and so-called configuration aliases that are "
+"used as templates to configure individual master files;"
+msgstr ""
+
+#. type: textblock
+#: po4a:112
+msgid ""
+"The list of each master file to translate, along with specific parameters."
+msgstr ""
+
+#. type: textblock
+#: po4a:113
+msgid ""
+"All lines contain a command between square braces, followed by its "
+"parameters. Comments begin with the char '#' and run until the end of the "
+"line. You can escape the end of line to spread a command over several lines."
+msgstr ""
+
+#. type: textblock
+#: po4a:114
+msgid ""
+"Some full examples are presented on this page, while other examples can be "
+"found in the C<t/cfg> directory of the source distribution."
+msgstr ""
+
+#. type: =head2
+#: po4a:115
+msgid "Finding the PO and POT files"
+msgstr ""
+
+#. type: textblock
+#: po4a:116
+msgid ""
+"The simplest solution is to explicitly give the path to POT and PO files, as "
+"follows:"
+msgstr ""
+
+#. type: verbatim
+#: po4a:117
+#, no-wrap
+msgid ""
+" [po4a_paths] man/po/project.pot de:man/po/de.po fr:man/po/fr.po\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: po4a:118
+msgid ""
+"This specifies the path to the POT file first, and then the paths to the "
+"German and French PO files."
+msgstr ""
+
+#. type: textblock
+#: po4a:119
+msgid ""
+"The same information can be written as follows to reduce the risk of copy/"
+"paste errors:"
+msgstr ""
+
+#. type: verbatim
+#: po4a:120
+#, no-wrap
+msgid ""
+" [po4a_langs] fr de\n"
+" [po4a_paths] man/po/project.pot $lang:man/po/$lang.po\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: po4a:121
+msgid ""
+"The C<$lang> component is automatically expanded using the provided "
+"languages list, reducing the risk of copy/paste error when a new language is "
+"added."
+msgstr ""
+
+#. type: textblock
+#: po4a:122
+msgid ""
+"You can further compact the same information by only providing the path to "
+"the directory containing your translation project, as follows."
+msgstr ""
+
+#. type: verbatim
+#: po4a:123
+#, no-wrap
+msgid ""
+" [po_directory] man/po/\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: po4a:124
+msgid ""
+"The provided directory must contain a set of PO files, each named F<XX.po> "
+"with C<XX> the ISO 639-1 of the language used in this file. The directory "
+"must also contain a single POT file, with the C<.pot> file extension. For "
+"the first run, this file can be empty but it must exist (po4a cannot guess "
+"the name to use before the extension)."
+msgstr ""
+
+#. type: textblock
+#: po4a:125
+msgid ""
+"Note that you must choose only one between C<po_directory> and "
+"C<po4a_paths>. The first one (C<po_directory>) is more compact, further "
+"reduces the risk of copy/paste error, but forces you to use the expected "
+"project structure and file names. The second one (C<po4a_paths>), is more "
+"explicit, probably more readable, and advised when you setup your first "
+"project with po4a."
+msgstr ""
+
+#. type: =head3
+#: po4a:126
+msgid "Centralized or split PO files?"
+msgstr ""
+
+#. type: textblock
+#: po4a:127
+msgid ""
+"By default, po4a produces one single PO file per target language, containing "
+"the whole content of your translation project. As your project grows, the "
+"size of these files may become problematic. When using weblate, it is "
+"possible to specify priorities for each translation segment (i.e., msgid) so "
+"that the important ones get translated first. Still, some translation teams "
+"prefer to split the content in several files."
+msgstr ""
+
+#. type: textblock
+#: po4a:128
+msgid ""
+"To have one PO file per master file, you simply have to use the string "
+"C<$master> in the name of your PO files on the C<[po4a_paths]> line, as "
+"follows."
+msgstr ""
+
+#. type: verbatim
+#: po4a:129
+#, no-wrap
+msgid ""
+" [po4a_paths] doc/$master/$master.pot $lang:doc/$master/$lang.po\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: po4a:130
+msgid ""
+"With this line, po4a will produce separate POT and PO files for each "
+"document to translate. For example, if you have 3 documents and 5 "
+"languages, this will result in 3 POT files and 15 PO files. These files are "
+"named as specified on the C<po4a_paths> template, with C<$master> "
+"substituted to the basename of each document to translate. In case of name "
+"conflict, you can specify the POT file to use as follows, with the C<pot=> "
+"parameter."
+msgstr ""
+
+#. type: textblock
+#: po4a:131
+msgid ""
+"This feature can also be used to group several translated files into the "
+"same POT file. The following example only produces 2 POT files: F<l10n/po/"
+"foo.pot> (containing the material from F<foo/gui.xml>) and F<l10n/po/bar."
+"pot> (containing the material from both F<bar/gui.xml> and F<bar/cli.xml>)."
+msgstr ""
+
+#. type: verbatim
+#: po4a:132
+#, no-wrap
+msgid ""
+" [po4a_langs] de fr ja\n"
+" [po4a_paths] l10n/po/$master.pot $lang:l10n/po/$master.$lang.po\n"
+" [type: xml] foo/gui.xml $lang:foo/gui.$lang.xml pot=foo\n"
+" [type: xml] bar/gui.xml $lang:bar/gui.$lang.xml pot=bar\n"
+" [type: xml] bar/cli.xml $lang:bar/cli.$lang.xml pot=bar\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: po4a:133
+msgid ""
+"In split mode, B<po4a> builds a temporary compendium during the PO update, "
+"to share the translations between all the PO files. If two PO files have "
+"different translations for the same string, B<po4a> will mark this string as "
+"fuzzy and will submit both translations in all the PO files containing this "
+"string. When unfuzzied by the translator, the translation is automatically "
+"used in every PO files."
+msgstr ""
+
+#. type: =head2
+#: po4a:134
+msgid "Specifying the documents to translate"
+msgstr ""
+
+#. type: textblock
+#: po4a:135
+msgid ""
+"You must also list the documents that should be translated. For each master "
+"file, you must specify the format parser to use, the location of the "
+"translated document to produce, and optionally some configuration. File "
+"names should be quoted or escaped if they contain spaces. Here is an example:"
+msgstr ""
+
+#. type: verbatim
+#: po4a:136
+#, no-wrap
+msgid ""
+" [type: sgml] \"doc/my stuff.sgml\" \"fr:doc/fr/mon truc.sgml\" de:doc/de/mein\\ kram.sgml\n"
+" [type: man] script fr:doc/fr/script.1 de:doc/de/script.1\n"
+" [type: docbook] doc/script.xml fr:doc/fr/script.xml \\\n"
+" de:doc/de/script.xml\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: po4a:137
+msgid ""
+"But again, these complex lines are difficult to read and modify, e.g. when "
+"adding a new language. It is much simpler to reorganize things using the "
+"C<$lang> template as follows:"
+msgstr ""
+
+#. type: verbatim
+#: po4a:138
+#, no-wrap
+msgid ""
+" [type: sgml] doc/my_stuff.sgml $lang:doc/$lang/my_stuff.sgml\n"
+" [type: man] script.1 $lang:po/$lang/script.1\n"
+" [type: docbook] doc/script.xml $lang:doc/$lang/script.xml\n"
+"\n"
+msgstr ""
+
+#. type: =head2
+#: po4a:139
+msgid "Specifying options"
+msgstr ""
+
+#. type: textblock
+#: po4a:140
+msgid ""
+"There is two types of options: I<po4a options> are default values to the "
+"po4a command line options while I<format options> are used to change the "
+"behavior of the format parsers. As a I<po4a options>, you could for example "
+"specify in your configuration file that the default value of the B<--keep> "
+"command line parameter is 50% instead of 80%. I<Format options> are "
+"documented on the specific page of each parsing module, e.g. L<Locale::Po4a::"
+"Xml(3pm)>. You could for example pass B<nostrip> to the XML parser to not "
+"strip the spaces around the extracted strings."
+msgstr ""
+
+#. type: textblock
+#: po4a:141
+msgid ""
+"You can pass these options for a specific master file, or even for a "
+"specific translation of that file, using C<opt:> and C<opt_XX:> for the "
+"C<XX> language. In the following example, the B<nostrip> option is passed "
+"to the XML parser (for all languages), while the threshold will be reduced "
+"to 0% for the French translation (that is thus always kept)."
+msgstr ""
+
+#. type: verbatim
+#: po4a:142
+#, no-wrap
+msgid ""
+" [type:xml] toto.xml $lang:toto.$lang.xml opt:\"-o nostrip\" opt_fr:\"--keep 0\"\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: po4a:143
+msgid ""
+"In any case, these configuration chunks must be located at the end of the "
+"line. The declaration of files must come first, then the addendum if any "
+"(see below), and then only the options. The grouping of configuration chunks "
+"is not very important, since elements are internally concatenated as "
+"strings. The following examples are all equivalent:"
+msgstr ""
+
+#. type: verbatim
+#: po4a:144
+#, no-wrap
+msgid ""
+" [type:xml] toto.xml $lang:toto.$lang.xml opt:\"--keep 20\" opt:\"-o nostrip\" opt_fr:\"--keep 0\"\n"
+" [type:xml] toto.xml $lang:toto.$lang.xml opt:\"--keep 20 -o nostrip\" opt_fr:\"--keep 0\"\n"
+" [type:xml] toto.xml $lang:toto.$lang.xml opt:--keep opt:20 opt:-o opt:nostrip opt_fr:--keep opt_fr:0\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: po4a:145
+msgid ""
+"Note that language specific options are not used when building the POT file. "
+"It is for example impossible to pass B<nostrip> to the parser only when "
+"building the French translation, because the same POT file is used to update "
+"every languages. So the only options that can be language-specific are the "
+"ones that are used when producing the translation, as the C<--keep> option."
+msgstr ""
+
+#. type: =head3
+#: po4a:146
+msgid "Configuration aliases"
+msgstr ""
+
+#. type: textblock
+#: po4a:147
+msgid ""
+"To pass the same options to several files, the best is to define a type "
+"alias as follows. In the next example, C<--keep 0> is passed to every "
+"Italian translation using this C<test> type, that is an extension of the "
+"C<man> type."
+msgstr ""
+
+#. type: verbatim
+#: po4a:148
+#, no-wrap
+msgid ""
+" [po4a_alias:test] man opt_it:\"--keep 0\"\n"
+" [type: test] man/page.1 $lang:man/$lang/page.1\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: po4a:149
+msgid ""
+"You can also extend an existing type reusing the same name for the alias as "
+"follows. This is not interpreted as as an erroneous recursive definition."
+msgstr ""
+
+#. type: verbatim
+#: po4a:150
+#, no-wrap
+msgid ""
+" [po4a_alias:man] man opt_it:\"--keep 0\"\n"
+" [type: man] man/page.1 $lang:man/$lang/page.1\n"
+"\n"
+msgstr ""
+
+#. type: =head3
+#: po4a:151
+msgid "Global default options"
+msgstr ""
+
+#. type: textblock
+#: po4a:152
+msgid ""
+"You can also use C<[options]> lines to define options that must be used for "
+"all files, regardless of their type."
+msgstr ""
+
+#. type: verbatim
+#: po4a:153
+#, no-wrap
+msgid ""
+" [options] --keep 20 --option nostrip\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: po4a:154
+msgid ""
+"As with the command line options, you can abbreviate the parameters passed "
+"in the configuration file:"
+msgstr ""
+
+#. type: verbatim
+#: po4a:155
+#, no-wrap
+msgid ""
+" [options] -k 20 -o nostrip\n"
+"\n"
+msgstr ""
+
+#. type: =head3
+#: po4a:156
+msgid "Option priorities"
+msgstr ""
+
+#. type: textblock
+#: po4a:157
+msgid ""
+"The options of every sources are concatenated, ensuring that the default "
+"values can easily be overridden by more specific options. The order is as "
+"follows:"
+msgstr ""
+
+#. type: textblock
+#: po4a:158
+msgid ""
+"C<[options]> lines provide default values that can be overridden by any "
+"other source."
+msgstr ""
+
+#. type: textblock
+#: po4a:159
+msgid ""
+"Type aliases are then used. Language specific settings override the ones "
+"applicable to all languages."
+msgstr ""
+
+#. type: textblock
+#: po4a:160
+msgid ""
+"Settings that are specific to a given master file override both the default "
+"ones and the ones coming from the type alias. In this case also, language "
+"specific settings override the global ones."
+msgstr ""
+
+#. type: textblock
+#: po4a:161
+msgid ""
+"Finally, parameters provided on the B<po4a> command line override any "
+"settings from the configuration file."
+msgstr ""
+
+#. type: =head3
+#: po4a:162
+msgid "Example"
+msgstr ""
+
+#. type: textblock
+#: po4a:163
+msgid "Here is an example showing how to quote the spaces and quotes:"
+msgstr ""
+
+#. type: verbatim
+#: po4a:164
+#, no-wrap
+msgid ""
+" [po_directory] man/po/\n"
+" \n"
+msgstr ""
+
+#. type: verbatim
+#: po4a:165
+#, no-wrap
+msgid ""
+" [options] --master-charset UTF-8\n"
+" \n"
+msgstr ""
+
+#. type: verbatim
+#: po4a:166
+#, no-wrap
+msgid ""
+" [po4a_alias:man] man opt:\"-o \\\"mdoc=NAME,SEE ALSO\\\"\"\n"
+" [type:man] t-05-config/test02_man.1 $lang:tmp/test02_man.$lang.1 \\\n"
+" opt:\"-k 75\" opt_it:\"-L UTF-8\" opt_fr:--verbose\n"
+"\n"
+msgstr ""
+
+#. type: =head2
+#: po4a:167
+msgid "Addendum: Adding extra content in the translation"
+msgstr ""
+
+#. type: textblock
+#: po4a:168
+msgid ""
+"If you want to add an extra section to the translation, for example to give "
+"credit to the translator, then you need to define an addendum to the line "
+"defining your master file. Please refer to the page L<po4a(7)> for more "
+"details on the syntax of addendum files."
+msgstr ""
+
+#. type: verbatim
+#: po4a:169
+#, no-wrap
+msgid ""
+" [type: pod] script fr:doc/fr/script.1 \\\n"
+" add_fr:doc/l10n/script.fr.add\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: po4a:170
+msgid "You can also use language templates as follow:"
+msgstr ""
+
+#. type: verbatim
+#: po4a:171
+#, no-wrap
+msgid ""
+" [type: pod] script $lang:doc/$lang/script.1 \\\n"
+" add_$lang:doc/l10n/script.$lang.add\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: po4a:172
+msgid "If an addendum fails to apply, the translation is discarded."
+msgstr ""
+
+#. type: =head3
+#: po4a:173
+msgid "Modifiers for the addendum declaration"
+msgstr ""
+
+#. type: textblock
+#: po4a:174
+msgid ""
+"Addendum modifiers can simplify the configuration file in the case where not "
+"all languages provide an addendum, or when the list of addenda changes from "
+"one language to the other. The modifier is a single char located before the "
+"file name."
+msgstr ""
+
+#. type: =item
+#: po4a:175
+msgid "B<?>"
+msgstr ""
+
+#. type: textblock
+#: po4a:176
+msgid "Include I<addendum_path> if this file does exist, otherwise do nothing."
+msgstr ""
+
+#. type: =item
+#: po4a:177
+msgid "B<@>"
+msgstr ""
+
+#. type: textblock
+#: po4a:178
+msgid ""
+"I<addendum_path> is not a regular addendum but a file containing a list of "
+"addenda, one by line. Each addendum may be preceded by modifiers."
+msgstr ""
+
+#. type: =item
+#: po4a:179
+msgid "B<!>"
+msgstr ""
+
+#. type: textblock
+#: po4a:180
+msgid ""
+"I<addendum_path> is discarded, it is not loaded and will not be loaded by "
+"any further addendum specification."
+msgstr ""
+
+#. type: textblock
+#: po4a:181
+msgid ""
+"The following includes an addendum in any language, but if only it exists. "
+"No error is reported if the addendum does not exist."
+msgstr ""
+
+#. type: verbatim
+#: po4a:182
+#, no-wrap
+msgid ""
+" [type: pod] script $lang:doc/$lang/script.1 add_$lang:?doc/l10n/script.$lang.add\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: po4a:183
+msgid "The following includes a list of addendum for every language:"
+msgstr ""
+
+#. type: verbatim
+#: po4a:184
+#, no-wrap
+msgid ""
+" [type: pod] script $lang:doc/$lang/script.1 add_$lang:@doc/l10n/script.$lang.add\n"
+"\n"
+msgstr ""
+
+#. type: =head2
+#: po4a:185
+msgid "Filtering the translated strings"
+msgstr ""
+
+#. type: textblock
+#: po4a:186
+msgid ""
+"Sometimes, you want to hide some strings from the translation process. To "
+"that extend, you can give a C<pot_in> parameter to your master file to "
+"specify the name of the file to use instead of the real master when building "
+"the POT file. Here is an example:"
+msgstr ""
+
+#. type: verbatim
+#: po4a:187
+#, no-wrap
+msgid ""
+" [type:docbook] book.xml \\\n"
+" pot_in:book-filtered.xml \\\n"
+" $lang:book.$lang.xml\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: po4a:188
+msgid ""
+"With this setting, the strings to translate will be extracted from the "
+"F<book-filtered.xml> (that must be produced before calling B<po4a>) while "
+"the translated files will be built from F<book.xml>. As a result, any string "
+"that is part of F<book.xml> but not in F<book-filtered.xml> will not be "
+"included in the PO files, preventing the translators from providing a "
+"translation for them. So these strings will be left unmodified when "
+"producing the translated documents. This naturally decreases the level of "
+"translation, so you may need the C<--keep> option to ensure that the "
+"document is produced anyway."
+msgstr ""
+
+#. type: textblock
+#: po4a:190
+msgid "L<po4a-gettextize(1)>, L<po4a(7)>."
+msgstr ""
+
+#. type: =head1
+#: po4a:191 po4a-gettextize:78 po4a-normalize:38 po4a-translate:52
+#: po4a-updatepo:55 msguntypot:32 doc/po4a.7.pod:196
+#: lib/Locale/Po4a/AsciiDoc.pm:56 lib/Locale/Po4a/BibTeX.pm:11
+#: lib/Locale/Po4a/Chooser.pm:12 lib/Locale/Po4a/Common.pm:28
+#: lib/Locale/Po4a/Dia.pm:14 lib/Locale/Po4a/Docbook.pm:17
+#: lib/Locale/Po4a/Guide.pm:12 lib/Locale/Po4a/Halibut.pm:16
+#: lib/Locale/Po4a/Ini.pm:10 lib/Locale/Po4a/KernelHelp.pm:9
+#: lib/Locale/Po4a/LaTeX.pm:10 lib/Locale/Po4a/Man.pm:109
+#: lib/Locale/Po4a/Po.pm:93 lib/Locale/Po4a/Pod.pm:23
+#: lib/Locale/Po4a/RubyDoc.pm:16 lib/Locale/Po4a/Sgml.pm:53
+#: lib/Locale/Po4a/TeX.pm:120 lib/Locale/Po4a/Texinfo.pm:16
+#: lib/Locale/Po4a/Text.pm:45 lib/Locale/Po4a/TransTractor.pm:157
+#: lib/Locale/Po4a/Wml.pm:11 lib/Locale/Po4a/Xhtml.pm:17
+#: lib/Locale/Po4a/Xml.pm:189 lib/Locale/Po4a/Yaml.pm:17
+msgid "AUTHORS"
+msgstr ""
+
+#. type: verbatim
+#: po4a:192 po4a-gettextize:79 po4a-normalize:39 po4a-translate:53
+#: po4a-updatepo:56 lib/Locale/Po4a/Man.pm:110
+#, no-wrap
+msgid ""
+" Denis Barbier <barbier@linuxfr.org>\n"
+" Nicolas François <nicolas.francois@centraliens.net>\n"
+" Martin Quinson (mquinson#debian.org)\n"
+"\n"
+msgstr ""
+
+#. type: =head1
+#: po4a:193 po4a-gettextize:80 po4a-normalize:40 po4a-translate:54
+#: po4a-updatepo:57 msguntypot:34 lib/Locale/Po4a/AsciiDoc.pm:58
+#: lib/Locale/Po4a/BibTeX.pm:13 lib/Locale/Po4a/Chooser.pm:14
+#: lib/Locale/Po4a/Common.pm:30 lib/Locale/Po4a/Dia.pm:16
+#: lib/Locale/Po4a/Docbook.pm:19 lib/Locale/Po4a/Guide.pm:14
+#: lib/Locale/Po4a/Halibut.pm:18 lib/Locale/Po4a/Ini.pm:12
+#: lib/Locale/Po4a/KernelHelp.pm:11 lib/Locale/Po4a/LaTeX.pm:12
+#: lib/Locale/Po4a/Man.pm:111 lib/Locale/Po4a/Pod.pm:25
+#: lib/Locale/Po4a/RubyDoc.pm:18 lib/Locale/Po4a/Sgml.pm:58
+#: lib/Locale/Po4a/TeX.pm:122 lib/Locale/Po4a/Texinfo.pm:18
+#: lib/Locale/Po4a/Text.pm:47 lib/Locale/Po4a/Wml.pm:13
+#: lib/Locale/Po4a/Xhtml.pm:19 lib/Locale/Po4a/Xml.pm:191
+#: lib/Locale/Po4a/Yaml.pm:19
+msgid "COPYRIGHT AND LICENSE"
+msgstr ""
+
+#. type: textblock
+#: po4a:194 po4a-gettextize:81 po4a-normalize:41 po4a-translate:55
+#: po4a-updatepo:58
+msgid "Copyright 2002-2023 by SPI, inc."
+msgstr ""
+
+#. type: textblock
+#: po4a:195 po4a-gettextize:82 po4a-normalize:42 po4a-translate:56
+#: po4a-updatepo:59 msguntypot:36 lib/Locale/Po4a/AsciiDoc.pm:60
+#: lib/Locale/Po4a/BibTeX.pm:15 lib/Locale/Po4a/Chooser.pm:16
+#: lib/Locale/Po4a/Common.pm:32 lib/Locale/Po4a/Dia.pm:18
+#: lib/Locale/Po4a/Docbook.pm:21 lib/Locale/Po4a/Guide.pm:16
+#: lib/Locale/Po4a/Halibut.pm:20 lib/Locale/Po4a/Ini.pm:14
+#: lib/Locale/Po4a/KernelHelp.pm:13 lib/Locale/Po4a/LaTeX.pm:14
+#: lib/Locale/Po4a/Man.pm:113 lib/Locale/Po4a/Pod.pm:27
+#: lib/Locale/Po4a/Sgml.pm:60 lib/Locale/Po4a/TeX.pm:124
+#: lib/Locale/Po4a/Texinfo.pm:20 lib/Locale/Po4a/Text.pm:50
+#: lib/Locale/Po4a/Wml.pm:15 lib/Locale/Po4a/Xhtml.pm:21
+#: lib/Locale/Po4a/Xml.pm:193 lib/Locale/Po4a/Yaml.pm:21
+msgid ""
+"This program is free software; you may redistribute it and/or modify it "
+"under the terms of GPL v2.0 or later (see the COPYING file)."
+msgstr ""
+
+#. type: textblock
+#: po4a-gettextize:2
+msgid ""
+"po4a-gettextize - convert an original file (and its translation) to a PO file"
+msgstr ""
+
+#. type: textblock
+#: po4a-gettextize:4
+msgid ""
+"B<po4a-gettextize> B<-f> I<fmt> B<-m> I<master.doc> B<-l> I<XX.doc> B<-p> "
+"I<XX.po>"
+msgstr ""
+
+#. type: textblock
+#: po4a-gettextize:5
+msgid "(I<XX.po> is the output, all others are inputs)"
+msgstr ""
+
+#. type: textblock
+#: po4a-gettextize:8
+msgid ""
+"The B<po4a-gettextize> script helps you converting your previously existing "
+"translations into a po4a-based workflow. This is only to be done once to "
+"salvage an existing translation while converting to po4a, not on a regular "
+"basis after the conversion of your project. This tedious process is "
+"explained in details in Section 'Converting a manual translation to po4a' "
+"below."
+msgstr ""
+
+#. type: textblock
+#: po4a-gettextize:9
+msgid ""
+"You must provide both a master file (e.g., the source in English) and an "
+"existing translated file (e.g., a previous translation attempt without "
+"po4a). If you provide more than one master or translation files, they will "
+"be used in sequence, but it may be easier to gettextize each page or chapter "
+"separately and then use B<msgmerge> to merge all produced PO files. As you "
+"wish."
+msgstr ""
+
+#. type: textblock
+#: po4a-gettextize:10
+msgid ""
+"If the master document has non-ASCII characters, the new generated PO file "
+"will be in UTF-8. If the master document is completely in ASCII, the "
+"generated PO will use the encoding of the translated input document."
+msgstr ""
+
+#. type: =item
+#: po4a-gettextize:12 po4a-normalize:26 po4a-translate:10 po4a-updatepo:12
+msgid "B<-f>, B<--format>"
+msgstr ""
+
+#. type: textblock
+#: po4a-gettextize:13 po4a-normalize:27 po4a-translate:11 po4a-updatepo:13
+msgid ""
+"Format of the documentation you want to handle. Use the B<--help-format> "
+"option to see the list of available formats."
+msgstr ""
+
+#. type: =item
+#: po4a-gettextize:14 po4a-translate:16 po4a-updatepo:14
+msgid "B<-m>, B<--master>"
+msgstr ""
+
+#. type: textblock
+#: po4a-gettextize:15
+msgid ""
+"File containing the master document to translate. You can use this option "
+"multiple times if you want to gettextize multiple documents."
+msgstr ""
+
+#. type: textblock
+#: po4a-gettextize:17 po4a-normalize:29 po4a-translate:19
+msgid "Charset of the file containing the document to translate."
+msgstr ""
+
+#. type: =item
+#: po4a-gettextize:18 po4a-normalize:30 po4a-translate:20
+msgid "B<-l>, B<--localized>"
+msgstr ""
+
+#. type: textblock
+#: po4a-gettextize:19
+msgid ""
+"File containing the localized (translated) document. If you provided "
+"multiple master files, you may wish to provide multiple localized file by "
+"using this option more than once."
+msgstr ""
+
+#. type: textblock
+#: po4a-gettextize:21 po4a-translate:23
+msgid "Charset of the file containing the localized document."
+msgstr ""
+
+#. type: =item
+#: po4a-gettextize:22 po4a-translate:24 po4a-updatepo:18
+msgid "B<-p>, B<--po>"
+msgstr ""
+
+#. type: textblock
+#: po4a-gettextize:23
+msgid ""
+"File where the message catalog should be written. If not given, the message "
+"catalog will be written to the standard output."
+msgstr ""
+
+#. type: =item
+#: po4a-gettextize:28 po4a-normalize:24 po4a-translate:34 po4a-updatepo:30
+msgid "B<--help-format>"
+msgstr ""
+
+#. type: textblock
+#: po4a-gettextize:29 po4a-normalize:25 po4a-translate:35 po4a-updatepo:31
+msgid "List the documentation formats understood by po4a."
+msgstr ""
+
+#. type: =item
+#: po4a-gettextize:30
+msgid "B<-k> B<--keep-temps>"
+msgstr ""
+
+#. type: textblock
+#: po4a-gettextize:31
+msgid ""
+"Keep the temporary master and localized POT files built before merging. "
+"This can be useful to understand why these files get desynchronized, leading "
+"to gettextization problems."
+msgstr ""
+
+#. type: =head2
+#: po4a-gettextize:46
+msgid "Converting a manual translation to po4a"
+msgstr ""
+
+#. type: textblock
+#: po4a-gettextize:47
+msgid ""
+"B<po4a-gettextize> synchronizes the master and localized files to extract "
+"their content into a PO file. The content of the master file gives the "
+"B<msgid> while the content of the localized file gives the B<msgstr>. This "
+"process is somewhat fragile: the Nth string of the translated file is "
+"supposed to be the translation of the Nth string in the original."
+msgstr ""
+
+#. type: textblock
+#: po4a-gettextize:48
+msgid ""
+"Gettextization works best if you manage to retrieve the exact version of the "
+"original document that was used for translation. Even so, you may need to "
+"fiddle with both master and localized files to align their structure if it "
+"was changed by the original translator, so working on files' copies is "
+"advised."
+msgstr ""
+
+#. type: textblock
+#: po4a-gettextize:49
+msgid ""
+"Internally, each po4a parser reports the syntactical type of each extracted "
+"strings. This is how desynchronization are detected during the "
+"gettextization. In the example depicted below, it is very unlikely that the "
+"4th string in translation (of type 'chapter') is the translation of the 4th "
+"string in original (of type 'paragraph'). It is more likely that a new "
+"paragraph was added to the original, or that two original paragraphs were "
+"merged together in the translation."
+msgstr ""
+
+#. type: verbatim
+#: po4a-gettextize:50
+#, no-wrap
+msgid ""
+" Original Translation\n"
+"\n"
+msgstr ""
+
+#. type: verbatim
+#: po4a-gettextize:51
+#, no-wrap
+msgid ""
+" chapter chapter\n"
+" paragraph paragraph\n"
+" paragraph paragraph\n"
+" paragraph chapter\n"
+" chapter paragraph\n"
+" paragraph paragraph\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: po4a-gettextize:52
+msgid ""
+"B<po4a-gettextize> will verbosely diagnose any structure desynchronization. "
+"When this happens, you should manually edit the files to add fake paragraphs "
+"or remove some content here and there until the structure of both files "
+"actually match. Some tricks are given below to salvage the most of the "
+"existing translation while doing so."
+msgstr ""
+
+#. type: textblock
+#: po4a-gettextize:53
+msgid ""
+"If you are lucky enough to have a perfect match in the file structures out "
+"of the box, building a correct PO file is a matter of seconds. Otherwise, "
+"you will soon understand why this process has such an ugly name :) Even so, "
+"gettextization often remains faster than translating everything again. I "
+"gettextized the French translation of the whole Perl documentation in one "
+"day despite the I<many> synchronization issues. Given the amount of text "
+"(2MB of original text), restarting the translation without first salvaging "
+"the old translations would have required several months of work. In "
+"addition, this grunt work is the price to pay to get the comfort of po4a. "
+"Once converted, the synchronization between master documents and "
+"translations will always be fully automatic."
+msgstr ""
+
+#. type: textblock
+#: po4a-gettextize:54
+msgid ""
+"After a successful gettextization, the produced documents should be manually "
+"checked for undetected disparities and silent errors, as explained below."
+msgstr ""
+
+#. type: =head3
+#: po4a-gettextize:55
+msgid "Hints and tricks for the gettextization process"
+msgstr ""
+
+#. type: textblock
+#: po4a-gettextize:56
+msgid ""
+"The gettextization stops as soon as a desynchronization is detected. When "
+"this happens, you need to edit the files as much as needed to re-align the "
+"files' structures. B<po4a-gettextize> is rather verbose when things go "
+"wrong. It reports the strings that don't match, their positions in the text, "
+"and the type of each of them. Moreover, the PO file generated so far is "
+"dumped as F<gettextization.failed.po> for further inspection."
+msgstr ""
+
+#. type: textblock
+#: po4a-gettextize:57
+msgid ""
+"Here are some tricks to help you in this tedious process and ensure that you "
+"salvage the most of the previous translation:"
+msgstr ""
+
+#. type: textblock
+#: po4a-gettextize:58
+msgid ""
+"Remove all extra content of the translations, such as the section giving "
+"credits to the translators. They should be added separately to B<po4a> as "
+"addenda (see L<po4a(7)>)."
+msgstr ""
+
+#. type: textblock
+#: po4a-gettextize:59
+msgid ""
+"When editing the files to align their structures, prefer editing the "
+"translation if possible. Indeed, if the changes to the original are too "
+"intrusive, the old and new versions will not be matched during the first "
+"po4a run after gettextization (see below). Any unmatched translation will be "
+"dumped anyway. That being said, you still want to edit the original "
+"document if it's too hard to get the gettextization to proceed otherwise, "
+"even if it means that one paragraph of the translation is dumped. The "
+"important thing is to get a first PO file to start with."
+msgstr ""
+
+#. type: textblock
+#: po4a-gettextize:60
+msgid ""
+"Do not hesitate to kill any original content that would not exist in the "
+"translated version. This content will be automatically reintroduced "
+"afterward, when synchronizing the PO file with the document."
+msgstr ""
+
+#. type: textblock
+#: po4a-gettextize:61
+msgid ""
+"You should probably inform the original author of any structural change in "
+"the translation that seems justified. Issues in the original document should "
+"reported to the author. Fixing them in your translation only fixes them for "
+"a part of the community. Plus, it is impossible to do so when using po4a ;) "
+"But you probably want to wait until the end of the conversion to B<po4a> "
+"before changing the original files."
+msgstr ""
+
+#. type: textblock
+#: po4a-gettextize:62
+msgid ""
+"Sometimes, the paragraph content does match, but not their types. Fixing it "
+"is rather format-dependent. In POD and man, it often comes from the fact "
+"that one of them contains a line beginning with a white space while the "
+"other does not. In those formats, such paragraph cannot be wrapped and thus "
+"become a different type. Just remove the space and you are fine. It may also "
+"be a typo in the tag name in XML."
+msgstr ""
+
+#. type: textblock
+#: po4a-gettextize:63
+msgid ""
+"Likewise, two paragraphs may get merged together in POD when the separating "
+"line contains some spaces, or when there is no empty line between the "
+"B<=item> line and the content of the item."
+msgstr ""
+
+#. type: textblock
+#: po4a-gettextize:64
+msgid ""
+"Sometimes, the desynchronization message seems odd because the translation "
+"is attached to the wrong original paragraph. It is the sign of an undetected "
+"issue earlier in the process. Search for the actual desynchronization point "
+"by inspecting the file F<gettextization.failed.po> that was produced, and "
+"fix the problem where it really is."
+msgstr ""
+
+#. type: textblock
+#: po4a-gettextize:65
+msgid ""
+"Other issues may come from duplicated strings in either the original or "
+"translation. Duplicated strings are merged in PO files, with two "
+"references. This constitutes a difficulty for the gettextization algorithm, "
+"that is a simple one to one pairing between the B<msgid>s of both the master "
+"and the localized files. It is however believed that recent versions of po4a "
+"deal properly with duplicated strings, so you should report any remaining "
+"issue that you may encounter."
+msgstr ""
+
+#. type: =head2
+#: po4a-gettextize:66
+msgid "Reviewing files produced by B<po4a-gettextize>"
+msgstr ""
+
+#. type: textblock
+#: po4a-gettextize:67
+msgid ""
+"Any file produced by B<po4a-gettextize> should be manually reviewed, even "
+"when the script terminates successfully. You should skim over the PO file, "
+"ensuring that the B<msgid> and B<msgstr> actually match. It is not necessary "
+"to ensure that the translation is perfectly correct yet, as all entries are "
+"marked as fuzzy translations anyway. You only need to check for obvious "
+"matching issues because badly matched translations will be dumped in "
+"subsequent steps while you want to salvage them."
+msgstr ""
+
+#. type: textblock
+#: po4a-gettextize:68
+msgid ""
+"Fortunately, this step does not require to master the target languages as "
+"you only want to recognize similar elements in each B<msgid> and its "
+"corresponding B<msgstr>. As a speaker of French, English, and some German "
+"myself, I can do this for all European languages at least, even if I cannot "
+"say one word of most of these languages. I sometimes manage to detect "
+"matching issues in non-Latin languages by looking at string length, phrase "
+"structures (does the amount of interrogation marks match?) and other clues, "
+"but I prefer when someone else can review those languages."
+msgstr ""
+
+#. type: textblock
+#: po4a-gettextize:69
+msgid ""
+"If you detect a mismatch, edit the original and translation files as if "
+"B<po4a-gettextize> reported an error, and try again. Once you have a decent "
+"PO file for your previous translation, backup it until you get po4a working "
+"correctly."
+msgstr ""
+
+#. type: =head2
+#: po4a-gettextize:70
+msgid "Running B<po4a> for the first time"
+msgstr ""
+
+#. type: textblock
+#: po4a-gettextize:71
+msgid ""
+"The easiest way to setup po4a is to write a B<po4a.conf> configuration file, "
+"and use the integrated B<po4a> program (B<po4a-updatepo> and B<po4a-"
+"translate> are deprecated). Please check the \"CONFIGURATION FILE\" Section "
+"in L<po4a(1)> documentation for more details."
+msgstr ""
+
+#. type: textblock
+#: po4a-gettextize:72
+msgid ""
+"When B<po4a> runs for the first time, the current version of the master "
+"documents will be used to update the PO files containing the old "
+"translations that you salvaged through gettextization. This can take quite a "
+"long time, because many of the B<msgid>s of from the gettextization do not "
+"exactly match the elements of the POT file built from the recent master "
+"files. This forces gettext to search for the closest one using a costly "
+"string proximity algorithm. For example, the first run over the Perl "
+"documentation's French translation (5.5 MB PO file) took about 48 hours "
+"(yes, two days) while the subsequent ones only take seconds."
+msgstr ""
+
+#. type: =head2
+#: po4a-gettextize:73
+msgid "Moving your translations to production"
+msgstr ""
+
+#. type: textblock
+#: po4a-gettextize:74
+msgid ""
+"After this first run, the PO files are ready to be reviewed by translators. "
+"All entries were marked as fuzzy in the PO file by B<po4a-gettextization>, "
+"forcing their careful review before use. Translators should take each entry "
+"to verify that the salvaged translation actually match the current original "
+"text, update the translation on need, and remove the fuzzy markers."
+msgstr ""
+
+#. type: textblock
+#: po4a-gettextize:75
+msgid ""
+"Once enough fuzzy markers are removed, B<po4a> will start generating the "
+"translation files on disk, and you're ready to move your translation "
+"workflow to production. Some projects find it useful to rely on weblate to "
+"coordinate between translators and maintainers, but that's beyond B<po4a>' "
+"scope."
+msgstr ""
+
+#. type: textblock
+#: po4a-gettextize:77
+msgid ""
+"L<po4a(1)>, L<po4a-normalize(1)>, L<po4a-translate(1)>, L<po4a-updatepo(1)>, "
+"L<po4a(7)>."
+msgstr ""
+
+#. type: textblock
+#: po4a-normalize:2
+msgid ""
+"po4a-normalize - normalize a documentation file by parsing it in po4a, and "
+"writing it back"
+msgstr ""
+
+#. type: textblock
+#: po4a-normalize:4
+msgid "B<po4a-normalize> B<-f> I<fmt> I<master.doc>"
+msgstr ""
+
+#. type: textblock
+#: po4a-normalize:6 po4a-translate:7 po4a-updatepo:7
+#: lib/Locale/Po4a/AsciiDoc.pm:4 lib/Locale/Po4a/BibTeX.pm:4
+#: lib/Locale/Po4a/Dia.pm:4 lib/Locale/Po4a/Docbook.pm:4
+#: lib/Locale/Po4a/Guide.pm:4 lib/Locale/Po4a/Halibut.pm:4
+#: lib/Locale/Po4a/LaTeX.pm:4 lib/Locale/Po4a/Man.pm:4
+#: lib/Locale/Po4a/RubyDoc.pm:4 lib/Locale/Po4a/Sgml.pm:4
+#: lib/Locale/Po4a/TeX.pm:4 lib/Locale/Po4a/Texinfo.pm:4
+#: lib/Locale/Po4a/Text.pm:4 lib/Locale/Po4a/TransTractor.pm:4
+#: lib/Locale/Po4a/Wml.pm:4 lib/Locale/Po4a/Xhtml.pm:4 lib/Locale/Po4a/Xml.pm:4
+msgid ""
+"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."
+msgstr ""
+"A po4a (PO for anything – PO mindenhez) projekt célja, hogy megkönnyítse a "
+"fordításokat (és érdekesebb módon a fordítások karbantartását) a gettext "
+"eszközök használatával olyan területeken, ahol azok nem számítanak "
+"elvárásnak, mint például a dokumentációnál."
+
+#. type: textblock
+#: po4a-normalize:7
+msgid ""
+"The B<po4a-normalize> script is a debugging tool used to make sure that po4a "
+"don't change the document when it's not supposed to. Only use it if you're "
+"developing a new module, or if you doubt the sanity of the tools."
+msgstr ""
+
+#. type: textblock
+#: po4a-normalize:8
+msgid ""
+"The generated document will be written to F<po4a-normalize.output> while the "
+"generated POT file will be written to F<po4a-normalize.po> by default, but "
+"you can use the B<--localized> and B<--pot> options to change that."
+msgstr ""
+
+#. type: =item
+#: po4a-normalize:14
+msgid "B<-b>, B<--blank>"
+msgstr ""
+
+#. type: textblock
+#: po4a-normalize:15
+msgid ""
+"Create a blank translated document. The generated translated document will "
+"be generated assuming all messages are translated by a space or new line."
+msgstr ""
+
+#. type: textblock
+#: po4a-normalize:16
+msgid ""
+"This is useful to check what parts of the document cannot be translated."
+msgstr ""
+
+#. type: textblock
+#: po4a-normalize:17 po4a-normalize:21
+msgid ""
+"Both B<--blank> and B<--capitalize> can't be specified at the same time."
+msgstr ""
+
+#. type: =item
+#: po4a-normalize:18
+msgid "B<-C>, B<--capitalize>"
+msgstr ""
+
+#. type: textblock
+#: po4a-normalize:19
+msgid ""
+"Create a translated document and corresponding po-file with original strings "
+"translated as their capitalized versions."
+msgstr ""
+
+#. type: textblock
+#: po4a-normalize:20
+msgid ""
+"This is useful to check what parts of the document cannot be translated and "
+"generate test data for po4a."
+msgstr ""
+
+#. type: textblock
+#: po4a-normalize:31
+msgid ""
+"Name of the normalized file to produce (I<po4a-normalize.output> by default)."
+msgstr ""
+
+#. type: =item
+#: po4a-normalize:32
+msgid "B<-p>, B<--pot>"
+msgstr ""
+
+#. type: textblock
+#: po4a-normalize:33
+msgid "Pot file to produce (I<po4a-normalize.po> by default)."
+msgstr ""
+
+#. type: textblock
+#: po4a-normalize:37
+msgid ""
+"L<po4a-gettextize(1)>, L<po4a-translate(1)>, L<po4a-updatepo(1)>, L<po4a(7)>"
+msgstr ""
+
+#. type: textblock
+#: po4a-translate:2
+msgid "po4a-translate - convert a PO file back to documentation format"
+msgstr ""
+
+#. type: textblock
+#: po4a-translate:4
+msgid ""
+"B<po4a-translate> B<-f> I<fmt> B<-m> I<master.doc> B<-p> I<XX.po> B<-l> I<XX."
+"doc>"
+msgstr ""
+
+#. type: textblock
+#: po4a-translate:5
+msgid "(I<XX.doc> is the output, all others are inputs)"
+msgstr ""
+
+#. type: textblock
+#: po4a-translate:8
+msgid ""
+"The B<po4a-translate> script is in charge of converting the translation "
+"(which was done in a PO file) back into the documentation format. The "
+"provided PO file should be the translation of the POT file which was "
+"produced by L<po4a-gettextize(1)>."
+msgstr ""
+
+#. type: =item
+#: po4a-translate:12
+msgid "B<-a>, B<--addendum>"
+msgstr ""
+
+#. type: textblock
+#: po4a-translate:13
+msgid ""
+"Add a file to the resulting file (to put translator's name or a section "
+"\"About this translation\", for example). The first line of the file to "
+"insert should be a PO4A header indicating where it should be added (see "
+"section B<HOWTO add extra text to translations> in L<po4a(7)>)."
+msgstr ""
+
+#. type: textblock
+#: po4a-translate:17
+msgid "File containing the master document to translate."
+msgstr ""
+
+#. type: textblock
+#: po4a-translate:21
+msgid "File where the localized (translated) document should be written."
+msgstr ""
+
+#. type: textblock
+#: po4a-translate:25
+msgid "File from which the message catalog should be read."
+msgstr ""
+
+#. type: textblock
+#: po4a-translate:29
+msgid ""
+"Minimal threshold for translation percentage to keep (i.e. write) the "
+"resulting file (default: 80). I.e. by default, files have to be translated "
+"at least at 80% to get written."
+msgstr ""
+
+#. type: =item
+#: po4a-translate:42 po4a-updatepo:38
+msgid "B<--porefs> I<type>[,B<wrap>|B<nowrap>]"
+msgstr ""
+
+#. type: textblock
+#: po4a-translate:44 po4a-updatepo:40
+msgid ""
+"Argument can be followed by a comma and either B<wrap> or B<nowrap> "
+"keyword. References are written by default on a single line. The B<wrap> "
+"option wraps references on several lines, to mimic B<gettext> tools "
+"(B<xgettext> and B<msgmerge>). This option will become the default in a "
+"future release, because it is more sensible. The B<nowrap> option is "
+"available so that users who want to keep the old behavior can do so."
+msgstr ""
+
+#. type: =head1
+#: po4a-translate:45
+msgid "Adding content (beside translations) to generated files"
+msgstr ""
+
+#. type: textblock
+#: po4a-translate:46
+msgid ""
+"To add some extra content to the generated document beside what you "
+"translated (like the name of the translator, or an \"About this "
+"translation\" section), you should use the B<--addendum> option."
+msgstr ""
+
+#. type: textblock
+#: po4a-translate:47
+msgid ""
+"The first line of the addendum must be a header indicating where to put it "
+"in the document (it can be before or after a given part of the document). "
+"The rest of the file will be added verbatim to the resulting file without "
+"further processing."
+msgstr ""
+
+#. type: textblock
+#: po4a-translate:48
+msgid ""
+"Note that if po4a-translate fails to add one of the given files, it discards "
+"the whole translation (because the missing file could be the one indicating "
+"the author, what would prevent the users to contact him to report bugs in "
+"the translation)."
+msgstr ""
+
+#. type: textblock
+#: po4a-translate:49
+msgid ""
+"The header has a pretty rigid syntax. For more information on how to use "
+"this feature and how it works, please refer to the L<po4a(7)> man page."
+msgstr ""
+
+#. type: textblock
+#: po4a-translate:51
+msgid ""
+"L<po4a-gettextize(1)>, L<po4a-normalize(1)>, L<po4a-updatepo(1)>, L<po4a(7)>"
+msgstr ""
+
+#. type: textblock
+#: po4a-updatepo:2
+msgid "po4a-updatepo - update the translation (in PO format) of documentation"
+msgstr ""
+
+#. type: textblock
+#: po4a-updatepo:4
+msgid "B<po4a-updatepo> B<-f> I<fmt> (B<-m> I<master.doc>)+ (B<-p> I<XX.po>)+"
+msgstr ""
+
+#. type: textblock
+#: po4a-updatepo:5
+msgid "(I<XX.po> are the outputs, all others are inputs)"
+msgstr ""
+
+#. type: textblock
+#: po4a-updatepo:8
+msgid ""
+"The B<po4a-updatepo> script is in charge of updating PO files to make them "
+"reflect the changes made to the original documentation file. For that, it "
+"converts the documentation file to a POT file, and call L<msgmerge(1)> on "
+"this new POT and on the provided PO files."
+msgstr ""
+
+#. type: textblock
+#: po4a-updatepo:9
+msgid ""
+"It is possible to give more than one PO file (if you want to update several "
+"languages at once), and several documentation files (if you want to store "
+"the translations of several documents in the same PO file)."
+msgstr ""
+
+#. type: textblock
+#: po4a-updatepo:10
+msgid ""
+"If the master document has non-ASCII characters, this script will convert "
+"the PO files to UTF-8 (if they weren't already), for a transparent handling "
+"of non-standard characters."
+msgstr ""
+
+#. type: textblock
+#: po4a-updatepo:15
+msgid "File(s) containing the master document to translate."
+msgstr ""
+
+#. type: textblock
+#: po4a-updatepo:17
+msgid ""
+"Charset of the files containing the document to translate. Note that all "
+"files must have the same charset."
+msgstr ""
+
+#. type: textblock
+#: po4a-updatepo:19
+msgid ""
+"PO file(s) to update. If these files do not exist, they are created by "
+"B<po4a-updatepo>."
+msgstr ""
+
+#. type: textblock
+#: po4a-updatepo:23
+msgid ""
+"This option removes B<--previous> from the options passed to B<msgmerge>. "
+"This helps supporting old versions of B<gettext> (before v0.16)."
+msgstr ""
+
+#. type: textblock
+#: po4a-updatepo:43
+msgid ""
+"Historically, the gettext suite has reformatted the po files at the 77th "
+"column for cosmetics. This option specifies the behavior of po4a. If set to "
+"a numerical value, po4a will wrap the po file after this column and after "
+"newlines in the content. If set to B<newlines>, po4a will only split the "
+"msgid and msgstr after newlines in the content. If set to B<no>, po4a will "
+"not wrap the po file at all. The wrapping of the reference comments is "
+"controlled by the B<--porefs> option."
+msgstr ""
+
+#. type: textblock
+#: po4a-updatepo:54
+msgid ""
+"L<po4a-gettextize(1)>, L<po4a-normalize(1)>, L<po4a-translate(1)>, L<po4a(7)>"
+msgstr ""
+
+#. type: textblock
+#: msguntypot:2
+msgid "msguntypot - update PO files when a typo is fixed in POT file"
+msgstr ""
+
+#. type: textblock
+#: msguntypot:4
+msgid "B<msguntypot> B<-o> I<old_pot> B<-n> I<new_pot> I<pofiles> ..."
+msgstr ""
+
+#. type: textblock
+#: msguntypot:6
+msgid ""
+"When you fix a trivial error which surely doesn't affect translations (e.g. "
+"a typo) in a POT file, you should unfuzzy the corresponding msgstr in the "
+"translated PO files to avoid so extra work to the translators."
+msgstr ""
+
+#. type: textblock
+#: msguntypot:7
+msgid ""
+"This task is difficult and error prone when done manually, and this tool is "
+"there to help doing so correctly. You just need to provide the two versions "
+"of the POT file: before the edition and after as marked in the above "
+"synopsis, and it all becomes automatic."
+msgstr ""
+
+#. type: =head1
+#: msguntypot:8
+msgid "HOW TO USE IT"
+msgstr ""
+
+#. type: textblock
+#: msguntypot:9
+msgid ""
+"In short, when you discover a typo in one of your [english] message, do the "
+"following:"
+msgstr ""
+
+#. type: =item
+#: msguntypot:10 msguntypot:19
+msgid "- Regenerate your POT and PO files."
+msgstr ""
+
+#. type: verbatim
+#: msguntypot:11
+#, no-wrap
+msgid ""
+" make -C po/ update-po # for message program translations\n"
+" debconf-updatepo # for debconf translations\n"
+" po4a po4a.conf # for po4a based documentation translations\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: msguntypot:12
+msgid ""
+"or something else, depending on your project's building settings. You know "
+"how to make sure your POT and PO files are uptodate, don't you??"
+msgstr ""
+
+#. type: =item
+#: msguntypot:13
+msgid "- Make a copy of your POT file."
+msgstr ""
+
+#. type: verbatim
+#: msguntypot:14
+#, no-wrap
+msgid ""
+" cp myfile.pot myfile.pot.orig\n"
+"\n"
+msgstr ""
+
+#. type: =item
+#: msguntypot:15
+msgid "- Make a copy of all your PO files."
+msgstr ""
+
+#. type: verbatim
+#: msguntypot:16
+#, no-wrap
+msgid ""
+" mkdir po_fridge; cp *.po po_fridge\n"
+"\n"
+msgstr ""
+
+#. type: =item
+#: msguntypot:17
+msgid "- Fix your typo."
+msgstr ""
+
+#. type: textblock
+#: msguntypot:18
+msgid "$EDITOR the_file_in_which_there_is_a_typo"
+msgstr ""
+
+#. type: textblock
+#: msguntypot:20
+msgid "See above."
+msgstr ""
+
+#. type: textblock
+#: msguntypot:21
+msgid ""
+"At this point, the typo fix fuzzied all the translations, and this "
+"unfortunate change is the only one between the PO files of your main "
+"directory and the one from the fridge. Here is how to solve this."
+msgstr ""
+
+#. type: =item
+#: msguntypot:22
+msgid "- Discard fuzzy translation, restore the ones from the fridge."
+msgstr ""
+
+#. type: verbatim
+#: msguntypot:23
+#, no-wrap
+msgid ""
+" cp po_fridge/*.po .\n"
+"\n"
+msgstr ""
+
+#. type: =item
+#: msguntypot:24
+msgid ""
+"- Manually merge the PO files with the new POT file, but taking the useless "
+"fuzzy into account."
+msgstr ""
+
+#. type: verbatim
+#: msguntypot:25
+#, no-wrap
+msgid ""
+" msguntypot -o myfile.pot.orig -n myfile.pot *.po\n"
+"\n"
+msgstr ""
+
+#. type: =item
+#: msguntypot:26
+msgid "- Cleanups."
+msgstr ""
+
+#. type: verbatim
+#: msguntypot:27
+#, no-wrap
+msgid ""
+" rm -rf myfile.pot.orig po_fridge\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: msguntypot:28
+msgid ""
+"You're done. The typo was eradicated from msgstr of both your POT and PO "
+"files, and the PO files were not fuzzyied in the process. Your translators "
+"love you already."
+msgstr ""
+
+#. type: textblock
+#: msguntypot:30
+msgid ""
+"Despite its name, this tool is not part of the gettext tool suite. It is "
+"instead part of po4a. More precisely, it's a random Perl script using the "
+"fine po4a modules. For more information about po4a, please see:"
+msgstr ""
+
+#. type: textblock
+#: msguntypot:31
+msgid "L<po4a(7)>"
+msgstr ""
+
+#. type: verbatim
+#: msguntypot:33
+#, no-wrap
+msgid ""
+" Martin Quinson (mquinson#debian,org)\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: msguntypot:35
+msgid "Copyright 2005 by SPI, inc."
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:2
+msgid "po4a - framework to translate documentation and other materials"
+msgstr ""
+
+#. type: =head1
+#: doc/po4a.7.pod:3
+msgid "Introduction"
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:4
+msgid ""
+"po4a (PO for anything) eases the maintenance of documentation translation "
+"using the classical gettext tools. The main feature of po4a is that it "
+"decouples the translation of content from its document structure."
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:5
+msgid ""
+"This document serves as an introduction to the po4a project with a focus on "
+"potential users considering whether to use this tool and on the curious "
+"wanting to understand why things are the way they are."
+msgstr ""
+
+#. type: =head1
+#: doc/po4a.7.pod:6
+msgid "Why po4a?"
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:7
+msgid ""
+"The philosophy of Free Software is to make the technology truly available to "
+"everyone. But licensing is not the only consideration: untranslated free "
+"software is useless for non-English speakers. Therefore, we still have some "
+"work to do to make software available to everybody."
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:8
+msgid ""
+"This situation is well understood by most projects and everybody is now "
+"convinced of the necessity to translate everything. Yet, the actual "
+"translations represent a huge effort of many individuals, crippled by small "
+"technical difficulties."
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:9
+msgid ""
+"Thankfully, Open Source software is actually very well translated using the "
+"gettext tool suite. These tools are used to extract the strings to translate "
+"from a program and present the strings to translate in a standardized format "
+"(called PO files, or translation catalogs). A whole ecosystem of tools has "
+"emerged to help the translators actually translate these PO files. The "
+"result is then used by gettext at run time to display translated messages to "
+"the end users."
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:10
+msgid ""
+"Regarding documentation, however, the situation still somewhat "
+"disappointing. At first translating documentation may seem to be easier "
+"than translating a program as it would seem that you just have to copy the "
+"documentation source file and start translating the content. However, when "
+"the original documentation is modified, keeping track of the modifications "
+"quickly turns into a nightmare for the translators. If done manually, this "
+"task is unpleasant and error-prone."
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:11
+msgid ""
+"Outdated translations are often worse than no translation at all. End-users "
+"can be tricked by documentation describing an old behavior of the program. "
+"Furthermore, they cannot interact directly with the maintainers since they "
+"don't speak English. Additionally, the maintainer cannot fix the problem as "
+"they don't know every language in which their documentation is translated. "
+"These difficulties, often caused by poor tooling, can undermine the "
+"motivation of volunteer translators, further aggravating the problem."
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:12
+msgid ""
+"B<The goal of the po4a project is to ease the work of documentation "
+"translators>. In particular, it makes documentation translations "
+"I<maintainable>."
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:13
+msgid ""
+"The idea is to reuse and adapt the gettext approach to this field. As with "
+"gettext, texts are extracted from their original locations and presented to "
+"translators as PO translation catalogs. The translators can leverage the "
+"classical gettext tools to monitor the work to do, collaborate and organize "
+"as teams. po4a then injects the translations directly into the documentation "
+"structure to produce translated source files that can be processed and "
+"distributed just like the English files. Any paragraph that is not "
+"translated is left in English in the resulting document, ensuring that the "
+"end users never see an outdated translation in the documentation."
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:14
+msgid ""
+"This automates most of the grunt work of the translation maintenance. "
+"Discovering the paragraphs needing an update becomes very easy, and the "
+"process is completely automated when elements are reordered without further "
+"modification. Specific verification can also be used to reduce the chance of "
+"formatting errors that would result in a broken document."
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:15
+msgid ""
+"Please also see the B<FAQ> below in this document for a more complete list "
+"of the advantages and disadvantages of this approach."
+msgstr ""
+
+#. type: =head2
+#: doc/po4a.7.pod:16
+msgid "Supported formats"
+msgstr "Támogatott formátumok"
+
+#. type: textblock
+#: doc/po4a.7.pod:17
+msgid ""
+"Currently, this approach has been successfully implemented to several kinds "
+"of text formatting formats:"
+msgstr ""
+
+#. type: =item
+#: doc/po4a.7.pod:18
+msgid "man (mature parser)"
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:19
+msgid ""
+"The good old manual pages' format, used by so many programs out there. po4a "
+"support is very welcome here since this format is somewhat difficult to use "
+"and not really friendly to newbies."
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:20
+msgid ""
+"The L<Locale::Po4a::Man(3pm)|Man> module also supports the mdoc format, used "
+"by the BSD man pages (they are also quite common on Linux)."
+msgstr ""
+
+#. type: =item
+#: doc/po4a.7.pod:21
+msgid "AsciiDoc (mature parser)"
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:22
+msgid ""
+"This format is a lightweight markup format intended to ease the authoring of "
+"documentation. It is for example used to document the git system. Those "
+"manpages are translated using po4a."
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:23
+msgid "See L<Locale::Po4a::AsciiDoc> for details."
+msgstr ""
+
+#. type: =item
+#: doc/po4a.7.pod:24
+msgid "pod (mature parser)"
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:25
+msgid ""
+"This is the Perl Online Documentation format. The language and extensions "
+"themselves are documented using this format in addition to most existing "
+"Perl scripts. It makes easy to keep the documentation close to the actual "
+"code by embedding them both in the same file. It makes programmer's life "
+"easier, but unfortunately, not the translator's, until you use po4a."
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:26
+msgid "See L<Locale::Po4a::Pod> for details."
+msgstr ""
+
+#. type: =item
+#: doc/po4a.7.pod:27
+msgid "sgml (mature parser)"
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:28
+msgid ""
+"Even if superseded by XML nowadays, this format is still used for documents "
+"which are more than a few screens long. It can even be used for complete "
+"books. Documents of this length can be very challenging to update. B<diff> "
+"often reveals useless when the original text was re-indented after update. "
+"Fortunately, po4a can help you after that process."
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:29
+msgid ""
+"Currently, only DebianDoc and DocBook DTD are supported, but adding support "
+"for a new one is really easy. It is even possible to use po4a on an unknown "
+"SGML DTD without changing the code by providing the needed information on "
+"the command line. See L<Locale::Po4a::Sgml(3pm)> for details."
+msgstr ""
+
+#. type: =item
+#: doc/po4a.7.pod:30
+msgid "TeX / LaTeX (mature parser)"
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:31
+msgid ""
+"The LaTeX format is a major documentation format used in the Free Software "
+"world and for publications."
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:32
+msgid ""
+"The L<Locale::Po4a::LaTeX(3pm)|LaTeX> module was tested with the Python "
+"documentation, a book and some presentations."
+msgstr ""
+
+#. type: =item
+#: doc/po4a.7.pod:33
+msgid "text (mature parser)"
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:34
+msgid ""
+"The Text format is the base format for many formats that include long blocks "
+"of text, including Markdown, fortunes, YAML front matter section, debian/"
+"changelog, and debian/control."
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:35
+msgid ""
+"This supports the common format used in Static Site Generators, READMEs, and "
+"other documentation systems. See L<Locale::Po4a::Text(3pm)|Text> for details."
+msgstr ""
+
+#. type: =item
+#: doc/po4a.7.pod:36
+msgid "xml and XHMTL (probably mature parser)"
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:37
+msgid "The XML format is a base format for many documentation formats."
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:38
+msgid ""
+"Currently, the DocBook DTD (see L<Locale::Po4a::Docbook(3pm)> for details) "
+"and XHTML are supported by po4a."
+msgstr ""
+
+#. type: =item
+#: doc/po4a.7.pod:39
+msgid "BibTex (probably mature parser)"
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:40
+msgid ""
+"The BibTex format is used alongside LaTex for formatting lists of references "
+"(bibliographies)."
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:41
+msgid "See L<Locale::Po4a::BibTex> for details."
+msgstr ""
+
+#. type: =item
+#: doc/po4a.7.pod:42
+msgid "Docbook (probably mature parser)"
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:43
+msgid ""
+"A XML-based markup language that uses semantic tags to describe documents."
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:44
+msgid "See L<Locale::Po4a:Docbook> for greater details."
+msgstr ""
+
+#. type: =item
+#: doc/po4a.7.pod:45
+msgid "Guide XML (probably mature parser)"
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:46
+msgid ""
+"A XML documentation format. This module was developed specifically to help "
+"with supporting and maintaining translations of Gentoo Linux documentation "
+"up until at least March 2016 (Based on the Wayback Machine). Gentoo have "
+"since moved to the DevBook XML format."
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:47
+msgid "See L<Locale::Po4a:Guide> for greater details."
+msgstr ""
+
+#. type: =item
+#: doc/po4a.7.pod:48
+msgid "Wml (probably mature parser)"
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:49
+msgid ""
+"The Web Markup Language, do not mixup WML with the WAP stuff used on cell "
+"phones. This module relies on the Xhtml module, which itself relies on the "
+"XmL module."
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:50
+msgid "See L<Locale::Po4a::Wml> for greater details."
+msgstr ""
+
+#. type: =item
+#: doc/po4a.7.pod:51
+msgid "Yaml (probably mature parser)"
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:52
+msgid ""
+"A strict superset of JSON. YAML is often used as systems or configuration "
+"projects. YAML is at the core of Red Hat's Ansible."
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:53
+msgid "See L<Locale::Po4a::Yaml> for greater details."
+msgstr ""
+
+#. type: =item
+#: doc/po4a.7.pod:54
+msgid "RubyDoc (probably mature parser)"
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:55
+msgid ""
+"The Ruby Document (RD) format, originally the default documentation format "
+"for Ruby and Ruby projects before converted to RDoc in 2002. Though "
+"apparently the Japanese version of the Ruby Reference Manual still use RD."
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:56
+msgid "See L<Locale::Po4a::RubyDoc> for greater details."
+msgstr ""
+
+#. type: =item
+#: doc/po4a.7.pod:57
+msgid "Halibut (probably experimental parser)"
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:58
+msgid ""
+"A documentation production system, with elements similar to TeX, debiandoc-"
+"sgml, TeXinfo, and others, developed by Simon Tatham, the developer of PuTTY."
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:59
+msgid "See L<Locale::Po4a:Halibut> for greater details."
+msgstr ""
+
+#. type: =item
+#: doc/po4a.7.pod:60
+msgid "Ini (probably experimental parser)"
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:61
+msgid "Configuration file format popularized by MS-DOS."
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:62
+msgid "See L<Locale::Po4a::Ini> for greater details."
+msgstr ""
+
+#. type: =item
+#: doc/po4a.7.pod:63
+msgid "texinfo (very highly experimental parser)"
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:64
+msgid ""
+"All of the GNU documentation is written in this format (it's even one of the "
+"requirements to become an official GNU project). The support for L<Locale::"
+"Po4a::Texinfo(3pm)|Texinfo> in po4a is still at the beginning. Please "
+"report bugs and feature requests."
+msgstr ""
+
+#. type: =item
+#: doc/po4a.7.pod:65
+msgid "gemtext (very highly experimental parser)"
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:66
+msgid ""
+"The native plain text format of the Gemini protocol. The extension \".gmi\" "
+"is commonly used. Support for this module in po4a is still in its infancy. "
+"If you find anything, please file a bug or feature request."
+msgstr ""
+
+#. type: =item
+#: doc/po4a.7.pod:67
+#, fuzzy
+#| msgid "Supported formats"
+msgid "Others supported formats"
+msgstr "Támogatott formátumok"
+
+#. type: textblock
+#: doc/po4a.7.pod:68
+msgid ""
+"Po4a can also handle some more rare or specialized formats, such as the "
+"documentation of compilation options for the 2.4+ Linux kernels (L<Locale::"
+"Po4a::KernelHelp>) or the diagrams produced by the dia tool (L<Locale::Po4a:"
+"Dia>). Adding a new format is often very easy and the main task is to come "
+"up with a parser for your target format. See L<Locale::Po4a::"
+"TransTractor(3pm)> for more information about this."
+msgstr ""
+
+#. type: =item
+#: doc/po4a.7.pod:69
+msgid "Unsupported formats"
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:70
+msgid ""
+"Unfortunately, po4a still lacks support for several documentation formats. "
+"Many of them would be easy to support in po4a. This includes formats not "
+"just used for documentation, such as, package descriptions (deb and rpm), "
+"package installation scripts questions, package changelogs, and all the "
+"specialized file formats used by programs such as game scenarios or wine "
+"resource files."
+msgstr ""
+
+#. type: =head1
+#: doc/po4a.7.pod:71
+msgid "Using po4a"
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:72
+msgid ""
+"The easiest way to use this tool in your project is to write a configuration "
+"file for the B<po4a> program, and only interact with this program. Please "
+"refer to its documentation, in L<po4a(1)>. The rest of this section provides "
+"more details for the advanced users of po4a wanting to deepen their "
+"understanding."
+msgstr ""
+
+#. type: =head2
+#: doc/po4a.7.pod:73
+msgid "Detailed schema of the po4a workflow"
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:74
+msgid ""
+"Make sure to read L<po4a(1)> before this overly detailed section to get a "
+"simplified overview of the po4a workflow. Come back here when you want to "
+"get the full scary picture, with almost all details."
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:75
+msgid ""
+"In the following schema, F<master.doc> is an example name for the "
+"documentation to be translated; F<XX.doc> is the same document translated in "
+"the language XX while F<doc.XX.po> is the translation catalog for that "
+"document in the XX language. Documentation authors will mostly be concerned "
+"with F<master.doc> (which can be a manpage, an XML document, an AsciidDoc "
+"file, etc); the translators will be mostly concerned with the PO file, while "
+"the end users will only see the F<XX.doc> file."
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:76
+msgid ""
+"Transitions with square brackets such as C<[po4a updates po]> represent the "
+"execution of a po4a tool while transitions with curly brackets such as "
+"C<{update of master.doc}> represent a manual modification of the project's "
+"files."
+msgstr ""
+
+#. type: verbatim
+#: doc/po4a.7.pod:77
+#, no-wrap
+msgid ""
+" master.doc\n"
+" |\n"
+" V\n"
+" +<-----<----+<-----<-----<--------+------->-------->-------+\n"
+" : | | :\n"
+"{translation} | {update of master.doc} :\n"
+" : | | :\n"
+" XX.doc | V V\n"
+" (optional) | master.doc ->-------->------>+\n"
+" : | (new) |\n"
+" V V | |\n"
+" [po4a-gettextize] doc.XX.po -->+ | |\n"
+" | (old) | | |\n"
+" | ^ V V |\n"
+" | | [po4a updates po] |\n"
+" V | | V\n"
+" translation.pot ^ V |\n"
+" | | doc.XX.po |\n"
+" | | (fuzzy) |\n"
+" {translation} | | |\n"
+" | ^ V V\n"
+" | | {manual editing} |\n"
+" | | | |\n"
+" V | V V\n"
+" doc.XX.po --->---->+<---<-- doc.XX.po addendum master.doc\n"
+" (initial) (up-to-date) (optional) (up-to-date)\n"
+" : | | |\n"
+" : V | |\n"
+" +----->----->----->------> + | |\n"
+" | | |\n"
+" V V V\n"
+" +------>-----+------<------+\n"
+" |\n"
+" V\n"
+" [po4a updates translations]\n"
+" |\n"
+" V\n"
+" XX.doc\n"
+" (up-to-date)\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:78
+msgid ""
+"Again, this schema is overly complicated. Check on L<po4a(1)> for a "
+"simplified overview."
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:79
+msgid ""
+"The left part depicts how L<po4a-gettextize(1)> can be used to convert an "
+"existing translation project to the po4a infrastructure. This script takes "
+"an original document and its translated counterpart, and tries to build the "
+"corresponding PO file. Such manual conversion is rather cumbersome (see the "
+"L<po4a-gettextize(1)> documentation for more details), but it is only needed "
+"once to convert your existing translations. If you don't have any "
+"translation to convert, you can forget about this and focus on the right "
+"part of the schema."
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:80
+msgid ""
+"On the top right part, the action of the original author is depicted, "
+"updating the documentation. The middle right part depicts the automatic "
+"updates of translation files: the new material is extracted and compared "
+"against the exiting translation. The previous translation is used for the "
+"parts that didn't change, while partially modified parts are connected to "
+"the previous translation with a \"fuzzy\" marker indicating that the "
+"translation must be updated. New or heavily modified material is left "
+"untranslated."
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:81
+msgid ""
+"Then, the I<manual editing> block depicts the action of the translators, "
+"that modify the PO files to provide translations to every original string "
+"and paragraph. This can be done using either a specific editor such as the "
+"B<GNOME Translation Editor>, KDE's B<Lokalize> or B<poedit>, or using an "
+"online localization platform such as B<weblate> or B<pootle>. The "
+"translation result is a set of PO files, one per language. Please refer to "
+"the gettext documentation for more details."
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:82
+msgid ""
+"The bottom part of the figure shows how B<po4a> creates a translated source "
+"document from the F<master.doc> original document and the F<doc.XX.po> "
+"translation catalog that was updated by the translators. The structure of "
+"the document is reused, while the original content is replaced by its "
+"translated counterpart. Optionally, an addendum can be used to add some "
+"extra text to the translation. This is often used to add the name of the "
+"translator to the final document. See below for details."
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:83
+msgid ""
+"Upon invocation, B<po4a> updates both the translation files and the "
+"translated documentation files automatically."
+msgstr ""
+
+#. type: =head2
+#: doc/po4a.7.pod:84
+msgid "Starting a new translation project"
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:85
+msgid ""
+"If you start from scratch, you just have to write a configuration file for "
+"po4a, and you are set. The relevant templates are created for the missing "
+"files, allowing your contributors to translate your project to their "
+"language. Please refer to L<po4a(1)> for a quick start tutorial and for all "
+"details."
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:86
+msgid ""
+"If you have an existing translation, i.e. a documentation file that was "
+"translated manually, you can integrate its content in your po4a workflow "
+"using B<po4a-gettextize>. This task is a bit cumbersome (as described in the "
+"tool's manpage), but once your project is converted to po4a workflow, "
+"everything will be updated automatically."
+msgstr ""
+
+#. type: =head2
+#: doc/po4a.7.pod:87
+msgid "Updating the translations and documents"
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:88
+msgid ""
+"Once setup, invoking B<po4a> is enough to update both the translation PO "
+"files and translated documents. You may pass the C<--no-translations> to "
+"B<po4a> to not update the translations (thus only updating the PO files) or "
+"C<--no-update> to not update the PO files (thus only updating the "
+"translations). This roughly corresponds to the individual B<po4a-updatepo> "
+"and B<po4a-translate> scripts which are now deprecated (see \"Why are the "
+"individual scripts deprecated\" in the FAQ below)."
+msgstr ""
+
+#. type: =head2
+#: doc/po4a.7.pod:89
+msgid "Using addenda to add extra text to translations"
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:90
+msgid ""
+"Adding new text to the translation is probably the only thing that is easier "
+"in the long run when you translate files manually :). This happens when you "
+"want to add an extra section to the translated document, not corresponding "
+"to any content in the original document. The classical use case is to give "
+"credits to the translation team, and to indicate how to report translation-"
+"specific issues."
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:91
+msgid ""
+"With po4a, you have to specify B<addendum> files, that can be conceptually "
+"viewed as patches applied to the localized document after processing. Each "
+"addendum must be provided as a separate file, which format is however very "
+"different from the classical patches. The first line is a I<header line>, "
+"defining the insertion point of the addendum (with an unfortunately cryptic "
+"syntax -- see below) while the rest of the file is added verbatim at the "
+"determined position."
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:92
+msgid ""
+"The header line must begin with the string B<PO4A-HEADER:>, followed by a "
+"semi-colon separated list of I<key>B<=>I<value> fields."
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:93
+msgid ""
+"For example, the following header declares an addendum that must be placed "
+"at the very end of the translation."
+msgstr ""
+
+#. type: verbatim
+#: doc/po4a.7.pod:94
+#, no-wrap
+msgid ""
+" PO4A-HEADER: mode=eof\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:95
+msgid ""
+"Things are more complex when you want to add your extra content in the "
+"middle of the document. The following header declares an addendum that must "
+"be placed after the XML section containing the string C<About this document> "
+"in translation."
+msgstr ""
+
+#. type: verbatim
+#: doc/po4a.7.pod:96
+#, no-wrap
+msgid ""
+" PO4A-HEADER: position=About this document; mode=after; endboundary=</section>\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:97
+msgid ""
+"In practice, when trying to apply an addendum, po4a searches for the first "
+"line matching the C<position> argument (this can be a regexp). Do not forget "
+"that po4a considers the B<translated> document here. This documentation is "
+"in English, but your line should probably read as follows if you intend your "
+"addendum to apply to the French translation of the document."
+msgstr ""
+
+#. type: verbatim
+#: doc/po4a.7.pod:98
+#, no-wrap
+msgid ""
+" PO4A-HEADER: position=À propos de ce document; mode=after; endboundary=</section>\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:99
+msgid ""
+"Once the C<position> is found in the target document, po4a searches for the "
+"next line after the C<position> that matches the provided C<endboundary>. "
+"The addendum is added right B<after> that line (because we provided an "
+"I<endboundary>, i.e. a boundary ending the current section)."
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:100
+msgid ""
+"The exact same effect could be obtained with the following header, that is "
+"equivalent:"
+msgstr ""
+
+#. type: verbatim
+#: doc/po4a.7.pod:101
+#, no-wrap
+msgid ""
+" PO4A-HEADER: position=About this document; mode=after; beginboundary=<section>\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:102
+msgid ""
+"Here, po4a searches for the first line matching C<< <section> >> after the "
+"line matching C<About this document> in the translation, and add the "
+"addendum B<before> that line since we provided a I<beginboundary>, i.e. a "
+"boundary marking the beginning of the next section. So this header line "
+"requires placing the addendum after the section containing C<About this "
+"document>, and instruct po4a that a section starts with a line containing "
+"the C<< <section> >> tag. This is equivalent to the previous example because "
+"what you really want is to add this addendum either after C<< </section> >> "
+"or before C<< <section> >>."
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:103
+msgid ""
+"You can also set the insertion I<mode> to the value C<before>, with a "
+"similar semantic: combining C<mode=before> with an C<endboundary> will put "
+"the addendum just B<after> the matched boundary, that is the last potential "
+"boundary line before the C<position>. Combining C<mode=before> with an "
+"C<beginboundary> will put the addendum just B<before> the matched boundary, "
+"that is the last potential boundary line before the C<position>."
+msgstr ""
+
+#. type: verbatim
+#: doc/po4a.7.pod:104
+#, no-wrap
+msgid ""
+" Mode | Boundary kind | Used boundary | Insertion point compared to the boundary\n"
+" ========|===============|========================|=========================================\n"
+" 'before'| 'endboundary' | last before 'position' | Right after the selected boundary\n"
+" 'before'|'beginboundary'| last before 'position' | Right before the selected boundary\n"
+" 'after' | 'endboundary' | first after 'position' | Right after the selected boundary\n"
+" 'after' |'beginboundary'| first after 'position' | Right before the selected boundary\n"
+" 'eof' | (none) | n/a | End of file\n"
+"\n"
+msgstr ""
+
+#. type: =head3
+#: doc/po4a.7.pod:105
+msgid "Hint and tricks about addenda"
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:106
+msgid ""
+"Remember that these are regexp. For example, if you want to match the end of "
+"a nroff section ending with the line C<.fi>, do not use C<.fi> as "
+"B<endboundary>, because it will match with C<the[ fi]le>, which is obviously "
+"not what you expect. The correct B<endboundary> in that case is: C<^\\.fi$>."
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:107
+msgid ""
+"White spaces ARE important in the content of the C<position> and boundaries. "
+"So the two following lines B<are different>. The second one will only be "
+"found if there is enough trailing spaces in the translated document."
+msgstr ""
+
+#. type: verbatim
+#: doc/po4a.7.pod:108
+#, no-wrap
+msgid ""
+" PO4A-HEADER: position=About this document; mode=after; beginboundary=<section>\n"
+" PO4A-HEADER: position=About this document ; mode=after; beginboundary=<section>\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:109
+msgid ""
+"Although this context search may be considered to operate roughly on each "
+"line of the B<translated> document, it actually operates on the internal "
+"data string of the translated document. This internal data string may be a "
+"text spanning a paragraph containing multiple lines or may be a XML tag "
+"itself alone. The exact I<insertion point> of the addendum must be before or "
+"after the internal data string and can not be within the internal data "
+"string."
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:110
+msgid ""
+"Pass the C<-vv> argument to B<po4a> to understand how the addenda are added "
+"to the translation. It may also help to run B<po4a> in debug mode to see the "
+"actual internal data string when your addendum does not apply."
+msgstr ""
+
+#. type: =head3
+#: doc/po4a.7.pod:111
+msgid "Addenda examples"
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:112
+msgid "If you want to add something after the following nroff section:"
+msgstr ""
+
+#. type: verbatim
+#: doc/po4a.7.pod:113
+#, no-wrap
+msgid ""
+" .SH \"AUTHORS\"\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:114
+msgid ""
+"You should select a two-step approach by setting B<mode=after>. Then you "
+"should narrow down search to the line after B<AUTHORS> with the B<position> "
+"argument regex. Then, you should match the beginning of the next section (i."
+"e., B<^\\.SH>) with the B<beginboundary> argument regex. That is to say:"
+msgstr ""
+
+#. type: verbatim
+#: doc/po4a.7.pod:115
+#, no-wrap
+msgid ""
+" PO4A-HEADER:mode=after;position=AUTHORS;beginboundary=\\.SH\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:116
+msgid ""
+"If you want to add something right after a given line (e.g. after the line "
+"\"Copyright Big Dude\"), use a B<position> matching this line, B<mode=after> "
+"and give a B<beginboundary> matching any line."
+msgstr ""
+
+#. type: verbatim
+#: doc/po4a.7.pod:117
+#, no-wrap
+msgid ""
+" PO4A-HEADER:mode=after;position=Copyright Big Dude, 2004;beginboundary=^\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:118
+msgid ""
+"If you want to add something at the end of the document, give a B<position> "
+"matching any line of your document (but only one line. Po4a won't proceed if "
+"it's not unique), and give an B<endboundary> matching nothing. Don't use "
+"simple strings here like B<\"EOF\">, but prefer those which have less chance "
+"to be in your document."
+msgstr ""
+
+#. type: verbatim
+#: doc/po4a.7.pod:119
+#, no-wrap
+msgid ""
+" PO4A-HEADER:mode=after;position=About this document;beginboundary=FakePo4aBoundary\n"
+"\n"
+msgstr ""
+
+#. type: =head3
+#: doc/po4a.7.pod:120
+msgid "More detailed example"
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:121
+msgid "Original document (POD formatted):"
+msgstr ""
+
+#. type: verbatim
+#: doc/po4a.7.pod:122
+#, no-wrap
+msgid ""
+" |=head1 NAME\n"
+" |\n"
+" |dummy - a dummy program\n"
+" |\n"
+" |=head1 AUTHOR\n"
+" |\n"
+" |me\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:123
+msgid ""
+"Then, the following addendum will ensure that a section (in French) about "
+"the translator is added at the end of the file (in French, \"TRADUCTEUR\" "
+"means \"TRANSLATOR\", and \"moi\" means \"me\")."
+msgstr ""
+
+#. type: verbatim
+#: doc/po4a.7.pod:124
+#, no-wrap
+msgid ""
+" |PO4A-HEADER:mode=after;position=AUTEUR;beginboundary=^=head\n"
+" |\n"
+" |=head1 TRADUCTEUR\n"
+" |\n"
+" |moi\n"
+" |\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:125
+msgid "To put your addendum before the AUTHOR, use the following header:"
+msgstr ""
+
+#. type: verbatim
+#: doc/po4a.7.pod:126
+#, no-wrap
+msgid ""
+" PO4A-HEADER:mode=after;position=NOM;beginboundary=^=head1\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:127
+msgid ""
+"This works because the next line matching the B<beginboundary> C</^=head1/> "
+"after the section \"NAME\" (translated to \"NOM\" in French), is the one "
+"declaring the authors. So, the addendum will be put between both sections. "
+"Note that if another section is added between NAME and AUTHOR sections "
+"later, po4a will wrongfully put the addenda before the new section."
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:128
+msgid "To avoid this you may accomplish the same using B<mode>=I<before>:"
+msgstr ""
+
+#. type: verbatim
+#: doc/po4a.7.pod:129
+#, no-wrap
+msgid ""
+" PO4A-HEADER:mode=before;position=^=head1 AUTEUR\n"
+"\n"
+msgstr ""
+
+#. type: =head1
+#: doc/po4a.7.pod:130
+msgid "How does it work?"
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:131
+msgid ""
+"This chapter gives you a brief overview of the po4a internals, so that you "
+"may feel more confident to help us to maintain and to improve it. It may "
+"also help you to understand why it does not do what you expected, and how to "
+"solve your problems."
+msgstr ""
+
+#. type: =head2
+#: doc/po4a.7.pod:132
+msgid "TransTractors and project architecture"
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:133
+msgid ""
+"At the core of the po4a project, the L<Locale::Po4a::TransTractor(3pm)|"
+"TransTractor> class is the common ancestor to all po4a parsers. This strange "
+"name comes from the fact that it is at the same time in charge of "
+"translating document and extracting strings."
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:134
+msgid ""
+"More formally, it takes a document to translate plus a PO file containing "
+"the translations to use as input while producing two separate outputs: "
+"Another PO file (resulting of the extraction of translatable strings from "
+"the input document), and a translated document (with the same structure as "
+"the input one, but with all translatable strings replaced with content of "
+"the input PO). Here is a graphical representation of this:"
+msgstr ""
+
+#. type: verbatim
+#: doc/po4a.7.pod:135
+#, no-wrap
+msgid ""
+" Input document --\\ /---> Output document\n"
+" \\ TransTractor:: / (translated)\n"
+" +-->-- parse() --------+\n"
+" / \\\n"
+" Input PO --------/ \\---> Output PO\n"
+" (extracted)\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:136
+msgid ""
+"This little bone is the core of all the po4a architecture. If you provide "
+"both input and disregard the output PO, you get B<po4a-translate>. If you "
+"disregard the output document instead, you get B<po4a-updatepo>. The B<po4a> "
+"uses a first TransTractor to get an up-to-date output POT file (disregarding "
+"the output documents), calls B<msgmerge -U> to update the translation PO "
+"files on disk, and builds a second TransTractor with these updated PO files "
+"to update the output documents. In short, B<po4a> provides one-stop solution "
+"to update what needs to be, using a single configuration file."
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:137
+msgid ""
+"B<po4a-gettextize> also uses two TransTractors, but another way: It builds "
+"one TransTractor per language, and then build a new PO file using the msgids "
+"of the original document as msgids, and the msgids of the translated "
+"document as msgstrs. Much care is needed to ensure that the strings matched "
+"this way actually match, as described in L<po4a-gettextize(1)>."
+msgstr ""
+
+#. type: =head2
+#: doc/po4a.7.pod:138
+msgid "Format-specific parsers"
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:139
+msgid ""
+"All po4a format parsers are implemented on top of the TransTractor. Some of "
+"them are very simple, such as the Text, Markdown and AsciiDoc ones. They "
+"load the lines one by one using C<TransTractor::shiftline()>, accumulate the "
+"paragraphs' content or whatever. Once a string is completely parsed, the "
+"parser uses C<TransTractor::translate()> to (1) add this string to the "
+"output PO file and (2) get the translation from the input PO file. The "
+"parser then pushes the result to the output file using C<TransTractor::"
+"pushline()>."
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:140
+msgid ""
+"Some other parsers are more complex because they rely on an external parser "
+"to analyze the input document. The Xml, HTML, SGML and Pod parsers are built "
+"on top of SAX parsers. They declare callbacks to events such as \"I found a "
+"new title which content is the following\" to update the output document and "
+"output POT files according to the input content using C<TransTractor::"
+"translate()> and C<TransTractor::pushline()>. The Yaml parser is similar but "
+"different: it serializes a data structure produced by the YAML::Tiny parser. "
+"This is why the Yaml module of po4a fails to declare the reference lines: "
+"the location of each string in the input file is not kept by the parser, so "
+"we can only provide \"$filename:1\" as a string location. The SAX-oriented "
+"parsers use globals and other tricks to save the file name and line numbers "
+"of references."
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:141
+msgid ""
+"One specific issue arises from file encodings and BOM markers. Simple "
+"parsers can forget about this issue, that is handled by C<TransTractor::"
+"read()> (used internally to get the lines of an input document), but the "
+"modules relying on an external parser must ensure that all files are read "
+"with an appropriate PerlIO decoding layer. The easiest is to open the file "
+"yourself, and provide an filehandle or directly the full string to your "
+"external parser. Check on C<Pod::read()> and C<Pod::parse()> for an example. "
+"The content read by the TransTractor is ignored, but a fresh filehandle is "
+"passed to the external parser. The important part is the C<< \"<:"
+"encoding($charset)\" >> mode that is passed to the B<open()> perl function."
+msgstr ""
+
+#. type: =head2
+#: doc/po4a.7.pod:142
+msgid "Po objects"
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:143
+msgid ""
+"The L<Locale::Po4a::Po(3pm)|Po> class is in charge of loading and using PO "
+"and POT files. Basically, you can read a file, add entries, get translations "
+"with the B<gettext()> method, write the PO into a file. More advanced "
+"features such as merging a PO file against a POT file or validating a file "
+"are delegated to B<msgmerge> and B<msgfmt> respectively."
+msgstr ""
+
+#. type: =head2
+#: doc/po4a.7.pod:144
+msgid "Contributing to po4a"
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:145
+msgid ""
+"Even if you have never contributed to any Open Source project in the past, "
+"you are welcome: we are willing to help and mentor you here. po4a is best "
+"maintained by its users nowadays. As we lack manpower, we try to make the "
+"project welcoming by improving the doc and the automatic tests to make you "
+"confident in contributing to the project. Please refer to the CONTRIBUTING."
+"md file for more details."
+msgstr ""
+
+#. type: =head1
+#: doc/po4a.7.pod:146
+msgid "Open-source projects using po4a"
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:147
+msgid ""
+"Here is a very partial list of projects that use po4a in production for "
+"their documentation. If you want to add your project to the list, just drop "
+"us an email (or a Merge Request)."
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:148
+msgid "adduser (man): users and groups management tool."
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:149
+msgid "apt (man, docbook): Debian package manager."
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:150
+msgid "aptitude (docbook, svg): terminal-based package manager for Debian"
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:151
+msgid ""
+"L<F-Droid website|https://gitlab.com/fdroid/fdroid-website> (markdown): "
+"installable catalog of FOSS (Free and Open Source Software) applications for "
+"the Android platform."
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:152
+msgid ""
+"L<git|https://github.com/jnavila/git-manpages-l10n> (asciidoc): distributed "
+"version-control system for tracking changes in source code."
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:153
+msgid ""
+"L<Linux manpages|https://salsa.debian.org/manpages-l10n-team/manpages-l10n> "
+"(man)"
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:154
+msgid ""
+"This project provides an infrastructure for translating many manpages to "
+"different languages, ready for integration into several major distributions "
+"(Arch Linux, Debian and derivatives, Fedora)."
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:155
+msgid ""
+"L<Stellarium|https://github.com/Stellarium/stellarium> (HTML): a free open "
+"source planetarium for your computer. po4a is used to translate the sky "
+"culture descriptions."
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:156
+msgid ""
+"L<Jamulus|https://jamulus.io/> (markdown, yaml, HTML): a FOSS application "
+"for online jamming in real time. The website documentation is maintained in "
+"multiple languages using po4a."
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:157
+msgid ""
+"Other item to sort out: L<https://gitlab.com/fdroid/fdroid-website/> "
+"L<https://github.com/fsfe/reuse-docs/pull/61>"
+msgstr ""
+
+#. type: =head1
+#: doc/po4a.7.pod:158
+msgid "FAQ"
+msgstr ""
+
+#. type: =head2
+#: doc/po4a.7.pod:159
+msgid "How do you pronounce po4a?"
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:160
+msgid ""
+"I personally vocalize it as L<pouah|https://en.wiktionary.org/wiki/pouah>, "
+"which is a French onomatopoetic that we use in place of yuck :) I may have a "
+"strange sense of humor :)"
+msgstr ""
+
+#. type: =head2
+#: doc/po4a.7.pod:161
+msgid "Why are the individual scripts deprecated?"
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:162
+msgid ""
+"Indeed, B<po4a-updatepo> and B<po4a-translate> are deprecated in favor of "
+"B<po4a>. The reason is that while B<po4a> can be used as a drop-in "
+"replacement to these scripts, there is quite a lot of code duplication here. "
+"Individual scripts last around 150 lines of codes while the B<po4a> program "
+"lasts 1200 lines, so they do a lot in addition of the common internals. The "
+"code duplication results in bugs occuring in both versions and needing two "
+"fixes. One example of such duplication are the bugs #1022216 in Debian and "
+"the issue #442 in GitHub that had the exact same fix, but one in B<po4a> and "
+"the other B<po4a-updatepo>."
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:163
+msgid ""
+"In the long run, I would like to drop the individual scripts and only "
+"maintain one version of this code. The sure thing is that the individual "
+"scripts will not get improved anymore, so only B<po4a> will get the new "
+"features. That being said, there is no deprecation urgency. I plan to keep "
+"the individual scripts as long as possible, and at least until 2030. If your "
+"project still use B<po4a-updatepo> and B<po4a-translate> in 2030, you may "
+"have a problem."
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:164
+msgid ""
+"We may also remove the deprecation of these scripts at some point, if a "
+"refactoring reduces the code duplication to zero. If you have an idea (or "
+"better: a patch), your help is welcome."
+msgstr ""
+
+#. type: =head2
+#: doc/po4a.7.pod:165
+msgid "What about the other translation tools for documentation using gettext?"
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:166
+msgid ""
+"There are a few of them. Here is a possibly incomplete list, and more tools "
+"are coming at the horizon."
+msgstr ""
+
+#. type: =item
+#: doc/po4a.7.pod:167
+msgid "B<poxml>"
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:168
+msgid ""
+"This is the tool developed by KDE people to handle DocBook XML. AFAIK, it "
+"was the first program to extract strings to translate from documentation to "
+"PO files, and inject them back after translation."
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:169
+msgid ""
+"It can only handle XML, and only a particular DTD. I'm quite unhappy with "
+"the handling of lists, which end in one big msgid. When the list become big, "
+"the chunk becomes harder to swallow."
+msgstr ""
+
+#. type: =item
+#: doc/po4a.7.pod:170
+msgid "B<po-debiandoc>"
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:171
+msgid ""
+"This program done by Denis Barbier is a sort of precursor of the po4a SGML "
+"module, which more or less deprecates it. As the name says, it handles only "
+"the DebianDoc DTD, which is more or less a deprecated DTD."
+msgstr ""
+
+#. type: =item
+#: doc/po4a.7.pod:172
+msgid "B<xml2po.py>"
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:173
+msgid ""
+"Used by the GIMP Documentation Team since 2004, works quite well even if, as "
+"the name suggests, only with XML files and needs specially configured "
+"makefiles."
+msgstr ""
+
+#. type: =item
+#: doc/po4a.7.pod:174
+msgid "B<Sphinx>"
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:175
+msgid ""
+"The Sphinx Documentation Project also uses gettext extensively to manage its "
+"translations. Unfortunately, it works only for a few text formats, rest and "
+"markdown, although it is perhaps the only tool that does this managing the "
+"whole translation process."
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:176
+msgid ""
+"The main advantages of po4a over them are the ease of extra content addition "
+"(which is even worse there) and the ability to achieve gettextization."
+msgstr ""
+
+#. type: =head2
+#: doc/po4a.7.pod:177
+msgid "SUMMARY of the advantages of the gettext based approach"
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:178
+msgid ""
+"The translations are not stored along with the original, which makes it "
+"possible to detect if translations become out of date."
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:179
+msgid ""
+"The translations are stored in separate files from each other, which "
+"prevents translators of different languages from interfering, both when "
+"submitting their patch and at the file encoding level."
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:180
+msgid ""
+"It is based internally on B<gettext> (but B<po4a> offers a very simple "
+"interface so that you don't need to understand the internals to use it). "
+"That way, we don't have to re-implement the wheel, and because of their wide "
+"use, we can think that these tools are more or less bug free."
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:181
+msgid ""
+"Nothing changed for the end-user (beside the fact translations will "
+"hopefully be better maintained). The resulting documentation file "
+"distributed is exactly the same."
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:182
+msgid ""
+"No need for translators to learn a new file syntax and their favorite PO "
+"file editor (like Emacs' PO mode, Lokalize or Gtranslator) will work just "
+"fine."
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:183
+msgid ""
+"gettext offers a simple way to get statistics about what is done, what "
+"should be reviewed and updated, and what is still to do. Some example can be "
+"found at those addresses:"
+msgstr ""
+
+#. type: verbatim
+#: doc/po4a.7.pod:184
+#, no-wrap
+msgid ""
+" - https://docs.kde.org/stable5/en/kdesdk/lokalize/project-view.html\n"
+" - http://www.debian.org/intl/l10n/\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:185
+msgid ""
+"But everything isn't green, and this approach also has some disadvantages we "
+"have to deal with."
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:186
+msgid "Addenda are somewhat strange at the first glance."
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:187
+msgid ""
+"You can't adapt the translated text to your preferences, like splitting a "
+"paragraph here, and joining two other ones there. But in some sense, if "
+"there is an issue with the original, it should be reported as a bug anyway."
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:188
+msgid ""
+"Even with an easy interface, it remains a new tool people have to learn."
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:189
+msgid ""
+"One of my dreams would be to integrate somehow po4a to Gtranslator or "
+"Lokalize. When a documentation file is opened, the strings are automatically "
+"extracted, and a translated file + po file can be written to disk. If we "
+"manage to do an MS Word (TM) module (or at least RTF) professional "
+"translators may even use it."
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:191
+msgid ""
+"The documentation of the all-in-one tool that you should use: L<po4a(1)>."
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:192
+msgid ""
+"The documentation of the individual po4a scripts: L<po4a-gettextize(1)>, "
+"L<po4a-updatepo(1)>, L<po4a-translate(1)>, L<po4a-normalize(1)>."
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:193
+msgid ""
+"The additional helping scripts: L<msguntypot(1)>, L<po4a-display-man(1)>, "
+"L<po4a-display-pod(1)>."
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:194
+msgid ""
+"The parsers of each formats, in particular to see the options accepted by "
+"each of them: L<Locale::Po4a::AsciiDoc(3pm)> L<Locale::Po4a::Dia(3pm)>, "
+"L<Locale::Po4a::Guide(3pm)>, L<Locale::Po4a::Ini(3pm)>, L<Locale::Po4a::"
+"KernelHelp(3pm)>, L<Locale::Po4a::Man(3pm)>, L<Locale::Po4a::RubyDoc(3pm)>, "
+"L<Locale::Po4a::Texinfo(3pm)>, L<Locale::Po4a::Text(3pm)>, L<Locale::Po4a::"
+"Xhtml(3pm)>, L<Locale::Po4a::Yaml(3pm)>, L<Locale::Po4a::BibTeX(3pm)>, "
+"L<Locale::Po4a::Docbook(3pm)>, L<Locale::Po4a::Halibut(3pm)>, L<Locale::"
+"Po4a::LaTeX(3pm)>, L<Locale::Po4a::Pod(3pm)>, L<Locale::Po4a::Sgml(3pm)>, "
+"L<Locale::Po4a::TeX(3pm)>, L<Locale::Po4a::Wml(3pm)>, L<Locale::Po4a::"
+"Xml(3pm)>."
+msgstr ""
+
+#. type: textblock
+#: doc/po4a.7.pod:195
+msgid ""
+"The implementation of the core infrastructure: L<Locale::Po4a::"
+"TransTractor(3pm)> (particularly important to understand the code "
+"organization), L<Locale::Po4a::Chooser(3pm)>, L<Locale::Po4a::Po(3pm)>, "
+"L<Locale::Po4a::Common(3pm)>. Please also check the F<CONTRIBUTING.md> file "
+"in the source tree."
+msgstr ""
+
+#. type: verbatim
+#: doc/po4a.7.pod:197
+#, no-wrap
+msgid ""
+" Denis Barbier <barbier,linuxfr.org>\n"
+" Martin Quinson (mquinson#debian.org)\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/AsciiDoc.pm:2
+msgid "Locale::Po4a::AsciiDoc - convert AsciiDoc documents from/to PO files"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/AsciiDoc.pm:5
+msgid ""
+"Locale::Po4a::AsciiDoc is a module to help the translation of documentation "
+"in the AsciiDoc format."
+msgstr ""
+
+#. type: =head1
+#: lib/Locale/Po4a/AsciiDoc.pm:6 lib/Locale/Po4a/BibTeX.pm:7
+#: lib/Locale/Po4a/Man.pm:34 lib/Locale/Po4a/Po.pm:13
+#: lib/Locale/Po4a/RubyDoc.pm:9 lib/Locale/Po4a/Sgml.pm:7
+#: lib/Locale/Po4a/TeX.pm:11 lib/Locale/Po4a/Texinfo.pm:10
+#: lib/Locale/Po4a/Text.pm:8 lib/Locale/Po4a/Wml.pm:7
+#: lib/Locale/Po4a/Xhtml.pm:6 lib/Locale/Po4a/Xml.pm:9
+#: lib/Locale/Po4a/Yaml.pm:7
+msgid "OPTIONS ACCEPTED BY THIS MODULE"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/AsciiDoc.pm:7 lib/Locale/Po4a/Man.pm:35
+#: lib/Locale/Po4a/TeX.pm:12 lib/Locale/Po4a/Texinfo.pm:11
+#: lib/Locale/Po4a/Text.pm:9 lib/Locale/Po4a/Xhtml.pm:7
+#: lib/Locale/Po4a/Xml.pm:11 lib/Locale/Po4a/Yaml.pm:8
+msgid "These are this module's particular options:"
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/AsciiDoc.pm:8 lib/Locale/Po4a/TeX.pm:21
+msgid "B<definitions>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/AsciiDoc.pm:9 lib/Locale/Po4a/TeX.pm:22
+msgid ""
+"The name of a file containing definitions for po4a, as defined in the "
+"B<INLINE CUSTOMIZATION> section. You can use this option if it is not "
+"possible to put the definitions in the document being translated."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/AsciiDoc.pm:10
+msgid ""
+"In a definitions file, lines must not start by two slashes, but directly by "
+"B<po4a:>."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/AsciiDoc.pm:11
+msgid "B<entry>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/AsciiDoc.pm:12
+msgid ""
+"Space-separated list of attribute entries you want to translate. By "
+"default, no attribute entries are translatable."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/AsciiDoc.pm:13
+msgid "B<macro>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/AsciiDoc.pm:14
+msgid "Space-separated list of macro definitions."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/AsciiDoc.pm:15
+msgid "B<style>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/AsciiDoc.pm:16
+msgid "Space-separated list of style definitions."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/AsciiDoc.pm:17
+msgid "B<forcewrap>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/AsciiDoc.pm:18
+msgid ""
+"Enable automatic line wrapping in non-verbatim blocks, even if the result "
+"could be misinterpreted by AsciiDoc formatters."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/AsciiDoc.pm:19
+msgid ""
+"By default, po4a will not wrap the produced AsciiDoc files because a manual "
+"inspection is mandated to ensure that the wrapping does not change the "
+"formatting. Consider for instance the following list item:"
+msgstr ""
+
+#. type: verbatim
+#: lib/Locale/Po4a/AsciiDoc.pm:20
+#, no-wrap
+msgid ""
+" * a long sentence that is ending with a number 1. A second sentence.\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/AsciiDoc.pm:21
+msgid ""
+"If the wrapping leads to the following presentation, the item is split into "
+"a numbered sub-list. To make things worse, only the speakers of the language "
+"used in the translation can inspect the situation."
+msgstr ""
+
+#. type: verbatim
+#: lib/Locale/Po4a/AsciiDoc.pm:22
+#, no-wrap
+msgid ""
+" * a long sentence that is ending with a number\n"
+" 1. A second sentence.\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/AsciiDoc.pm:23
+msgid ""
+"Note that not wrapping the files produced by po4a should not be a problem "
+"since those files are meant to be processed automatically. They should not "
+"be regarded as source files anyway."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/AsciiDoc.pm:24
+msgid ""
+"With this option, po4a will produce better-looking AsciiDoc files, but it "
+"may lead to possibly erroneous formatted outputs."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/AsciiDoc.pm:25
+msgid "B<noimagetargets>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/AsciiDoc.pm:26
+msgid ""
+"By default, the targets of block images are translatable to give opportunity "
+"to make the content point to translated images. This can be stopped by "
+"setting this option."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/AsciiDoc.pm:27
+msgid "B<tablecells>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/AsciiDoc.pm:28
+msgid ""
+"This option is a flag that enables sub-table segmentation into cell "
+"content. The segmentation is limited to cell content, without any parsing "
+"inside of it."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/AsciiDoc.pm:29
+msgid "B<compat>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/AsciiDoc.pm:30
+msgid ""
+"Switch parsing rules to compatibility with different tools. Available "
+"options are \"asciidoc\" or \"asciidoctor\". Asciidoctor has stricter "
+"parsing rules, such as equality of length of opening and closing block "
+"fences."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/AsciiDoc.pm:31
+msgid "B<nolinting>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/AsciiDoc.pm:32
+msgid ""
+"Disable linting messages. When the source code cannot be fixed for clearer "
+"document structure, these messages are useless."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/AsciiDoc.pm:33
+msgid "B<cleanspaces>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/AsciiDoc.pm:34
+msgid ""
+"Remove extra spaces from the source segments in no-wrap mode. This is useful "
+"when the translation tools are sensitive to the number of spaces."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/AsciiDoc.pm:35
+msgid "B<yfm_keys>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/AsciiDoc.pm:36 lib/Locale/Po4a/Text.pm:31
+msgid ""
+"Comma-separated list of keys to process for translation in the YAML Front "
+"Matter section. All other keys are skipped. Keys are matched with a case-"
+"sensitive match. If B<yfm_paths> and B<yfm_keys> are used together, values "
+"are included if they are matched by at least one of the options. Array "
+"values are always translated, unless the B<yfm_skip_array> option is "
+"provided."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/AsciiDoc.pm:37
+msgid "B<yfm_skip_array>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/AsciiDoc.pm:38 lib/Locale/Po4a/Text.pm:38
+msgid "Do not translate array values in the YAML Front Matter section."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/AsciiDoc.pm:39 lib/Locale/Po4a/Text.pm:35
+msgid "B<yfm_paths>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/AsciiDoc.pm:40 lib/Locale/Po4a/Text.pm:36
+msgid ""
+"Comma-separated list of hash paths to process for extraction in the YAML "
+"Front Matter section, all other paths are skipped. Paths are matched with a "
+"case-sensitive match. If B<yfm_paths> and B<yfm_keys> are used together, "
+"values are included if they are matched by at least one of the options. "
+"Arrays values are always returned unless the B<yfm_skip_array> option is "
+"provided."
+msgstr ""
+
+#. type: =head1
+#: lib/Locale/Po4a/AsciiDoc.pm:41 lib/Locale/Po4a/TeX.pm:27
+msgid "INLINE CUSTOMIZATION"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/AsciiDoc.pm:42
+msgid ""
+"The AsciiDoc module can be customized with lines starting by B<//po4a:>. "
+"These lines are interpreted as commands to the parser. The following "
+"commands are recognized:"
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/AsciiDoc.pm:43
+msgid "B<//po4a: macro >I<name>B<[>I<attribute list>B<]>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/AsciiDoc.pm:44
+msgid ""
+"This describes in detail the parameters of a B<macro>; I<name> must be a "
+"valid macro name, and it ends with an underscore if the target must be "
+"translated."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/AsciiDoc.pm:45
+msgid ""
+"The I<attribute list> argument is a comma separated list which contains "
+"information about translatable arguments. This list contains either "
+"numbers, to define positional parameters, or named attributes."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/AsciiDoc.pm:46
+msgid ""
+"If a plus sign (B<+>) is prepended to I<name>, then the macro and its "
+"arguments are translated as a whole. There is no need to define attribute "
+"list in this case, but brackets must be present."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/AsciiDoc.pm:47
+msgid "B<//po4a: style >B<[>I<attribute list>B<]>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/AsciiDoc.pm:48
+msgid ""
+"This describes in detail which attributes of a style must be translated."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/AsciiDoc.pm:49
+msgid ""
+"The I<attribute list> argument is a comma separated list which contains "
+"information about translatable arguments. This list contains either "
+"numbers, to define positional parameters, or named attributes. The first "
+"attribute is the style name, it will not be translated."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/AsciiDoc.pm:50
+msgid ""
+"If a plus sign (B<+>) is prepended to the style name, then the attribute "
+"list is translated as a whole. There is no need to define translatable "
+"attributes."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/AsciiDoc.pm:51
+msgid ""
+"If a minus sign (B<->) is prepended to the style name, then this attribute "
+"is not translated."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/AsciiDoc.pm:52
+msgid "B<//po4a: entry >I<name>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/AsciiDoc.pm:53
+msgid ""
+"This declares an attribute entry as being translatable. By default, they "
+"are not translated."
+msgstr ""
+
+#. type: =head1
+#: lib/Locale/Po4a/AsciiDoc.pm:54 lib/Locale/Po4a/BibTeX.pm:9
+#: lib/Locale/Po4a/Dia.pm:10 lib/Locale/Po4a/Docbook.pm:6
+#: lib/Locale/Po4a/Guide.pm:7 lib/Locale/Po4a/Halibut.pm:7
+#: lib/Locale/Po4a/KernelHelp.pm:5 lib/Locale/Po4a/Man.pm:96
+#: lib/Locale/Po4a/Pod.pm:9 lib/Locale/Po4a/RubyDoc.pm:6
+#: lib/Locale/Po4a/Sgml.pm:34 lib/Locale/Po4a/TeX.pm:104
+#: lib/Locale/Po4a/Texinfo.pm:8 lib/Locale/Po4a/Text.pm:43
+#: lib/Locale/Po4a/Wml.pm:9 lib/Locale/Po4a/Xhtml.pm:12
+#: lib/Locale/Po4a/Xml.pm:181
+msgid "STATUS OF THIS MODULE"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/AsciiDoc.pm:55
+msgid "Tested successfully on simple AsciiDoc files."
+msgstr ""
+
+#. type: verbatim
+#: lib/Locale/Po4a/AsciiDoc.pm:57
+#, no-wrap
+msgid ""
+" Nicolas François <nicolas.francois@centraliens.net>\n"
+" Denis Barbier <barbier@linuxfr.org>\n"
+"\n"
+msgstr ""
+
+#. type: verbatim
+#: lib/Locale/Po4a/AsciiDoc.pm:59
+#, no-wrap
+msgid ""
+" Copyright © 2005-2008 Nicolas FRANÇOIS <nicolas.francois@centraliens.net>.\n"
+" Copyright © 2012 Denis BARBIER <barbier@linuxfr.org>.\n"
+" Copyright © 2017 Martin Quinson <mquinson#debian.org>.\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/BibTeX.pm:2
+msgid "Locale::Po4a::BibTeX - convert BibTeX documents from/to PO files"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/BibTeX.pm:5
+msgid ""
+"Locale::Po4a::BibTeX is a module to help the translation of bibliographies "
+"in the BibTeX format into other [human] languages."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/BibTeX.pm:6
+msgid "Fields values are extracted and proposed for translation."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/BibTeX.pm:8 lib/Locale/Po4a/Wml.pm:8
+msgid "NONE."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/BibTeX.pm:10
+msgid "It is a very simple module, but still young."
+msgstr ""
+
+#. type: verbatim
+#: lib/Locale/Po4a/BibTeX.pm:12 lib/Locale/Po4a/Halibut.pm:17
+#: lib/Locale/Po4a/LaTeX.pm:11 lib/Locale/Po4a/TeX.pm:121
+#: lib/Locale/Po4a/Texinfo.pm:17 lib/Locale/Po4a/Text.pm:46
+#, no-wrap
+msgid ""
+" Nicolas François <nicolas.francois@centraliens.net>\n"
+"\n"
+msgstr ""
+
+#. type: verbatim
+#: lib/Locale/Po4a/BibTeX.pm:14
+#, no-wrap
+msgid ""
+" Copyright © 2006 Nicolas FRANÇOIS <nicolas.francois@centraliens.net>.\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Chooser.pm:2
+msgid "Locale::Po4a::Chooser - manage po4a modules"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Chooser.pm:4
+msgid ""
+"Locale::Po4a::Chooser is a module to manage po4a modules. Previously, all "
+"po4a binaries used to know all po4a modules (pod, man, sgml, etc). This made "
+"the addition of a new module boring, because you had to make sure that the "
+"documentation is synchronized in all modules, and that each of them can "
+"access the new module."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Chooser.pm:5
+msgid ""
+"Now, you just have to call the Locale::Po4a::Chooser::new() function, "
+"passing the name of module as argument."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Chooser.pm:6
+msgid ""
+"The function Locale::Po4a::Chooser::list() lists the available formats, and "
+"exits with the value passed as argument. So, we call Locale::Po4a::Chooser::"
+"list(0) when requested for the list of formats, and Locale::Po4a::Chooser::"
+"list(1) when passed an invalid format name."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Chooser.pm:8
+msgid "About po4a:"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Chooser.pm:9
+msgid ""
+"L<Locale::Po4a::Po(3pm)>, L<Locale::Po4a::TransTractor(3pm)>, L<po4a(7)|"
+"po4a.7>"
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Chooser.pm:10
+msgid "About modules:"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Chooser.pm:11
+msgid ""
+"L<Locale::Po4a::Dia(3pm)>, L<Locale::Po4a::Docbook(3pm)>, L<Locale::Po4a::"
+"Guide(3pm)>, L<Locale::Po4a::Halibut(3pm)>, L<Locale::Po4a::Ini(3pm)>, "
+"L<Locale::Po4a::KernelHelp(3pm)>, L<Locale::Po4a::LaTeX(3pm)>, L<Locale::"
+"Po4a::Man(3pm)>, L<Locale::Po4a::Pod(3pm)>, L<Locale::Po4a::RubyDoc(3pm)>, "
+"L<Locale::Po4a::Sgml(3pm)>, L<Locale::Po4a::TeX(3pm)>, L<Locale::Po4a::"
+"Texinfo(3pm)>, L<Locale::Po4a::Text(3pm)>, L<Locale::Po4a::Wml(3pm)>. "
+"L<Locale::Po4a::Xhtml(3pm)>, L<Locale::Po4a::Xml(3pm)>, L<Locale::Po4a::"
+"Wml(3pm)>, L<Locale::Po4a::Yaml(3pm)>."
+msgstr ""
+
+#. type: verbatim
+#: lib/Locale/Po4a/Chooser.pm:13 lib/Locale/Po4a/KernelHelp.pm:10
+#: lib/Locale/Po4a/Po.pm:94 lib/Locale/Po4a/Pod.pm:24
+#: lib/Locale/Po4a/Sgml.pm:57
+#, no-wrap
+msgid ""
+" Denis Barbier <barbier@linuxfr.org>\n"
+" Martin Quinson (mquinson#debian.org)\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Chooser.pm:15
+msgid "Copyright © 2002-2005, 2014, 2017 SPI, Inc."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Common.pm:2
+msgid "Locale::Po4a::Common - common parts of the po4a scripts and utils"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Common.pm:4
+msgid ""
+"Locale::Po4a::Common contains common parts of the po4a scripts and some "
+"useful functions used along the other modules."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Common.pm:5
+msgid "If needed, you can disable the use of Text::WrapI18N as such:"
+msgstr ""
+
+#. type: verbatim
+#: lib/Locale/Po4a/Common.pm:6
+#, no-wrap
+msgid ""
+" use Locale::Po4a::Common qw(nowrapi18n);\n"
+" use Locale::Po4a::Text;\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Common.pm:7
+msgid "instead of:"
+msgstr ""
+
+#. type: verbatim
+#: lib/Locale/Po4a/Common.pm:8
+#, no-wrap
+msgid ""
+" use Locale::Po4a::Text;\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Common.pm:9
+msgid ""
+"The ordering is important here: as most Locale::Po4a modules load themselves "
+"Locale::Po4a::Common, the first time this module is loaded determines "
+"whether Text::WrapI18N is used."
+msgstr ""
+
+#. type: =head1
+#: lib/Locale/Po4a/Common.pm:10
+msgid "FUNCTIONS"
+msgstr ""
+
+#. type: =head2
+#: lib/Locale/Po4a/Common.pm:11
+msgid "Showing output messages"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Common.pm:12
+msgid "show_version($)"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Common.pm:13
+msgid ""
+"Shows the current version of the script, and a short copyright message. It "
+"takes the name of the script as an argument."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Common.pm:14
+msgid "wrap_msg($@)"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Common.pm:15
+msgid ""
+"This function displays a message the same way as sprintf() does, but wraps "
+"the result so that they look nice on the terminal."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Common.pm:16
+msgid "wrap_mod($$@)"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Common.pm:17
+msgid ""
+"This function works like wrap_msg(), but it takes a module name as the first "
+"argument, and leaves a space at the left of the message."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Common.pm:18
+msgid "wrap_ref_mod($$$@)"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Common.pm:19
+msgid ""
+"This function works like wrap_msg(), but it takes a file:line reference as "
+"the first argument, a module name as the second one, and leaves a space at "
+"the left of the message."
+msgstr ""
+
+#. type: =head2
+#: lib/Locale/Po4a/Common.pm:20
+msgid "Wrappers for other modules"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Common.pm:21
+msgid "Locale::Gettext"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Common.pm:22
+msgid ""
+"When the Locale::Gettext module cannot be loaded, this module provide dummy "
+"(empty) implementation of the following functions. In that case, po4a "
+"messages won't get translated but the program will continue to work."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Common.pm:23
+msgid ""
+"If Locale::gettext is present, this wrapper also calls "
+"setlocale(LC_MESSAGES, \"\") so callers don't depend on the POSIX module "
+"either."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Common.pm:24
+msgid "bindtextdomain($$)"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Common.pm:25
+msgid "textdomain($)"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Common.pm:26
+msgid "gettext($)"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Common.pm:27
+msgid "dgettext($$)"
+msgstr ""
+
+#. type: verbatim
+#: lib/Locale/Po4a/Common.pm:29 lib/Locale/Po4a/Dia.pm:15
+#: lib/Locale/Po4a/Docbook.pm:18 lib/Locale/Po4a/Guide.pm:13
+#, no-wrap
+msgid ""
+" Jordi Vilalta <jvprat@gmail.com>\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Common.pm:31
+msgid "Copyright © 2005 SPI, Inc."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Dia.pm:2
+msgid "Locale::Po4a::Dia - convert uncompressed Dia diagrams from/to PO files"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Dia.pm:5
+msgid ""
+"Locale::Po4a::Dia is a module to help the translation of diagrams in the "
+"uncompressed Dia format into other [human] languages."
+msgstr ""
+
+#. type: verbatim
+#: lib/Locale/Po4a/Dia.pm:6
+#, no-wrap
+msgid ""
+"You can get Dia (the graphical editor for these diagrams) from:\n"
+" http://www.gnome.org/projects/dia/\n"
+"\n"
+msgstr ""
+
+#. type: =head1
+#: lib/Locale/Po4a/Dia.pm:7
+msgid "TRANSLATING WITH PO4A::DIA"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Dia.pm:8
+msgid ""
+"This module only translates uncompressed Dia diagrams. You can save your "
+"uncompressed diagrams with Dia itself, unchecking the \"Compress diagram "
+"files\" at the \"Save Diagram\" dialog."
+msgstr ""
+
+#. type: verbatim
+#: lib/Locale/Po4a/Dia.pm:9
+#, no-wrap
+msgid ""
+"Another way is to uncompress the dia files from command line with:\n"
+" gunzip < original.dia > uncompressed.dia\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Dia.pm:11
+msgid ""
+"This module is fully functional, as it relies in the L<Locale::Po4a::Xml> "
+"module. This only defines the translatable tags (E<lt>dia:stringE<gt>), and "
+"filters the internal strings (the content of the E<lt>dia:diagramdataE<gt> "
+"tag), not interesting for translation."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Dia.pm:13 lib/Locale/Po4a/Docbook.pm:16
+#: lib/Locale/Po4a/Guide.pm:11 lib/Locale/Po4a/Xhtml.pm:16
+msgid ""
+"L<Locale::Po4a::TransTractor(3pm)>, L<Locale::Po4a::Xml(3pm)>, L<po4a(7)|"
+"po4a.7>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Dia.pm:17 lib/Locale/Po4a/Guide.pm:15
+msgid "Copyright © 2004 Jordi Vilalta <jvprat@gmail.com>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Docbook.pm:2
+msgid "Locale::Po4a::Docbook - convert DocBook XML documents from/to PO files"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Docbook.pm:5
+msgid ""
+"Locale::Po4a::Docbook is a module to help the translation of DocBook XML "
+"documents into other [human] languages."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Docbook.pm:7 lib/Locale/Po4a/Guide.pm:8
+#: lib/Locale/Po4a/Xhtml.pm:13
+msgid ""
+"This module is fully functional, as it relies in the L<Locale::Po4a::Xml> "
+"module. This only defines the translatable tags and attributes."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Docbook.pm:8
+msgid ""
+"The only known issue is that it doesn't handle entities yet, and this "
+"includes the file inclusion entities, but you can translate most of those "
+"files alone (except the typical entities files), and it's usually better to "
+"maintain them separated."
+msgstr ""
+
+#. type: =head2
+#: lib/Locale/Po4a/Docbook.pm:9 lib/Locale/Po4a/Xml.pm:106
+msgid "OVERRIDE THE DEFAULT BEHAVIOR WITH COMMAND LINE OPTIONS"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Docbook.pm:10
+msgid ""
+"The default behavior of system provided modules is set to be on the safe "
+"side."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Docbook.pm:11
+msgid ""
+"For example, the default of B<< <author> >> tag is aiming it to appear under "
+"B<< <para> >>. But you may be using it only under B<< <bookinfo> >>. For "
+"this case, you may want to translate it independently for each author."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Docbook.pm:12
+msgid ""
+"If you don't like the default behavior of the xml module and its derivative "
+"modules, you can provide command line options to change their behavior. For "
+"example, you can add the following to the po4a configuration file:"
+msgstr ""
+
+#. type: verbatim
+#: lib/Locale/Po4a/Docbook.pm:13
+#, no-wrap
+msgid ""
+" opt:\"-k 0 -o nodefault=\\\"<bookinfo> <author>\\\" \\\n"
+" -o break=\\\"<bookinfo> <author>\\\" \\\n"
+" -o untranslated=\\\"<bookinfo>\\\" \\\n"
+" -o translated=\\\"<author>\\\"\"\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Docbook.pm:14
+msgid ""
+"This overrides the default behavior for B<< <bookinfo> >> and B<< <author> "
+">>, set B<< <bookinfo> >> and B<< <author> >> to break input data stream on "
+"these tags, set B<< <bookinfo> >> not to translate its tagged content, and "
+"set B<< <author> >> to translate its tagged content."
+msgstr ""
+
+#. type: verbatim
+#: lib/Locale/Po4a/Docbook.pm:20
+#, no-wrap
+msgid ""
+" Copyright © 2004 Jordi Vilalta <jvprat@gmail.com>\n"
+" Copyright © 2007-2009 Nicolas François <nicolas.francois@centraliens.net>\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Guide.pm:2
+msgid "Locale::Po4a::Guide - convert Guide XML documents from/to PO files"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Guide.pm:5
+msgid ""
+"Locale::Po4a::Guide is a module to help in the translation of the Gentoo "
+"Linux documentation in the Guide XML format into other [human] languages."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Guide.pm:6
+msgid ""
+"This format is documented here: http://www.gentoo.org/doc/en/xml-guide.xml"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Guide.pm:9
+msgid ""
+"The only known issue is that it doesn't include files with the <include "
+"href=\"...\"> tag, but you can translate all those files alone, and it's "
+"usually better to have them separated."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Halibut.pm:2
+msgid ""
+"Locale::Po4a::Halibut - convert Halibut documents and derivates from/to PO "
+"files"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Halibut.pm:5
+msgid ""
+"Locale::Po4a::Halibut is a module to help the translation of Halibut "
+"documents into other [human] languages."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Halibut.pm:6
+msgid ""
+"This module contains the definitions of common Halibut commands and "
+"environments."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Halibut.pm:8
+msgid "This module is still beta. Please send feedback and feature requests."
+msgstr ""
+
+#. type: =head1
+#: lib/Locale/Po4a/Halibut.pm:9
+msgid "CAVEAT"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Halibut.pm:10
+msgid ""
+"Some constructs are badly supported. The known ones are documented below."
+msgstr ""
+
+#. type: =head2
+#: lib/Locale/Po4a/Halibut.pm:11
+msgid "Verbatim blocks"
+msgstr ""
+
+#. type: verbatim
+#: lib/Locale/Po4a/Halibut.pm:12
+#, no-wrap
+msgid ""
+" \\c foo\n"
+" \\c bar\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Halibut.pm:13
+msgid ""
+"The verbatim block is not considered as a whole. Each line will be "
+"translated separately."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Halibut.pm:15 lib/Locale/Po4a/LaTeX.pm:9
+#: lib/Locale/Po4a/Texinfo.pm:15
+msgid ""
+"L<Locale::Po4a::TeX(3pm)|Locale::Po4a::TeX>, L<Locale::Po4a::"
+"TransTractor(3pm)|Locale::Po4a::TransTractor>, L<po4a(7)|po4a.7>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Halibut.pm:19
+msgid ""
+"Copyright © 2004-2008 Nicolas FRANÇOIS <nicolas.francois@centraliens.net>."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Ini.pm:2
+msgid "Locale::Po4a::Ini - convert INI files from/to PO files"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Ini.pm:4
+msgid ""
+"Locale::Po4a::Ini is a module to help the translation of INI files into "
+"other [human] languages."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Ini.pm:5
+msgid ""
+"The module searches for lines of the following format and extracts the "
+"quoted text:"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Ini.pm:6
+msgid "identificator=\"text than can be translated\""
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Ini.pm:7
+msgid "NOTE: If the text is not quoted, it will be ignored."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Ini.pm:9 lib/Locale/Po4a/Yaml.pm:16
+msgid "L<Locale::Po4a::TransTractor(3pm)>, L<po4a(7)|po4a.7>"
+msgstr ""
+
+#. type: verbatim
+#: lib/Locale/Po4a/Ini.pm:11
+#, no-wrap
+msgid ""
+" Razvan Rusu <rrusu@bitdefender.com>\n"
+" Costin Stroie <cstroie@bitdefender.com>\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Ini.pm:13
+msgid "Copyright © 2006 BitDefender"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/KernelHelp.pm:2
+msgid ""
+"Locale::Po4a::KernelHelp - convert kernel configuration help from/to PO files"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/KernelHelp.pm:4
+msgid ""
+"Locale::Po4a::KernelHelp is a module to help the translation of "
+"documentation for the Linux kernel configuration options into other [human] "
+"languages."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/KernelHelp.pm:6
+msgid ""
+"This module is just written, and needs more tests. Most of the needed work "
+"will concern the tools used to parse this file (and configure the kernel), "
+"so that they accept to read the documentation from another (translated) "
+"file."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/KernelHelp.pm:8
+msgid ""
+"L<Pod::Parser>, L<Locale::Po4a::Man(3pm)>, L<Locale::Po4a::Pod(3pm)>, "
+"L<Locale::Po4a::TransTractor(3pm)>, L<po4a(7)|po4a.7>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/KernelHelp.pm:12 lib/Locale/Po4a/Pod.pm:26
+msgid "Copyright © 2002 SPI, Inc."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/LaTeX.pm:2
+msgid ""
+"Locale::Po4a::LaTeX - convert LaTeX documents and derivates from/to PO files"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/LaTeX.pm:5
+msgid ""
+"Locale::Po4a::LaTeX is a module to help the translation of LaTeX documents "
+"into other [human] languages. It can also be used as a base to build modules "
+"for LaTeX-based documents."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/LaTeX.pm:6
+msgid ""
+"This module contains the definitions of common LaTeX commands and "
+"environments."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/LaTeX.pm:7
+msgid ""
+"See the L<Locale::Po4a::TeX(3pm)|Locale::Po4a::TeX> manpage for the list of "
+"recognized options."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/LaTeX.pm:13 lib/Locale/Po4a/TeX.pm:123
+msgid ""
+"Copyright © 2004, 2005 Nicolas FRANÇOIS <nicolas.francois@centraliens.net>."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Man.pm:2
+msgid "Locale::Po4a::Man - convert manual pages from/to PO files"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Man.pm:5
+msgid ""
+"Locale::Po4a::Man is a module to help the translation of documentation in "
+"the nroff format (the language of manual pages) into other [human] languages."
+msgstr ""
+
+#. type: =head1
+#: lib/Locale/Po4a/Man.pm:6
+msgid "TRANSLATING WITH PO4A::MAN"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Man.pm:7
+msgid ""
+"This module tries pretty hard to make translator's life easier. For that, "
+"the text presented to translators isn't a verbatim copy of the text found in "
+"the man page. Indeed, the cruder parts of the nroff format are hidden, so "
+"that translators can't mess up with them."
+msgstr ""
+
+#. type: =head2
+#: lib/Locale/Po4a/Man.pm:8
+msgid "Text wrapping"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Man.pm:9
+msgid ""
+"Unindented paragraphs are automatically rewrapped for the translator. This "
+"can lead to some minor difference in the generated output, since the "
+"rewrapping rules used by groff aren't very clear. For example, two spaces "
+"after a parenthesis are sometimes preserved."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Man.pm:10
+msgid ""
+"Anyway, the difference will only be about the position of the extra spaces "
+"in wrapped paragraph, and I think it's worth."
+msgstr ""
+
+#. type: =head2
+#: lib/Locale/Po4a/Man.pm:11
+msgid "Font specification"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Man.pm:12
+msgid ""
+"The first change is about font change specifications. In nroff, there are "
+"several ways to specify if a given word should be written in small, bold or "
+"italics. In the text to translate, there is only one way, borrowed from the "
+"POD (Perl online documentation) format:"
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Man.pm:13
+msgid "IE<lt>textE<gt> -- italic text"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Man.pm:14
+msgid "equivalent to \\fItext\\fP or \".I text\""
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Man.pm:15
+msgid "BE<lt>textE<gt> -- bold text"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Man.pm:16
+msgid "equivalent to \\fBtext\\fP or \".B text\""
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Man.pm:17
+msgid "RE<lt>textE<gt> -- roman text"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Man.pm:18
+msgid "equivalent to \\fRtext\\fP"
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Man.pm:19
+msgid "CWE<lt>textE<gt> -- constant width text"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Man.pm:20
+msgid "equivalent to \\f(CWtext\\fP or \".CW text\""
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Man.pm:21
+msgid ""
+"Remark: The CW face is not available for all groff devices. It is not "
+"recommended to use it. It is provided for your convenience."
+msgstr ""
+
+#. type: =head2
+#: lib/Locale/Po4a/Man.pm:22
+msgid "Automatic characters transliteration"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Man.pm:23
+msgid ""
+"Po4a automatically transliterate some characters to ease the translation or "
+"the review of the translation. Here is the list of the transliterations:"
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Man.pm:24
+msgid "hyphens"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Man.pm:25
+msgid ""
+"Hyphens (-) and minus signs (\\-) in man pages are all transliterated as "
+"simple dashes (-) in the PO file. Then all dash are transliterated into "
+"roff minus signs (\\-) when the translation is inserted into the output "
+"document."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Man.pm:26
+msgid ""
+"Translators can force an hyphen by using the roff glyph '\\[hy]' in their "
+"translations."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Man.pm:27
+msgid "non-breaking spaces"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Man.pm:28
+msgid ""
+"Translators can use non-breaking spaces in their translations. These non-"
+"breaking spaces (0xA0 in latin1) will be transliterated into a roff non-"
+"breaking space ('\\ ')."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Man.pm:29
+msgid "quotes transliterations"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Man.pm:30
+msgid "`` and '' are respectively tranliterated into \\*(lq and \\*(rq."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Man.pm:31
+msgid ""
+"To avoid these transliterations, translators can insert a zero width roff "
+"character (i.e., using `\\&` or '\\&' respectively)."
+msgstr ""
+
+#. type: =head2
+#: lib/Locale/Po4a/Man.pm:32
+msgid "Putting 'E<lt>' and 'E<gt>' in translations"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Man.pm:33
+msgid ""
+"Since these chars are used to delimit parts under font modification, you "
+"can't use them verbatim. Use EE<lt>ltE<gt> and EE<lt>gtE<gt> instead (as in "
+"POD, one more time)."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Man.pm:36 lib/Locale/Po4a/Sgml.pm:8
+#: lib/Locale/Po4a/TeX.pm:13
+msgid "B<debug>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Man.pm:37 lib/Locale/Po4a/TeX.pm:14
+msgid ""
+"Activate debugging for some internal mechanisms of this module. Use the "
+"source to see which parts can be debugged."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Man.pm:38 lib/Locale/Po4a/Sgml.pm:10
+msgid "B<verbose>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Man.pm:39
+msgid "Increase verbosity."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Man.pm:40
+msgid "B<groff_code>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Man.pm:41
+msgid ""
+"This option controls the behavior of the module when it encounter a .de, .ie "
+"or .if section. It can take the following values:"
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Man.pm:42 lib/Locale/Po4a/Xml.pm:27
+msgid "I<fail>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Man.pm:43
+msgid ""
+"This is the default value. The module will fail when a .de, .ie or .if "
+"section is encountered."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Man.pm:44
+msgid "I<verbatim>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Man.pm:45
+msgid ""
+"Indicates that the .de, .ie or .if sections must be copied as is from the "
+"original to the translated document."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Man.pm:46
+msgid "I<translate>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Man.pm:47
+msgid ""
+"Indicates that the .de, .ie or .if sections will be proposed for the "
+"translation. You should only use this option if a translatable string is "
+"contained in one of these section. Otherwise, I<verbatim> should be "
+"preferred."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Man.pm:48
+msgid "B<generated>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Man.pm:49
+msgid ""
+"This option specifies that the file was generated, and that po4a should not "
+"try to detect if the man pages was generated from another format. This "
+"option is mandatory to use po4a on generated man pages. Note that "
+"translating generated pages instead of sources ones is often more fragile, "
+"and thus a bad idea."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Man.pm:50
+msgid "B<mdoc>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Man.pm:51
+msgid "This option is only useful for mdoc pages."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Man.pm:52
+msgid ""
+"It selects a stricter support of the mdoc format by telling po4a not to "
+"translate the 'NAME' section. mdoc pages whose 'NAME' section is translated "
+"won't generate any header or footer."
+msgstr ""
+
+#. type: verbatim
+#: lib/Locale/Po4a/Man.pm:53
+#, no-wrap
+msgid ""
+"According to the groff_mdoc page, the NAME, SYNOPSIS and DESCRIPTION\n"
+"sections are mandatory.\n"
+"There are no known issues with translated SYNOPSIS or DESCRIPTION section,\n"
+"but you can also specify these sections this way:\n"
+" -o mdoc=NAME,SYNOPSIS,DESCRIPTION\n"
+"\n"
+msgstr ""
+
+#. type: verbatim
+#: lib/Locale/Po4a/Man.pm:54
+#, no-wrap
+msgid ""
+"This mdoc issue can also be solved with an addendum like this one:\n"
+" PO4A-HEADER:mode=before;position=^.Dd\n"
+" .TH DOCUMENT_TITLE 1 \"Month day, year\" OS \"Section Name\"\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Man.pm:55
+msgid ""
+"The following options specify the behavior of a user-defined macro (with a ."
+"de request), or of a classical macro that is not supported by po4a. They "
+"take as argument a comma-separated list of macros. For example:"
+msgstr ""
+
+#. type: verbatim
+#: lib/Locale/Po4a/Man.pm:56
+#, no-wrap
+msgid ""
+" -o noarg=FO,OB,AR -o translate_joined=BA,ZQ,UX\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Man.pm:57
+msgid ""
+"Note: if a macro is not supported by po4a and if you consider that it is a "
+"standard roff macro, you should submit it to the po4a development team."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Man.pm:58 lib/Locale/Po4a/Xml.pm:94
+msgid "B<untranslated>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Man.pm:59
+msgid ""
+"B<untranslated> indicates that this macro (at its arguments) don't have to "
+"be translated."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Man.pm:60
+msgid "B<noarg>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Man.pm:61
+msgid ""
+"B<noarg> is like B<untranslated>, except that po4a will verify that no "
+"argument is added to this macro."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Man.pm:62
+msgid "B<translate_joined>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Man.pm:63
+msgid ""
+"B<translate_joined> indicates that po4a must propose to translate the "
+"arguments of the macro."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Man.pm:64
+msgid "B<translate_each>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Man.pm:65
+msgid ""
+"With B<translate_each>, the arguments will also be proposed for the "
+"translation, except that each one will be translated separately."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Man.pm:66 lib/Locale/Po4a/TeX.pm:15
+msgid "B<no_wrap>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Man.pm:67
+msgid ""
+"This option takes as argument a list of comma-separated couples I<begin>:"
+"I<end>, where I<begin> and I<end> are commands that delimit the begin and "
+"end of a section that should not be rewrapped."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Man.pm:68
+msgid ""
+"Note: no test is done to ensure that an I<end> command matches its I<begin> "
+"command; any ending command stop the no_wrap mode. If you have a I<begin> "
+"(respectively I<end>) macro that has no I<end> (respectively I<begin>), you "
+"can specify an existing I<end> (like fi) or I<begin> (like nf) as a "
+"counterpart. These macros (and their arguments) won't be translated."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Man.pm:69 lib/Locale/Po4a/Xml.pm:59
+msgid "B<inline>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Man.pm:70
+msgid ""
+"This option specifies a list of comma-separated macros that must not split "
+"the current paragraph. The string to translate will then contain I<foo E<lt>."
+"bar baz quxE<gt> quux>, where I<bar> is the command that should be inlined, "
+"and I<baz qux> its arguments."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Man.pm:71
+msgid "B<unknown_macros>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Man.pm:72
+msgid ""
+"This option indicates how po4a should behave when an unknown macro is "
+"found. By default, po4a fails with a warning. It can take the following "
+"values: B<failed> (the default value), B<untranslated>, B<noarg>, "
+"B<translate_joined>, or B<translate_each> (see above for an explanation of "
+"these values)."
+msgstr ""
+
+#. type: =head1
+#: lib/Locale/Po4a/Man.pm:73
+msgid "AUTHORING MAN PAGES COMPLIANT WITH PO4A::MAN"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Man.pm:74
+msgid ""
+"This module is still very limited, and will always be, because it's not a "
+"real nroff interpreter. It would be possible to do a real nroff interpreter, "
+"to allow authors to use all the existing macros, or even to define new ones "
+"in their pages, but we didn't want to. It would be too difficult, and we "
+"thought it wasn't necessary. We do think that if manpages' authors want to "
+"see their productions translated, they may have to adapt to ease the work of "
+"translators."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Man.pm:75
+msgid ""
+"So, the man parser implemented in po4a have some known limitations we are "
+"not really inclined to correct, and which will constitute some pitfalls "
+"you'll have to avoid if you want to see translators taking care of your "
+"documentation."
+msgstr ""
+
+#. type: =head2
+#: lib/Locale/Po4a/Man.pm:76
+msgid "Don't program in nroff"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Man.pm:77
+msgid ""
+"nroff is a complete programming language, with macro definition, "
+"conditionals and so on. Since this parser isn't a fully featured nroff "
+"interpreter, it will fail on pages using these facilities (There are about "
+"200 such pages on my box)."
+msgstr ""
+
+#. type: =head2
+#: lib/Locale/Po4a/Man.pm:78
+msgid "Use the plain macro set"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Man.pm:79
+msgid ""
+"There are still some macros which are not supported by po4a::man. This is "
+"only because I failed to find any documentation about them. Here is the list "
+"of unsupported macros used on my box. Note that this list isn't exhaustive "
+"since the program fails on the first encountered unsupported macro. If you "
+"have any information about some of these macros, I'll happily add support "
+"for them. Because of these macros, about 250 pages on my box are "
+"inaccessible to po4a::man."
+msgstr ""
+
+#. type: verbatim
+#: lib/Locale/Po4a/Man.pm:80
+#, no-wrap
+msgid ""
+" .. .\" .AT .b .bank\n"
+" .BE ..br .Bu .BUGS .BY\n"
+" .ce .dbmmanage .do .En\n"
+" .EP .EX .Fi .hw .i\n"
+" .Id .l .LO .mf\n"
+" .N .na .NF .nh .nl\n"
+" .Nm .ns .NXR .OPTIONS .PB\n"
+" .pp .PR .PRE .PU .REq\n"
+" .RH .rn .S< .sh .SI\n"
+" .splitfont .Sx .T .TF .The\n"
+" .TT .UC .ul .Vb .zZ\n"
+"\n"
+msgstr ""
+
+#. type: =head2
+#: lib/Locale/Po4a/Man.pm:81
+msgid "Hiding text from po4a"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Man.pm:82
+msgid ""
+"Sometimes, the author knows that some parts are not translatable, and should "
+"not be extracted by po4a. For example, an option may accept an I<other> "
+"argument, and I<other> may also appear as the last item of a list. In the "
+"first case, I<other> should be not be translatable. And in the second case, "
+"I<other> should be translated."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Man.pm:83
+msgid ""
+"In such case, the author can avoid po4a to extract some strings, using some "
+"special groff constructs:"
+msgstr ""
+
+#. type: verbatim
+#: lib/Locale/Po4a/Man.pm:84
+#, no-wrap
+msgid ""
+" .if !'po4a'hide' .B other\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Man.pm:85
+msgid "(this will require the B<-o groff_code=verbatim> option)"
+msgstr ""
+
+#. type: verbatim
+#: lib/Locale/Po4a/Man.pm:86
+#, no-wrap
+msgid ""
+"A new macro can also be defined to automate this:\n"
+" .de IR_untranslated\n"
+" . IR \\\\$@\n"
+" ..\n"
+"\n"
+msgstr ""
+
+#. type: verbatim
+#: lib/Locale/Po4a/Man.pm:87 lib/Locale/Po4a/Man.pm:90
+#, no-wrap
+msgid ""
+" .IR_untranslated \\-q \", \" \\-\\-quiet\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Man.pm:88
+msgid ""
+"(this will require the options B<-o groff_code=verbatim> and B<-o "
+"untranslated=IR_untranslated>; with this construct, the B<.if !'po4a'hide'> "
+"conditional is not strictly needed since po4a will not parse the internal of "
+"the macro definition)"
+msgstr ""
+
+#. type: verbatim
+#: lib/Locale/Po4a/Man.pm:89
+#, no-wrap
+msgid ""
+"or using an alias:\n"
+" .als IR_untranslated IR\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Man.pm:91
+msgid "This will require the B<-o untranslated=als,IR_untranslated> option."
+msgstr ""
+
+#. type: =head2
+#: lib/Locale/Po4a/Man.pm:92
+msgid "Conclusion"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Man.pm:93
+msgid ""
+"To summarise this section, keep simple, and don't try to be clever while "
+"authoring your man pages. A lot of things are possible in nroff, and not "
+"supported by this parser. For example, don't try to mess with \\c to "
+"interrupt the text processing (like 40 pages on my box do). Or, be sure to "
+"put the macro arguments on the same line that the macro itself. I know that "
+"it's valid in nroff, but would complicate too much the parser to be handled."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Man.pm:94
+msgid ""
+"Of course, another possibility is to use another format, more translator "
+"friendly (like POD using po4a::pod, or one of the XML family like SGML), but "
+"thanks to po4a::man it isn't needed anymore. That being said, if the source "
+"format of your documentation is POD, or XML, it may be clever to translate "
+"the source format and not this generated one. In most cases, po4a::man will "
+"detect generated pages and issue a warning. It will even refuse to process "
+"POD generated pages, because those pages are perfectly handled by po4a::pod, "
+"and because their nroff counterpart defines a lot of new macros I didn't "
+"want to write support for. On my box, 1432 of the 4323 pages are generated "
+"from POD and will be ignored by po4a::man."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Man.pm:95
+msgid ""
+"In most cases, po4a::man will detect the problem and refuse to process the "
+"page, issuing an adapted message. In some rare cases, the program will "
+"complete without warning, but the output will be wrong. Such cases are "
+"called \"bugs\" ;) If you encounter such case, be sure to report this, along "
+"with a fix when possible…"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Man.pm:97
+msgid "This module can be used for most of the existing man pages."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Man.pm:98
+msgid "Some tests are regularly run on Linux boxes:"
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Man.pm:99 lib/Locale/Po4a/Man.pm:101
+#: lib/Locale/Po4a/Man.pm:103 lib/Locale/Po4a/Man.pm:105
+#: lib/Locale/Po4a/Sgml.pm:36 lib/Locale/Po4a/Sgml.pm:42
+#: lib/Locale/Po4a/Sgml.pm:45 lib/Locale/Po4a/Sgml.pm:49
+msgid "*"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Man.pm:100
+msgid ""
+"one third of the pages are refused because they were generated from another "
+"format supported by po4a (e.g. POD or SGML)."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Man.pm:102
+msgid ""
+"10% of the remaining pages are rejected with an error (e.g. a groff macro is "
+"not supported)."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Man.pm:104
+msgid ""
+"Then, less than 1% of the pages are accepted silently by po4a, but with "
+"significant issues (i.e. missing words, or new words inserted)"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Man.pm:106
+msgid ""
+"The other pages are usually handled without differences more important than "
+"spacing differences or line rewrapped (font issues in less than 10% of the "
+"processed pages)."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Man.pm:108
+msgid ""
+"L<Locale::Po4a::Pod(3pm)>, L<Locale::Po4a::TransTractor(3pm)>, L<po4a(7)|"
+"po4a.7>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Man.pm:112
+msgid "Copyright © 2002-2008 SPI, Inc."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Po.pm:2
+msgid "Locale::Po4a::Po - PO file manipulation module"
+msgstr ""
+
+#. type: verbatim
+#: lib/Locale/Po4a/Po.pm:4
+#, no-wrap
+msgid ""
+" use Locale::Po4a::Po;\n"
+" my $pofile=Locale::Po4a::Po->new();\n"
+"\n"
+msgstr ""
+
+#. type: verbatim
+#: lib/Locale/Po4a/Po.pm:5
+#, no-wrap
+msgid ""
+" # Read PO file\n"
+" $pofile->read('file.po');\n"
+"\n"
+msgstr ""
+
+#. type: verbatim
+#: lib/Locale/Po4a/Po.pm:6
+#, no-wrap
+msgid ""
+" # Add an entry\n"
+" $pofile->push('msgid' => 'Hello', 'msgstr' => 'bonjour',\n"
+" 'flags' => \"wrap\", 'reference'=>'file.c:46');\n"
+"\n"
+msgstr ""
+
+#. type: verbatim
+#: lib/Locale/Po4a/Po.pm:7
+#, no-wrap
+msgid ""
+" # Extract a translation\n"
+" $pofile->gettext(\"Hello\"); # returns 'bonjour'\n"
+"\n"
+msgstr ""
+
+#. type: verbatim
+#: lib/Locale/Po4a/Po.pm:8
+#, no-wrap
+msgid ""
+" # Write back to a file\n"
+" $pofile->write('otherfile.po');\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Po.pm:10
+msgid ""
+"Locale::Po4a::Po is a module that allows you to manipulate message catalogs. "
+"You can load and write from/to a file (which extension is often I<po>), you "
+"can build new entries on the fly or request for the translation of a string."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Po.pm:11
+msgid ""
+"For a more complete description of message catalogs in the PO format and "
+"their use, please refer to the info documentation of the gettext program "
+"(node \"`PO Files\"')."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Po.pm:12
+msgid ""
+"This module is part of the po4a project, which objective is to use PO files "
+"(designed at origin to ease the translation of program messages) to "
+"translate everything, including documentation (man page, info manual), "
+"package description, debconf templates, and everything which may benefit "
+"from this."
+msgstr ""
+
+#. type: =head1
+#: lib/Locale/Po4a/Po.pm:28
+msgid "Functions concerning entire message catalogs"
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Po.pm:29
+msgid "new()"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Po.pm:30
+msgid ""
+"Creates a new message catalog. If an argument is provided, it's the name of "
+"a PO file we should load."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Po.pm:31
+msgid "read($)"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Po.pm:32
+msgid ""
+"Reads a PO file (which name is given as argument). Previously existing "
+"entries in self are not removed, the new ones are added to the end of the "
+"catalog."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Po.pm:33 lib/Locale/Po4a/TransTractor.pm:81
+msgid "write($)"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Po.pm:34
+msgid "Writes the current catalog to the given file."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Po.pm:35
+msgid "write_if_needed($$)"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Po.pm:36
+msgid ""
+"Like write, but if the PO or POT file already exists, the object will be "
+"written in a temporary file which will be compared with the existing file to "
+"check if the update is needed (this avoids to change a POT just to update a "
+"line reference or the POT-Creation-Date field)."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Po.pm:37
+msgid "filter($)"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Po.pm:38
+msgid ""
+"This function extracts a catalog from an existing one. Only the entries "
+"having a reference in the given file will be placed in the resulting catalog."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Po.pm:39
+msgid ""
+"This function parses its argument, converts it to a Perl function "
+"definition, evals this definition and filters the fields for which this "
+"function returns true."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Po.pm:40
+msgid "I love Perl sometimes ;)"
+msgstr ""
+
+#. type: =head1
+#: lib/Locale/Po4a/Po.pm:41
+msgid "Functions to use a message catalog for translations"
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Po.pm:42
+msgid "gettext($%)"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Po.pm:43
+msgid ""
+"Request the translation of the string given as argument in the current "
+"catalog. The function returns the original (untranslated) string if the "
+"string was not found."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Po.pm:44
+msgid ""
+"After the string to translate, you can pass a hash of extra arguments. Here "
+"are the valid entries:"
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Po.pm:45 lib/Locale/Po4a/Po.pm:75
+#: lib/Locale/Po4a/TransTractor.pm:122 lib/Locale/Po4a/Xml.pm:14
+msgid "B<wrap>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Po.pm:46
+msgid ""
+"boolean indicating whether we can consider that whitespaces in string are "
+"not important. If yes, the function canonizes the string before looking for "
+"a translation, and wraps the result."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Po.pm:47 lib/Locale/Po4a/Po.pm:78
+#: lib/Locale/Po4a/TransTractor.pm:124
+msgid "B<wrapcol>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Po.pm:48
+msgid "the column at which we should wrap (default: 76)."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Po.pm:49
+msgid "stats_get()"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Po.pm:50
+msgid ""
+"Returns statistics about the hit ratio of gettext since the last time that "
+"stats_clear() was called. Please note that it's not the same statistics than "
+"the one printed by msgfmt --statistic. Here, it's statistics about recent "
+"usage of the PO file, while msgfmt reports the status of the file. Example "
+"of use:"
+msgstr ""
+
+#. type: verbatim
+#: lib/Locale/Po4a/Po.pm:51
+#, no-wrap
+msgid ""
+" [some use of the PO file to translate stuff]\n"
+"\n"
+msgstr ""
+
+#. type: verbatim
+#: lib/Locale/Po4a/Po.pm:52
+#, no-wrap
+msgid ""
+" ($percent,$hit,$queries) = $pofile->stats_get();\n"
+" print \"So far, we found translations for $percent\\% ($hit of $queries) of strings.\\n\";\n"
+"\n"
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Po.pm:53
+msgid "stats_clear()"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Po.pm:54
+msgid "Clears the statistics about gettext hits."
+msgstr ""
+
+#. type: =head1
+#: lib/Locale/Po4a/Po.pm:55
+msgid "Functions to build a message catalog"
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Po.pm:56
+msgid "push(%)"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Po.pm:57
+msgid ""
+"Push a new entry at the end of the current catalog. The arguments should "
+"form a hash table. The valid keys are:"
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Po.pm:58
+msgid "B<msgid>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Po.pm:59
+msgid "the string in original language."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Po.pm:60
+msgid "B<msgstr>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Po.pm:61
+msgid "the translation."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Po.pm:62
+msgid "B<reference>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Po.pm:63
+msgid ""
+"an indication of where this string was found. Example: file.c:46 (meaning in "
+"'file.c' at line 46). It can be a space-separated list in case of multiple "
+"occurrences."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Po.pm:64 lib/Locale/Po4a/TransTractor.pm:127
+msgid "B<comment>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Po.pm:65
+msgid ""
+"a comment added here manually (by the translators). The format here is free."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Po.pm:66
+msgid "B<automatic>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Po.pm:67
+msgid ""
+"a comment which was automatically added by the string extraction program. "
+"See the B<--add-comments> option of the B<xgettext> program for more "
+"information."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Po.pm:68
+msgid "B<flags>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Po.pm:69
+msgid "space-separated list of all defined flags for this entry."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Po.pm:70
+msgid ""
+"Valid flags are: B<c-text>, B<python-text>, B<lisp-text>, B<elisp-text>, "
+"B<librep-text>, B<smalltalk-text>, B<java-text>, B<awk-text>, B<object-"
+"pascal-text>, B<ycp-text>, B<tcl-text>, B<wrap>, B<no-wrap> and B<fuzzy>."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Po.pm:71
+msgid "See the gettext documentation for their meaning."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Po.pm:72
+msgid "B<type>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Po.pm:73
+msgid ""
+"this is mostly an internal argument: it is used while gettextizing "
+"documents. The idea here is to parse both the original and the translation "
+"into a PO object, and merge them, using one's msgid as msgid and the other's "
+"msgid as msgstr. To make sure that things get ok, each msgid in PO objects "
+"are given a type, based on their structure (like \"chapt\", \"sect1\", \"p\" "
+"and so on in DocBook). If the types of strings are not the same, that means "
+"that both files do not share the same structure, and the process reports an "
+"error."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Po.pm:74
+msgid ""
+"This information is written as automatic comment in the PO file since this "
+"gives to translators some context about the strings to translate."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Po.pm:76
+msgid ""
+"boolean indicating whether whitespaces can be mangled in cosmetic "
+"reformattings. If true, the string is canonized before use."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Po.pm:77
+msgid ""
+"This information is written to the PO file using the B<wrap> or B<no-wrap> "
+"flag."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Po.pm:79
+msgid "ignored; the key is kept for backward computability."
+msgstr ""
+
+#. type: =head1
+#: lib/Locale/Po4a/Po.pm:80
+msgid "Miscellaneous functions"
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Po.pm:81
+msgid "count_entries()"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Po.pm:82
+msgid "Returns the number of entries in the catalog (without the header)."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Po.pm:83
+msgid "count_entries_doc()"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Po.pm:84
+msgid ""
+"Returns the number of entries in document. If a string appears multiple "
+"times in the document, it will be counted multiple times."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Po.pm:85
+msgid "msgid($)"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Po.pm:86
+msgid "Returns the msgid of the given number."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Po.pm:87
+msgid "msgid_doc($)"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Po.pm:88
+msgid "Returns the msgid with the given position in the document."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Po.pm:89
+msgid "type_doc($)"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Po.pm:90
+msgid ""
+"Returns the type of the msgid with the given position in the document. This "
+"is probably only useful to gettextization, and it's stored separately from "
+"{$msgid}{'type'} because the later location may be overwritten by another "
+"type when the $msgid is duplicated in the master document."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Po.pm:91
+msgid "get_charset()"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Po.pm:92
+msgid ""
+"Returns the character set specified in the PO header. If it hasn't been set, "
+"it will return \"UTF-8\"."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Pod.pm:2
+msgid "Locale::Po4a::Pod - convert POD data from/to PO files"
+msgstr ""
+
+#. type: verbatim
+#: lib/Locale/Po4a/Pod.pm:4
+#, no-wrap
+msgid ""
+" use Locale::Po4a::Pod;\n"
+" my $parser = Locale::Po4a::Pod->new();\n"
+"\n"
+msgstr ""
+
+#. type: verbatim
+#: lib/Locale/Po4a/Pod.pm:5
+#, no-wrap
+msgid ""
+" # Read POD from STDIN and write to STDOUT.\n"
+" $parser->parse_from_filehandle;\n"
+"\n"
+msgstr ""
+
+#. type: verbatim
+#: lib/Locale/Po4a/Pod.pm:6
+#, no-wrap
+msgid ""
+" # Read POD from file.pod and write to file.txt.\n"
+" $parser->parse_from_file ('file.pod', 'file.txt');\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Pod.pm:8
+msgid ""
+"Locale::Po4a::Pod is a module to help the translation of documentation in "
+"the POD format (the preferred language for documenting Perl) into other "
+"[human] languages."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Pod.pm:10
+msgid ""
+"I think that this module is rock stable, and there is only one known bug "
+"with F</usr/lib/perl5/Tk/MainWindow.pod> (and some other pages, see below) "
+"which contains:"
+msgstr ""
+
+#. type: verbatim
+#: lib/Locale/Po4a/Pod.pm:11
+#, no-wrap
+msgid ""
+" C<\" #n\">\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Pod.pm:12
+msgid ""
+"Lack of luck, in the po4a version, this was split on the space by the "
+"wrapping. As result, in the original version, the man page contains:"
+msgstr ""
+
+#. type: verbatim
+#: lib/Locale/Po4a/Pod.pm:13
+#, no-wrap
+msgid ""
+" \" #n\"\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Pod.pm:14
+msgid "and mine contains:"
+msgstr ""
+
+#. type: verbatim
+#: lib/Locale/Po4a/Pod.pm:15
+#, no-wrap
+msgid ""
+" \"\" #n\"\"\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Pod.pm:16
+msgid "which is logic since CE<lt>foobarE<gt> is rewritten \"foobar\"."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Pod.pm:17
+msgid ""
+"Complete list of pages having this problem on my box (from 564 pages; note "
+"that it depends on the chosen wrapping column):"
+msgstr ""
+
+#. type: verbatim
+#: lib/Locale/Po4a/Pod.pm:18
+#, no-wrap
+msgid ""
+" /usr/lib/perl5/Tk/MainWindow.pod\n"
+" /usr/share/perl/5.8.0/overload.pod\n"
+" /usr/share/perl/5.8.0/pod/perlapi.pod\n"
+" /usr/share/perl/5.8.0/pod/perldelta.pod\n"
+" /usr/share/perl/5.8.0/pod/perlfaq5.pod\n"
+" /usr/share/perl/5.8.0/pod/perlpod.pod\n"
+" /usr/share/perl/5.8.0/pod/perlre.pod\n"
+" /usr/share/perl/5.8.0/pod/perlretut.pod\n"
+"\n"
+msgstr ""
+
+#. type: =head1
+#: lib/Locale/Po4a/Pod.pm:19
+msgid "INTERNALS"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Pod.pm:20
+msgid ""
+"As a derived class from Pod::Parser, Locale::Po4a::Pod supports the same "
+"methods and interfaces. See L<Pod::Parser> for all the details; briefly, "
+"one creates a new parser with C<< Locale::Po4a::Pod->new() >> and then calls "
+"either parse_from_filehandle() or parse_from_file()."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Pod.pm:22
+msgid ""
+"L<Pod::Parser>, L<Locale::Po4a::Man(3pm)>, L<Locale::Po4a::"
+"TransTractor(3pm)>, L<po4a(7)|po4a.7>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/RubyDoc.pm:2
+msgid "Locale::Po4a::RubyDoc -- Convert Ruby Document data from/to PO files"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/RubyDoc.pm:5
+msgid ""
+"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."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/RubyDoc.pm:7
+msgid ""
+"This module has been successfully tested on simple Ruby Document files "
+"covering a good part of the format syntax."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/RubyDoc.pm:8
+msgid ""
+"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..."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/RubyDoc.pm:10
+msgid "This module supports the following option:"
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/RubyDoc.pm:11
+msgid "B<puredoc>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/RubyDoc.pm:12
+msgid ""
+"Handle files entirely made of Ruby Document formatted text (without any "
+"\"=begin\" line)."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/RubyDoc.pm:13
+msgid ""
+"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)."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/RubyDoc.pm:15
+msgid "L<Locale::Po4a::TransTractor(3pm)>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/RubyDoc.pm:17
+msgid "Francesco Poli <invernomuto@paranoici.org>"
+msgstr ""
+
+#. type: verbatim
+#: lib/Locale/Po4a/RubyDoc.pm:19
+#, no-wrap
+msgid ""
+" Copyright © 2016-2017 Francesco Poli <invernomuto@paranoici.org>\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/RubyDoc.pm:20
+msgid ""
+"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."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/RubyDoc.pm:21
+msgid ""
+"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."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/RubyDoc.pm:22
+msgid ""
+"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."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/RubyDoc.pm:23
+msgid ""
+"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:"
+msgstr ""
+
+#. type: verbatim
+#: lib/Locale/Po4a/RubyDoc.pm:24
+#, no-wrap
+msgid ""
+" Copyright © 2004 MoonWolf <moonwolf@moonwolf.com>\n"
+" Copyright © 2011-2012 Youhei SASAKI <uwabami@gfd-dennou.org>\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/RubyDoc.pm:25
+msgid ""
+"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:"
+msgstr ""
+
+#. type: verbatim
+#: lib/Locale/Po4a/RubyDoc.pm:26
+#, no-wrap
+msgid ""
+" Copyright © 2005-2008 Nicolas FRANÇOIS <nicolas.francois@centraliens.net>\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Sgml.pm:2
+msgid "Locale::Po4a::Sgml - convert SGML documents from/to PO files"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Sgml.pm:5
+msgid ""
+"Locale::Po4a::Sgml is a module to help the translation of documentation in "
+"the SGML format into other [human] languages."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Sgml.pm:6
+msgid ""
+"This module uses B<onsgmls>(1) to parse the SGML files. Make sure it is "
+"installed. Also make sure that the DTD of the SGML files are installed in "
+"the system."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Sgml.pm:9
+msgid ""
+"Space-separated list of keywords indicating which category of extra debug "
+"messages should be shown. Possible values are: C<entities>, C<generic>, "
+"C<onsgml>, C<refs> and C<tag>."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Sgml.pm:11
+msgid "Give more information about what's going on."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Sgml.pm:12 lib/Locale/Po4a/TeX.pm:60
+msgid "B<translate>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Sgml.pm:13
+msgid ""
+"Space-separated list of extra tags (beside the DTD provided ones) whose "
+"content should form an extra msgid, i.e that should be translated."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Sgml.pm:14
+msgid "B<section>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Sgml.pm:15
+msgid ""
+"Space-separated list of extra tags (beside the DTD provided ones) "
+"containing other tags, some of them being of category B<translate>."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Sgml.pm:16
+msgid "B<indent>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Sgml.pm:17
+msgid ""
+"Space-separated list of tags which increase the indentation level. This will "
+"affect the identation in the resulting document."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Sgml.pm:18 lib/Locale/Po4a/TeX.pm:23
+#: lib/Locale/Po4a/Text.pm:19
+msgid "B<verbatim>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Sgml.pm:19
+msgid ""
+"The layout within those tags should not be changed. The paragraph won't get "
+"wrapped, and no extra indentation space or new line will be added for "
+"cosmetic purpose."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Sgml.pm:20
+msgid "B<empty>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Sgml.pm:21
+msgid "Tags not needing to be closed."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Sgml.pm:22
+msgid "B<ignore>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Sgml.pm:23
+msgid ""
+"Tags ignored and considered as plain char data by po4a. That is to say that "
+"they can be part of an msgid. For example, E<lt>bE<gt> is a good candidate "
+"for this category since putting it in the B<translate> section would create "
+"a msgids with only its content, (and it's ususally not a whole sentence), "
+"which is bad."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Sgml.pm:24 lib/Locale/Po4a/Xml.pm:48
+msgid "B<attributes>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Sgml.pm:25
+msgid ""
+"A space-separated list of attributes that need to be translated. You can "
+"specify the attributes by their name (for example, C<lang>), but you can "
+"also prefix it with a tag hierarchy, to specify that this attribute will "
+"only be translated when it is into the specified tag. For example: C<< "
+"<bbb><aaa>lang >> specifies that the lang attribute will only be translated "
+"if it is in an C<< <aaa> >> tag, which is in a C<< <bbb> >> tag. The tag "
+"names are actually regular expressions so you can also write things like C<< "
+"<aaa|bbb>lang >> to only translate C<lang> attributes that are in an C<< "
+"<aaa> >> or a C<< <bbb> >> tag."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Sgml.pm:26
+msgid "B<qualify>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Sgml.pm:27
+msgid ""
+"A space-separated list of attributes for which the translation must be "
+"qualified by the attribute name, i.e. the text extracted for the "
+"transalation will include both the attributes name and it's value. e.g. for "
+"a tag like C<< <aaa lang_en=\"foo\"> >> translators will be presented with "
+"the string C<lang_en=\"foo\">. Note that this also automatically adds the "
+"given attribute into the B<attributes> list too."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Sgml.pm:28
+msgid "B<force>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Sgml.pm:29
+msgid ""
+"Proceed even if the DTD is unknown or if B<onsgmls> finds errors in the "
+"input file."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Sgml.pm:30
+msgid "B<include-all>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Sgml.pm:31
+msgid ""
+"By default, msgids containing only one entity (like C<&version;>) are "
+"skipped for the translators' comfort. Activating this option prevents this "
+"optimisation. It can be useful if the document contains a construction like "
+"C<< <title>&Aacute;</title> >>, even if I doubt such things to ever happen..."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Sgml.pm:32
+msgid "B<ignore-inclusion>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Sgml.pm:33
+msgid ""
+"Space-separated list of entities that won't be inlined. Use this option "
+"with caution: it may cause B<onsgmls> (used internally) to add tags and "
+"render the output document invalid."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Sgml.pm:35
+msgid ""
+"The result is perfect. I.e., the generated documents are exactly the same as "
+"the originals. But there are still some problems:"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Sgml.pm:37
+msgid ""
+"The error output of B<onsgmls> is redirected to /dev/null by default, which "
+"is clearly bad. I don't know how to avoid that."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Sgml.pm:38
+msgid ""
+"The problem is that I have to \"protect\" the conditional inclusions (i.e. "
+"the C<E<lt>! [ %foo [> and C<]]E<gt>> stuff) from B<onsgmls>. Otherwise "
+"B<onsgmls> eats them, and I don't know how to restore them in the final "
+"document. To prevent that, I rewrite them to C<{PO4A-beg-foo}> and C<{PO4A-"
+"end}>."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Sgml.pm:39
+msgid ""
+"The problem with this is that the C<{PO4A-end}> and such I add are invalid "
+"in the document (not in a E<lt>pE<gt> tag or so)."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Sgml.pm:40
+msgid ""
+"If you want to view the B<onsgmls> output, just add the following to your "
+"command line (or po4a configuration line):"
+msgstr ""
+
+#. type: verbatim
+#: lib/Locale/Po4a/Sgml.pm:41
+#, no-wrap
+msgid ""
+" -o debug=onsgmls\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Sgml.pm:43
+msgid ""
+"It does work only with the DebianDoc and DocBook DTD. Adding support for a "
+"new DTD should be very easy. The mechanism is the same for every DTD, you "
+"just have to give a list of the existing tags and some of their "
+"characteristics."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Sgml.pm:44
+msgid ""
+"I agree, this needs some more documentation, but it is still considered as "
+"beta, and I hate to document stuff which may/will change."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Sgml.pm:46
+msgid ""
+"Warning, support for DTDs is quite experimental. I did not read any "
+"reference manual to find the definition of every tag. I did add tag "
+"definition to the module 'till it works for some documents I found on the "
+"net. If your document use more tags than mine, it won't work. But as I said "
+"above, fixing that should be quite easy."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Sgml.pm:47
+msgid ""
+"I did test DocBook against the SAG (System Administrator Guide) only, but "
+"this document is quite big, and should use most of the DocBook specificities."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Sgml.pm:48
+msgid ""
+"For DebianDoc, I tested some of the manuals from the DDP, but not all yet."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Sgml.pm:50
+msgid ""
+"In case of file inclusion, string reference of messages in PO files (i.e. "
+"lines like C<#: en/titletoc.sgml:9460>) will be wrong."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Sgml.pm:51
+msgid ""
+"This is because I preprocess the file to protect the conditional inclusion "
+"(i.e. the C<E<lt>! [ %foo [> and C<]]E<gt>> stuff) and some entities (like "
+"C<&version;>) from B<onsgmls> because I want them verbatim to the generated "
+"document. For that, I make a temp copy of the input file and do all the "
+"changes I want to this before passing it to B<onsgmls> for parsing."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Sgml.pm:52
+msgid ""
+"So that it works, I replace the entities asking for a file inclusion by the "
+"content of the given file (so that I can protect what needs to be in a "
+"subfile also). But nothing is done so far to correct the references (i.e., "
+"filename and line number) afterward. I'm not sure what the best thing to do "
+"is."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Sgml.pm:54
+msgid ""
+"This module is an adapted version of sgmlspl (SGML postprocessor for the "
+"ONSGMLS parser) which was:"
+msgstr ""
+
+#. type: verbatim
+#: lib/Locale/Po4a/Sgml.pm:55
+#, no-wrap
+msgid ""
+" Copyright © 1995 David Megginson <dmeggins@aix1.uottawa.ca>\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Sgml.pm:56
+msgid "The adaptation for po4a was done by:"
+msgstr ""
+
+#. type: verbatim
+#: lib/Locale/Po4a/Sgml.pm:59
+#, no-wrap
+msgid ""
+" Copyright © 1995 David Megginson <dmeggins@aix1.uottawa.ca>.\n"
+" Copyright © 2002-2005 SPI, Inc.\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TeX.pm:2
+msgid ""
+"Locale::Po4a::TeX - convert TeX documents and derivatives from/to PO files"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TeX.pm:5
+msgid ""
+"Locale::Po4a::TeX is a module to help the translation of TeX documents into "
+"other [human] languages. It can also be used as a base to build modules for "
+"TeX-based documents."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TeX.pm:6
+msgid ""
+"Users should probably use the LaTeX module, which inherits from the TeX "
+"module and contains the definitions of common LaTeX commands."
+msgstr ""
+
+#. type: =head1
+#: lib/Locale/Po4a/TeX.pm:7
+msgid "TRANSLATING WITH PO4A::TEX"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TeX.pm:8
+msgid ""
+"This module can be used directly to handle generic TeX documents. This will "
+"split your document in smaller blocks (paragraphs, verbatim blocks, or even "
+"smaller like titles or indexes)."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TeX.pm:9
+msgid ""
+"There are some options (described in the next section) that can customize "
+"this behavior. If this doesn't fit to your document format you're "
+"encouraged to write your own derivative module from this, to describe your "
+"format's details. See the section B<WRITING DERIVATIVE MODULES> below, for "
+"the process description."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TeX.pm:10
+msgid ""
+"This module can also be customized by lines starting with \"% po4a:\" in the "
+"TeX file. This process is described in the B<INLINE CUSTOMIZATION> section."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TeX.pm:16
+msgid "Comma-separated list of environments which should not be re-wrapped."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TeX.pm:17
+msgid ""
+"Note that there is a difference between verbatim and no_wrap environments. "
+"There is no command and comments analysis in verbatim blocks."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TeX.pm:18 lib/Locale/Po4a/TeX.pm:25
+#: lib/Locale/Po4a/TeX.pm:54
+msgid ""
+"If this environment was not already registered, po4a will consider that this "
+"environment does not take any parameters."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/TeX.pm:19
+msgid "B<exclude_include>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TeX.pm:20
+msgid ""
+"Colon-separated list of files that should not be included by \\input and "
+"\\include."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TeX.pm:24
+msgid "Comma-separated list of environments which should be taken as verbatim."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TeX.pm:26
+msgid ""
+"Use these options to override the default behavior of the defined commands."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TeX.pm:28
+msgid ""
+"The TeX module can be customized with lines starting by B<% po4a:>. These "
+"lines are interpreted as commands to the parser. The following commands are "
+"recognized:"
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/TeX.pm:29
+msgid "B<% po4a: command> I<command1> B<alias> I<command2>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TeX.pm:30
+msgid ""
+"Indicates that the arguments of the I<command1> command should be treated as "
+"the arguments of the I<command2> command."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/TeX.pm:31
+msgid "B<% po4a: command> I<command1> I<parameters>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TeX.pm:32
+msgid ""
+"This describes in detail the parameters of the I<command1> command. This "
+"information will be used to check the number of arguments and their types."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TeX.pm:33
+msgid "You can precede the I<command1> command by"
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/TeX.pm:34
+msgid "an asterisk (B<*>)"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TeX.pm:35
+msgid ""
+"po4a will extract this command from paragraphs (if it is located at the "
+"beginning or the end of a paragraph). The translators will then have to "
+"translate the parameters that are marked as translatable."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/TeX.pm:36
+msgid "a plus (B<+>)"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TeX.pm:37
+msgid ""
+"As for an asterisk, the command will be extracted if it appear at an "
+"extremity of a block, but the parameters won't be translated separately. "
+"The translator will have to translate the command concatenated to all its "
+"parameters. This keeps more context, and is useful for commands with small "
+"words in parameter, which can have multiple meanings (and translations)."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TeX.pm:38
+msgid ""
+"Note: In this case you don't have to specify which parameters are "
+"translatable, but po4a must know the type and number of parameters."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/TeX.pm:39
+msgid "a minus (B<->)"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TeX.pm:40
+msgid ""
+"In this case, the command won't be extracted from any block. But if it "
+"appears alone on a block, then only the parameters marked as translatable "
+"will be presented to the translator. This is useful for font commands. "
+"These commands should generally not be separated from their paragraph (to "
+"keep the context), but there is no reason to annoy the translator with them "
+"if a whole string is enclosed in such a command."
+msgstr ""
+
+#. type: verbatim
+#: lib/Locale/Po4a/TeX.pm:41
+#, no-wrap
+msgid ""
+"The I<parameters> argument is a set of [] (to indicate an optional\n"
+"argument) or {} (to indicate a mandatory argument).\n"
+"You can place an underscore (_) between these brackets to indicate that\n"
+"the parameter must be translated. For example:\n"
+" % po4a: command *chapter [_]{_}\n"
+"\n"
+msgstr ""
+
+#. type: verbatim
+#: lib/Locale/Po4a/TeX.pm:42
+#, no-wrap
+msgid ""
+"This indicates that the chapter command has two parameters: an optional\n"
+"(short title) and a mandatory one, which must both be translated.\n"
+"If you want to specify that the href command has two mandatory parameters,\n"
+"that you don't want to translate the URL (first parameter), and that you\n"
+"don't want this command to be separated from its paragraph (which allow\n"
+"the translator to move the link in the sentence), you can use:\n"
+" % po4a: command -href {}{_}\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TeX.pm:43
+msgid ""
+"In this case, the information indicating which arguments must be translated "
+"is only used if a paragraph is only composed of this href command."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/TeX.pm:44
+msgid "B<% po4a: environment> I<env> I<parameters>"
+msgstr ""
+
+#. type: verbatim
+#: lib/Locale/Po4a/TeX.pm:45
+#, no-wrap
+msgid ""
+"This defines the parameters accepted by the I<env> environment and specifies the ones to be translated.\n"
+"This information is later used to check the number of arguments of the\n"
+"\\begin command.\n"
+"The syntax of the I<parameters> argument is the same as described for the\n"
+"others commands.\n"
+"The first parameter of the \\begin command is the name of the environment.\n"
+"This parameter must not be specified in the list of parameters. Here are\n"
+"some examples:\n"
+" % po4a: environment multicols {}\n"
+" % po4a: environment equation\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TeX.pm:46
+msgid ""
+"As for the commands, I<env> can be preceded by a plus (+) to indicate that "
+"the \\begin command must be translated with all its arguments."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/TeX.pm:47
+msgid "B<% po4a: separator> I<env> B<\">I<regex>B<\">"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TeX.pm:48
+msgid ""
+"Indicates that an environment should be split according to the given regular "
+"expression."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TeX.pm:49
+msgid ""
+"The regular expression is delimited by quotes. It should not create any "
+"back-reference. You should use (?:) if you need a group. It may also need "
+"some escapes."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TeX.pm:50
+msgid ""
+"For example, the LaTeX module uses the \"(?:&|\\\\\\\\)\" regular expression "
+"to translate separately each cell of a table (lines are separated by '\\\\' "
+"and cells by '&')."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TeX.pm:51
+msgid ""
+"The notion of environment is expanded to the type displayed in the PO file. "
+"This can be used to split on \"\\\\\\\\\" in the first mandatory argument of "
+"the title command. In this case, the environment is title{#1}."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/TeX.pm:52
+msgid "B<% po4a: verbatim environment> I<env>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TeX.pm:53
+msgid ""
+"Indicate that I<env> is a verbatim environment. Comments and commands will "
+"be ignored in this environment."
+msgstr ""
+
+#. type: =head1
+#: lib/Locale/Po4a/TeX.pm:55
+msgid "WRITING DERIVATE MODULES"
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/TeX.pm:56
+msgid "B<pre_trans>"
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/TeX.pm:57
+msgid "B<post_trans>"
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/TeX.pm:58
+msgid "B<add_comment>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TeX.pm:59
+msgid ""
+"Add a string as a comment to be added around the next translated element. "
+"This is mostly useful to the texinfo module, as comments are automatically "
+"handled in TeX."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TeX.pm:61
+msgid ""
+"Wrapper around Transtractor's translate, with pre- and post-processing "
+"filters."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TeX.pm:62
+msgid ""
+"Comments of a paragraph are inserted as a PO comment for the first "
+"translated string of this paragraph."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/TeX.pm:63
+msgid "B<get_leading_command>($buffer)"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TeX.pm:64
+msgid "This function returns:"
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/TeX.pm:65 lib/Locale/Po4a/TeX.pm:93
+msgid "A command name"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TeX.pm:66
+msgid ""
+"If no command is found at the beginning of the given buffer, this string "
+"will be empty. Only commands that can be separated are considered. The "
+"%separated_command hash contains the list of these commands."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/TeX.pm:67 lib/Locale/Po4a/TeX.pm:94
+msgid "A variant"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TeX.pm:68
+msgid ""
+"This indicates if a variant is used. For example, an asterisk (*) can be "
+"added at the end of sections command to specify that they should not be "
+"numbered. In this case, this field will contain \"*\". If there is no "
+"variant, the field is an empty string."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/TeX.pm:69
+msgid "An array of tuples (type of argument, argument)"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TeX.pm:70
+msgid ""
+"The type of argument can be either '{' (for mandatory arguments) or '[' (for "
+"optional arguments)."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/TeX.pm:71
+msgid "The remaining buffer"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TeX.pm:72
+msgid ""
+"The rest of the buffer after the removal of this leading command and its "
+"arguments. If no command is found, the original buffer is not touched and "
+"returned in this field."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/TeX.pm:73
+msgid "B<get_trailing_command>($buffer)"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TeX.pm:74
+msgid ""
+"The same as B<get_leading_command>, but for commands at the end of a buffer."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/TeX.pm:75
+msgid "B<translate_buffer>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TeX.pm:76
+msgid ""
+"Recursively translate a buffer by separating leading and trailing commands "
+"(those which should be translated separately) from the buffer."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TeX.pm:77
+msgid ""
+"If a function is defined in %translate_buffer_env for the current "
+"environment, this function will be used to translate the buffer instead of "
+"translate_buffer()."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/TeX.pm:78
+msgid "B<read>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TeX.pm:79
+msgid "Overloads Transtractor's read()."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/TeX.pm:80
+msgid "B<read_file>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TeX.pm:81
+msgid ""
+"Recursively read a file, appending included files which are not listed in "
+"the @exclude_include array. Included files are searched using the "
+"B<kpsewhich> command from the Kpathsea library."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TeX.pm:82
+msgid ""
+"Except from the file inclusion part, it is a cut and paste from "
+"Transtractor's read."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/TeX.pm:83
+msgid "B<parse_definition_file>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TeX.pm:84
+msgid ""
+"Subroutine for parsing a file with po4a directives (definitions for new "
+"commands)."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/TeX.pm:85
+msgid "B<parse_definition_line>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TeX.pm:86
+msgid "Parse a definition line of the form \"% po4a: \"."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TeX.pm:87
+msgid "See the B<INLINE CUSTOMIZATION> section for more details."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/TeX.pm:88
+msgid "B<is_closed>"
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/TeX.pm:89
+msgid "B<parse>"
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/TeX.pm:90
+msgid "B<docheader>"
+msgstr ""
+
+#. type: =head1
+#: lib/Locale/Po4a/TeX.pm:91 lib/Locale/Po4a/TransTractor.pm:97
+#: lib/Locale/Po4a/Xml.pm:134
+msgid "INTERNAL FUNCTIONS used to write derivative parsers"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TeX.pm:92
+msgid ""
+"Command and environment functions take the following arguments (in addition "
+"to the $self object):"
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/TeX.pm:95
+msgid "An array of (type, argument) tuples"
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/TeX.pm:96
+msgid "The current environment"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TeX.pm:97
+msgid ""
+"The first 3 arguments are extracted by get_leading_command or "
+"get_trailing_command."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TeX.pm:98
+msgid ""
+"Command and environment functions return the translation of the command with "
+"its arguments and a new environment."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TeX.pm:99
+msgid ""
+"Environment functions are called when a \\begin command is found. They are "
+"called with the \\begin command and its arguments."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TeX.pm:100
+msgid ""
+"The TeX module only proposes one command function and one environment "
+"function: generic_command and generic_environment."
+msgstr ""
+
+#. type: verbatim
+#: lib/Locale/Po4a/TeX.pm:101
+#, no-wrap
+msgid ""
+"generic_command uses the information specified by\n"
+"register_generic_command or by adding definition to the TeX file:\n"
+" % po4a: command I<command1> I<parameters>\n"
+"\n"
+msgstr ""
+
+#. type: verbatim
+#: lib/Locale/Po4a/TeX.pm:102
+#, no-wrap
+msgid ""
+"generic_environment uses the information specified by\n"
+"register_generic_environment or by adding definition to the TeX file:\n"
+" % po4a: environment I<env> I<parameters>\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TeX.pm:103
+msgid ""
+"Both functions will only translate the parameters that were specified as "
+"translatable (with a '_'). generic_environment will append the name of the "
+"environment to the environment stack and generic_command will append the "
+"name of the command followed by an identifier of the parameter (like {#7} or "
+"[#2])."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TeX.pm:105
+msgid "This module needs more tests."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TeX.pm:106
+msgid "It was tested on a book and with the Python documentation."
+msgstr ""
+
+#. type: =head1
+#: lib/Locale/Po4a/TeX.pm:107 lib/Locale/Po4a/Xml.pm:183
+msgid "TODO LIST"
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/TeX.pm:108
+msgid "Automatic detection of new commands"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TeX.pm:109
+msgid ""
+"The TeX module could parse the newcommand arguments and try to guess the "
+"number of arguments, their type and whether or not they should be translated."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/TeX.pm:110
+msgid "Translation of the environment separator"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TeX.pm:111
+msgid ""
+"When \\item is used as an environment separator, the item argument is "
+"attached to the following string."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/TeX.pm:112
+msgid "Some commands should be added to the environment stack"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TeX.pm:113
+msgid ""
+"These commands should be specified by couples. This can be used to specify "
+"commands beginning or ending a verbatim environment."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/TeX.pm:114
+msgid "Others"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TeX.pm:115
+msgid "Various other points are tagged TODO in the source."
+msgstr ""
+
+#. type: =head1
+#: lib/Locale/Po4a/TeX.pm:116
+msgid "KNOWN BUGS"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TeX.pm:117
+msgid "Various points are tagged FIXME in the source."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TeX.pm:119
+msgid ""
+"L<Locale::Po4a::LaTeX(3pm)|Locale::Po4a::LaTeX>, L<Locale::Po4a::"
+"TransTractor(3pm)|Locale::Po4a::TransTractor>, L<po4a(7)|po4a.7>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Texinfo.pm:2
+msgid ""
+"Locale::Po4a::Texinfo - convert Texinfo documents and derivates from/to PO "
+"files"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Texinfo.pm:5
+msgid ""
+"Locale::Po4a::Texinfo is a module to help the translation of Texinfo "
+"documents into other [human] languages."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Texinfo.pm:6
+msgid ""
+"This module contains the definitions of common Texinfo commands and "
+"environments."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Texinfo.pm:7
+msgid ""
+"Only the comments starting with 'TRANSLATORS' are added to the PO files to "
+"guide the translators."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Texinfo.pm:9
+msgid ""
+"This module is still beta and not ready for production use. Please send "
+"patches to contribute, not bug reports as we don't know how to deal with "
+"them."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Texinfo.pm:12
+msgid "no-warn"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Texinfo.pm:13
+msgid "Do not warn about the current state of this module."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Texinfo.pm:19
+msgid ""
+"Copyright © 2004-2007 Nicolas FRANÇOIS <nicolas.francois@centraliens.net>."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Text.pm:2
+msgid "Locale::Po4a::Text - convert text documents from/to PO files"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Text.pm:5
+msgid ""
+"Locale::Po4a::Text is a module to help the translation of text documents "
+"into other [human] languages."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Text.pm:6
+msgid ""
+"Paragraphs are split on empty lines (or lines containing only spaces or "
+"tabulations)."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Text.pm:7
+msgid ""
+"If a paragraph contains a line starting by a space (or tabulation), this "
+"paragraph won't be rewrapped."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Text.pm:10
+msgid "B<keyvalue>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Text.pm:11
+msgid ""
+"Treat paragraphs that look like a colon-separated key-value pair as verbatim "
+"(with the C<no-wrap> flag in the PO file). A key-value pair string is a "
+"string like C<key: value>, containing one or more non-colon and non-space "
+"characters followed by a colon followed by at least one non-space character "
+"before the end of the line."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Text.pm:12
+msgid "B<nobullets>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Text.pm:13
+msgid "Deactivate the detection of bullets."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Text.pm:14
+msgid ""
+"By default, when a bullet is detected, the bullet paragraph is not "
+"considered as a verbatim paragraph (with the C<no-wrap> flag in the PO "
+"file). Instead, the corresponding paragraph is rewrapped in the translation."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Text.pm:15
+msgid "B<tabs=>I<mode>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Text.pm:16
+msgid "Specify how tabulations shall be handled. The I<mode> can be any of:"
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Text.pm:17
+msgid "B<split>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Text.pm:18
+msgid "Lines with tabulations introduce breaks in the current paragraph."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Text.pm:20
+msgid "Paragraph containing tabulations will not be re-wrapped."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Text.pm:21
+msgid "By default, tabulations are considered as spaces."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Text.pm:22
+msgid "B<breaks=>I<regex>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Text.pm:23
+msgid ""
+"A regular expression matching lines which introduce breaks. The regular "
+"expression will be anchored so that the whole line must match."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Text.pm:24
+msgid "B<debianchangelog>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Text.pm:25
+msgid ""
+"Handle the header and footer of released versions, which only contain non "
+"translatable information."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Text.pm:26
+msgid "B<fortunes>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Text.pm:27
+msgid ""
+"Handle the fortunes format, which separate fortunes with a line which "
+"consists in '%' or '%%', and use '%%' as the beginning of a comment."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Text.pm:28
+msgid "B<markdown>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Text.pm:29
+msgid "Handle some special markup in Markdown-formatted texts."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Text.pm:30
+msgid "B<yfm_keys> (markdown-only)"
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Text.pm:32
+msgid "B<yfm_lenient> (markdown only)"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Text.pm:33
+msgid ""
+"Allow the YAML Front Matter parser to fail on malformated headers. This is "
+"particularly helpful when your file starts with a horizontal ruler instead "
+"of a YAML Front Matter, but you insist on using three dashes only for your "
+"ruler."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Text.pm:34
+msgid "B<yfm_paths> (markdown only)"
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Text.pm:37
+msgid "B<yfm_skip_array> (markdown-only)"
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Text.pm:39
+msgid "B<control>[B<=>I<field_list>]"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Text.pm:40
+msgid ""
+"Handle Debian's control files. A comma-separated list of fields to be "
+"translated can be provided."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Text.pm:41
+msgid "B<neverwrap>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Text.pm:42
+msgid ""
+"Prevent po4a from wrapping any lines. This means that every content is "
+"handled verbatim, even simple paragraphs."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Text.pm:44
+msgid "Tested successfully on simple text files and NEWS.Debian files."
+msgstr ""
+
+#. type: verbatim
+#: lib/Locale/Po4a/Text.pm:48
+#, no-wrap
+msgid ""
+" Copyright © 2005-2008 Nicolas FRANÇOIS <nicolas.francois@centraliens.net>.\n"
+"\n"
+msgstr ""
+
+#. type: verbatim
+#: lib/Locale/Po4a/Text.pm:49
+#, no-wrap
+msgid ""
+" Copyright © 2008-2009, 2018 Jonas Smedegaard <dr@jones.dk>.\n"
+" Copyright © 2020 Martin Quinson <mquinson#debian.org>.\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TransTractor.pm:2
+msgid "Locale::Po4a::TransTractor - generic trans(lator ex)tractor."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TransTractor.pm:5
+msgid ""
+"This class is the ancestor of every po4a parser used to parse a document, to "
+"search translatable strings, to extract them to a PO file and to replace "
+"them by their translation in the output document."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TransTractor.pm:6
+msgid "More formally, it takes the following arguments as input:"
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/TransTractor.pm:7 lib/Locale/Po4a/TransTractor.pm:9
+#: lib/Locale/Po4a/TransTractor.pm:12 lib/Locale/Po4a/TransTractor.pm:14
+#: lib/Locale/Po4a/TransTractor.pm:114 lib/Locale/Po4a/TransTractor.pm:116
+#: lib/Locale/Po4a/TransTractor.pm:118 lib/Locale/Po4a/TransTractor.pm:130
+#: lib/Locale/Po4a/TransTractor.pm:132 lib/Locale/Po4a/TransTractor.pm:134
+#: lib/Locale/Po4a/TransTractor.pm:149 lib/Locale/Po4a/TransTractor.pm:151
+#: lib/Locale/Po4a/TransTractor.pm:153
+msgid "-"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TransTractor.pm:8
+msgid "a document to translate;"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TransTractor.pm:10
+msgid "a PO file containing the translations to use."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TransTractor.pm:11
+msgid "As output, it produces:"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TransTractor.pm:13
+msgid ""
+"another PO file, resulting of the extraction of translatable strings from "
+"the input document;"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TransTractor.pm:15
+msgid ""
+"a translated document, with the same structure than the one in input, but "
+"with all translatable strings replaced with the translations found in the PO "
+"file provided in input."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TransTractor.pm:16
+msgid "Here is a graphical representation of this:"
+msgstr ""
+
+#. type: verbatim
+#: lib/Locale/Po4a/TransTractor.pm:17
+#, no-wrap
+msgid ""
+" Input document --\\ /---> Output document\n"
+" \\ / (translated)\n"
+" +-> parse() function -----+\n"
+" / \\\n"
+" Input PO --------/ \\---> Output PO\n"
+" (extracted)\n"
+"\n"
+msgstr ""
+
+#. type: =head1
+#: lib/Locale/Po4a/TransTractor.pm:18
+msgid "FUNCTIONS YOUR PARSER SHOULD OVERRIDE"
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/TransTractor.pm:19
+msgid "parse()"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TransTractor.pm:20
+msgid ""
+"This is where all the work takes place: the parsing of input documents, the "
+"generation of output, and the extraction of the translatable strings. This "
+"is pretty simple using the provided functions presented in the section "
+"B<INTERNAL FUNCTIONS> below. See also the B<SYNOPSIS>, which presents an "
+"example."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TransTractor.pm:21
+msgid ""
+"This function is called by the process() function below, but if you choose "
+"to use the new() function, and to add content manually to your document, you "
+"will have to call this function yourself."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/TransTractor.pm:22
+msgid "docheader()"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TransTractor.pm:23
+msgid ""
+"This function returns the header we should add to the produced document, "
+"quoted properly to be a comment in the target language. See the section "
+"B<Educating developers about translations>, from L<po4a(7)|po4a.7>, for what "
+"it is good for."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TransTractor.pm:25
+msgid ""
+"The following example parses a list of paragraphs beginning with \"<p>\". "
+"For the sake of simplicity, we assume that the document is well formatted, i."
+"e. that '<p>' tags are the only tags present, and that this tag is at the "
+"very beginning of each paragraph."
+msgstr ""
+
+#. type: verbatim
+#: lib/Locale/Po4a/TransTractor.pm:26
+#, no-wrap
+msgid ""
+" sub parse {\n"
+" my $self = shift;\n"
+"\n"
+msgstr ""
+
+#. type: verbatim
+#: lib/Locale/Po4a/TransTractor.pm:27
+#, no-wrap
+msgid ""
+" PARAGRAPH: while (1) {\n"
+" my ($paragraph,$pararef)=(\"\",\"\");\n"
+" my $first=1;\n"
+" my ($line,$lref)=$self->shiftline();\n"
+" while (defined($line)) {\n"
+" if ($line =~ m/<p>/ && !$first--; ) {\n"
+" # Not the first time we see <p>.\n"
+" # Reput the current line in input,\n"
+" # and put the built paragraph to output\n"
+" $self->unshiftline($line,$lref);\n"
+"\n"
+msgstr ""
+
+#. type: verbatim
+#: lib/Locale/Po4a/TransTractor.pm:28
+#, no-wrap
+msgid ""
+" # Now that the document is formed, translate it:\n"
+" # - Remove the leading tag\n"
+" $paragraph =~ s/^<p>//s;\n"
+"\n"
+msgstr ""
+
+#. type: verbatim
+#: lib/Locale/Po4a/TransTractor.pm:29
+#, no-wrap
+msgid ""
+" # - push to output the leading tag (untranslated) and the\n"
+" # rest of the paragraph (translated)\n"
+" $self->pushline( \"<p>\"\n"
+" . $self->translate($paragraph,$pararef)\n"
+" );\n"
+"\n"
+msgstr ""
+
+#. type: verbatim
+#: lib/Locale/Po4a/TransTractor.pm:30
+#, no-wrap
+msgid ""
+" next PARAGRAPH;\n"
+" } else {\n"
+" # Append to the paragraph\n"
+" $paragraph .= $line;\n"
+" $pararef = $lref unless(length($pararef));\n"
+" }\n"
+"\n"
+msgstr ""
+
+#. type: verbatim
+#: lib/Locale/Po4a/TransTractor.pm:31
+#, no-wrap
+msgid ""
+" # Reinit the loop\n"
+" ($line,$lref)=$self->shiftline();\n"
+" }\n"
+" # Did not get a defined line? End of input file.\n"
+" return;\n"
+" }\n"
+" }\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TransTractor.pm:32
+msgid ""
+"Once you've implemented the parse function, you can use your document class, "
+"using the public interface presented in the next section."
+msgstr ""
+
+#. type: =head1
+#: lib/Locale/Po4a/TransTractor.pm:33
+msgid "PUBLIC INTERFACE for scripts using your parser"
+msgstr ""
+
+#. type: =head2
+#: lib/Locale/Po4a/TransTractor.pm:34
+msgid "Constructor"
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/TransTractor.pm:35
+msgid "process(%)"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TransTractor.pm:36
+msgid ""
+"This function can do all you need to do with a po4a document in one "
+"invocation. Its arguments must be packed as a hash. ACTIONS:"
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/TransTractor.pm:37
+msgid "a."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TransTractor.pm:38
+msgid "Reads all the PO files specified in po_in_name"
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/TransTractor.pm:39
+msgid "b."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TransTractor.pm:40
+msgid "Reads all original documents specified in file_in_name"
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/TransTractor.pm:41
+msgid "c."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TransTractor.pm:42
+msgid "Parses the document"
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/TransTractor.pm:43
+msgid "d."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TransTractor.pm:44
+msgid "Reads and applies all the addenda specified"
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/TransTractor.pm:45
+msgid "e."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TransTractor.pm:46
+msgid "Writes the translated document to file_out_name (if given)"
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/TransTractor.pm:47
+msgid "f."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TransTractor.pm:48
+msgid "Writes the extracted PO file to po_out_name (if given)"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TransTractor.pm:49
+msgid "ARGUMENTS, beside the ones accepted by new() (with expected type):"
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/TransTractor.pm:50
+msgid "file_in_name (@)"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TransTractor.pm:51
+msgid "List of filenames where we should read the input document."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/TransTractor.pm:52
+msgid "file_in_charset ($)"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TransTractor.pm:53
+msgid "Charset used in the input document (if it isn't specified, use UTF-8)."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/TransTractor.pm:54
+msgid "file_out_name ($)"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TransTractor.pm:55
+msgid "Filename where we should write the output document."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/TransTractor.pm:56
+msgid "file_out_charset ($)"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TransTractor.pm:57
+msgid "Charset used in the output document (if it isn't specified, use UTF-8)."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/TransTractor.pm:58
+msgid "po_in_name (@)"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TransTractor.pm:59
+msgid ""
+"List of filenames where we should read the input PO files from, containing "
+"the translation which will be used to translate the document."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/TransTractor.pm:60
+msgid "po_out_name ($)"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TransTractor.pm:61
+msgid ""
+"Filename where we should write the output PO file, containing the strings "
+"extracted from the input document."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/TransTractor.pm:62
+msgid "addendum (@)"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TransTractor.pm:63
+msgid "List of filenames where we should read the addenda from."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/TransTractor.pm:64
+msgid "addendum_charset ($)"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TransTractor.pm:65
+msgid "Charset for the addenda."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/TransTractor.pm:66
+msgid "new(%)"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TransTractor.pm:67
+msgid ""
+"Create a new po4a document. Accepted options (in the hash passed as a "
+"parameter):"
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/TransTractor.pm:68
+msgid "verbose ($)"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TransTractor.pm:69
+msgid "Sets the verbosity."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/TransTractor.pm:70
+msgid "debug ($)"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TransTractor.pm:71
+msgid "Sets the debugging."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/TransTractor.pm:72
+msgid "wrapcol ($)"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TransTractor.pm:73
+msgid ""
+"The column at which we should wrap text in output document (default: 76)."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TransTractor.pm:74
+msgid "The negative value means not to wrap lines at all."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TransTractor.pm:75
+msgid ""
+"Also it accepts next options for underlying Po-files: B<porefs>, B<copyright-"
+"holder>, B<msgid-bugs-address>, B<package-name>, B<package-version>, B<wrap-"
+"po>."
+msgstr ""
+
+#. type: =head2
+#: lib/Locale/Po4a/TransTractor.pm:76
+msgid "Manipulating document files"
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/TransTractor.pm:77
+msgid "read($$)"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TransTractor.pm:78
+msgid ""
+"Add another input document data at the end of the existing array C<< @{$self-"
+">{TT}{doc_in}} >>. The argument is the filename to read. If a second "
+"argument is provided, it is the filename to use in the references."
+msgstr ""
+
+#. type: verbatim
+#: lib/Locale/Po4a/TransTractor.pm:79
+#, no-wrap
+msgid ""
+"This array C<< @{$self->{TT}{doc_in}} >> holds this input document data as an\n"
+"array of strings with alternating meanings.\n"
+" * The string C<$textline> holding each line of the input text data.\n"
+" * The string C<< $filename:$linenum >> holding its location and called as\n"
+" \"reference\" (C<linenum> starts with 1).\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TransTractor.pm:80
+msgid ""
+"Please note that it does not parse anything. You should use the parse() "
+"function when you're done with packing input files into the document."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TransTractor.pm:82
+msgid "Write the translated document to the given filename."
+msgstr ""
+
+#. type: verbatim
+#: lib/Locale/Po4a/TransTractor.pm:83
+#, no-wrap
+msgid ""
+"This translated document data are provided by:\n"
+" * C<< $self->docheader() >> holding the header text for the plugin, and\n"
+" * C<< @{$self->{TT}{doc_out}} >> holding each line of the main translated text in the array.\n"
+"\n"
+msgstr ""
+
+#. type: =head2
+#: lib/Locale/Po4a/TransTractor.pm:84
+msgid "Manipulating PO files"
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/TransTractor.pm:85
+msgid "readpo($)"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TransTractor.pm:86
+msgid ""
+"Add the content of a file (which name is passed as argument) to the existing "
+"input PO. The old content is not discarded."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/TransTractor.pm:87
+msgid "writepo($)"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TransTractor.pm:88
+msgid "Write the extracted PO file to the given filename."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/TransTractor.pm:89
+msgid "stats()"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TransTractor.pm:90
+msgid ""
+"Returns some statistics about the translation done so far. Please note that "
+"it's not the same statistics than the one printed by msgfmt --statistic. "
+"Here, it's stats about recent usage of the PO file, while msgfmt reports the "
+"status of the file. It is a wrapper to the Locale::Po4a::Po::stats_get "
+"function applied to the input PO file. Example of use:"
+msgstr ""
+
+#. type: verbatim
+#: lib/Locale/Po4a/TransTractor.pm:91
+#, no-wrap
+msgid ""
+" [normal use of the po4a document...]\n"
+"\n"
+msgstr ""
+
+#. type: verbatim
+#: lib/Locale/Po4a/TransTractor.pm:92
+#, no-wrap
+msgid ""
+" ($percent,$hit,$queries) = $document->stats();\n"
+" print \"We found translations for $percent\\% ($hit from $queries) of strings.\\n\";\n"
+"\n"
+msgstr ""
+
+#. type: =head2
+#: lib/Locale/Po4a/TransTractor.pm:93
+msgid "Manipulating addenda"
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/TransTractor.pm:94
+msgid "addendum($)"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TransTractor.pm:95
+msgid ""
+"Please refer to L<po4a(7)|po4a.7> for more information on what addenda are, "
+"and how translators should write them. To apply an addendum to the "
+"translated document, simply pass its filename to this function and you are "
+"done ;)"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TransTractor.pm:96
+msgid "This function returns a non-null integer on error."
+msgstr ""
+
+#. type: =head2
+#: lib/Locale/Po4a/TransTractor.pm:98
+msgid "Getting input, providing output"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TransTractor.pm:99
+msgid ""
+"Four functions are provided to get input and return output. They are very "
+"similar to shift/unshift and push/pop of Perl."
+msgstr ""
+
+#. type: verbatim
+#: lib/Locale/Po4a/TransTractor.pm:100
+#, no-wrap
+msgid ""
+" * Perl shift returns the first array item and drop it from the array.\n"
+" * Perl unshift prepends an item to the array as the first array item.\n"
+" * Perl pop returns the last array item and drop it from the array.\n"
+" * Perl push appends an item to the array as the last array item.\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TransTractor.pm:101
+msgid ""
+"The first pair is about input, while the second is about output. Mnemonic: "
+"in input, you are interested in the first line, what shift gives, and in "
+"output you want to add your result at the end, like push does."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/TransTractor.pm:102
+msgid "shiftline()"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TransTractor.pm:103
+msgid ""
+"This function returns the first line to be parsed and its corresponding "
+"reference (packed as an array) from the array C<< @{$self->{TT}{doc_in}} >> "
+"and drop these first 2 array items. Here, the reference is provided by a "
+"string C<< $filename:$linenum >>."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/TransTractor.pm:104
+msgid "unshiftline($$)"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TransTractor.pm:105
+msgid ""
+"Unshifts the last shifted line of the input document and its corresponding "
+"reference back to the head of C<< {$self->{TT}{doc_in}} >>."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/TransTractor.pm:106
+msgid "pushline($)"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TransTractor.pm:107
+msgid "Push a new line to the end of C<< {$self->{TT}{doc_out}} >>."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/TransTractor.pm:108
+msgid "popline()"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TransTractor.pm:109
+msgid "Pop the last pushed line from the end of C<< {$self->{TT}{doc_out}} >>."
+msgstr ""
+
+#. type: =head2
+#: lib/Locale/Po4a/TransTractor.pm:110
+msgid "Marking strings as translatable"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TransTractor.pm:111
+msgid "One function is provided to handle the text which should be translated."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/TransTractor.pm:112
+msgid "translate($$$)"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TransTractor.pm:113
+msgid "Mandatory arguments:"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TransTractor.pm:115
+msgid "A string to translate"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TransTractor.pm:117
+msgid "The reference of this string (i.e. position in inputfile)"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TransTractor.pm:119
+msgid ""
+"The type of this string (i.e. the textual description of its structural "
+"role; used in Locale::Po4a::Po::gettextization(); see also L<po4a(7)|"
+"po4a.7>, section B<Gettextization: how does it work?>)"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TransTractor.pm:120
+msgid ""
+"This function can also take some extra arguments. They must be organized as "
+"a hash. For example:"
+msgstr ""
+
+#. type: verbatim
+#: lib/Locale/Po4a/TransTractor.pm:121
+#, no-wrap
+msgid ""
+" $self->translate(\"string\",\"ref\",\"type\",\n"
+" 'wrap' => 1);\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TransTractor.pm:123
+msgid ""
+"boolean indicating whether we can consider that whitespaces in string are "
+"not important. If yes, the function canonizes the string before looking for "
+"a translation or extracting it, and wraps the translation."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TransTractor.pm:125
+msgid ""
+"the column at which we should wrap (default: the value of B<wrapcol> "
+"specified during creation of the TransTractor or 76)."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TransTractor.pm:126
+msgid "The negative value will be substracted from the default."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TransTractor.pm:128
+msgid "an extra comment to add to the entry."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TransTractor.pm:129
+msgid "Actions:"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TransTractor.pm:131
+msgid "Pushes the string, reference and type to po_out."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TransTractor.pm:133
+msgid ""
+"Returns the translation of the string (as found in po_in) so that the parser "
+"can build the doc_out."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TransTractor.pm:135
+msgid ""
+"Handles the charsets to recode the strings before sending them to po_out and "
+"before returning the translations."
+msgstr ""
+
+#. type: =head2
+#: lib/Locale/Po4a/TransTractor.pm:136
+msgid "Misc functions"
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/TransTractor.pm:137
+msgid "verbose()"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TransTractor.pm:138
+msgid ""
+"Returns if the verbose option was passed during the creation of the "
+"TransTractor."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/TransTractor.pm:139
+msgid "debug()"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TransTractor.pm:140
+msgid ""
+"Returns if the debug option was passed during the creation of the "
+"TransTractor."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/TransTractor.pm:141
+msgid "get_in_charset()"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TransTractor.pm:142
+msgid "This function return the charset that was provided as master charset"
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/TransTractor.pm:143
+msgid "get_out_charset()"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TransTractor.pm:144
+msgid ""
+"This function will return the charset that should be used in the output "
+"document (usually useful to substitute the input document's detected charset "
+"where it has been found)."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TransTractor.pm:145
+msgid ""
+"It will use the output charset specified in the command line. If it wasn't "
+"specified, it will use the input PO's charset, and if the input PO has the "
+"default \"CHARSET\", it will return the input document's charset, so that no "
+"encoding is performed."
+msgstr ""
+
+#. type: =head1
+#: lib/Locale/Po4a/TransTractor.pm:146
+msgid "FUTURE DIRECTIONS"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TransTractor.pm:147
+msgid ""
+"One shortcoming of the current TransTractor is that it can't handle "
+"translated document containing all languages, like debconf templates, or ."
+"desktop files."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TransTractor.pm:148
+msgid "To address this problem, the only interface changes needed are:"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TransTractor.pm:150
+msgid "take a hash as po_in_name (a list per language)"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TransTractor.pm:152
+msgid "add an argument to translate to indicate the target language"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TransTractor.pm:154
+msgid ""
+"make a pushline_all function, which would make pushline of its content for "
+"all languages, using a map-like syntax:"
+msgstr ""
+
+#. type: verbatim
+#: lib/Locale/Po4a/TransTractor.pm:155
+#, no-wrap
+msgid ""
+" $self->pushline_all({ \"Description[\".$langcode.\"]=\".\n"
+" $self->translate($line,$ref,$langcode)\n"
+" });\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/TransTractor.pm:156
+msgid "Will see if it's enough ;)"
+msgstr ""
+
+#. type: verbatim
+#: lib/Locale/Po4a/TransTractor.pm:158
+#, no-wrap
+msgid ""
+" Denis Barbier <barbier@linuxfr.org>\n"
+" Martin Quinson (mquinson#debian.org)\n"
+" Jordi Vilalta <jvprat@gmail.com>\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Wml.pm:2
+msgid ""
+"Locale::Po4a::Wml - convert WML (web markup language) documents from/to PO "
+"files"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Wml.pm:5
+msgid ""
+"Locale::Po4a::Wml is a module to help the translation of WML documents into "
+"other [human] languages. Do not mixup the WML we are speaking about here "
+"(web markup language) and the WAP crap used on cell phones."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Wml.pm:6
+msgid ""
+"Please note that this module relies upon the Locale::Po4a::Xhtml module, "
+"which also relies upon the Locale::Po4a::Xml module. This means that all "
+"tags for web page expressions are assumed to be written in the XHTML syntax."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Wml.pm:10
+msgid ""
+"This module works for some simple documents, but is still young. Currently, "
+"the biggest issue of the module is probably that it cannot handle documents "
+"that contain non-XML inline tags such as <email \"foo@example.org\">, which "
+"are often defined in the WML. Improvements will be added in the future "
+"releases."
+msgstr ""
+
+#. type: verbatim
+#: lib/Locale/Po4a/Wml.pm:12
+#, no-wrap
+msgid ""
+" Martin Quinson (mquinson#debian.org)\n"
+" Noriada Kobayashi <nori1@dolphin.c.u-tokyo.ac.jp>\n"
+"\n"
+msgstr ""
+
+#. type: verbatim
+#: lib/Locale/Po4a/Wml.pm:14
+#, no-wrap
+msgid ""
+" Copyright © 2005 SPI, Inc.\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xhtml.pm:2
+msgid "Locale::Po4a::Xhtml - convert XHTML documents from/to PO files"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xhtml.pm:5
+msgid ""
+"Locale::Po4a::Xhtml is a module to help the translation of XHTML documents "
+"into other [human] languages."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Xhtml.pm:8
+msgid "B<includessi>[B<=>I<rootpath>]"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xhtml.pm:9
+msgid ""
+"Include files specified by an include SSI (Server Side Includes) element (e."
+"g. <!--#include virtual=\"/foo/bar.html\" -->)."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xhtml.pm:10
+msgid "B<Note:> You should use it only for static files."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xhtml.pm:11
+msgid ""
+"An additional I<rootpath> parameter can be specified. It specifies the root "
+"path to find files included by a B<virtual> attribute."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xhtml.pm:14
+msgid ""
+"\"It works for me\", which means I use it successfully on my personal Web "
+"site. However, YMMV: please let me know if something doesn't work for you."
+msgstr ""
+
+#. type: verbatim
+#: lib/Locale/Po4a/Xhtml.pm:18
+#, no-wrap
+msgid ""
+" Yves Rütschlé <po4a@rutschle.net>\n"
+" Nicolas François <nicolas.francois@centraliens.net>\n"
+"\n"
+msgstr ""
+
+#. type: verbatim
+#: lib/Locale/Po4a/Xhtml.pm:20
+#, no-wrap
+msgid ""
+" Copyright © 2004 Yves Rütschlé <po4a@rutschle.net>\n"
+" Copyright © 2007-2008 Nicolas François <nicolas.francois@centraliens.net>\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:2
+msgid ""
+"Locale::Po4a::Xml - convert XML documents and derivates from/to PO files"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:5
+msgid ""
+"Locale::Po4a::Xml is a module to help the translation of XML documents into "
+"other [human] languages. It can also be used as a base to build modules for "
+"XML-based documents."
+msgstr ""
+
+#. type: =head1
+#: lib/Locale/Po4a/Xml.pm:6
+msgid "TRANSLATING WITH PO4A::XML"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:7
+msgid ""
+"This module can be used directly to handle generic XML documents. This will "
+"extract all tag's content, and no attributes, since it's where the text is "
+"written in most XML based documents."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:8
+msgid ""
+"There are some options (described in the next section) that can customize "
+"this behavior. If this doesn't fit to your document format you're "
+"encouraged to write your own module derived from this, to describe your "
+"format's details. See the section B<WRITING DERIVATE MODULES> below, for "
+"the process description."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:10
+msgid ""
+"The global debug option causes this module to show the excluded strings, in "
+"order to see if it skips something important."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Xml.pm:12
+msgid "B<nostrip>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:13
+msgid "Prevents it to strip the spaces around the extracted strings."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:15
+msgid ""
+"Canonicalizes the string to translate, considering that whitespaces are not "
+"important, and wraps the translated document. This option can be overridden "
+"by custom tag options. See the B<translated> option below."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Xml.pm:16
+msgid "B<unwrap_attributes>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:17
+msgid "Attributes are wrapped by default. This option disables wrapping."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Xml.pm:18
+msgid "B<caseinsensitive>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:19
+msgid ""
+"It makes the tags and attributes searching to work in a case insensitive "
+"way. If it's defined, it will treat E<lt>BooKE<gt>laNG and "
+"E<lt>BOOKE<gt>Lang as E<lt>bookE<gt>lang."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Xml.pm:20
+msgid "B<escapequotes>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:21
+msgid ""
+"Escape quotes in output strings. Necessary, for example, for creating "
+"string resources for use by Android build tools."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:22
+msgid ""
+"See also: https://developer.android.com/guide/topics/resources/string-"
+"resource.html"
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Xml.pm:23
+msgid "B<includeexternal>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:24
+msgid ""
+"When defined, external entities are included in the generated (translated) "
+"document, and for the extraction of strings. If it's not defined, you will "
+"have to translate external entities separately as independent documents."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Xml.pm:25
+msgid "B<ontagerror>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:26
+msgid ""
+"This option defines the behavior of the module when it encounters invalid "
+"XML syntax (a closing tag which does not match the last opening tag). It "
+"can take the following values:"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:28
+msgid "This is the default value. The module will exit with an error."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Xml.pm:29
+msgid "I<warn>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:30
+msgid "The module will continue, and will issue a warning."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Xml.pm:31
+msgid "I<silent>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:32
+msgid "The module will continue without any warnings."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:33
+msgid ""
+"Be careful when using this option. It is generally recommended to fix the "
+"input file."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Xml.pm:34
+msgid "B<tagsonly>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:35
+msgid "Note: This option is deprecated."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:36
+msgid ""
+"Extracts only the specified tags in the B<tags> option. Otherwise, it will "
+"extract all the tags except the ones specified."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Xml.pm:37
+msgid "B<doctype>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:38
+msgid ""
+"String that will try to match with the first line of the document's doctype "
+"(if defined). If it doesn't, a warning will indicate that the document might "
+"be of a bad type."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Xml.pm:39
+msgid "B<addlang>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:40
+msgid ""
+"String indicating the path (e.g. E<lt>bbbE<gt>E<lt>aaaE<gt>) of a tag where "
+"a lang=\"...\" attribute shall be added. The language will be defined as the "
+"basename of the PO file without any .po extension."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Xml.pm:41
+msgid "B<optionalclosingtag>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:42
+msgid ""
+"Boolean indicating whether closing tags are optional (as in HTML). By "
+"default, missing closing tags raise an error handled according to "
+"B<ontagerror>."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Xml.pm:43
+msgid "B<tags>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:44
+msgid ""
+"Note: This option is deprecated. You should use the B<translated> and "
+"B<untranslated> options instead."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:45
+msgid ""
+"Space-separated list of tags you want to translate or skip. By default, the "
+"specified tags will be excluded, but if you use the \"tagsonly\" option, the "
+"specified tags will be the only ones included. The tags must be in the form "
+"E<lt>aaaE<gt>, but you can join some (E<lt>bbbE<gt>E<lt>aaaE<gt>) to say "
+"that the content of the tag E<lt>aaaE<gt> will only be translated when it's "
+"into a E<lt>bbbE<gt> tag."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:46
+msgid ""
+"You can also specify some tag options by putting some characters in front of "
+"the tag hierarchy. For example, you can put I<w> (wrap) or I<W> (don't "
+"wrap) to override the default behavior specified by the global B<wrap> "
+"option."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:47 lib/Locale/Po4a/Xml.pm:92
+msgid "Example: WE<lt>chapterE<gt>E<lt>titleE<gt>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:49
+msgid ""
+"Space-separated list of tag's attributes you want to translate. You can "
+"specify the attributes by their name (for example, \"lang\"), but you can "
+"prefix it with a tag hierarchy, to specify that this attribute will only be "
+"translated when it's in the specified tag. For example: "
+"E<lt>bbbE<gt>E<lt>aaaE<gt>lang specifies that the lang attribute will only "
+"be translated if it's in an E<lt>aaaE<gt> tag, and it's in a E<lt>bbbE<gt> "
+"tag."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Xml.pm:50
+msgid "B<foldattributes>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:51
+msgid ""
+"Do not translate attributes in inline tags. Instead, replace all attributes "
+"of a tag by po4a-id=<id>."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:52
+msgid ""
+"This is useful when attributes shall not be translated, as this simplifies "
+"the strings for translators, and avoids typos."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Xml.pm:53
+msgid "B<customtag>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:54
+msgid ""
+"Space-separated list of tags which should not be treated as tags. These "
+"tags are treated as inline, and do not need to be closed."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Xml.pm:55
+msgid "B<break>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:56
+msgid ""
+"Space-separated list of tags which should break the sequence. By default, "
+"all tags break the sequence."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:57 lib/Locale/Po4a/Xml.pm:61
+#: lib/Locale/Po4a/Xml.pm:66 lib/Locale/Po4a/Xml.pm:76
+#: lib/Locale/Po4a/Xml.pm:96
+msgid ""
+"The tags must be in the form <aaa>, but you can join some (<bbb><aaa>), if a "
+"tag (<aaa>) should only be considered when it's within another tag (<bbb>)."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:58
+msgid ""
+"Please note a tag should be listed in only one of the B<break>, B<inline> "
+"B<placeholder>, or B<customtag> setting string."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:60
+msgid ""
+"Space-separated list of tags which should be treated as inline. By default, "
+"all tags break the sequence."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Xml.pm:62
+msgid "B<placeholder>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:63
+msgid ""
+"Space-separated list of tags which should be treated as placeholders. "
+"Placeholders do not break the sequence, but the content of placeholders is "
+"translated separately."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:64
+msgid ""
+"The location of the placeholder in its block will be marked with a string "
+"similar to:"
+msgstr ""
+
+#. type: verbatim
+#: lib/Locale/Po4a/Xml.pm:65
+#, no-wrap
+msgid ""
+" <placeholder type=\\\"footnote\\\" id=\\\"0\\\"/>\n"
+"\n"
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Xml.pm:67
+msgid "B<break-pi>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:68
+msgid ""
+"By default, Processing Instructions (i.e., C<E<lt>? ... ?E<gt>> tags) are "
+"handled as inline tags. Pass this option if you want the PI to be handled "
+"as breaking tag. Note that unprocessed PHP tags are handled as Processing "
+"Instructions by the parser."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Xml.pm:69
+msgid "B<nodefault>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:70
+msgid ""
+"Space separated list of tags that the module should not try to set by "
+"default in any category."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:71
+msgid ""
+"If you have a tag which has its default setting by the subclass of this "
+"module but you want to set alternative setting, you need to list that tag as "
+"a part of the B<nodefault> setting string."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Xml.pm:72
+msgid "B<cpp>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:73
+msgid ""
+"Support C preprocessor directives. When this option is set, po4a will "
+"consider preprocessor directives as paragraph separators. This is important "
+"if the XML file must be preprocessed because otherwise the directives may be "
+"inserted in the middle of lines if po4a consider it belong to the current "
+"paragraph, and they won't be recognized by the preprocessor. Note: the "
+"preprocessor directives must only appear between tags (they must not break a "
+"tag)."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Xml.pm:74
+msgid "B<translated>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:75
+msgid "Space-separated list of tags you want to translate."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:77
+msgid ""
+"You can also specify some tag options by putting some characters in front of "
+"the tag hierarchy. This overrides the default behavior specified by the "
+"global B<wrap> and B<defaulttranslateoption> option."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Xml.pm:78
+msgid "I<w>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:79
+msgid "Tags should be translated and content can be re-wrapped."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Xml.pm:80
+msgid "I<W>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:81
+msgid "Tags should be translated and content should not be re-wrapped."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Xml.pm:82
+msgid "I<i>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:83
+msgid "Tags should be translated inline."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Xml.pm:84
+msgid "I<p>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:85
+msgid "Tags should be translated as placeholders."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:86
+msgid ""
+"Internally, the XML parser only cares about these four options: I<w> I<W> "
+"I<i> I<p>."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:87
+msgid ""
+"* Tags listed in B<break> are set to I<w> or I<W> depending on the B<wrap> "
+"option."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:88
+msgid "* Tags listed in B<inline> are set to I<i>."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:89
+msgid "* Tags listed in B<placeholder> are set to I<p>."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:90
+msgid "* Tags listed in B<untranslated> are without any of these options set."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:91
+msgid ""
+"You can verify actual internal parameter behavior by invoking B<po4a> with "
+"B<--debug> option."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:93
+msgid ""
+"Please note a tag should be listed in either B<translated> or "
+"B<untranslated> setting string."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:95
+msgid "Space-separated list of tags you do not want to translate."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:97
+msgid ""
+"Please note a translatable inline tag in an untranslated tag is treated as a "
+"translatable breaking tag, I<i> setting is dropped and I<w> or I<W> is set "
+"depending on the B<wrap> option."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Xml.pm:98
+msgid "B<defaulttranslateoption>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:99
+msgid ""
+"The default categories for tags that are not in any of the translated, "
+"untranslated, break, inline, or placeholder."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:100
+msgid ""
+"This is a set of letters as defined in B<translated> and this setting is "
+"only valid for translatable tags."
+msgstr ""
+
+#. type: =head1
+#: lib/Locale/Po4a/Xml.pm:101
+msgid "WRITING DERIVATIVE MODULES"
+msgstr ""
+
+#. type: =head2
+#: lib/Locale/Po4a/Xml.pm:102
+msgid "DEFINE WHAT TAGS AND ATTRIBUTES TO TRANSLATE"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:103
+msgid ""
+"The simplest customization is to define which tags and attributes you want "
+"the parser to translate. This should be done in the initialize function. "
+"First you should call the main initialize, to get the command-line options, "
+"and then, append your custom definitions to the options hash. If you want "
+"to treat some new options from command line, you should define them before "
+"calling the main initialize:"
+msgstr ""
+
+#. type: verbatim
+#: lib/Locale/Po4a/Xml.pm:104
+#, no-wrap
+msgid ""
+" $self->{options}{'new_option'}='';\n"
+" $self->SUPER::initialize(%options);\n"
+" $self->{options}{'_default_translated'}.=' <p> <head><title>';\n"
+" $self->{options}{'attributes'}.=' <p>lang id';\n"
+" $self->{options}{'_default_inline'}.=' <br>';\n"
+" $self->treat_options;\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:105
+msgid ""
+"You should use the B<_default_inline>, B<_default_break>, "
+"B<_default_placeholder>, B<_default_translated>, B<_default_untranslated>, "
+"and B<_default_attributes> options in derivative modules. This allow users "
+"to override the default behavior defined in your module with command line "
+"options."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:107
+msgid ""
+"If you don't like the default behavior of this xml module and its derivative "
+"modules, you can provide command line options to change their behavior."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:108
+msgid "See L<Locale::Po4a::Docbook(3pm)|Locale::Po4a::Docbook>,"
+msgstr ""
+
+#. type: =head2
+#: lib/Locale/Po4a/Xml.pm:109
+msgid "OVERRIDING THE found_string FUNCTION"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:110
+msgid ""
+"Another simple step is to override the function \"found_string\", which "
+"receives the extracted strings from the parser, in order to translate them. "
+"There you can control which strings you want to translate, and perform "
+"transformations to them before or after the translation itself."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:111
+msgid ""
+"It receives the extracted text, the reference on where it was, and a hash "
+"that contains extra information to control what strings to translate, how to "
+"translate them and to generate the comment."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:112
+msgid ""
+"The content of these options depends on the kind of string it is (specified "
+"in an entry of this hash):"
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Xml.pm:113
+msgid "type=\"tag\""
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:114
+msgid ""
+"The found string is the content of a translatable tag. The entry "
+"\"tag_options\" contains the option characters in front of the tag hierarchy "
+"in the module \"tags\" option."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Xml.pm:115
+msgid "type=\"attribute\""
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:116
+msgid ""
+"Means that the found string is the value of a translatable attribute. The "
+"entry \"attribute\" has the name of the attribute."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:117
+msgid ""
+"It must return the text that will replace the original in the translated "
+"document. Here's a basic example of this function:"
+msgstr ""
+
+#. type: verbatim
+#: lib/Locale/Po4a/Xml.pm:118
+#, no-wrap
+msgid ""
+" sub found_string {\n"
+" my ($self,$text,$ref,$options)=@_;\n"
+" $text = $self->translate($text,$ref,\"type \".$options->{'type'},\n"
+" 'wrap'=>$self->{options}{'wrap'});\n"
+" return $text;\n"
+" }\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:119
+msgid ""
+"There's another simple example in the new Dia module, which only filters "
+"some strings."
+msgstr ""
+
+#. type: =head2
+#: lib/Locale/Po4a/Xml.pm:120
+msgid "MODIFYING TAG TYPES (TODO)"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:121
+msgid ""
+"This is a more complex one, but it enables a (almost) total customization. "
+"It's based on a list of hashes, each one defining a tag type's behavior. The "
+"list should be sorted so that the most general tags are after the most "
+"concrete ones (sorted first by the beginning and then by the end keys). To "
+"define a tag type you'll have to make a hash with the following keys:"
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Xml.pm:122
+msgid "B<beginning>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:123
+msgid "Specifies the beginning of the tag, after the \"E<lt>\"."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Xml.pm:124
+msgid "B<end>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:125
+msgid "Specifies the end of the tag, before the \"E<gt>\"."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Xml.pm:126
+msgid "B<breaking>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:127
+msgid ""
+"It says if this is a breaking tag class. A non-breaking (inline) tag is one "
+"that can be taken as part of the content of another tag. It can take the "
+"values false (0), true (1) or undefined. If you leave this undefined, "
+"you'll have to define the f_breaking function that will say whether a "
+"concrete tag of this class is a breaking tag or not."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Xml.pm:128
+msgid "B<f_breaking>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:129
+msgid ""
+"It's a function that will tell if the next tag is a breaking one or not. It "
+"should be defined if the B<breaking> option is not."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Xml.pm:130
+msgid "B<f_extract>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:131
+msgid ""
+"If you leave this key undefined, the generic extraction function will have "
+"to extract the tag itself. It's useful for tags that can have other tags or "
+"special structures in them, so that the main parser doesn't get mad. This "
+"function receives a boolean that says if the tag should be removed from the "
+"input stream or not."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Xml.pm:132
+msgid "B<f_translate>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:133
+msgid ""
+"This function receives the tag (in the get_string_until() format) and "
+"returns the translated tag (translated attributes or all needed "
+"transformations) as a single string."
+msgstr ""
+
+#. type: =head2
+#: lib/Locale/Po4a/Xml.pm:135
+msgid "WORKING WITH TAGS"
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Xml.pm:136
+msgid "get_path()"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:137
+msgid ""
+"This function returns the path to the current tag from the document's root, "
+"in the form E<lt>htmlE<gt>E<lt>bodyE<gt>E<lt>pE<gt>."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:138
+msgid ""
+"An additional array of tags (without brackets) can be passed as argument. "
+"These path elements are added to the end of the current path."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Xml.pm:139
+msgid "tag_type()"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:140
+msgid ""
+"This function returns the index from the tag_types list that fits to the "
+"next tag in the input stream, or -1 if it's at the end of the input file."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:141
+msgid ""
+"Here, the tag has structure started by E<lt> and end by E<gt> and it can "
+"contain multiple lines."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:142 lib/Locale/Po4a/Xml.pm:145
+#: lib/Locale/Po4a/Xml.pm:152 lib/Locale/Po4a/Xml.pm:161
+msgid ""
+"This works on the array C<< @{$self->{TT}{doc_in}} >> holding input document "
+"data and reference indirectly via C<< $self->shiftline() >> and C<< $self-"
+">unshiftline($$) >>."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Xml.pm:143
+msgid "extract_tag($$)"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:144
+msgid ""
+"This function returns the next tag from the input stream without the "
+"beginning and end, in an array form, to maintain the references from the "
+"input file. It has two parameters: the type of the tag (as returned by "
+"tag_type) and a boolean, that indicates if it should be removed from the "
+"input stream."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Xml.pm:146
+msgid "get_tag_name(@)"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:147
+msgid ""
+"This function returns the name of the tag passed as an argument, in the "
+"array form returned by extract_tag."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Xml.pm:148
+msgid "breaking_tag()"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:149
+msgid ""
+"This function returns a boolean that says if the next tag in the input "
+"stream is a breaking tag or not (inline tag). It leaves the input stream "
+"intact."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Xml.pm:150
+msgid "treat_tag()"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:151
+msgid ""
+"This function translates the next tag from the input stream. Using each tag "
+"type's custom translation functions."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Xml.pm:153
+msgid "tag_in_list($@)"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:154
+msgid ""
+"This function returns a string value that says if the first argument (a tag "
+"hierarchy) matches any of the tags from the second argument (a list of tags "
+"or tag hierarchies). If it doesn't match, it returns 0. Else, it returns the "
+"matched tag's options (the characters in front of the tag) or 1 (if that tag "
+"doesn't have options)."
+msgstr ""
+
+#. type: =head2
+#: lib/Locale/Po4a/Xml.pm:155
+msgid "WORKING WITH ATTRIBUTES"
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Xml.pm:156
+msgid "treat_attributes(@)"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:157
+msgid ""
+"This function handles the translation of the tags' attributes. It receives "
+"the tag without the beginning / end marks, and then it finds the attributes, "
+"and it translates the translatable ones (specified by the module option "
+"B<attributes>). This returns a plain string with the translated tag."
+msgstr ""
+
+#. type: =head2
+#: lib/Locale/Po4a/Xml.pm:158
+msgid "WORKING WITH TAGGED CONTENTS"
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Xml.pm:159
+msgid "treat_content()"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:160
+msgid ""
+"This function gets the text until the next breaking tag (not inline) from "
+"the input stream. Translate it using each tag type's custom translation "
+"functions."
+msgstr ""
+
+#. type: =head2
+#: lib/Locale/Po4a/Xml.pm:162
+msgid "WORKING WITH THE MODULE OPTIONS"
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Xml.pm:163
+msgid "treat_options()"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:164
+msgid ""
+"This function fills the internal structures that contain the tags, "
+"attributes and inline data with the options of the module (specified in the "
+"command-line or in the initialize function)."
+msgstr ""
+
+#. type: =head2
+#: lib/Locale/Po4a/Xml.pm:165
+msgid "GETTING TEXT FROM THE INPUT DOCUMENT"
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Xml.pm:166
+msgid "get_string_until($%)"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:167
+msgid ""
+"This function returns an array with the lines (and references) from the "
+"input document until it finds the first argument. The second argument is an "
+"options hash. Value 0 means disabled (the default) and 1, enabled."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:168
+msgid "The valid options are:"
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Xml.pm:169
+msgid "B<include>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:170
+msgid "This makes the returned array to contain the searched text"
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Xml.pm:171
+msgid "B<remove>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:172
+msgid "This removes the returned stream from the input"
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Xml.pm:173
+msgid "B<unquoted>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:174
+msgid "This ensures that the searched text is outside any quotes"
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Xml.pm:175
+msgid "B<regex>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:176
+msgid ""
+"This denotes that the first argument is a regular expression rather than an "
+"plain string"
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Xml.pm:177
+msgid "skip_spaces(\\@)"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:178
+msgid ""
+"This function receives as argument the reference to a paragraph (in the "
+"format returned by get_string_until), skips his heading spaces and returns "
+"them as a simple string."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Xml.pm:179
+msgid "join_lines(@)"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:180
+msgid ""
+"This function returns a simple string with the text from the argument array "
+"(discarding the references)."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:182
+msgid "This module can translate tags and attributes."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:184
+msgid "DOCTYPE (ENTITIES)"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:185
+msgid ""
+"There is a minimal support for the translation of entities. They are "
+"translated as a whole, and tags are not taken into account. Multilines "
+"entities are not supported and entities are always rewrapped during the "
+"translation."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:186
+msgid ""
+"MODIFY TAG TYPES FROM INHERITED MODULES (move the tag_types structure inside "
+"the $self hash?)"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Xml.pm:188
+msgid ""
+"L<Locale::Po4a::TransTractor(3pm)|Locale::Po4a::TransTractor>, L<po4a(7)|"
+"po4a.7>"
+msgstr ""
+
+#. type: verbatim
+#: lib/Locale/Po4a/Xml.pm:190
+#, no-wrap
+msgid ""
+" Jordi Vilalta <jvprat@gmail.com>\n"
+" Nicolas François <nicolas.francois@centraliens.net>\n"
+"\n"
+msgstr ""
+
+#. type: verbatim
+#: lib/Locale/Po4a/Xml.pm:192
+#, no-wrap
+msgid ""
+" Copyright © 2004 Jordi Vilalta <jvprat@gmail.com>\n"
+" Copyright © 2008-2009 Nicolas François <nicolas.francois@centraliens.net>\n"
+"\n"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Yaml.pm:2
+msgid "Locale::Po4a::Yaml - convert YAML files from/to PO files"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Yaml.pm:4
+msgid ""
+"Locale::Po4a::Yaml is a module to help the translation of Yaml files into "
+"other [human] languages."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Yaml.pm:5
+msgid ""
+"The module extracts the value of YAML hashes and arrays. Hash keys are not "
+"extracted."
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Yaml.pm:6
+msgid "NOTE: This module parses the YAML file with YAML::Tiny."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Yaml.pm:9
+msgid "B<keys>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Yaml.pm:10
+msgid ""
+"Space-separated list of hash keys to process for extraction, all other keys "
+"are skipped. Keys are matched with a case-sensitive match. If B<paths> and "
+"B<keys> are used together, values are included if they are matched by at "
+"least one of the options. Arrays values are always returned unless the "
+"B<skip_array> option is provided."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Yaml.pm:11
+msgid "B<paths>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Yaml.pm:12
+msgid ""
+"Comma-separated list of hash paths to process for extraction, all other "
+"paths are skipped. Paths are matched with a case-sensitive match. If "
+"B<paths> and B<keys> are used together, values are included if they are "
+"matched by at least one of the options. Arrays values are always returned "
+"unless the B<skip_array> option is provided."
+msgstr ""
+
+#. type: =item
+#: lib/Locale/Po4a/Yaml.pm:13
+msgid "B<skip_array>"
+msgstr ""
+
+#. type: textblock
+#: lib/Locale/Po4a/Yaml.pm:14
+msgid "Do not translate array values."
+msgstr ""
+
+#. type: verbatim
+#: lib/Locale/Po4a/Yaml.pm:18
+#, no-wrap
+msgid ""
+" Brian Exelbierd <bex@pobox.com>\n"
+"\n"
+msgstr ""
+
+#. type: verbatim
+#: lib/Locale/Po4a/Yaml.pm:20
+#, no-wrap
+msgid ""
+" Copyright © 2017 Brian Exelbierd.\n"
+" Copyright © 2022 Martin Quinson <mquinson#debian.org>.\n"
+"\n"
+msgstr ""
+
+#~ msgid ""
+#~ "<command>po4aman-display-po</command> can be used by a translator who "
+#~ "wants to check how the man page being translated in a PO will be "
+#~ "displayed."
+#~ msgstr ""
+#~ "A <command>po4aman-display-po</command> parancsot olyan fordító "
+#~ "használhatja, aki ellenőrizni szeretné, hogy a PO fájlban fordítás alatt "
+#~ "lévő kézikönyvoldal hogyan fog megjelenni."