2013-03-06 3 views
0

Когда Doxygen используется для документирования вложенной структуры C вроде следующего -Doxygen: Уплотненная структура именования

struct level0 {   
    struct level1 {    
     struct level2 {    
      int data1;    
     } var_level2a;   

     struct level2b {  
      int data2;  
      int data3;  
     } var_level2b;  

    } var_level1;  
};  

сгенерированного документа структуры названа как это -

  • структуры level0 :: level1 :: level2a
  • структура level0 :: level1 :: level2b

мы можем иметь просто structu вновь будет отображаться имя (внутренне он может иметь полное имя с разрешением области видимости «::» вещи для вида), как это -

  • структура level2a
  • структура level2b

Просьба предоставить помощь. Быстрый ответ будет очень полезен.

+0

Это недвусмысленный, я считаю. Вы можете четко видеть структуру там. –

+0

Спасибо, что ответили. действительно безопасно в проблеме двусмысленности. У нас есть уникальные имена для внутренних структур, чтобы они не конфликтуют. но проблема заключается в том, когда doxygen читает вложенный стиль определения структур, в которых он использует это разрешение «::». это делает название структуры длинным и запутанным для обычных читателей, которые не знакомы с doxygen. , поэтому наше требование состоит в том, чтобы иметь только краткие имена структуры в документе RTF. Это можно добиться каким-либо образом? ... в @ref мы можем указать ссылку 'labels'; но это автоматически созданные ссылки, на которые у нас нет никаких элементов управления. –

ответ

0

Вы пробовали установить HIDE_SCOPE_NAMES на YES?

+0

Hi Doxygen, Спасибо за ваш ответ. Да, мы пробовали это, но это не решает проблему. На самом деле я не мог узнать изменения, которые он внес в выходной документ, если мы установили для этого HIDE_SCOPE_NAMES значение ДА или НЕТ. Я, с опытом, вижу, что в некоторых случаях параметры настройки конфигурационного файла не всегда работают, как говорится. Я использую последнюю версию Doxygen, и проблема существует в версиях Windows и Linux. С тех пор как вы создали этот инструмент, можете ли вы предложить, есть ли стабильная (и имеющая почти такие же функции, как и последняя) версия, в которой вышеупомянутая вещь будет работать? –

+0

Если вы обнаружите, что что-то не работает как задокументированное или ожидаемое, то, пожалуйста, напишите отчет об ошибке для него в отладчике ошибок doxygen и включите автономный пример (файл конфигурации + источник в zip или tar). Я могу только исправить проблемы, которые я могу воспроизвести. Doxygen имеет более 200 опций, поэтому я не могу проверить все возможные настройки. – doxygen

Смежные вопросы