Пособие по практике программирования


бесплатные ставки на спорт и тотализатор в букмекерских. | Заказать монтаж электропроводки на даче Новокузнецк и пригороде. Русский электрик.

Пример 1.47








В этом содержательном комментарии имеется ссылка на описание алгоритма, кратко представлены используемые данные, обозначена производительность алгоритма и показано, когда и для чего была произведена модификация кода.

Не комментируйте плохой код, а передишите его. Все необычное или потенциально смущающее стоит комментировать, но когда комментарий по своему размеру приближается к коду, то, скорее всего, код стоит подправить. В приводимом примере используются длинный, путаный комментарий и условно компилируемое выражение для распечатки отладочной информации — и все это для пояснения всего лишь одного выражения:




Содержание  Назад  Вперед