Panduan Info Gentoo

1.  Pendahuluan

Apa itu info?

Kebanyakan dari anda mungkin sudah akrab dengan sistem dokumentasi man. Walaupun man cukup bagus untuk mencari item tertentu, man tidak memiliki kemampuan untuk mengkaitkan banyak manual secara bersamaan. Di sinilah info beraksi. Halaman info ditulis dengan texinfo, yang dapat mengkaitkan satu manual dengan manual lainnya, menciptakan menu dan memudahkan pengarahan secara umum. Seksi berikut ini membahas layout halaman info.

Layout halaman info

Halaman utama info ditempatkan di /usr/share/info. Tidak seperti model layout direktori man, /usr/share/info berisi koleksi file yang lebih banyak. File-file ini memiliki format berikut:

pagename.info[-node].gz

pagename adalah nama yang sebenarnya dari halaman tersebut (mis: wget). [-node] adalah kunstruksi tambahan yang menunjukkan level node lain (biasanya inilah yang direferensikan oleh level teratas dari dokumen info). Untuk menghemat ruang, halaman info dipadatkan dengan skema pemadatan gzip. Halaman info tambahan bisa anda daftarkan dengan variabel lingkungan INFOPATH biasanya ditetapkan dengan berbagai file di dalam /etc/env.d/). Untuk memulai, penting bagi anda untuk mengenal file /usr/share/info/dir. File ini digunakan ketika info dijalankan tanpa parameter. File ini berisi daftar semua halaman info yang tersedia. Untuk mulai membaca halaman info, kita akan menjalankannya tanpa argumen:

$ info

Pada bab selanjutnya kita akan mempelajari dasar-dasar cara membaca halaman info.

2.  Membaca halaman info

Menjelajahi menu

Setelah info dijalankan, kita akan mendapatkan tampilan seperti ini:

File: dir,      Node: Top       This is the top of the INFO tree

  This (the Directory node) gives a menu of major topics.
  Typing "q" exits, "?" lists all Info commands, "d" returns here,
  "h" gives a primer for first-timers,
  "mEmacs<Return>" visits the Emacs manual, etc.

  In Emacs, you can click mouse button 2 on a menu item or cross reference
  to select it.

* Menu:

User Interface Toolkit
* GDK: (gdk).           The General Drawing Kit
* GTK: (gtk).           The GIMP Toolkit

GNU programming tools
* Autoconf v2.1: (autoconf).         Create source code configuration scripts.

Di sini ada beberapa entri yang memiliki tanda asterisk (bintang). Item inilah yang kita gunakan untuk menjelajahi level node lain. Ada dua cara untuk memilih menu. Kita akan mempelajarinya satu persatu. Pertama, kita akan membuka halaman info wget. Untuk melakukannya, gunakan tombol panah bawah sampai anda mencapai area yang diberi warna biru:

Network Applications
* GnuTLS: (gnutls).                     Package for Transport Layer Security.
* Wget: (wget).         The non-interactive network downloader.
* certtool: (gnutls)Invoking certtool.  Manipulate certificates and keys.
* gnutls-cli: (gnutls)Invoking gnutls-cli.      GNU TLS test client.
* gnutls-cli-debug: (gnutls)Invoking gnutls-cli-debug.  GNU TLS debug client.
* gnutls-serv: (gnutls)Invoking gnutls-serv.    GNU TLS test server.
* srptool: (gnutls)Invoking srptool.    Simple SRP password tool.

Setelah anda berada di area ini, tekan tombol ENTER untuk memilih item tersebut. Halaman info untuk wget akan ditampilkan.

File: wget.info,  Node: Top,  Next: Overview,  Up: (dir)

Wget 1.10.2
***********

This manual documents version 1.10.2 of GNU Wget, the freely available
utility for network downloads.

   Copyright (C) 1996-2005 Free Software Foundation, Inc.

* Menu:

* Overview::            Features of Wget.
* Invoking::            Wget command-line arguments.
* Recursive Download::  Downloading interlinked pages.
* Following Links::     The available methods of chasing links.
* Time-Stamping::       Mirroring according to time-stamps.
* Startup File::        Wget's initialization file.

Setelah halaman info ditampilkan, bagian berikut ini akan membahas dasar-dasar navigasi.

