после обновления doxygen он стал как-то плохо работать с одинарными ' Сборка документации стала падать: [builder@localhost docs]$ doxygen -d extcmd -u ../docs/Doxyfile && doxygen -w html ../docs/header.html ../docs/footer.html ../docs/custom_style.css ../docs/Doxyfile && doxygen ../docs/Doxyfile && cp ../docs/auth.md ../docs/obsolete/fan_utils.html html Configuration file '../docs/Doxyfile' updated. /usr/src/RPM/BUILD/netcdf-4.9.3/docs/install-fortran.md:230: error: Reached end of file while still searching closing '`' of a verbatim block starting at line 215 (warning treated as error, aborting now) Если отключить WARN_AS_ERROR то ошибок вылезает больше - в каждом файле .md Явно проблема где-то в doxygen. Заодно предлагаю сборку doxygen переделать на сборку из git, что бы было легче искать проблемный коммит.
+ в git репозитории doxygen лежит пачка неприложенных патчей.
> /usr/src/RPM/BUILD/netcdf-4.9.3/docs/install-fortran.md:230: error: Reached end of file while still searching closing '`' of a verbatim block starting at line 215 (warning treated as error, aborting now) Doxygen 1.15.0 стал строже к markdown'у. Вот так решил апстрим. В 1.15.0 появилась (и теперь включена по умолчанию) опция MARKDOWN_STRICT. Из changelog'а: Minor incompatibilities New option MARKDOWN_STRICT which is enabled by default, and will no longer treat ' as the end of a quoted text started with `(e.g. `word'). If you depend on the old behavior, set this option to NO. Добавьте в Doxyfile MARKDOWN_STRICT=NO или исправтье файлы, чтобы в них inline verbatim, открывающийся bactick'ом, им же и закрывался, как в markdown и положено. Также в двух файлах в netcdf встречаются inline verbatim блоки, открывающиеся и закрывающиеся четырьмя backtick'ами. Почему они теперь считаются ошибкой я пока не смотрел, но и их несложно исправить.
