Merging upstream version 0.73.

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 89 insertions, 79 deletions

diff --git a/po/pod/nb.po b/po/pod/nb.po
index 1c15e88..dc73f50 100644
--- a/po/pod/nb.po
+++ b/po/pod/nb.po
@@ -7,7 +7,7 @@ msgid ""
 msgstr ""
 "Project-Id-Version: po4a 0.51\n"
 "Report-Msgid-Bugs-To: devel@lists.po4a.org\n"
-"POT-Creation-Date: 2024-05-26 00:33+0200\n"
+"POT-Creation-Date: 2024-06-13 00:50+0200\n"
 "PO-Revision-Date: 2024-02-17 08:02+0000\n"
 "Last-Translator: Petter Reinholdtsen <pere-weblate@hungry.com>\n"
 "Language-Team: Norwegian Bokmål <https://hosted.weblate.org/projects/po4a/"
@@ -1679,7 +1679,7 @@ msgstr ""
 #: lib/Locale/Po4a/Po.pm:93 lib/Locale/Po4a/Pod.pm:23
 #: lib/Locale/Po4a/RubyDoc.pm:16 lib/Locale/Po4a/Sgml.pm:53
 #: lib/Locale/Po4a/TeX.pm:120 lib/Locale/Po4a/Texinfo.pm:16
-#: lib/Locale/Po4a/Text.pm:45 lib/Locale/Po4a/TransTractor.pm:157
+#: lib/Locale/Po4a/Text.pm:45 lib/Locale/Po4a/TransTractor.pm:158
 #: lib/Locale/Po4a/Wml.pm:11 lib/Locale/Po4a/Xhtml.pm:17
 #: lib/Locale/Po4a/Xml.pm:189 lib/Locale/Po4a/Yaml.pm:17
 msgid "AUTHORS"
@@ -6050,7 +6050,7 @@ msgid ""
 msgstr ""
 
 #. type: =item
-#: lib/Locale/Po4a/Po.pm:33 lib/Locale/Po4a/TransTractor.pm:81
+#: lib/Locale/Po4a/Po.pm:33 lib/Locale/Po4a/TransTractor.pm:82
 msgid "write($)"
 msgstr ""
 
@@ -6125,7 +6125,7 @@ msgstr ""
 
 #. type: =item
 #: lib/Locale/Po4a/Po.pm:45 lib/Locale/Po4a/Po.pm:75
-#: lib/Locale/Po4a/TransTractor.pm:122 lib/Locale/Po4a/Xml.pm:14
+#: lib/Locale/Po4a/TransTractor.pm:123 lib/Locale/Po4a/Xml.pm:14
 msgid "B<wrap>"
 msgstr ""
 
@@ -6139,7 +6139,7 @@ msgstr ""
 
 #. type: =item
 #: lib/Locale/Po4a/Po.pm:47 lib/Locale/Po4a/Po.pm:78
-#: lib/Locale/Po4a/TransTractor.pm:124
+#: lib/Locale/Po4a/TransTractor.pm:125
 msgid "B<wrapcol>"
 msgstr ""
 
@@ -6241,7 +6241,7 @@ msgid ""
 msgstr ""
 
 #. type: =item
-#: lib/Locale/Po4a/Po.pm:64 lib/Locale/Po4a/TransTractor.pm:127
+#: lib/Locale/Po4a/Po.pm:64 lib/Locale/Po4a/TransTractor.pm:128
 msgid "B<comment>"
 msgstr ""
 
@@ -7493,7 +7493,7 @@ msgid "B<docheader>"
 msgstr ""
 
 #. type: =head1
-#: lib/Locale/Po4a/TeX.pm:91 lib/Locale/Po4a/TransTractor.pm:97
+#: lib/Locale/Po4a/TeX.pm:91 lib/Locale/Po4a/TransTractor.pm:98
 #: lib/Locale/Po4a/Xml.pm:134
 msgid "INTERNAL FUNCTIONS used to write derivative parsers"
 msgstr ""
@@ -7949,11 +7949,11 @@ msgstr ""
 #. type: =item
 #: lib/Locale/Po4a/TransTractor.pm:7 lib/Locale/Po4a/TransTractor.pm:9
 #: lib/Locale/Po4a/TransTractor.pm:12 lib/Locale/Po4a/TransTractor.pm:14