Navigasi dasar

Dalam istilah node, tampilan di atas adalah node Top (puncak) dari halaman info wget. Bayangkanlah node Top sebagai daftar isi dari halaman info. Sekarang untuk menavigasinya, anda bisa menggunakan bebreapa metode. Pertama adalah dengan metode standar info, yaitu dengan tombol SPASI untuk maju ke halaman selanjutnya dan tombol BACKSPACE/DELETE untuk mundur. Metode ini adalah metode yang dianjurkan karena akan langsung melanjutkan/mengembalikan node yang sesuai pada dokumen. Dengan ini anda dapat melakukan penjelajahan secara linear/lurus seperti pada man. Cara lain adalah dengan menggunakan tombol PAGE UP/PAGE DOWN, tetapi anda tidak dapat melanjutkan/mengembalikan node seperti dengan metode SPACE/BACKSPACE/DELETE. Jika anda ingin melangkahi seluruh node tanpa menggunakan SPACE/BACKSPACE/DELETE, anda juga dapat menggunakan tombol [ (loncat mundur) dan ] (loncat maju).

Seperti yang telah kami jelaskan, ada dua metode untuk menavigasi menu. Metode lainnya akan kami jelaskan sekarang. Nomor 1-9 menunjuk ke entri menu pertama sampai menu kesembilan dari dokumen. Anda dapat menggunakannya untuk membaca dengan cepat. Misalnya, kita akan menggunakan 3 untuk mencapai entri menu Recursive Download. Jadi, sekarang tekan 3:

File: wget.info,  Node: Recursive Download,  Next: Following Links,  Prev: Invoking,  Up: Top

3 Recursive Download
********************

GNU Wget is capable of traversing parts of the Web (or a single HTTP or
FTP server), following links and directory structure.  We refer to this
as to "recursive retrieval", or "recursion".

Kita sudah mencapai layar Recursive Download. Sekarang saat yang tepat untuk mencatat beberapa hal. Yang pertama adalah seksi header. Header menampilkan navigasi yang dapat dilakukan pada layar saat ini. Halaman ini diindikasikan oleh Next: dapat diakses dengan tombol n, dan halaman Prev: dapat diakses dengan tombol p. Perlu diketahui bahwa cara ini hanya dapat dilakukan pada level yang sama. Jika salah, anda bisa saja dibawa ke halaman yang tidak ada hubungannya sama sekali. Untuk itu anda lebih baik menggunakan SPACE/BACKSPACE/DELETE/[/] untuk melakukan navigasi secara linear.

Jika anda tersesat, ada beberapa cara untuk keluar. Pertama adalah dengan tombol t. Dengan ini anda dapat langsung kembali ke halaman info yang anda jelajahi. Jika anda ingin kembali ke halaman terakhir yang anda baca, gunakan tombol l. Jika anda ingin kembali ke level di atasnya, gunakan tombol u. Setelah anda mengetahui dasar-dasar ini, bab selanjutnya akan menjelaskan cara melakukan pencarian di dalam dokumen.

3.  Melakukan pencarian di dalam info

Navigasi ke halaman info lain

Setelah anda mengetahui cara melakukan navigasi pada suatu halaman info, penting sekali untuk mengetahui cara mengakses halaman info lain. Cara paling jelas yang pertama adalah melalui daftar indeks dir dari halaman info yang tersedia. Untuk mendapatkan indeks dir dari sebuah dokumen, tekan tombol d. Dari sana anda dapat mencari halaman info yang anda inginkan. Namun, jika anda sudah mengetahui nama halaman info yang anda inginkan, ada cara yang lebih mudah, yaitu dengan perintah Goto node (tombol g). Untuk mencapai sebuah halaman info dengan namanya, tekan g untuk menampilkan prompt, lalu masukkan nama halaman info yang anda inginkan:

* Startup File::        Wget's initialization file.
* Examples::            Examples of usage.
* Various::             The stuff that doesn't fit anywhere else.
* Appendices::          Some useful references.
* Copying::             You may give out copies of Wget and of this manual.
--zz-Info: (wget.info.gz)Top, 24 lines --Top-------------------------------
Goto node: (libc)

Ini akan membuka halaman info libc seperti berikut:

