xref: /dports/textproc/po4a/po4a-0.65/po/pod/po4a-pod.pot

# SOME DESCRIPTIVE TITLE
# Copyright (C) YEAR Free Software Foundation, Inc.
# This file is distributed under the same license as the po4a package.
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: po4a 0.64\n"
"Report-Msgid-Bugs-To: devel@lists.po4a.org\n"
"POT-Creation-Date: 2021-11-06 11:27+0100\n"
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
"Language-Team: LANGUAGE <LL@li.org>\n"
"Language: \n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n"
"Content-Transfer-Encoding: 8bit\n"

#. type: Attribute 'xml:lang' of: <refentry>
#: share/doc/po4a-display-man.xml:1 share/doc/po4a-display-pod.xml:1
msgid "en"
msgstr ""

#. type: Content of: <refentry><refentryinfo>
#: share/doc/po4a-display-man.xml:2
msgid "<date>2006-04-08</date>"
msgstr ""

#. type: Content of: <refentry><refmeta><refentrytitle>
#: share/doc/po4a-display-man.xml:3
msgid "PO4A-DISPLAY-MAN"
msgstr ""

#. type: Content of: <refentry><refmeta><manvolnum>
#: share/doc/po4a-display-man.xml:4 share/doc/po4a-display-pod.xml:4
msgid "1"
msgstr ""

#. type: Content of: <refentry><refmeta><refmiscinfo>
#: share/doc/po4a-display-man.xml:5
msgid "2020-04-19"
msgstr ""

#. 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 ""

#. type: Content of: <refentry><refnamediv><refname>
#: share/doc/po4a-display-man.xml:8
msgid "po4a-display-man"
msgstr ""

#. type: Content of: <refentry><refnamediv><refpurpose>
#: share/doc/po4a-display-man.xml:9
msgid "display a translated man page according to a PO"
msgstr ""

#. type: Content of: <refentry><refsynopsisdiv><cmdsynopsis>
#: share/doc/po4a-display-man.xml:10
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 ""

#. 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/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
msgid "DESCRIPTION"
msgstr ""

#. 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:15
#: 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:71 po4a-normalize:29 po4a-translate:54 po4a-updatepo:53
#: msguntypot:29 doc/po4a.7.pod:177 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:36 lib/Locale/Po4a/TeX.pm:118
#: lib/Locale/Po4a/Texinfo.pm:10 lib/Locale/Po4a/Xhtml.pm:15
#: lib/Locale/Po4a/Xml.pm:184
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
msgid "PO4A-DISPLAY-POD"
msgstr ""

#. 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
msgid "po4a-display-pod"
msgstr ""

#. type: Content of: <refentry><refnamediv><refpurpose>
#: share/doc/po4a-display-pod.xml:9
msgid "display of a translated POD file according to a PO"
msgstr ""

#. 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 ""

#. 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/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
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 ""
"When you run the B<po4a> program for the first time, with only a "
"configuration file and the documents to translate (called master documents), "
"it produces a POT file (also called translation template)  that contains all "
"of the translatable strings in the document in a form that eases the work of "
"translators."
msgstr ""

#. type: textblock
#: po4a:8
msgid ""
"Those POT files can either be translated with a specific editor such as the "
"B<GNOME Translation Editor>, KDE's B<Lokalize> or B<poedit>, or they can be "
"integrated in an online localization platform such as B<weblate> or "
"B<pootle>.  The translation result is a set of PO files, one per language."
msgstr ""

#. type: textblock
#: po4a:9
msgid ""
"When you run the B<po4a> program with both the master documents and the PO "
"files, it produces the translated documents by injecting the content's "
"translation (found in the PO files) into the structure of the original "
"master document."
msgstr ""

#. type: textblock
#: po4a:10
msgid ""
"If the master documents changed in the meanwhile, po4a will update the PO "
"and POT files accordingly, so that the translators can easily detect the "
"modifications and update their work. Depending on your settings, po4a will "
"discard the partially translated documents, or produce a document mixing "
"English (for the new or modified paragraphs) and the target language (for "
"paragraphs where translation is already in the PO file)."
msgstr ""

#. type: textblock
#: po4a:11
msgid ""
"By default, the translated documents are produced when at least 80% of their "
"content is translated (see the I<--keep> option below).  Discarding "
"translations as soon as they are not 100% may be discouraging for the "
"translators, while showing \"translations\" that are too incomplete may be "
"troubling for the end users."
msgstr ""

#. type: =head2
#: po4a:12
msgid "Graphical overview"
msgstr ""

#. type: verbatim
#: po4a:13
#, no-wrap
msgid ""
" master documents ---+---->-------->---------+\n"
"  (doc authoring)    |                       |\n"
"                     V   (po4a executions)   >-----+--> translations\n"
"                     |                       |     |\n"
" existing PO files -->--> updated PO files >-+     |\n"
"      ^                            |               |\n"
"      |                            V               |\n"
"      +----------<---------<-------+               ^\n"
"       (manual translation process)                |\n"
"                                                   |\n"
" addendum -->--------------------------------------+\n"
"\n"
msgstr ""

#. type: textblock
#: po4a:14
msgid ""
"The master documents are authored by the documentation writers. Any changes "
"are automatically reflected by po4a in the PO files, that are then updated "
"by the translators. All changes to the PO files (either manual or by po4a) "
"are automatically reflected in translated documents. You can mimic this "
"behavior using the L<po4a-updatepo(1)> and L<po4a-translate(1)> scripts in "
"makefiles, but this quickly becomes bothersome and repetitive (see "
"L<po4a(7)>). It is highly recommended to use the B<po4a> program in your "
"build process."
msgstr ""

#. type: =item
#: po4a:16 po4a-translate:28
msgid "B<-k>, B<--keep>"
msgstr ""

#. type: textblock
#: po4a:17
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:18 po4a-gettextize:26 po4a-normalize:15 po4a-translate:32
#: po4a-updatepo:28
msgid "B<-h>, B<--help>"
msgstr ""

#. type: textblock
#: po4a:19 po4a-gettextize:27 po4a-normalize:16 po4a-translate:33
#: po4a-updatepo:29
msgid "Show a short help message."
msgstr ""

#. type: =item
#: po4a:20 po4a-gettextize:16 po4a-normalize:21 po4a-translate:18
#: po4a-updatepo:16
msgid "B<-M>, B<--master-charset>"
msgstr ""

#. type: textblock
#: po4a:21
msgid ""
"Charset of the files containing the documents to translate. Note that all "
"master documents must use the same charset."
msgstr ""

#. type: =item
#: po4a:22 po4a-gettextize:20 po4a-translate:22
msgid "B<-L>, B<--localized-charset>"
msgstr ""

#. type: textblock
#: po4a:23
msgid ""
"Charset of the files containing the localized documents. Note that all "
"translated documents will use the same charset."
msgstr ""

#. type: =item
#: po4a:24 po4a-translate:14
msgid "B<-A>, B<--addendum-charset>"
msgstr ""

#. type: textblock
#: po4a:25 po4a-translate:15
msgid ""
"Charset of the addenda. Note that all the addenda should be in the same "
"charset."
msgstr ""

#. type: =item
#: po4a:26 po4a-gettextize:30 po4a-normalize:27 po4a-translate:36
#: po4a-updatepo:32
msgid "B<-V>, B<--version>"
msgstr ""

#. type: textblock
#: po4a:27 po4a-gettextize:31 po4a-normalize:28 po4a-translate:37
#: po4a-updatepo:33
msgid "Display the version of the script and exit."
msgstr ""

#. type: =item
#: po4a:28 po4a-gettextize:32 po4a-translate:38 po4a-updatepo:34
msgid "B<-v>, B<--verbose>"
msgstr ""

#. type: textblock
#: po4a:29 po4a-gettextize:33 po4a-translate:39 po4a-updatepo:35
msgid "Increase the verbosity of the program."
msgstr ""

#. type: =item
#: po4a:30
msgid "B<-q>, B<--quiet>"
msgstr ""

#. type: textblock
#: po4a:31
msgid "Decrease the verbosity of the program."
msgstr ""

#. type: =item
#: po4a:32 po4a-gettextize:34 po4a-translate:40 po4a-updatepo:36
msgid "B<-d>, B<--debug>"
msgstr ""

#. type: textblock
#: po4a:33 po4a-gettextize:35 po4a-translate:41 po4a-updatepo:37
msgid "Output some debugging information."
msgstr ""

#. type: =item
#: po4a:34 po4a-gettextize:24 po4a-normalize:10 po4a-translate:26
#: po4a-updatepo:20
msgid "B<-o>, B<--option>"
msgstr ""

#. type: textblock
#: po4a:35 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:36
msgid "B<-f>, B<--force>"
msgstr ""

#. type: textblock
#: po4a:37
msgid ""
"Always generate the POT and PO files, even if B<po4a> considers it is not "
"necessary."
msgstr ""

#. type: textblock
#: po4a:38
msgid "The default behavior (when B<--force> is not specified) is the following:"
msgstr ""

#. type: textblock
#: po4a:39
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:40
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:41
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:42
msgid "The PO files are always re-generated based on the POT with B<msgmerge -U>."
msgstr ""

#. type: =item
#: po4a:43
msgid "B<--stamp>"
msgstr ""

#. type: textblock
#: po4a:44
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:45
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:46
msgid "B<--no-translations>"
msgstr ""

#. type: textblock
#: po4a:47
msgid "Do not generate the translated documents, only update the POT and PO files."
msgstr ""

#. type: =item
#: po4a:48
msgid "B<--no-update>"
msgstr ""

#. type: textblock
#: po4a:49
msgid "Do not change the POT and PO files, only the translation may be updated."
msgstr ""

