Perintah info Linux: menavigasi dokumentasi GNU

info adalah perintah untuk membaca manual format Info dari program GNU di terminal. Jika man lebih mirip dengan dokumen referensi yang Anda baca halaman demi halaman, naik dan turun, info membagi dokumen menjadi unit yang disebut node dan menghubungkannya dengan menu dan referensi silang, memungkinkan Anda menavigasinya seperti sebuah buku.

Untuk program dengan dokumentasi yang luas seperti GNU Coreutils, dokumen Info sering kali memberikan penjelasan lebih rinci tentang konsep, interaksi opsi, dan contoh. Artikel ini menjelaskan cara membuka dokumen, berpindah antara node dan menu, mencari teks dan indeks, langsung menuju lokasi tertentu dalam dokumen, dan apa yang harus dilakukan jika dokumen hilang.

Apa itu perintah info?

info adalah penampil dokumen berbasis teks yang membaca file Info yang dibuat dengan sistem dokumentasi Texinfo. Biasanya, file Info diinstal di direktori seperti /usr/share/info, dan satu manual dibagi menjadi beberapa node yang membentuk struktur hierarkis.

Dokumen Info dapat menyertakan menu untuk berpindah ke subtopik, referensi silang yang menunjuk ke node atau manual lain, dan indeks khusus subjek. Mereka cocok tidak hanya untuk membaca item yang diperlukan secara berurutan tetapi juga untuk mengikuti penjelasan terkait atau mencari istilah dalam indeks.

Sintaks dasar dan cara memulai

Sintaks dasar GNU Info adalah sebagai berikut. Kurung siku menunjukkan item opsional, dan elipsis berarti bahwa beberapa item dapat ditentukan, sehingga tidak dimasukkan dalam perintah yang sebenarnya.

info [options...] [manual] [menu-or-index-item...]

Jika dijalankan tanpa argumen, menu direktori tingkat atas yang mengumpulkan dokumen Info yang terdaftar dalam sistem akan terbuka.

info

Panduan penggunaan umum untuk info itu sendiri dan manual rinci GNU Info yang berdiri sendiri dapat dibuka sebagai berikut.

info info
info info-stnd

Jika nama program tertentu ditentukan, itu akan mencari entri terkait di direktori tingkat atas dan menavigasi ke manual atau node tersebut.

info ls
info coreutils

info ls dapat menautkan ke node terkait ls di dalam manual GNU Coreutils, bukan ke file ls.info yang terpisah. Ini karena entri direktori tingkat atas dapat langsung menunjuk ke node tertentu dalam sebuah manual.

Memahami struktur dokumen Info

Saat pertama kali dijalankan, ini mungkin terasa rumit karena istilah-istilah yang berbeda dari halaman web biasa atau man. Memahami empat konsep berikut membuat lebih mudah untuk mengerti struktur dokumen.

Terminologi Makna
Node Dokumen Info terdiri dari halaman-halaman. Seringkali, satu halaman sesuai dengan satu bab atau bagian.
Menu Daftar yang memungkinkan Anda berpindah ke subtopik atau item terkait dari node saat ini.
Referensi Silang (Xref) Sebuah tautan ke node lain atau manual Info lain yang terkait dengan deskripsi saat ini.
Node Direktori Menu tingkat atas yang mengklasifikasikan dan menampilkan beberapa manual Info yang terdaftar dalam sistem.

Di bagian atas layar, nama file dan node saat ini, serta target navigasi seperti Next, Prev, dan Up mungkin ditampilkan. Di garis mode bawah, status seperti manual saat ini, node, dan posisi dalam dokumen ditampilkan.

Tombol yang digunakan untuk menggerakkan layar dan menavigasi dokumen

Tabel di bawah ini didasarkan pada tombol default dari GNU Info versi mandiri. Beberapa tombol mungkin berbeda tergantung pada pengaturan pengguna atau opsi --vi-keys.

Tombol Aksi
Space Pindah ke layar berikutnya, dan di akhir sebuah node, lanjutkan ke node berikutnya.
Backspace, Delete Pindah ke layar sebelumnya. Tombol dapat bervariasi tergantung pada terminal.
n Pindah ke node Next dari node saat ini.
p Pindah ke node Prev dari node saat ini.
u Pindah ke node Up satu tingkat di atas.
t Pindah ke node Top dari file Info saat ini.
d Pindah ke node direktori yang mengumpulkan manual yang terpasang.
l Kembali ke node yang sebelumnya dilihat dari riwayat kunjungan.
m Masukkan nama untuk memilih item menu di node saat ini.
Tab, Shift+Tab Pindahkan kursor ke item menu/referensi silang berikutnya atau sebelumnya di layar.
Enter Buka item menu atau referensi silang tempat kursor berada.
H Buka jendela bantuan yang merangkum tombol-tombol dasar.
h Pindah ke node bantuan yang menjelaskan cara menggunakan Info.
q Keluar dari Info.

