summaryrefslogtreecommitdiff
path: root/documentation
AgeCommit message (Collapse)Author
2025-02-13doxygen: add prefix for page name (#9989)Chen Wang
Add prefix "page_" to the name of pages. Add this as a rule in guide of writing doxygen documents. Signed-off-by: Chen Wang <[email protected]>
2025-02-11doxygen: add documentation for doxygenChen Wang
Documentation is provided to clarify how to write doxygen documentation for RT-Thread. This document is also integrated as part of RT-Thread doxygen documentation. An example is also provided. The original README.md is removed and integrated into this document. Updated github actions for doxygen too. Signed-off-by: Chen Wang <[email protected]>
2025-01-27[doxygen] add doxygen comment for clk.c and clk.h (#9950)wumingzi
Accroding to #9947 and #9424, adding doxygen comment for function in .c files and data structure, macro in .h file is a solution.For this pr, I encountered problem following situations. - rt_clk_unprepare function return value type is different from rt_clk_ops so I change type of rt_clk_unprepare and its dependencies. - clk_get function may be similar as rt_clk_unprepare but I'm not sure so not modify. - clk_release implements may be incomplete, so I just marked in comment. Signed-off-by: 1078249029 <[email protected]>
2025-01-26doxygen: create framework to unify markdown and source code part (#9946)Chen Wang
* doxygen: adjust documentation directory structure - Rename documentation/doxygen to documentation/0.doxygen and cleanup some unused files. - Add/rename folders for each sub sections, such as 1.introduction/...... Each sub section will be created as a subpage. - Generate initial Doxyfile, this Doxyfile will be used to unify doxygen generated API documents and those markdown files under documentation folder. This patch just add the default Doxyfile generated by running "doxygen -g". It is used as baseline to add more features/configurations. - Rename documentation/README.md to documentation/INDEX.md, and use it as mainpage. - Move 0.doxygen/readme.md to documentation/README.md. * doxygen: update configurations These configurations are from old documentation/doxygen/Doxyfile. Try best to compatible exixting design. * doxygen: add run script Add a script to automatic some operations. Updated the README.md. --------- Signed-off-by: Chen Wang <[email protected]> Co-authored-by: Supper Thomas <[email protected]>
2025-01-03[doc]Update doxygen rtthread_logo.png (#9861)Rbb666
2024-12-22doc: introduce how to build & run doxygen on ubuntuChen Wang
Update readme doc to introduce how to build doxygen and run html on Ubuntu machines. Signed-off-by: Chen Wang <[email protected]>
2024-11-26[documentation][Finsh]fix the wrong comments for FINSH_USING_SYMTAB macro in ↵ligr
markdown files.
2024-09-15[doxygen] add driver example for doxygen (#9446)Supper Thomas
2024-09-13[drivers] Specifies the name of the drivers driver fileCXSforHPU
https://github.com/RT-Thread/rt-thread/pull/9420
2024-08-15删除rt_thread_sleep遗留Meco Man
2024-06-26[doc][doxygen] Fix doxygen struct error.supperthomas
Signed-off-by: supperthomas <[email protected]>
2024-06-26[doc][doxygen]: Fix doxygen warning in commentsupperthomas
kservice.c:474: warning: The following parameter of rt_backtrace_to_buffer(rt_thread_t thread, struct rt_hw_backtrace_frame *frame, long skip, rt_ubase_t *buffer, long buflen) is not documented: parameter 'thread' kernel.h:157: warning: unable to resolve reference to '_rt_errno' for \ref command Signed-off-by: supperthomas <[email protected]>
2024-04-18[mem] Remove useless code And Update mem documentationwdfk-prog
2023-11-10[debug] rename RT_DEBUGING_INIT as RT_DEBUGING_AUTO_INITMeco Man
2023-10-29[action] Doxygen ci fix (#8191)Supper Thomas
2023-08-08rt_hw_cpu_shutdown: implement default weak functionMeco Man
and remvoe duplicated default functions in each cpu/bsp level
2023-07-30[docs] add env vscode documentMeco Man
2023-07-28[.github] add CONTRIBUTING.mdMeco Man
https://docs.github.com/en/communities/setting-up-your-project-for-healthy-contributions/setting-guidelines-for-repository-contributors
2023-07-25[doc][qemu] update qemu for windows docMeco Man
2023-07-25[docs][qemu] update quick_start_qemu_windowsMeco Man
2023-07-23[doc][env] update env documentMeco Man
2023-07-22[debug] 整理debug宏并增加RT_DEBUGING_CONTEXT (#7805)Man, Jianting (Meco)
2023-07-09[debug] remove RT_DEBUG_xxxMeco Man
remove RT_DEBUG_THREAD RT_DEBUG_SCHEDULER RT_DEBUG_IPC RT_DEBUG_TIMER RT_DEBUG_IRQ RT_DEBUG_MEM RT_DEBUG_SLAB RT_DEBUG_MEMHEAP
2023-07-03[docs] fix a typo in documentation (#7773)Legend
2023-06-29[include][dbg]update: no longer use RT_DEBUG_LOG in rtdebug.h (#7750)Shicheng Chu
2023-06-21[Kernel] message 可以返回消息的实际大小 (#7709)zhkag
2023-05-18[HUST CSE][example] fix some typo bugs about 'sucess' and others. (#7528)shandianchengzi
2023-05-07env.md: Update URL to download env toolmichael-skynorth
2023-04-14[HUST CSE][document] Fix some comments, invalid grouping commands and ↵Xu Biang
warnings in Doxygen. 将Doxygen输入文件(由Doxyfile中的INPUT定义)中的失效Doxygen分组指令(如/*@*/和/*@}*/)更改为有效的分组指令(如/**@*/和/**@}*/);(此处只对INPUT中的文件做了修改,bsp目录下和libcpu目录下存在近万个失效的Doxygen分组指令,但由于不作为文档的输入文件且这些文件过于庞大老旧,没有对这些文件中的无效指令做修改) 将图片文件统一放入了images目录下; 修改了Doxyfile和部分Doxygen注释,使得Doxyfile能够定位到新的代码路径且不受重复实现的影响; 解决了一些注释中的参数名不匹配、参数多余/缺失等问题。
2023-04-08[DFS] prepare for dfs_v2.0 (#7200)Bernard Xiong
* [DFS] prepare for dfs_v2. dfs_fd -> dfs_file; dfs_fnode -> dfs_vnode. * [BSP] fix code analysis warning * [smart] fix the pointer overflow. * code format * [smart] fix the lwp->lwp_obj checking.
2023-04-03Revise the description of rt_thread_resumecccccya
2023-03-22[errno code][-RT_ETIMEOUT] fix that use RT_ETIMEOUT without -Meco Man
2023-03-20[errno code][-RT_ERROR] fix that use RT_ERROR without -Meco Man
2023-03-07修改doc文件夹下pwm例程中将led的io设置为输出模式后再使� ↵slhuan
�PWM控制LED,经验证使用这样是无法正常输出PWM的
2023-02-07rt_device_write/read return data type as rt_ssize_tMeco Man
rt_ssize_t can give negative error code, which follows the unix style correctly
2023-02-02[doxygen] Fix some warnings in doxygen (#6899)tuduweb
2023-01-12modify RT_ALIGN_SIZE as 8 by defaultMeco Man
2022-12-16documention里的一处小问题 (#6748)sbb
* Update thread-comm.md * Update documentation/thread-comm/thread-comm.md Co-authored-by: Man, Jianting (Meco) <[email protected]>
2022-12-11[rtdef] use lower-case to define attributes (#6728)Man, Jianting (Meco)
* [rtdef] rename RT_WEAK attribute as rt_weak * [rtdef] rename RT_USED attribute as rt_used * [rtdef] rename RT_SECTION attribute as rt_section * [rtdef] rename ALIGN attribute as rt_align * [legacy] add RT_USED ALIGN RT_SECTION RT_WEAK as legacy support
2022-08-27fix typo洩氏诹诹子
2022-08-19docs fixes half donesnikolaj
2022-08-18grammar and wording fixessnikolaj
2022-08-16[gcc][armcc][armclang] rtconfig.CROSS_TOOL->rtconfig.PLATFORMMeco Man
2022-08-10[docs] update env documentMeco Man
append some information about menuconfig -s
2022-08-03[document] Fix the doxygen file (#6217)supperthomas
* [document] Fix the doxygen file
2022-07-15correct the license descriptionMeco Man
2022-07-11Further edits of documentation for clarity (#6156)snikolaj
* Overhaul of document, fixing multiple grammar mistakes and editing for clarity * Further documentation grammar and spelling fixes
2022-07-10Overhaul of document, fixing multiple grammar mistakes and editing for ↵snikolaj
clarity (#6155)
2022-06-29Update English coding style for more idiomatic use (#6120)GPSBabel
* Update English coding style for more idiomatic use Fresh eyes on the English coding style guide. Remove "speed bumps" to a native English reader to improve acceptance. * Coding_style_en: fix plurality disagreement
2022-06-09[scons][iar] 将IAR的PLATFORM字段由iar调整为iccarmMeco Man
将路径更新为IAR最新版本的路径