rt-thread.git/documentation, branch copilot/refactor-hwtimer-ktime-cputime

[clock_time] Add unified clock_time subsystem with documentation

2025-12-04T15:26:42Z

- Created new clock_time subsystem consolidating hwtimer/ktime/cputime - Implemented clock_time device abstraction with ops structure - Added high-resolution timer (hrtimer) implementation - Created compatibility layers for legacy APIs - Added comprehensive English and Chinese documentation - Updated Kconfig to mark old subsystems as deprecated Co-authored-by: BernardXiong <1241087+BernardXiong@users.noreply.github.com>

fix(doc): Exclude 'src/utest/perf/README.md' from Doxygen build (RT-Thread#10888)

2025-11-06T02:43:28Z

Problem description: The file 'src/utest/perf/README.md' was incorrectly appearing as a root-level page in the Doxygen documentation output. Problem analysis: This file was unintentionally included by the Doxygen build process following commit 7499790. It is an internal README for performance tests and is not intended to be part of the generated documentation. Solution: The issue is resolved by explicitly excluding this file from the build. The path '../src/utest/perf/README.md' has been added to the EXCLUDE list in both 'documentation/Doxyfile.1.9.1' and 'documentation/Doxyfile.1.9.8'. This issue was originally introduced by the following commit: Commit: 7499790 Title: utest: core: move perf testcase from example to src Signed-off-by: lhxj <2743257167@qq.com>

[format][version]: synchronize bsp version configuration

2025-10-23T14:06:51Z

utest/msh: supports autocomplete of utest cases for utest_run (#10701)

2025-10-20T04:46:44Z

* utest/msh: supports autocomplete of utest cases for utest_run * docs/utest: explanation of adding the automatic completion function for utest_run * fix[utest]: Improvement of annotation description * remove outdated code

doxygen: update doc for utest for config naming rule

2025-10-15T01:43:16Z

Configuration options naming rule for utest is changed from "RT_UTEST_TC_USING_XXXX" to "RT_UTEST_XXXX". Signed-off-by: Chen Wang

doxygen: support 1.9.8

2025-10-10T12:19:05Z

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

doxygen: fix two issues when building with doxygen 1.9.8 (#10768)

2025-10-10T02:05:06Z

* doxygen: remove @return command if function return void When doxygen is upgraded to v1.9.8 (on ubuntu 24.04), doxygen reports: "doxygen error: found documented return type for xxx that does not return anything" for those functions which return void but declare "@return" in doxygen comment. Solution: remove "@return" for those cases, and update guide document for how to write doxgen comment for functions. Signed-off-by: Chen Wang * doxygen: fixed a minor typo for uart doc This error is found when building with doxygen 1.9.8, but not detecetd on 1.9.1. Signed-off-by: Chen Wang

utest: remove RT_UTEST_USING_ALL_CASES

2025-09-26T01:57:54Z

Many modules' utests currently don't support enabling all tests at once. Furthermore, some modules' tests are complex, for example due to their numerous dependencies on other modules. This makes it nearly impossible to enable all tests with a single global switch. Consequently, the previously defined `RT_UTEST_USING_ALL_CASES` has lost its original meaning. We recommend deprecating this configuration switch. If a module needs to enable a group of functional tests through its own configuration, this local enable all switch should be implemented by the module itself, and a global RTT enable switch will no longer be provided. If such a requirement arises in the future, we recommend careful design, especially considering how to ensure that turning on a single switch enables all dependencies for all involved modules for ease of use. Signed-off-by: Chen Wang

doxygen: update naming rule for utest-case

2025-09-15T11:40:31Z

More details see PR #10681. As utest cases are currently moving out of `examples/utest/testcases` into their own module directories, the naming rule needs to change accordingly. Signed-off-by: Chen Wang

doxygen: update doc for env to latest

2025-09-10T08:52:48Z

The introduction to Env under the documentation section of the RTT source code repository is outdated and unmaintained. We recommend moving the Env documentation to https://github.com/RT-Thread/env/ for self-maintenance. Solution: Direct users to the latest README at https://github.com/RT-Thread/env/. The Env content under the documentation section of RTT will not be deleted for now, but will be marked as "outdated". Signed-off-by: Chen Wang