Panduan Man Gentoo

1.  Pendahuluan

Program man

Setiap pengguna kemungkinan besar pernah menggunakannya. Dialah perintah man. Namun, walaupun program man itu sendiri kelihatannya memiliki bentuk yang sederhana, ia memiliki beberapa kemampuan tambahan selain untuk menggulung halaman. Dokumen ini dibuat untuk membantu anda mengetahui kemampuan ini.

Layout Man

Halaman manual kebanyakan disimpan di direktori /usr/share/man. Namun, selama halaman manual diletakkan di variabel lingkungan MANPATH, man akan dapat menemukannya. Gentoo biasanya meletakkan variabel MANPATH di dalam /etc/env.d. Di dalam direktori ini terdapat beberapa folder yang memiliki struktur manX, di mana X adalah nomor seksi. Sebagai contoh, layout standar man terlihat seperti berikut:

$ ls /usr/share/man | grep man
man0p
man1
man1p
man2
man3
man3p
man4
man5
man6
man7
man8
man9
mann

Penomoran seksi ini terlihat cukup standar. Namun, perhatikan adanya mann dan beberapa folder man#p. Tabel berikut ini berisi direktori halaman manual di atas dan apa yang ada di dalamnya:

Daftar di atas mungkin tidak terlalu lengkap, namun berisi banyak halaman manual sering yang diperlukan. Terkadang anda dapat dengan mudah mengetahui apa yang dilakukan oleh sebuah seksi dengan melihat tabel tersebut. Bab berikut akan menjelaskan cara menggunakan man untuk memahami layout man.

2.  Bekerja dengan layout man

Menelusuri layout man

Setelah kita mengetahui layout man, kita dapat mulai menggunakannya untuk mencari perintah-perintah. Terkadang kita mungkin perlu memperuncing halaman manual yang kita perlukan. Cara pertama adalah dengan mencari alamat seksinya. Untuk mengetahui penjelasan dari sebuah seksi, anda dapat menggunakan perintah seperti man section intro :

$ man 3 intro
(Output sedikit diubah agar cocok dengan dokumen)
INTRO(3)               Linux Programmer's Manual                INTRO(3)



NAME
       intro - Introduction to library functions

DESCRIPTION
       This chapter describes all library functions excluding the library
       functions described in chapter 2, which implement system calls.
       There are various function groups which can be identified by a
       letter which is appended to the chapter number:
....

Sayangnya, hal ini tidak selalu bisa digunakan. Namun, kita beruntung karena ada cara lain untuk mencari perintah yang dapat memberikan beberapa hasil (seperti sebuah library call dan perintah sistem yang memiliki nama yang sama). Untuk melakukannya kita gunakan parameter -K pada man seperti:

$ man -K sleep
/usr/share/man/man0p/time.h.0p.gz? [ynq] n
/usr/share/man/man0p/unistd.h.0p.gz? [ynq] n
/usr/share/man/man2/alarm.2.gz? [ynq] n
/usr/share/man/man2/pause.2.gz? [ynq] n
/usr/share/man/man2/futex.2.gz? [ynq] n
/usr/share/man/man2/nanosleep.2.gz? [ynq] y
/usr/share/man/man2/semop.2.gz? [ynq] q

Kadang-kadang outputnya jauh lebih besar. Pada kasus ini, anda mungkin lebih baik memberikan kata kunci yang lebih spesifik. Setelah kita mengetahui cara mencari halaman manual, seksi selanjutnya akan menjelaskan cara membukanya.

Membaca halaman manual

Membaca halaman manual bisa dilakukan dengan dua cara, pertama dengan man [nama halaman manual] dan man [seksi] [nama halaman manual]. Mari kita gunakan bc sebagai contoh. Kita dapat membaca halaman manual manapun yang pertama kali ditampilkan dengan bc (yaitu seksi 1, karena merupakan seksi terendah yang memiliki halaman manual untuk bc):

$ man bc
bc(1)                                            bc(1)


NAME
       bc - An arbitrary precision calculator language
...

Tetapi, bagaimana jika kita menginginkan versi POSIX? Kita dapat menggunakan bentuk kedua:

$ man 1p bc
BC(P)        POSIX Programmer's Manual           BC(P)


NAME
       bc - arbitrary-precision arithmetic language
...

Maka halaman manual akan ditampilkan. Sekarang setelah halaman dibuka, saatnya untuk bekerja dengannya. Seksi selanjutnya akan menjelaskan cara navigasi dan melakukan pencarian di dalam halaman manual.

Melakukan navigasi dan pencarian pada halaman manual

