# Pomoc dla systemu Debian GNU/Linux

## Jakie inne dokumentacje istnieją dla systemu Debian GNU/Linux?

- Instrukcja instalacji dla obecnego wydania - zobacz: http://www.debian.org/releases/stable/installmanual.

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

  Pobierz go z pakietu: `debian-policy` lub z http://www.debian.org/doc/devel-manuals#policy.

- Dokumentacja dotycząca zainstalowanych pakietów Debiana: Większość pakietów posiada pliki pomocy, które zapisywane są do `/usr/doc/PAKIET`.

- Dokumentacja dla projektu Linux: Pakiety Debiana `doc-linux` zawierają wszystkie najnowsze wersje HOWTO i mini-HOWTO z Projektu Dokumentacji Linuksa.

- 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: `man 3 foo`, lub po prostu `man foo` jeśli trzecia część jest pierwszą zawartą w podręczniku systemowym dotyczącym `foo`.

  Można dowiedzieć się, który katalog z `/usr/share/man/` zawiera konkretną stronę poprzez polecenie `man -w foo`.

  Nowi użytkownicy Debiana powinni wiedzieć, że strony podręcznika systemowego dla wielu poleceń nie są osiągalne, aż do czasu gdy zainstalują pakiety:

  - `man-db`, który zawiera program `man` oraz inne programy do kontroli i sterowania stronami podręcznika systemowego.

  - `manpages`, który zawiera strony podręcznika systemowego. (zobacz nonenglish).

- 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 `info`, uruchamiane `M-x info` w GNU Emacs lub przez inne przeglądarki.

  Największą przewagą względem oryginalnych stron podręcznika systemowego `man' jest hipertekstowy system stron info. Nie potrzebują one jednak przeglądarki WWW; `info` może zostać uruchomione w zwykłej konsoli tekstowej. Standard info został stworzony przez Richarda Stallmana i poprzedzał WWW.

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.

## Czy w Internecie dostępne są jakieś możliwości do dyskusji na temat Debiana?

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

### Listy dyskusyjne.

Jest ich wiele Listy dyskusyjne związane z Debianem.

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

Listy dyskusyjne Debiana nazywane są według następującego wzoru debian-`temat_listy`. Przykładem są debian-announce, debian-user, debian-news. Aby zapisać się na listę dyskusyjną debian-`temat_listy`, wyślij list pocztą elektroniczną do debian-`temat_listy`-request@lists.debian.org wraz ze słowem "subscribe" w temacie wiadomości. Pamiętaj aby dodać -request 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ą.

Jeśli posiadasz przeglądarkę WWW obsługującą formularze możesz zapisać się na listę dyskusyjną używając Formularza WWW. Możesz również zrezygnować z listy używając Formularza WWW.

W razie jakiś problemów adres administratora list dyskusyjnych to: listmaster@lists.debian.org

Archiwa list dyskusyjnych Debiana dostępne są pod adresem WWW: http://lists.debian.org/.

#### Jakie zasady panują na listach dyskusyjnych?

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

- Nie wysyłaj spamu. Zobacz Polityka rozpowszechniania list dyskusyjnych związanych z Debianem.

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

- Nie używaj przekleństw; wielu ludzi otrzymuje listę za pomocą pakietu radiowego, gdzie przeklinanie jest nielegalne.

- Upewnij się czy używasz odpowiedniej listy. Nie wysyłaj swojej prośby o zapisanie lub rezygnację do listy dyskusyjnej

  . Używaj do tego adresu debian-`temat_listy`-REQUEST@lists.debian.org.

- Zobacz część bugreport aby dowiedzieć się więcej o zgłaszaniu błędów.

### Opiekunowie pakietów.

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 xyz@packages.debian.org.

### Grupy dyskusyjne.

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. Linux Online lub LinuxJournal.

## Czy istnieje szybka metoda wyszukiwania materiałów związanych z systemem Debian GNU/Linux?

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

- Debian WWW search site.

- Google Groups: przeszukuje listy dyskusyjne.

  Na przykład: aby dowiedzieć się więcej na temat sterowników do kontrolerów Promise dla Debiana, spróbuj wyszukać wyrażenie `Promise Linux sterownik`. 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 `Debian` do szukanego wyrażenia, w wyniku otrzymasz wiadomości ściśle powiązane z Debianem.

- Zwykłe wyszukiwarki, takie jak: AltaVista lub Google jeśli będziesz używać prawidłowych warunków wyszukiwania.

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

## Czy istnieją logi znanych błędów?

Dystrybucja Debian GNU/Linux 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.

Kopie tych informacji są dostępne pod adresem http://www.debian.org/Bugs/.

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.

## Jak mogę zgłosić błąd dotyczący Debiana?

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:

- Poprzez anonimowy FTP. Strony serwerów lustrzanych Debiana zawierają instrukcję w pliku `doc/bug-reporting.txt`.

- Poprzez stronę WWW. Kopia instrukcji znajduje się pod adresem http://www.debian.org/Bugs/Reporting.

- W każdej dystrybucji Debiana poprzez instalację pakietu `doc-debian`. Instrukcja znajduje się w pliku `/usr/doc/debian/bug-reporting.txt`.

Możesz również użyć pakietu `bug` lub `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.

Jeśli chcesz wysłać raport o błędzie z programu pocztowego, wyślij wiadomość do submxit@bugs.debian.org. Pierwsza linia wiadomości musi zawierać:

    Package: nazwa pakietu

Następna linia powinna zawierać wersję pakietu podaną w podobny sposób:

    Version: numer wersji

Numer wersji dla jakiegokolwiek pakietu zainstalowanego w Twoim systemie można uzyskać wydając polecenie:

    dpkg -s nazwa pakietu

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

    cat /etc/debian_version

.

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.

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

Dodatkowo istnieje tester pakietów Debiana nazywany 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 lintian-maint@debian.org. Powstanie nowej metody wyszukiwania błędów zapobiegnie pojawianiu się tego samego błędu w innych pakietach dystrybucji.

Możesz również używać adresu 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.