The OpenNET Project / Index page

[ новости /+++ | форум | теги | ]



Индекс форумов
Составление сообщения

Исходное сообщение
"Изучение изменения размера кодовой базы Ext4, Btrfs и XFS"
Отправлено fr0ster, 23-Июн-11 15:28 
Цитата так же точна, как напев Желтой Субмарины Абрамом по телефону(С)

Что собственно Страустрап по поводу комментов пишет.
http://lib.ru/CPPHB/cpptut.txt
"Можно рекомендовать такой стиль введения комментариев в
программу:

     [1] начинать с комментария каждый файл программы: указать в
         общих чертах, что в ней определяется, дать ссылки на
         справочные руководства, общие идеи по сопровождению
         программы и т.д.;
     [2] снабжать комментарием каждое определение класса или шаблона
         типа;
     [3] комментировать каждую нетривиальную функцию, указав: ее
         назначение, используемый алгоритм (если только он неочевиден)
         и, возможно, предположения об окружении, в котором работает
         функция;
     [4] комментировать определение каждой глобальной переменной;
     [5] давать некоторое число комментариев в тех местах, где
         алгоритм неочевиден или непереносим;
     [6] больше практически ничего."

Кстати говоря Бьярни не ввел бы вообще комментарии в С++ если бы считал их ненужными.
Ну и избыточные комментарии это совершенно другое дело, но против них высказывались многие и это никак не значит "код плохо написан и его надо переделывать, пока не отпадёт необходимость в комментариях"

 

Ваше сообщение
Имя*:
EMail:
Для отправки ответов на email укажите знак ! перед адресом, например, !user@host.ru (!! - не показывать email).
Более тонкая настройка отправки ответов производится в профиле зарегистрированного участника форума.
Заголовок*:
Сообщение*:
 
При общении не допускается: неуважительное отношение к собеседнику, хамство, унизительное обращение, ненормативная лексика, переход на личности, агрессивное поведение, обесценивание собеседника, провоцирование флейма голословными и заведомо ложными заявлениями. Не отвечайте на сообщения, явно нарушающие правила - удаляются не только сами нарушения, но и все ответы на них. Лог модерирования.



Партнёры:
PostgresPro
Inferno Solutions
Hosting by Hoster.ru
Хостинг:

Закладки на сайте
Проследить за страницей
Created 1996-2024 by Maxim Chirkov
Добавить, Поддержать, Вебмастеру