help2man-texi 1.47.17 - en to pl translation catalogue (164 entries)

note: type: settitle
en: @command{help2man} Reference Manual
pl: Podręcznik do programu @command{help2man}

note: type: dircategory
en: Software development
pl: Rozwijanie oprogramowania

note: type: menuentry
en: Automatic manual page generation.
pl: Automatyczne tworzenie stron podręcznika man.

note: type: copying
en: This file documents the GNU @command{help2man} command which produces simple manual pages from the @samp{--help} and @samp{--version} output of other commands.
pl: Ten plik opisuje polecenie GNU @command{help2man}, tworzące proste strony podręcznika man z wyjścia @samp{--help} oraz @samp{--version} innych poleceń.

note: type: titlepage
en: Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice and this permission notice are preserved on all copies.
pl: Zezwala się na tworzenie i rozprowadzanie dokładnych kopii tego podręcznika, pod warunkiem zachowania we wszystkich kopiach informacji o prawach autorskich oraz niniejszej informacji.

note: type: titlepage
en: Permission is granted to copy and distribute modified versions of this manual under the conditions for verbatim copying, provided that the entire resulting derived work is distributed under the terms of a permission notice identical to this one.
pl: Zezwala się na kopiowanie i rozprowadzanie zmodyfikowanych wersji tego podręcznika na takich warunkach, jak dokładnych kopii, pod warunkiem, że całe dzieło pochodne jest rozprowadzanie na warunkach takich samych, jak niniejsze.

note: type: titlepage
en: Permission is granted to copy and distribute translations of this manual into another language, under the above conditions for modified versions, except that this permission notice may be stated in a translation approved by the Foundation.
pl: Zezwala się na kopiowanie i rozprowadzanie tłumaczeń tego podręcznika na inny język na takich warunkach, jak wersje zmodyfikowane, z wyjątkiem tego, że niniejsze oświadczenie może wystąpić w tłumaczeniu zaaprobowanym przez Free Software Foundation.

note: type: subtitle
en: A utility for generating simple manual pages
pl: Narzędzie do generowania prostych stron podręcznika man

note: type: ifnottex
en: @command{help2man} produces simple manual pages from the @samp{--help} and @samp{--version} output of other commands.
pl: Polecenie @command{help2man} tworzy proste strony podręcznika man z wyjścia @samp{--help} oraz @samp{--version} innych poleceń.

note: type: node
en: Overview
pl: Przegląd

note: type: menuentry
en: Overview of @command{help2man}.
pl: Przegląd polecenia @command{help2man}.

note: type: node
en: Invoking help2man
pl: Uruchamianie help2man

note: type: menuentry
en: How to run @command{help2man}.
pl: Jak uruchomić polecenie @command{help2man}.

note: type: node
en: --help recommendations
pl: Zalecenia --help

note: type: menuentry
en: Recommended formatting for @samp{--help} output.
pl: Zalecenia dotyczące formatowania wyjścia @samp{--help}.

note: type: node
en: Including text
pl: Dołączanie tekstu

note: type: menuentry
en: Including additional text in the output.
pl: Dołączanie dodatkowego tekstu na wyjściu.

note: type: node
en: Makefile usage
pl: Użycie Makefile

note: type: menuentry
en: Using @command{help2man} with @command{make}.
pl: Użycie polecenia @command{help2man} z poziomu programu @command{make}.

note: type: node
en: Localised man pages
pl: Zlokalizowane strony man

note: type: menuentry
en: Producing native language manual pages.
pl: Tworzenie stron podręcznika man w języku ojczystym.

note: type: node
en: Example
pl: Przykład

note: type: menuentry
en: Example @command{help2man} output.
pl: Przykładowe wyjście polecenia @command{help2man}.

note: type: node
en: Reports
pl: Kontakt

note: type: menuentry
en: Reporting bugs or suggestions.
pl: Zgłaszanie błędów i propozycji.

note: type: node
en: Availability
pl: Dostępność

note: type: menuentry
en: Obtaining @command{help2man}.
pl: Pozyskiwanie programu @command{help2man}.

note: type: chapter
en: Overview of @command{help2man}
pl: Przegląd polecenia @command{help2man}

note: type: Plain text
en: @command{help2man} is a tool for automatically generating simple manual pages from program output.
pl: @command{help2man} to narzędzie do automatycznego generowania prostych stron podręcznika man z wyjścia programów.

note: type: Plain text
en: Although manual pages are optional for GNU programs other projects, such as Debian require them (@pxref{Man Pages, , , standards, GNU Coding Standards})
pl: Mimo że strony podręcznika man są opcjonalne dla programów GNU, inne projekty - takie jak Debian - wymagają ich (@pxref{Man Pages, , , standards, GNU Coding Standards})

note: type: Plain text
en: This program is intended to provide an easy way for software authors to include a manual page in their distribution without having to maintain that document.
pl: Ten program ma na celu zapewnienie autorom programów prostej metody dołączania stron podręcznika man bez potrzeby utrzymywania tego dokumentu.

