У меня проблема с Eclox, плагином Doxygen для Eclipse.
Я использую его для документирования своего кода на C / C ++.
Реально приятной особенностью этого является то, что он автоматически генерирует комментарии для функций, когда пишет «/ **», а затем ENTER перед определением функции.
Начальный (код 1):
/** <--pressing enter after this results in code 2-->
int f(int a, int b)
Код после нажатия введите (код 2):
/**
*
* @param a
* @param b
* @return
*/
int f(int a, int b)
Проблема заключается в том, что я использую синтаксис SAL Microsoft при написании своих функций, и f будет выглядеть примерно так:
int f(__in int a, __in int b)
что приводит в замешательство Eclox и не позволяет ему автоматически генерировать @param & @ вернуть вещи. Так что у меня осталось следующее:
/**
*
*/
int f(__in int a, __in int b)
даже если __in определен как пустой во включенном файле:
#define __in
Обратите внимание, что если я вставлю вышеуказанное определение в ТО ЖЕ файл, он будет работать:
#define __in
/** <--now pressing enter here works as expected-->
int f(__in int a, __in int b)
Кто-нибудь еще сталкивался с этой проблемой?
Вид решил мою проблему.
Не идеальное решение, не очень хорошее, но оно выполняет свою работу, поэтому результат, тем не менее, удовлетворительный.
В Затмении: щелкните правой кнопкой мыши ваш проект C / C ++-> Свойства-> Общие сведения о C / C ++-> Пути и символы-> Символы-> Выберите язык C (GNU C в моем случае).
Можете добавить символы которые будут приняты во внимание Eclox там: например, добавление символа __в с пустой ценность решает ситуацию, проиллюстрированную в моем первоначальном вопросе.
В моем случае я бы добавил МНОГО СИМВОЛОВ (как я уже говорил, я украшаю свои функции с помощью Microsoft SAL), что займет много времени, если будет сделано непосредственно из Eclipse. Вместо этого я добавляю только один символ и нажимаю Настройки экспорта который экспортирует их в XML для которого вы можете сделать скрипт чтобы добавить свои записи и которые вы можете импортировать впоследствии с помощью Настройки импорта.
Или так же вы можете редактировать свой .cproject файл (я предлагаю вам сначала сделать его резервную копию), если вы хотите добавить эти настройки в ВСЕ конфигурации проекта сразу же просто найдите добавленный вами символ, и вы обнаружите, что он там определен.
Рядом с Пути и символы существует также Препроцессор включает пути, макросы и т. Д.. Вы также можете использовать это, он настроен аналогично, с примечанием, что вам нужно добавить макросы в Пользовательские настройки CDT. Я пытался добавить Включить файл запись или Файл макроса препроцессора запись вместо добавления Препроцессор Макро записи, но это не сработало.