Комментарии в C коде

doxygen, например, создаёт документацию по комментариям.
например:
/**
* @param field - desctiption
*/

или:
/*!
* my description block
*/

Промышленный стандарт ныне http://en.wikipedia.org/wiki/Javadoc схожий снтаксис перелез и в другие генераторы.

Благодарю за ссылку! Действительно ведь. А есть еще какие-нибудь препроцессоры, которые смотрят на /** ?

You'd better avoid using /* */ style of comments altogether and use only one liners //.

Imagine a situation: you need to comment out a big chunk of code with such (/* */) comments. You suddenly realize that C doesn't allow nesting such comments ;-)

Если твой редактор не позволяет выделить блок и сделать в нем s!^!//!, то ты не то что неудачнег, а полный балбес.

попробуй потом скомпилить этот код на Legacy системах

это ты о чем?

// - коментарии такого вида это расширения С++, а не исконно С-шные, поэтому на многих машинах типа SGI IRIX, AIX ранних версий и (если не ошибаюсь) если установлен флаг компилятора следовать стандарту ANSI (не c99), этот стиль комментариев будет интерпретироваться препроцессором как синтаксическая ошибка

> You'd better avoid using /* */ style of comments altogether and use only one liners //.

Я так не думаю. А вкладывать комментарии не надо вообще.

Огромное спасибо за помощь. Заодно открыл себе doxygen :) Интересная штука, однако!