po4a 0.41 - en to pl translation catalogue (652 entries)

note: type: Attribute 'xml:lang' of: <refentry>
en: en
pl: pl

note: type: Content of: <refentry><refmeta><refmiscinfo>
en: Po4a Tools
pl: Narzędzia po4a

note: type: Content of: <refentry><refnamediv><refpurpose>
en: display a translated man page according to a PO
pl: wyświetla przetłumaczoną stronę podręcznika zgodnie z plikiem PO

note: type: =head1
en: DESCRIPTION
pl: OPIS

note: type: =head1
en: OPTIONS
pl: OPCJE

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
en: <option>-p </option><replaceable>PO_FILE</replaceable>
pl: <option>-p </option><replaceable>PLIK_PO</replaceable>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The PO file containing the translations.
pl: Plik PO zawierający tłumaczenia.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
en: <option>-m </option><replaceable>MASTER_FILE</replaceable>
pl: <option>-m </option><replaceable>PLIK_GŁÓWNY</replaceable>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
en: <option>-o </option><replaceable>PO4A_OPT</replaceable>
pl: <option>-o </option><replaceable>OPCJA_PO4A</replaceable>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Some options to pass to <citerefentry><refentrytitle>po4a-translate</refentrytitle><manvolnum>1</manvolnum></citerefentry>.
pl: Opcje przekazywane do <citerefentry><refentrytitle>po4a-translate</refentrytitle><manvolnum>1</manvolnum></citerefentry>.

note: type: =head1
en: SEE ALSO
pl: ZOBACZ TAKŻE

note: type: Content of: <refentry><refsect1><title>
en: AUTHOR
pl: AUTOR

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
en: <option>-m </option><replaceable>POD_FILE</replaceable>
pl: <option>-m </option><replaceable>PLIK_POD</replaceable>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The original POD file used by po4a to generate PO file.
pl: Oryginalny plik POD, na podstawie którego po4a generuje plik PO.

note: type: =head1
en: NAME
pl: NAZWA

note: type: textblock
en: po4a - update both the PO files and translated documents in one shot
pl: po4a - aktualizowanie w jednym przebiegu zarówno plików PO, jak i przetłumaczonych dokumentów

note: type: =head1
en: SYNOPSIS
pl: SKŁADNIA

note: type: textblock
en: B<po4a> [I<options>] I<config_file>
pl: B<po4a> [I<opcje>] I<plik_konfiguracyjny>

note: type: textblock
en: Show a short help message.
pl: Pokazuje krótki komunikat pomocy.

note: type: textblock
en: Charset of the addenda. Note that all the addenda should be in the same charset.
pl: Kodowanie znaków załącznika. Proszę zauważyć, że wszystkie załączniki powinny mieć to samo kodowanie znaków.

note: type: textblock
en: Display the version of the script and exit.
pl: Wyświetla wersję skryptu i kończy działanie.

note: type: textblock
en: Increase the verbosity of the program.
pl: Zwiększa gadatliwość programu.

note: type: textblock
en: Decrease the verbosity of the program.
pl: Zmniejsza gadatliwość programu.

note: type: textblock
en: Output some debugging information.
pl: Wypisuje informacje przydatne do debugowania.

note: type: textblock
en: Always generate the POT and PO files, even if B<po4a> considers it is not necessary.
pl: Zawsze generuje pliki POT i PO, nawet jeżeli B<po4a> uważa to za niepotrzebne.

note: type: textblock
en: The default behavior (when B<--force> is not specified) is the following:
pl: Domyślne zachowanie (jeśli nie podano B<--force>) jest następujące:

note: type: textblock
en: 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>).
pl: Ponadto tłumaczenie zostanie ponownie wygenerowane, jeżeli oryginalny dokument, plik PO, jeden z załączników lub plik konfiguracyjny są od niego nowsze. Aby uniknąć prób ponownego generowania tłumaczeń, które są poniżej zdefiniowanego progu (patrz B<--keep>), można utworzyć plik z rozszerzeniem  F<.po4a-stamp> (patrz B<--stamp>).

note: type: textblock
en: 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.
pl: Jeśli jakieś pliki są włączane (include) do oryginalnego dokumentu, należy użyć flagi B<--force>, ponieważ czasy modyfikacji włączanych plików nie są brane pod uwagę.

note: type: textblock
en: The PO files are always re-generated based on the POT with B<msgmerge -U>.
pl: Pliki PO są zawsze ponownie generowane na podstawie plików POT za pomocą B<msgmerge -U>.

note: type: textblock
en: 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.
pl: Nakazuje programowi B<po4a> tworzenie plików ze znacznikiem czasowym, jeżeli tłumaczenie nie zostanie wygenerowane z powodu nieprzekroczenia zdefiniowanego progu. Pliki znaczników mają nazwę taką jak oczekiwany przetłumaczony dokument z dodanym rozszerzeniem F<.po4a-stamp>.

note: type: textblock
en: 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.
pl: Uwaga: Ta opcja aktywuje tworzenie plików F<.po4a-stamp>. Pliki znaczników, jeżeli tylko istnieją, to są zawsze używane. Pliki te są usuwane za pomocą B<--rm-translations>, albo gdy plik zostanie w końcu przetłumaczony.

note: type: textblock
en: Do not generate the translated documents, only update the POT and PO files.
pl: Nie generuje przetłumaczonych dokumentów, aktualizuje tylko pliki POT i PO.

note: type: textblock
en: Remove the translated files (implies B<--no-translations>).
pl: Usuwa przetłumaczone pliki (wymusza B<--no-translations>).

note: type: textblock
en: This flag does nothing since 0.41, and may be removed in later releases.
pl: Od wersji 0.41 ta flaga nic nie robi i może zostać usunięta w kolejnych wersjach.

note: type: =item
en: B<--translate-only> I<translated-file>
pl: B<--translate-only> I<plik_przetłumaczony>

note: type: textblock
en: 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.
pl: Tłumaczy tylko podany plik. Może być to użyteczne do przyspieszenia przetwarzania, gdy plik konfiguracyjny zawiera odwołania do wielu plików. Proszę zauważyć, że ta opcja nie aktualizuje plików PO i POT. Można tej opcji użyć wiele razy.

note: type: =item
en: B<--variable> I<var>B<=>I<value>
pl: B<--variable> I<zmienna>B<=>I<wartość>

note: type: textblock
en: 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.
pl: Definiuje zmienną, która będzie rozwinięta w pliku konfiguracyjnym B<po4a>. Każde użycie I<$(zmienna)> zostanie zastąpione przez I<wartość>. Tę opcję można podać wielokrotnie.

note: type: =item
en: B<--srcdir> I<SRCDIR>
pl: B<--srcdir> I<KATALOG_ŹRÓDŁOWY>

note: type: =item
en: B<--destdir> I<DESTDIR>
pl: B<--destdir> I<KATALOG_DOCELOWY>

note: type: =item
en: B<--msgid-bugs-address> I<email@address>
pl: B<--msgid-bugs-address> I<adres@e-mail>

note: type: textblock
en: Set the report address for msgid bugs. By default, the created POT files have no Report-Msgid-Bugs-To fields.
pl: Ustawia adres, pod który należy zgłaszać błędy w polach msgid. Domyślnie, utworzone pliki POT nie zawierają nagłówków Report-Msgid-Bugs-To.

note: type: textblock
en: Set the copyright holder in the POT header. The default value is "Free Software Foundation, Inc."
pl: Ustawia właściciela praw autorskich w nagłówku POT. Domyślną wartością jest "Free Software Foundation, Inc."

note: type: =item
en: B<--package-name> I<string>
pl: B<--package-name> I<nazwa>

note: type: textblock
en: Set the package name for the POT header. The default is "PACKAGE".
pl: Ustawia nazwę pakietu w nagłówku POT. Domyślną wartością jest "PACKAGE".

note: type: =item
en: B<--package-version> I<string>
pl: B<--package-version> I<wersja>

note: type: textblock
en: Set the package version for the POT header. The default is "VERSION".
pl: Ustawia wersję pakietu w nagłówku pliku POT. Domyślną wartością jest "VERSION".

note: type: textblock
en: Extra options for B<msgmerge>(1).
pl: Dodatkowe opcje przekazywane programowi B<msgmerge>(1).

note: type: textblock
en: Note: B<$lang> will be extended to the current language.
pl: Uwaga: B<$lang> zostanie zastąpione nazwą bieżącego języka.

note: type: textblock
en: 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.
pl: Opcja dodaje B<--previous> do opcji przekazywanych programowi B<msgmerge>. Wymaga wersji 0.16 lub późniejszej pakietu B<gettext> i jest domyślnie włączona.

note: type: =head2
en: Specifying the documents to translate
pl: Określanie dokumentów do przetłumaczenia

note: type: textblock
en: Include I<addendum_path> if this file does exist, otherwise do nothing.
pl: Włącza plik I<ścieżka_do_załącznika>, jeśli taki plik istnieje. W przeciwnym wypadku nic nie robi.

note: type: textblock
en: 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.
pl: I<ścieżka_do_załącznika> nie jest zwykłym załącznikiem, ale plikiem zawierającym listę załączników, po jednym w każdej linii. Każdy załącznik może być poprzedzony modyfikatorem.

note: type: textblock
en: I<addendum_path> is discarded, it is not loaded and will not be loaded by any further addendum specification.
pl: Plik I<ścieżka_do_załącznika> jest całkowicie ignorowany - nie jest ładowany i nie będzie, nawet jeśli pojawia się w późniejszych specyfikacjach załączników.

note: type: =head1
en: AUTHORS
pl: AUTORZY

note: type: =head1
en: COPYRIGHT AND LICENSE
pl: PRAWA AUTORSKIE I LICENCJA

note: type: textblock
en: This program is free software; you may redistribute it and/or modify it under the terms of GPL (see the COPYING file).
pl: Program jest wolnym oprogramowaniem; można go redystrybuować i/lub modyfikować zgodnie z warunkami licencji GPL (patrz plik COPYING).

note: type: textblock
en: po4a-gettextize - convert an original file (and its translation) to a PO file
pl: po4a-gettextize - konwertuje oryginalny plik (i jego tłumaczenie) do pliku PO

note: type: textblock
en: (I<XX.po> is the output, all others are inputs)
pl: (I<XX.po> jest plikiem wyjściowym, wszystkie pozostałe są plikami wejściowymi)

note: type: textblock
en: Format of the documentation you want to handle. Use the B<--help-format> option to see the list of available formats.
pl: Format dokumentacji, którą chce się obsłużyć. Listę dostępnych formatów można wyświetlić, podając opcję B<--help-format>.

note: type: textblock
en: File containing the master document to translate. You can use this option multiple times if you want to gettextize multiple documents.
pl: Plik zawierający główny dokument do przetłumaczenia. Można użyć tej opcji wielokrotnie, aby przekształcić wiele dokumentów do formatu gettext.

note: type: textblock
en: Charset of the file containing the document to translate.
pl: Kodowanie znaków pliku zawierającego dokument do przetłumaczenia.

note: type: textblock
en: 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.
pl: Plik zawierający dokument przetłumaczony. Jeżeli podano wiele głównych dokumentów, można podać również wiele dokumentów przetłumaczonych, używając tej opcji więcej niż raz.

note: type: textblock
en: Charset of the file containing the localized document.
pl: Kodowanie znaków pliku zawierającego przetłumaczony dokument.

note: type: textblock
en: File where the message catalog should be written. If not given, the message catalog will be written to the standard output.
pl: Plik, do którego powinien zostać zapisany katalog wiadomości. Jeżeli nie podano, to katalog wiadomości zostanie wypisany na standardowe wyjście.

note: type: textblock
en: List the documentation formats understood by po4a.
pl: Wyświetla listę formatów dokumentacji obsługiwanych przez po4a.

note: type: verbatim
en:     Original         Translation
pl:    Oryginał         Tłumaczenie

note: type: verbatim
en:   chapter            chapter
        paragraph          paragraph
        paragraph          paragraph
        paragraph        chapter
      chapter              paragraph
        paragraph          paragraph
pl:    rozdział          rozdział
          akapit            akapit
          akapit            akapit
          akapit         rozdział
       rozdział             akapit
          akapit            akapit

note: type: textblock
en: po4a-normalize - normalize a documentation file by parsing it in po4a, and writing it back
pl: po4a-normalize - normalizuje plik dokumentacji, przepuszczając go przez po4a i zapisując z powrotem

note: type: textblock
en: 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.
pl: Celem projektu po4a ("PO for anything") jest ułatwienie tłumaczeń (oraz, co ciekawsze, zarządzania tłumaczeniami) przy użyciu narzędzi gettext w tych obszarach, gdzie nie były używane, jak na przykład w obszarze dokumentacji.

note: type: textblock
en: 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.
pl: Skrypt B<po4a-normalize> jest narzędziem przydatnym do debugowania, używanym, aby mieć pewność, że po4a nie zmieni dokumentu tam, gdzie nie powinien go zmienić. Używaj tylko podczas tworzenia nowego modułu lub gdy masz wątpliwości, co do poprawności działania narzędzi po4a.

note: type: textblock
en: Create an blank translated document.  The generated translated document will be generated assuming all messages are translated by a space or new line.
pl: Tworzy pusty przetłumaczony dokument. Podczas generowania tłumaczenia zostanie przyjęte założenie, że wszystkie komunikaty są przetłumaczone na spację lub nową linię.

note: type: textblock
en: This is useful to check what parts of the document cannot be translated.
pl: Jest to przydatne do wykrywania części dokumentu, których nie można przetłumaczyć.

note: type: textblock
en: po4a-translate - convert a PO file back to documentation format
pl: po4a-translate - konwertuje plik PO z powrotem do formatu dokumentacji

note: type: textblock
en: (I<XX.doc> is the output, all others are inputs)
pl: (I<XX.doc> jest plikiem wyjściowym, wszystkie pozostałe są plikami wejściowymi)

note: type: textblock
en: 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)>.
pl: Skrypt B<po4a-translate> odpowiada za konwertowanie tłumaczeń (dokonanych w pliku PO) z powrotem do formatu dokumentacji. Przekazany plik PO powinien być tłumaczeniem pliku POT utworzonego przez L<po4a-gettextize(1)>.

note: type: textblock
en: 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)>).
pl: Dodaje załącznik do pliku wynikowego (na przykład, aby umieścić nazwisko tłumacza albo sekcję "O tłumaczeniu"). Pierwszą linią tego pliku powinien być nagłówek PO4A, określający, gdzie zawartość powinna być dodana (patrz sekcja B<JAK umieścić dodatkowy tekst w tłumaczeniach> w L<po4a(7)>).

note: type: textblock
en: File containing the master document to translate.
pl: Plik zawierający dokument do przetłumaczenia.

note: type: textblock
en: File where the localized (translated) document should be written.
pl: Plik, do którego powinien być zapisany przetłumaczony dokument.

note: type: textblock
en: File from which the message catalog should be read.
pl: Plik, z którego powinien być odczytany katalog wiadomości.

note: type: textblock
en: 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.
pl: Minimalny procentowy próg tłumaczeń pozwalający zachować (tj. zapisać) plik wynikowy (domyślnie: 80). Czyli, domyślnie, aby pliki zostały zapisane, muszą być przetłumaczone co najmniej w 80%.

note: type: textblock
en: Column at which we should wrap the resulting file.
pl: Kolumna, wg której powinien być zawijany plik wynikowy.

note: type: =head1
en: Adding content (beside translations) to generated files
pl: Dodawanie zawartości (poza tłumaczeniami) do generowanych plików

note: type: textblock
en: 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.
pl: Aby w wygenerowanym dokumencie umieścić dodatkową zawartość, niebędącą tłumaczeniem oryginału (np. nazwisko tłumacza lub rozdział "O tłumaczeniu"), należy użyć opcji B<--addendum>.

note: type: textblock
en: 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.
pl: Pierwsza linia załącznika musi zawierać nagłówek, wskazujący, gdzie umieścić resztę załącznika w dokumencie (może to być przed podaną częścią dokumentu lub za nią). Reszta pliku załącznika będzie dodana niezmieniona do pliku wynikowego.

note: type: textblock
en: 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).
pl: Proszę zauważyć, że jeżeli po4a-translate zwróci błąd podczas dodawania któregokolwiek z podanych załączników, odrzuci całe tłumaczenie (ponieważ brakującym plikiem może być ten, który wskazuje na autora, co uniemożliwi użytkownikom skontaktowanie się z nim i zgłoszenie błędów w tłumaczeniu).

note: type: textblock
en: 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.
pl: Składnia nagłówka jest bardzo sztywna. Więcej informacji o tym, jak używać załączników i jak działają, można znaleźć w stronie podręcznika L<po4a(7)>.

note: type: textblock
en: po4a-updatepo - update the translation (in PO format) of documentation
pl: po4a-updatepo - aktualizuje tłumaczenie dokumentacji (w formacie PO)

note: type: textblock
en: (I<XX.po> are the outputs, all others are inputs)
pl: (I<XX.po> to pliki wyjściowe, wszystkie pozostałe są plikami wejściowymi)

note: type: textblock
en: 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.
pl: Skrypt B<po4a-updatepo> jest odpowiedzialny za aktualizowanie plików PO, tak aby odzwierciedlały zmiany dokonane w oryginalnym pliku dokumentacji. W tym celu konwertuje plik dokumentacji do pliku POT i wywołuje L<msgmerge(1)> na tym nowym pliku POT i dostarczonych plikach PO.

note: type: textblock
en: 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).
pl: Jest możliwe podanie więcej niż jednego pliku PO (jeśli chce się od razu zaktualizować kilka języków) i kilku plików z dokumentacją (jeśli chce się przechowywać tłumaczenia kilku dokumentów w tym samym pliku PO).

note: type: textblock
en: File(s) containing the master document to translate.
pl: Plik(i) zawierający(e) dokument(y) do przetłumaczenia.

note: type: textblock
en: Charset of the files containing the document to translate. Note that all files must have the same charset.
pl: Kodowanie znaków plików zawierających dokumenty do przetłumaczenia. Proszę zauważyć, że wszystkie pliki muszą mieć to samo kodowanie znaków.

note: type: textblock
en: PO file(s) to update. If these files do not exist, they are created by B<po4a-updatepo>.
pl: Plik(i) PO do zaktualizowania. Jeśli nie istnieją, to zostaną utworzone przez B<po4a-updatepo>.

note: type: textblock
en: msguntypot - update PO files when a typo is fixed in POT file
pl: msguntypot - aktualizuje pliki PO, jeżeli w pliku POT poprawiono literówki

