У меня проблемы с пониманием некоторых команд Doxygen, принимающих параметры в качестве первого аргумента (используя вывод HTML)
Здесь речь идет о команде \include, но я считаю, что ответы (если таковые имеются) будут применяться к другим командам.
Руководство говорит:
При желании вы можете добавить опцию {lineno}, чтобы включить номера строк для включенного кода.
Вы можете добавить опцию {doc}, чтобы рассматривать файл как документацию, а не как код.
Я не могу заставить это работать.
Это:
\include doc path/to/my/file
отлично работает. Но содержимое файла рассматривается как код (что совершенно нормально), и на самом деле оно содержит некоторое сгенерированное содержимое, которое я хочу отформатировать как документацию.
Я попробовал это (да, не смейтесь, пожалуйста):
\include doc path/to/my/file
\include [doc] path/to/my/file
\include {doc} path/to/my/file
\include {[doc]} path/to/my/file
\include [{doc}] path/to/my/file
но ни одна из этих работ.
И то же поведение с опцией lineno.
Чтобы завершить, я должен упомянуть, что руководство дает некоторую информацию о записи здесь :
Некоторые команды имеют один или несколько аргументов. Каждый аргумент имеет определенный диапазон:
Если используются фигурные скобки, аргумент является одним словом.
Если используются (круглые) фигурные скобки, аргумент продолжается до конца строки, в которой была найдена команда.
Если используются фигурные скобки, аргумент продолжается до следующего абзаца. Абзацы разделены пустой строкой или индикатором раздела.
Но я не понимаю, как это относится к приведенной выше цитате руководства по команде \include.
У кого-нибудь есть подсказка?
Версия Doxygen: 1.8.11 (последняя версия Ubuntu 16.04).