Вам нужно открыть свои комментарии как комментарии Doxygen с /**
.
Может быть, это будет понятнее:
int main() {
/** \brief Integer 1 */
int iOne;
/** \brief Integer 2 */
int iTwo;
/** \brief Integer 3 */
int iThree;
/** ... and so on ... */
}
Таким образом, вы можете изменить имя переменной, не нарушая вашу документацию, и это также облегчает работу других программистов, которым нужно читать ваш исходный код, потому что описание переменной находится рядом с ним, а не где-то еще в файле.