<?xml version="1.0" ?>
<!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN"
"dtd/kdex.dtd" [
<!ENTITY % addindex "IGNORE">
<!ENTITY % Polish "INCLUDE"
> <!-- change language only here -->
]>
	
<article lang="&language;" id="man">
<title
>Man</title>
<articleinfo>
<authorgroup>
<author
>&Lauri.Watts; &Lauri.Watts.mail;</author>
<author
><firstname
>Nicolas</firstname
> <surname
>Goutte</surname
> <email
>goutte@kde.org</email
> </author>
<othercredit role="translator"
><firstname
>Suse</firstname
><surname
>Polska</surname
><affiliation
><address
><email
>suse@suse.pl</email
></address
></affiliation
><contrib
>Polskie tłumaczenie</contrib
></othercredit
> <othercredit role="translator"
><firstname
>Krzysztof</firstname
><surname
>Woźniak</surname
><affiliation
><address
><email
>wozniakk@ceti.pl</email
></address
></affiliation
><contrib
>Polskie tłumaczenie - Aktualizacja i poprawki</contrib
></othercredit
>  
</authorgroup>
</articleinfo>

<para
>Wtyczka protokołu "man" służy do przyjaznego dla użytkownika przeglądania stron dokumentacji zainstalowanej w systemie. </para>

<variablelist>
<varlistentry>
<term
><userinput
><command
>man:</command
></userinput
></term>
<listitem>
<para
>Wyświetli wszystkie dostępne sekcje dokumentacji. Kliknięcie na wybraną sekcję wyświetli jej zawartość. </para>
</listitem>
</varlistentry>
<varlistentry>
<term
><userinput
><command
>man:</command
><replaceable
>fopen</replaceable
></userinput
></term>
<listitem>
<para
>Wyświetla stronę dokumentacji polecenia <command
>fopen</command
>. </para>
</listitem>
</varlistentry>
<varlistentry>
<term
><userinput
><command
>man:</command
><replaceable
>fopen(3)</replaceable
></userinput
></term>
<listitem>
<para
>Wyświetla stronę dokumentacji polecenia <command
>fopen</command
> znajdującą się w sekcji 3. </para>
</listitem>
</varlistentry>
<varlistentry>
<term
><userinput
><command
>man:</command
><replaceable
>(3)</replaceable
></userinput
></term>
<listitem>
<para
>Wyświetla zawartość sekcji 3 dokumentacji. </para>
</listitem>
</varlistentry>
<varlistentry>
<term
><userinput
><command
>man:</command
>intro<replaceable
>(3)</replaceable
></userinput
></term>
<listitem>
<para
>Wyświetla informacje wprowadzające dotyczące sekcji 3 dokumentacji. </para>
</listitem>
</varlistentry>
</variablelist>

<note
><para
>Jeżeli do danego polecenia dostępnych jest kilka stron dokumentacji to wyświetlona zostanie ich lista, z której użytkownik będzie mógł wybrać właściwą stronę.</para
></note>

<para
>Podobną funkcję spełnia skrót: <userinput
><command
>#fopen</command
></userinput
>. </para>

<para
>Jeżeli nie widać całej zainstalowanej w systemie dokumentacji, to należy sprawdzić zawartość pliku konfiguracyjnego  <filename
>/etc/manpath.config</filename
> (lub pliku o podobnej funkcji w stosowanej dystrybucji systemu) lub dostosować zmienne środowiskowe <envar
>MANPATH</envar
> oraz <envar
>MANSECT</envar
>. </para>

<para
>Jak w innych wtyczkach protokołów środowiska &kde;, możliwe jest wprowadzenie adresu &URL; w postaci:<userinput
><command
>man:socket</command
></userinput
> w <emphasis
>dowolnym</emphasis
> programie. Jeżeli na przykład użytkownik wprowadzi taki adres w programie &kwrite; to otworzy on stronę dokumentacji w formacie &HTML;. </para>

<para
>W razie problemów należy się kontaktować z listą dyskusyjną: <email
>kde-devel@kde.org</email
> </para>

</article>