note: type: Plain text
en: Given a program which produces reasonably standard @samp{--help} and @samp{--version} outputs, @command{help2man} can re-arrange that output into something which resembles a manual page.
pl: Po wskazaniu programu tworzącego w miarę standardowe opisy jako wyjście opcji @samp{--help} oraz @samp{--version}, polecenie @command{help2man} potrafi przekształcić te opisy w coś przypominającego stronę podręcznika.

note: type: chapter
en: How to Run @command{help2man}
pl: Jak uruchomić @command{help2man}

note: type: Plain text
en: The format for running the @command{help2man} program is:
pl: Składnia przy uruchamianiu programu @command{help2man} jest następująca:

note: type: example
en: @command{help2man} [@var{option}]@dots{} @var{executable}
pl: @command{help2man} [@var{opcja}]@dots{} @var{program}

note: type: Plain text
en: @command{help2man} supports the following options:
pl: @command{help2man} obsługuje następujące opcje:

note: type: item
en: -n @var{string}
pl: -n @var{łańcuch}

note: type: itemx
en: --name=@var{string}
pl: --name=@var{łańcuch}

note: type: table
en: Use @var{string} as the description for the @samp{NAME} paragraph of the manual page.
pl: Użycie @var{łańcucha} jako opisu dla akapitu @samp{NAZWA} strony podręcznika.

note: type: table
en: By default (for want of anything better) this paragraph contains @samp{manual page for @var{program} @var{version}}.
pl: Domyślnie (przy braku czegokolwiek lepszego) akapit ten zawiera @samp{strona podręcznika dla @var{program} @var{wersja}}.

note: Translators: the translated cross-reference "Including text" here must match the target (type: node) translation elsewhere in this file. type: table
en: This option overrides an include file @samp{[name]} section (@pxref{Including text}).
pl: Ta opcja nadpisuje sekcję pliku dołączanego @samp{[nazwa]} (@pxref{Dołączanie tekstu}).

note: type: item
en: -s @var{section}
pl: -s @var{sekcja}

note: type: itemx
en: --section @var{section}
pl: --section @var{sekcja}

note: type: table
en: Use @var{section} as the section for the man page.  The default section is 1.
pl: Użycie @var{sekcji} jako sekcji dla strony podręcznika man. Domyślną sekcją jest 1.

note: type: item
en: -m @var{manual}
pl: -m @var{podręcznik}

note: type: itemx
en: --manual=@var{manual}
pl: --manual=@var{podręcznik}

note: type: table
en: Set the name of the manual section to @var{section}, used as a centred heading for the manual page.  By default @samp{User Commands} is used for pages in section 1, @samp{Games} for section 6 and @samp{System Administration Utilities} for sections 8 and 1M.
pl: Ustawienie nazwy sekcji podręcznika na @var{podręcznik}; nazwa jest używana jako wyśrodkowany nagłówek na stronie podręcznika. Domyślnie używane nazwy to: @samp{Polecenia użytkownika} dla stron z sekcji 1, @samp{Gry} dla sekcji 6 oraz @samp{Narzędzia administracyjne} dla sekcji 8 oraz 1M.

note: type: item
en: -S @var{source}
pl: -S @var{źródło}

note: type: itemx
en: --source=@var{source}
pl: --source=@var{źródło}

note: type: table
en: The program source is used as a page footer, and often contains the name of the organisation or a suite of which the program is part.  By default the value is the package name and version.
pl: Źródło programu służy jako stopka strony, zwykle zawiera nazwę organizacji lub kolekcji, w której skład wchodzi program. Domyślnie wartość tego pola to nazwa i wersja pakietu.

note: type: item
en: -L @var{locale}
pl: -L @var{lokalizacja}

note: type: itemx
en: --locale=@var{locale}
pl: --locale=@var{lokalizacja}

note: Translators: the translated cross-reference "Localised man pages" here must match the target (type: node) translation elsewhere in this file. type: table
en: Select output locale (default @samp{C}).  Both the program and @command{help2man} must support the given @var{locale} (@pxref{Localised man pages}).
pl: Wybór lokalizacji wyjścia (domyślnie @samp{C}). Zarówno program, jak i @command{help2man} muszą obsługiwać podaną @var{lokalizację} (@pxref{Zlokalizowane strony man})

note: type: item
en: -i @var{file}
pl: -i @var{plik}

note: type: itemx
en: --include=@var{file}
pl: --include=@var{plik}

note: Translators: the translated cross-reference "Including text" here must match the  target (type: node) translation elsewhere in this file. type: table
en: Include material from @var{file} (@pxref{Including text}).
pl: Dołączenie treści z @var{pliku} (@pxref{Dołączanie tekstu}).

note: type: item
en: -I @var{file}
pl: -I @var{plik}

note: type: itemx
en: --opt-include=@var{file}
pl: --opt-include=@var{plik}

