
        *****************************************************
        *           GENERATED FILE, DO NOT EDIT             *
        * THIS IS NO SOURCE FILE, BUT RESULT OF COMPILATION *
        *****************************************************

This file was generated by po4a(7). Do not store it (in VCS, for example),
but store the PO file used as source file by po4a-translate.

In fact, consider this as a binary, and the PO file as a regular .c file:
If the PO get lost, keeping this translation up-to-date will be harder.

=encoding UTF-8

=head1 NAZWA

Locale::Po4a::Pod - konwersja danych POD z/do plików PO

=head1 SKŁADNIA

    use Locale::Po4a::Pod;
    my $parser = Locale::Po4a::Pod->new (sentence => 0, width => 78);

    # Czytanie POD ze STDIN i zapisanie do STDOUT.
    $parser->parse_from_filehandle;

    # Czytanie POD z plik.pod i zapisanie do plik.txt.
    $parser->parse_from_file ('plik.pod', 'plik.txt');

=head1 OPIS

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].

=head1 STATUS MODUŁU

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:

  C<" #n">

Niestety, w wersji z po4a zostało to rozdzielone na spacji podczas zawijania. W wyniku, oryginalna strona podręcznika zawiera

 " #n"

a przetłumaczona zawiera

 "" #n""

co jest logiczne, skoro CE<lt>cośtamE<gt> jest przepisane jako "cośtam".

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





=head1 STRUKTURY WEWNĘTRZNE

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().

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:

=over 4

=item B<alt>

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.

=item B<code>

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.

=item B<indent>

Liczba spacji wcinania zwykłego tekstu i domyślne wcinanie bloków B<=over>. Domyślnie 4.

=item B<loose>

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.

=item B<quotes>

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.

Może to także przyjmować na specjalną wartość B<none>, określającą, że tekst CE<lt>> nie zostanie otoczony znakami cudzysłowu.

=item B<sentence>

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.

=item B<width>

Numer kolumny, według której zawijać tekst po jego prawej stronie. Domyślnie jest to 76.

=back

=head1 ZOBACZ TAKŻE

L<Pod::Parser>, L<Locale::Po4a::Man(3pm)>, L<Locale::Po4a::TransTractor(3pm)>, L<po4a(7)|po4a.7>

=head1 AUTORZY

 Denis Barbier <barbier@linuxfr.org>
 Martin Quinson (mquinson#debian.org)


=head1 TŁUMACZENIE

 Robert Luberda <robert@debian.org>

=head1 PRAWA AUTORSKIE I LICENCJA

Copyright © 2002 SPI, Inc.

Program jest wolnym oprogramowaniem; można go redystrybuować i/lub modyfikować zgodnie z warunkami licencji GPL (patrz plik COPYING).

