The OpenNET Project / Index page

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



"Изучение изменения размера кодовой базы Ext4, Btrfs и XFS"
Версия для распечатки Пред. тема | След. тема
Форум Разговоры, обсуждение новостей
Исходное сообщение [ Отслеживать ]
Подсказка: Ссылки "<<" и ">>" открывают первые и последние 10 сообщений.
. "Изучение изменения размера кодовой базы Ext4, Btrfs и XFS" +1 +/
Сообщение от fr0ster (ok), 23-Июн-11, 15:28 
Цитата так же точна, как напев Желтой Субмарины Абрамом по телефону(С)

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

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

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

Ответить | Правка | Наверх | Cообщить модератору

Оглавление
Изучение изменения размера кодовой базы Ext4, Btrfs и XFS, opennews, 23-Июн-11, 12:28  [смотреть все]
Форумы | Темы | Пред. тема | След. тема



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

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