Оформление исходников

[rlens]

Уважаемые форумчане!
Подскажите пожалуйста для чего в исходниках Qt'шных примеров (fortuneserver.h, fortuneserver.cpp) вставляют строки:
...
//! [1]
...
//! [2]
...
Заранее спасибо.

[mutineer]

Чтобы в текстовом описании на них ссылаться

[rlens]

каким образом? и зачем? и почему перед цифрами стоят знаки //!
это же спец. символы для документирования Doxygena

[Bepec]

rlens это примеры. К примерам прилагается описание. Описание генерируется текстовыми генераторами из комментариев. По поводу оформления комментариев достигнуты несколько соглашений. В данном случае они оформляются так и служат ссылками при генерации документации. Как бы вот так.

PS доксиген не единственный генератор. Их много.

[DmitryM]

каким образом? и зачем? и почему перед цифрами стоят знаки //!
это же спец. символы для документирования Doxygena

Google забанил? qdoc3

[rlens]

тогда чем генерится документация для Qt'шных примеров?

[Bepec]

Смотри выше *рукалицо*