Saat menulis alat untuk CLI UNIX, bagaimana saya harus membuat program mencetak bantuan dan / atau penggunaan?
Saya biasanya menggunakan fprintf(stderr, "help text here");
, tetapi ada beberapa masalah dengan itu.
- Pertama, saya tidak yakin, apakah saya harus menggunakan
stderr
. Apakah itu OK, atau haruskah saya gunakanstdout
? - Seperti yang dapat Anda bayangkan, teks bantuannya cukup panjang, tergantung pada berapa banyak opsi yang dimiliki alat ini. Sekarang, saya biasanya, cukup masukkan beberapa
"strings like that\n"
di parameter kedua. Namun ini, mengisi kode sumber saya dengan lima puluh atau lebih baris teks bantuan. Tidak mudah dikelola sama sekali. Apa yang harus saya lakukan? - Ketika sebuah alat tidak ditulis dalam bahasa C atau seperti C, saya cenderung menggunakan di sini-docs jika memungkinkan (paling jelas dengan Perl). Saya tidak bisa menggunakannya di C, tetapi apakah ada sesuatu seperti itu, yang bisa saya gunakan?
- Saya sedang mempertimbangkan meletakkannya di
headerfile.h
dalam#define HELP "help text here"
, saya belum pernah melihatnya di alam liar, tidak tahu apakah saya benar-benar harus menggunakannya.
Idealnya, saya bisa meletakkan teks dalam file eksternal, dan memasukkannya. Menggunakan #include
untuk itu tampaknya salah. Apa yang harus saya lakukan?
Idenya adalah, untuk memiliki teks bantuan, yang mudah dikelola. Memiliki itu di dalam kode sumber tidak benar-benar nyaman.