DOXYGEN, Eclox: функции автозаполнения не работают с декорированием макросов

У меня проблема с 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)

Кто-нибудь еще сталкивался с этой проблемой?

1

Решение

Вид решил мою проблему.

Не идеальное решение, не очень хорошее, но оно выполняет свою работу, поэтому результат, тем не менее, удовлетворительный.

В Затмении: щелкните правой кнопкой мыши ваш проект C / C ++-> Свойства-> Общие сведения о C / C ++-> Пути и символы-> Символы-> Выберите язык C (GNU C в моем случае).

Можете добавить символы которые будут приняты во внимание Eclox там: например, добавление символа __в с пустой ценность решает ситуацию, проиллюстрированную в моем первоначальном вопросе.

В моем случае я бы добавил МНОГО СИМВОЛОВ (как я уже говорил, я украшаю свои функции с помощью Microsoft SAL), что займет много времени, если будет сделано непосредственно из Eclipse. Вместо этого я добавляю только один символ и нажимаю Настройки экспорта который экспортирует их в XML для которого вы можете сделать скрипт чтобы добавить свои записи и которые вы можете импортировать впоследствии с помощью Настройки импорта.

Или так же вы можете редактировать свой .cproject файл (я предлагаю вам сначала сделать его резервную копию), если вы хотите добавить эти настройки в ВСЕ конфигурации проекта сразу же просто найдите добавленный вами символ, и вы обнаружите, что он там определен.

Рядом с Пути и символы существует также Препроцессор включает пути, макросы и т. Д.. Вы также можете использовать это, он настроен аналогично, с примечанием, что вам нужно добавить макросы в Пользовательские настройки CDT. Я пытался добавить Включить файл запись или Файл макроса препроцессора запись вместо добавления Препроцессор Макро записи, но это не сработало.

1

Другие решения


По вопросам рекламы ammmcru@yandex.ru
Adblock
detector