Doxygen: несколько \mainpage блоков в проекте C++
Я не смог определить то, что поведение doxygen расценивает \mainpage раздел, в двух случаях:
- Если Вы указываете нет
\mainpageразделите, это использует какую-либо другую страницу вместо этого и раз так как это выбрано? - Что, если два файла оба указывают a
\mainpageраздел?
1 ответ
Команда \ mainpage определяет содержимое, используемое для настройки страницы индекса, поэтому, если вам его не хватает, это просто пустая страница с обычным заголовком и нижним колонтитулом Doxygen.
Я думаю, что безопаснее всего сказать о наличии нескольких команд \ mainpage , что это undefined в классическом смысле, дающее непредсказуемые результаты в зависимости от версии и платформы. Точно так же у меня были странные результаты, когда я случайно создал более одной команды \ page с тем же именем страницы.
Дальнейшие размышления
На вопрос , отвечая на другой вопрос Doxygen , помните, что вы можете заставить Doxygen подчиняться директивам препроцессора, чтобы вы могли использовать условные выражения #if для защиты нескольких директив главной страницы и запускать различные файлы конфигурации поверх та же база кода, где файлы конфигурации определяют одно из нескольких значений флага.
Я использовал этот подход к созданию документов с разных точек зрения , чтобы опубликовать Macintosh и Windows-ориентированные версии одного и того же справочника.