> For the complete documentation index, see [llms.txt](https://comaqa.gitbook.io/java-automation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://comaqa.gitbook.io/java-automation/stil-napisaniya-koda/kommentarii-v-konce-stroki.md).

# Комментарии в конце строки

## Блочные

Очень короткие комментарии могут стоять на одной строке с комментируемым кодом, но должны быть отделены от него отступом. Если таких комментариев в фрагменте кода больше одного, они должны быть выровнены по одному уровню. Избегайте комментирования, как в ассемблере, в конце каждой строки исполняемого кода.

Вот пример кода с блочным комментарием в конце строки:

```
if (a == 2) {
    return TRUE;            /* особый случай */
} else {
    return isPrime(a);      /* только для нечетной a */
}
```

## Однострочные

"//" - знак означающий начало однострочного комментария в плоть до конца строки. Он может занимать всю строку или только ее часть. Не стоит использовать однострочный комментарий для многострочного текста; однако, так можно закомментировать часть кода. Пример всех трех стилей:

```
if (foo > 1) {

    // Делаем двойной переворот
    ...
}
else {
    return false;          // Пояснение, почему так
}
//if (bar > 1) {
//
//    // Делаем тройной переворот
//    ...
//}
//else {
//    return false;
//}
```