-#: lib/Locale/Po4a/TransTractor.pm:114 lib/Locale/Po4a/TransTractor.pm:116
-#: lib/Locale/Po4a/TransTractor.pm:118 lib/Locale/Po4a/TransTractor.pm:130
-#: lib/Locale/Po4a/TransTractor.pm:132 lib/Locale/Po4a/TransTractor.pm:134
-#: lib/Locale/Po4a/TransTractor.pm:149 lib/Locale/Po4a/TransTractor.pm:151
-#: lib/Locale/Po4a/TransTractor.pm:153
+#: lib/Locale/Po4a/TransTractor.pm:115 lib/Locale/Po4a/TransTractor.pm:117
+#: lib/Locale/Po4a/TransTractor.pm:119 lib/Locale/Po4a/TransTractor.pm:131
+#: lib/Locale/Po4a/TransTractor.pm:133 lib/Locale/Po4a/TransTractor.pm:135
+#: lib/Locale/Po4a/TransTractor.pm:150 lib/Locale/Po4a/TransTractor.pm:152
+#: lib/Locale/Po4a/TransTractor.pm:154
 msgid "-"
 msgstr ""
 
@@ -8372,21 +8372,31 @@ msgstr ""
 
 #. type: =item
 #: lib/Locale/Po4a/TransTractor.pm:77
-msgid "read($$)"
+msgid "read($$$)"
 msgstr ""
 
 #. type: textblock
 #: lib/Locale/Po4a/TransTractor.pm:78
 msgid ""
 "Add another input document data at the end of the existing array C<< @{$self-"
-">{TT}{doc_in}} >>. The argument is the filename to read. If a second "
-"argument is provided, it is the filename to use in the references."
+">{TT}{doc_in}} >>."
 msgstr ""
 
 #. type: verbatim
 #: lib/Locale/Po4a/TransTractor.pm:79
 #, no-wrap
 msgid ""
+"This function takes two mandatory arguments and an optional one.\n"
+" * The filename to read on disk;\n"
+" * The name to use as filename when building the reference in the PO file;\n"
+" * The charset to use to read that file (UTF-8 by default)\n"
+"\n"
+msgstr ""
+
+#. type: verbatim
+#: lib/Locale/Po4a/TransTractor.pm:80
+#, 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"
@@ -8396,19 +8406,19 @@ msgid ""
 msgstr ""
 
 #. type: textblock
-#: lib/Locale/Po4a/TransTractor.pm:80
+#: lib/Locale/Po4a/TransTractor.pm:81
 msgid ""
 "Please note that it does not parse anything. You should use the parse()  "
 "function when you're done with packing input files into the document."
 msgstr ""
 
 #. type: textblock
-#: lib/Locale/Po4a/TransTractor.pm:82
+#: lib/Locale/Po4a/TransTractor.pm:83
 msgid "Write the translated document to the given filename."
 msgstr ""
 
 #. type: verbatim
-#: lib/Locale/Po4a/TransTractor.pm:83
+#: lib/Locale/Po4a/TransTractor.pm:84
 #, no-wrap
 msgid ""
 "This translated document data are provided by:\n"
@@ -8418,39 +8428,39 @@ msgid ""
 msgstr ""
 
 #. type: =head2
-#: lib/Locale/Po4a/TransTractor.pm:84
+#: lib/Locale/Po4a/TransTractor.pm:85
 msgid "Manipulating PO files"
 msgstr ""
 
 #. type: =item
-#: lib/Locale/Po4a/TransTractor.pm:85
+#: lib/Locale/Po4a/TransTractor.pm:86
 msgid "readpo($)"
 msgstr ""
 
 #. type: textblock
-#: lib/Locale/Po4a/TransTractor.pm:86
+#: lib/Locale/Po4a/TransTractor.pm:87
 msgid ""
 "Add the content of a file (which name is passed as argument) to the existing "
 "input PO. The old content is not discarded."
 msgstr ""
 
 #. type: =item
-#: lib/Locale/Po4a/TransTractor.pm:87
+#: lib/Locale/Po4a/TransTractor.pm:88
 msgid "writepo($)"
 msgstr ""
 
 #. type: textblock
-#: lib/Locale/Po4a/TransTractor.pm:88
+#: lib/Locale/Po4a/TransTractor.pm:89
 msgid "Write the extracted PO file to the given filename."
 msgstr ""
 
 #. type: =item
-#: lib/Locale/Po4a/TransTractor.pm:89
+#: lib/Locale/Po4a/TransTractor.pm:90
 msgid "stats()"
 msgstr ""
 
 #. type: textblock
-#: lib/Locale/Po4a/TransTractor.pm:90
+#: lib/Locale/Po4a/TransTractor.pm:91
 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. "
@@ -8460,7 +8470,7 @@ msgid ""
 msgstr ""
 
 #. type: verbatim
