Bagaimana saya bisa membaca dokumentasi tentang perintah zsh bawaan?

Coba salah satu dari ini:

man zshbuiltins

atau

man zshall

Halaman manual untuk zsh dibagi berdasarkan topik, man zsh sebagian besar adalah daftar isi dan pengantar sementara man zshall adalah segalanya (24628 baris pada sistem saya dibandingkan dengan 5242 untuk man bash ).

Adapun bindkey , man zshbuiltins akan mengarahkan Anda ke man zshzle .

Informasi utama untuk mendapatkan utilitas bantuan yang lebih berguna sebenarnya disertakan dengan Zsh, hanya masalah menemukan halaman manual yang kritis—dan sulit ditemukan—:man zshcontrib (di sini di web), yang menjelaskan run-help gawit:

Secara default, run-help adalah alias untuk man perintah, jadi ini sering gagal ketika kata perintah adalah shell bawaan atau fungsi yang ditentukan pengguna. Dengan mendefinisikan ulang run-help alias, seseorang dapat meningkatkan bantuan online yang disediakan oleh shell.

Lebih lanjut dijelaskan cara menggantinya dengan peningkatan bawaan.

Setelah menyiapkan ini, panggil run-help untuk nama builtin, fungsi penyelesaian dan sebagainya sekarang akan mencoba menunjukkan kepada Anda dokumentasi yang diekstraksi, atau menunjukkan kepada Anda halaman manual yang berisi hak, dll. Misalnya run-help bindkey keluaran:

bindkey
   See the section `Zle Builtins' in zshzle(1).

yang bisa lebih baik. Untuk contoh yang lebih baik, run-help history menunjukkan bagian halaman manual Zsh untuk fc , yang merupakan perintah yang mendasari history .

Juga berguna untuk dicatat:ESC-h akan memanggil run-help untuk perintah pada baris input saat ini.

Saya menganggap pengaturan ini bukan default karena mengekstraksi data bantuan granular dan menyetel HELPDIR untuk menunjukkannya mungkin keputusan pengemasan diserahkan kepada distribusi OS. Ada juga pilihan pengguna:autoload run-help util berguna tanpa menyetel HELPDIR sama sekali. Tampaknya bagus untuk membawa Anda ke halaman manual yang tepat meskipun tidak dapat melompat ke bagian yang tepat untuk satu item. Beberapa mungkin lebih suka ini daripada mengalami kasus seperti bindkey contoh di atas yang hanya membuang-buang waktu. (Mengapa standarnya adalah alias run-help=man lalu, saya tidak bisa mengerti).

Untuk Zsh versi 5.0.3 atau lebih baru

helpfiles ekstraksi kemungkinan disertakan dengan distribusi Zsh. Anda hanya perlu menemukan mereka di sistem Anda untuk menyetel HELPDIR jika Anda mau—kemungkinan kandidat ada di /usr/share/zsh atau /usr/local/share/zsh , cari help subdirektori.

Untuk versi Zsh sebelum 5.0.3

Anda mungkin harus mengikuti prosedur yang dirinci dalam man zshcontrib diri Anda untuk menghasilkan file bantuan. Agak menyebalkan jika harus melakukan ini, tetapi sebaliknya cepat dan tidak menyakitkan.

Temukan versi terinstal Anda dengan zsh --version dan dapatkan tarball sumber yang sesuai dari arsip sourceforge. Kemudian jalankan helpfiles skrip seperti yang ditunjukkan di halaman manual dan tetapkan target sebagai HELPDIR di ~/.zshrc Anda .