Saat menggunakannya untuk pertama kali, disarankan untuk membuka info info-stnd, tekan H untuk memeriksa tombol dasar, dan baca dokumen menggunakan Space dan Backspace.

Cara mengikuti menu dan referensi silang

Memilih item di layar dengan Tab dan Enter

Jika sebuah menu atau referensi silang terlihat di layar, Anda dapat berpindah antar item dengan Tab dan memilih dengan Enter. Shift+Tab kembali ke item sebelumnya. Ini adalah metode navigasi yang paling intuitif ketika Anda belum mengenal struktur dokumen.

Memasukkan nama menu dengan m

Tekan m untuk memasukkan nama item menu di area input di bagian bawah layar. Anda kemudian dapat mengetik sebagian nama dan menggunakan Tab untuk memeriksa item yang dapat dilengkapi, sehingga memudahkan bergerak cepat di menu panjang.

Setelah membaca dokumen lain dengan mengikuti menu, gunakan l untuk kembali ke posisi semula. Jika Anda ingin pindah ke node yang lebih tinggi dalam struktur, Anda sebaiknya menggunakan u daripada riwayat kunjungan.

Cara mencari konten yang diinginkan dalam dokumen

Mencari teks di dalam tubuh utama

Tekan s atau / lalu masukkan istilah untuk mencari di berkas Info saat ini. Secara default, pencarian memakai ekspresi reguler; istilah dengan huruf kapital membedakan huruf besar dan kecil. Gunakan R untuk beralih antara ekspresi reguler dan teks literal.