-#: lib/Locale/Po4a/TransTractor.pm:91
+#: lib/Locale/Po4a/TransTractor.pm:92
 #, no-wrap
 msgid ""
 "    [normal use of the po4a document...]\n"
@@ -8468,7 +8478,7 @@ msgid ""
 msgstr ""
 
 #. type: verbatim
-#: lib/Locale/Po4a/TransTractor.pm:92
+#: lib/Locale/Po4a/TransTractor.pm:93
 #, no-wrap
 msgid ""
 "    ($percent,$hit,$queries) = $document->stats();\n"
@@ -8477,17 +8487,17 @@ msgid ""
 msgstr ""
 
 #. type: =head2
-#: lib/Locale/Po4a/TransTractor.pm:93
+#: lib/Locale/Po4a/TransTractor.pm:94
 msgid "Manipulating addenda"
 msgstr ""
 
 #. type: =item
-#: lib/Locale/Po4a/TransTractor.pm:94
+#: lib/Locale/Po4a/TransTractor.pm:95
 msgid "addendum($)"
 msgstr ""
 
 #. type: textblock
-#: lib/Locale/Po4a/TransTractor.pm:95
+#: lib/Locale/Po4a/TransTractor.pm:96
 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 "
@@ -8496,24 +8506,24 @@ msgid ""
 msgstr ""
 
 #. type: textblock
-#: lib/Locale/Po4a/TransTractor.pm:96
+#: lib/Locale/Po4a/TransTractor.pm:97
 msgid "This function returns a non-null integer on error."
 msgstr ""
 
 #. type: =head2
-#: lib/Locale/Po4a/TransTractor.pm:98
+#: lib/Locale/Po4a/TransTractor.pm:99
 msgid "Getting input, providing output"
 msgstr ""
 
 #. type: textblock
-#: lib/Locale/Po4a/TransTractor.pm:99
+#: lib/Locale/Po4a/TransTractor.pm:100
 msgid ""
 "Four functions are provided to get input and return output. They are very "
 "similar to shift/unshift and push/pop of Perl."
 msgstr ""
 
 #. type: verbatim
-#: lib/Locale/Po4a/TransTractor.pm:100
+#: lib/Locale/Po4a/TransTractor.pm:101
 #, no-wrap
 msgid ""
 " * Perl shift returns the first array item and drop it from the array.\n"
@@ -8524,7 +8534,7 @@ msgid ""
 msgstr ""
 
 #. type: textblock
-#: lib/Locale/Po4a/TransTractor.pm:101
+#: lib/Locale/Po4a/TransTractor.pm:102
 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 "
@@ -8532,12 +8542,12 @@ msgid ""
 msgstr ""
 
 #. type: =item
-#: lib/Locale/Po4a/TransTractor.pm:102
+#: lib/Locale/Po4a/TransTractor.pm:103
 msgid "shiftline()"
 msgstr ""
 
 #. type: textblock
-#: lib/Locale/Po4a/TransTractor.pm:103
+#: lib/Locale/Po4a/TransTractor.pm:104
 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}} >> "
@@ -8546,69 +8556,69 @@ msgid ""
 msgstr ""
 
 #. type: =item
-#: lib/Locale/Po4a/TransTractor.pm:104
+#: lib/Locale/Po4a/TransTractor.pm:105
 msgid "unshiftline($$)"
 msgstr ""
 
 #. type: textblock
-#: lib/Locale/Po4a/TransTractor.pm:105
+#: lib/Locale/Po4a/TransTractor.pm:106
 msgid ""
 "Unshifts the last shifted line of the input document and its corresponding "
 "reference back to the head of C<< {$self->{TT}{doc_in}} >>."
 msgstr ""
 
 #. type: =item
-#: lib/Locale/Po4a/TransTractor.pm:106
+#: lib/Locale/Po4a/TransTractor.pm:107
 msgid "pushline($)"
 msgstr ""
 
 #. type: textblock
-#: lib/Locale/Po4a/TransTractor.pm:107
+#: lib/Locale/Po4a/TransTractor.pm:108
 msgid "Push a new line to the end of C<< {$self->{TT}{doc_out}} >>."
 msgstr ""
 
 #. type: =item
-#: lib/Locale/Po4a/TransTractor.pm:108
+#: lib/Locale/Po4a/TransTractor.pm:109
 msgid "popline()"
 msgstr ""
 
 #. type: textblock
-#: lib/Locale/Po4a/TransTractor.pm:109
+#: lib/Locale/Po4a/TransTractor.pm:110
 msgid "Pop the last pushed line from the end of C<< {$self->{TT}{doc_out}} >>."
 msgstr ""
 
 #. type: =head2
