سؤال حول التعليقات في لغة Java

التعليقان متشابهان من ناحية ولكن الأخير يُستخدم للتعليقات التي يُراد عن طريقها إنشاء توثيق Documentation، مثلا عن طريق أداة javadoc. في هذه الحالة فإن النص الموجود بين **/ و */ سيظهر كفقرة في ملف html الخاص بالتوثيق.

للمزيد حول Javadoc:

السلام عليكم و رحمة الله

التوثيق يمكنك من وضع شروح أو توصيفات سواء للكلاس أو الدوال حول كيفية عملها. بحيث أن أي مبرمج آخر يستطيع الرجوع للتوثيق لفهم الكلاس أو الدالة دون الحاجة للرجوع للشيفرة (الكود). هذا التوثيق يتم عادة إنتاجه باستخدام javadoc

الرابط التالي يحتوي على مثال للتوثيق