note: type: table
en: A variant of @samp{--include} for use in Makefile pattern rules which does not require @var{file} to exist.
pl: Wariant @samp{--include} do wykorzystania w regułach szablonów Makefile, nie wymagający istnienia @var{pliku}.

note: type: item
en: -o @var{file}
pl: -o @var{plik}

note: type: itemx
en: --output=@var{file}
pl: --output=@var{plik}

note: type: table
en: Send output to @var{file} rather than @code{stdout}.
pl: Zapis wyjścia do @var{pliku} zamiast na @code{standardowe wyjście}.

note: type: item
en: -p @var{text}
pl: -p @var{tekst}

note: type: itemx
en: --info-page=@var{text}
pl: --info-page=@var{tekst}

note: type: table
en: Name of Texinfo manual.
pl: Nazwa podręcznika Texinfo.

note: type: table
en: Suppress inclusion of a @samp{SEE ALSO} paragraph directing the reader to the Texinfo documentation.
pl: Pominięcie dołączania akapitu @samp{ZOBACZ TAKŻE} kierującego czytelnika do dokumentacji Texinfo.

note: type: table
en: Drop @file{lt-} prefix from instances of the program name in the synopsis (@command{libtool} creates wrapper scripts in the build directory which invoke @command{foo} as @command{.libs/lt-foo}).
pl: Pominięcie przedrostka @file{lt-} z wystąpień nazwy programu w sekcji składni (@command{libtool} tworzy skrypty obudowujące w katalogu budowania, wywołujące @command{foo} jako @command{.libs/lt-foo}).

note: type: table
en: Show help or version information.
pl: Wyświetlenie opisu lub informacji o wersji.

note: type: Plain text
en: By default @command{help2man} passes the standard @samp{--help} and @samp{--version} options to the executable although alternatives may be specified using:
pl: Domyślnie @command{help2man} przekazuje do programu wykonywalnego standardowe opcje @samp{--help} oraz @samp{--version}, ale można przekazać alternatywne nazwy przy użyciu opcji:

note: type: item
en: -h @var{option}
pl: -h @var{opcja}

note: type: itemx
en: --help-option=@var{option}
pl: --help-option=@var{opcja}

note: type: table
en: Help option string.
pl: Łańcuch określający opcję pomocy.

note: type: item
en: -v @var{option}
pl: -v @var{opcja}

note: type: itemx
en: --version-option=@var{option}
pl: --version-option=@var{opcja}

note: type: table
en: Version option string.
pl: Łańcuch określający opcję informacji o wersji.

note: type: item
en: --version-string=@var{string}
pl: --version-string=@var{łańcuch}

note: type: table
en: Version string.
pl: Łańcuch określający wersję.

note: type: table
en: Include stderr when parsing option output.
pl: Dołączenie standardowego wyjścia diagnostycznego przy analizie wyjścia z opcji.

note: type: chapter
en: @option{--help} Recommendations
pl: Zalecenia dotyczące opcji @option{--help}

note: type: Plain text
en: Here are some recommendations for what to include in your @option{--help} output.  Including these gives @command{help2man} the best chance at generating a respectable man page, as well as benefitting users directly.
pl: Poniżej można znaleźć trochę zaleceń, co powinno zawierać wyjście dla opcji @option{--help}. Uwzględnienie ich pozwala programowi @command{help2man} wygenerować możliwie najlepiej reprezentacyjną stronę man, a także bezpośrednio pomóc użytkownikom.

note: type: Plain text
en: See @ref{Command-Line Interfaces, , , standards, GNU Coding Standards} and @ref{Man Pages, , , standards, GNU Coding Standards}, for the official GNU standards relating to @option{--help} and man pages.
pl: Oficjalne standardy GNU dotyczące opcji @option{--help} oraz stron man można znaleźć w dokumentach: @ref{Command-Line Interfaces, , , standards, GNU Coding Standards} oraz @ref{Man Pages, , , standards, GNU Coding Standards}.

note: type: itemize
en: A synopsis of how to invoke the program.  If different usages of the program have different invocations, then list them all.  For example (edited for brevity):
pl: Streszczenie opisu składni, jak uruchamiać program. Jeśli różne sposoby użycia programu mają różne składnie, należy wypisać wszystkie. Na przykład (zmodyfikowane dla zwięzłości):

note: type: smallexample
en: Usage: cp [OPTION]... SOURCE DEST
      or:  cp [OPTION]... SOURCE... DIRECTORY
    @dots{}
pl: Składnia: cp [OPCJA]... ŹRÓDŁO CEL
        albo: cp [OPCJA]... ŹRÓDŁO... KATALOG
    @dots{}

note: type: itemize
en: Use @code{argv[0]} for the program name in these synopses, just as it is, with no directory stripping.  This is in contrast to the canonical (constant) name of the program which is used in @option{--version}.
pl: W opisie składni programu należy używać @code{argv[0]} w niezmienionej postaci, bez usuwania katalogu. Różni się to od kanonicznej (stałej) nazwy programu, używanej w wyjściu opcji @option{--version}.

