# Отримання підтримки для Debian GNU/Linux

## Яка ще документація існує для системи Debian?

- Інструкції по встановленню для поточного випуску: перегляньте http://www.debian.org/releases/stable/installmanual.

- Довідник Debian GNU/Linux торкається багатьох аспектів системного адміністрування за допомогою прикладів команд оболонки. Базові навчальні програми, підказки та інша інформація з багатьох різноманітних тем від системного адміністрування до програмування постачається у пакунку `debian-reference`, також доступна за адресою http://www.debian.org/doc/user-manuals#quick-reference.

- Підручник політики (Policy manual) документує стратегічні вимоги збірки, як наприклад структуру та вміст архіву Debian; деякі проблеми дизайну операційної системи і т.п. Він також включає технічні вимоги до пакунку, котрих потрібно дотримуватись для включення його в збірку, та документує основні технічні аспекти двійкових та джерельних пакунків Debian.

  Його ви можете отримати з пакунку `debian-policy` або за адресою http://www.debian.org/doc/devel-manuals#policy.

- Документація розроблена в рамках Проекту документування Debian (Debian Documentation Project). Вона доступна за адресою http://www.debian.org/doc/ та включає посібники користувача, адміністратора та убезпечення операційної системи Debian GNU/Linux.

- Документація на встановлені пакунки Debian: переважна більшість пакунків мають файли документації, що встановлюються до `/usr/doc/ПАКУНОК`.

- Проект документування Linux: пакунок `doc-linux` встановлює всі найсвіжіші версії документів HOWTOs та mini-HOWTOs від Linux Documentation Project.

- Сторінки підручника у стилі Unix: Переважна більшість команд мають сторінки довідки в стилі оригінальних man-файлів Unix. Вони поділені на секції у каталозі man: наприклад, foo(3) вказує на сторінку підручника, котра знаходиться у /usr/share/man/man3/, і може бути викликана за допомогою команди: `man 3 foo`, або просто `man foo`, якщо третя секція є першою, що містить сторінку `foo`.

  Які з підтек `/usr/share/man/` містять задану сторінку можна дізнатись, виконавши команду `man -w foo`.

  Новачки Debian повинні пам'ятати, що сторінки підручника багатьох загальносистемних команд будуть недоступними, аж поки вони не встановлять наступні пакунки:

  - `man-db`, котрий містить саму програму `man`, та інші програми для маніпуляцій сторінками підручника;

  - `manpages`, що містить системні сторінки підручника (див. nonenglish).

- Інформаційні сторінки у стилі GNU: Користувацька документація для багатьох команд, особливо інструментів GNU доступна не лише у man-сторінках, але й у файлах info, котрі можуть бути прочитані інструментом GNU `info`, запуском `M-x info` у середовищі GNU Emacs, чи будь-яким іншим переглядачем сторінок Info.

  Їхньою головною перевагою над сторінками підручника є те, що вони базуються на гіпертекстовій системі. Проте вони не потребують тенет; сторінки `info` можуть бути прочитані з текстової консолі. Ця система була спроектована Річардом Столлменом та передувала WWW.

Зауважте, що ви можете знайти чимало документації у своїй системі за допомогою веб-переглядача та команд dwww, dhelp або doccentral з відповідних пакунків.

## Чи є якісь мережеві ресурси для обговорення Debian?

Так. Фактично, основним методом підтримки, що надає Debian своїм користувачам є підтримка за допомогою електронної пошти.

### Списки розсилки

Існує велика кількість пов'язаних з Debian списків розсилки.

В системі з встановленим пакунком `doc-debian` повний їх список можна знайти у файлі `/usr/share/doc/debian/mailing-lists.txt`.

Списки розсилки Debian отримують назви за таким зразком: debian-`тема-списку`. Наприклад, debian-announce, debian-user, debian-news. Щоб підписатись до будь-якого з них, відправте листа за адресою debian-`тема-списку`-request@lists.debian.org з словом subscribe у полі Subject заголовку листа. Не забувайте додавати -request до адреси електронної пошти, якщо ви використовуєте такий метод щоб підписатись чи відписатись. В іншому випадку ваш лист потрапить до власне розсилки, що може роздратувати, або ж розгубити вас, в залежності від вашої точки зору.

Якщо у вас є переглядач Тенет, що підтримує форми, ви можете з їх допомогою підписатись на списки розсилки або відписатись від них.

Список керівників e-mail-адреса — listmaster@lists.debian.org, сюди можна звертатись у випадку виявлення будь-яких проблем.

Списки розсилки є публічними форумами. Всі електронні листи, відправлені до списків, копіюються до загальнодоступних архівів, щоб будь-хто (навіть люди не підписані на них) міг переглянути їх або здійснити пошук по їх вмісту. Будь ласка, впевніться що ви не відсилаєте жодних конфіденційних чи неліцензійних матеріалів до списку розсилки. Це стосується і таких речей, як, наприклад, електронні адреси. Зверніть особливу увагу і на той факт, що електронні адреси, з яких ви відсилаєте листи до наших списків розсилки, можуть стати відомими спамерам та використані ними для зловживань. Перегляньте політику щодо приватності в списках розсилки Debian щоб отримати більше інформації.