#. type: =item
#: po4a:50
msgid "B<--keep-translations>"
msgstr ""

#. type: textblock
#: po4a:51
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:52
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:53
msgid "B<--rm-translations>"
msgstr ""

#. type: textblock
#: po4a:54
msgid "Remove the translated files (implies B<--no-translations>)."
msgstr ""

#. type: =item
#: po4a:55
msgid "B<--no-backups>"
msgstr ""

#. type: textblock
#: po4a:56 po4a:58
msgid "This flag does nothing since 0.41, and may be removed in later releases."
msgstr ""

#. type: =item
#: po4a:57
msgid "B<--rm-backups>"
msgstr ""

#. type: =item
#: po4a:59
msgid "B<--translate-only> I<translated-file>"
msgstr ""

#. type: textblock
#: po4a:60
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:61
msgid "B<--variable> I<var>B<=>I<value>"
msgstr ""

#. type: textblock
#: po4a:62
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:63
msgid "B<--srcdir> I<SRCDIR>"
msgstr ""

#. type: textblock
#: po4a:64
msgid ""
"Set the base directory for all input documents specified in the B<po4a> "
"configuration file."
msgstr ""

#. type: textblock
#: po4a:65
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:66
msgid "B<--destdir> I<DESTDIR>"
msgstr ""

#. type: textblock
#: po4a:67
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:68
msgid "Options modifying the POT header"
msgstr ""

#. type: =item
#: po4a:69 lib/Locale/Po4a/Po.pm:14
msgid "B<--porefs> I<type>"
msgstr ""

#. type: textblock
#: po4a:70 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:71 po4a-translate:45 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:72 po4a-translate:46 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:73 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:74 po4a-translate:48 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, "
"ie on how newlines are added to the content of these strings."
msgstr ""

#. type: =item
#: po4a:75
msgid "B<--master-language>"
msgstr ""

#. type: textblock
#: po4a:76
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:77 po4a-gettextize:36 po4a-updatepo:45 lib/Locale/Po4a/Po.pm:20
msgid "B<--msgid-bugs-address> I<email@address>"
msgstr ""

#. type: textblock
#: po4a:78 po4a-gettextize:37 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:79 po4a-gettextize:38 po4a-updatepo:47 lib/Locale/Po4a/Po.pm:22
msgid "B<--copyright-holder> I<string>"
msgstr ""

#. type: textblock
#: po4a:80 po4a-gettextize:39 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:81 po4a-gettextize:40 po4a-updatepo:49 lib/Locale/Po4a/Po.pm:24
msgid "B<--package-name> I<string>"
msgstr ""

#. type: textblock
#: po4a:82 po4a-gettextize:41 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:83 po4a-gettextize:42 po4a-updatepo:51 lib/Locale/Po4a/Po.pm:26
msgid "B<--package-version> I<string>"
msgstr ""

#. type: textblock
#: po4a:84 po4a-gettextize:43 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:85
msgid "Options to modify the PO files"
msgstr ""

#. type: =item
#: po4a:86 po4a-updatepo:26
msgid "B<--msgmerge-opt> I<options>"
msgstr ""

#. type: textblock
#: po4a:87 po4a-updatepo:27
msgid "Extra options for B<msgmerge>(1)."
msgstr ""

#. type: textblock
#: po4a:88
msgid "Note: B<$lang> will be extended to the current language."
msgstr ""

#. type: =item
#: po4a:89 po4a-updatepo:22
msgid "B<--no-previous>"
msgstr ""

#. type: textblock
#: po4a:90 po4a-updatepo:23
msgid ""
"This option removes B<--previous> from the options passed to B<msgmerge>.  "
"This permits to support versions of B<gettext> earlier than 0.16."
msgstr ""

#. type: =item
#: po4a:91 po4a-updatepo:24
msgid "B<--previous>"
msgstr ""

#. type: textblock
#: po4a:92 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:93
msgid "CONFIGURATION FILE"
msgstr ""

#. type: textblock
#: po4a:94
msgid ""
"po4a expects a configuration file as argument. This file must contain the "
"following elements:"
msgstr ""

#. type: textblock
#: po4a:95
msgid "The path to the PO files and the list of languages existing in the project;"
msgstr ""

#. type: textblock
#: po4a:96
msgid ""
"Optionally, some global options and so-called configuration aliases that are "
"used as templates to configure individual master files;"
msgstr ""

#. type: textblock
#: po4a:97
msgid "The list of each master file to translate, along with specific parameters."
msgstr ""

#. type: textblock
#: po4a:98
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:99
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:100
msgid "Finding the PO and POT files"
msgstr ""

#. type: textblock
#: po4a:101
msgid ""
"The simplest solution is to explicitly give the path to POT and PO files, as "
"follows:"
msgstr ""

#. type: verbatim
#: po4a:102
#, 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:103
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:104
msgid ""
"The same information can be written as follows to reduce the risk of "
"copy/paste errors:"
msgstr ""

#. type: verbatim
#: po4a:105
#, 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:106
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:107
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:108
#, no-wrap
msgid ""
" [po_directory] man/po/\n"
"\n"
msgstr ""

#. type: textblock
#: po4a:109
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:110
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:111
msgid "Centralized or split PO files?"
msgstr ""

#. type: textblock
#: po4a:112
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:113
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:114
#, no-wrap
msgid ""
" [po4a_paths] doc/$master/$master.pot $lang:doc/$master/$lang.po\n"
"\n"
msgstr ""

#. type: textblock
#: po4a:115
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.  This feature can also be used to group several translated files "
"into the same POT file."
msgstr ""

#. type: verbatim
#: po4a:116
#, 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-gui\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:117
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:118
msgid "Specifying the documents to translate"
msgstr ""

#. type: textblock
#: po4a:119
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. Here is "
"an example:"
msgstr ""

#. type: verbatim
#: po4a:120
#, no-wrap
msgid ""
" [type: sgml] doc/my_stuff.sgml fr:doc/fr/mon_truc.sgml \\\n"
"              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:121
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:122
#, 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:123
msgid "Specifying options"
msgstr ""

#. type: textblock
#: po4a:124
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:125
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:126
#, no-wrap
msgid ""
" [type:xml] toto.xml $lang:toto.$lang.xml opt:\"-o nostrip\" opt_fr:\"--keep "
"0\"\n"
"\n"
msgstr ""

#. type: textblock
#: po4a:127
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:128
#, 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:129
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:130
msgid "Configuration aliases"
msgstr ""

#. type: textblock
#: po4a:131
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:132
#, 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:133
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:134
#, 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:135
msgid "Global default options"
msgstr ""

#. type: textblock
#: po4a:136
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:137
#, no-wrap
msgid ""
"  [options] --keep 20 --option nostrip\n"
"\n"
msgstr ""

#. type: textblock
#: po4a:138
msgid ""
"As with the command line options, you can abbreviate the parameters passed "
"in the configuration file:"
msgstr ""

#. type: verbatim
#: po4a:139
#, no-wrap
msgid ""
"  [options] -k 20 -o nostrip\n"
"\n"
msgstr ""

#. type: =head3
#: po4a:140
msgid "Option priorities"
msgstr ""

#. type: textblock
#: po4a:141
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:142
msgid ""
"C<[options]> lines provide default values that can be overridden by any "
"other source."
msgstr ""

#. type: textblock
#: po4a:143
msgid ""
"Type aliases are then used. Language specific settings override the ones "
"applicable to all languages."
msgstr ""

#. type: textblock
#: po4a:144
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:145
msgid ""
"Finally, parameters provided on the B<po4a> command line override any "
"settings from the configuration file."
msgstr ""

#. type: =head3
#: po4a:146
msgid "Example"
msgstr ""

#. type: textblock
#: po4a:147
msgid "Here is an example showing how to quote the spaces and quotes:"
msgstr ""

#. type: verbatim
#: po4a:148
#, no-wrap
msgid ""
" [po_directory] man/po/\n"
" \n"
msgstr ""

#. type: verbatim
#: po4a:149
#, no-wrap
msgid ""
" [options] --master-charset UTF-8\n"
" \n"
msgstr ""

#. type: verbatim
#: po4a:150
#, 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:151
msgid "Addendum: Adding extra content in the translation"
msgstr ""

#. type: textblock
#: po4a:152
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:153
#, 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:154
msgid "You can also use language templates as follow:"
msgstr ""

#. type: verbatim
#: po4a:155
#, 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:156
msgid "If an addendum fails to apply, the translation is discarded."
msgstr ""

#. type: =head3
#: po4a:157
msgid "Modifiers for the addendum declaration"
msgstr ""

#. type: textblock
#: po4a:158
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:159
msgid "B<?>"
msgstr ""

#. type: textblock
#: po4a:160
msgid "Include I<addendum_path> if this file does exist, otherwise do nothing."
msgstr ""

#. type: =item
#: po4a:161
msgid "B<@>"
msgstr ""

#. type: textblock
#: po4a:162
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:163
msgid "B<!>"
msgstr ""

#. type: textblock
#: po4a:164
msgid ""
"I<addendum_path> is discarded, it is not loaded and will not be loaded by "
"any further addendum specification."
msgstr ""

#. type: textblock
#: po4a:165
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:166
#, no-wrap
msgid ""
" [type: pod] script $lang:doc/$lang/script.1  "
"add_$lang:?doc/l10n/script.$lang.add\n"
"\n"
msgstr ""

#. type: textblock
#: po4a:167
msgid "The following includes a list of addendum for every language:"
msgstr ""

#. type: verbatim
#: po4a:168
#, no-wrap
msgid ""
" [type: pod] script $lang:doc/$lang/script.1  "
"add_$lang:@doc/l10n/script.$lang.add\n"
"\n"
msgstr ""

#. type: =head2
#: po4a:169
msgid "Filtering the translated strings"
msgstr ""