note: type: textblock
en: B<msguntypot> B<-o> I<old_pot> B<-n> I<new_pot> I<pofiles> ...
pl: B<msguntypot> B<-o> I<stary_pot> B<-n> I<nowy_pot> I<pliki_po> ...

note: type: textblock
en: 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.
pl: Jeżeli w pliku POT poprawiony zostanie banalny błąd, który na pewno nie ma wpływu na tłumaczenia (np. literówka), to powinno się usunąć znaczniki "fuzzy" w odpowiadających wpisach msgstr przetłumaczonych plików PO, aby oszczędzić tłumaczom dodatkowej pracy.

note: type: textblock
en: 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.
pl: Wykonanie tego zadania ręcznie jest trudne i podatne na błędy. To narzędzie pomaga poprawnie go wykonać. Należy podać dwie wersje pliku POT: przed zmianami i po nich, tak jak to podano w powyższej sekcji "SKŁADNIA", i wszystko wykona się automatycznie.

note: type: =head1
en: HOW TO USE IT
pl: JAK TEGO UŻYWAĆ

note: type: textblock
en: In short, when you discover a typo in one of your [english] message, do the following:
pl: W skrócie, po odkryciu literówki w [angielskim] komunikacie, wykonaj następujące czynności:

note: type: =item
en: - Regenerate your POT and PO files.
pl: - Ponownie wygeneruj pliki POT i PO.

note: type: verbatim
en:   make -C po/ update-po # for message program translations
      debconf-updatepo      # for debconf translations
      po4a po4a.conf        # for po4a based documentation translations
pl:   make -C po/ update-po # dla tłumaczeń komunikatów programów
      debconf-updatepo      # dla tłumaczeń szablonów debconfa
      po4a po4a.conf        # dla tłumaczeń opartych na po4a

note: type: textblock
en: 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??
pl: albo w inny sposób, w zależności od ustawień budowania Twojego projektu. Przecież wiesz najlepiej, jak zaktualizować pliki POT i PO, nieprawdaż?

note: type: =item
en: - Make a copy of your POT file.
pl: - Stwórz kopię pliku POT.

note: type: verbatim
en:   cp myfile.pot myfile.pot.orig
pl:   cp mój_plik.pot mój_plik.pot.orig

note: type: =item
en: - Make a copy of all your PO files.
pl: - Stwórz kopie wszystkich plików PO.

note: type: verbatim
en:   mkdir po_fridge; cp *.po po_fridge
pl:   mkdir po_kopia; cp *.po po_kopia

note: type: =item
en: - Fix your typo.
pl: - Popraw literówkę.

note: type: textblock
en: $EDITOR the_file_in_which_there_is_a_typo
pl: $EDITOR plik_w_którym_jest_literówka

note: type: textblock
en: See above.
pl: Patrz wyżej.

note: type: textblock
en: 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.
pl: W tym momencie, poprawienie literówki spowodowało oznaczenie wszystkich tłumaczeń jako niepewne ("fuzzy") i jest to niestety jedyna różnica między plikami PO w głównym katalogu a plikami PO skopiowanymi wcześniej do innego katalogu. Poniżej objaśniono, jak ten problem rozwiązać.

note: type: =item
en: - Discard fuzzy translation, restore the ones from the fridge.
pl: - Wyrzuć niepewne tłumaczenia, zastępując je wcześniej zachowanymi tłumaczeniami.

