rt-thread/documentation
Chen Wang d58958e397 doxygen: support 1.9.8
The current test environment is mainly based on Ubuntu
22.04 LTS and doxygen version is 1.9.1.
But when we switch to Ubuntu 24.04, the default Doxygen
version on Ubuntu 24.04 is 1.9.8.
The supported configuration and layout file formats
differ from those in 1.9.1 (Ubuntu 22.04).
In particular, the layout XML file format of 1.9.8 is
incompatible with the older format(1.9.1). Therefore,
to support Doxygen on Ubuntu 24.04, we need to load
different configuration and layout files. (The layout
file is specified using the LAYOUT_FILE parameter in
the configuration file.)

Solution: Provide corresponding configuration and layout
files for different Doxygen versions, distinguished by
the Doxygen version number.

Currently, only Doxygen versions 1.9.1 and above are supported.
If the doxygen version is >= 1.9.1 but < 1.9.8, the 1.9.1
configuration and layout are used by default. If the doxygen
version is >= 1.9.8, the 1.9.8 configuration and layout are used.

Only 1.9.1 and 1.9.8 have been tested, as these are the
default doxygen versions on Ubuntu 22.04 LTS and Ubuntu
24.04. Other versions have not been tested yet. If
necessary, we will change the configuration based on
the same approach in the future.

Signed-off-by: Chen Wang <unicorn_wang@outlook.com>
2025-10-10 20:19:05 +08:00
..
0.doxygen doxygen: fix two issues when building with doxygen 1.9.8 (#10768) 2025-10-10 10:05:06 +08:00
1.introduction doxygen: Improve the text description of the introduction section 2025-02-21 21:58:19 -05:00
2.quick-start doxygen: add prefix for page name (#9989) 2025-02-13 23:28:19 +08:00
3.kernel doxygen: updated doc for thread management subsystem 2025-09-02 18:05:44 +08:00
4.tool doxygen: reorganize directory structure 2025-02-25 11:27:58 +08:00
6.components doxygen: fix two issues when building with doxygen 1.9.8 (#10768) 2025-10-10 10:05:06 +08:00
7.contribution doxygen: reorganize directory structure 2025-02-25 11:27:58 +08:00
env doxygen: update doc for env to latest 2025-09-10 16:52:48 +08:00
figures update README.md studio.gif, README_zh.md studiozh.gif (#5875) 2022-04-30 21:02:48 +08:00
Doxyfile.1.9.1 doxygen: support 1.9.8 2025-10-10 20:19:05 +08:00
Doxyfile.1.9.8 doxygen: support 1.9.8 2025-10-10 20:19:05 +08:00
DoxygenLayout-1.9.1.xml doxygen: support 1.9.8 2025-10-10 20:19:05 +08:00
DoxygenLayout-1.9.8.xml doxygen: support 1.9.8 2025-10-10 20:19:05 +08:00
INDEX.md doxygen: move device_driver under to components for pages 2025-05-29 13:47:46 +08:00
run.sh doxygen: support 1.9.8 2025-10-10 20:19:05 +08:00