#. type: textblock
#: po4a:170
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:171
#, no-wrap
msgid ""
"  [type:docbook] book.xml          \\\n"
"          pot_in:book-filtered.xml \\\n"
"          $lang:book.$lang.xml\n"
"\n"
msgstr ""

#. type: textblock
#: po4a:172
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: =head2
#: po4a:173
msgid "CONFIGURATION EXAMPLE"
msgstr ""

#. type: textblock
#: po4a:174
msgid "TODO: Is this section really useful?"
msgstr ""

#. type: textblock
#: po4a:175
msgid ""
"Let's assume you maintain a program named B<foo> which has a man page "
"F<man/foo.1> which naturally is maintained in English only. Now you as the "
"upstream or downstream maintainer want to create and maintain the "
"translation.  First you need to create the POT file necessary to send to "
"translators using L<po4a-gettextize(1)>."
msgstr ""

#. type: textblock
#: po4a:176
msgid "So for our case we would call"
msgstr ""

#. type: verbatim
#: po4a:177
#, no-wrap
msgid ""
" cd man && po4a-gettextize -f man -m foo.1 -p foo.pot\n"
"\n"
msgstr ""

#. type: textblock
#: po4a:178
msgid ""
"You would then send this file to the appropriate language lists or offer it "
"for download somewhere on your website."
msgstr ""

#. type: textblock
#: po4a:179
msgid ""
"Now let's assume you received three translations before your next release: "
"F<de.po> (including an addendum F<de.add>), F<sv.po> and F<pt.po>.  Since "
"you don't want to change your F<Makefile>(s) whenever a new translation "
"arrives you can use B<po4a> with an appropriate configuration file in your "
"F<Makefile>.  Let's call it F<po4a.cfg>. In our example it would look like "
"the following:"
msgstr ""

#. type: verbatim
#: po4a:180
#, no-wrap
msgid ""
" [po_directory] man/po4a/po/\n"
"\n"
msgstr ""

#. type: verbatim
#: po4a:181
#, no-wrap
msgid ""
" [type: man] man/foo.1 $lang:man/translated/$lang/foo.1 \\\n"
"            add_$lang:?man/po4a/add_$lang/$lang.add opt:\"-k 80\"\n"
"\n"
msgstr ""

#. type: textblock
#: po4a:182
msgid ""
"In this example we assume that your generated man pages (and all PO and "
"addenda files) should be stored in F<man/translated/$lang/> (respectively in "
"F<man/po4a/po/> and F<man/po4a/add_$lang/>) below the current directory. In "
"our example the F<man/po4a/po/> directory would include F<de.po>, F<pt.po> "
"and F<sv.po>, and the F<man/po4a/add_de/> directory would include F<de.add>."
msgstr ""

#. type: textblock
#: po4a:183
msgid ""
"Note the use of the modifier B<?> as only the German translation (F<de.po>) "
"is accompanied by an addendum."
msgstr ""

#. type: textblock
#: po4a:184
msgid ""
"To actually build the translated man pages you would then (once!) add the "
"following line in the B<build> target of the appropriate F<Makefile>:"
msgstr ""

#. type: verbatim
#: po4a:185
#, no-wrap
msgid ""
"        po4a po4a.cfg\n"
"\n"
msgstr ""

#. type: textblock
#: po4a:186
msgid ""
"Once this is set up you don't need to touch the F<Makefile> when a new "
"translation arrives, i.e. if the French team sends you F<fr.po> and "
"F<fr.add> then you simply drop them respectively in F<man/po4a/po/> and "
"F<man/po4a/add_fr/> and the next time the program is built the French "
"translation is automatically build as well in F<man/translated/fr/>."
msgstr ""

#. type: textblock
#: po4a:187
msgid ""
"Note that you still need an appropriate target to install localized manual "
"pages with English ones."
msgstr ""

#. type: verbatim
#: po4a:188
#, no-wrap
msgid ""
"Finally if you do not store generated files into your version control "
"system,\n"
"you will need a line in your B<clean> target as well:\n"
"        -rm -rf man/translated\n"
"\n"
msgstr ""

#. type: textblock
#: po4a:190
msgid ""
"L<po4a-gettextize(1)>, L<po4a-normalize(1)>, L<po4a-translate(1)>, "
"L<po4a-updatepo(1)>, L<po4a(7)>."
msgstr ""

#. type: =head1
#: po4a:191 po4a-gettextize:73 po4a-normalize:31 po4a-translate:56
#: po4a-updatepo:55 msguntypot:32 doc/po4a.7.pod:183
#: lib/Locale/Po4a/AsciiDoc.pm:52 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:101 lib/Locale/Po4a/Pod.pm:38
#: lib/Locale/Po4a/Sgml.pm:53 lib/Locale/Po4a/TeX.pm:120
#: lib/Locale/Po4a/Texinfo.pm:12 lib/Locale/Po4a/Text.pm:40
#: lib/Locale/Po4a/TransTractor.pm:156 lib/Locale/Po4a/Wml.pm:11
#: lib/Locale/Po4a/Xhtml.pm:17 lib/Locale/Po4a/Xml.pm:186
msgid "AUTHORS"
msgstr ""

#. type: verbatim
#: po4a:192 po4a-gettextize:74 po4a-normalize:32 po4a-translate:57
#: 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:75 po4a-normalize:33 po4a-translate:58
#: po4a-updatepo:57 msguntypot:34 lib/Locale/Po4a/AsciiDoc.pm:54
#: 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:40
#: lib/Locale/Po4a/Sgml.pm:58 lib/Locale/Po4a/TeX.pm:122
#: lib/Locale/Po4a/Texinfo.pm:14 lib/Locale/Po4a/Text.pm:42
#: lib/Locale/Po4a/Wml.pm:13 lib/Locale/Po4a/Xhtml.pm:19
#: lib/Locale/Po4a/Xml.pm:188
msgid "COPYRIGHT AND LICENSE"
msgstr ""

#. type: textblock
#: po4a:194 po4a-gettextize:76 po4a-normalize:34 po4a-translate:59
#: po4a-updatepo:58
msgid "Copyright 2002-2020 by SPI, inc."
msgstr ""

#. type: textblock
#: po4a:195 po4a-gettextize:77 po4a-normalize:35 po4a-translate:60
#: po4a-updatepo:59 msguntypot:36 lib/Locale/Po4a/AsciiDoc.pm:56
#: 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/Ini.pm:14 lib/Locale/Po4a/KernelHelp.pm:13
#: lib/Locale/Po4a/Man.pm:113 lib/Locale/Po4a/Pod.pm:42
#: lib/Locale/Po4a/Sgml.pm:60 lib/Locale/Po4a/TeX.pm:124
#: lib/Locale/Po4a/Text.pm:45 lib/Locale/Po4a/Wml.pm:15
#: lib/Locale/Po4a/Xhtml.pm:21 lib/Locale/Po4a/Xml.pm:190
msgid ""
"This program is free software; you may redistribute it and/or modify it "
"under the terms of GPL (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 is in charge of converting documentation files "
"into PO files. You only need it to setup your translation project with po4a, "
"never afterward."
msgstr ""

#. type: textblock
#: po4a-gettextize:9
msgid ""
"If you start from scratch, B<po4a-gettextize> will extract the translatable "
"strings from the documentation and write a POT file. If you provide a "
"previously existing translated file with the B<-l> flag, B<po4a-gettextize> "
"will try to use the translations that it contains in the produced PO "
"file. This process remains tedious and manual, as explained in Section "
"'Converting a manual translation to po4a' below."
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. Else (if the master document is completely in ASCII), the "
"generated PO will use the encoding of the translated input document, or "
"UTF-8 if no translated document is provided."
msgstr ""

#. type: =item
#: po4a-gettextize:12 po4a-normalize:19 po4a-translate:10 po4a-updatepo:12
msgid "B<-f>, B<--format>"
msgstr ""

#. type: textblock
#: po4a-gettextize:13 po4a-normalize:20 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:22 po4a-translate:19
msgid "Charset of the file containing the document to translate."
msgstr ""

#. type: =item
#: po4a-gettextize:18 po4a-normalize:23 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:17 po4a-translate:34 po4a-updatepo:30
msgid "B<--help-format>"
msgstr ""

#. type: textblock
#: po4a-gettextize:29 po4a-normalize:18 po4a-translate:35 po4a-updatepo:31
msgid "List the documentation formats understood by po4a."
msgstr ""

#. type: =head2
#: po4a-gettextize:44
msgid "Converting a manual translation to po4a"
msgstr ""

#. type: textblock
#: po4a-gettextize:45
msgid ""
"B<po4a-gettextize> will try to extract the content of any provided "
"translation file, and use this content as msgstr in the produced PO file. Be "
"warned that this process is very fragile: the Nth string of the translated "
"file is supposed to be the translation of the Nth string in the "
"original. This will naturally not work unless both files share exactly the "
"same structure."
msgstr ""

#. type: textblock
#: po4a-gettextize:46
msgid ""
"Internally, each po4a parser reports the syntactical type of each extracted "
"strings. This is how desynchronization are detected during the "
"gettextization.  For example, if the files have the following structure, 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:47
#, no-wrap
msgid ""
"    Original         Translation\n"
"\n"
msgstr ""

#. type: verbatim
#: po4a-gettextize:48
#, 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:49
msgid ""
"B<po4a-gettextize> will verbosely diagnose any detected structure "
"desynchronization. When this happens, you should manually edit the files "
"(this probably requires that you have some notions of the target "
"language). You must add fake paragraphs or remove some content in one of the "
"documents (or both) to fix the reported disparities, until the structure of "
"both documents perfectly match. Some tricks are given in the next section."
msgstr ""