note: type: verbatim
en:   cp po_fridge/*.po .
pl:   cp po_kopia/*.po .

note: type: =item
en: - Manually merge the PO files with the new POT file, but taking the useless fuzzy into account.
pl: - Ręcznie scal pliki PO z nowym plikiem POT, biorąc pod uwagę niepotrzebne znaczniki  "fuzzy".

note: type: verbatim
en:   msguntypot -o myfile.pot.orig -n myfile.pot *.po
pl:   msguntypot -o mój_plik.pot.orig -n mój_plik.pot *.po

note: type: =item
en: - Cleanups.
pl: - Porządki.

note: type: verbatim
en:   rm -rf myfile.pot.orig po_fridge
pl:   rm -rf mój_plik.pot.orig po_kopia

note: type: textblock
en: 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.
pl: I to wszystko. Literówka została wyeliminowana zarówno z plików POT, jak i PO, a tłumaczenia w plikach PO nie są zaznaczone jako niepewne. Tłumacze już Cię uwielbiają!

note: type: textblock
en: 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:
pl: Mimo swojej nazwy, to narzędzie nie jest częścią pakietu gettext. Jest częścią po4a. Mówiąc dokładniej, jest to przypadkowy skrypt w Perlu używający modułów po4a. Więcej informacji o po4a można znaleźć w:

note: type: verbatim
en:  Martin Quinson (mquinson#debian,org)
pl:  Martin Quinson (mquinson#debian.org)

note: type: textblock
en: po4a - framework to translate documentation and other materials
pl: po4a - narzędzia do tłumaczeń dokumentacji i innych materiałów

note: type: =head1
en: Introduction
pl: Wstęp

note: type: textblock
en: Please also see the B<FAQ> below in this document for a more complete list of the advantages and disadvantages of this approach.
pl: W sekcji B<FAQ> poniżej opisano kompletną listę plusów i minusów tego rozwiązania.

note: type: =head2
en: Supported formats
pl: Obsługiwane formaty

note: type: textblock
en: Currently, this approach has been successfully implemented to several kinds of text formatting formats:
pl: Obecnie rozwiązanie to zaimplementowano z sukcesem dla kilku formatów tekstu:

note: type: textblock
en: The XML format is a base format for many documentation formats.
pl: XML jest formatem bazowym wielu innych formatów dokumentacji.

note: type: =item
en: Unsupported formats
pl: Formaty niewspierane

note: type: verbatim
en:                                    master.doc
                                           |
                                           V
         +<-----<----+<-----<-----<--------+------->-------->-------+
         :           |                     |                        :
    {translation}    |         { update of master.doc }             :
         :           |                     |                        :
       XX.doc        |                     V                        V
     (optional)      |                 master.doc ->-------->------>+
         :           |                   (new)                      |
         V           V                     |                        |
      [po4a-gettextize]   doc.XX.po -->+   |                        |
              |            (old)       |   |                        |
              |              ^         V   V                        |
              |              |     [po4a-updatepo]                  |
              V              |           |                          V
       translation.pot       ^           V                          |
              |              |        doc.XX.po                     |
              |              |         (fuzzy)                      |
       { translation }       |           |                          |
              |              ^           V                          V
              |              |     {manual editing}                 |
              |              |           |                          |
              V              |           V                          V
          doc.XX.po --->---->+<---<-- doc.XX.po    addendum     master.doc
          (initial)                 (up-to-date)  (optional)   (up-to-date)
              :                          |            |             |
              :                          V            |             |
              +----->----->----->------> +            |             |
                                         |            |             |
                                         V            V             V
                                         +------>-----+------<------+
                                                      |
                                                      V
                                               [po4a-translate]
                                                      |
                                                      V
                                                    XX.doc
                                                 (up-to-date)
pl:                                    master.doc
                                           |
                                           V
         +<-----<----+<-----<-----<--------+------->-------->-------+
         :           |                     |                        :
    {tłumaczenie}    |            { aktualizacja master.doc }       :
         :           |                     |                        :
       XX.doc        |                     V                        V
    (nieobowiązkowy) |                  master.doc ------->-------->+
         :           |                   (nowy)                     |
         V           V                     |                        |
      [po4a-gettextize]   doc.XX.po -->+   |                        |
              |            (stary)     |   |                        |
              |              ^         V   V                        |
              |              |     [po4a-updatepo]                  |
              V              |           |                          V
      tłumaczenie.pot        ^           V                          |
              |              |         doc.XX.po                    |
              |              |         (fuzzy)                      |
       { tłumaczenie }       |           |                          |
              |              ^           V                          V
              |              |     {ręczna edycja}                  |
              |              |           |                          |
              V              |           V                          V
          doc.XX.po --->---->+<---<-- doc.XX.po    załącznik    master.doc
         (początkowy)                  (aktualny) (opcjonalny)  (aktualny)
              :                          |            |             |
              :                          V            |             |
              +----->----->----->------> +            |             |
                                         |            |             |
                                         V            V             V
                                         +------>-----+------<------+
                                                      |
                                                      V
                                               [po4a-translate]
                                                      |
                                                      V
                                                    XX.doc
                                                  (aktualny)

note: type: textblock
en: If you want to add something after the following nroff section:
pl: Aby dodać coś po następującej sekcji nroff:

note: type: verbatim
en:   .SH "AUTHORS"
pl:   .SH "AUTORZY"

note: type: verbatim
en:  PO4A-HEADER:mode=after;position=AUTHORS;beginboundary=\.SH
pl:  PO4A-HEADER:mode=after;position=AUTORZY;beginboundary=\.SH

note: type: textblock
en: 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.
pl: Aby dodać coś na końcu dokumentu, należy podać B<position> pasujące do jakiejkolwiek linii pliku (ale tylko jednej linii. Po4a nie przetworzy tego, jeśli linia nie będzie unikatowa) i podać B<endboundary> nie pasujące do niczego. Nie należy używać tutaj prostych tekstów jak B<"EOF">, tylko takich, które mają małe szanse pojawienia się w dokumencie.

note: type: verbatim
en:  PO4A-HEADER:mode=after;position=About this document;beginboundary=FakePo4aBoundary
pl:  PO4A-HEADER:mode=after;position=O dokumencie;beginboundary=NieistniejąaLiniaPo4a

note: type: =head3
en: More detailed example
pl: Bardziej szczegółowy przykład

note: type: textblock
en: Original document (POD formatted):
pl: Oryginalny dokument (w formacie POD):

note: type: verbatim
en:  |=head1 NAME
     |
     |dummy - a dummy program
     |
     |=head1 AUTHOR
     |
     |me
pl:  |=head1 NAZWA
     |
     |dummy - fikcyjny program
     |
     |=head1 AUTOR
     |
     |ja

note: type: textblock
en: 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").
pl: Wtedy następujący dodatek spowoduje dodanie sekcji (w języku francuskim) na koniec tego pliku (w jęz. francuskim "TRADUCTEUR" oznacza "TŁUMACZ", a "moi" znaczy "ja").

note: type: =head1
en: How does it work?
pl: Jak to działa?

note: type: textblock
en: 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.
pl: Ten rozdział zawiera krótki opis wewnętrznych mechanizmów po4a, tak że będziesz miał więcej odwagi, aby pomóc nam w jego tworzeniu i udoskonalaniu. Może także Ci pomóc w zrozumieniu, dlaczego nie działa tak, jak byś tego oczekiwał, oraz jak rozwiązać napotkane problemy.

note: type: textblock
en: 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:
pl: Bardziej formalnie mówiąc, pobiera dokument do przetłumaczenia oraz plik PO zawierający tłumaczenia używany jako wejście podczas tworzenia dwóch oddzielnych plików wyjściowych: innego pliku PO (wyniku wyodrębniania komunikatów z dokumentu wejściowego) oraz przetłumaczonego dokumentu (mającego taką samą strukturę jak plik wejściowy, ale ze wszystkimi komunikatami zamienionymi na zawartość wejściowego pliku PO). Poniżej jest graficzne przedstawienie tego procesu:

note: type: verbatim
en:    Input document --\                             /---> Output document
                         \      TransTractor::       /       (translated)
                          +-->--   parse()  --------+
                         /                           \
       Input PO --------/                             \---> Output PO
                                                             (extracted)
pl:    Dokument wejściowy -\                          /-> Dokument wyjściowy
                            \      TransTractor::    /    (przetłumaczony)
                             +-->--   parse()  --- -+
                            /                        \
       Wejściowy PO -------/                          \---> Wyjściowy PO
                                                            (wyodrębniony)

note: type: =head2
en: What about the other translation tools for documentation using gettext?
pl: Co z innymi narzędziami do tłumaczeń dokumentacji wykorzystującymi gettext?

note: type: textblock
en: 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.
pl: Jest to narzędzie rozwijane przez ludzi z KDE obsługujące format DocBook XML. O ile mi wiadomo, był to pierwszy program wyciągający łańcuchy znaków do przetłumaczenia z dokumentacji do plików PO i wstawiający je z powrotem po przetłumaczeniu.

note: type: textblock
en: 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.
pl: Może on obsługiwać tylko XML i częściowo DTD. Jestem bardzo niezadowolony z obsługi list, które zostają umieszczone w jednym wielkim msgid. Kiedy lista staje się długa, sprawa się komplikuje.

note: type: textblock
en: 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.
pl: Program utworzony przez Denisa Barbiera jest poprzednikiem modułu SGML po4a, który w mniejszym bądź większym stopniu go zastępuje, czyniąc przestarzałym. Zgodnie ze swą nazwą obsługuje tylko DebianDoc DTD, który jest DTD mniej lub bardziej przestarzałym.

note: type: textblock
en: 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.
pl: Największą zaletą po4a nad nimi jest łatwość umieszczania dodatkowej zawartości (co jest nawet gorsze tutaj) i przejścia na format gettext.

note: type: =head2
en: SUMMARY of the advantages of the gettext based approach
pl: PODSUMOWANIE plusów i minusów rozwiązania opartego na gettext

note: type: textblock
en: The translations are not stored along with the original, which makes it possible to detect if translations become out of date.
pl: Tłumaczenia nie są trzymane wraz z oryginałem, co pozwala w prosty sposób wykryć, czy tłumaczenia nie są przestarzałe.

note: type: textblock
en: 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.
pl: Tłumaczenia są przechowywane w oddzielnych plikach, dzięki czemu tłumacze różnych języków sobie nie przeszkadzają, zarówno kiedy podsyłają swoje tłumaczenia, jak i kiedy zmieniają kodowanie znaków pliku.

note: type: textblock
en: 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.
pl: Wewnętrznie jest oparty na pakiecie B<gettext> (ale B<po4a> oferuje bardzo prosty interfejs, tak że nie ma potrzeby poznawania wewnętrznych mechanizmów, aby go użyć). W ten sposób, nie musimy ponownie wymyślać koła, a ponieważ gettext jest szeroko używany, mamy nadzieję, że w większym lub mniejszym stopniu jest wolny od błędów.

note: type: textblock
en: Nothing changed for the end-user (beside the fact translations will hopefully be better maintained). The resulting documentation file distributed is exactly the same.
pl: Z punktu widzenia końcowego użytkownika nic się nie zmieniło (poza tym, że tłumaczenia są lepiej zarządzane). Wynikowe pliki z dokumentacją są tak samo dystrybuowane.

note: type: textblock
en: 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.
pl: Tłumacze nie muszą uczyć się składni nowego pliku i mogą po prostu użyć swojego ulubionego edytora plików PO (jak tryb PO Emasca, Lokalize lub Gtranslator).

note: type: textblock
en: 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:
pl: gettext udostępnia prosty sposób otrzymania statystyk o tym, co zostało zrobione, co powinno być przejrzane i zaktualizowane, a co jeszcze jest do zrobienia. Przykłady można znaleźć POD tymi adresami:

note: type: textblock
en: But everything isn't green, and this approach also has some disadvantages we have to deal with.
pl: Nie wszystko złoto, co się świeci - to podejście ma także kilka minusów, z którymi musimy sobie poradzić.

note: type: textblock
en: Addenda are… strange at the first glance.
pl: Na pierwszy rzut oka załączniki są… dziwne.

note: type: textblock
en: 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.
pl: Nie można dostosowywać tłumaczonego tekstu do własnych upodobań, na przykład przez podzielenie w danym miejscu na akapity, połączenie dwóch innych akapitów w jeden. Jednak w pewnym sensie, jeżeli jest jakiś problem z oryginałem, powinno to zostać zgłoszone jako błąd.

note: type: textblock
en: Even with an easy interface, it remains a new tool people have to learn.
pl: Nawet mając łatwy interfejs, wciąż pozostaje nowym narzędziem, którego trzeba się uczyć.

note: type: textblock
en: Locale::Po4a::AsciiDoc - convert AsciiDoc documents from/to PO files
pl: Locale::Po4a::AsciiDoc - konwersja dokumentów AsciiDoc z/do plików PO

note: type: =head1
en: OPTIONS ACCEPTED BY THIS MODULE
pl: OPCJE AKCEPTOWANE PRZEZ MODUŁ

note: type: textblock
en: These are this module's particular options:
pl: Opcje tego modułu:

note: type: textblock
en: 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.
pl: Nazwa pliku zawierającego definicje dla po4a, jak to zdefiniowano w sekcji B<DOSTOSOWYWANIE ZA POMOCĄ OPCJI W PLIKU ŹRÓDŁOWYM>. Można użyć tej opcji, jeśli nie jest możliwe umieszczenie definicja w tłumaczonym dokumencie.

note: type: =head1
en: INLINE CUSTOMIZATION
pl: DOSTOSOWYWANIE ZA POMOCĄ OPCJI W PLIKU ŹRÓDŁOWYM

note: type: textblock
en: 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:
pl: Działanie modułu AsciiDoc może być zmieniane za pomocą linii zaczynających się od B<//po4a:>, które są interpretowane jako polecenia parsera. Rozpoznawane są następujące polecenia:

note: type: =head1
en: STATUS OF THIS MODULE
pl: STATUS MODUŁU

note: type: textblock
en: Locale::Po4a::BibTeX - convert BibTeX documents from/to PO files
pl: Locale::Po4a::BibTeX - konwersja dokumentów BibTeX z/do plików PO

note: type: textblock
en: Locale::Po4a::BibTeX is a module to help the translation of bibliographies in the BibTeX format into other [human] languages.
pl: Locale::Po4a::BibTeX jest modułem ułatwiającym tłumaczenie bibliografiiw formacie BibTex do innych języków [używanych przez ludzi].

note: type: textblock
en: Fields values are extracted and proposed for translation.
pl: Wartości pól są wyciągane i proponowane do przetłumaczenia.

note: type: textblock
en: NONE.
pl: BRAK.

note: type: textblock
en: It is a very simple module, but still young.
pl: Jest to moduł bardzo prosty, lecz dostępny od niedawna.

note: type: textblock
en: Locale::Po4a::Chooser - manage po4a modules
pl: Locale::Po4a::Chooser - zarządza modułami po4a

note: type: textblock
en: 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.
pl: Locale::Po4a::Chooser jest modułem zarządzającym modułami po4a. Poprzednio wszystkie programy po4a znały wszystkie moduły po4a (pod, man, sgml, itd). Podczas dodawania nowego modułu powodowało to trudności z synchronizacją dokumentacji wszystkich modułów i dodaniem każdemu z nich dostępu do nowego modułu.

note: type: textblock
en: Now, you just have to call the Locale::Po4a::Chooser::new() function, passing the name of module as argument.
pl: Teraz należy wywołać funkcję Locale::Po4a::Chooser::new(), przekazując nazwę modułu jako jej argument.

note: type: =item
en: About po4a:
pl: O po4a:

note: type: =item
en: About modules:
pl: O modułach:

note: type: textblock
en: Locale::Po4a::Common - common parts of the po4a scripts and utils
pl: Locale::Po4a::Common - wspólne części narzędzi i użytków po4a

note: type: textblock
en: Locale::Po4a::Common contains common parts of the po4a scripts and some useful functions used along the other modules.
pl: Locale::Po4a::Common zawiera części wspólne wszystkich skryptów po4a i kilka użytecznych funkcji używanych przez inne moduły.

note: type: textblock
en: instead of:
pl: zamiast:

note: type: =head1
en: FUNCTIONS
pl: FUNKCJE

note: type: =head2
en: Showing output messages
pl: Pokazywanie komunikatów wyjściowych

note: type: textblock
en: Shows the current version of the script, and a short copyright message. It takes the name of the script as an argument.
pl: Wyświetla bieżącą wersję skryptu i krótką informację o prawach autorskich. Pobiera nazwę skryptu jako argument.

note: type: textblock
en: This function displays a message the same way as sprintf() does, but wraps the result so that they look nice on the terminal.
pl: Ta funkcja wyświetla wiadomość w ten sam sposób, co sprnitf(), jednakże zawija ją tak, żeby ładnie wyglądała na terminalu.

note: type: textblock
en: 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.
pl: Funkcja działa tak jak wrap_msg(), ale jako pierwszy argument pobiera nazwę modułu i pozostawia spację z lewej strony komunikatu.

note: type: textblock
en: 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.
pl: Funkcja działa tak jak wrap_msg(), ale jako pierwszy argument pobiera odnośnik plik:linia, jako drugi - nazwę modułu i pozostawia spację z lewej strony komunikatu.

note: type: =head2
en: Wrappers for other modules
pl: Moduły opakowujące ("wrappers") inne moduły

note: type: textblock
en: 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.
pl: Jeżeli moduł Locale::Gettext nie może zostać załadowany, to ten moduł udostępnia fałszywe (puste) implementacje następujących funkcji. Dziki temu program będzie działać, chociaż wiadomości po4a nie będą przetłumaczone.

note: type: textblock
en: If Locale::gettext is present, this wrapper also calls setlocale(LC_MESSAGES, "") so callers don't depend on the POSIX module either.
pl: Jeżeli Locale::gettext jest obecny ten moduł opakowujący wywoła także setlocale(LC_MESSAGES, ""), tak żeby funkcje korzystające z modułu nie musiały zależeć od modułu POSIX.

note: type: textblock
en: Locale::Po4a::Dia - convert uncompressed Dia diagrams from/to PO files
pl: Locale::Po4a::Dia - konwertuje nieskompresowane diagramy DIA do/z plików PO

note: type: textblock
en: Locale::Po4a::Dia is a module to help the translation of diagrams in the uncompressed Dia format into other [human] languages.
pl: Locale::Po4a::Dia jest modułem ułatwiającym tłumaczenie diagramów w nieskompresowanym formacie Dia do innych języków [używanych przez ludzi].

note: type: verbatim
en: You can get Dia (the graphical editor for these diagrams) from:
      http://www.gnome.org/projects/dia/
pl: Dia (graficzny edytor diagramów) można pobrać z:
      http://www.gnome.org/projects/dia/

note: type: =head1
en: TRANSLATING WITH PO4A::DIA
pl: TŁUMACZENIE Z POMOCĄ PO4A::DIA

note: type: textblock
en: 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.
pl: Ten moduł tłumaczy tylko nieskompresowane diagramy Dia. Aby w programie Dia zachować diagram nieskompresowany, należy odznaczyć opcję "Kompresuj pliki diagramów" ("Compress diagram files") w okienku "Zapisz diagram" ("Save Diagram").

note: type: verbatim
en: Another way is to uncompress the dia files from command line with:
      gunzip < original.dia > uncompressed.dia
pl: Innym sposobem jest rozpakowanie plików dia, używając polecenia:
      gunzip < oryginalny.dia > rozpakowany.dia

note: type: textblock
en: 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.
pl: Ten moduł jest w pełni funkcjonalny, ponieważ polega na module L<Locale::Po4a::Xml>. Definiuje tylko elementy do tłumaczenia (E<lt>dia:stringE<gt>) i odfiltrowuje wewnętrzne łańcuchy znaków (zawartość elementu E<lt>dia:diagramdataE<gt>), których się nie tłumaczy.

note: type: textblock
en: Locale::Po4a::Docbook - convert DocBook XML documents from/to PO files
pl: Locale::Po4a::Docbook - konwersja dokumentów DocBook XML z/do plików PO

note: type: textblock
en: Locale::Po4a::Docbook is a module to help the translation of DocBook XML documents into other [human] languages.
pl: Locale::Po4a::Docbook jest modułem ułatwiającym tłumaczenie dokumentów DocBook XML do innych języków [używanych przez ludzi].

note: type: textblock
en: This module is fully functional, as it relies in the L<Locale::Po4a::Xml> module. This only defines the translatable tags and attributes.
pl: Ten moduł jest w pełni funkcjonalny, ponieważ polega ma module L<Locale::Po4a::Xml>. Definiuje tylko elementy i atrybuty do tłumaczenia.

note: type: textblock
en: 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.
pl: Jedynym znanym problemem jest to, że nie obsługuje on jeszcze encji, włączając to encje dołączania plików, jednak można po prostu oddzielnie przetłumaczyć większość tych plików (poza typowymi plikami encji). Zresztą i tak zazwyczaj lepiej zarządzać nimi oddzielnie.

note: type: textblock
en: Locale::Po4a::Guide - convert Guide XML documents from/to PO files
pl: Locale::Po4a::Guide - konwersja dokumentów Guide XML z/do plików PO

note: type: textblock
en: 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.
pl: Locale::Po4a::Guide jest modułem ułatwiającym tłumaczenie dokumentacji dystrybucji Gentoo Linux  do innych języków [używanych przez ludzi].

note: type: textblock
en: This format is documented here: http://www.gentoo.org/doc/en/xml-guide.xml
pl: Format jest udokumentowany na stronie: http://www.gentoo.org/doc/en/xml-guide.xml

note: type: textblock
en: 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.
pl: Jedynym znanym problemem jest to, że nie dołącza plików za pomocą elementu <include href="...">, jednak można przetłumaczyć wszystkie takie pliki osobno i zazwyczaj lepiej je mieć rozdzielone.

note: type: textblock
en: Locale::Po4a::Halibut - convert Halibut documents and derivates from/to PO files
pl: Locale::Po4a::Halibut - konwersja dokumentów Halibut i pochodnych z/do plików PO

note: type: textblock
en: Locale::Po4a::Halibut is a module to help the translation of Halibut documents into other [human] languages.
pl: Locale::Po4a::Halibut jest modułem ułatwiającym tłumaczenie dokumentów w formacie Halibut do innych języków [używanych przez ludzi].

note: type: textblock
en: This module contains the definitions of common Halibut commands and environments.
pl: Moduł zawiera definicje wspólnych poleceń i środowisk Halibuta.

note: type: textblock
en: This module is still beta.  Please send feedback and feature requests.
pl: Moduł jest wciąż w fazie beta. Prosimy o przesyłanie opinii i próśb dotyczących dodania nowych funkcjonalności.

note: type: =head1
en: CAVEAT
pl: OGRANICZENIA

note: type: textblock
en: Some constructs are badly supported. The known ones are documented below.
pl: Wsparcie niektórych konstrukcji jest niepełne. Znane ograniczenia są opisane poniżej.

note: type: =head2
en: Verbatim blocks
pl: Bloki dosłowne

note: type: verbatim
en:   \c foo
      \c bar
pl:   \c ble
      \c bla

note: type: textblock
en: The verbatim block is not considered as a whole. Each line will be translated separately.
pl: Bloki dosłowne (verbatim blocks) nie są uważane za całość. Każda linia będzie tłumaczona osobno.

note: type: textblock
en: This program is free software; you may redistribute it and/or modify it under the terms of GPL (see COPYING file).
pl: Program jest wolnym oprogramowaniem; można go redystrybuować i/lub modyfikować zgodnie z warunkami licencji GPL (patrz plik COPYING).

note: type: textblock
en: Locale::Po4a::Ini - convert INI files from/to PO files
pl: Locale::Po4a::Ini - konwersja plików INI z/do plików PO

note: type: textblock
en: Locale::Po4a::Ini is a module to help the translation of INI files into other [human] languages.
pl: Locale::Po4a::Ini jest modułem ułatwiającym tłumaczenie plików INI do innych języków [używanych przez ludzi].

note: type: textblock
en: The module searches for lines of the following format and extracts the quoted text:
pl: Moduł szuka linii w poniższym formacie, wyciągając z nich teksty otoczone cudzysłowami:

note: type: textblock
en: identificator="text than can be translated"
pl: identyfikator="tekst do przetłumaczenia"

note: type: textblock
en: NOTE: If the text is not quoted, it will be ignored.
pl: UWAGA: teksty nieotoczone cudzysłowami zostaną zignorowane.

note: type: textblock
en: Locale::Po4a::KernelHelp - convert kernel configuration help from/to PO files
pl: Locale::Po4a::KernelHelp - konwersja pomocy konfiguracji jądra z/do plików PO

note: type: textblock
en: Locale::Po4a::KernelHelp is a module to help the translation of documentation for the Linux kernel configuration options into other [human] languages.
pl: Locale::Po4a::KernelHelp jest modułem ułatwiającym tłumaczenie dokumentacji opcji konfiguracji jądra Linuksa do innych języków [używanych przez ludzi].

note: type: textblock
en: 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.
pl: Moduł został właśnie napisany i wymaga większej liczby testów. Większość potrzebnej pracy będzie dotyczyć narzędzi używanych do przetwarzania pliku (i konfigurowania jądra), tak żeby akceptowały czytanie dokumentacji z innego (przetłumaczonego) pliku.

note: type: textblock
en: Locale::Po4a::LaTeX - convert LaTeX documents and derivates from/to PO files
pl: Locale::Po4a::LaTeX - konwersja dokumentów LaTeX z/do plików PO

note: type: textblock
en: 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.
pl: Locale::Po4a::LaTeX jest modułem ułatwiającym tłumaczenie dokumentów LaTeX do innych języków [używanych przez ludzi].

note: type: textblock
en: This module contains the definitions of common LaTeX commands and environments.
pl: Moduł zawiera definicje wspólnych poleceń i środowisk LaTeX.

note: type: textblock
en: See the L<Locale::Po4a::TeX(3pm)|Locale::Po4a::TeX> manpage for the list of recognized options.
pl: Listę obsługiwanych opcji można znaleźć w stronie podręcznika L<Locale::Po4a::TeX(3pm)|Locale::Po4a::TeX>.

note: type: textblock
en: Locale::Po4a::Man - convert manual pages from/to PO files
pl: Locale::Po4a::Man - konwersja stron podręcznika z/do plików PO

note: type: textblock
en: 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.
pl: Locale::Po4a::Man jest modułem ułatwiającym tłumaczenie dokumentacji w formacie nroff (język stron podręcznika ekranowego) do innych języków [używanych przez ludzi].

note: type: =head1
en: TRANSLATING WITH PO4A::MAN
pl: TŁUMACZENIE Z POMOCĄ PO4A::MAN

note: type: textblock
en: 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.
pl: Moduł bardzo się stara, aby ułatwić życie tłumacza. Dlatego tekst prezentowany tłumaczowi nie jest dosłowną kopią oryginalnego tekstu strony podręcznika. W istocie, ukrywane są surowe części formatu nroff, tak żeby tłumacze nie zrobili w nich bałaganu.

note: type: =head2
en: Text wrapping
pl: Zawijanie tekstu

note: type: textblock
en: 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.
pl: Teksty niewciętych akapitów są automatycznie zawijane dla wygody tłumacza. Może to prowadzić do niewielkich różnic w wygenerowanym pliku wyjściowym, ponieważ reguły zawijania tekstu używane przez groffa nie są jasne - na przykład czasami groff zachowuje dwie spacje występujące po nawiasie.

note: type: textblock
en: Anyway, the difference will only be about the position of the extra spaces in wrapped paragraph, and I think it's worth.
pl: Tak czy owak, różnica będzie dotyczyła tylko rozmieszczenia dodatkowych spacji w zawiniętym tekście akapitu.

note: type: =head2
en: Font specification
pl: Określanie czcionki

note: type: textblock
en: 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:
pl: Pierwsza zmiana dotyczy specyfikacji zmian czcionek. W nroffie istnieje kilka sposobów określenia, że podane słowo powinno być napisane czcionką małą, wytłuszczoną lub kursywą. W tekście do przetłumaczenia można to zrobić tylko na jeden sposób, zapożyczony z formatu POD (formatu dokumentacji Perla):

note: type: =item
en: IE<lt>textE<gt> -- italic text
pl: IE<lt>tekstE<gt> -- kursywa

note: type: textblock
en: equivalent to \fItext\fP or ".I text"
pl: odpowiednik \fItekst\fP lub ".I tekst"

note: type: =item
en: BE<lt>textE<gt> -- bold text
pl: BE<lt>tekstE<gt> -- tekst wytłuszczony

note: type: textblock
en: equivalent to \fBtext\fP or ".B text"
pl: odpowiednik \fBtekst\fP lub ".B tekst"

note: type: =item
en: RE<lt>textE<gt> -- roman text
pl: RE<lt>tekstE<gt> -- tekst zwykłą czcionką

note: type: textblock
en: equivalent to \fRtext\fP
pl: odpowiednik \fRtekst\fP

note: type: =item
en: CWE<lt>textE<gt> -- constant width text
pl: CWE<lt>tekst<gt> -- tekst o stałej szerokości

note: type: textblock
en: equivalent to \f(CWtext\fP or ".CW text"
pl: odpowiednik \f(CWtekst\fP lub ".CW tekst"

note: type: textblock
en: Remark: The CW face is not available for all groff devices. It is not recommended to use it. It is provided for your convenience.
pl: Uwaga: CW nie jest dostępne dla wszystkich urządzeń groffa. Używanie go nie jest zalecane. Jest dostarczone dla wygody użytkownika.

note: type: =head2
en: Automatic characters transliteration
pl: Automatyczna transliteracja znaków

note: type: textblock
en: Po4a automatically transliterate some characters to ease the translation or the review of the translation.  Here is the list of the transliterations:
pl: Po4a automatycznie zamienia niektóre znaki, aby ułatwić tłumaczenia lub przeglądanie tłumaczeń. Lista takich transliteracji:

note: type: =item
en: hyphens
pl: łączniki

note: type: textblock
en: 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.
pl: Łączniki (-) i znaki minusa (\-) w stronach podręcznika ekranowego są wszystkie transliterowane do zwykłych myślników (-) w pliku PO. Kiedy tłumaczenia są zapisywane w pliku wynikowym wszystkie myślniki są zamieniane na znaki minusa (\-).

note: type: textblock
en: Translators can force an hyphen by using the roff glyph '\[hy]' in their translations.
pl: Tłumacze mogą wymusić wstawienie łącznika, używając w swoich tłumaczeniach kodu "\[hy]" groffa.

note: type: =item
en: non-breaking spaces
pl: spacje nierozdzielające

note: type: textblock
en: 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 ('\ ').
pl: Tłumacze mogą używać nierozdzielających spacji w swoich tłumaczeniach. Takie spacje nierozdzielające (0xA0 w latin1) będą przetłumaczone jako spacje nierozdzielające roff ("\ ").

note: type: =item
en: quotes transliterations
pl: transliteracje cudzysłowów

note: type: textblock
en: `` and '' are respectively tranliterated into \*(lq and \*(rq.
pl: `` i '' są odpowiednio zamieniane na \*(lq i \*(rq.

note: type: textblock
en: To avoid these transliterations, translators can insert a zero width roff character (i.e., using `\&` or '\&' respectively).
pl: Aby uniknąć tych transliteracji, tłumacze mogą umieścić zerowej szerokości znak roffa (np. używając odpowiednio `\&` lub '\&').

note: type: =head2
en: Putting 'E<lt>' and 'E<gt>' in translations
pl: Wstawianie "E<lt>" i "E<gt>" w tłumaczeniach

note: type: textblock
en: 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).
pl: Ponieważ znaki te są używane do oddzielania części objętych zmianą czcionki, nie można ich używać wprost. Zamiast nich trzeba użyć EE<lt>ltE<gt> i EE<lt>gtE<gt> (jak w POD, po raz kolejny).

note: type: textblock
en: Activate debugging for some internal mechanisms of this module.  Use the source to see which parts can be debugged.
pl: Uaktywnia debugowanie kilku wewnętrznych mechanizmów modułu. Informacje o tym, które części mogą być debugowane, można znaleźć w źródłach.

note: type: textblock
en: Increase verbosity.
pl: Zwiększa gadatliwość.

note: type: textblock
en: This is the default value.  The module will fail when a .de, .ie or .if section is encountered.
pl: Jest to domyślna wartość. Działanie modułu zakończy się błędem, jeżeli zostanie napotkana sekcja .de, .ie lub .if.

note: type: textblock
en: Indicates that the .de, .ie or .if sections must be copied as is from the original to the translated document.
pl: Określa, że sekcje .de, .ie lub .if muszą być skopiowane bez zmian z oryginału do tłumaczonego dokumentu.

note: type: textblock
en: 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.
pl: Wskazuje sekcje .de, .ie lub .if jako możliwe do przetłumaczenia. Opcja powinna być używana tylko wtedy, gdy któraś z tych sekcji zawiera tekst do przetłumaczenia. W przeciwnym razie wskazane byłoby użycie I<verbatim>.

note: type: textblock
en: This option is only useful for mdoc pages.
pl: Ta opcja jest użyteczna tylko dla stron w formacie mdoc.

note: type: textblock
en: 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.
pl: Wybiera dokładniejszą obsługę formatu mdoc, nakazuję po4a nietłumaczenie sekcji "NAME" (NAZWA). Strony mdoc, zawierające przetłumaczoną sekcję "NAME", nie generują nagłówka ani stopki.

note: type: verbatim
en: According to the groff_mdoc page, the NAME, SYNOPSIS and DESCRIPTION
    sections are mandatory.
    There are no known issues with translated SYNOPSIS or DESCRIPTION section,
    but you can also specify these sections this way:
     -o mdoc=NAME,SYNOPSIS,DESCRIPTION
pl: Zgodnie ze stroną podręcznika groff_mdoc, wymagane są sekcje NAME (NAZWA),
    SYNOPSIS (SKŁADNIA)oraz DESCRIPTION (OPIS).
    Chociaż nie ma żadnych znanych problemów z przetłumaczonymi sekcjami SYNOPSIS
    czy DESCRIPTION, to ich tłumaczenie można również pominąć za pomocą:
     -o mdoc=NAME,SYNOPSIS,DESCRIPTION

note: type: verbatim
en: This mdoc issue can also be solved with an addendum like this one:
     PO4A-HEADER:mode=before;position=^.Dd
     .TH DOCUMENT_TITLE 1 "Month day, year" OS "Section Name"
pl: Kwestię mdoc można także rozwiązać, używając załącznika podobnego do poniższego:
     PO4A-HEADER:mode=before;position=^.Dd
     .TH DOCUMENT_TITLE 1 "Month day, year" OS "Section Name"

note: type: textblock
en: 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.
pl: Uwaga: jeśli po4a nie obsługuje danego makra, a uważasz, że jest to standardowe makro roff, proszę to zgłosić zespołowi deweloperów po4a.

note: type: textblock
en: B<untranslated> indicates that this macro (at its arguments) don't have to be translated.
pl: B<untranslated> oznacza, że to makro (i wszystkie jego argumenty) nie muszą być tłumaczone.

note: type: textblock
en: B<noarg> is like B<untranslated>, except that po4a will verify that no argument is added to this macro.
pl: B<noarg> jest jak B<untranslated>, poza tym, że po4a sprawdzi, że do tego makra nie dodano żadnego argumentu.

note: type: textblock
en: B<translate_joined> indicates that po4a must propose to translate the arguments of the macro.
pl: B<translate_joined> oznacza, że po4a musi zaproponować tłumaczenie argumentów makra.

note: type: textblock
en: With B<translate_each>, the arguments will also be proposed for the translation, except that each one will be translated separately.
pl: B<translate_each> powoduje, że argumenty będą także zaproponowane do tłumaczenia, z tym że każdy z nich będzie przetłumaczony osobno.

note: type: textblock
en: 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.
pl: Opcja przyjmuje jako argument rozdzieloną przecinkami listę par I<początek>:I<koniec>, gdzie I<początek> i I<koniec> są poleceniami ograniczającymi początek i koniec sekcji, której tekst nie powinien być ponownie zawijany.

note: type: textblock
en: 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.
pl: Opcja pozwala na podanie rozdzielonej przecinkami listy makr, które nie mogą dzielić bieżącego akapitu. Komunikat do przetłumaczenia będzie wtedy zawierał I<foo E<lt>.bar baz quxE<gt> quux>, gdzie I<bar> jest poleceniem, które powinno być włączone do pliku, a I<baz qux> - jego argumentami.

note: type: textblock
en: 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).
pl: Ta opcja określa zachowanie po4a po napotkaniu nieznanego makra. Domyślnie po4 kończy działanie z błędem i wyświetla stosowny komunikat. Możliwe są następujące wartości: I<failed> (wartość domyślna), I<untranslated>, I<noarg>, I<translate_joined>, I<translate_each> (patrz objaśnienia powyżej).

note: type: =head1
en: AUTHORING MAN PAGES COMPLIANT WITH PO4A::MAN
pl: PISANIE STRON PODRĘCZNIKA ZGODNYCH Z PO4A::MAN

note: type: textblock
en: 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.
pl: Moduł wciąż ma dużo ograniczeń i zawsze będzie miał, ponieważ nie jest rzeczywistym interpreterem nroffa. Byłoby możliwe wykonanie rzeczywistego interpretera nroffa, aby umożliwić autorom używanie w swoich stronach wszystkich istniejących makr i tworzenie nowych, ale nie chcieliśmy tego robić. Byłoby to zbyt trudne, a przy tym raczej niepotrzebne. Uważamy, że jeżeli autorzy stron podręcznika chcą, żeby ich strony były przetłumaczone, to muszą tak przekształcić strony, by uprościć pracę tłumaczy.

note: type: textblock
en: 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.
pl: Tak więc, parser stron man zaimplementowany w po4a ma kilka znanych ograniczeń, których nie chcemy poprawiać, i będących pułapkami, których powinieneś unikać, jeśli chcesz, żeby tłumacze opiekowali się Twoją dokumentacją.

note: type: =head2
en: Don't program in nroff
pl: Nie programuj w nroffie

note: type: textblock
en: 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).
pl: nroff jest kompletnym językiem programowania z definicjami makr, instrukcjami warunkowymi itd. Ponieważ parser nie jest pełnowartościowym interpreterem nroffa, zwróci błąd podczas przetwarzania stron zawierających te właściwości. (Na moim komputerze jest około 200 takich stron).

note: type: =head2
en: Use the plain macro set
pl: Używaj prostego zbioru makr

note: type: textblock
en: 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.
pl: Wciąż istnieje kilka makr, których po4a nie obsługuje. Dzieje się tak dlatego, że nie znalazłem żadnej dokumentacji tych makr. Poniżej jest lista nieobsługiwanych makr znalezionych na moim komputerze. Proszę zauważyć, że ta lista nie jest pełna, ponieważ program kończy się, zwracając błąd, już po napotkaniu pierwszego nieznanego makra. Jeśli masz jakieś informacje o niektórych z nich, z przyjemnością dopiszę ich obsługę. Z powodu tych makr około 250 stron na moim komputerze nie jest dostępnych dla po4a::man.

note: type: =head2
en: Hiding text from po4a
pl: Ukrywanie tekstu przez po4a

note: type: textblock
en: 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.
pl: Czasem autor wie, że niektóre części strony podręcznika nie powinny być tłumaczone, więc nie powinny być przetwarzane przez po4a. Na przykład opcja może pobierać argument I<other> oraz I<other> może się także pojawić jako ostatni element listu. Pierwsze I<other> nie powinno być tłumaczone, a drugie - powinno.

note: type: textblock
en: In such case, the author can avoid po4a to extract some strings, using some special groff constructs:
pl: W takim przypadku, aby po4a pominęło takie komunikaty, autor może użyć specjalnych konstrukcji groffa:

note: type: textblock
en: (this will require the B<-o groff_code=verbatim> option)
pl: (wymaga to podania opcji B<-o groff_code=verbatim>)

note: type: verbatim
en: A new macro can also be defined to automate this:
     .de IR_untranslated
     .    IR \\$@
     ..
pl: Aby to zautomatyzować, można zdefiniować nowe makro:
    .de IR_untranslated
     .    IR \\$@
     ..

note: type: textblock
en: (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)
pl: (wymaga to podania opcji B<-o groff_code=verbatim> i B<-o untranslated=IR_untranslated>; przy tej konstrukcji warunek B<.if !'po4a'hide'> staje się zbędny, ponieważ po4a nie przetwarza wnętrza definicji makra)

note: type: verbatim
en: or using an alias:
     .als IR_untranslated IR
pl: lub używając aliasu:
     .als IR_untranslated IR

note: type: textblock
en: This will require the B<-o untranslated=als,IR_untranslated> option.
pl: Wymaga to podania opcji B<-o untranslated=als,IR_untranslated>.

note: type: =head2
en: Conclusion
pl: Wniosek

note: type: textblock
en: 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.
pl: Podsumowując tę sekcję, pamiętaj, żeby tworzyć proste strony podręcznika ekranowego i nie starać się być zbyt pomysłowym. Roff pozwala na wiele rzeczy, które nie są obsługiwane przez parser. Na przykład: nie rób bałaganu, używając \c do przerwania przetwarzania tekstu (jak to robi 40 stron podręcznika na moim komputerze). Albo: argumenty makr umieszczaj w tej samej linii, co samo makro. Wiem, że nroff dopuszcza rozdzielanie makr i ich argumentów, ale obsługiwanie tego zbytnio by skomplikowało parser.

note: type: textblock
en: 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.
pl: Oczywiście inną możliwością jest użycie innego formatu, bardziej przyjaznego tłumaczom (jak POD używający po4a::pod albo jednego z rodziny XML, np. SGML), ale nie jest to potrzebne dzięki po4a::man. Jeśli formatem źródłowym Twojej dokumentacji jest POD lub XML, to byłoby mądre, aby przetłumaczyć źródłowy format, a nie ten wygenerowany. W większości wypadków po4a::man rozpozna wygenerowane strony i wypisze odpowiednie ostrzeżenie. A nawet odmówi przetwarzana stron wygenerowanych przez POD, ponieważ te strony są perfekcyjnie obsługiwane przez po4a::pod i ponieważ ich odpowiednik nroffa generuje wiele nowych makr, których nie chcę obsługiwać. Na moim komputerze 1432 spośród 4323 stron jest wygenerowanych z formatu POD i będzie zignorowanych przez po4a::man.

note: type: textblock
en: 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…
pl: W większości wypadków, po4a::man wykryje problem i odmówi przetwarzania strony, wypisując odpowiedni komunikat. W kilku rzadkich wypadkach, program zakończy się bez żadnego ostrzeżenia, ale plik wynikowy będzie niepoprawny. Takie sytuacje są nazywane "błędami";) Jeśli spotkasz się z taką sytuacją, proszę to zgłosić wraz z odpowiednią poprawką, jeśli to możliwe…

note: type: textblock
en: This module can be used for most of the existing man pages.
pl: Modułu można używać z większością istniejących stron podręcznika.

note: type: textblock
en: Some tests are regularly run on Linux boxes:
pl: Niektóre testy są regularnie uruchamiane na komputerach z Linuksem:

note: type: textblock
en: one third of the pages are refused because they were generated from another format supported by po4a (e.g. POD or SGML).
pl: odrzucono jedną trzecią stron ponieważ były one wygenerowane z innego formatu obsługiwanego przez po4a (np. POD lub SGML).

note: type: textblock
en: 10% of the remaining pages are rejected with an error (e.g. a groff macro is not supported).
pl: 10% pozostałych stron odrzucono z powodu błędu (np. nieobsługiwane makro groff).

note: type: textblock
en: Then, less than 1% of the pages are accepted silently by po4a, but with significant issues (i.e. missing words, or new words inserted)
pl: W końcu mniej niż 1% stron został zaakceptowany bez ostrzeżeń przez po4a, ale wystąpiły pewne poważne problemy (np. usunięte lub dodane słowa).

note: type: textblock
en: 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).
pl: Inne strony są zazwyczaj obsługiwane bez różnic bardziej istotnych niż różnice w liczbie spacji czy zawijaniu linii (problemy z czcionkami w mniej niż 10% przetworzonych stron).

note: type: textblock
en: Locale::Po4a::Po - PO file manipulation module
pl: Locale::Po4a::Po - moduł manipulujący plikami PO

note: type: verbatim
en:     # Read PO file
        $pofile->read('file.po');
pl:     # Czytanie pliku PO
        $pofile->read('plik.po');

note: type: verbatim
en:     # Add an entry
        $pofile->push('msgid' => 'Hello', 'msgstr' => 'bonjour',
                      'flags' => "wrap", 'reference'=>'file.c:46');
pl:     # Dodanie wpisu
        $pofile->push('msgid' => 'Hello', 'msgstr' => 'bonjour',
                      'flags' => "wrap", 'reference'=>'file.c:46');

note: type: verbatim
en:     # Extract a translation
        $pofile->gettext("Hello"); # returns 'bonjour'
pl:     # Wyciągnięcie tłumaczenia
        $pofile->gettext("Hello"); # zwraca 'bonjour'

note: type: verbatim
en:     # Write back to a file
        $pofile->write('otherfile.po');
pl:     # Zapisanie z powrotem do pliku
        $pofile->write('inny_plik.po');

note: type: textblock
en: 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.
pl: Locale::Po4a::Po jest modułem pozwalającym manipulować katalogami wiadomości. Można załadować i zapisać plik po (którego rozszerzeniem często jest I<po>), można zbudować nowe wpisy w locie albo zażądać przetłumaczenia komunikatu.

note: type: textblock
en: 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.
pl: Ten moduł jest częścią projektu po4a, którego celem jest użycie plików PO (z założenia przeznaczonych do ułatwienia tłumaczenia komunikatów programu) do tłumaczenia wszystkiego, włączając dokumentację (strony podręcznika man, strony info), opisy pakietów, szablony debconfa i wszystkiego, co może korzystać z tego.

note: type: textblock
en: Creates a new message catalog. If an argument is provided, it's the name of a PO file we should load.
pl: Tworzy nowy katalog wiadomości. Jeśli podano argument, jest on nazwą pliku PO, który powinien być załadowany.

note: type: textblock
en: 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.
pl: Czyta plik PO (o nazwie podanej jako argument). Wcześniej istniejące wpisy nie są usuwane, a nowe wpisy są dodawane na końcu katalogu.

note: type: textblock
en: Writes the current catalog to the given file.
pl: Zapisuje bieżący katalog do podanego pliku.

note: type: textblock
en: 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).
pl: Podobne do write, ale jeżeli pliki PO lub POT już istnieją, to wynik zostanie zapisany do pliku tymczasowego, który będzie porównany z istniejącym plikiem, aby sprawdzić, czy aktualizacja jest rzeczywiście potrzebna (pozwala to uniknąć zmieniania pliku POT tylko po to, by zaktualizować odnośniki lub pole POT-Creation-Date).

note: type: textblock
en: 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.
pl: Funkcja wyodrębnia katalog wiadomości z istniejącego katalogu. W pliku wynikowym będą umieszczone tylko te wpisy, do których istnieje odniesienie w podanym pliku.

note: type: textblock
en: 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.
pl: Funkcja przetwarza swoje argumenty, generuje z nich definicję funkcji Perla, ewaluuje tę definicję i filtruje pola, dla których ta wygenerowana funkcja zwróci wartość true.

note: type: textblock
en: I love Perl sometimes ;)
pl: Czasami uwielbiam Perla ;)

note: type: textblock
en: 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.
pl: Zmienia kodowanie wpisów msgstr pliku PO do UTF-8. Nic nie robi, jeśli w pliku PO nie jest podane kodowanie znaków (wartość "CHARSET") albo gdy jest ono ustawione na UTF-8 lub ASCII.

note: type: =head1
en: Functions to use a message catalog for translations
pl: Funkcje używające katalogu wiadomości do tłumaczeń

note: type: textblock
en: 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.
pl: Żąda przetłumaczenia przez bieżący katalog komunikatu podanego jako argument. Jeśli nie znaleziono tłumaczenia, funkcja zwróci oryginalny (nieprzetłumaczony) komunikat.

note: type: textblock
en: After the string to translate, you can pass a hash of extra arguments. Here are the valid entries:
pl: Po komunikacie do przetłumaczenia można przekazać hasha z dodatkowymi argumentami. Poniżej podano poprawne wpisy:

note: type: textblock
en: 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.
pl: wartość logiczna, określająca, czy białe znaki w tekście mają znaczenie. Jeśli tak, to funkcja kanonizuje tekst przed wyszukaniem tłumaczenia oraz zawija tekst wynikowy.

note: type: textblock
en: the column at which we should wrap (default: 76).
pl: kolumna, w której tekst powinien być zawijany (domyślnie: 76).

note: type: textblock
en: 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:
pl: Zwraca statystyki dotyczące stosunku trafień od ostatniego wywołania funkcji stats_clear(). Proszę zauważyć, że to nie są te same statystyki, które wypisuje msgfmt --statistic. Tutaj, statystyki dotyczą bieżącego użycia pliku PO, a msgfmt podaje stan pliku. Przykład użycia:

note: type: verbatim
en:     [some use of the PO file to translate stuff]
pl:     [klika użyć pliku PO do tłumaczenia rzeczy]

note: type: verbatim
en:     ($percent,$hit,$queries) = $pofile->stats_get();
        print "So far, we found translations for $percent\%  ($hit of $queries) of strings.\n";
pl:     ($percent,$hit,$queries) = $pofile->stats_get();
        print "Do tej pory znaleźliśmy tłumaczenia $percent\% ($hit z $queries) komunikatów.\n";

note: type: textblock
en: Clears the statistics about gettext hits.
pl: Czyści statystyki dotyczące trafienia gettexta.

note: type: =head1
en: Functions to build a message catalog
pl: Funkcje budujące katalog wiadomości

note: type: textblock
en: Push a new entry at the end of the current catalog. The arguments should form a hash table. The valid keys are:
pl: Dodaje nowy wpis na koniec bieżącego katalogu. Argumenty powinny być przekazane w hashu. Dostępne klucze:

note: type: textblock
en: the string in original language.
pl: łańcuch znaków w oryginalnym języku.

note: type: textblock
en: the translation.
pl: tłumaczenie.

note: type: textblock
en: 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.
pl: wskazanie, gdzie dany komunikat został znaleziony. Przykład plik.c:46 (w linii 46 pliku "plik.c"). W razie wielokrotnych wystąpień może być to lista rozdzielona znakami spacji.

note: type: textblock
en: a comment added here manually (by the translators). The format here is free.
pl: komentarz dodany tutaj ręcznie (przez tłumaczy). Format jest dowolny.

note: type: textblock
en: 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.
pl: komentarz dodany automatycznie przez program wyciągający komunikaty. Szczegóły w opisie opcji B<--add-comments> programu B<xgettext>.

note: type: textblock
en: space-separated list of all defined flags for this entry.
pl: rozdzielona spacjami lista wszystkich zdefiniowanych flag dla tego wpisu.

note: type: textblock
en: 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>.
pl: Poprawne flagi: 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> i B<fuzzy>.

note: type: textblock
en: See the gettext documentation for their meaning.
pl: Ich znaczenie można znaleźć w dokumentacji pakietu gettext.

note: type: textblock
en: 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.
pl: jest to w większości argument wewnętrzny używany podczas przekształcania dokumentów do formatu gettext. Ideą jest przetworzenie do obiektu PO zarówno oryginału, jak i tłumaczenia, scalenie ich, używając msgid jednego jako msgstr drugiego i msgid drugiego jako msgstr pierwszego. Aby mieć pewność, że wszystko jest OK, każdy msgid w obiekcie ma przypisany typ, oparty na strukturze dokumentu (jak "chap", "sect1", "p" w formacie DocBook). Jeśli typy komunikatów nie są takie same, oznacza to, że struktura obu plików jest różna i proces kończy się błędem.

note: type: textblock
en: This information is written as automatic comment in the PO file since this gives to translators some context about the strings to translate.
pl: Ta informacja jest zapisywana jako automatyczny komentarz w pliku PO, ponieważ dostarcza tłumaczom kontekstu o komunikatach, które tłumaczą.

note: type: textblock
en: boolean indicating whether whitespaces can be mangled in cosmetic reformattings. If true, the string is canonized before use.
pl: wartość logiczna, określająca, czy białe znaki mogą być scalane. Jeśli tak, komunikat przed użyciem będzie ujednolicony.

note: type: textblock
en: This information is written to the PO file using the B<wrap> or B<no-wrap> flag.
pl: Ta informacja jest zapisywana do pliku PO z użyciem flagi B<wrap> lub B<no-wrap>.

note: type: textblock
en: This information is not written to the PO file.
pl: Ta informacja nie jest zapisywana w pliku PO.

note: type: =head1
en: Miscellaneous functions
pl: Różne funkcje

note: type: textblock
en: Returns the number of entries in the catalog (without the header).
pl: Zwraca liczbę wpisów w katalogu (nie licząc nagłówka).

note: type: textblock
en: Returns the number of entries in document. If a string appears multiple times in the document, it will be counted multiple times.
pl: Zwraca liczbę wpisów w dokumencie. Komunikaty pojawiające się wiele razy w tym dokumencie będą policzone wiele razy.

note: type: textblock
en: Returns the msgid of the given number.
pl: Zwraca msgid o zadanym numerze.

note: type: textblock
en: Returns the msgid with the given position in the document.
pl: Zwraca msgid znajdujące się w dokumencie na podanej pozycji.

note: type: textblock
en: Locale::Po4a::Pod - convert POD data from/to PO files
pl: Locale::Po4a::Pod - konwersja danych POD z/do plików PO

note: type: verbatim
en:     # Read POD from STDIN and write to STDOUT.
        $parser->parse_from_filehandle;
pl:     # Czytanie POD ze STDIN i zapisanie do STDOUT.
        $parser->parse_from_filehandle;

note: type: verbatim
en:     # Read POD from file.pod and write to file.txt.
        $parser->parse_from_file ('file.pod', 'file.txt');
pl:     # Czytanie POD z plik.pod i zapisanie do plik.txt.
        $parser->parse_from_file ('plik.pod', 'plik.txt');

note: type: textblock
en: 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.
pl: Locale::Po4a::Pod jest modułem ułatwiającym tłumaczenie dokumentacji w formacie POD (preferowany język dokumentowania programów napisanych w Perlu) do innych języków [używanych przez ludzi].

note: type: textblock
en: 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:
pl: Myślę, że ten moduł jest stabilny jak skała. Istnieje tylko jeden znany błąd związany z F</usr/lib/perl5/Tk/MainWindow.pod> (i innymi stronami, patrz niżej), który zawiera:

note: type: textblock
en: 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
pl: Niestety, w wersji z po4a zostało to rozdzielone na spacji podczas zawijania. W wyniku, oryginalna strona podręcznika zawiera

note: type: textblock
en: and mine contains
pl: a przetłumaczona zawiera

note: type: textblock
en: which is logic since CE<lt>foobarE<gt> is rewritten "foobar".
pl: co jest logiczne, skoro CE<lt>cośtamE<gt> jest przepisane jako "cośtam".

note: type: textblock
en: 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
pl: Pełna lista stron mających ten problem na moim komputerze (z 564 stron; proszę zauważyć, że zależy to od wyboru kolumny zawijania): /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

note: type: =head1
en: INTERNALS
pl: STRUKTURY WEWNĘTRZNE

note: type: textblock
en: 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().
pl: Locale::Po4a::Pod, jako klasa dziedziczona z Pod::Parser, obsługuje te same interfejsy i metody. Wszystkie szczegóły można znaleźć w L<Pod::Parser>; w skrócie: najpierw trzeba utworzyć parser, używając C<< Locale::Po4a::Pod->new() >>, a potem wywołać albo parse_from_filehandle() albo parse_from_file().

note: type: textblock
en: 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:
pl: new() może pobrać opcje, w postaci par klucz/wartość, kontrolujące zachowanie parsera. Następujące wspólne opcje są rozpoznawane przez wszystkie dzieci Pod::Parser:

note: type: textblock
en: 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.
pl: Jeśli ustawione na true, wybiera alternatywny format wyjścia, między innymi używa innego stylu nagłówka i oznacza wpisy B<=item> dwukropkiem na lewym marginesie. Domyślną wartością jest false.

note: type: textblock
en: 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.
pl: Jeśli ustawione na true, części nie-POD pliku wejściowego będą dołączone do pliku wyjściowego. Użyteczne podczas oglądania dokumentu mającego bloki POD z POD przekształconym, a kodem pozostawionym bez zmian.

note: type: textblock
en: The number of spaces to indent regular text, and the default indentation for B<=over> blocks.  Defaults to 4.
pl: Liczba spacji wcinania zwykłego tekstu i domyślne wcinanie bloków B<=over>. Domyślnie 4.

note: type: textblock
en: 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.
pl: Jeśli ustawione na true, po nagłówku B<=head1> jest dodawana pusta linia. Jeśli ustawione na false (domyślnie), to nie jest wypisywana pusta linia po B<=head1>, ale jest wciąż wypisywana po B<=head2>. Jest to wartość domyślna, ponieważ jest to oczekiwane formatowanie stron podręcznika ekranowego. Podczas formatowania dowolnych dokumentów tekstowych, ustawienie tego na true może wygenerować przyjemniejsze wyjście.

note: type: textblock
en: 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.
pl: Ustawia znaki cudzysłowu używane do otaczania tekstów CE<lt>>. Jeżeli wartością jest pojedynczy znak, to jest on używany jako lewy i prawy cudzysłów; jeśli są to dwa znaki, to pierwszy z nich jest lewym cudzysłowem, a drugi - prawym; jeśli są cztery znaki, to pierwsze dwa są lewym cudzysłowem, a kolejne dwa - prawym.

note: type: textblock
en: This may also be set to the special value B<none>, in which case no quote marks are added around CE<lt>> text.
pl: Może to także przyjmować na specjalną wartość B<none>, określającą, że tekst CE<lt>> nie zostanie otoczony znakami cudzysłowu.

note: type: textblock
en: 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.
pl: Jeśli jest ustawione na true, Locale::Po4a::Pod przyjmie, że każde zdanie kończy się dwoma spacjami i postara się to zachować. Jeśli ustawione na false, wszystkie kolejne białe znaki w niedosłownych akapitach są zamieniane na jedną spację. Domyślną wartością jest true.

note: type: textblock
en: The column at which to wrap text on the right-hand side.  Defaults to 76.
pl: Numer kolumny, według której zawijać tekst po jego prawej stronie. Domyślnie jest to 76.

note: type: textblock
en: Locale::Po4a::Sgml - convert SGML documents from/to PO files
pl: Locale::Po4a::Sgml - konwersja dokumentów SGML z/do plików PO

note: type: textblock
en: Locale::Po4a::Sgml is a module to help the translation of documentation in the SGML format into other [human] languages.
pl: Locale::Po4a::Sgml jest modułem ułatwiającym tłumaczenie dokumentacji w formacie SGML do innych języków [używanych przez ludzi].

note: type: textblock
en: 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.
pl: Moduł ten do przetworzenia plików SGML używa programu B<onsgmls>(1). Proszę się upewnić, że program ten wraz z definicjami DTD plików SGMLjest zainstalowany w systemie.

note: type: textblock
en: Space separated list of keywords indicating which part you want to debug. Possible values are: tag, generic, entities and refs.
pl: Rozdzielona spacjami lista słów kluczowych, określająca, którą część chcesz debugować. Możliwe wartości: tag, generic, entities i refs.

note: type: textblock
en: Give more information about what's going on.
pl: Daje więcej informacji na temat tego, co się dzieje.

note: type: textblock
en: Space separated list of extra tags (beside the DTD provided ones) whose content should form an extra msgid.
pl: Rozdzielona spacjami lista dodatkowych elementów (oprócz tych zdefiniowanych w DTD), których zawartość powinna utworzyć dodatkowy msgid.

note: type: textblock
en: Space separated list of extra tags (beside the DTD provided ones)  containing other tags, some of them being of category B<translate>.
pl: Rozdzielona spacjami lista dodatkowych elementów (oprócz tych zdefiniowanych w DTD), zawierających inne elementy, wśród których istnieją elementy należące do kategorii B<translate>.

note: type: textblock
en: Space separated list of tags which increase the indentation level.
pl: Rozdzielona spacjami lista elementów, które zwiększają poziom wcięcia.

note: type: textblock
en: 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.
pl: Struktura takich elementów nie powinna być zmieniana. Tekst akapitu nie będzie zawijany i nie zostaną dodane żadne kosmetyczne dodatkowe spacje czy znaki nowej linii.

note: type: textblock
en: Tags not needing to be closed.
pl: Elementy nie muszą być zamknięte.

note: type: textblock
en: 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.
pl: Elementy ignorowane i uznawane przez po4a za zwykłe dane znakowe. Mogą być one częścią msgid. Na przykład E<lt>bE<gt> jest dobrym kandydatem do tej kategorii, ponieważ dodanie go w sekcji translate stworzyłoby msgid, nie będące całymi zdaniami, co niewątpliwie jest złe.

note: type: textblock
en: 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.
pl: Rozdzielona spacjami lista atrybutów, które muszą być przetłumaczone. Można określić atrybuty przez ich nazwę (na przykład "lang"), ale można także użyć hierarchii elementów jako przedrostków, tak aby określić, że ten atrybut będzie przetłumaczony tylko wtedy, gdy należy do podanego elementu. Na przykład: E<lt>bbbE<gt>E<lt>aaaE<gt>lang określa, że atrybut lang będzie przetłumaczony tylko wtedy, gdy występuje w elemencie E<lt>aaaE<gt>, który z kolei jest zawarty w elemencie E<lt>bbbE<gt>. Nazwy elementów są tak naprawdę wyrażeniami regularnymi, tak więc można przykładowo użyć E<lt>aaa|bbbbE<gt>lang do przetłumaczenia tylko tych atrybutów lang, które są zawarte w elementach E<lt>aaaE<gt> lub E<lt>bbbE<gt>.

note: type: textblock
en: 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.
pl: Rozdzielona spacjami lista atrybutów, których tłumaczenia muszą być łączone z nazwą atrybutu. Proszę zauważyć, że ta opcja automatycznie doda podany atrybut do listy "attributes".

note: type: textblock
en: Proceed even if the DTD is unknown or if onsgmls finds errors in the input file.
pl: Kontynuowanie działania, nawet gdy DTD nie jest znany lub gdy onsgmls wykryje błędy w pliku wejściowym.

note: type: textblock
en: 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...
pl: Domyślnie, msgid zawierające tylko jedną encję (jak "&version;") są pomijane, zapewniając komfort tłumaczowi. Aktywowanie tej opcji uniemożliwia tę optymalizację. Może być jednak użyteczne, gdy dokument zawiera konstrukcje takie, jak "<title>&Aacute;</title>", choć prawdę mówiąc, wątpię, by takie coś się mogło kiedykolwiek zdarzyć...

note: type: textblock
en: 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.
pl: Rozdzielona spacjami lista encji, które nie będą włączane. Tej opcji należy używać ostrożnie: może spowodować, że onsgmls (używany wewnętrznie przez ten moduł) doda elementy i wygeneruje niepoprawny dokument wyjściowy.

note: type: textblock
en: The result is perfect. I.e., the generated documents are exactly the same. But there are still some problems:
pl: Wynik jest doskonały. Tj. wygenerowane dokumenty są dokładnie takie same. Jednak wciąż jest parę problemów:

note: type: textblock
en: 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}>.
pl: Problemem jest to, że musiałem "ochronić" warunkowe włączenia (rzeczy takie jak C<E<lt>! [ %foo [> i C<]]E<gt>>) w onsgmls. W przeciwnym razie onsgmls je zjada, a nie mam pojęcia jak je przywrócić w końcowym dokumencie. Aby temu zapobiec, przepisałem je jako {PO4A-beg-coś}> i C<{PO4A-end}>.

note: type: textblock
en: 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.
pl: Działa to tylko z DTD DebianDoc i DocBook. Dodanie obsługi nowego DTD powinno być bardzo proste. Mechanizm jest taki sam dla każdego DTD, po prostu należy podać listę istniejących elementów i ich charakterystykę.

note: type: textblock
en: I agree, this needs some more documentation, but it is still considered as beta, and I hate to document stuff which may/will change.
pl: Zgadzam się, to wymaga dokładniejszej dokumentacji, jednak jest to wciąż wersja beta, a ja nienawidzę dokumentowania rzeczy, które się mogą zmienić i zmienią.

note: type: textblock
en: 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.
pl: Ostrzeżenie: obsługa DTD jest całkiem eksperymentalna. Nie przeczytałem żadnego podręcznika, żeby znaleźć definicje każdego elementu. Dodałem definicje elementów, które działają dla kilku dokumentów znalezionych w sieci. Jeśli Twój dokument używa więcej elementów niż mój, nie będzie działał. Jak napisałem wyżej, poprawienie tego powinno być proste.

note: type: textblock
en: 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.
pl: Testowałem DocBook tylko na dokumencie SAG (System Administrator Guide), jednak jest on całkiem spory, więc powinien używać większości rzeczy specyficznych dla tego formatu.

note: type: textblock
en: For DebianDoc, I tested some of the manuals from the DDP, but not all yet.
pl: Dla DebianDoc, przetestowałem kilka podręczników z DDP, ale jeszcze nie wszystkie.

note: type: textblock
en: In case of file inclusion, string reference of messages in PO files (i.e. lines like C<#: en/titletoc.sgml:9460>) will be wrong.
pl: W razie dołączania plików odnośniki do komunikatów wiadomości w plikach PO (tj. linie jak C<#: en/titletoc.sgml:9460>) będą niepoprawne.

note: type: textblock
en: 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.
pl: Dzieje się tak dlatego, że wstępnie przetwarzam ten plik, aby ochronić warunkowe włączenia (rzeczy takie jak C<E<lt>! [ %foo [> i C<]]E<gt>>) oraz niektóre encja (jak &version) przed onsgmls ponieważ chcę je otrzymać bez zmian w wygenerowanym dokumencie. Dlatego, tworzę tymczasową kopię pliku wejściowego i na niej robię wszystkie zmiany przed przekazaniem go programowi onsgmls do przetwarzania.

note: type: textblock
en: 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.
pl: Żeby to działało, zamieniam encje proszące o włączenie pliku zawartością podanego pliku (dlatego mogę ochronić to, co trzeba, także w plikach włączanych). Ale do tej pory nic nie jest robione, aby poprawić później odnośniki (tj. nazwę pliku i numer linii). Nie jestem pewien, jak można by to najlepiej zrobić.

note: type: textblock
en: This module is an adapted version of sgmlspl (SGML postprocessor for the ONSGMLS parser) which was:
pl: Moduł jest zaadaptowaną wersją sgmlspl (postprocesora SGML parsera ONSGMLS), który był:

note: type: textblock
en: The adaptation for po4a was done by:
pl: Adaptacji do po4a dokonali:

note: type: textblock
en: 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.
pl: Locale::Po4a::TeX jest modułem ułatwiającym tłumaczenie dokumentacji w formacie TeX do innych języków [używanych przez ludzi].

note: type: textblock
en: Users should probably use the LaTeX module, which inherits from the TeX module and contains the definitions of common LaTeX commands.
pl: Użytkownicy najprawdopodobniej powinni używać modułu LaTeX, który dziedziczy z modułu TeX i zawiera definicję częstych poleceń LaTeX.

note: type: =head1
en: TRANSLATING WITH PO4A::TEX
pl: TŁUMACZENIE Z POMOCĄ PO4A::TEX

note: type: textblock
en: 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).
pl: Tego modułu można bezpośrednio użyć do obsługi ogólnych dokumentów w formacie TeX. Podzieli on dokument na mniejsze bloki (akapity, bloki dosłowych tekstów, a nawet jeszcze mniejsze jak tytuły czy indeksy).

note: type: textblock
en: Comma-separated list of environments which should not be re-wrapped.
pl: Rozdzielona przecinkami lista środowisk, które nie powinny być powtórnie zawijane.

note: type: textblock
en: Note that there is a difference between verbatim and no_wrap environments.  There is no command and comments analysis in verbatim blocks.
pl: Proszę zauważyć, że środowiska verbatim i no_wrap się różnią. W blokach verbatim nie są analizowane polecenia ani komentarze.

note: type: textblock
en: If this environment was not already registered, po4a will consider that this environment does not take any parameters.
pl: Jeżeli środowisko nie było wcześniej zarejestrowane, to po4a założy, że to środowisko nie potrzebuje żadnych parametrów.

note: type: textblock
en: Colon-separated list of files that should not be included by \input and \include.
pl: Rozdzielona dwukropkami lista plików, które nie powinny być włączane przez \input i \include.

note: type: textblock
en: Comma-separated list of environments which should be taken as verbatim.
pl: Rozdzielona przecinkami lista środowisk, które powinny być przetwarzane tak, jak zostały podane.

note: type: textblock
en: 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:
pl: Działanie modułu TeX może być zmieniane za pomocą linii zaczynających się od B<% po4a:>, które są interpretowane jako polecenia parsera. Rozpoznawane są następujące polecenia:

note: type: =item
en: B<% po4a: command> I<command1> B<alias> I<command2>
pl: B<% po4a: command> I<polecenie1> B<alias> I<polecenie2>

note: type: textblock
en: Indicates that the arguments of the I<command1> command should be treated as the arguments of the I<command2> command.
pl: Mówi, że argumenty polecenia I<polecenie1> powinny być traktowane jako argumenty polecenia I<polecenie2>.

note: type: =item
en: B<% po4a: command> I<command1> I<parameters>
pl: B<% po4a: polecenie> I<polecenie1> I<parametry>

note: type: textblock
en: You can precede the I<command1> command by
pl: Polecenie I<polecenie1> może być poprzedzone przez następujące znaki:

note: type: =item
en: an asterisk (B<*>)
pl: gwiazdka (B<*>)

note: type: textblock
en: 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.
pl: po4a wyciągnie to polecenie z akapitów (jeśli jest umieszczone na początku lub na końcu akapitu). Tłumacze będą musieli wtedy przetłumaczyć te parametry, które są oznaczone jako odpowiednie do tłumaczenia.

note: type: =item
en: a plus (B<+>)
pl: plus (B<+>)

note: type: textblock
en: Note: In this case you don't have to specify which parameters are translatable, but po4a must know the type and number of parameters.
pl: Uwaga: w tym przypadku nie trzeba określać, które parametry należy tłumaczyć, ale po4a musi znać typ i liczbę parametrów.

note: type: =item
en: a minus (B<->)
pl: minus (B<->)

note: type: textblock
en: 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.
pl: W takim wypadku, polecenie nie zostanie wydobyte z żadnego bloku. Ale jeżeli pojawi się samodzielnie w bloku, to tłumaczowi zostaną pokazane tylko te parametry, które zostały zaznaczone jako możliwe do przetłumaczenia. Polecenia te zazwyczaj nie powinny być wydzielane z ich akapitów (aby zachować kontekst), ale nie ma żadnego powodu, żeby męczyć tłumacza nimi, jeśli cały komunikat jest zawarty w takim poleceniu.

note: type: verbatim
en: The I<parameters> argument is a set of [] (to indicate an optional
    argument) or {} (to indicate a mandatory argument).
    You can place an underscore (_) between these brackets to indicate that
    the parameter must be translated. For example:
     % po4a: command *chapter [_]{_}
pl: Argument I<parameters> jest zbiorem nawiasów [] (określających argumenty
    opcjonalne) lub {} (określających argumenty wymagane).
    Aby wskazać, że parametr ma zostać przetłumaczony, można pomiędzy
    tymi nawiasami umieścić znak podkreślenia (_). Na przykład:
     % po4a: command *chapter [_]{_}

note: type: verbatim
en: This indicates that the chapter command has two parameters: an optional
    (short title) and a mandatory one, which must both be translated.
    If you want to specify that the href command has two mandatory parameters,
    that you don't want to translate the URL (first parameter), and that you
    don't want this command to be separated from its paragraph (which allow
    the translator to move the link in the sentence), you can use:
     % po4a: command -href {}{_}
pl: To wskazuje, że polecenie chapter ma dwa parametry: opcjonalny
    (krótki tytuł) i obowiązkowy, oba muszą być przetłumaczone.
    Aby określić, że polecenie href ma dwa wymagane parametry,
    oraz że pierwszy z nich (URL) ma nie być przetłumaczony, oraz
    że polecenie to ma nie być oddzielone od otaczającego go akapitu
    (co pozwala tłumaczowi zmienić pozycję linku w zdaniu), można użyć:
     % po4a: command -href {}{_}

note: type: textblock
en: In this case, the information indicating which arguments must be translated is only used if a paragraph is only composed of this href command.
pl: W tym wypadku informacja wskazująca, które argumenty muszą być przetłumaczone jest używana tylko wtedy, gdy akapit jest utworzony tylko z tej komendy href.

note: type: =item
en: B<% po4a: environment> I<env> I<parameters>
pl: B<% po4a: environment> I<środowisko> I<parametery>

note: type: textblock
en: 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.
pl: Tak jak dla poleceń I<środowisko> może być poprzedzone plusem (+), aby wskazać, że polecenie \begin musi być przetłumaczone wraz ze wszystkimi jego argumentami.

note: type: =item
en: B<% po4a: separator> I<env> B<">I<regex>B<">
pl: B<% po4a: separator> I<środowisko> B<">I<wyrażenie_regularne>B<">

note: type: textblock
en: Indicates that an environment should be split according to the given regular expression.
pl: Wskazuje, że środowisko powinno być podzielone zgodnie z podanym wyrażeniem regularnym.

note: type: textblock
en: For example, the LaTeX module uses the "(?:&|\\\\)" regular expression to translate separately each cell of a table (lines are separated by '\\' and cells by '&').
pl: Na przykład moduł LaTeX używa wyrażenia regularnego "(?:&|\\\\)" , aby osobno przetłumaczyć każdą komórkę tabeli (linie są rozdzielone przez '\\' a komórki przez '&').

note: type: =item
en: B<% po4a: verbatim environment> I<env>
pl: B<% po4a: verbatim environment> I<środowisko>

note: type: textblock
en: Indicate that I<env> is a verbatim environment.  Comments and commands will be ignored in this environment.
pl: Określa, że I<środowisko> jest środowiskiem dosłownym,tj. takim, w którym wszelkie komentarze i polecenia są ignorowane.

note: type: =head1
en: WRITING DERIVATE MODULES
pl: PRACA Z MODUŁAMI POCHODNYMI

note: type: textblock
en: Wrapper around Transtractor's translate, with pre- and post-processing filters.
pl: Funkcje opakowujące translate TransTractora  filtrami uruchamianymi przed przetwarzaniem i po nim.

note: type: textblock
en: Comments of a paragraph are inserted as a PO comment for the first translated string of this paragraph.
pl: Komentarze akapitu są wstawiane jako komentarz PO dla pierwszego tłumaczonego komunikatu dla tego akapitu.

note: type: textblock
en: This function returns:
pl: Funkcja zwraca:

note: type: =item
en: A command name
pl: Nazwę polecenia

note: type: textblock
en: 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.
pl: Jeżeli na początku podanego bufora nie znaleziono żadnego polecenia, tekst będzie pusty. Są brane pod uwagę tylko te polecenia, które można rozdzielić. Hash %separated_command zawiera ich listę.

note: type: =item
en: A variant
pl: Wariant

note: type: textblock
en: 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.
pl: Określa użyty wariant. Na przykład gwiazdka (*) może być dodana na końcu sekcji poleceń, aby określić że nie powinny być numerowane. W tym przypadku pole to będzie zawierać "*". Jeśli wariant nie istnieje, pole będzie pustym łańcuchem znaków.

note: type: =item
en: An array of tuples (type of argument, argument)
pl: Tablicę par  (typ argumentu, argument)

note: type: textblock
en: The type of argument can be either '{' (for mandatory arguments) or '[' (for optional arguments).
pl: Typem argumentu może być albo "{" (dla argumentów wymaganych), albo "[" (dla argumentów opcjonalnych).

note: type: =item
en: The remaining buffer
pl: Pozostały bufor

note: type: textblock
en: 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.
pl: Reszta bufora po usunięciu początkowego polecenia i jego argumentów. Jeśli nie znaleziono polecenia, oryginalny bufor jest zwracany niezmieniony w tym polu.

note: type: textblock
en: The same as B<get_leading_command>, but for commands at the end of a buffer.
pl: To samo co, B<get_leading_command>, ale dla poleceń z końca bufora.

note: type: textblock
en: Recursively translate a buffer by separating leading and trailing commands (those which should be translated separately) from the buffer.
pl: Rekurencyjnie tłumaczy bufor, wydzielając z niego początkowe i końcowe polecenia (które powinny być tłumaczone oddzielnie).

note: type: textblock
en: 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().
pl: Jeżeli w bieżącym środowisku zmienna %translate_buffer_env zawiera definicję funkcji, to ta funkcja zostanie użyta zamiast translate_buffer() do przetłumaczenia zawartości bufora.

note: type: textblock
en: Overloads Transtractor's read().
pl: Przeładowanie funkcji read() TransTractora.

note: type: textblock
en: 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.
pl: Rekurencyjnie czyta plik, dodając te pliki włączane, które nie są wymienione w tablicy @exclude_include. Plik włączane są wyszukiwane poleceniem B<kpsewhich> z biblioteki Kpathsea.

note: type: textblock
en: Except from the file inclusion part, it is a cut and paste from Transtractor's read.
pl: Poza częścią włączania plików, jest to przekopiowane z funkcji read TransTractora.

note: type: textblock
en: Subroutine for parsing a file with po4a directives (definitions for new commands).
pl: Procedura parsowania pliku zawierającego dyrektywę po4a (definicje nowych poleceń).

note: type: textblock
en: Parse a definition line of the form "% po4a: ".
pl: Przetwarza linię definicji w formacie "% po4a: ".

note: type: textblock
en: See the B<INLINE CUSTOMIZATION> section for more details.
pl: Dalsze informacje można znaleźć w sekcji B<DOSTOSOWYWANIE ZA POMOCĄ OPCJI W PLIKU ŹRÓDŁOWYM>.

note: type: =head1
en: INTERNAL FUNCTIONS used to write derivative parsers
pl: FUNKCJE WEWNĘTRZNE, używane do pisania parserów

note: type: textblock
en: Command and environment functions take the following arguments (in addition to the $self object):
pl: Funkcje poleceń i środowiska pobierają następujące argumenty (oraz dodatkowo obiekt $self):

note: type: =item
en: An array of (type, argument) tuples
pl: Tablica krotek (typ, argument)

note: type: =item
en: The current environment
pl: Bieżące środowisko

note: type: textblock
en: The first 3 arguments are extracted by get_leading_command or get_trailing_command.
pl: Pierwsze 3 argumenty są wyodrębniane przez get_leading_command lub get_trailing_command.

note: type: textblock
en: Command and environment functions return the translation of the command with its arguments and a new environment.
pl: Funkcje poleceń i środowiska zwracają tłumaczenia poleceń z jego argumentami i nowe środowisko.

note: type: textblock
en: Environment functions are called when a \begin command is found. They are called with the \begin command and its arguments.
pl: Funkcje środowiska są wywoływane, jeśli znaleziono polecenie \begin. Są one wywoływane z poleceniem \begin i jego argumentami.

note: type: textblock
en: The TeX module only proposes one command function and one environment function: generic_command and generic_environment.
pl: Moduł TeX proponuje tylko jedną funkcję poleceń i jedną funkcję środowiska: generic_command i generic_environment.

note: type: verbatim
en: generic_command uses the information specified by
    register_generic_command or by adding definition to the TeX file:
     % po4a: command I<command1> I<parameters>
pl: generic_command używa informacji podanych przez 
    register_generic_command albo przez dodanie definicji w pliku TeX:
     % po4a: command I<polecenie1> I<parametry>

note: type: verbatim
en: generic_environment uses the information specified by
    register_generic_environment or by adding definition to the TeX file:
     % po4a: environment I<env> I<parameters>
pl: generic_environment używa informacji podanych przez 
    register_generic_environment albo przez dodanie definicji w pliku TeX:
     % po4a: environment I<środowisko> I<parametery>

note: type: textblock
en: 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]).
pl: Obie funkcje tylko przetłumaczą parametry, które były określone jako możliwe do tłumaczenie (z ""). generic_environment doda nazwę środowiska do stosu środowiska, a generic_command doda nazwę polecenia, po której nastąpi identyfikator parametru (jak {#7} lub [#2]).

note: type: textblock
en: This module needs more tests.
pl: Moduł powinien być bardziej przetestowany.

note: type: textblock
en: It was tested on a book and with the Python documentation.
pl: Było testowany na książce z dokumentacją Pythona.

note: type: =head1
en: TODO LIST
pl: LISTA RZECZY DO ZROBIENIA

note: type: =item
en: Automatic detection of new commands
pl: Automatyczne wykrywanie nowych poleceń

note: type: textblock
en: 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.
pl: Moduł TeX mógłby sparsować argumenty nowego polecenia i spróbować odgadnąć liczbę i typy argumentów oraz czy powinny być tłumaczone, czy też nie.

note: type: =item
en: Translation of the environment separator
pl: Tłumaczenie separatora środowiska

note: type: textblock
en: When \item is used as an environment separator, the item argument is attached to the following string.
pl: Kiedy jako separatora środowiska użyje się \item, to jego argument jest dołączany do następującego łańcucha znaków.

note: type: =item
en: Some commands should be added to the environment stack
pl: Niektóre polecenia powinny być dodane do stosu środowiska.

note: type: =item
en: Others
pl: Inne

note: type: textblock
en: Various other points are tagged TODO in the source.
pl: Różne inne punkty są oznaczone w źródłach jako "TODO", czyli do zrobienia.

note: type: =head1
en: KNOWN BUGS
pl: ZNANE BŁĘDY

note: type: textblock
en: Various points are tagged FIXME in the source.
pl: Różne punkty są oznaczone w źródłach jako "FIXME", czyli do poprawienia.

note: type: textblock
en: Locale::Po4a::Texinfo - convert Texinfo documents and derivates from/to PO files
pl: Locale::Po4a::Texinfo - konwersja dokumentów Texinfo i pochodnych z/do plików PO

note: type: textblock
en: Locale::Po4a::Texinfo is a module to help the translation of Texinfo documents into other [human] languages.
pl: Locale::Po4a::Texinfo jest modułem ułatwiającym tłumaczenie dokumentów w formacie Texinfo do innych języków [używanych przez ludzi].

note: type: textblock
en: This module contains the definitions of common Texinfo commands and environments.
pl: Moduł zawiera definicje wspólnych poleceń i środowisk Texinfo.

note: type: textblock
en: Locale::Po4a::Text - convert text documents from/to PO files
pl: Locale::Po4a::Text - konwersja dokumentów tekstowych z/do plików PO

note: type: textblock
en: Locale::Po4a::Text is a module to help the translation of text documents into other [human] languages.
pl: Locale::Po4a::Text jest modułem ułatwiającym tłumaczenie dokumentów tekstowych do innych języków [używanych przez ludzi].

note: type: textblock
en: Paragraphs are split on empty lines (or lines containing only spaces or tabulations).
pl: Akapity są dzielone na pustych liniach (lub liniach zawierających tylko spacje lub tabulacje).

note: type: textblock
en: If a paragraph contains a line starting by a space (or tabulation), this paragraph won't be rewrapped.
pl: Jeżeli akapit zawiera linię zaczynającą się od spacji (lub tabulacji), to nie będzie zmieniane zawijanie tekstu w tym akapicie.

note: type: =item
en: B<tabs=>I<mode>
pl: B<tabs=>I<tryb>

note: type: textblock
en: Specify how tabulations shall be handled. The I<mode> can be any of:
pl: Określa sposób obsługi znaków tabulacji. I<tryb> może być jednym z:

note: type: textblock
en: Lines with tabulations introduce breaks in the current paragraph.
pl: Linie zawierające tabulacje przerywają bieżący akapit.

note: type: textblock
en: Paragraph containing tabulations will not be re-wrapped.
pl: Akapit zawierający tabulacje nie będzie zawijany.

note: type: textblock
en: By default, tabulations are considered as spaces.
pl: Domyślnie, znaki tabulacji są uważane za spacje.

note: type: =item
en: B<breaks=>I<regex>
pl: B<breaks=>I<wyrażenie_regularne>

note: type: textblock
en: A regular expression matching lines which introduce breaks.  The regular expression will be anchored so that the whole line must match.
pl: Wyrażenie regularne, którego dopasowanie powoduje przerywanie akapitów. Wyrażenie to musi pasować do całej linii tekstu.

note: type: textblock
en: Handle the fortunes format, which separate fortunes with a line which consists in '%' or '%%', and use '%%' as the beginning of a comment.
pl: Obsługuje format pliku fortunes, w którym poszczególne fortunki rozdzielane są liniami składającymi się z "%" lub "%%" oraz "%%" oznacza początek komentarza.

note: type: textblock
en: Handle some special markup in Markdown-formatted texts.
pl: Obsługuje niektóre specjalne znaczniki tekstów sformatowanych jako Markdown.

note: type: textblock
en: Handle control files.  A comma-separated list of tags to be translated can be provided.
pl: Obsługuje pliki kontrolne. Można podać rozdzieloną przecinkami listę elementów do przetłumaczenia.

note: type: textblock
en: Tested successfully on simple text files and NEWS.Debian files.
pl: Pomyślnie przetestowany na kilku prostych plikach tekstowych oraz plikach NEWS.Debian.

note: type: textblock
en: Locale::Po4a::TransTractor - generic trans(lator ex)tractor.
pl: Locale::Po4a::TransTractor - ogólny moduł wyodrębniania tłumaczeń.

note: type: textblock
en: 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.
pl: Ta klasa jest przodkiem wszystkich parserów po4a używanych do przetwarzania dokumentu w poszukiwaniu komunikatów do przetłumaczenia, wyodrębniania ich do pliku PO oraz zastępowania ich tłumaczeniami w wyjściowym dokumencie.

note: type: textblock
en: More formally, it takes the following arguments as input:
pl: Bardziej formalnie mówiąc, przyjmuje następujące argumenty jako wejście:

note: type: textblock
en: a document to translate;
pl: dokument do przetłumaczenia;

note: type: textblock
en: a PO file containing the translations to use.
pl: plik PO zawierający tłumaczenia do użycia.

note: type: textblock
en: As output, it produces:
pl: Jako wynik dostajemy:

note: type: textblock
en: another PO file, resulting of the extraction of translatable strings from the input document;
pl: inny plik PO, czego wynikiem jest wyciągnięcie komunikatów możliwych do przetłumaczenia z dokumentu wejściowego;

note: type: textblock
en: 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.
pl: przetłumaczony dokument o takiej samej strukturze, co dokument wejściowy, ale ze wszystkimi komunikatami możliwymi do przetłumaczenia zamienionymi na tłumaczenia znalezione w wejściowym pliku PO.

note: type: textblock
en: Here is a graphical representation of this:
pl: Graficzna reprezentacja tego procesu:

note: type: verbatim
en:    Input document --\                             /---> Output document
                         \                           /       (translated)
                          +-> parse() function -----+
                         /                           \
       Input PO --------/                             \---> Output PO
                                                             (extracted)
pl:    Dokument wejściowy --\                          /--> Dokument wyjściowy
                             \                        /     (przetłumaczony)
                              +-> funkcja parse() ---+
                             /                        \
       Wejściowy PO --------/                          \--> Wyjściowy PO
                                                            (wyodrębniony)

note: type: =head1
en: FUNCTIONS YOUR PARSER SHOULD OVERRIDE
pl: FUNKCJE, KTÓRE TWÓJ PARSER POWINIEN NADPISAĆ

note: type: textblock
en: 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.
pl: Jest to miejsce, gdzie odbywa się cała praca: parsowanie dokumentów wejściowych, generowanie wyjścia, wyodrębnianie komunikatów do przetłumaczenia. Jest to bardzo proste, jeśli użyje się funkcji opisanych poniżej, w sekcji B<FUNKCJE WEWNĘTRZNE>. Patrz także sekcja B<SKŁADNIA>, zawierająca przykład.

note: type: textblock
en: 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.
pl: Ta funkcja jest wywoływana przez poniższą funkcję proces(), ale jeżeli wybierze się użycie funkcji new() i ręczenie się doda zawartość do dokumentu, trzeba będzie wywołać tę funkcję samemu.

note: type: textblock
en: 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.
pl: Funkcja zwraca nagłówek, który powinien zostać dodany do wygenerowanego dokumentu, odpowiednio przygotowany, tak żeby mógł być komentarzem w języku docelowym. Aby dowiedzieć się, do czego to służy, proszę przeczytać sekcję B<Przekazywanie deweloperom wiedzy o tłumaczeniu> w L<po4a(7)|po4a.7>.

note: type: textblock
en: 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.
pl: Następujący przykład przetwarza listę akapitów rozpoczynających się od "<p>". Dla uproszczenia, zakładamy, że dokument jest dobrze sformatowany, tj. występują tylko elementy "<p>" i są one umieszczone na samym początku każdego akapitu.

note: type: verbatim
en:    PARAGRAPH: while (1) {
           my ($paragraph,$pararef)=("","");
           my $first=1;
           my ($line,$lref)=$self->shiftline();
           while (defined($line)) {
               if ($line =~ m/<p>/ && !$first--; ) {
                   # Not the first time we see <p>.
                   # Reput the current line in input,
                   #  and put the built paragraph to output
                   $self->unshiftline($line,$lref);
pl:    PARAGRAPH: while (1) {
           my ($paragraph,$pararef)=("","");
           my $first=1;
           my ($line,$lref)=$self->shiftline();
           while (defined($line)) {
               if ($line =~ m/<p>/ && !$first--; ) {
                   # Nie po raz pierwszy widzimy <p>.
                   # Włóż z powrotem bieżącą linię do wejścia,
                   #  i dodaj zbudowany akapit do wyjścia
                   $self->unshiftline($line,$lref);

note: type: verbatim
en:                # Now that the document is formed, translate it:
                   #   - Remove the leading tag
                   $paragraph =~ s/^<p>//s;
pl:                # Teraz, gdy dokument jest sformatowany, przetłumaczmy go:
                   #   - Usunięcie początkowych tagów
                   $paragraph =~ s/^<p>//s;

note: type: verbatim
en:                next PARAGRAPH;
               } else {
                   # Append to the paragraph
                   $paragraph .= $line;
                   $pararef = $lref unless(length($pararef));
               }
pl:                next PARAGRAPH;
               } else {
                   # Dodanie do akapitu
                   $paragraph .= $line;
                   $pararef = $lref unless(length($pararef));
               }

note: type: verbatim
en:            # Reinit the loop
               ($line,$lref)=$self->shiftline();
           }
           # Did not get a defined line? End of input file.
           return;
       }
     }
pl:            # Ponowna inicjacja pętli
               ($line,$lref)=$self->shiftline();
           }
           # Nie dostaliśmy zdefiniowanej linii? Koniec pliku wejściowego.
           return;
       }
     }

note: type: textblock
en: Once you've implemented the parse function, you can use your document class, using the public interface presented in the next section.
pl: Po zaimplementowaniu funkcji parsującej, można użyć własnych klas dokumentu, używając publicznego interfejsu zaprezentowanego w następnym rozdziale.

note: type: =head1
en: PUBLIC INTERFACE for scripts using your parser
pl: INTERFEJS PUBLICZNY dla skryptów używających Twojego parsera

note: type: =head2
en: Constructor
pl: Konstruktor

note: type: textblock
en: 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:
pl: Funkcja zrobi  w jednym uruchomieniu wszystko, co tylko trzeba zrobić z dokumentem po4a. Jej argumenty muszą być umieszczone w hashu. AKCJE:

note: type: textblock
en: Reads all the PO files specified in po_in_name
pl: Czyta wszystkie pliki określone w po_in_name

note: type: textblock
en: Reads all original documents specified in file_in_name
pl: Czyta wszystkie oryginalne dokumenty określone w file_in_name

note: type: textblock
en: Parses the document
pl: Przetwarza (parsuje) dokument

note: type: textblock
en: Reads and applies all the addenda specified
pl: Dodaje i stosuje wszystkie podane załączniki

note: type: textblock
en: Writes the translated document to file_out_name (if given)
pl: Zapisuje przetłumaczony dokument do file_out_name (jeśli podano)

note: type: textblock
en: Writes the extracted PO file to po_out_name (if given)
pl: Zapisuje wygenerowany plik PO do po_out_name (jeśli podano)

note: type: textblock
en: ARGUMENTS, beside the ones accepted by new() (with expected type):
pl: ARGUMENTY, poza tymi akceptowanymi przez new() (z oczekiwanym typem):

note: type: textblock
en: List of filenames where we should read the input document.
pl: Lista nazw plików, z których powinniśmy odczytać plik wejściowy.

note: type: textblock
en: Charset used in the input document (if it isn't specified, it will try to detect it from the input document).
pl: Kodowanie znaków dokumentu wejściowego (jeśli nie podano, nastąpi próba określenia kodowania z dokumentu wejściowego).

note: type: textblock
en: Filename where we should write the output document.
pl: Nazwa pliku, do którego należy zapisać wynikowy dokument.

note: type: textblock
en: Charset used in the output document (if it isn't specified, it will use the PO file charset).
pl: Kodowanie znaków wyjściowego dokumentu (jeśli nie podano, będzie użyte kodowanie znaków pliku PO).

note: type: textblock
en: List of filenames where we should read the input PO files from, containing the translation which will be used to translate the document.
pl: Lista nazw plików, z których powinniśmy odczytać wejściowe pliki PO zawierające tłumaczenia, które będą użyte podczas tłumaczenia dokumentu.

note: type: textblock
en: Filename where we should write the output PO file, containing the strings extracted from the input document.
pl: Nazwa pliku, do którego powinien być zapisany wynikowy plik PO, zawierający komunikaty wyciągnięte z dokumentu wejściowego.

note: type: textblock
en: List of filenames where we should read the addenda from.
pl: Lista nazw plików, z których powinniśmy odczytać pliki załączników.

note: type: textblock
en: Charset for the addenda.
pl: Kodowanie znaków załączników.

note: type: textblock
en: Sets the verbosity.
pl: Ustawia gadatliwość.

note: type: textblock
en: Sets the debugging.
pl: Ustawia debugowanie.

note: type: =head2
en: Manipulating document files
pl: Manipulowanie plikami z dokumentacją

note: type: textblock
en: 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.
pl: Proszę zauważyć, że to niczego nie przetwarza. Należy użyć funkcji parse() po zakończeniu pakowania plików wejściowych do dokumentu.

note: type: textblock
en: Write the translated document to the given filename.
pl: Zapisuje przetłumaczony dokument do pliku o podanej nazwie.

note: type: =head2
en: Manipulating PO files
pl: Manipulowanie plikami PO

note: type: textblock
en: Add the content of a file (which name is passed as argument) to the existing input PO. The old content is not discarded.
pl: Dodaje zawartość pliku (którego nazwa jest podawana w argumencie) do istniejącego pliku wejściowego PO. Stara zawartość nie jest tracona.

note: type: textblock
en: Write the extracted PO file to the given filename.
pl: Zapisuje wygenerowany plik PO do pliku o podanej nazwie.

note: type: textblock
en: 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:
pl: Zwraca statystyki dotyczące tłumaczeń. Proszę zauważyć, że nie są to te same statystyki, które wypisuje msgfmt --statistic. Tutaj są to statystyki o obecnym wykorzystaniu pliku PO, podczas gdy msgfmt wyświetla status tego pliku. Funkcja jest opakowaniem funkcji Locale::Po4a::Po::stats_get  zastosowanej do wejściowego pliku PO. Przykład użycia:

note: type: verbatim
en:     [normal use of the po4a document...]
pl:     [zwykłe użycie dokumentu po4a ...]

note: type: verbatim
en:     ($percent,$hit,$queries) = $document->stats();
        print "We found translations for $percent\%  ($hit from $queries) of strings.\n";
pl:     ($percent,$hit,$queries) = $document->stats();
        print "Znaleźliśmy tłumaczenia $percent\% ($hit z $queries) komunikatów.\n";

note: type: =head2
en: Manipulating addenda
pl: Manipulowanie załącznikami

note: type: textblock
en: 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 ;)
pl: Więcej informacji o tym, czym są załączniki, i jak tłumacze powinni je pisać, można znaleźć w L<po4a(7)|po4a.7>. Aby dodać załącznik do przetłumaczonego dokumentu, wystarczy po prostu tej funkcji przekazać nazwę pliku, w którym się znajduje, i gotowe ;)

note: type: textblock
en: This function returns a non-null integer on error.
pl: Funkcja zwraca liczbę nie będącą nullem lub błąd.

note: type: =head2
en: Getting input, providing output
pl: Pobieranie wejścia, dostarczanie wyjścia

note: type: textblock
en: Four functions are provided to get input and return output. They are very similar to shift/unshift and push/pop of Perl.
pl: Dostarczone są cztery funkcje pobierania wejścia i zwracania wyjścia. Są one bardzo podobne do shift/unshift i push/pop w Perlu.

note: type: textblock
en: 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.
pl: Pierwsza para dotyczy wejścia, a druga - wyjścia. Mnemonik: w wejściu interesuje Cię pierwsza linia, co daje shift, a w wyjściu chcesz dostać wynik na końcu, tak jak do robi push.

note: type: =head2
en: Marking strings as translatable
pl: Zaznaczanie łańcuchów znaków jako możliwych do przetłumaczenia

note: type: textblock
en: One function is provided to handle the text which should be translated.
pl: Dostarczona jest jedna funkcja obsługująca tekst, który powinien być przetłumaczony.

note: type: textblock
en: Mandatory arguments:
pl: Argumenty obowiązkowe:

note: type: textblock
en: A string to translate
pl: Łańcuch znaków do przetłumaczenia

note: type: textblock
en: The reference of this string (i.e. position in inputfile)
pl: Odnośnik tego komunikatu (tj. pozycja w pliku wejściowym)

note: type: textblock
en: 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?>)
pl: Typ tego komunikatu (tj. tekstowy opis jego roli w strukturze; używany w Locale::Po4a::Po::gettextization(); patrz także L<po4a(7)|po4a.7>, sekcja B<Proces przekształcania do formatu gettext: jak to działa?>)

note: type: textblock
en: This function can also take some extra arguments. They must be organized as a hash. For example:
pl: Funkcja przyjmuje także kilka dodatkowych argumentów. Muszą być zorganizowane jako hash. Na przykład:

note: type: textblock
en: 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.
pl: flaga logiczna określająca, czy traktujemy białe znaki w komunikacie jako nieistotne. Jeśli tak, to funkcja przed wyszukaniem lub wyciągnięciem tłumaczenia kanonizuje komunikat, a następnie zawija tekst tłumaczenia.

note: type: textblock
en: an extra comment to add to the entry.
pl: dodatkowy komentarz do dodania do wpisu.

note: type: textblock
en: Actions:
pl: Akcje:

note: type: textblock
en: Pushes the string, reference and type to po_out.
pl: Dodaje nowy komunikat, odnośnik i typ do po_out.

note: type: textblock
en: Returns the translation of the string (as found in po_in) so that the parser can build the doc_out.
pl: Zwraca tłumaczenie tekstu (znalezione w po_in), tak że parser może zbudować doc_out.

note: type: textblock
en: Handles the charsets to recode the strings before sending them to po_out and before returning the translations.
pl: Obsługuje kodowania znaków, aby zmienić kodowanie komunikatów przed wysłaniem do po_out i przed zwróceniem tłumaczeń.

note: type: =head2
en: Misc functions
pl: Różne funkcje

note: type: textblock
en: Returns if the verbose option was passed during the creation of the TransTractor.
pl: Zwraca informację, czy podczas uruchomienia TransTractora, podano opcję verbose.

note: type: textblock
en: Returns if the debug option was passed during the creation of the TransTractor.
pl: Zwraca informację, czy podczas uruchomienia TransTractora podano opcję debug.

note: type: textblock
en: 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.
pl: Mówi TransTractorowi, że w dokumencie źródłowym wykryto nowe kodowanie znaków (podane jako pierwszy argument wywołania). Zwykle kodowanie może być odczytane z nagłówka dokumentu. Pozostawione będzie tylko pierwsze kodowanie znaków, pochodzące albo z argumentów funkcji process(), albo z dokumentu.

note: type: textblock
en: 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).
pl: Funkcja zwraca kodowanie znaków, które powinno być użyte w dokumencie wyjściowym (zazwyczaj użyteczne do zamienienia wykrytego kodowania znaków dokumentu wejściowego, tam gdzie został znaleziony).

note: type: textblock
en: 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.
pl: Użyje wyjściowego kodowania znaków podanego w linii poleceń. Jeśli go nie podano, użyje kodowania znaków wejściowego pliku PO, a jeżeli jako to kodowanie w pliku był ustawiony domyślny tekst "CHARSET", to zwróci kodowanie znaków wejściowego dokumentu, tak że nie zostanie przeprowadzona żadna konwersja kodowań.

note: type: textblock
en: 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.
pl: Funkcja zwraca tekst przekazany jako argument przekodowany z kodowania znaków dokumentu wejściowego na kodowanie znaków dokumentu wyjściowego. Nie jest to potrzebne podczas tłumaczenia komunikatu (translate() wszystko przekodowuje samodzielnie), ale wtedy, gdy pominięto komunikat z dokumentu wejściowego, a dokument wyjściowy powinien mieć spójne kodowanie znaków.

note: type: =head1
en: FUTURE DIRECTIONS
pl: DALSZE WSKAZÓWKI

note: type: textblock
en: One shortcoming of the current TransTractor is that it can't handle translated document containing all languages, like debconf templates, or .desktop files.
pl: Mankamentem obecnego TransTractora jest brak obsługi dokumentów zawierających wszystkie języki naraz, jak na przykład szablony debconf lub pliki .desktop.

note: type: textblock
en: To address this problem, the only interface changes needed are:
pl: Aby rozwiązać ten problem, jedynymi potrzebnymi zmianami w interfejsie są:

note: type: textblock
en: take a hash as po_in_name (a list per language)
pl: pobieranie hasha jak po_in_name (lista dla języka)

note: type: textblock
en: add an argument to translate to indicate the target language
pl: dodawanie argumentu do przetłumaczenia, wskazując język docelowy

note: type: textblock
en: Will see if it's enough ;)
pl: Zobaczymy, czy to wystarczy ;)

note: type: textblock
en: Locale::Po4a::Wml - convert WML (web markup language) documents from/to PO files
pl: Locale::Po4a::Wml - konwersja dokumentów WML (web markup language) z/do plików PO

note: type: textblock
en: 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.
pl: Locale::Po4a::XML jest modułem ułatwiającym tłumaczenie dokumentów WML do innych języków [używanych przez ludzi]. Proszę nie mylić WML, o który tu jest mowa (web markup language) z tandetnym WAP-em używanym w telefonach komórkowych.

note: type: textblock
en: 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.
pl: Proszę zauważyć, że ten moduł zależy od modułu Locale::Po4a::Xhtml, który z kolei zależy od Locale::Po4a::Xml. Oznacza to, że zakłada się, że wszystkie znaczniki wyrażeń stron web używają składni XHTML.

note: type: textblock
en: 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.
pl: Moduł ten działa dla niektórych prostych dokumentów, chociaż wciąż jest jeszcze nowy. Obecnie największym problemem modułu jest najprawdopodobniej brak obsługi dokumentów zawierających włączane znaczniki nie-XML-owe, takie jak<email "bla@przyklad.org">, które często są definiowane w WML-u. Zostanie to ulepszone w kolejnych wersjach modułu.

note: type: textblock
en: Locale::Po4a::Xhtml - convert XHTML documents from/to PO files
pl: Locale::Po4a::Xhtml - konwersja dokumentów XHTML z/do plików PO

note: type: textblock
en: Locale::Po4a::Xhtml is a module to help the translation of XHTML documents into other [human] languages.
pl: Locale::Po4a::Xhtml jest modułem ułatwiającym tłumaczenie dokumentów w formacie XHTML do innych języków [używanych przez ludzi].

note: type: textblock
en: Include files specified by an include SSI (Server Side Includes) element (e.g. <!--#include virtual="/foo/bar.html" -->).
pl: Włącza pliki określone przez element "include" SSI (Server Side Includes) (np. <!--#include virtual="/foo/bar.html" -->).

note: type: textblock
en: B<Note:> You should use it only for static files.
pl: B<Uwaga>: Powinno się używać tej opcji tylko dla plików statycznych.

note: type: textblock
en: An additional I<rootpath> parameter can be specified. It specifies the root path to find files included by a B<virtual> attribute.
pl: Można podać dodatkowy parametr I<rootpath>, określający ścieżkę bazową, w której będą poszukiwane pliki dołączane za pomocą atrybutu B<virtual>.

note: type: textblock
en: Locale::Po4a::Xml - convert XML documents and derivates from/to PO files
pl: Locale::Po4a::Xml - konwersja dokumentów XML i pochodnych z/do plików PO

note: type: textblock
en: 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.
pl: Locale::Po4a::XML jest modułem ułatwiającym tłumaczenie dokumentów XML do innych języków [używanych przez ludzi].

note: type: =head1
en: TRANSLATING WITH PO4A::XML
pl: TŁUMACZENIE Z POMOCĄ PO4A::XML

note: type: textblock
en: 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.
pl: Tego modułu można użyć bezpośrednio do obsługi ogólnych dokumentów w formacie XML. Wyciągnie on zawartość wszystkich elementów, bez żadnych atrybutów, ponieważ to właśnie w elementach jest zapisywany tekst w większości dokumentów opartych na XML-u.

note: type: textblock
en: 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.
pl: Istnieje kilka opcji (opisanych w następnej sekcji), które mogą dostosować  zachowanie do Twoich wymagań. Jeśli nie pasuje ono do formatu Twojego dokumentu, zachęcamy do napisania własnego modułu dziedziczącego z tego, opisującego szczegóły formatu. Szczegóły można znaleźć w sekcji B<PRACA ZMODUŁAMI POCHODNYMI> poniżej.

note: type: textblock
en: The global debug option causes this module to show the excluded strings, in order to see if it skips something important.
pl: Globalna opcja debug powoduje, że ten moduł pokaże wyłączone komunikaty, aby móc sprawdzić, czy przypadkiem nie pomija czegoś istotnego.

note: type: textblock
en: Prevents it to strip the spaces around the extracted strings.
pl: Uniemożliwia usuwanie spacji otaczających wyodrębnione komunikaty.

note: type: textblock
en: 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.
pl: Kanonizuje komunikaty do przetłumaczenia, przyjmując, że spacje nie są ważnie i tylko służą do zawijania przetłumaczonego dokumentu. Tę opcję można nadpisać opcjami dotyczącymi własnych elementów. Patrz opis opcji B<translated> poniżej.

note: type: textblock
en: 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.
pl: Powoduje, że elementy i atrybuty są wyszukiwane z pominięciem rozpoznawania wielkości liter. Jeśli jest to zdefiniowane, to E<lt>BooKE<gt>laNG i E<lt>BOOKE<gt>Lang zostaną potraktowane tak samo jak E<lt>bookE<gt>lang.

note: type: textblock
en: See also: https://developer.android.com/guide/topics/resources/string-resource.html
pl: Patrz także: https://developer.android.com/guide/topics/resources/string-resource.html

note: type: textblock
en: 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.
pl: Jeżeli zdefiniowano, zewnętrzne encje są dołączane do wygenerowanego (przetłumaczonego) dokumentu oraz do wyodrębnionych łańcuchów znaków. Jeżeli nie zdefiniowano, będzie trzeba przetłumaczyć zewnętrzne encje jako niezależne dokumenty.

note: type: textblock
en: This is the default value.  The module will exit with an error.
pl: Jest to domyślna wartość. Działanie modułu zakończy się błędem.

note: type: textblock
en: The module will continue, and will issue a warning.
pl: Moduł wyświetli ostrzeżenie i będzie kontynuował działanie.

note: type: textblock
en: The module will continue without any warnings.
pl: Moduł będzie kontynuował bez wypisywania żadnych ostrzeżeń.

note: type: textblock
en: Be careful when using this option.  It is generally recommended to fix the input file.
pl: Proszę zachować ostrożność, używając tej opcji. Rekomendowanym zachowaniem jest poprawienie pliku wejściowego.

note: type: textblock
en: Note: This option is deprecated.
pl: Uwaga: Opcja ta jest przestarzała.

note: type: textblock
en: 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.
pl: Łańcuch znaków, który będziemy próbowali dopasować do pierwszej linii typu dokumentu (doctype; jeśli zdefiniowany). Jeśli nie pasuje, to zostanie wypisane ostrzeżenie, że dokument może mieć niepoprawny typ.

note: type: textblock
en: 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.
pl: Łańcuch znaków oznaczający ścieżkę (np. E<lt>bbbE<gt>E<lt>aaaE<gt>)) znacznika, do którego powinien zostać dodany atrybut lang="..." . Język jest zdefiniowany jako nazwa bazowa pliku PO z usuniętym rozszerzeniem .po.

note: type: textblock
en: Note: This option is deprecated.  You should use the B<translated> and B<untranslated> options instead.
pl: Uwaga: Opcja ta jest przestarzała. Prosimy zamiast niej używać opcji B<translated> i B<untranslated>.

note: type: textblock
en: 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.
pl: Rozdzielona spacjami lista elementów, które mają być przetłumaczone lub opuszczone. Domyślnie podane elementy będę opuszczone, ale użycie opcji "tagsonly" oznacza, że podane elementy będą jedynymi elementami włączonymi. Elementy muszą mieć postać E<lt>aaaE<gt>, jednak można połączyć kilka z nich (E<lt>bbbE<gt>E<lt>aaaE<gt>), aby określić, że zawartość elementu E<lt>aaaE<gt> będzie przetłumaczona tylko wtedy, gdy sam element jest zawarty w elemencie E<lt>bbbE<gt>.

note: type: textblock
en: Example: WE<lt>chapterE<gt>E<lt>titleE<gt>
pl: Przykład: WE<lt>chapterE<gt>E<lt>titleE<gt>

note: type: textblock
en: 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.
pl: Rozdzielona spacjami lista atrybutów elementów, które należy tłumaczyć. Można podać atrybuty, używając ich nazwy (na przykład "lang"), ale także można poprzedzić je hierarchią elementów, aby powiedzieć, że ten atrybut będzie tłumaczony tylko wtedy. gdy jest zawarty w określonym elemencie. Na przykład E<lt>bbbE<gt>E<lt>aaaE<gt>lang mówi, że atrybut lang zostanie przetłumaczony, tylko jeżeli jest zawarty w elemencie E<lt>aaaE<gt>, który jest w elemencie E<lt>bbbE<gt>.

note: type: textblock
en: Do not translate attributes in inline tags.  Instead, replace all attributes of a tag by po4a-id=<id>.
pl: Nie tłumaczy atrybutów elementów włączanych. Zamiast tego zastępuje wszystkie atrybuty elementu przez po4a-id=<id>.

note: type: textblock
en: This is useful when attributes shall not be translated, as this simplifies the strings for translators, and avoids typos.
pl: Jest to użyteczne w przypadku atrybutów, które nie powinny być tłumaczone -  upraszcza komunikaty do tłumaczenia i zapobiega pomyłkom tłumaczy.

note: type: textblock
en: 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.
pl: Rozdzielona spacjami lista elementów, które nie powinny być traktowane jako elementy.Tagi te są traktowane jako włączane i nie muszą być zamykane.

note: type: textblock
en: Space-separated list of tags which should break the sequence.  By default, all tags break the sequence.
pl: Rozdzielona spacjami lista elementów, które powinny przerwać sekwencję. Domyślnie wszystkie elementy przerywają sekwencję.

note: type: textblock
en: 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>).
pl: Elementu muszą być w postaci <aaa>, można je jednak połączyć (<bbb><aaa>), jeżeli dany element (<aaa>) powinien być rozpatrywany tylko wtedy, gdy znajduje się w innym elemencie (<bbb>).

note: type: textblock
en: Space-separated list of tags which should be treated as inline.  By default, all tags break the sequence.
pl: Rozdzielona spacjami lista elementów, które powinny zostać potraktowane jako włączane. Domyślnie wszystkie elementy przerywają sekwencję.

note: type: textblock
en: 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.
pl: Rozdzielona spacjami lista elementów, które powinny zostać potraktowane jako wypełniacze miejsca (placeholder). Wypełniacze miejsca nie przerywają sekwencji, jednak ich zawartość jest tłumaczona osobno.

note: type: textblock
en: The location of the placeholder in its block will be marked with a string similar to:
pl: Położenie wypełniaczy miejsca w bloku będzie oznaczone łańcuchem znaków podobnym do:

note: type: textblock
en: Space separated list of tags that the module should not try to set by default in any category.
pl: Rozdzielona spacjami lista elementów, których moduł nie powinien próbować domyślnie umieszczać jakiejkolwiek kategorii.

note: type: textblock
en: 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).
pl: Wspiera dyrektywy preprocesora C. Jeśli opcja zostanie włączona, po4a będzie przetwarzał dyrektywy preprocesora jako separatory akapitów. Jest to ważne, jeśli plik XML jest przetwarzany przez preprocesor, ponieważ jeśli nie użyje się tej opcji, a dyrektywy preprocesora trafią w środek linii, to po4a przyjmie, ża należą do bieżącego paragramu, co spowoduje, że preprocesor ich już nie rozpozna. Uwaga: dyrektywy preprocesora muszą być umieszczone między elementami (nie mogą rozdzielać elementu).

note: type: textblock
en: Space-separated list of tags you want to translate.
pl: Rozdzielona spacjami lista elementów do przetłumaczenia.

note: type: textblock
en: Tags should be translated and content can be re-wrapped.
pl: Elementy powinny być przetłumaczone i można zmienić formatowanie zawartości.

note: type: textblock
en: Tags should be translated and content should not be re-wrapped.
pl: Elementy powinny być tłumaczone, ale nie można zmieniać formatowania ich zawartości.

note: type: textblock
en: Tags should be translated inline.
pl: Elementy powinny tłumaczone jako włączane.

note: type: textblock
en: Tags should be translated as placeholders.
pl: Elementy powinny być tłumaczone jako wypełniacze miejsca.

note: type: textblock
en: Space-separated list of tags you do not want to translate.
pl: Rozdzielona spacjami lista elementów, które nie mają być tłumaczone.

note: type: textblock
en: The default categories for tags that are not in any of the translated, untranslated, break, inline, or placeholder.
pl: Domyślne kategorie tych elementów które nie są tłumaczone (translated), nietłumaczone (untranslated), przerywaczami (break), włączane (inline), ani wypełniaczami miejsca (placeholder).

note: type: =head1
en: WRITING DERIVATIVE MODULES
pl: PRACA Z MODUŁAMI POCHODNYMI

note: type: =head2
en: DEFINE WHAT TAGS AND ATTRIBUTES TO TRANSLATE
pl: DEFINIOWANIE ELEMENTÓW I ATRYBUTÓW DO PRZETŁUMACZENIA

note: type: textblock
en: 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:
pl: Najprostszą zmianą jest zdefiniowanie elementów i atrybutów, które parser ma przetłumaczyć. Powinno być to zrobione w funkcji initialize. Najpierw trzeba wywołać główną funkcję initialize, aby otrzymać opcje linii poleceń, a następnie dodać własne definicje do hasha opcji. Aby obsłużyć nowe opcje w linii poleceń, trzeba je zdefiniować przed wywołaniem głównej funkcji initialize:

note: type: textblock
en: See L<Locale::Po4a::Docbook(3pm)|Locale::Po4a::Docbook>,
pl: Patrz L<Locale::Po4a::Docbook(3pm)|Locale::Po4a::Docbook>,

note: type: =head2
en: OVERRIDING THE found_string FUNCTION
pl: NADPISYWANIE FUNKCJI found_string

note: type: textblock
en: 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.
pl: Innym prostym krokiem jest nadpisanie funkcji "found_string", która otrzymuje od parsera wyciągnięte komunikaty do przetłumaczenia. Tutaj można kontrolować, które komunikaty tłumaczyć, oraz przeprowadzić na nich transformacje zarówno przed tłumaczeniem, jak i po nim.

note: type: textblock
en: 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.
pl: Otrzymuje wyodrębniony tekst, odnośnik do miejsca jego znalezienia i hash zawierające dodatkowe informacje kontrolujące, które komunikaty są do przetłumaczenia, jak je przetłumaczyć i jak wygenerować komentarz.

note: type: textblock
en: The content of these options depends on the kind of string it is (specified in an entry of this hash):
pl: Zawartość tych opcji zależy od rodzaju łańcucha znaków (podanego we rekordzie tego hasha):

note: type: textblock
en: 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.
pl: Znaleziony łańcuch znaków jest zawartością elementu, który można przetłumaczyć. Wpis "tag_options" zawiera znaki opcji wyciągnięte z początku hierarchii elementów z opcji "tags" modułu.

note: type: textblock
en: Means that the found string is the value of a translatable attribute. The entry "attribute" has the name of the attribute.
pl: Oznacza, że znaleziony tekst jest wartością atrybutu możliwego do tłumaczenia. Wpis "attribute" zawiera nazwę atrybutu.

note: type: textblock
en: It must return the text that will replace the original in the translated document. Here's a basic example of this function:
pl: Funkcja musi zwrócić tekst zastępujący w tłumaczonym dokumencie tekst oryginalny. Podstawowy przykład takiej funkcji:

note: type: textblock
en: There's another simple example in the new Dia module, which only filters some strings.
pl: Kolejny prosty przykład można znaleźć w nowym module Dia, który tylko filtruje niektóre łańcuchy znaków.

note: type: =head2
en: MODIFYING TAG TYPES (TODO)
pl: MODYFIKOWANIE TYPÓW ELEMENTÓW (DO ZROBIENIA)

note: type: textblock
en: 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:
pl: Jest to jeden z bardziej złożonych procesów, ale pozwala na (prawie) całkowite dostosowanie do własnych potrzeb. Jest oparty na liście hashów, z których każdy określa sposób zachowania się typu elementu. Lista powinna być posortowana, tak że elementy bardziej ogólne występują po bardziej szczegółowych (posortowanych najpierw po kluczach początkowych, a potem końcowych). Aby zdefiniować typ elementu, trzeba utworzyć hash zawierający następujące klucze:

note: type: textblock
en: Specifies the beginning of the tag, after the "E<lt>".
pl: Określa początek elementu, po "E<lt>".

note: type: textblock
en: Specifies the end of the tag, before the "E<gt>".
pl: Określa koniec elementu, przed "E<gt>".

note: type: textblock
en: 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.
pl: Mówi, że jest to klasa elementów rozdzielających. Element nierozdzielający (inline) jest to taki element, które może być pobrany jako zawartość innego elementu. Może to przyjmować wartości false (0), true (1) lub undefinded. Jeśli zostanie jako undefined, to trzeba będzie zdefiniować funkcje f_breaking, mówiącą, czy podany element tej klasy jest elementem rozdzielającym, czy też nie.

note: type: textblock
en: 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.
pl: Jest to funkcja, która powie, czy następny element jest elementem zamykającym, czy też nie. Powinna być zdefiniowana, jeśli nie zdefiniowano opcji B<breaking>.

note: type: textblock
en: 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.
pl: Jeśli wartością tego klucza pozostanie undefined, to ogólne funkcje wyodrębniające będą musiały wyodrębnić ten element samodzielnie. Jest to użyteczne dla elementów, które mogą zawierać w sobie inne elementy lub specjalne struktury, tak żeby główny parser nie oszalał. Funkcja otrzymuje flagę logiczną mówiącą, czy element powinien zostać usunięty z wejściowego strumienia, czy też nie.

note: type: textblock
en: 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.
pl: Funkcja otrzymuje element (w formacie get_string_until() ) i zwraca przetłumaczony element (przetłumaczone atrybuty lub wszystkie potrzebne transformacje) jako pojedynczy łańcuch znaków.

note: type: =head2
en: WORKING WITH TAGS
pl: PRACA Z ELEMENTAMI

note: type: textblock
en: 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>.
pl: Funkcja zwraca ścieżkę bieżącego elementu od korzenia dokumentu w formacie E<lt>htmlE<gt>E<lt>bodyE<gt>E<lt>pE<gt>.

note: type: textblock
en: An additional array of tags (without brackets) can be passed as argument.  These path elements are added to the end of the current path.
pl: Jako argument można przekazać dodatkową tablicę elementów (bez nawiasów). Elementy te zostaną dołączone na końcu bieżącej ścieżki.

note: type: textblock
en: 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.
pl: Funkcja zwraca indeks z listy tag_types, który odpowiada następnemu elementowi ze strumienia wejściowego, lub -1 gdy dotarła do końca pliku wejściowego.

note: type: textblock
en: 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.
pl: Funkcja zwraca następny element ze strumienia wejściowego bez początku i końca, w postaci tablicy i zarządza odnośnikami do pliku wejściowego. Przyjmuje dwa parametry: typ elementu (zwrócone przez tag_type) i wartość logiczną, określającą, czy element powinien zostać usunięty ze strumienia wejściowego.

note: type: textblock
en: This function returns the name of the tag passed as an argument, in the array form returned by extract_tag.
pl: Funkcja zwraca nazwę następnego elementu przekazanego jako argument w formie tablicy zwracanej przez extract_tag.

note: type: textblock
en: 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.
pl: Funkcja zwraca wartość logiczną, która mówi, czy następny element jest elementem rozdzielającym, czy nie (element inline). Nie zmienia strumienia wejściowego.

note: type: textblock
en: This function translates the next tag from the input stream.  Using each tag type's custom translation functions.
pl: Funkcja tłumaczy następny element z źródłowego strumienia, używając do tego własnych funkcji każdego typu elementu.

note: type: textblock
en: 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).
pl: Funkcja zwraca wartość będącą łańcuchem znaków, mówiącą, czy jej pierwszy argument (hierarchia elementów) pasuje do któregokolwiek elementu jej drugiego argumentu (lista elementów lub hierarchii elementów). Zwraca 0, jeśli nie pasuje. W przeciwnym razie zwraca opcje dopasowanego elementy (znaki z początku elementu) lub 1 (jeśli element nie miał opcji).

note: type: =head2
en: WORKING WITH ATTRIBUTES
pl: PRACA Z ATRYBUTAMI

note: type: =head2
en: WORKING WITH THE MODULE OPTIONS
pl: PRACA Z OPCJAMI MODUŁU

note: type: textblock
en: 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).
pl: Funkcja wypełnia wewnętrzne struktury zawierające elementy, atrybuty i dane włączane wraz z opcjami modułu (podanymi w linii poleceń lub w funkcji initialize).

note: type: =head2
en: GETTING TEXT FROM THE INPUT DOCUMENT
pl: POBIERANIE TEKSTU Z PLIKU WEJŚCIOWEGO

note: type: textblock
en: 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.
pl: Funkcja zwraca tablicę z liniami (i odnośnikami) z wejściowego dokumentu dopóki nie znajdzie pierwszego argumentu. Drugim argumentem jest hash opcji. Wartość 0 oznacza wyłączenie (domyślnie), a 1 - włączenie.

note: type: textblock
en: The valid options are:
pl: Poprawne opcje:

note: type: textblock
en: This makes the returned array to contain the searched text
pl: Powoduje, że zwracana tablica zawiera szukany tekst.

note: type: textblock
en: This removes the returned stream from the input
pl: Usuwa zwrócony strumień z wejścia

note: type: textblock
en: This ensures that the searched text is outside any quotes
pl: Zapewnia, że szukany tekst nie jest umieszczony w cudzysłowach.

note: type: textblock
en: 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.
pl: Funkcja otrzymuje jako argument odnośnik do akapitu (w formacie zwróconym przez get_string_until), pomija spacje nagłówka i zwraca prosty łańcuch znaków.

note: type: textblock
en: This function returns a simple string with the text from the argument array (discarding the references).
pl: Funkcja zwraca prosty łańcuch znaków zawierający tekst z tablicy argumentu (odrzucając odnośniki).

note: type: textblock
en: This module can translate tags and attributes.
pl: Ten moduł umożliwia tłumaczenie elementów i atrybutów.

note: type: textblock
en: DOCTYPE (ENTITIES)
pl: DOCTYPE (ENCJE)

note: type: textblock
en: 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.
pl: Istnieje minimalna obsługa tłumaczeń encji. Są one tłumaczone jako całość, a elementy nie są brane pod uwagę. Encje wieloliniowe  nie są wspierane, a podczas tłumaczenia tekst encji jest zawsze zawijany.

note: type: textblock
en: MODIFY TAG TYPES FROM INHERITED MODULES (move the tag_types structure inside the $self hash?)
pl: MODYFIKOWANIE TYPÓW ELEMENTÓW ODZIEDZICZONYCH MODUŁÓW (przenieść strukturę tag_types do hasha $self?)
