<chapt id="support">Pomoc dla systemu &debian;

<sect id="debiandocs">Jakie inne dokumentacje istnieją dla systemu Debian GNU/Linux?

<p><list>
  <item>Instrukcja instalacji dla obecnego wydania - zobacz:
    <url id="http://www.debian.org/releases/stable/installmanual">.
  <item>Podręcznik zasad zawiera normy dotyczące dystrybucji, takie jak:
    struktura i zawartość archiwum Debiana, zagadnienia
    dotyczące projektowania systemu operacyjnego itd. Zawiera on również
    wymagania techniczne, jakie musi spełnić każdy pakiet aby zostać włączonym
    do dystrybucji, oraz dokumentację podstawowych aspektów technicznych 
    pakietów binarnych i źródłowych Debiana.
  <p>Pobierz go z pakietu: <package/debian-policy/ lub z
    <url id="http://www.debian.org/doc/devel-manuals#policy">.
  <item>Dokumentacja dotycząca zainstalowanych pakietów Debiana:
    Większość pakietów posiada pliki pomocy, które zapisywane są do 
    <tt>/usr/doc/PAKIET</tt>.
  <item>Dokumentacja dla projektu Linux:
    Pakiety Debiana <package/doc-linux/ zawierają wszystkie najnowsze
    wersje HOWTO i mini-HOWTO z 
    <url name="Projektu Dokumentacji Linuksa" id="http://www.tldp.org/">.
  <item>Strony podręcznika systemowego `man' :  Większość poleceń posiada
    strony podręcznika systemowego napisane w postaci plików `man'. 
    Są one opisane przez części indeksu `man' w którym się znajdują: 
    n.p. foo(3) odnosi się do strony podręcznika, która znajduje się 
    w /usr/share/man/man3/ i może zostać wywołana przez wydanie polecenia: 
    <tt>man 3 foo</tt>, lub po prostu <tt>man foo</tt> jeśli trzecia część 
    jest pierwszą zawartą w podręczniku systemowym dotyczącym <tt>foo</tt>.
    <p>Można dowiedzieć się, który katalog z <tt>/usr/share/man/</tt> zawiera
    konkretną stronę poprzez polecenie <tt>man -w foo</tt>.
    <p>Nowi użytkownicy Debiana powinni wiedzieć, że strony podręcznika
    systemowego dla wielu poleceń nie są osiągalne, aż do czasu gdy 
    zainstalują pakiety:
    <list>
      <item><tt>man-db</tt>, który zawiera program <tt>man</tt>
        oraz inne programy do kontroli i sterowania stronami podręcznika 
        systemowego.
      <item><tt>manpages</tt>, który zawiera strony podręcznika systemowego.
        (zobacz <ref id="nonenglish">).
    </list>
  <item>Strony `info': Dokumentacja użytkowników dotycząca wielu poleceń,
    zwłaszcza narzędzi GNU, jest dostępna w postaci plików `info', a nie
    stron podręcznika systemowego. Pliki takie mogą być przeczytane przez 
    narzędzie GNU <tt>info</tt>, uruchamiane <tt>M-x info</tt> w GNU Emacs 
    lub przez inne przeglądarki.
    <p>Największą przewagą względem oryginalnych stron podręcznika
    systemowego `man' jest hipertekstowy system stron info. 
     <em>Nie</em> potrzebują one jednak przeglądarki WWW;
    <tt>info</tt> może zostać uruchomione w zwykłej konsoli tekstowej.
    Standard info został stworzony przez Richarda Stallmana i poprzedzał WWW.
</list>

<p>Zapamiętaj, iż możesz mieć dostęp do dużej ilości dokumentacji w Twoim 
   systemie używając przeglądarki WWW, bezpośrednio, przez polecenia `dwww' 
   lub `dhelp', znajdujące się w poszczególnych pakietach.

<sect id="onlineresources">Czy w Internecie dostępne są jakieś możliwości do 
dyskusji na temat Debiana?

<p>Tak. Poczta elektroniczna jest główną metodą wspierania użytkowników Debiana.

<sect1>Listy dyskusyjne.

<p>Jest ich wiele <url name="Listy dyskusyjne związane z Debianem"
id="http://www.debian.org/MailingLists/">.

<p>Kompletny spis list dyskusyjnych znajduje się
<file>/usr/share/doc/debian/mailing-lists.txt</file> pod warunkiem, że
w systemie zainstalowany jest pakiet <package/doc-debian/.

<p>Listy dyskusyjne Debiana nazywane są według następującego wzoru
debian-<var>temat_listy</var>. Przykładem są debian-announce,
debian-user, debian-news. Aby zapisać się na listę dyskusyjną
debian-<var>temat_listy</var>, wyślij list pocztą elektroniczną do
debian-<var>temat_listy</var>-request@lists.debian.org wraz ze słowem
"subscribe" w temacie wiadomości. Pamiętaj aby dodać <em>-request</em>
do adresu listu, gdy używasz tej metody zapisywania się lub rezygnacji z listy 
dyskusyjnej. W przeciwnym wypadku Twój list elektroniczny zostanie wysłany 
na listę dyskusyjną.

