@@ -11,7 +11,7 @@ msgid ""
1111msgstr ""
1212"Project-Id-Version : Python 3.14\n "
1313"Report-Msgid-Bugs-To : \n "
14- "POT-Creation-Date : 2026-05-08 19:31 +0000\n "
14+ "POT-Creation-Date : 2026-05-17 15:44 +0000\n "
1515"PO-Revision-Date : 2026-05-08 17:17+0000\n "
1616"Last-Translator : Rafael Fontenelle <rffontenelle@gmail.com>, 2026\n "
1717"Language-Team : Polish (https://app.transifex.com/python-doc/teams/5390/pl/)\n "
@@ -33,8 +33,9 @@ msgid ""
3333"This module provides functions for encoding binary data to printable ASCII "
3434"characters and decoding such encodings back to binary data. This includes "
3535"the :ref:`encodings specified in <base64-rfc-4648>` :rfc:`4648` (Base64, "
36- "Base32 and Base16) and the non-standard :ref:`Base85 encodings <base64-"
37- "base-85>`."
36+ "Base32 and Base16), the :ref:`Base85 encoding <base64-base-85>` specified in "
37+ "`PDF 2.0 <https://pdfa.org/resource/iso-32000-2/>`_, and non-standard "
38+ "variants of Base85 used elsewhere."
3839msgstr ""
3940
4041msgid ""
@@ -209,31 +210,42 @@ msgid "Base85 Encodings"
209210msgstr ""
210211
211212msgid ""
212- "Base85 encoding is not formally specified but rather a de facto standard, "
213- "thus different systems perform the encoding differently."
213+ "Base85 encoding is a family of algorithms which represent four bytes using "
214+ "five ASCII characters. Originally implemented in the Unix ``btoa(1)`` "
215+ "utility, a version of it was later adopted by Adobe in the PostScript "
216+ "language and is standardized in PDF 2.0 (ISO 32000-2). This version, in both "
217+ "its ``btoa`` and PDF variants, is implemented by :func:`a85encode`."
214218msgstr ""
215219
216220msgid ""
217- "The :func:`a85encode` and :func:`b85encode` functions in this module are two "
218- "implementations of the de facto standard. You should call the function with "
219- "the Base85 implementation used by the software you intend to work with ."
221+ "A separate version, using a different output character set, was defined as "
222+ "an April Fool's joke in :rfc:`1924` but is now used by Git and other "
223+ "software. This version is implemented by :func:`b85encode` ."
220224msgstr ""
221225
222226msgid ""
223- "The two functions present in this module differ in how they handle the "
224- "following:"
227+ "Finally, a third version, using yet another output character set designed "
228+ "for safe inclusion in programming language strings, is defined by ZeroMQ and "
229+ "implemented here by :func:`z85encode`."
225230msgstr ""
226231
227- msgid "Whether to include enclosing ``<~`` and ``~>`` markers"
232+ msgid ""
233+ "The functions present in this module differ in how they handle the following:"
234+ msgstr ""
235+
236+ msgid "Whether to include and expect enclosing ``<~`` and ``~>`` markers."
228237msgstr ""
229238
230- msgid "Whether to include newline characters "
239+ msgid "Whether to fold the input into multiple lines. "
231240msgstr ""
232241
233- msgid "The set of ASCII characters used for encoding"
242+ msgid "The set of ASCII characters used for encoding. "
234243msgstr ""
235244
236- msgid "Handling of null bytes"
245+ msgid "Compact encodings of sequences of spaces and null bytes."
246+ msgstr ""
247+
248+ msgid "The encoding of zero-padding bytes applied to the input."
237249msgstr ""
238250
239251msgid ""
@@ -248,7 +260,7 @@ msgstr ""
248260msgid ""
249261"*foldspaces* is an optional flag that uses the special short sequence 'y' "
250262"instead of 4 consecutive spaces (ASCII 0x20) as supported by 'btoa'. This "
251- "feature is not supported by the \" standard\" Ascii85 encoding."
263+ "feature is not supported by the standard encoding used in PDF ."
252264msgstr ""
253265
254266msgid ""
@@ -258,13 +270,17 @@ msgid ""
258270msgstr ""
259271
260272msgid ""
261- "*pad* controls whether the input is padded to a multiple of 4 before "
262- "encoding. Note that the ``btoa`` implementation always pads."
273+ "*pad* controls whether zero-padding applied to the end of the input is fully "
274+ "retained in the output encoding, as done by ``btoa``, producing an exact "
275+ "multiple of 5 bytes of output. This is not part of the standard encoding "
276+ "used in PDF, as it does not preserve the length of the data."
263277msgstr ""
264278
265279msgid ""
266280"*adobe* controls whether the encoded byte sequence is framed with ``<~`` and "
267- "``~>``, which is used by the Adobe implementation."
281+ "``~>``, as in a PostScript base-85 string literal. Note that while "
282+ "ASCII85Decode streams in PDF documents *must* be terminated with ``~>``, "
283+ "they *must not* use a leading ``<~``."
268284msgstr ""
269285
270286msgid ""
@@ -275,12 +291,13 @@ msgstr ""
275291msgid ""
276292"*foldspaces* is a flag that specifies whether the 'y' short sequence should "
277293"be accepted as shorthand for 4 consecutive spaces (ASCII 0x20). This feature "
278- "is not supported by the \" standard\" Ascii85 encoding."
294+ "is not supported by the standard Ascii85 encoding used in PDF and PostScript ."
279295msgstr ""
280296
281297msgid ""
282- "*adobe* controls whether the input sequence is in Adobe Ascii85 format (i.e. "
283- "is framed with <~ and ~>)."
298+ "*adobe* controls whether the ``<~`` and ``~>`` markers are present. While "
299+ "the leading ``<~`` is not required, the input must end with ``~>``, or a :"
300+ "exc:`ValueError` is raised."
284301msgstr ""
285302
286303msgid ""
@@ -295,26 +312,32 @@ msgid ""
295312msgstr ""
296313
297314msgid ""
298- "If *pad* is true, the input is padded with ``b'\\ 0'`` so its length is a "
299- "multiple of 4 bytes before encoding."
315+ "The input is padded with ``b'\\ 0'`` so its length is a multiple of 4 bytes "
316+ "before encoding. If *pad* is true, all the resulting characters are "
317+ "retained in the output, which will always be a multiple of 5 bytes, and thus "
318+ "the length of the data may not be preserved on decoding."
300319msgstr ""
301320
302321msgid ""
303322"Decode the base85-encoded :term:`bytes-like object` or ASCII string *b* and "
304- "return the decoded :class:`bytes`. Padding is implicitly removed, if "
305- "necessary."
323+ "return the decoded :class:`bytes`."
306324msgstr ""
307325
308326msgid ""
309327"Encode the :term:`bytes-like object` *s* using Z85 (as used in ZeroMQ) and "
310- "return the encoded :class:`bytes`. See `Z85 specification <https://rfc."
311- "zeromq.org/spec/32/>`_ for more information."
328+ "return the encoded :class:`bytes`."
329+ msgstr ""
330+
331+ msgid ""
332+ "The `ZeroMQ specification <https://rfc.zeromq.org/spec/32/>`_ requires the "
333+ "length of Z85-encoded data to be a multiple of 5 bytes. To produce compliant "
334+ "data frames, you must pad the input data to this function to a multiple of 4 "
335+ "bytes."
312336msgstr ""
313337
314338msgid ""
315339"Decode the Z85-encoded :term:`bytes-like object` or ASCII string *s* and "
316- "return the decoded :class:`bytes`. See `Z85 specification <https://rfc."
317- "zeromq.org/spec/32/>`_ for more information."
340+ "return the decoded :class:`bytes`."
318341msgstr ""
319342
320343msgid "Legacy Interface"
@@ -382,6 +405,25 @@ msgstr ""
382405"Sekcja 5.2, \" Base64 Treść-Transfer-Kodowanie,\" dostarcza definicji "
383406"kodowania base64."
384407
408+ msgid ""
409+ "`ISO 32000-2 Portable document format - Part 2: PDF 2.0 <https://pdfa.org/"
410+ "resource/iso-32000-2/>`_"
411+ msgstr ""
412+
413+ msgid ""
414+ "Section 7.4.3, \" ASCII85Decode Filter,\" provides the definition of the "
415+ "Ascii85 encoding used in PDF and PostScript, including the output character "
416+ "set and the details of data length preservation using zero-padding and "
417+ "partial output groups."
418+ msgstr ""
419+
420+ msgid "`ZeroMQ RFC 32/Z85 <https://rfc.zeromq.org/spec/32/>`_"
421+ msgstr ""
422+
423+ msgid ""
424+ "The \" Formal Specification\" section provides the character set used in Z85."
425+ msgstr ""
426+
385427msgid "base64"
386428msgstr ""
387429
0 commit comments