note: type: itemize
en: A very brief explanation of what the program does, including default and/or typical behaviour.  For example, here is @command{cp}'s:
pl: Bardzo krótkie wyjaśnienie, co program robi, z uwzględnieniem zachowania domyślnego i/lub typowego. Na przykład, dla polecenia @command{cp}:

note: type: example
en: Copy SOURCE to DEST, or multiple SOURCE(s) to DIRECTORY.
pl: Skopiowanie ŹRÓDŁA do CELU lub ŹRÓDŁA/ŹRÓDEŁ do KATALOGU.

note: type: itemize
en: A list of options, indented to column 2.  If the program supports one-character options, put those first, then the equivalent long option (if any).  If the option takes an argument, include that too, giving it a meaningful name.  Align the descriptions in a convenient column, if desired.  Note that to be correctly recognised by @command{help2man} the description must be separated from the options by at least two spaces and descriptions continued on subsequent lines must start at the same column.
pl: Lista opcji z wcięciem do kolumny 2. Jeśli program obsługuje opcje jednoznakowe, należy umieścić je jako pierwsze, a po nich odpowiadające im opcje długie (jeśli istnieją). Jeśli opcja przyjmuje argument, należy go dołączyć, nadając mu znaczącą nazwę. Opisy można wyrównać do wygodnej kolumny. Uwaga: w celu poprawnego rozpoznania przez @command{help2man}, opisy muszą być oddzielone od opcji przynajmniej dwiema spacjami, a opisy kontynuowane w kolejnych liniach muszą zaczynać się od tej samej kolumny.

note: type: itemize
en: Here again is an (edited) excerpt from @command{cp}, showing a short option with an equivalent long option, a long option only, and a short option only:
pl: Poniżej (zmodyfikowany) fragment z polecenia @command{cp}, pokazujący opcję krótką z odpowiadającą jej opcją długą, opcję wyłącznie długą oraz opcję wyłącznie krótką:

note: type: smallexample
en:   -a, --archive                same as -dpR
          --backup[=CONTROL]       make a backup of each ...
      -b                           like --backup but ...
pl:   -a, --archive                to samo co -dpR
          --backup[=TRYB]          robienie kopii zapasowej każdego ...
      -b                           jak --backup, ale ...

note: type: itemize
en: For programs that take many options, it may be desirable to split the option list into sections such as @samp{Global}, @samp{Output control}, or whatever makes sense in the particular case.  It is usually best to alphabetise (by short option name first, then long) within each section, or the entire list if there are no sections.
pl: W przypadku programów przyjmujących wiele opcji, może być warto podzielić listę opcji na sekcje, takie jak na przykład @samp{Globalne}, @samp{Sterowanie wyjściem}, czy cokolwiek mającego sens w konkretnym przypadku. Zwykle najlepiej opcje wypisywać w kolejności alfabetycznej (najpierw dla opcji krótkich, potem długich) w ramach każdej sekcji, lub całej listy, jeśli nie ma sekcji.

note: type: itemize
en: Any useful additional information about program behaviour, such as influential environment variables, further explanation of options, etc.  For example, @command{cp} discusses @env{VERSION_CONTROL} and sparse files.
pl: Wszystkie przydatne dodatkowe informacje o zachowaniu programu, takie jak zmienne środowiskowe wpływające na działanie, dalsze wyjaśnienia opcji itp. - na przykład @command{cp} wyjaśnia zmienną @env{VERSION_CONTROL} oraz pliki rzadkie.

note: type: itemize
en: A few examples of typical usage, at your discretion.  One good example is usually worth a thousand words of description, so this is highly recommended.
pl: Kilka przykładów typowego użycia, wedle uznania. Jeden dobry przykład często warty jest tysiąca słów opisu, więc jest zalecany.

note: type: cindex
en: address for bug reports
pl: adres do zgłaszania błędów

note: type: cindex
en: bug reports
pl: zgłaszanie błędów

note: type: itemize
en: In closing, a line stating how to email bug reports.  Typically, @var{mailing-address} will be @samp{bug-@var{program}@@gnu.org}; please use this form for GNU programs whenever possible.  It's also good to mention the home page of the program, other mailing lists, etc.
pl: Na zakończenie linia oznajmująca, w jaki sposób zgłaszać błędy pocztą elektroniczną. Zwykle @var{adresem} będzie @samp{bug-@var{program}@@gnu.org}; proszę w miarę możliwości używać tej postaci dla programów GNU. Dobrze także wskazać stronę domową programu, inne listy pocztowe itp.

note: type: Plain text
en: The @code{argp} and @code{popt} programming interfaces let you specify option descriptions for @option{--help} in the same structure as the rest of the option definition; you may wish to consider using these routines for option parsing instead of @code{getopt}.
pl: Interfejsy programowe @code{argp} i @code{popt} pozwalają przekazać opisy opcji dla @option{--help} w tej samej strukturze, co reszta definicji opcji; można rozważyć użycie tych funkcji do analizy opcji zamiast funkcji @code{getopt}.

