Comments 12
С прошлой работы: есть модуль, делающий что-то совсем неочевидное. Пять файлов исходников, и на все один комментарий:
; Плохо!
<зануда> И во фразе БГ про 640 КБ было все-таки не should, а ought to be enough - гораздо более осторожный вариант. :-Р </зануда>
На работе как-то встретили в своем же коде двухгодичной давности.
// TODO: подумать
Долго думали, о чем надо было подумать, так и не поняли :)
В одном проекте встретил такой кусок кода, если происходит неожиданный поворот событий.
static void ...
{
...
fprintf(stderr, "can't %s `%zu' bytes: %s (https://www.youtube.com/watch?v=bq6gMJgguHY)", op, size, strerror(errno));
abort();
}
double penetration = 1.0;
Я когда писал свой вариант тетриса назвал переменную, которая хранит информацию о падающем фрагменте, piece_data. Осознание аллюзии наступило не сразу.
Заменяем слеши - рука-лицо...
метод drawChildren()
Мне в LabVIEW комменты нравятся, поскольку это графическое программирование, то и комменты можно картинками разбавлять (кстати, удобно, когда формулы и графики), но там также и анимированные гифки можно вставлять (они при компиляции удаляются).
Баг как есть:
Разбирался в чужом коде и наткнулся на комментарий: "Не забыть отремить!!! Не забыл."
Шутим в комментариях к коду