Архіви списків розсилки Debian доступні через WWW за адресою http://lists.debian.org/.

#### Як поводитись у списках розсилки?

Спілкуючись у списках розсилки Debian, дотримуйтесь, будь ласка, наступних правил:

- Не надсилайте спаму. Перегляньте Політику Debian щодо реклами в списках розсилки.

- Не флейміть — це неввічливо. Всі розробники Debian — добровольці, що жертвують проекту свій час, енергію та кошти, стараючись спільно принести користь.

- Не використовуйте нецензурну лексику; окрім усього іншого деякі люди отримують листи за допомогою пакетного радіо, де лайливі вислови є неприпустимими.

- Переконайтесь, що ви вказуєте правильну назву списку. Ніколи не відправляйте ваші запити про підписку на список розсилки або відмову під подальшої участі в ньому безпосередньо у списки

  Для цього необхідно вказувати адресу debian-`назва-списку`-REQUEST@lists.debian.org.

  .

- Див. bugreport щоб дізнатись про відсилання повідомлень про помилки.

### Супроводжуючі

Користувачі можуть адресувати свої запитання до конкретних супроводжуючих пакунків за допомогою електронної пошти. Щоб зв'язатись з супроводжуючим пакунка xyz, відішліть листа за адресою xyz@packages.debian.org.

### Групи новин

Користувачі мають публікувати не специфічні для Debian запитання до однієї з груп новин, присвячених Linux, котрі називаються comp.os.linux.* та linux.*. Також є кілька груп новин у тенетах, наприклад на сайтах Linux Online та LinuxJournal.

## Чи є якийсь швидкий спосіб пошуку інформації про Debian GNU/Linux?

Є набір пошукових систем, котрі обслуговують документацію, присвячену Debian:

- Пошуковий веб-сайт Debian.

- Google Groups: пошукова система для груп новин.

  Наприклад, щоб дізнатись, про успіхи людей у пошуку драйверів під Debian для контролерів Promise, спробуйте здійснити пошук по фразі `Promise Linux driver`. Вам буде показано всі повідомлення, що містять цей рядок, тобто все, що люди обговорювали на цю тему. Якщо до цього ланцюжка додати слово `Debian`, ви побачите лише ті повідомлення, що стосуються саме Debian.

- Чим краще ви задаєте ключову фразу, тим точніші результати видають стандартні пошукові системи, як наприклад AltaVista чи Google.

  Наприклад, пошук по ланцюжку cgi-perl дасть значно детальніші пояснення про пакунок, аніж коротке поле опису у його файлі control.

## Чи ведуться записи про відомі помилки?

Звіти про невирішені (та закриті) питання є загальнодоступними: Debian пообіцяв робити так, заявляючи, що „Ми не будемо приховувати проблеми“ в Суспільному договорі Debian.

Збірка Debian GNU/Linux має систему відслідковування помилок (bug tracking system — BTS), котра зберігає деталі звітів про помилки, надісланих користувачами та розробниками. Кожній помилці присвоюється число і звіт про неї зберігається до тих пір, поки проблема не буде вирішеною.

Копія цієї інформації доступна за адресою http://www.debian.org/Bugs/.

Поштовий сервер надає доступ до бази даних системи відслідковування помилок за допомогою електронної пошти. Щоб отримати детальніші інструкції, відправте листа на адресу request@bugs.debian.org зі словом help.

## Як мені відправити в Debian звіт про помилку?

Якщо ви знайшли помилку, прочитайте, будь ласка, інструкції щодо звітування про помилки в Debian. Ці інструкції можна отримати кількома шляхами:

- Через анонімний FTP. Дзеркальні сайти Debian містять інструкції у файлі `doc/bug-reporting.txt`.

- З тенет. Копія інструкцій доступна за адресою http://www.debian.org/Bugs/Reporting.

- На будь-якій системі Debian зі встановленим пакунком `doc-debian`. Інструкції знаходяться у файлі `/usr/doc/debian/bug-reporting.txt`.

Ви також можете відіслати звіт про помилку за допомогою пакунку `reportbug`, котрий проведе вас через процес створення звіту та надішле листа електронною поштою за правильною адресою, автоматично додавши деякі відомості про вашу систему. Він також покаже вам список помилок, знайдених у пакунку, про котрий ви звітуєте з тим щоб ви могли надати додаткову інформацію до існуючих звітів.

Якщо ви хочете відіслати звіт електронною поштою, надсилайте його на submit@bugs.debian.org. Перший рядок звіту має бути подібний до

    Package: package-name

(замініть `package-name` назвою пакунка). Наступний рядок повинен подібним чином вказувати на версію програми:

    Version: version-number

Номер версії будь-якого встановленого у вашій системі пакунку можна дізнатись за допомогою команди

    dpkg -s package-name

Ця частина відноситься до так званого псевдо-заголовку. Решта повідомлення повинна містити опис помилки (робіть його помірковано детальним, будь ласка), версію вашої збірки Debian та версії інших пакунків, що мають відношення до помилки. Версію Debian можна дізнатись за допомогою команди

    cat /etc/debian_version

Ви маєте отримати автоматичне підтвердження про отримання вашого звіту. Йому також буде автоматично надано номер, додано до журналу помилок та перенаправлено до списку розсилки debian-bugs-dist.