Menavigasi halaman manual cukup sederhana. Untuk naik dan turun sejauh satu baris, gunakan tombol panah atas dan bawah. Untuk naik/turun satu halaman, anda dapat menggunakan tombol PgUp dan PgDn. Namun perlu dicatat bahwa instruksi navigasi ini mengasumsikan variabel lingkungan PAGER diatur ke perintah penggulung halaman default, yaitu less. Less juga memiliki beberapa perintah lain untuk navigasi, tetapi biasanya tomobl-tombol panah sudah cukup:

  e  ^E  j  ^N  CR  *  Maju satu baris                      (atau N baris).
  y  ^Y  k  ^K  ^P  *  Mundur satu baris                    (atau N baris).
  f  ^F  ^V  SPACE  *  Maju satu jendela                    (atau N jendela).
  b  ^B  ESC-v      *  Mundur satu jendela                  (atau N jendela).
  z                 *  Maju satu jendela                    (dan set jendela ke N).
  w                 *  Mundur satu jendela                  (dan set jendela ke N).
  ESC-SPACE         *  Maju satu jendela, tetapi jangan berhenti pada akhir file.
  d  ^D             *  Maju setengah jendela                (dan set setengah jendela ke N).
  u  ^U             *  Mundur setengah jendela              (dan set setengah jendela ke N).
  ESC-)  RightArrow *  Gerak ke kiri setengah lebar layar   (atau N posisi).
  ESC-(  LeftArrow  *  Gerak ke kanan setengah lebar layar  (or N posisi ).
  F                    Maju terus; seperti "tail -f".

Bagaimanapun juga, proses pencarian jauh lebih menarik. Dua pencarian yang paling sederhana adalah /pattern dan ?pattern. Versi pertama mencari ke arah depan, sedangkan yang kedua mencari ke arah belakang. pattern adalah sebuah pola regular expression yang dijelaskan di man 7 regex. Mari kita coba melakukan pencarian opsi -D di manual emerge. Pertama buka halaman manual emerge:

$ man emerge

Kemudian, di layar, tekan tombol / untuk membuka prompt entri untuk melakukan pencarian ke arah depan lalu masukkan pencarian kita:

     gracefully handles updating installed packages to newer releases as well.
     It handles both source and binary packages, and it can be used to create
     binary packages for distribution.

EBUILDS, TBZ2S, CLASSES AND DEPENDENCIES
/\-D

Perintah tadi akan melakukan pencarian dan membawa item yang dicari ke fokus:

  --deep (-D)
        When used in conjunction with --update, this flag forces emerge to consider the entire
        dependency tree of packages, instead of checking only the immediate dependencies of
        the packages.  As an example, this catches updates in libraries that are not directly
        listed in the  dependencies of a package.

Jika anda melewati hasil pencarian secara tidak sengaja dan ingin melanjutkan pencarian yang sama, tekan kembali tombol / lalu tekan enter (tidak usah memasukkkan apa-apa). Ini akan melakukan pencarian untuk pola yang telah kita berikan sebelumnya. Pada beberapa halaman manual, pertama diberikan daftar opsi-opsi yang tersedia kemudian baru penjelasannya. Ambil contoh manual portage (man 5 portage). Pertama diberikan daftar file-file yang digunakan oleh portage, kemudian penjelasan dari kegunaannya masing-masing. Melakukan pencarian ke arah depan bisa memberikan beberapa hasil, namun ada cara yang lebih mudah untuk menangani hal ini, yaitu dengan bentuk pencarian kedua, yaitu pencarian ke arah depan. Mari kita gunakan bentuk pencarian ini untuk menemukan penjelasan dari package.unmask. Pertama, ketik man 5 portage:

$ man 5 portage

Sekarang tekan SHIFT+g. Ini akan membawa anda ke akhir halaman:

SEE ALSO
       emerge(1), ebuild(1), ebuild(5), make.conf(5)

Portage 2.0.51        Jan 2004            PORTAGE(5)
lines 418-442/442 (END)

Sekarang kita memasukkan kata yang akan dicari dengan opsi pencarian ke arah belakang, ?pattern. Pertama tekan tombol ? untuk membuka prompt, kemudian masukkan package.unmask, pencarian kita:

SEE ALSO
       emerge(1), ebuild(1), ebuild(5), make.conf(5)

Portage 2.0.51        Jan 2004           PORTAGE(5)
?package.unmask

Kemudian tekan enter untuk membuka hasil:

  package.unmask
       Just like package.mask above, except here you list packages you want to unmask.
       Useful for overriding the global  package.mask  file (see below).  Note that
       this does not override packages that are masked via KEYWORDS.
...

Pencarian sudah selesai! Perlu diketahui bahwa sama seperti /, menekan ? tanpa memasukkan kata akan melakukan pencarian kata yang terakhir dicari.

Penutup

Sampai di sini panduan man. Mudah-mudahan dapat sedikit membantu anda dalam menavigasi halaman manual, dan mungkin memberikan tips baru untuk anda yang sudah berpengalaman. Bagi anda yang lebih suka menggunakan cara lain untuk membaca halaman manual, tersedia program-program berikut:

• app-text/man2html - program untuk merubah halaman manual ke html
• app-text/tkman - browser halaman manual berbasis tk

Browser web KDE, yakni Konqueror, juga dapat menelusuri halaman manual dengan memasukkan sintaks man: di kolom alamat.

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