I3: Tingkatkan perbedaan antara arahan dan perintah konfigurasi

Dibuat pada 20 Mar 2019  ·  4Komentar  ·  Sumber: i3/i3

Saya mengajukan…

 [ ] Serangga
 [] Permintaan fitur
 [x] Permintaan Dokumentasi
 [ ] Lainnya (Tolong jelaskan secara rinci)

Perilaku Saat Ini

Di saluran dukungan kami, saya sering melihat kebingungan arahan dan perintah konfigurasi, khususnya jika menyangkut for_window dan kriteria yang cocok. Kita harus memperjelas apa perbedaan antara config / perintah, dan bahwa pengguna hanya dapat menjalankan perintah saat runtime tetapi tidak mengubah konfigurasi.

i3 4.16

4.16 accepted documentation enhancement good first issue

Komentar yang paling membantu

Oke, saya akan membahasnya. Terima kasih.

Semua 4 komentar

Saya akan bersedia melakukan ini. Apakah ini akan sesederhana file teks, atau apakah saya akan mengedit file dokumentasi?

Kita harus memperbarui panduan pengguna untuk ini ( docs/userguide ). Itu sendiri sudah dipisahkan menjadi konfigurasi dan perintah, tetapi saya pikir perbedaannya tidak cukup jelas bagi pengguna. Bagian yang relevan adalah

  1. https://i3wm.org/docs/userguide.html#for_window
  2. https://i3wm.org/docs/userguide.html#list_of_commands

Khususnya yang terakhir, petunjuk eksplisit bahwa arahan konfigurasi yang tercantum di bawah https://i3wm.org/docs/userguide.html#configuring tidak dapat diubah saat runtime kecuali jika mereka memiliki perintah yang setara, saya pikir akan sangat berguna.

Oke, saya akan membahasnya. Terima kasih.

Saya setuju, bagian for_window dimulai dengan

Dengan perintah for_window ...

yang pasti bisa menyesatkan. Mengubah yang melakukan sesuatu seperti "arahan" dapat membantu.

Apakah halaman ini membantu?
0 / 5 - 0 peringkat