-#: lib/Locale/Po4a/TransTractor.pm:110
+#: lib/Locale/Po4a/TransTractor.pm:111
 msgid "Marking strings as translatable"
 msgstr ""
 
 #. type: textblock
-#: lib/Locale/Po4a/TransTractor.pm:111
+#: lib/Locale/Po4a/TransTractor.pm:112
 msgid "One function is provided to handle the text which should be translated."
 msgstr ""
 
 #. type: =item
-#: lib/Locale/Po4a/TransTractor.pm:112
+#: lib/Locale/Po4a/TransTractor.pm:113
 msgid "translate($$$)"
 msgstr ""
 
 #. type: textblock
-#: lib/Locale/Po4a/TransTractor.pm:113
+#: lib/Locale/Po4a/TransTractor.pm:114
 msgid "Mandatory arguments:"
 msgstr ""
 
 #. type: textblock
-#: lib/Locale/Po4a/TransTractor.pm:115
+#: lib/Locale/Po4a/TransTractor.pm:116
 msgid "A string to translate"
 msgstr ""
 
 #. type: textblock
-#: lib/Locale/Po4a/TransTractor.pm:117
+#: lib/Locale/Po4a/TransTractor.pm:118
 msgid "The reference of this string (i.e. position in inputfile)"
 msgstr ""
 
 #. type: textblock
-#: lib/Locale/Po4a/TransTractor.pm:119
+#: lib/Locale/Po4a/TransTractor.pm:120
 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)|"
@@ -8616,14 +8626,14 @@ msgid ""
 msgstr ""
 
 #. type: textblock
-#: lib/Locale/Po4a/TransTractor.pm:120
+#: lib/Locale/Po4a/TransTractor.pm:121
 msgid ""
 "This function can also take some extra arguments. They must be organized as "
 "a hash. For example:"
 msgstr ""
 
 #. type: verbatim
-#: lib/Locale/Po4a/TransTractor.pm:121
+#: lib/Locale/Po4a/TransTractor.pm:122
 #, no-wrap
 msgid ""
 "  $self->translate(\"string\",\"ref\",\"type\",\n"
@@ -8632,7 +8642,7 @@ msgid ""
 msgstr ""
 
 #. type: textblock
-#: lib/Locale/Po4a/TransTractor.pm:123
+#: lib/Locale/Po4a/TransTractor.pm:124
 msgid ""
 "boolean indicating whether we can consider that whitespaces in string are "
 "not important. If yes, the function canonizes the string before looking for "
@@ -8640,92 +8650,92 @@ msgid ""
 msgstr ""
 
 #. type: textblock
-#: lib/Locale/Po4a/TransTractor.pm:125
+#: lib/Locale/Po4a/TransTractor.pm:126
 msgid ""
 "the column at which we should wrap (default: the value of B<wrapcol> "
 "specified during creation of the TransTractor or 76)."
 msgstr ""
 
 #. type: textblock
-#: lib/Locale/Po4a/TransTractor.pm:126
+#: lib/Locale/Po4a/TransTractor.pm:127
 msgid "The negative value will be substracted from the default."
 msgstr ""
 
 #. type: textblock
-#: lib/Locale/Po4a/TransTractor.pm:128
+#: lib/Locale/Po4a/TransTractor.pm:129
 msgid "an extra comment to add to the entry."
 msgstr ""
 
 #. type: textblock
-#: lib/Locale/Po4a/TransTractor.pm:129
+#: lib/Locale/Po4a/TransTractor.pm:130
 msgid "Actions:"
 msgstr ""
 
 #. type: textblock
-#: lib/Locale/Po4a/TransTractor.pm:131
+#: lib/Locale/Po4a/TransTractor.pm:132
 msgid "Pushes the string, reference and type to po_out."
 msgstr ""
 
 #. type: textblock
-#: lib/Locale/Po4a/TransTractor.pm:133
+#: lib/Locale/Po4a/TransTractor.pm:134
 msgid ""
 "Returns the translation of the string (as found in po_in) so that the parser "
 "can build the doc_out."
 msgstr ""
 
 #. type: textblock
-#: lib/Locale/Po4a/TransTractor.pm:135
+#: lib/Locale/Po4a/TransTractor.pm:136
 msgid ""
 "Handles the charsets to recode the strings before sending them to po_out and "
 "before returning the translations."
 msgstr ""
 
 #. type: =head2
-#: lib/Locale/Po4a/TransTractor.pm:136
+#: lib/Locale/Po4a/TransTractor.pm:137
 msgid "Misc functions"
 msgstr ""
 
 #. type: =item