File: libc.info,  Node: Top,  Next: Introduction,  Prev: (dir),  Up: (dir)

Main Menu
*********

This is Edition 0.10, last updated 2001-07-06, of `The GNU C Library
Reference Manual', for Version 2.3.x of the GNU C Library.

* Menu:

* Introduction::                 Purpose of the GNU C Library.

Setelah kita mengetahui cara membuka halaman info dengan namnya, bagian selanjutnya akan membahas pencarian informasi dengan menggunakan indeks halaman info.

Melakukan pencarian dengan indeks

Pada contoh ini kita akan mencari fungsi printf pustaka C dari indeks halaman info libc. Seharusnya sekarang anda masih berada di halaman info libc hasil dari contoh kita sebelumnya, dan jika tidak, gunakan perintah "Goto node" untuk mendapatkannya. Untuk menampilkan prompt pencarian, tekan tombol i, lalu masukkan kata yang anda cari. Kita akan melakukannya untuk mencari kata printf:

* Character Set Handling::       Support for extended character sets.
* Locales::                      The country and language can affect the
                                   behavior of library functions.
* Message Translation::          How to make the program speak the user's
                                   language.
--zz-Info: (libc.info.gz)Top, 1291 lines --Top-- Subfile: libc.info-1.gz-----
Index entry: printf

Setelah menekan enter, kita akan dibawa ke definisi libc untuk printf:

File: libc.info,  Node: Formatted Output Functions,  Next: Dynamic Output,  Prev: Other Output Conversions,  Up: Formatted Output

12.12.7 Formatted Output Functions
----------------------------------

This section describes how to call `printf' and related functions.
Prototypes for these functions are in the header file `stdio.h'.
Because these functions take a variable number of arguments, you _must_
declare prototypes for them before using them.  Of course, the easiest
way to make sure you have all the right prototypes is to just include

Kita sudah berhasil melakukan pencarian pada indeks halaman info libc. Namun, terkadang kita menginginkan halaman itu sendiri. Bagian selanjutnya akan menerangkannya.

Melakukan pencarian dengan perintah pencarian

Mulai dari lokasi sebelumnya di node Formatted Output Functions, kita akan melihat cara melakukan pencarian untuk variasi sprintf dari fungsi printf. Untuk melakukannya, tekan tombol s agar prompt ditampilkan, lalu masukkan kata yang ingin anda cari (sprintf pada contoh ini):

 -- Function: int wprintf (const wchar_t *TEMPLATE, ...)
     The `wprintf' function prints the optional arguments under the
     control of the wide template string TEMPLATE to the stream
     `stdout'.  It returns the number of wide characters printed, or a
--zz-Info: (libc.info.gz)Formatted Output Functions, 127 lines --Top-- Subfile: libc.info-3.gz--
Search for string []: sprintf

Tekan ENTER dan anda akan mendapatkan hasilnya:

-- Function: int sprintf (char *S, const char *TEMPLATE, ...)
     This is like `printf', except that the output is stored in the
     character array S instead of written to a stream.  A null
     character is written to mark the end of the string.

     The `sprintf' function returns the number of characters stored in
     the array S, not including the terminating null character.

Dan kita telah mendapatkan fungsi yang kita cari.

4.  Penutup

Penutup

Bagian di atas menutup panduan tentang cara menggunakan info untuk membaca halaman info. Seperti biasa, kami akan sangat menerima komentar dari anda tentang panduan ini. Kirimkan e-mail anda dengan mengklik nama penulis (Chris White).

Program-program Tambahan

Untuk mempermudah anda yang ingin menjelajahi halaman-halaman info dengan antarmuka grafis yang lebih bersahabat, anda dapat menggunakan program-program berikut ini:

• app-text/info2html - Merubah halaman info ke format HTML yang dapat dijelahahi
• app-text/pinfo - pembaca info berbasis ncurses
• app-text/tkinfo - penjelajah info berbasis tcl/tk
• app-vim/info - penjelajah info berbasis vim

Browser Konqueror milik KDE juga dapat anda gunakan untuk menjelajahi halaman info dengan memasukkan info: di kolom alamat.

Isi dokumen ini dilisensikan dengan lisensi Creative Commons - Attribution / Share Alike.