? mencari mundur. Untuk menuju kecocokan berikutnya gunakan } atau Ctrl+x n; untuk sebelumnya gunakan { atau Ctrl+x N. Ctrl+s dan Ctrl+r melakukan pencarian inkremental maju dan mundur saat Anda mengetik.

Menemukan topik di indeks

i mencari istilah yang dimasukkan di indeks manual saat ini dan berpindah ke node yang ditunjuk oleh entri pertama yang cocok. Ini bisa lebih cepat dan lebih akurat daripada mencari seluruh teks saat mencari nama opsi atau konsep dalam manual panjang.

I mengumpulkan entri indeks yang cocok ke dalam node virtual untuk ditampilkan. Setelah pencarian i, menekan tombol koma (,) berpindah ke entri indeks cocok berikutnya.

Mencari di semua indeks Info yang terpasang

Jika Anda tidak tahu manual mana yang berisi penjelasan, gunakan opsi -k atau --apropos di shell. Ini mencari indeks semua file Info yang terpasang, jadi mungkin membutuhkan waktu jika ada banyak dokumen.

info -k permissions
info --apropos='regular expression'

Melompat Langsung ke Manual dan Node Tertentu

Buka Berdasarkan Nama Manual atau Program

Jika Anda mengetahui nama manualnya, Anda dapat menyebutkannya secara langsung. Seluruh dokumentasi GNU Coreutils dapat dibuka sebagai berikut.

info coreutils

Jika entri khusus program terdaftar di direktori tingkat atas, Anda dapat langsung pergi ke node terkait dalam manual hanya dengan menggunakan nama program.

info ls
info cp
info date

Perintah-perintah ini mengasumsikan bahwa GNU Coreutils telah terpasang dan entri direktori Info terdaftar dengan benar.

Menentukan Nama Node

Anda dapat menentukan node awal untuk dibuka dengan -n atau --node. Nama node yang mengandung spasi harus dimasukkan dalam tanda kutip agar diteruskan sebagai satu argumen ke shell.

info coreutils -n 'ls invocation'

Anda juga dapat menentukan format referensi silang Info (manual)node sebagai satu argumen. Masukkan seluruh string dalam tanda kutip agar tanda kurung dan spasi tidak ditafsirkan oleh shell.

info '(coreutils)ls invocation'

Nama node dapat bervariasi tergantung versi dokumen yang terpasang. Jika Anda tidak yakin dengan nama yang tepat, lebih aman untuk terlebih dahulu menavigasi menggunakan info ls atau pencarian indeks.

Menemukan node yang menjelaskan cara menjalankan perintah

-O, --show-options, atau --usage menemukan node Invocation yang menjelaskan cara menjalankan program yang ditentukan dari baris perintah.

info ls -O
info --show-options coreutils

Tergantung pada struktur dokumentasi, Anda mungkin tidak menemukan node Invocation yang sesuai. Dalam kasus itu, buka dengan info program dan gunakan pencarian indeks i.

Opsi info yang sering digunakan

Opsi di bawah ini didasarkan pada GNU Info yang berdiri sendiri. Untuk opsi lengkap versi yang terpasang, periksa info --help atau info info-stnd.

Opsi Deskripsi
-k string, --apropos=string Cari string dalam indeks semua file Info yang terpasang.
-n node, --node=node Menentukan node yang akan dikunjungi terlebih dahulu.
-f manual, --file=manual Membuka manual tertentu tanpa mencari namanya di entri direktori.
-w, --where Mencetak jalur file Info yang akan dipilih tanpa membuka dokumen.
-d path, --directory=path Menambahkan jalur pencarian untuk file Info. Dapat ditentukan beberapa kali.
-o file, --output=file Alih-alih menampilkan layar interaktif, menampilkan konten node yang akan dikunjungi sebagai file.
--subnodes Digunakan dengan --output untuk menampilkan secara rekursif sub-node dari menu.
-O, --show-options Menemukan node yang menjelaskan penggunaan perintah program.
--vi-keys Mengikat ulang beberapa tombol dengan cara yang lebih mirip dengan vi dan Less.
--version Menampilkan versi Info yang terinstal.

Periksa lokasi file Info dan menampilkan teks.

Memverifikasi file dokumen yang sedang dipilih.

-w menampilkan lokasi file yang dipilih Info tanpa membuka dokumen. Ini memungkinkan Anda memeriksa dokumen mana yang dibaca ketika ada beberapa file dengan nama yang sama di jalur pencarian.

info -w coreutils

Di lingkungan yang mendukung semua jalur file yang cocok, ini dapat digunakan dengan --all.

info --all --where coreutils

Mengekspor dokumen ke file teks

Dengan -o, Anda dapat menyimpan konten ke berkas alih-alih membukanya secara interaktif. Pilih nama dan direktori tujuan baru; perintah dapat menimpa berkas yang sudah ada. --subnodes juga menyertakan subnode yang ditautkan oleh menu secara rekursif.

info --subnodes -o coreutils.txt coreutils

Jika Anda menentukan - sebagai file output, Anda dapat mengirimkannya ke output standar, sehingga mudah untuk terhubung dengan perintah lain.

info -o - coreutils | less

Karena seluruh manual bisa sangat besar, pertama pertimbangkan ukuran file dan cakupan yang Anda butuhkan. Jika hanya node tertentu yang dibutuhkan, lebih efisien menggunakan -n bersama-sama.

Menentukan dokumen pengguna dan jalur pencarian

Membuka langsung file Info lokal

File Info di direktori saat ini dapat dibuka dengan menentukan jalur relatif. Jika tanda garis miring disertakan dalam jalur, itu menargetkan file di lokasi tersebut daripada jalur pencarian umum.

info ./project.info
info -f ./project.info

File Info yang dikompresi juga dapat dibaca langsung jika formatnya didukung oleh implementasi.

Menentukan Direktori Pencarian Tambahan

Anda dapat menambahkan direktori untuk mencari dokumen menggunakan -d. Ini berguna untuk sementara membuka dokumentasi alat yang diinstal di luar jalur sistem.

info -d /opt/example/share/info example

Path pencarian yang persisten dapat dipengaruhi oleh variabel lingkungan INFOPATH. Jika Anda menetapkan nilainya secara langsung, penyertaan path default mungkin berubah, jadi pertama periksa kondisi saat ini dan hasil dari info -w manual.

printf '%s\n' "$INFOPATH"
info -w info-stnd

Perbedaan antara info dan man

Kategori info man
Struktur Dokumen Dokumen hierarkis yang dihubungkan oleh node, menu, referensi silang, dan indeks Dokumen biasanya linier yang dibaca dari atas ke bawah pada satu halaman
Penggunaan yang sesuai Saat membaca konsep, penjelasan bab, contoh panjang, dan topik terkait secara mendalam Saat memeriksa dengan cepat tata bahasa, opsi, file, dan status keluar
Target utama Program GNU dan perangkat lunak lain yang menyediakan dokumen Info Perintah, file konfigurasi, panggilan sistem, fungsi pustaka, dll.
Metode navigasi Navigasi menu/node dan pencarian teks utama/indeks Navigasi layar dan pencarian string di pager
Status instalasi Beberapa program mungkin tidak memiliki dokumen Info Beberapa paket mungkin tidak memiliki halaman man

Anda tidak harus menggunakan hanya salah satunya. Ketika Anda ingin memeriksa arti suatu opsi dengan cepat, man atau --help sangat nyaman, dan ketika Anda ingin melihat konsep keseluruhan dari program GNU dan hubungan antara opsi secara mendalam, info berguna. Pilih alat yang sesuai tergantung pada format dokumen yang disediakan oleh program dan status instalasinya.

Ketika info hilang atau dokumen tidak dapat ditemukan

Menginstal program info

Dalam lingkungan instalasi minimal, info mungkin tidak ada. Dalam keluarga Debian/Ubuntu dan Fedora/Rocky Linux, nama paket umumnya adalah info.

sudo apt update
sudo apt install info
sudo dnf install info

Perintah ini memerlukan hak administrator dan memasang paket pada sistem. Nama paket dan repositori dapat berbeda menurut distribusi dan versinya; periksa hasil pencarian paket jika nama tersebut tidak tersedia.

Periksa apakah dokumentasi Info dari program tertentu telah terpasang

Walaupun program info ada, manual yang diinginkan mungkin belum terpasang. Periksa daftar dan hasil pencarian; ganti program or topic dan manual dengan istilah dan nama yang sesuai.

info
info -k 'program or topic'
info -w manual

Jika program dan dokumentasinya disediakan dalam paket terpisah, temukan paket dokumentasi untuk program tersebut di manajer paket distribusi.

Ketika dokumen tidak muncul di menu direktori

Jika file ada tetapi tidak terdaftar di direktori tingkat atas, Anda dapat membukanya dengan menentukan jalur atau file secara langsung.

info -d /additional/document/path manual
info -f /full/path/manual.info

Jika perangkat lunak diinstal langsung dari sumber, periksa juga apakah proses instalasi memperbarui file direktori Info. Sebelum secara manual memodifikasi pendaftaran dokumentasi sistem, periksa terlebih dahulu catatan instalasi paket dan petunjuk instalasi program.

Urutan penggunaan praktis

  1. Periksa apakah dokumen terkait dapat dibuka dengan program info.
  2. Periksa bantuan kunci saat ini dengan H, dan navigasikan struktur dengan Space, n, p, u.
  3. Pilih menu yang ditampilkan di layar menggunakan Tab dan Enter atau m.
  4. Jika Anda mengetahui istilah yang tepat, cari di indeks dengan i, dan untuk frasa umum, cari di teks dengan s atau /.
  5. Jika Anda tidak tahu manual mana yang harus digunakan, cari seluruh indeks yang terpasang dari shell dengan info -k keyword.
  6. Jika Anda ingin melihat lokasi secara berulang, tentukan node secara langsung dengan -n atau keluarkan konten yang dibutuhkan dengan -o.

Pertanyaan yang Sering Diajukan

Bagaimana cara keluar dari info?

Tekan q untuk keluar. Jika Anda tidak mengetahui pengaturan tombol saat ini, tekan H huruf besar untuk memeriksa bantuan cepat.

Saat menekan n, itu berpindah ke dokumen lain alih-alih hasil pencarian

Dalam pengaturan tombol default, n berpindah ke node Next dari node saat ini, bukan hasil pencarian. Gunakan s atau / untuk pencarian teks, dan i untuk pencarian indeks. Tautan tombol dapat berubah jika Anda menggunakan --vi-keys.

Apa perbedaan antara info ls dan info coreutils?

info ls menemukan entri ls di direktori tingkat atas dan langsung pergi ke node terkait, sementara info coreutils membuka lokasi awal manual Coreutils. Tergantung pada entri direktori yang terpasang dan versi dokumen, node awal yang sebenarnya mungkin berbeda.

Apakah semua perintah memiliki dokumen Info?

Tidak. Info banyak digunakan dalam proyek GNU, tetapi tidak semua program Linux menyediakan dokumen Info. Jika tidak ada dokumen Info, periksa man command, command --help, atau dokumentasi resmi program.

Apakah dokumen Info selalu lebih akurat daripada manual man?

Tidak selalu demikian. Setiap proyek memiliki dokumen referensi dan metode pembaruan yang berbeda. Beberapa proyek, seperti GNU Coreutils, menyediakan manual Info sebagai dokumen referensi yang rinci, sementara program lain mungkin memprioritaskan halaman man atau dokumen web. Disarankan untuk memeriksa versi program yang terpasang saat ini dan dokumentasi resmi proyek.

Ringkasan

info memungkinkan Anda menavigasi manual panjang program GNU melalui node, menu, referensi silang, dan indeks. Pada awalnya, Anda dapat membaca sebagian besar dokumentasi hanya dengan mempelajari info program, H, Space, n, p, u, i, dan q.

Gunakan --help atau man untuk memeriksa sintaks dan opsi, serta info untuk penjelasan dan contoh ketika tersedia.

Rujuk dokumen resmi