-#: lib/Locale/Po4a/TransTractor.pm:137
+#: lib/Locale/Po4a/TransTractor.pm:138
 msgid "verbose()"
 msgstr ""
 
 #. type: textblock
-#: lib/Locale/Po4a/TransTractor.pm:138
+#: lib/Locale/Po4a/TransTractor.pm:139
 msgid ""
 "Returns if the verbose option was passed during the creation of the "
 "TransTractor."
 msgstr ""
 
 #. type: =item
-#: lib/Locale/Po4a/TransTractor.pm:139
+#: lib/Locale/Po4a/TransTractor.pm:140
 msgid "debug()"
 msgstr ""
 
 #. type: textblock
-#: lib/Locale/Po4a/TransTractor.pm:140
+#: lib/Locale/Po4a/TransTractor.pm:141
 msgid ""
 "Returns if the debug option was passed during the creation of the "
 "TransTractor."
 msgstr ""
 
 #. type: =item
-#: lib/Locale/Po4a/TransTractor.pm:141
+#: lib/Locale/Po4a/TransTractor.pm:142
 msgid "get_in_charset()"
 msgstr ""
 
 #. type: textblock
-#: lib/Locale/Po4a/TransTractor.pm:142
+#: lib/Locale/Po4a/TransTractor.pm:143
 msgid "This function return the charset that was provided as master charset"
 msgstr ""
 
 #. type: =item
-#: lib/Locale/Po4a/TransTractor.pm:143
+#: lib/Locale/Po4a/TransTractor.pm:144
 msgid "get_out_charset()"
 msgstr ""
 
 #. type: textblock
-#: lib/Locale/Po4a/TransTractor.pm:144
+#: lib/Locale/Po4a/TransTractor.pm:145
 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 "
@@ -8733,7 +8743,7 @@ msgid ""
 msgstr ""
 
 #. type: textblock
-#: lib/Locale/Po4a/TransTractor.pm:145
+#: lib/Locale/Po4a/TransTractor.pm:146
 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 "
@@ -8742,12 +8752,12 @@ msgid ""
 msgstr ""
 
 #. type: =head1
-#: lib/Locale/Po4a/TransTractor.pm:146
+#: lib/Locale/Po4a/TransTractor.pm:147
 msgid "FUTURE DIRECTIONS"
 msgstr ""
 
 #. type: textblock
-#: lib/Locale/Po4a/TransTractor.pm:147
+#: lib/Locale/Po4a/TransTractor.pm:148
 msgid ""
 "One shortcoming of the current TransTractor is that it can't handle "
 "translated document containing all languages, like debconf templates, or ."
@@ -8755,29 +8765,29 @@ msgid ""
 msgstr ""
 
 #. type: textblock
-#: lib/Locale/Po4a/TransTractor.pm:148
+#: lib/Locale/Po4a/TransTractor.pm:149
 msgid "To address this problem, the only interface changes needed are:"
 msgstr ""
 
 #. type: textblock
-#: lib/Locale/Po4a/TransTractor.pm:150
+#: lib/Locale/Po4a/TransTractor.pm:151
 msgid "take a hash as po_in_name (a list per language)"
 msgstr ""
 
 #. type: textblock
-#: lib/Locale/Po4a/TransTractor.pm:152
+#: lib/Locale/Po4a/TransTractor.pm:153
 msgid "add an argument to translate to indicate the target language"
 msgstr ""
 
 #. type: textblock
-#: lib/Locale/Po4a/TransTractor.pm:154
+#: lib/Locale/Po4a/TransTractor.pm:155
 msgid ""
 "make a pushline_all function, which would make pushline of its content for "
 "all languages, using a map-like syntax:"
 msgstr ""
 
 #. type: verbatim
-#: lib/Locale/Po4a/TransTractor.pm:155
+#: lib/Locale/Po4a/TransTractor.pm:156
 #, no-wrap
 msgid ""
 "    $self->pushline_all({ \"Description[\".$langcode.\"]=\".\n"
@@ -8787,12 +8797,12 @@ msgid ""
 msgstr ""
 
 #. type: textblock
-#: lib/Locale/Po4a/TransTractor.pm:156
+#: lib/Locale/Po4a/TransTractor.pm:157
 msgid "Will see if it's enough ;)"
 msgstr ""
 
 #. type: verbatim
-#: lib/Locale/Po4a/TransTractor.pm:158
+#: lib/Locale/Po4a/TransTractor.pm:159
 #, no-wrap
 msgid ""
 " Denis Barbier <barbier@linuxfr.org>\n"