#. type: textblock
#: po4a-gettextize:50
msgid ""
"Even when the document is successfully processed, undetected disparities and "
"silent errors are still possible. That is why any translation associated "
"automatically by po4a-gettextize is marked as I<fuzzy> to require an manual "
"inspection by humans. One has to check that each retrieved msgstr is "
"actually the translation of the associated msgid, and not the string before "
"or after."
msgstr ""

#. type: textblock
#: po4a-gettextize:51
msgid ""
"As you can see, the key here is to have the exact same structure in the "
"translated document and in the original one. The best is to do the "
"gettextization on the exact version of F<master.doc> that was used for the "
"translation, and only update the PO file against the latest master file once "
"the gettextization was successful."
msgstr ""

#. type: textblock
#: po4a-gettextize:52
msgid ""
"If you are lucky enough to have a a perfect match in the file structures, "
"building a correct PO file is a matter of seconds. Otherwise, you will soon "
"understand why this process has such an ugly name :) But remember that this "
"grunt work is the price to pay to get the comfort of po4a afterward. Once "
"converted, the synchronization between master documents and translations "
"will always be fully automatic."
msgstr ""

#. type: textblock
#: po4a-gettextize:53
msgid ""
"Even when things go wrong, gettextization often remains faster than "
"translating everything again. I was able to gettextize the existing French "
"translation of the whole Perl documentation in one day, even though the "
"structure of many documents were desynchronized. That was more than two "
"megabytes of original text (2 millions of characters): restarting the "
"translation from scratch would have required several months of work."
msgstr ""

#. type: =head2
#: po4a-gettextize:54
msgid "Hints and tricks for the gettextization process"
msgstr ""

#. type: textblock
#: po4a-gettextize:55
msgid ""
"The gettextization stops as soon as a desynchronization is detected. In "
"theory, it should probably be possible resynchronize the gettextization "
"later in the documents using e.g. the same algorithm than the L<diff(1)> "
"utility. But a manual intervention would still be mandatory to manually "
"match the elements that couldn't be automatically matched, explaining why "
"automatic resynchronization is not implemented (yet?)."
msgstr ""

#. type: textblock
#: po4a-gettextize:56
msgid ""
"When this happens, the whole game comes down to the alignment of these damn "
"files' structures again through manual edits. B<po4a-gettextize> is rather "
"verbose about what went wrong when it happens. 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 other tricks to help you in this tedious process:"
msgstr ""

#. type: textblock
#: po4a-gettextize:58
msgid ""
"Remove all extra content of the translations, such as the section giving "
"credits to the translators. You can add them back in po4a afterward, using "
"an addenda (see L<po4a(7)>)."
msgstr ""

#. type: textblock
#: po4a-gettextize:59
msgid ""
"If you need to edit the files to align their structures, you should 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 "
"PO update, and the corresponding translation will be dumped anyway. But do "
"not hesitate to also edit the original document if required: 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 ;)"
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 F<gettextization.failed.po>, and fix the problem where it "
"really is."
msgstr ""

#. type: textblock
#: po4a-gettextize:65
msgid ""
"In some unfortunate settings, you will get the feeling that po4a ate some "
"parts of the text, either the original or the "
"translation. F<gettextization.failed.po> indicates that both files matched "
"as expected up to the paragraph N. But then, an (unsuccessful) attempt is "
"made to match the N+1 paragraph in the original file not with the N+1 "
"paragraph in the translation as it should, but with the N+2 paragraph. Just "
"as if the N+1 paragraph that you see in the document simply disappeared from "
"the file during the process."
msgstr ""

#. type: textblock
#: po4a-gettextize:66
msgid ""
"This unfortunate situation happens when the same paragraph is repeated over "
"the document. In that case, no new entry is created in the PO file, but a "
"new reference is added to the existing one instead."
msgstr ""

#. type: textblock
#: po4a-gettextize:67
msgid ""
"So, the previous situation occurs when two similar but different paragraphs "
"are translated in the exact same way. This will apparently remove a "
"paragraph of the translation. To fix the problem, it is sufficient to "
"slightly alter one of the translations in the document. You can also prefer "
"to kill the second paragraph in the original document."
msgstr ""

#. type: textblock
#: po4a-gettextize:68
msgid ""
"To the opposite, if the same paragraph appearing twice in the original "
"document is not translated in the exact same way at both locations, you will "
"get the feeling that one paragraph of the original document just "
"vanished. Just copy the best translation over the other one in the "
"translated document to fix the problem."
msgstr ""

#. type: textblock
#: po4a-gettextize:69
msgid ""
"As a final note, do not be too surprised if the first synchronization of "
"your PO file takes a long time. This is because most of the msgid of the PO "
"file resulting from the gettextization don't match exactly any element 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."
msgstr ""

#. type: textblock
#: po4a-gettextize:70
msgid ""
"For example, the first B<po4a-updatepo> of the Perl documentation's French "
"translation (5.5 MB PO file) took about 48 hours (yes, two days) while the "
"subsequent ones only take a dozen of seconds."
msgstr ""

#. type: textblock
#: po4a-gettextize:72
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/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 ""

#. 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:12
msgid "B<-b>, B<--blank>"
msgstr ""

#. type: textblock
#: po4a-normalize:13
msgid ""
"Create an 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:14
msgid "This is useful to check what parts of the document cannot be translated."
msgstr ""

#. type: textblock
#: po4a-normalize:24
msgid ""
"Name of the normalized file to produce (I<po4a-normalize.output> by "
"default)."
msgstr ""

#. type: =item
#: po4a-normalize:25
msgid "B<-p>, B<--pot>"
msgstr ""

#. type: textblock
#: po4a-normalize:26
msgid "Pot file to produce (I<po4a-normalize.po> by default)."
msgstr ""

#. type: textblock
#: po4a-normalize:30
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:30
msgid "B<-w>, B<--width>"
msgstr ""

#. type: textblock
#: po4a-translate:31
msgid "Column at which we should wrap the resulting file."
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: textblock
#: po4a-translate:47 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: =head1
#: po4a-translate:49
msgid "Adding content (beside translations) to generated files"
msgstr ""

#. type: textblock
#: po4a-translate:50
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:51
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:52
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:53
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:55
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, it will convert the PO "
"files to UTF-8 (if they weren't already), in order to allow non-standard "
"characters in a culture independent way."
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: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 ""

#. 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 "Others supported formats"
msgstr ""

#. type: textblock
#: doc/po4a.7.pod:66
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:67
msgid "Unsupported formats"
msgstr ""

#. type: textblock
#: doc/po4a.7.pod:68
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:69
msgid "Using po4a"
msgstr ""

#. type: textblock
#: doc/po4a.7.pod:70
msgid ""
"Historically, po4a was built around four scripts, each fulfilling a specific "
"task. L<po4a-gettextize(1)> helps bootstrapping translations and optionally "
"converting existing translation projects to po4a. L<po4a-updatepo(1)> "
"reflects the changes to the original documentation into the corresponding po "
"files.  L<po4a-translate(1)> builds translated source file from the original "
"file and the corresponding PO file. In addition, L<po4a-normalize(1)> is "
"mostly useful to debug the po4a parsers, as it produces an untranslated "
"document from the original one. It makes it easier to spot the glitches "
"introduced by the parsing process."
msgstr ""

#. type: textblock
#: doc/po4a.7.pod:71
msgid ""
"Most projects only require the features of L<po4a-updatepo(1)> and "
"L<po4a-translate(1)>, but these scripts proved to be cumbersome and error "
"prone to use. If the documentation to translate is split over several source "
"files, it is difficult to keep the PO files up to date and build the "
"documentation files correctly. As an answer, a all-in-one tool was provided: "
"L<po4a(1)>. This tool takes a configuration file describing the structure of "
"the translation project: the location of the PO files, the list of files to "
"translate, and the options to use, and it fully automatizes the "
"process. When you invoke L<po4a(1)>, it both updates the PO files and "
"regenerate the translation files that need to. If everything is already up "
"to date, L<po4a(1)> does not change any file."
msgstr ""

#. type: textblock
#: doc/po4a.7.pod:72
msgid ""
"The rest of this section gives an overview of how use the scripts' interface "
"of po4a. Most users will probably prefer to use the all-in-one tool, that is "
"described in the documentation of L<po4a(1)>."
msgstr ""

#. type: =head2
#: doc/po4a.7.pod:73
msgid "Graphical overview of the po4a scripts"
msgstr ""

#. type: textblock
#: doc/po4a.7.pod:74
msgid ""
"The following schema gives an overview of how each po4a script can be used.  "
"Here, 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 asciidoc file or similar); the "
"translators will be mostly concerned with the PO file, while the end users "
"will only see the F<XX.doc> file."
msgstr ""

#. type: verbatim
#: doc/po4a.7.pod:75
#, 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-updatepo]                  |\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-translate]\n"
"                                                  |\n"
"                                                  V\n"
"                                                XX.doc\n"
"                                             (up-to-date)\n"
"\n"
msgstr ""

#. type: textblock
#: doc/po4a.7.pod:76
msgid ""
"This schema is complicated, but in practice only the right part (involving "
"L<po4a-updatepo(1)> and L<po4a-translate(1)>) is used once the project is "
"setup and configured."
msgstr ""

#. type: textblock
#: doc/po4a.7.pod:77
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:78
msgid ""
"On the top right part, the action of the original author is depicted, "
"updating the documentation. The middle right part depicts the automatic "
"actions of L<po4a-updatepo(1)>. 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:79
msgid ""
"Then, the I<manual editing> reported 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:80
msgid ""
"The bottom part of the figure shows how L<po4a-translate(1)> 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:81
msgid ""
"As noted before, the L<po4a(1)> program combines the effects of the "
"separated scripts, updating the PO files and the translated document in one "
"invocation.  The underlying logic remains the same."
msgstr ""