note: type: Plain text
en: By default @command{help2man} has some heuristics for identifying manual page sections: a line consisting of @samp{Options:} for example will cause the following text to appear in the @code{OPTIONS} section, and a line beginning with @samp{Copyright} will appear in the @code{COPYRIGHT} section.  Outside of these heuristics, a line consisting of @samp{*Words*} will start a new section, and @samp{Words:} a new sub-section.
pl: Domyślnie @command{help2man} stosuje heurystykę do identyfikowania części strony podręcznika: linia zawierająca @samp{Opcje:} spowoduje pojawienie się następującego po niej tekstu w sekcji @code{OPCJE}, a linia zaczynająca się od @samp{Copyright} pojawi się z sekcji @code{COPYRIGHT}. Niezależnie od tej heurystyki, linia zawierająca @samp{*Słowa*} rozpocznie nową sekcję, a @samp{Słowa:} nową podsekcję.

note: type: chapter
en: Including Additional Text in the Output
pl: Dołączanie do wyjścia dodatkowego tekstu

note: Translators: the translated cross-reference "Invoking help2man" here must match the  target (type: node) translation elsewhere in this file. type: Plain text
en: Additional static text may be included in the generated manual page by using the @samp{--include} and @samp{--opt-include} options (@pxref{Invoking help2man}).  While these files can be named anything, for consistency we suggest to use the extension @code{.h2m} for @command{help2man} include files.
pl: W wygenerowanej stronie można dołączyć dodatkowy statyczny tekst korzystając z opcji @samp{--include} oraz @samp{--opt-include} (@pxref{Uruchamianie help2man}). Chociaż pliki te mogą mieć dowolne nazwy, dla spójności sugerujemy dla plików dołączanych przez @command{help2man} używać rozszerzenia @code{.h2m}.

note: type: Plain text
en: The format for files included with these option is simple:
pl: Format plików dołączanych tymi opcjami jest prosty:

note: type: example
en: [section]
    text
pl: [sekcja]
    tekst

note: type: example
en: /pattern/
    text
pl: /wzorzec/
    tekst

note: type: Plain text
en: Blocks of verbatim *roff text are inserted into the output either at the start of the given @samp{[section]} (case insensitive), or after a paragraph matching @samp{/pattern/}.
pl: Bloki dosłownego tekstu *roff są wstawiane na wyjściu na początku wskazanej @samp{[sekcji]} (bez rozróżniania wielkości liter) lub po akapicie pasującym do @samp{/wzorca/}.

note: type: Plain text
en: Patterns use the Perl regular expression syntax and may be followed by the @samp{i}, @samp{s} or @samp{m} modifiers (@pxref{perlre, , perlre(1), *manpages*, The @code{perlre(1)} manual page})
pl: Wzorce wykorzystują składnię perlowych wyrażeń regularnych; mogą po nich wystąpić modyfikatory @samp{i}, @samp{s} lub @samp{m} (@pxref{perlre, , perlre(1), *manpages*, Strona podręcznika @code{perlre(1)}}).

note: type: Plain text
en: Lines before the first section or pattern which begin with @samp{-} are processed as options.  Anything else is silently ignored and may be used for comments, RCS keywords and the like.
pl: Linie przed pierwszą sekcją lub wzorcem, zaczynające się od @samp{-}, są przetwarzane jako opcje. Cała reszta jest po cichu ignorowana i może być wykorzystana jako komentarze, słowa kluczowe RCS itp.

note: type: Plain text
en: The section output order (for those included) is:
pl: Kolejność sekcji na wyjściu (w ramach sekcji obecnych) to:

note: type: example
en: NAME
    SYNOPSIS
    DESCRIPTION
    OPTIONS
    @emph{other}
    ENVIRONMENT
    FILES
    EXAMPLES
    AUTHOR
    REPORTING BUGS
    COPYRIGHT
    SEE ALSO
pl: NAZWA
    SKŁADNIA
    OPIS
    OPCJE
    @emph{inne}
    ŚRODOWISKO
    PLIKI
    PRZYKŁADY
    AUTOR
    ZGŁASZANIE BŁĘDÓW
    COPYRIGHT
    ZOBACZ TAKŻE

note: type: Plain text
en: Any @samp{[name]} or @samp{[synopsis]} sections appearing in the include file will replace what would have automatically been produced (although you can still override the former with @samp{--name} if required).
pl: Jakiekolwiek sekcje @samp{[nazwa]} i @samp{[składnia]}, występujące w dołączanym pliku, zastąpią tekst, który byłby utworzony automatycznie (choć nadal nazwę można nadpisać w razie potrzeby opcję @samp{--name}).

note: type: Plain text
en: Other sections are prepended to the automatically produced output for the standard sections given above, or included at @emph{other} (above)  in the order they were encountered in the include file.
pl: Pozostałe sekcje są dołączane do automatycznie utworzonego wyjścia dla standardowych sekcji podanych powyżej, lub dołączane w miejscu @emph{inne} (p. wyżej) w takiej kolejności, w jakiej wystąpiły w dołączanym pliku.

