Как говорит @kgrad, / * * / не вкладывается и может вызывать ошибки. Лучший ответ:
// LINE *of code* I WANT COMMENTED
// LINE *of code* I WANT COMMENTED
// LINE *of code* I WANT COMMENTED
В большинстве сред IDE есть одна клавиатурная команда для выполнения / отмены этого, поэтому на самом деле больше нет причин использовать другой стиль. Например: в eclipse выделите блок текста и нажмите Ctrl + /
Чтобы отменить этот тип комментария, используйте Ctrl + \
ОБНОВЛЕНИЕ: Соглашение о кодировании Sun говорит, что этот стиль не должен использоваться для блока текст комментарии:
// Using the slash-slash
// style of comment as shown
// in this paragraph of non-code text is
// against the coding convention.
но // можно использовать 3 других способа:
- Однострочный комментарий
- Комментарий в конце строки кода
- Комментирование блока кода