#. type: =head2
#: doc/po4a.7.pod:82
msgid "Starting a new translation"
msgstr ""

#. type: textblock
#: doc/po4a.7.pod:83
msgid ""
"If you use L<po4a(1)>, there is no specific step to start a translation. You "
"just have to list the languages in the configuration file, and the missing "
"PO files are automatically created. Naturally, the translator then have to "
"provide translations for every content used in your documents. L<po4a(1)> "
"also creates a POT file, that is a PO template file. Potential translators "
"can translate your project into a new language by renaming this file and "
"providing the translations in their language."
msgstr ""

#. type: textblock
#: doc/po4a.7.pod:84
msgid ""
"If you prefer to use the individual scripts separately, you should use "
"L<po4a-gettextize(1)> as follows to create the POT file. This file can then "
"be copied into F<XX.po> to initiate a new translation."
msgstr ""

#. type: verbatim
#: doc/po4a.7.pod:85
#, no-wrap
msgid ""
"  $ po4a-gettextize --format <format> --master <master.doc> --po "
"<translation.pot>\n"
"\n"
msgstr ""

#. type: textblock
#: doc/po4a.7.pod:86
msgid ""
"The master document is used in input, while the POT file is the output of "
"this process."
msgstr ""

#. type: =head2
#: doc/po4a.7.pod:87
msgid "Integrating changes to the original document"
msgstr ""

#. type: textblock
#: doc/po4a.7.pod:88
msgid ""
"The script to use for that is L<po4a-updatepo(1)> (please refer to its "
"documentation for details):"
msgstr ""

#. type: verbatim
#: doc/po4a.7.pod:89
#, no-wrap
msgid ""
"  $ po4a-updatepo --format <format> --master <new_master.doc> --po "
"<old_doc.XX.po>\n"
"\n"
msgstr ""

#. type: textblock
#: doc/po4a.7.pod:90
msgid ""
"The master document is used in input, while the PO file is updated: it is "
"used both in input and output."
msgstr ""

#. type: =head2
#: doc/po4a.7.pod:91
msgid "Generating a translated document"
msgstr ""

#. type: textblock
#: doc/po4a.7.pod:92
msgid ""
"Once you're done with the translation, you want to get the translated "
"documentation and distribute it to users along with the original one.  For "
"that, use the L<po4a-translate(1)> program as follows:"
msgstr ""

#. type: verbatim
#: doc/po4a.7.pod:93
#, no-wrap
msgid ""
"  $ po4a-translate --format <format> --master <master.doc> --po <doc.XX.po> "
"--localized <XX.doc>\n"
"\n"
msgstr ""

#. type: textblock
#: doc/po4a.7.pod:94
msgid ""
"Both the master and PO files are used in input, while the localized file is "
"the output of this process."
msgstr ""

#. type: =head2
#: doc/po4a.7.pod:95
msgid "Using addenda to add extra text to translations"
msgstr ""

#. type: textblock
#: doc/po4a.7.pod:96
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:97
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:98
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:99
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:100
#, no-wrap
msgid ""
" PO4A-HEADER: mode=eof\n"
"\n"
msgstr ""

#. type: textblock
#: doc/po4a.7.pod:101
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:102
#, no-wrap
msgid ""
" PO4A-HEADER: position=About this document; mode=after; "
"endboundary=</section>\n"
"\n"
msgstr ""

#. type: textblock
#: doc/po4a.7.pod:103
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:104
#, no-wrap
msgid ""
" PO4A-HEADER: position=À propos de ce document; mode=after; "
"endboundary=</section>\n"
"\n"
msgstr ""

#. type: textblock
#: doc/po4a.7.pod:105
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:106
msgid ""
"The exact same effect could be obtained with the following header, that is "
"equivalent:"
msgstr ""

#. type: verbatim
#: doc/po4a.7.pod:107
#, no-wrap
msgid ""
" PO4A-HEADER: position=About this document; mode=after; "
"beginboundary=<section>\n"
"\n"
msgstr ""

#. type: textblock
#: doc/po4a.7.pod:108
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 to "
"place 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:109
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 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 the last potential boundary line before the C<position>."
msgstr ""

#. type: verbatim
#: doc/po4a.7.pod:110
#, 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:111
msgid "Hint and tricks about addenda"
msgstr ""

#. type: textblock
#: doc/po4a.7.pod:112
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:113
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:114
#, 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:115
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:116
msgid ""
"Pass the B<-vv> argument to po4a to understand how the addenda are added to "
"the translation. It may also help to run po4a in debug mode to see the "
"actual internal data string when your addendum does not apply."
msgstr ""

#. type: =head3
#: doc/po4a.7.pod:117
msgid "Addenda examples"
msgstr ""

#. type: textblock
#: doc/po4a.7.pod:118
msgid "If you want to add something after the following nroff section:"
msgstr ""

#. type: verbatim
#: doc/po4a.7.pod:119
#, no-wrap
msgid ""
"  .SH \"AUTHORS\"\n"
"\n"
msgstr ""

#. type: textblock
#: doc/po4a.7.pod:120
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:121
#, no-wrap
msgid ""
" PO4A-HEADER:mode=after;position=AUTHORS;beginboundary=\\.SH\n"
"\n"
msgstr ""

#. type: textblock
#: doc/po4a.7.pod:122
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:123
#, no-wrap
msgid ""
" PO4A-HEADER:mode=after;position=Copyright Big Dude, 2004;beginboundary=^\n"
"\n"
msgstr ""

#. type: textblock
#: doc/po4a.7.pod:124
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:125
#, no-wrap
msgid ""
" PO4A-HEADER:mode=after;position=About this "
"document;beginboundary=FakePo4aBoundary\n"
"\n"
msgstr ""

#. type: =head3
#: doc/po4a.7.pod:126
msgid "More detailed example"
msgstr ""

#. type: textblock
#: doc/po4a.7.pod:127
msgid "Original document (POD formatted):"
msgstr ""

#. type: verbatim
#: doc/po4a.7.pod:128
#, 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:129
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:130
#, 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:131
msgid "To put your addendum before the AUTHOR, use the following header:"
msgstr ""

#. type: verbatim
#: doc/po4a.7.pod:132
#, no-wrap
msgid ""
" PO4A-HEADER:mode=after;position=NOM;beginboundary=^=head1\n"
"\n"
msgstr ""

#. type: textblock
#: doc/po4a.7.pod:133
msgid ""
"This works because the next line matching the B<beginboundary> /^=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:134
msgid "To avoid this you may accomplish the same using B<mode>=I<before>:"
msgstr ""

#. type: verbatim
#: doc/po4a.7.pod:135
#, no-wrap
msgid ""
" PO4A-HEADER:mode=before;position=^=head1 AUTEUR\n"
"\n"
msgstr ""

#. type: =head1
#: doc/po4a.7.pod:136
msgid "How does it work?"
msgstr ""

#. type: textblock
#: doc/po4a.7.pod:137
msgid ""
"This chapter gives you a brief overview of the po4a internals, so that you "
"may feel more confident to help us maintaining and improving it. It may also "
"help you understanding why it does not do what you expected, and how to "
"solve your problems."
msgstr ""

#. type: textblock
#: doc/po4a.7.pod:138
msgid ""
"The po4a architecture is object oriented. 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:139
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 than "
"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:140
#, 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:141
msgid ""
"This little bone is the core of all the po4a architecture. If you omit the "
"input PO and the output document, you get B<po4a-gettextize>. If you provide "
"both input and disregard the output PO, you get B<po4a-translate>. The "
"B<po4a> calls TransTractor twice and calls B<msgmerge -U> between these "
"TransTractor invocations to provide one-stop solution with a single "
"configuration file.  Please see L<Locale::Po4a::TransTractor(3pm)> for more "
"details."
msgstr ""

#. type: =head1
#: doc/po4a.7.pod:142
msgid "Open-source projects using po4a"
msgstr ""

#. type: textblock
#: doc/po4a.7.pod:143
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:144
msgid "adduser (man): users and groups management tool."
msgstr ""

#. type: textblock
#: doc/po4a.7.pod:145
msgid "apt (man, docbook): Debian package manager."
msgstr ""

#. type: textblock
#: doc/po4a.7.pod:146
msgid "aptitude (docbook, svg): terminal-based package manager for Debian"
msgstr ""

#. type: textblock
#: doc/po4a.7.pod:147
msgid ""
"L<F-Droid website|https://gitlab.com/fdroid/fdroid-website> (markdown): "
"installable catalogue of FOSS (Free and Open Source Software) applications "
"for the Android platform."
msgstr ""

#. type: textblock
#: doc/po4a.7.pod:148
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:149
msgid ""
"L<Linux manpages|https://salsa.debian.org/manpages-l10n-team/manpages-l10n> "
"(man)"
msgstr ""

#. type: textblock
#: doc/po4a.7.pod:150
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:151
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:152
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:153
msgid "FAQ"
msgstr ""

#. type: =head2
#: doc/po4a.7.pod:154
msgid "How do you pronounce po4a?"
msgstr ""

#. type: textblock
#: doc/po4a.7.pod:155
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:156
msgid "What about the other translation tools for documentation using gettext?"
msgstr ""

#. type: textblock
#: doc/po4a.7.pod:157
msgid "As far as I know, there are only two of them:"
msgstr ""

#. type: =item
#: doc/po4a.7.pod:158
msgid "B<poxml>"
msgstr ""

#. type: textblock
#: doc/po4a.7.pod:159
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:160
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:161
msgid "B<po-debiandoc>"
msgstr ""

#. type: textblock
#: doc/po4a.7.pod:162
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: textblock
#: doc/po4a.7.pod:163
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:164
msgid "SUMMARY of the advantages of the gettext based approach"
msgstr ""