note: type: Plain text
en: Placement of the text within the section may be explicitly requested by using the syntax @samp{[<section]}, @samp{[=section]} or @samp{[>section]} to place the additional text before, in place of, or after the default output respectively.
pl: Umiejscowienie tekstu wewnątrz sekcji można jawnie określić przy użyciu składni @samp{[<sekcja]}, @samp{[=sekcja]} lub @samp{[>sekcja]}, aby umieścić tekst odpowiednio przed, zamiast lub po domyślnym wyjściu.

note: type: chapter
en: Using @command{help2man} With @command{make}
pl: Użycie programu @command{help2man} wraz z @command{make}

note: type: Plain text
en: A suggested use of @command{help2man} in Makefiles is to have the manual page depend not on the binary, but on the source file(s) in which the @samp{--help} and @samp{--version} output are defined.
pl: Sugerowany sposób użycia narzędzia @command{help2man} w plikach Makefile to utworzenie zależności strony podręcznika nie od programu wykonywalnego, ale od plików źródłowych, w których zdefiniowane jest wyjście opcji @samp{--help} oraz @samp{--version}.

note: type: Plain text
en: This usage allows a manual page to be generated by the maintainer and included in the distribution without requiring the end-user to have @command{help2man} installed.
pl: Metoda ta pozwala na wygenerowanie strony podręcznika przez utrzymującego projekt i dołączenie w dystrybucji, dzięki czemu użytkownik końcowy nie musi mieć zainstalowanego programu @command{help2man}.

note: type: Plain text
en: An example rule for the program @code{prog} could be:
pl: Przykładowa reguła dla programu @code{prog} może wyglądać następująco:

note: type: group
en: prog.1: $(srcdir)/main.c
            -$(HELP2MAN) --output=$@@ --name='an example program' ./prog
pl: prog.1: $(srcdir)/main.c
            -$(HELP2MAN) --output=$@@ --name='przykładowy program' ./prog

note: type: Plain text
en: The value of @code{HELP2MAN} may be set in @code{configure.in} using either of:
pl: Wartość zmiennej @code{HELP2MAN} można ustawić @code{configure.in} używając na przykład:

note: type: Plain text
en: for @command{automake}, or something like:
pl: w przypadku korzystania z narzędzia @command{automake} albo:

note: type: Plain text
en: for @command{autoconf} alone.
pl: w przypadku samego narzędzia @command{autoconf}.

note: type: chapter
en: Producing Native Language Manual Pages
pl: Wytwarzanie stron podręcznika w języku ojczystym

note: type: Plain text
en: Manual pages may be produced for any locale supported by both the program and @command{help2man} with the @samp{--locale} (@samp{-L})  option.
pl: Strony podręcznika można wygenerować dla dowolnej lokalizacji obsługiwanej jednocześnie przez program oraz polecenie @command{help2man} przy użyciu opcji @samp{--locale} (@samp{-L}).

note: type: example
en: help2man -L fr_FR@@euro -o cp.fr.1 cp
pl: help2man -L pl_PL -o cp.pl.1 cp

