Глава 2.6 Комментарии.

     Прежде, чем переходить к описанию объектно-ориентированного программирования на языке Java, следует рассказать о еще одной составной части синтаксиса любого языка - комментариях. В языке Java существуют несколько видов комментариев - кратко рассмотрим и проанализируем все.

1. Комментарии в одну строку.
   Начинаются с двух слешей (//) и могут занимать только одну строку. Можно использовать для кратких замечаний и пояснений:
   

   // Это коментарий

2. Если одной строки недостаточно, можно воспользоваться другим видом комментария - в несколько строк. Начинается такой комментарий с символов /*, далее идет тело комментария, начинающееся в каждой строке с звездочки (*), и заканчивается все символами */.
   

   /* Для инициализации переменных мы вводим значения с клавиатуры по очереди:
   * первое - для нулевого элемента,
   * второе - для первого
   * и так далее,
   * не забывая разделять их запятыми.
   */
   

3. Комментарии для документов будут использоваться на первых стадиях изучения Java редко. Они предназначены для программы javadoc, которая автоматически генерирует документацию в виде HTML-файлов. В программном коде они чаще всего располагаются перед классами, объявленными public (что это такое смотрите в главе 3.6). Выглядят они также, как и предыдущий вид комментариев, только начинаются не с /*, а с /** (слеша и двух звездочек).

Второй и первый вид комментариев мы будем часто использовать для разъяснения фрагментов программного кода.