#. type: textblock
#: doc/po4a.7.pod:165
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:166
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:167
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:168
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:169
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:170
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:171
#, 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:172
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:173
msgid "Addenda are… strange at the first glance."
msgstr ""

#. type: textblock
#: doc/po4a.7.pod:174
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:175
msgid "Even with an easy interface, it remains a new tool people have to learn."
msgstr ""

#. type: textblock
#: doc/po4a.7.pod:176
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:178
msgid "The documentation of the all-in-one tool that you should use: L<po4a(1)>."
msgstr ""

#. type: textblock
#: doc/po4a.7.pod:179
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:180
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:181
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:182
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:184
#, 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/Sgml.pm:7
#: lib/Locale/Po4a/TeX.pm:11 lib/Locale/Po4a/Text.pm:8 lib/Locale/Po4a/Wml.pm:7
#: lib/Locale/Po4a/Xhtml.pm:6 lib/Locale/Po4a/Xml.pm:9
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/Text.pm:9
#: lib/Locale/Po4a/Xhtml.pm:7 lib/Locale/Po4a/Xml.pm:11
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 source files, that 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<yfm_keys>"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/AsciiDoc.pm:32 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-insensitive match. Array values are always translated, unless the "
"B<yfm_skip_array> option is provided."
msgstr ""

#. type: =item
#: lib/Locale/Po4a/AsciiDoc.pm:33
msgid "B<nolinting>"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/AsciiDoc.pm:34
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:35
msgid "B<yfm_skip_array>"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/AsciiDoc.pm:36 lib/Locale/Po4a/Text.pm:33
msgid "Do not translate array values in the YAML Front Matter section."
msgstr ""

#. type: =head1
#: lib/Locale/Po4a/AsciiDoc.pm:37 lib/Locale/Po4a/TeX.pm:27
msgid "INLINE CUSTOMIZATION"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/AsciiDoc.pm:38
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:39
msgid "B<//po4a: macro >I<name>B<[>I<attribute list>B<]>"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/AsciiDoc.pm:40
msgid ""
"This permits to describe 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:41
msgid ""
"The I<attribute list> argument is a comma separated list which contains "
"informations about translatable arguments.  This list contains either "
"numbers, to define positional parameters, or named attributes."
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/AsciiDoc.pm:42
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:43
msgid "B<//po4a: style >B<[>I<attribute list>B<]>"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/AsciiDoc.pm:44
msgid ""
"This permits to describe in detail which attributes of a style 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 "
"informations 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:46
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:47
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:48
msgid "B<//po4a: entry >I<name>"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/AsciiDoc.pm:49
msgid ""
"This declares an attribute entry as being translatable.  By default, they "
"are not translated."
msgstr ""

#. type: =head1
#: lib/Locale/Po4a/AsciiDoc.pm:50 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/Sgml.pm:34
#: lib/Locale/Po4a/TeX.pm:104 lib/Locale/Po4a/Texinfo.pm:8
#: lib/Locale/Po4a/Text.pm:38 lib/Locale/Po4a/Wml.pm:9
#: lib/Locale/Po4a/Xhtml.pm:12 lib/Locale/Po4a/Xml.pm:178
msgid "STATUS OF THIS MODULE"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/AsciiDoc.pm:51
msgid "Tested successfully on simple AsciiDoc files."
msgstr ""

#. type: verbatim
#: lib/Locale/Po4a/AsciiDoc.pm:53
#, 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:55
#, 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:13 lib/Locale/Po4a/Text.pm:41
#, 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:102 lib/Locale/Po4a/Pod.pm:39
#: 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:103
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 lib/Locale/Po4a/Texinfo.pm:9
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:11
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/Halibut.pm:20 lib/Locale/Po4a/LaTeX.pm:14
#: lib/Locale/Po4a/Texinfo.pm:16
msgid ""
"This program is free software; you may redistribute it and/or modify it "
"under the terms of GPL (see COPYING file)."
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
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:41
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 permits to change 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 "
"permits to use po4a on generated man pages.  This option does not take any "
"argument."
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 permit to specify the behavior of a new macro (defined "
"with a .de request), or of a macro 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:91
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) wont 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:77
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 "gettextize($$)"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/Po.pm:38
msgid ""
"This function produces one translated message catalog from two catalogs, an "
"original and a translation. This process is described in L<po4a(7)|po4a.7>, "
"section I<Gettextization: how does it work?>."
msgstr ""

#. type: =item
#: lib/Locale/Po4a/Po.pm:39
msgid "filter($)"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/Po.pm:40
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:41
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:42
msgid "I love Perl sometimes ;)"
msgstr ""

#. type: =item
#: lib/Locale/Po4a/Po.pm:43
msgid "to_utf8()"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/Po.pm:44
msgid ""
"Recodes to UTF-8 the PO's msgstrs. Does nothing if the charset is not "
"specified in the PO file (\"CHARSET\" value), or if it's already UTF-8 or "
"ASCII."
msgstr ""

#. type: =head1
#: lib/Locale/Po4a/Po.pm:45
msgid "Functions to use a message catalog for translations"
msgstr ""

#. type: =item
#: lib/Locale/Po4a/Po.pm:46
msgid "gettext($%)"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/Po.pm:47
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:48
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:49 lib/Locale/Po4a/Po.pm:79
#: lib/Locale/Po4a/TransTractor.pm:120 lib/Locale/Po4a/Xml.pm:14
msgid "B<wrap>"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/Po.pm:50
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:51 lib/Locale/Po4a/Po.pm:82
#: lib/Locale/Po4a/TransTractor.pm:122
msgid "B<wrapcol>"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/Po.pm:52 lib/Locale/Po4a/Po.pm:83
#: lib/Locale/Po4a/TransTractor.pm:123
msgid "the column at which we should wrap (default: 76)."
msgstr ""

#. type: =item
#: lib/Locale/Po4a/Po.pm:53
msgid "stats_get()"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/Po.pm:54
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:55
#, no-wrap
msgid ""
"    [some use of the PO file to translate stuff]\n"
"\n"
msgstr ""

#. type: verbatim
#: lib/Locale/Po4a/Po.pm:56
#, 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:57
msgid "stats_clear()"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/Po.pm:58
msgid "Clears the statistics about gettext hits."
msgstr ""

#. type: =head1
#: lib/Locale/Po4a/Po.pm:59
msgid "Functions to build a message catalog"
msgstr ""

#. type: =item
#: lib/Locale/Po4a/Po.pm:60
msgid "push(%)"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/Po.pm:61
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:62
msgid "B<msgid>"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/Po.pm:63
msgid "the string in original language."
msgstr ""

#. type: =item
#: lib/Locale/Po4a/Po.pm:64
msgid "B<msgstr>"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/Po.pm:65
msgid "the translation."
msgstr ""

#. type: =item
#: lib/Locale/Po4a/Po.pm:66
msgid "B<reference>"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/Po.pm:67
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:68 lib/Locale/Po4a/TransTractor.pm:124
msgid "B<comment>"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/Po.pm:69
msgid "a comment added here manually (by the translators). The format here is free."
msgstr ""

#. type: =item
#: lib/Locale/Po4a/Po.pm:70
msgid "B<automatic>"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/Po.pm:71
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:72
msgid "B<flags>"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/Po.pm:73
msgid "space-separated list of all defined flags for this entry."
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/Po.pm:74
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:75
msgid "See the gettext documentation for their meaning."
msgstr ""

#. type: =item
#: lib/Locale/Po4a/Po.pm:76
msgid "B<type>"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/Po.pm:77
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:78
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:80
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:81
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:84
msgid "This information is not written to the PO file."
msgstr ""

#. type: =head1
#: lib/Locale/Po4a/Po.pm:85
msgid "Miscellaneous functions"
msgstr ""

#. type: =item
#: lib/Locale/Po4a/Po.pm:86
msgid "count_entries()"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/Po.pm:87
msgid "Returns the number of entries in the catalog (without the header)."
msgstr ""

#. type: =item
#: lib/Locale/Po4a/Po.pm:88
msgid "count_entries_doc()"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/Po.pm:89
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:90
msgid "equals_msgid(po)"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/Po.pm:91
msgid ""
"Returns ($uptodate, $diagnostic) with $uptodate indicating whether all msgid "
"of the current po file are also present in the one passed as parameter (all "
"other fields are ignored in the file comparison).  Informally, if $uptodate "
"returns false, then the po files would be changed when going through "
"B<po4a-updatepo>."
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/Po.pm:92
msgid ""
"If $uptodate is false, then $diagnostic contains a diagnostic of why this is "
"so."
msgstr ""

#. type: =item
#: lib/Locale/Po4a/Po.pm:93
msgid "msgid($)"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/Po.pm:94
msgid "Returns the msgid of the given number."
msgstr ""

#. type: =item
#: lib/Locale/Po4a/Po.pm:95
msgid "msgid_doc($)"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/Po.pm:96
msgid "Returns the msgid with the given position in the document."
msgstr ""

#. type: =item
#: lib/Locale/Po4a/Po.pm:97
msgid "get_charset()"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/Po.pm:98
msgid ""
"Returns the character set specified in the PO header. If it hasn't been set, "
"it will return \"UTF-8\"."
msgstr ""

#. type: =item
#: lib/Locale/Po4a/Po.pm:99
msgid "set_charset($)"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/Po.pm:100
msgid ""
"This sets the character set of the PO header to the value specified in its "
"first argument. If you never call this function (and no file with a "
"specified character set is read), the default value is left to "
"\"UTF-8\". This value doesn't change the behavior of this module, it's just "
"used to fill that field in the header, and to return it in get_charset()."
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 (sentence => 0, width => 78);\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): "
"/usr/lib/perl5/Tk/MainWindow.pod /usr/share/perl/5.8.0/overload.pod "
"/usr/share/perl/5.8.0/pod/perlapi.pod "
"/usr/share/perl/5.8.0/pod/perldelta.pod "
"/usr/share/perl/5.8.0/pod/perlfaq5.pod /usr/share/perl/5.8.0/pod/perlpod.pod "
"/usr/share/perl/5.8.0/pod/perlre.pod /usr/share/perl/5.8.0/pod/perlretut.pod"
msgstr ""

#. type: =head1
#: lib/Locale/Po4a/Pod.pm:18
msgid "INTERNALS"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/Pod.pm:19
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:20
msgid ""
"new() can take options, in the form of key/value pairs, that control the "
"behavior of the parser.  The recognized options common to all Pod::Parser "
"children are:"
msgstr ""

#. type: =item
#: lib/Locale/Po4a/Pod.pm:21
msgid "B<alt>"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/Pod.pm:22
msgid ""
"If set to a true value, selects an alternate output format that, among other "
"things, uses a different heading style and marks B<=item> entries with a "
"colon in the left margin.  Defaults to false."
msgstr ""

#. type: =item
#: lib/Locale/Po4a/Pod.pm:23
msgid "B<code>"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/Pod.pm:24
msgid ""
"If set to a true value, the non-POD parts of the input file will be included "
"in the output.  Useful for viewing code documented with POD blocks with the "
"POD rendered and the code left intact."
msgstr ""

#. type: =item
#: lib/Locale/Po4a/Pod.pm:25 lib/Locale/Po4a/Sgml.pm:16
msgid "B<indent>"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/Pod.pm:26
msgid ""
"The number of spaces to indent regular text, and the default indentation for "
"B<=over> blocks.  Defaults to 4."
msgstr ""

#. type: =item
#: lib/Locale/Po4a/Pod.pm:27
msgid "B<loose>"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/Pod.pm:28
msgid ""
"If set to a true value, a blank line is printed after a B<=head1> heading.  "
"If set to false (the default), no blank line is printed after B<=head1>, "
"although one is still printed after B<=head2>.  This is the default because "
"it's the expected formatting for manual pages; if you're formatting "
"arbitrary text documents, setting this to true may result in more pleasing "
"output."
msgstr ""

#. type: =item
#: lib/Locale/Po4a/Pod.pm:29
msgid "B<quotes>"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/Pod.pm:30
msgid ""
"Sets the quote marks used to surround CE<lt>> text.  If the value is a "
"single character, it is used as both the left and right quote; if it is two "
"characters, the first character is used as the left quote and the second as "
"the right quote; and if it is four characters, the first two are used as the "
"left quote and the second two as the right quote."
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/Pod.pm:31
msgid ""
"This may also be set to the special value B<none>, in which case no quote "
"marks are added around CE<lt>> text."
msgstr ""

#. type: =item
#: lib/Locale/Po4a/Pod.pm:32
msgid "B<sentence>"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/Pod.pm:33
msgid ""
"If set to a true value, Locale::Po4a::Pod will assume that each sentence "
"ends in two spaces, and will try to preserve that spacing.  If set to false, "
"all consecutive whitespace in non-verbatim paragraphs is compressed into a "
"single space.  Defaults to true."
msgstr ""