<p>Jeśli posiadasz przeglądarkę WWW obsługującą formularze możesz zapisać się 
na listę dyskusyjną używając <url name="Formularza WWW"
id="http://www.debian.org/MailingLists/subscribe">.
Możesz również zrezygnować z listy używając <url name="Formularza WWW"
id="http://www.debian.org/MailingLists/unsubscribe">.

<p>W razie jakiś problemów adres administratora list dyskusyjnych to:
<email/listmaster@lists.debian.org/

<p>Archiwa list dyskusyjnych Debiana dostępne są pod adresem WWW:
<url id="http://lists.debian.org/">.

<sect2 id="mailinglistconduct">Jakie zasady panują na listach dyskusyjnych?

<p>Gdy korzystasz z list dyskusyjnych związanych z Debianem postępuj zgodnie
z następującymi regułami:

<list>
  <item>Nie wysyłaj spamu. Zobacz <url name="Polityka rozpowszechniania list
  dyskusyjnych związanych z Debianem" id="http://www.debian.org/MailingLists/#ads">.
  <item>Nie przeklinaj; to niekulturalne. Ludzie rozwijający Debiana to 
  ochotnicy, którzy poświęcają swój czas, energię i pieniądze próbując 
  scalić projekt Debian. 
  <item>Nie używaj przekleństw; wielu ludzi otrzymuje listę za pomocą pakietu
  radiowego, gdzie przeklinanie jest nielegalne.
  <item>Upewnij się czy używasz odpowiedniej listy. <em/Nie/ wysyłaj swojej 
  prośby o   zapisanie lub rezygnację do listy dyskusyjnej <footnote>.
  Używaj do  tego adresu 
  debian-<var>temat_listy</var>-REQUEST@lists.debian.org.</footnote>
  <item>Zobacz część <ref id="bugreport"> aby dowiedzieć się więcej o 
  zgłaszaniu błędów.
</list>

<sect1>Opiekunowie pakietów.

<p>Użytkownicy mogą również adresować pytania do opiekunów poszczególnych 
pakietów. By zadać pytanie opiekunowi pakietu xyz, wyślij list pocztą 
elektroniczną pod adres <em>xyz@packages.debian.org</em>.

<sect1>Grupy dyskusyjne.

<p>Pytania nie dotyczące jednoznacznie Debiana użytkownicy powinni zadawać na 
grupach dyskusyjnych związanych z Linuksem. Są to grupy dyskusyjne 
comp.os.linux.* lub linux.*. Wiele adresów grup dyskusyjnych dotyczących 
Linuksa oraz pokrewnych materiałów znaleźć możemy na stronach WWW : np. 
<url name="Linux Online" id="http://www.linux.org/docs/usenet.html"> lub 
<url name="LinuxJournal" id="http://www.linuxjournal.com/helpdesk.php">.

<sect id="searchtools">Czy istnieje szybka metoda wyszukiwania materiałów
związanych z systemem &debian;?

<p>Jest wiele wyszukiwarek, które pomagają szukać dokumentów 
związanych z Debianem:

<list>
  <item><url id="http://search.debian.org/" name="Debian WWW search site">.

  <item><url id="http://groups.google.com/" name="Google Groups">: przeszukuje
  listy dyskusyjne.

    <p>Na przykład: aby dowiedzieć się więcej na temat sterowników do 
    kontrolerów Promise dla Debiana, spróbuj wyszukać wyrażenie 
    <tt>Promise Linux sterownik</tt>. Zostaną znalezione wszystkie wiadomości, 
    które zawierają podany ciąg znaków, n.p. dyskusje, których tematem był 
    ten problem. Jeśli dodasz <tt>Debian</tt> do szukanego wyrażenia, w wyniku 
    otrzymasz wiadomości ściśle powiązane z Debianem.

  <item>Zwykłe wyszukiwarki, takie jak:
    <url id="http://www.altavista.com/" name="AltaVista"> lub
    <url id="http://www.google.com/" name="Google"> jeśli będziesz używać 
    prawidłowych warunków wyszukiwania.

    <p>Na przykład: wyszukanie terminu "cgi-perl" dostarcza o wiele 
    dokładniejsze wyjaśnienia, niż krótki opis zawarty w tym pakiecie.
</list>

<sect id="buglogs">Czy istnieją logi znanych błędów?

