Belajar Emacs - Help System & Self-Documentation

#Pendahuluan

Satu hal yang membuat Emacs unik di antara semua editor: setiap fungsi, variabel, dan keybinding punya dokumentasi yang bisa diinspeksi langsung dari dalam editor. Tidak perlu buka docs site, tidak perlu man, tidak perlu googling. Episode 8 mengajarkan cara memanfaatkan kekuatan itu secara sistematis.

Mengapa ini game-changer? Karena belajar tool paling cepat bukan dengan menghafal, melainkan dengan menyelidiki saat butuh. Kalian menemukan shortcut misterius → C-h k menjelaskannya. Error aneh memanggil fungsi flymake-show-diagnostics → C-h f membuka dokumentasinya. Setelah episode ini, kalian tidak akan pernah lagi "terjebak" di Emacs — karena Emacs selalu bersedia menjelaskan dirinya.

#C-h k: Describe-Key — Selidiki Tombol

C-h k menanyakan key sequence lalu menjelaskan fungsi yang dipanggilnya:

C-h k  C-x C-f  →  describe-key: menjelaskan find-file
C-h k  C-s      →  menjelaskan isearch-forward

Cara pakai: tekan C-h k, lalu tekan kombinasi yang ingin diselidiki. Emacs membuka buffer *Help* berisi:

• Nama fungsi yang dijalankan (find-file).
• Dokumentasi lengkap fungsi.
• Binding yang sama di mode lain.
• Tautan ke source code Lisp — tekan RET pada find-file untuk langsung membuka source-nya.

#C-h f: Describe-Function

C-h f menjelaskan fungsi apa pun, tanpa harus tahu keybindingnya:

C-h f find-file RET
C-h f eglot RET
C-h f evil-mode RET

Output *Help* menunjukkan: signature, dokumentasi, hook yang terkait, dan tombol untuk membuka source. Ini cara tercepat memahami apa yang dilakukan sebuah paket sebelum menggunakannya.

#C-h v: Describe-Variable

C-h v menjelaskan variabel — pengaturan internal Emacs yang mengendalikan perilaku:

C-h v tab-width RET
C-h v fill-column RET
C-h v auto-mode-alist RET

Informasi penting: nilai saat ini, nilai default, dokumentasi, dan — krusial — (setq ...) yang disarankan untuk mengubahnya. Kebiasaan membaca C-h v sebelum mengubah variabel akan mencegah banyak konfigurasi yang keliru di episode 10.

#C-h b: Semua Binding di Buffer

C-h b mencetak seluruh keybinding yang aktif di buffer saat ini — termasuk dari minor mode:

C-h b  →  describe-bindings

Outputnya berurutan: prefix C-x, C-c, C-h, lalu per M-. Ini cara cepat menemukan "tombol apa yang tersedia untuk fitur X" — cukup C-h b lalu C-s (Isearch, episode 6) untuk mencari goto misalnya.

#C-h a: Apropos — Cari Nama

Tidak tahu nama persisnya? C-h a mencari apropos — cocokkan substring pada semua nama fungsi yang terdokumentasi:

C-h a "utf"      →  semua fungsi/variabel berisi "utf"
C-h a "window"   →  puluhan fungsi terkait window
C-h a "git"      →  cari semua yang berbau git (dengan Magit terpasang)

C-h a adalah Google lokal untuk API Emacs. C-h d (documentation search) melakukan hal serupa untuk teks dokumentasi — C-h d "recover lost file" akan menemukan recover-file (episode 23).

#M-x describe-package: Menelusuri Paket

Di episode 11 kita membahas instalasi paket; sekarang cukup tahu cara inspeksinya:

M-x describe-package RET magit RET

Buffer yang terbuka berisi: versi terpasang, versi terbaru di archive, dependensi, tombol Install/Upgrade/Delete, dan halaman penulis. Semua tanpa keluar Emacs.

#C-h e: Membaca Cerita Emacs

*Messages* adalah log aktivitas sesi — dan C-h e membukanya sebagai buffer yang bisa di-scroll:

C-h e  →  tampilkan buffer *Messages*

Setiap pesan error, setiap message dari paket, tercatat di sini. Saat sesuatu "tidak berfungsi tapi tidak jelas kenapa", C-h e adalah saksi mata pertama yang harus diperiksa.

#Workflow Menyelidiki Binding Baru

Contoh lengkap: kalian menemukan C-x r t di suatu artikel. Cara menyelidikinya:

1. C-h k C-x r t      →  apa fungsi ini? (transpose-lines? no — string-rectangle!)
2. RET pada nama fungsi → buka source
3. C-h f string-rectangle → baca dokumentasi & contoh
4. C-h a rectangle     →  temukan saudara fungsinya (episode ini mengajarkan kelincahan)

Empat langkah itu memakan waktu 30 detik dan langsung membuat kalian paham — bukan sekadar menghafal tombol.

#Penutup

Pada episode 8 ini, kalian telah mempersenjatai diri dengan help system Emacs.

Inti yang harus dibawa pulang:

• C-h k menjelaskan keybinding; C-h f fungsi; C-h v variabel.
• C-h b semua binding buffer; C-h a apropos (cari nama); C-h d cari di dokumentasi.
• M-x describe-package menelusuri paket; C-h e membaca log *Messages*.
• Pola selidik: C-h k → C-h f → source → C-h a.

Di episode 9 selanjutnya, kita membuka bahasa yang menjadi jantung Emacs: Emacs Lisp dasar — s-expression, defun & defvar, evaluasi ekspresi dengan C-x C-e, dan buffer *scratch* sebagai playground pertama kalian menulis fungsi kustom. Sampai jumpa di episode 9!