Bug 56969

Summary:	сломалась сборка netcdf после обновление до 1.15.0
Product:	Sisyphus	Reporter:	Anton Farygin <rider>
Component:	doxygen	Assignee:	Ivan A. Melnikov <iv>
Status:	CLOSED NOTABUG	QA Contact:	qa-sisyphus
Severity:	normal
Priority:	P5	CC:	george, iv, rider
Version:	unstable
Hardware:	x86_64
OS:	Linux

Description Anton Farygin 2025-11-23 15:46:03 MSK

после обновления 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, что бы было легче искать проблемный коммит.

Comment 1 Anton Farygin 2025-11-23 15:51:00 MSK

+ в git репозитории doxygen лежит пачка неприложенных патчей.

Comment 2 Ivan A. Melnikov 2025-11-23 22:58:12 MSK

> /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'ами. Почему они теперь считаются ошибкой я пока не смотрел, но и их несложно исправить.