note: Translators: the translated cross-reference "Reports" here must match the target (type: node) translation elsewhere in this file. type: Plain text
en: See @url{http://translationproject.org/domain/help2man.html} for the languages currently supported by @command{help2man}, and @pxref{Reports} for how to submit other translations.
pl: Języki aktualnie obsługiwane przez @command{help2man} oraz @pxref{Kontakt}, jak zgłaszać nowe tłumaczenia, można znaleźć na stronie @url{http://translationproject.org/domain/help2man.html}.

note: type: section
en: Changing the Location of Message Catalogs
pl: Zmiana umiejscowienia katalogów komunikatów

note: type: Plain text
en: When creating localised manual pages from a program's build directory it is probable that the translations installed in the standard location will not be (if installed at all) correct for the version of the program being built.
pl: Przy tworzeniu zlokalizowanych stron podręcznika z katalogu budowania programu jest dość prawdopodobne, że tłumaczenia zainstalowane w standardowym miejscu nie będą (o ile w ogóle są zainstalowane) właściwe dla właśnie budowanej wersji programu.

note: type: Plain text
en: A preloadable library is provided with @command{help2man} which will intercept @code{bindtextdomain} calls configuring the location of message catalogs for the domain given by @env{$TEXTDOMAIN} and override the location to the path given by @env{$LOCALEDIR}.
pl: Wraz z programem @command{help2man} jest dostarczana biblioteka ładowalna, przechwytująca wywołania @code{bindtextdomain}, konfigurujące położenie katalogów komunikatów dla domeny określonej przez zmienną @env{$TEXTDOMAIN} i nadpisująca to położenie ścieżką podaną przez zmienną @env{$LOCALEDIR}.

note: type: Plain text
en: So for example:
pl: Na przykład:

note: type: example
en: mkdir -p tmp/fr/LC_MESSAGES
    cp po/fr.gmo tmp/fr/LC_MESSAGES/@var{prog}.mo
    LD_PRELOAD="/usr/lib/help2man/bindtextdomain.so" \
      LOCALEDIR=tmp \
      TEXTDOMAIN=@var{prog} \
      help2man -L fr_FR@@euro -i @var{prog}.fr.h2m -o @var{prog}.fr.1 @var{prog}
    rm -rf tmp
pl: mkdir -p tmp/pl/LC_MESSAGES
    cp po/pl.gmo tmp/pl/LC_MESSAGES/@var{prog}.mo
    LD_PRELOAD="/usr/lib/help2man/bindtextdomain.so" \
      LOCALEDIR=tmp \
      TEXTDOMAIN=@var{prog} \
      help2man -L pl_PL -i @var{prog}.pl.h2m -o @var{prog}.pl.1 @var{prog}
    rm -rf tmp

note: type: Plain text
en: will cause @var{prog} to load the message catalog from @samp{tmp} rather than @samp{/usr/share/locale}.
pl: spowoduje, że @var{prog} wczyta katalog komunikatów z @samp{tmp} zamiast @samp{/usr/share/locale}.

note: type: Plain text
en: Notes:
pl: Uwagi:

note: type: itemize
en: The generalisation of @samp{fr_FR@@euro} to @samp{fr} in the example above is done by @code{gettext}, if a more specific match were available it would also have been re-mapped.
pl: Uogólnienie @samp{pl_PL} do @samp{pl} w powyższym przykładzie jest wykonywane przez @code{gettext}; gdyby było dostępne bardziej konkretne dopasowanie, byłoby także przemapowane.

note: Translators: the translated cross-reference "Reports" here must match the target (type: node) translation elsewhere in this file. type: itemize
en: This preload has only been tested against @command{eglibc} 2.11.2 and @command{gettext} 0.18.1.1 on a GNU/Linux system; let me know if it does (or doesn't) work for you (@pxref{Reports}).
pl: To ładowanie biblioteki było testowane tylko z bibliotekami @command{eglibc} 2.11.2 i @command{gettext} 0.18.1.1 na systemie GNU/Linux; jeśli nie działa w innym przypadku, proszę to zgłosić (@pxref{Kontakt}).

note: type: chapter
en: Example @command{help2man} Output
pl: Przykładowe wyjście @command{help2man}

note: type: Plain text
en: Given a hypothetical program @command{foo} which produces the following output:
pl: Dla hipotetycznego programu @command{foo}, dającego następujące wyjście:

note: type: example
en: Copyright (C) 2011 Free Software Foundation, Inc.
    This is free software; see the source for copying conditions.  There is NO
    warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
pl: Copyright (C) 2011 Free Software Foundation, Inc.
    Ten program jest wolnodostępny; warunki kopiowania są opisane w źródłach.
    Autorzy nie dają ŻADNYCH gwarancji, w tym również gwarancji PRZYDATNOŚCI
    DO SPRZEDAŻY LUB DO KONKRETNYCH CELÓW.

note: type: example
en: Written by A. Programmer.
    @exstrong{$ foo --help}
    GNU `foo' does nothing interesting except serve as an example for
    `help2man'.
pl: Program napisał A. Programista.
    @exstrong{$ foo --help}
    GNU `foo' nie robi nic ciekawego, poza służeniem jako przykład dla programu
    `help2man'.

note: type: example
en: Usage: foo [OPTION]...
pl: Składnia: foo [OPCJA]...

note: type: example
en: Options:
      -a, --option      an option
      -b, --another-option[=VALUE]
                        another option
pl: Opcje:
      -a, --option      opcja
      -b, --another-option[=WARTOŚĆ]
                        inna opcja

note: type: example
en:       --help        display this help and exit
          --version     output version information and exit
pl:       --help        wyświetlenie tego opisu i zakończenie
          --version     wypisanie informacji o wersji i zakończenie

note: type: example
en: Examples:
      foo               do nothing
      foo --option      the same thing, giving `--option'
pl: Przykłady:
      foo               nic nie robi
      foo --option      to samo, z podaniem `--option'

note: type: example
en: Report bugs to <bug-gnu-utils@@gnu.org>.
pl: Błędy prosimy zgłaszać na adres <bug-gnu-utils@@gnu.org>.

note: type: Plain text
en: @command{help2man} will produce @command{nroff} input for a manual page which will be formatted something like this:
pl: @command{help2man} utworzy wejście dla programu @command{nroff} dla strony podręcznika man, która będzie sformatowana podobnie do poniższej:

note: type: example
en: FOO(1)                         User Commands                        FOO(1)
pl: FOO(1)                     Polecenia użytkownika                    FOO(1)

note: type: example
en: @exstrong{NAME}
           foo - manual page for foo 1.1
pl: @exstrong{NAZWA}
           foo - strona podręcznika dla foo 1.1

note: type: example
en: @exstrong{SYNOPSIS}
           foo [OPTION]...
pl: @exstrong{SKŁADNIA}
           foo [OPCJA]...

note: type: example
en: @exstrong{DESCRIPTION}
           GNU  `foo'  does nothing interesting except serve as an example for
           `help2man'.
pl: @exstrong{OPIS}
           GNU  `foo'  nie robi nic ciekawego, poza służeniem jako przykład dla
           programu `help2man'.

note: type: example
en: @exstrong{OPTIONS}
           @exstrong{-a}, @exstrong{--option}
                  an option
pl: @exstrong{OPCJE}
           @exstrong{-a}, @exstrong{--option}
                  opcja

note: type: example
en:        @exstrong{-b}, @exstrong{--another-option}[=@exemph{VALUE}]
                  another option
pl:        @exstrong{-b}, @exstrong{--another-option}[=@exemph{WARTOŚĆ}]
                  inna opcja

note: type: example
en:        @exstrong{--help} display this help and exit
pl:        @exstrong{--help} wyświetlenie tego opisu i zakończenie

note: type: example
en:        @exstrong{--version}
                  output version information and exit
pl:        @exstrong{--version}
                  wypisanie informacji o wersji i zakończenie

note: type: example
en: @exstrong{EXAMPLES}
           foo    do nothing
pl: @exstrong{PRZYKŁAD}
           foo    nic nie robi

note: type: example
en:        foo @exstrong{--option}
                  the same thing, giving `--option'
pl:        foo @exstrong{--option}
                  to samo, z podaniem `--option'

note: type: example
en: @exstrong{AUTHOR}
           Written by A. Programmer.
pl: @exstrong{AUTOR}
           Program napisał A. Programista.

note: type: example
en: @exstrong{REPORTING BUGS}
           Report bugs to <bug-gnu-utils@@gnu.org>.
pl: @exstrong{ZGŁASZANIE BŁĘDÓW}
           Błędy prosimy zgłaszać na adres <bug-gnu-utils@@gnu.org>.

note: type: example
en: @exstrong{COPYRIGHT}
           Copyright @copyright{} 2011 Free Software Foundation, Inc.
           This is free software;  see  the  source  for  copying  conditions.
           There is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A
           PARTICULAR PURPOSE.
pl: @exstrong{COPYRIGHT}
           Copyright @copyright{} 2011 Free Software Foundation, Inc.
           Ten program jest wolnodostępny; warunki kopiowania są opisane w źródłach.
           Autorzy nie dają ŻADNYCH gwarancji, w tym również gwarancji PRZYDATNOŚCI
           DO SPRZEDAŻY LUB DO KONKRETNYCH CELÓW.

note: type: example
en: @exstrong{SEE ALSO}
           The full documentation for @exstrong{foo} is maintained as a  Texinfo  manual.
           If  the  @exstrong{info} and @exstrong{foo} programs are properly installed at your site,
           the command
pl: @exstrong{ZOBACZ TAKŻE}
           Pełna dokumentacja dla programu @exstrong{foo} jest utrzymywana jako podręcznik
           Texinfo. Jeśli programy @exstrong{info} oraz @exstrong{foo} są właściwie zainstalowane,
           polecenie

note: type: example
en:        should give you access to the complete manual.
pl:        powinno udostępnić kompletny podręcznik.

note: type: example
en: foo 1.1                          May 2011                           FOO(1)
pl: foo 1.1                          Maj 2011                           FOO(1)

note: type: chapter
en: Reporting Bugs or Suggestions
pl: Zgłaszanie błędów i propozycji

note: type: Plain text
en: If you find problems or have suggestions about this program or manual, please report them to @email{bug-help2man@@gnu.org}.
pl: Aby zgłosić napotkany problem lub propozycję, prosimy skontaktować się pod adresem @email{bug-help2man@@gnu.org}.

note: type: Plain text
en: Note to translators: Translations are handled though the @uref{http://translationproject.org/, Translation Project} see @url{http://translationproject.org/html/translators.html} for details.
pl: Uwaga do tłumaczy: tłumaczenia są obsługiwane poprzez @uref{http://translationproject.org/, Translation Project}, szczegóły pod adresem @url{http://translationproject.org/html/translators.html}.

note: type: chapter
en: Obtaining @command{help2man}
pl: Pozyskiwanie programu @command{help2man}

note: type: Plain text
en: The latest version of this distribution is available online from GNU mirrors:
pl: Najnowsza wersja tego pakietu jest dostępna w sieci z serwerów lustrzanych GNU:

note: type: Plain text
en: If automatic redirection fails, the list of mirrors is at:
pl: Jeśli automatyczne przekierowanie się nie powiedzie, listę serwerów można uzyskać pod:

note: type: Plain text
en: Or if need be you can use the main GNU ftp server:
pl: Albo, w razie potrzeby, można użyć głównego serwera ftp GNU:
