пятница, 17 июля 2009 г.

Примеры комментариев


По просьбе Ilya Kulakov привожу два примера того, как могли бы выглядеть комментарии.

Первый пример (не знаю, хорошо ли будет видно...):




(Для особо внимательных: в этом кусочке есть опечатка. Она уже исправлена. Капчу переделывать лень. :-))

Второй пример - даже не комментарий, а как бы просто "маркер": он говорит, что, мол, в этом месте неплохо бы написать комментарий такого-то содержания. Такие маркеры также приветствуются.



И последнее замечание. На самом деле, комментарии вовсе не обязаны быть "умными". У меня полно коротеньких комментариев типа "об этом подробнее сказано в таком-то разделе", "здесь такой-то термин использован неправильно, надо такой-то" и даже "простите за буквоедство, но здесь опечатка"...

3 комментария:

Анонимный комментирует...

Осмелюсь написать комментарий.

n2800
3.3.1 Point of declaration
6 Могу только пример предложить
class A
{
public:
class B;
void f(class C);
};

B* b; // Error
C* c; // OK

Ну вот как-то так :)

Александр М.

Анонимный комментирует...

новых творческих начинаний в новом году!

petrenkov комментирует...

It was rather interesting for me to read this post. Thanks for it. I like such topics and anything that is connected to them. I would like to read more soon.

Best regards
Jeph Normic