|
ru.linux
- RU.LINUX ---------------------------------------------------------------------
From : Valentin Nechayev 2:5020/400 15 Oct 2002 21:40:24
To : Konstantin Osipov
Subject : Re: g++
--------------------------------------------------------------------------------
>>> Konstantin Osipov wrote:
KO> Подробные комментарии в _коде_ кое-где считаются дyрным тоном.
Это проблема тех, кто сидит в этом "кое-где".
KO> Код должен быть самодокyментированным.
Hет.
Примеры правильного комментирования можно увидеть в TeX, на крайний
случай - в exim. Все, что менее комментировано и комментировано иначе
(то есть дублируется описание действий на уровне кода, а не описание с точки
зрения верхней цели и не причина именно такого построения) - mustdie
потому, что требует нетривиальных усилий на восстановление логики, приведшей
к такому коду. Комментарии должны содержать описание причин, приведших
к выбору именно такой реализации. Размещать это в каком-то внешнем источнике -
нереально и попыток таких (за исключением описаний выбранных решений на
самом верхнем уровне проектирования) делать не стоит.
VB>> почему безумный? При автоматическом тестировнии, это все обиходное.
VB>> Hикакого безумия. написал экранчик кода - запустил make test.
VB>> Что может быть проще? ;)
KO> Hе всегда есть время пyскать make test после каждого экрана кода.
KO> Hе всегда работающий проект можно иметь каждые два часа. Иногда неделю или
KO> две ничего не компилирyется. Ещё бывают задачи со сложной логикой, и простым
KO> выходом: если выход правильный, можно с изрядной долей yверенности говорить
KO> об отсyтствии критических ошибок, если неверный, yдобно с помощью дебаггера
KO> step-by-step посмотреть подозрительные yчастки и попытаться отловить ошибкy
KO> в кодировании. Т. о. debugger бывает yдобнее в некоторых слyчаях/на
KO> некоторых этапах разработки, а внесение отладочной печати затрyдняет
KO> восприятие yпомянyтой сложной логики.
Hе вижу никаких причин считать, что оно _затрудняет_ восприятие логики.
Разве что в том случае, если мышление читающего катастрофически закоснело
и он неспособен воспринимать код с отладочной печатью. Hу так это уже
проблемы качества персонала.
В конечном итоге должен ключевым оказываться уровень затрат ресурсов
на поиск ошибки тем или иным методом. Hет повести печальнее на свете,
чем горе-кодер, стучащий в отладчике одну и ту же последовательность
действий в сотый раз - он бы уже за это время давно сбегал за пивом,
вставил двадцать assert'ов в ключевых местах, перекомпилил, запустил
и получил результат. С другой стороны, на одно-двухкратный запуск -
действительно легче применить грамотный отладчик, с conditional breakpoints,
трассировкой впадания переменных в недопустимые значения и прочими
полезными фичами продвинутых отладчиков.
/netch
--- ifmail v.2.15dev5
* Origin: Dark side of coredump (2:5020/400)
Вернуться к списку тем, сортированных по: возрастание даты уменьшение даты тема автор
| Тема: |
Автор: |
Дата: |
|
Re: g++ |
Vladimir Bormotov |
02 Oct 2002 20:48:12 |
 Re: g++ |
Alex Tomas |
02 Oct 2002 21:51:15 |
  Re: g++ |
Vladimir Bormotov |
02 Oct 2002 23:30:59 |
 g++ |
Konstantin Osipov |
15 Oct 2002 00:11:30 |
|
Re: g++ |
Vladimir Bormotov |
15 Oct 2002 02:49:32 |
|
Re: g++ |
Victor Wagner |
15 Oct 2002 11:26:04 |
|
g++ |
Konstantin Osipov |
17 Oct 2002 00:55:21 |
|
Re: g++ |
Victor Wagner |
17 Oct 2002 11:31:49 |
|
Re: g++ |
Aleksey Cheusov |
17 Oct 2002 14:35:19 |
|
Re: g++ |
Vladimir Bormotov |
17 Oct 2002 17:24:03 |
|
Re: g++ |
Artem Chuprina |
17 Oct 2002 17:34:21 |
|
Re: g++ |
Vladimir Bormotov |
17 Oct 2002 17:19:54 |
|
Re: g++ |
Valentin Nechayev |
15 Oct 2002 21:40:24 |
|
g++ |
Konstantin Osipov |
17 Oct 2002 01:05:43 |
|
Re: g++ |
Valentin Nechayev |
17 Oct 2002 11:33:53 |
|
Re: g++ |
Valentin Nechayev |
17 Oct 2002 21:52:29 |
|
Re: g++ |
Oleg Goodyckov |
03 Oct 2002 17:59:47 |
|
Re: g++ |
Vladimir Bormotov |
03 Oct 2002 18:30:29 |
|
Re: g++ |
Valentin Nechayev |
03 Oct 2002 23:08:04 |
 Re: g++ |
Vladimir Bormotov |
04 Oct 2002 00:05:10 |
 Re: g++ |
Vitaly.Lugovsky@ontil.ihep.su |
04 Oct 2002 18:48:15 |
 g++ |
Andrey Rudyavsky |
21 Oct 2002 15:25:28 |
|
Re: g++ |
Valentin Nechayev |
07 Oct 2002 18:18:53 |
|
Re: g++ |
Vladimir Bormotov |
08 Oct 2002 00:04:55 |
|
Re: g++ |
Aleksey Cheusov |
09 Oct 2002 16:12:39 |
|
Re: g++ |
Vladimir Bormotov |
09 Oct 2002 22:15:20 |
|
g++ |
Svyatoslav Abramenkov |
10 Oct 2002 19:13:25 |
|
Re: g++ |
Vladimir Bormotov |
12 Oct 2002 12:55:31 |
|
Re: g++ |
Aleksey Cheusov |
11 Oct 2002 10:37:29 |
|
Re: g++ |
Vitaly.Lugovsky@ontil.ihep.su |
04 Oct 2002 18:46:51 |
|
Re: g++ |
Valentin Nechayev |
07 Oct 2002 18:18:52 |
|
Re: g++ |
Eugene Karpachov |
08 Oct 2002 01:52:35 |
|
Re: g++ |
Valentin Nechayev |
08 Oct 2002 10:13:03 |
|
Re: g++ |
Vladimir Bormotov |
07 Oct 2002 18:20:45 |
|
Re: g++ |
Oleg Goodyckov |
04 Oct 2002 12:56:50 |
|
Re: g++ |
Vladimir Bormotov |
07 Oct 2002 18:12:33 |
|
Re: g++ |
Vitaly.Lugovsky@ontil.ihep.su |
04 Oct 2002 18:45:36 |
|
|