<p>Dystrybucja &debian; posiada "System Śledzenia Błędów - Bug Tracking 
System (BTS)", który przechowuje informacje o błędach zgłoszonych przez 
użytkowników i opiekunów pakietów. Każdy błąd otrzymuje swój numer i 
przechowywany jest w pliku tak długo, aż nie zostanie uznany za usunięty.

<p>Kopie tych informacji są dostępne pod adresem 
<url id="http://www.debian.org/Bugs/">.

<p>Dostęp do bazy danych "Systemu Śledzenia Błędów (BTS)" zapewnia serwer 
pocztowy. Aby dowiedzieć się więcej, wyślij list drogą elektroniczną 
zawierający słowo "help" na adres: request@bugs.debian.org.

<sect id="bugreport">Jak mogę zgłosić błąd dotyczący Debiana?

<p>Jeśli znaleziono błąd w Debianie, postępuje się zgodnie z instrukcją 
zgłaszania błędów dotyczących Debiana. Instrukcję tę można otrzymać na kilka 
sposobów:
<list>
  <item>Poprzez anonimowy FTP. Strony serwerów lustrzanych Debiana zawierają
  instrukcję w pliku <tt>doc/bug-reporting.txt</tt>.
  <item>Poprzez stronę WWW.  Kopia instrukcji znajduje się pod adresem 
  <url id="http://www.debian.org/Bugs/Reporting">.
  <item>W każdej dystrybucji Debiana poprzez instalację pakietu 
  <package/doc-debian/. Instrukcja znajduje się w pliku 
  <file>/usr/doc/debian/bug-reporting.txt</file>.
</list>

<p>Możesz również użyć pakietu <package/bug/ lub <package/reportbug/,
 które poprowadzą Cię przez proces zgłaszania błędów i wyślą wiadomość
 o nich pod odpowiedni adres wraz z dodatkowymi informacjami, dotyczącymi 
 Twojego systemu.

<p>Jeśli chcesz wysłać raport o błędzie z programu pocztowego, wyślij wiadomość
do <email/submxit@bugs.debian.org/. Pierwsza linia wiadomości musi zawierać:
  <example>Package: nazwa pakietu</example>
Następna linia powinna zawierać wersję pakietu podaną w podobny sposób:
  <example>Version: numer wersji</example>
Numer wersji dla jakiegokolwiek pakietu zainstalowanego w Twoim systemie
można uzyskać wydając polecenie:
  <example>dpkg -s <var>nazwa pakietu</var></example>
Reszta wiadomości powinna zawierać dokładny opis błędu, dystrybucji Debiana
jakiej używasz oraz numery wersji innych stosowanych pakietów. Wersję 
dystrybucji Debiana, którą obecnie używasz, można wyświetlić poprzez polecenie 
  <example>cat /etc/debian_version</example>.

<p>Po wysłaniu przez Ciebie zgłoszenia błędu zostaniemy automatycznie 
powiadomieni o otrzymaniu zgłoszenia. Również automatycznie błąd otrzyma 
numer (zapisany w logu błędów) oraz zostanie wysłany na listę dyskusyjną 
debian-bugs-dist.

<p>Jeśli znaleziony błąd jest powiązany z wieloma pakietami, zamiast wysyłać
wiele podobnych zgłoszeń błędu, należy wysłać zgłoszenia odnośnie błędów do 
<email/maintonly@bugs.debian.org/ (zamiast adresu
submit@... ), aby powiadomić tylko opiekunów poszczególnych pakietów, a 
następnie wysłać podsumowanie zgłoszonych błędów do listy mailingowej 
debian-devel lub debian-bugs-dist.

<p>Dodatkowo istnieje tester pakietów Debiana nazywany
<url name="Lintian" id="http://www.debian.org/lintian/">. Został on tak
zaprojektowany, aby automatycznie przeszukiwać pakiety w celu znalezienia 
naruszeń zasad dystrybucji czy błędów wykrytych już wcześniej w innych 
pakietach. Zatem jeśli znajdziesz błąd, który może również wystąpić w innych 
pakietach, lepiej będzie jeśli skontaktujesz się z opiekunami pakietu 
Lintian <email/lintian-maint@debian.org/. Powstanie nowej metody wyszukiwania 
błędów zapobiegnie pojawianiu się tego samego błędu w innych pakietach 
dystrybucji.

<p>Możesz również używać adresu <email/quiet@bugs.debian.org/, aby zgłaszać 
błędy tylko do "Systemu Śledzenia Błędów (BTS)", bez jednoczesnego wysyłania 
ich do listy dyskusyjnej debian-bugs-dist lub do opiekuna pakietu. Adres 
ten jest wykorzystywany bardzo rzadko np. jeśli chcesz dołączyć drugorzędne 
dane do swojego zgłoszenia błędu lub gdy chcesz zaznaczyć coś w logu 
"Systemu Śledzenia Błędów (BTS)", a już wcześniej powiadomiono o tym opiekuna 
projektu.
