Apa arti #XXX dalam komentar kode?

Saya telah banyak melihat ini dalam kode, bahkan vim menandainya sebagai kasus khusus. #TODOdan #FIXMEdua penanda fix vim highlight lainnya tapi apa #XXXartinya?

XXXdalam komentar biasanya pemberitahuan awal. Bisa jadi:

• Sesuatu yang tidak diterapkan sepenuhnya dengan benar.
• Sesuatu yang harus diperbaiki nanti.
• Menyoroti kemungkinan tempat bermasalah.
• Sesuatu yang tidak Anda yakini, sebuah pertanyaan.

Saya sering lebih suka tag yang lebih deskriptif seperti FIXMEatau TODOatau HACK. XXXsering digunakan sebagai tangkapan semua hal di atas.

Mencari 'XXX' pada referensi silang kode FreeBSD adalah contoh bagus dari banyak penggunaan. Ada ribuan ...

• NOTE: Deskripsi tentang cara kerja kode (jika tidak terbukti dengan sendirinya).
• XXX: Peringatan tentang kemungkinan jebakan, dapat digunakan sebagai NOTE:XXX:.
• HACK: Tidak ditulis dengan baik atau kode yang salah format untuk menghindari masalah / bug. Harus digunakan sebagai HACK:FIXME:.
• FIXME: Ini berfungsi, semacam, tetapi bisa dilakukan dengan lebih baik. (biasanya kode ditulis dengan terburu-buru sehingga perlu ditulis ulang).
• BUG: Ada masalah di sini.
• TODO: Tidak masalah, tetapi kode tambahan perlu ditulis, biasanya saat Anda melewatkan sesuatu.

Setidaknya begitulah cara saya diajari tentang tag ini. Pada dasarnya dua yang pertama ( NOTEdan XXX) digunakan untuk informasi dan tidak ada tindakan yang diperlukan. Sedangkan tiga yang terakhir ( FIXME, BUGdan TODO) memang membutuhkan tindakan. HACKada di antara keduanya (dan saya pikir hampir tidak pernah digunakan?).

Beberapa catatan dari Proposal Peningkatan Python Juni 2005 yang ditolak .

Sulit memilih antara FIXMEdan XXX.
XXXtampaknya lebih umum, tetapi kurang deskriptif.
Selain itu, XXXadalah tempat penampung yang berguna dalam potongan kode yang
memiliki nilai yang tidak diketahui.

Demikianlah FIXMEejaan yang disukai.
Sun mengatakan itu XXXdan FIXMEsedikit berbeda, memberikan XXXtingkat keparahan yang lebih tinggi.
Namun, dengan kekacauan selama beberapa dekade tentang topik ini, dan terlalu banyak jutaan
developer yang tidak akan terpengaruh oleh Sun, mudah untuk menyebut mereka sinonim.

PEP Dimulai dengan,

PEP ini telah ditolak. Meskipun komunitas mungkin tertarik,
tidak ada keinginan untuk membuat perpustakaan standar sesuai dengan standar ini.

...

Apa itu Codetags?

Pemrogram secara luas menggunakan konvensi markup komentar kode ad-hoc untuk berfungsi sebagai pengingat bagian kode yang perlu diperiksa atau ditinjau lebih dekat. Contoh markup termasuk FIXME, TODO, XXX, BUG, tapi ada banyak lagi digunakan secara luas dalam perangkat lunak yang ada. Markup tersebut selanjutnya akan disebut sebagai codetag . Codetags ini dapat muncul dalam kode aplikasi, pengujian unit, skrip, dokumentasi umum, atau dimanapun sesuai.

PEP adalah bacaan yang menarik.

Silakan lihat di PEP350 . Ini menjelaskan semua TODO, XXXdll. Saya menggunakannya setiap hari ketika saya tidak dapat mengingat dengan tepat apa arti salah satu tag kode.

Saya menggunakan XXXkarena lebih mudah untuk mengetik daripada TODO.

XXX adalah untuk saat Anda sedang terburu-buru dan akan kembali ke ini sendiri.

TODO adalah saat Anda harus menyerahkannya kepada orang lain.

Mungkin untuk kasus-kasus yang Anda tidak tahu cara menanganinya.
Lihat ini: Tampilan daftar pernyataan TODO / FIXME / XXX / HACK

teks alt http://editra-plugins.googlecode.com/svn/wiki/images/commentbrowser/cb_screenshot.PNG

Dari konvensi kode Java (lama) :

Gunakan XXX di komentar untuk menandai sesuatu yang palsu tetapi berfungsi. Gunakan FIXME untuk menandai sesuatu yang palsu dan rusak.

XXX adalah singkatan dari peringatan yang sedikit berbeda dari NOTE tapi sangat mirip dengan HACK. Ini mungkin bug di pustaka / kode pihak ketiga yang sedang digunakan dan kode dengan // XXX: menunjukkan bahwa itu adalah solusi karena bug dalam kode pihak ketiga atau bisa berarti "hati-hati" bagi seseorang yang melihat / memodifikasi kode untuk menunjukkan mengapa sesuatu dilakukan dengan cara tertentu yang mungkin tampak tidak benar / tidak elegan pada pandangan pertama. HACK adalah istilah umum yang berarti solusi untuk masalah yang mungkin ada di basis kode Anda sendiri atau pustaka pihak ketiga.

Saya percaya sementara FIXMEuntuk pengembang, dan HACKuntuk pengelola, XXXuntuk pengguna.

Misalnya, jika Anda mengabaikan XXXdan memanggil fungsi ini di tempat lain, tanpa memahami cara kerjanya, sesuatu yang tidak terduga dapat terjadi, dan orang yang menangani masalah ini tidak akan senang (setidaknya orang yang menambahkan XXXanggapan tersebut). Anda mungkin berpikir masalahnya akan hilang jika Anda tidak menggunakan fungsi ini.

Namun karena FIXME, Anda akan merasa layak untuk memperbaiki kode agar berfungsi. Dan karena HACK, Anda mungkin tidak memiliki pilihan yang lebih baik meskipun Anda tidak menggunakannya.

Jika Anda menulis XXXpada kode Anda sendiri dan seseorang menggunakannya, Anda mungkin merasa tidak senang karena alasan seperti Anda benar-benar menulis ulang kode itu, dan kemudian berperilaku dengan cara yang sangat berbeda, dan Anda melanggar kode orang lain. Tetapi jika Anda meninggalkan FIXMEatau TODOsebaliknya, Anda tidak akan terlalu peduli.

Saya menggunakan // XXX jadi saya tidak perlu mengingat nomor baris. Alih-alih, saya hanya menelusuri XXX saat ingin kembali ke bagian kode itu.