#. type: =item
#: lib/Locale/Po4a/Pod.pm:34
msgid "B<width>"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/Pod.pm:35
msgid "The column at which to wrap text on the right-hand side.  Defaults to 76."
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/Pod.pm:37
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/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 part you want to "
"debug. Possible values are: tag, generic, entities and refs."
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."
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: textblock
#: lib/Locale/Po4a/Sgml.pm:17
msgid "Space separated list of tags which increase the indentation level."
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 translate section would create "
"msgids not being whole sentences, 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, \"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: "
"E<lt>bbbE<gt>E<lt>aaaE<gt>lang specifies that the lang attribute will only "
"be translated if it is in an E<lt>aaaE<gt> tag, which is in a E<lt>bbbE<gt> "
"tag.  The tag names are actually regular expressions so you can also write "
"things like E<lt>aaa|bbbbE<gt>lang to only translate lang attributes that "
"are in an E<lt>aaaE<gt> or a E<lt>bbbE<gt> 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. Note that this setting automatically adds "
"the given attribute into the '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 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 '&version;') are skipped "
"for the translator comfort. Activating this option prevents this "
"optimisation. It can be useful if the document contains a construction like "
"\"<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 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. But there are still some problems:"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/Sgml.pm:37
msgid ""
"The error output of 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 onsgmls. Otherwise "
"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 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 "
"&version;) from 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 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 derivates 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 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/TeX.pm:10
msgid ""
"This module can also be customized by lines starting with \"% po4a:\" in the "
"TeX file.  These customizations are 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 ""
"Using these options permits to override the behaviour of the commands "
"defined in the default lists."
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 permit to describe 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 permits to keep 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 permits to define the parameters accepted by the I<env> environment.\n"
"This information is later used to check the number of arguments of the\n"
"\\begin command, and permit to specify which one must be translated.\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 "
"backreference.  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 expended 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
msgid "INTERNAL FUNCTIONS used to write derivated 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:180
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 could allow 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:15
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 key value pair as verbatim (with the "
"no-wrap flag in the PO file).  Key value pairs are defined as a line "
"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 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 informations."
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_skip_array> (markdown-only)"
msgstr ""

#. type: =item
#: lib/Locale/Po4a/Text.pm:34
msgid "B<control>[B<=>I<taglist>]"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/Text.pm:35
msgid ""
"Handle control files.  A comma-separated list of tags to be translated can "
"be provided."
msgstr ""

#. type: =item
#: lib/Locale/Po4a/Text.pm:36
msgid "B<neverwrap>"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/Text.pm:37
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:39
msgid "Tested successfully on simple text files and NEWS.Debian files."
msgstr ""

#. type: verbatim
#: lib/Locale/Po4a/Text.pm:43
#, no-wrap
msgid ""
" Copyright © 2005-2008 Nicolas FRANÇOIS "
"<nicolas.francois@centraliens.net>.\n"
"\n"
msgstr ""

#. type: verbatim
#: lib/Locale/Po4a/Text.pm:44
#, 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:112 lib/Locale/Po4a/TransTractor.pm:114
#: lib/Locale/Po4a/TransTractor.pm:116 lib/Locale/Po4a/TransTractor.pm:127
#: lib/Locale/Po4a/TransTractor.pm:129 lib/Locale/Po4a/TransTractor.pm:131
#: lib/Locale/Po4a/TransTractor.pm:148 lib/Locale/Po4a/TransTractor.pm:150
#: lib/Locale/Po4a/TransTractor.pm:152
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, it will try to "
"detect it from the input document)."
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, it will use the "
"PO file charset)."
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 (but be in a hash):"
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: =head2
#: lib/Locale/Po4a/TransTractor.pm:72
msgid "Manipulating document files"
msgstr ""

#. type: =item
#: lib/Locale/Po4a/TransTractor.pm:73
msgid "read($$)"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/TransTractor.pm:74
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:75
#, 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:76
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:78
msgid "Write the translated document to the given filename."
msgstr ""

#. type: verbatim
#: lib/Locale/Po4a/TransTractor.pm:79
#, 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:80
msgid "Manipulating PO files"
msgstr ""

#. type: =item
#: lib/Locale/Po4a/TransTractor.pm:81
msgid "readpo($)"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/TransTractor.pm:82
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:83
msgid "writepo($)"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/TransTractor.pm:84
msgid "Write the extracted PO file to the given filename."
msgstr ""

#. type: =item
#: lib/Locale/Po4a/TransTractor.pm:85
msgid "stats()"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/TransTractor.pm:86
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:87
#, no-wrap
msgid ""
"    [normal use of the po4a document...]\n"
"\n"
msgstr ""

#. type: verbatim
#: lib/Locale/Po4a/TransTractor.pm:88
#, 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: =item
#: lib/Locale/Po4a/TransTractor.pm:89
msgid "is_po_uptodate()"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/TransTractor.pm:90
msgid ""
"Returns ($uptodate, $diagnostic) where $uptodate is whether the input po and "
"the output po match (if not, it means that the input po should be updated)  "
"and $diagnostic is a string explaining why the po file is not uptodate, when "
"this happens."
msgstr ""

#. type: =head2
#: lib/Locale/Po4a/TransTractor.pm:91
msgid "Manipulating addenda"
msgstr ""

#. type: =item
#: lib/Locale/Po4a/TransTractor.pm:92
msgid "addendum($)"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/TransTractor.pm:93
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:94
msgid "This function returns a non-null integer on error."
msgstr ""

#. type: =head1
#: lib/Locale/Po4a/TransTractor.pm:95 lib/Locale/Po4a/Xml.pm:131
msgid "INTERNAL FUNCTIONS used to write derivative parsers"
msgstr ""

#. type: =head2
#: lib/Locale/Po4a/TransTractor.pm:96
msgid "Getting input, providing output"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/TransTractor.pm:97
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:98
#, 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:99
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:100
msgid "shiftline()"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/TransTractor.pm:101
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:102
msgid "unshiftline($$)"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/TransTractor.pm:103
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:104
msgid "pushline($)"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/TransTractor.pm:105
msgid "Push a new line to the end of C<< {$self->{TT}{doc_out}} >>."
msgstr ""

#. type: =item
#: lib/Locale/Po4a/TransTractor.pm:106
msgid "popline()"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/TransTractor.pm:107
msgid "Pop the last pushed line from the end of C<< {$self->{TT}{doc_out}} >>."
msgstr ""

#. type: =head2
#: lib/Locale/Po4a/TransTractor.pm:108
msgid "Marking strings as translatable"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/TransTractor.pm:109
msgid "One function is provided to handle the text which should be translated."
msgstr ""

#. type: =item
#: lib/Locale/Po4a/TransTractor.pm:110
msgid "translate($$$)"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/TransTractor.pm:111
msgid "Mandatory arguments:"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/TransTractor.pm:113
msgid "A string to translate"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/TransTractor.pm:115
msgid "The reference of this string (i.e. position in inputfile)"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/TransTractor.pm:117
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:118
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:119
#, no-wrap
msgid ""
"  $self->translate(\"string\",\"ref\",\"type\",\n"
"                   'wrap' => 1);\n"
"\n"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/TransTractor.pm:121
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 "an extra comment to add to the entry."
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/TransTractor.pm:126
msgid "Actions:"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/TransTractor.pm:128
msgid "Pushes the string, reference and type to po_out."
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/TransTractor.pm:130
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:132
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:133
msgid "Misc functions"
msgstr ""

#. type: =item
#: lib/Locale/Po4a/TransTractor.pm:134
msgid "verbose()"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/TransTractor.pm:135
msgid ""
"Returns if the verbose option was passed during the creation of the "
"TransTractor."
msgstr ""

#. type: =item
#: lib/Locale/Po4a/TransTractor.pm:136
msgid "debug()"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/TransTractor.pm:137
msgid ""
"Returns if the debug option was passed during the creation of the "
"TransTractor."
msgstr ""

#. type: =item
#: lib/Locale/Po4a/TransTractor.pm:138
msgid "detected_charset($)"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/TransTractor.pm:139
msgid ""
"This tells TransTractor that a new charset (the first argument) has been "
"detected from the input document. It can usually be read from the document "
"header. Only the first charset will remain, coming either from the process() "
"arguments or detected from the document."
msgstr ""

#. type: =item
#: lib/Locale/Po4a/TransTractor.pm:140
msgid "get_out_charset()"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/TransTractor.pm:141
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:142
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: =item
#: lib/Locale/Po4a/TransTractor.pm:143
msgid "recode_skipped_text($)"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/TransTractor.pm:144
msgid ""
"This function returns the recoded text passed as argument, from the input "
"document's charset to the output document's one. This isn't needed when "
"translating a string (translate() recodes everything itself), but it is when "
"you skip a string from the input document and you want the output document "
"to be consistent with the global encoding."
msgstr ""

#. type: =head1
#: lib/Locale/Po4a/TransTractor.pm:145
msgid "FUTURE DIRECTIONS"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/TransTractor.pm:146
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:147
msgid "To address this problem, the only interface changes needed are:"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/TransTractor.pm:149
msgid "take a hash as po_in_name (a list per language)"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/TransTractor.pm:151
msgid "add an argument to translate to indicate the target language"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/TransTractor.pm:153
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:154
#, 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:155
msgid "Will see if it's enough ;)"
msgstr ""

#. type: verbatim
#: lib/Locale/Po4a/TransTractor.pm:157
#, 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. In particular, tables are getting no testing whatsoever, as we don't "
"use them."
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: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 \"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 "
"C<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 'w' (wrap) or 'W' (don't wrap)  "
"to override the default behavior specified by the global \"wrap\" option."
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/Xml.pm:47 lib/Locale/Po4a/Xml.pm:89
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:93
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<<? ... ?>> 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: verbatim
#: lib/Locale/Po4a/Xml.pm:87
#, no-wrap
msgid ""
"  * Tags listed in B<break> are set to I<w> or I<W> depending on the <wrap> "
"option.\n"
"  * Tags listed in B<inline> are set to I<i>.\n"
"  * Tags listed in B<placeholder> are set to I<p>.\n"
"  * Tags listed in B<untranslated> are without any of these options set.\n"
"\n"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/Xml.pm:88
msgid ""
"You can verify actual internal parameter behavior by invoking B<po4a> with "
"B<--debug> option."
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/Xml.pm:90
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:92
msgid "Space-separated list of tags you do not want to translate."
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/Xml.pm:94
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 <wrap> option."
msgstr ""

#. type: =item
#: lib/Locale/Po4a/Xml.pm:95
msgid "B<defaulttranslateoption>"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/Xml.pm:96
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:97
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:98
msgid "WRITING DERIVATIVE MODULES"
msgstr ""

#. type: =head2
#: lib/Locale/Po4a/Xml.pm:99
msgid "DEFINE WHAT TAGS AND ATTRIBUTES TO TRANSLATE"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/Xml.pm:100
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:101
#, 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:102
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:104
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:105
msgid "See L<Locale::Po4a::Docbook(3pm)|Locale::Po4a::Docbook>,"
msgstr ""

#. type: =head2
#: lib/Locale/Po4a/Xml.pm:106
msgid "OVERRIDING THE found_string FUNCTION"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/Xml.pm:107
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:108
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:109
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:110
msgid "type=\"tag\""
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/Xml.pm:111
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:112
msgid "type=\"attribute\""
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/Xml.pm:113
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:114
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:115
#, 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:116
msgid ""
"There's another simple example in the new Dia module, which only filters "
"some strings."
msgstr ""

#. type: =head2
#: lib/Locale/Po4a/Xml.pm:117
msgid "MODIFYING TAG TYPES (TODO)"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/Xml.pm:118
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:119
msgid "B<beginning>"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/Xml.pm:120
msgid "Specifies the beginning of the tag, after the \"E<lt>\"."
msgstr ""

#. type: =item
#: lib/Locale/Po4a/Xml.pm:121
msgid "B<end>"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/Xml.pm:122
msgid "Specifies the end of the tag, before the \"E<gt>\"."
msgstr ""

#. type: =item
#: lib/Locale/Po4a/Xml.pm:123
msgid "B<breaking>"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/Xml.pm:124
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:125
msgid "B<f_breaking>"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/Xml.pm:126
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:127
msgid "B<f_extract>"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/Xml.pm:128
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:129
msgid "B<f_translate>"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/Xml.pm:130
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:132
msgid "WORKING WITH TAGS"
msgstr ""

#. type: =item
#: lib/Locale/Po4a/Xml.pm:133
msgid "get_path()"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/Xml.pm:134
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:135
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:136
msgid "tag_type()"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/Xml.pm:137
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:138
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:139 lib/Locale/Po4a/Xml.pm:142
#: lib/Locale/Po4a/Xml.pm:149 lib/Locale/Po4a/Xml.pm:158
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:140
msgid "extract_tag($$)"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/Xml.pm:141
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:143
msgid "get_tag_name(@)"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/Xml.pm:144
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:145
msgid "breaking_tag()"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/Xml.pm:146
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:147
msgid "treat_tag()"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/Xml.pm:148
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:150
msgid "tag_in_list($@)"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/Xml.pm:151
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:152
msgid "WORKING WITH ATTRIBUTES"
msgstr ""

#. type: =item
#: lib/Locale/Po4a/Xml.pm:153
msgid "treat_attributes(@)"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/Xml.pm:154
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 "
"\"attributes\").  This returns a plain string with the translated tag."
msgstr ""

#. type: =head2
#: lib/Locale/Po4a/Xml.pm:155
msgid "WORKING WITH TAGGED CONTENTS"
msgstr ""

#. type: =item
#: lib/Locale/Po4a/Xml.pm:156
msgid "treat_content()"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/Xml.pm:157
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:159
msgid "WORKING WITH THE MODULE OPTIONS"
msgstr ""

#. type: =item
#: lib/Locale/Po4a/Xml.pm:160
msgid "treat_options()"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/Xml.pm:161
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:162
msgid "GETTING TEXT FROM THE INPUT DOCUMENT"
msgstr ""

#. type: =item
#: lib/Locale/Po4a/Xml.pm:163
msgid "get_string_until($%)"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/Xml.pm:164
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:165
msgid "The valid options are:"
msgstr ""

#. type: =item
#: lib/Locale/Po4a/Xml.pm:166
msgid "B<include>"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/Xml.pm:167
msgid "This makes the returned array to contain the searched text"
msgstr ""

#. type: =item
#: lib/Locale/Po4a/Xml.pm:168
msgid "B<remove>"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/Xml.pm:169
msgid "This removes the returned stream from the input"
msgstr ""

#. type: =item
#: lib/Locale/Po4a/Xml.pm:170
msgid "B<unquoted>"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/Xml.pm:171
msgid "This ensures that the searched text is outside any quotes"
msgstr ""

#. type: =item
#: lib/Locale/Po4a/Xml.pm:172
msgid "B<regex>"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/Xml.pm:173
msgid ""
"This denotes that the first argument is a regular expression rather than an "
"plain string"
msgstr ""

#. type: =item
#: lib/Locale/Po4a/Xml.pm:174
msgid "skip_spaces(\\@)"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/Xml.pm:175
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:176
msgid "join_lines(@)"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/Xml.pm:177
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:179
msgid "This module can translate tags and attributes."
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/Xml.pm:181
msgid "DOCTYPE (ENTITIES)"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/Xml.pm:182
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:183
msgid ""
"MODIFY TAG TYPES FROM INHERITED MODULES (move the tag_types structure inside "
"the $self hash?)"
msgstr ""

#. type: textblock
#: lib/Locale/Po4a/Xml.pm:185
msgid ""
"L<Locale::Po4a::TransTractor(3pm)|Locale::Po4a::TransTractor>, "
"L<po4a(7)|po4a.7>"
msgstr ""

#. type: verbatim
#: lib/Locale/Po4a/Xml.pm:187
#, 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:189
#, no-wrap
msgid ""
" Copyright © 2004 Jordi Vilalta  <jvprat@gmail.com>\n"
" Copyright © 2008-2009 Nicolas François <nicolas.francois@centraliens.net>\n"
"\n"
msgstr ""