Kata Pengantar

Aturan pemandu berikut diikuti ketika menyusun dokumen ini.

	Awas
	Anda diharapkan berupaya keras untuk mencari jawaban sendiri lebih jauh dari dokumentasi ini. Dokumen ini hanya memberikan titik awal yang efisien.

Anda harus mencari solusi sendiri dari sumber-sumber primer.

Dokumen ini menyediakan informasi melalui gaya presentasi sederhana dengan contoh perintah shell bash(1) berikut ini.

# command-in-root-account
$ command-in-user-account

Sapaan shell ini membedakan akun yang dipakai dan sesuai dengan variabel lingkungan yang ditata sebagai: "PS1='\$'" dan "PS2=' '". Nilai-nilai ini dipilih agar dokumen ini mudah terbaca dan tidak umum dipakai pada sistem terpasang yang sebenarnya.

Semua contoh perintah dijalankan di bawah locale bahasa Inggris "LANG=en_US.UTF8". Jangan berharap string placeholder seperti command-in-root-account dan command-in-user-account diterjemahkan dalam contoh-contoh perintah. Ini pilihan yang disengaja untuk menjaga agar semua contoh yang diterjemahkan mutakhir.

	Catatan
	Lihat arti variabel lingkungan "$PS1" dan "$PS2" dalam bash(1).

Aksi yang diperlukan oleh administrator sistem ditulis dalam kalimat imperatif, mis. "Ketikkan tombol Enter setelah mengetikkan setiap string perintah ke shell."

Kolom deskripsi dan yang serupa dalam tabel mungkin berisi frasa kata benda mengikuti konvensi deskripsi singkat paket yang membuang artikel pembuka seperti "a" dan "the". Mereka mungkin berisi suatu frasa infinitif seperti frasa kata benda tanpa pembuka "to" mengikuti konvensi deskripsi perintah singkat dalam manpages. Ini mungkin terlihat aneh bagi beberapa orang tapi merupakan pilihan gaya yang disengaja untuk mempertahankan dokumentasi ini sesederhana mungkin. Frasa kata benda ini tidak mengkapitalkan awalannya maupun akhirannya dengan titik mengikuti konvensi deskripsi pendek ini.

Suatu cuplikan perintah dikutip dalam suatu paragraf teks yang diacu oleh fonta mesin ketik di antara tanda kutip ganda, seperti misalnya "aptitude safe-upgrade".

Suatu data teks dari sebuah berkas konfigurasi yang dikutip dalam sebuah paragraf teks diacu dengan fonta mesin ketik di antara tanda kutip ganda, seperti misalnya "deb-src".

Suatu perintah diacu oleh namanya dalam fonta mesin ketik, dan mungkin juga diikuti oleh nomor seksi halaman man di dalam kurung, seperti misalnya bash(1). Anda disarankan mendapatkan informasi dengan mengetikkan yang berikut.

$ man 1 bash

Suatu halaman man diacu oleh namanya dalam fonta mesin ketik dan diikuti oleh nomor seksi halaman man di dalam kurung, seperti misalnya sources.list(5). Anda disarankan mendapatkan informasi dengan mengetikkan yang berikut.

$ man 5 sources.list

Suatu halaman info diacu oleh cuplikan perintahnya dalam fonta mesin ketik di antara tanda kutip ganda, seperti misalnya "info make". Anda disarankan untuk mendapatkan informasi dengan mengetikkan perintah berikut.

$ info make

Suatu nama berkas diacu oleh fonta mesin ketik di antara tanda kutip ganda, seperti misalnya "/etc/passwd". Untuk berkas konfigurasi, Anda disarankan untuk mendapatkan informasi dengan mengetikkan yang berikut.

$ sensible-pager "/etc/passwd"

Suatu nama direktori diacu oleh fonta mesin ketik di antara tanda kutip ganda, seperti misalnya "/etc/apt/". Anda disarankan untuk mengeksplorasi isinya dengan mengetikkan yang berikut.

$ mc "/etc/apt/"

Suatu nama paket diacu dengan namanya dalam fonta mesin ketik, seperti misalnya vim. Anda disarankan untuk mendapatkan informasi dengan mengetikkan yang berikut.

$ dpkg -L vim
$ apt-cache show vim
$ aptitude show vim

Suatu dokumentasi dapat menunjukkan lokasinya melalui nama berkas dalam fonta mesin tik antara tanda kutip ganda, seperti "/usr/share/doc/base-passwd/users-and-groups.txt.gz" dan "/usr/share/doc/base-passwd/users-and-groups.html "; atau URLnya, seperti https://www.debian.org. Anda disarankan untuk membaca dokumentasi dengan mengetik yang berikut.

$ zcat "/usr/share/doc/base-passwd/users-and-groups.txt.gz" | sensible-pager
$ sensible-browser "/usr/share/doc/base-passwd/users-and-groups.html"
$ sensible-browser "https://www.debian.org"

Sebuah variabel lingkungan diacu dengan namanya dengan awalan "$ " dalam fonta mesin tik antara tanda kutip ganda, seperti "$TERM". Anda disarankan untuk memperoleh nilai saat ini dengan mengetik yang berikut.

$ echo "$TERM"

Data popcon disajikan sebagai ukuran objektif bagi popularitas dari setiap paket. Itu diunduh pada 2022-02-27 06:33:04 UTC dan memuat total kiriman 210215 laporan atas 185622 paket biner dan 26 arsitektur.

Angka popcon yang diawali dengan "V:" untuk "suara" (votes) dihitung dengan "1000 * (kiriman popcon bagi paket yang baru-baru ini dieksekusi pada PC)/(total kiriman popcon)".

Angka popcon yang diawali dengan "I:" untuk "instalasi" dihitung dengan "1000 * (kiriman popcon bagi paket yang dipasang pada PC)/(total kiriman popcon)".

Data ukuran paket juga disajikan sebagai ukuran objektif untuk setiap paket. Hal ini didasarkan pada "Installed-Size:" yang dilaporkan oleh perintah "apt-cache show" atau "aptitude show" (saat ini pada arsitektur amd64 untuk rilis unstable ). Ukuran yang dilaporkan dalam KiB ( Kibibyte = unit untuk 1024 byte).

Harap laporkan bug pada paket debian-reference menggunakan reportbug(1) jika Anda menemukan masalah di dokumen ini. Harap sertakan saran koreksi memakai "diff -u" ke versi teks polos atau sumber.