- PVSM.RU - https://www.pvsm.ru -
На StackOverflow был отличный пост [1] точно на эту тему, но какой-то сверхусердный модератор, который должен остаться неназванным, удалил его (судя по всему, сейчас восстановлено — прим. пер.).
К счастью, у меня сохранилась возможность просмотреть все удаленные комментарии. Вот некоторые из моих любимых.
//
// Дорогой мейнтейнер:
//
// Когда ты закончишь «оптимизировать» эту подпрограмму
// и поймешь, насколько большой ошибкой было делать это,
// пожалуйста, увеличь счетчик внизу как предупреждение
// для следующего парня:
//
// total_hours_wasted_here = 42
//
// Когда я начинал это писать, только Бог и я понимали, что я делаю
// Сейчас остался только Бог
(Изначально цитату приписывают Карлу Вейерштрассу, относительно его математической статьи).
// иногда мне кажется, что компилятор игнорирует все мои комментарии
// Я посвящаю весь свой код, всю работу своей жене Дарлин, которой
// придётся содержать меня, наших троих детей и собаку, когда
// это пойдет в паблик.
// пьян, исправить позже
// Магия. Не трогать.
#define TRUE FALSE
// Удачного дебаггинга, молокососы
long john; // silver
(Так банально, что даже смешно).
Долговязый Джон Сильвер (Long John Silver) — персонаж романа Роберта Льюиса Стивенсона «Остров сокровищ» — прим. пер.
long long ago; /* в далёкой-далёкой Галактике */
(Это даже компилируется в C99/C++0x).
/**
* Всегда возвращает true.
*/
public boolean isAvailable() {
return false;
}
(Это доказывает, почему код *всегда* лучше, чем комментарии)
<!-- Here be dragons -->
Автор: alizar
Источник [2]
Сайт-источник PVSM.RU: https://www.pvsm.ru
Путь до страницы источника: https://www.pvsm.ru/yumor/41992
Ссылки в тексте:
[1] пост: http://stackoverflow.com/questions/184618/what-is-the-best-comment-in-source-code-you-have-ever-encountered%3E
[2] Источник: http://habrahabr.ru/post/191772/
Нажмите здесь для печати.