Очень короткие комментарии могут стоять на одной строке с комментируемым кодом, но должны быть отделены от него отступом. Если таких комментариев в фрагменте кода больше одного они должны быть выровнены по одному уровню. Избегайте комментирования, как в ассемблере, в конце каждой строки исполняемого кода.
Вот пример кода с блочным комментарием в конце строки:
if (a == 2) {
return TRUE; /* особый случай */
} else {
return isPrime(a); /* только для нечетной a */
}
"//" - знак означающий начало однострочного комментария в плоть до конца строки. Он может занимать всю строку или только ее часть. Не стоит использовать однострочный комментарий для многострочного текста; однако, так можно закомментировать часть кода. Пример всех трех стилей:
if (foo > 1) {
// Делаем двойной переворот
...
}
else {
return false; // Пояснение, почему так
}
//if (bar > 1) {
//
// // Делаем тройной переворот
// ...
//}
//else {
// return false;
//}