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