update docs

Author: waruqi

docs/api/description/builtin-policies.md

@@ -589,3 +589,26 @@ Sets uiAccess for Windows UAC, defaults to false if it is not set.
 ```lua
 set_policy("windows.manifest.uac.ui", true)
 ```
+
+## build.progress_style <Badge type="tip" text="v3.0.5" />
+
+Sets the build progress output style. Supports two styles:
+
+- `"single"` (default): Single-row progress output, only updates one line of progress information
+- `"multirow"`: Multi-row progress output, displays multiple concurrent build tasks with their individual progress
+
+Multi-row progress output provides a significantly better visual experience during long-running builds, making it easier to monitor parallel compilation.
+
+You can enable multi-row progress output in two ways:
+
+1. **Via theme configuration**: Use the `soong` theme which includes multi-row progress by default:
+   ```bash
+   $ xmake g --theme=soong
+   ```
+
+2. **Via project policy**: Enable it directly in your `xmake.lua`:
+   ```lua
+   set_policy("build.progress_style", "multirow")
+   ```
+
+This provides better visibility into parallel build progress, makes it easier to identify slow compilation units, and improves the overall user experience for large projects with many source files or parallel builds with multiple compilation units.

docs/api/description/project-target.md

@@ -6136,6 +6136,20 @@ target("test")
      add_runenvs("LD_LIBRARY_PATH", "/lib")
 ```
 
+#### Realtime output support
+
+Starting from v3.0.5, you can enable realtime output support for tests, allowing test output to be displayed in real-time as tests run, rather than buffering output until the test completes. This is particularly useful for long-running tests or tests that produce continuous output.
+
+To enable realtime output for a test, set `realtime_output = true` in the test configuration:
+
+```lua
+target("test")
+    set_kind("binary")
+    add_tests("stub_n", {realtime_output = true, files = "tests/stub_n*.cpp", defines = "STUB_N"})
+```
+
+When `realtime_output` is enabled, the test output will be streamed directly to the terminal as the test runs, making it easier to monitor test progress and debug issues in real-time.
+
 #### Matching output results
 
 By default, `xmake test` will determine whether the test passed based on whether the exit code of the test run is 0.

docs/api/scripts/builtin-modules/os.md

@@ -78,6 +78,16 @@ Since v3.0.4, the parameter `{copy_if_different = true}` is added to copy files
 os.cp("$(scriptdir)/config.h", "$(builddir)/inc/config.h", {copy_if_different = true})
 ```
 
+Starting from v3.0.5, async operations are supported:
+
+```lua
+-- Async copy files (blocking wait)
+os.cp("src/*.h", "dest/", {async = true})
+
+-- Async copy files (non-blocking, background execution)
+os.cp("src/*.h", "dest/", {async = true, detach = true})
+```
+
 ## os.mv
 
 - Move to rename a file or directory
@@ -118,7 +128,7 @@ os.mv("$(builddir)/libtest.a", "$(builddir)/libdemo.a")
 
 ::: tip API
 ```lua
-os.rm(path: <string>)
+os.rm(path: <string>, options?: <table>)
 ```
 :::
 
@@ -128,6 +138,7 @@ os.rm(path: <string>)
 | Parameter | Description |
 |-----------|-------------|
 | path | File or directory path |
+| options | Optional options table, supports `async` and `detach` parameters |
 
 #### Usage
 
@@ -138,6 +149,16 @@ os.rm("$(builddir)/inc/**.h")
 os.rm("$(builddir)/lib/")
 ```
 
+Starting from v3.0.5, async operations are supported:
+
+```lua
+-- Async delete file (blocking wait)
+os.rm("/tmp/xxx.txt", {async = true})
+
+-- Async delete file (non-blocking, background execution)
+os.rm("/tmp/xxx.txt", {async = true, detach = true})
+```
+
 ## os.trycp
 
 - Try copying files or directories
@@ -519,7 +540,7 @@ end
 
 ::: tip API
 ```lua
-os.files(pattern: <string>)
+os.files(pattern: <string>, options?: <table>)
 ```
 :::
 
@@ -529,6 +550,7 @@ os.files(pattern: <string>)
 | Parameter | Description |
 |-----------|-------------|
 | pattern | File pattern |
+| options | Optional options table, supports `async` parameter |
 
 #### Usage
 
@@ -541,6 +563,13 @@ for _, filepath in ipairs(os.files("$(builddir)/inc/*.h")) do
 end
 ```
 
+Starting from v3.0.5, async operations are supported:
+
+```lua
+-- Async find files (blocking wait for return value)
+local files = os.files("src/*.c", {async = true})
+```
+
 ## os.filedirs
 
 - Traverse to get all files and directories under the specified directory

docs/api/scripts/extension-modules/core/base/tty.md

@@ -642,3 +642,223 @@ local oldmode = tty.term_mode("stdout")
 tty.term_mode("stdout", newmode)
 ```
 
+## tty.cursor_move_up <Badge type="tip" text="v3.0.5" />
+
+- Move cursor up by n lines
+
+#### Function Prototype
+
+::: tip API
+```lua
+tty.cursor_move_up(n: <number>)
+```
+:::
+
+#### Parameter Description
+
+| Parameter | Description |
+|-----------|-------------|
+| n | Number of lines to move up |
+
+#### Return Value
+
+| Type | Description |
+|------|-------------|
+| tty | Returns the tty module for method chaining |
+
+#### Usage
+
+```lua
+import("core.base.tty")
+
+tty.cursor_move_up(3)  -- Move cursor up 3 lines
+```
+
+## tty.cursor_move_down <Badge type="tip" text="v3.0.5" />
+
+- Move cursor down by n lines
+
+#### Function Prototype
+
+::: tip API
+```lua
+tty.cursor_move_down(n: <number>)
+```
+:::
+
+#### Parameter Description
+
+| Parameter | Description |
+|-----------|-------------|
+| n | Number of lines to move down |
+
+#### Return Value
+
+| Type | Description |
+|------|-------------|
+| tty | Returns the tty module for method chaining |
+
+#### Usage
+
+```lua
+import("core.base.tty")
+
+tty.cursor_move_down(2)  -- Move cursor down 2 lines
+```
+
+## tty.cursor_move_left <Badge type="tip" text="v3.0.5" />
+
+- Move cursor left by n columns
+
+#### Function Prototype
+
+::: tip API
+```lua
+tty.cursor_move_left(n: <number>)
+```
+:::
+
+#### Parameter Description
+
+| Parameter | Description |
+|-----------|-------------|
+| n | Number of columns to move left |
+
+#### Return Value
+
+| Type | Description |
+|------|-------------|
+| tty | Returns the tty module for method chaining |
+
+#### Usage
+
+```lua
+import("core.base.tty")
+
+tty.cursor_move_left(5)  -- Move cursor left 5 columns
+```
+
+## tty.cursor_move_right <Badge type="tip" text="v3.0.5" />
+
+- Move cursor right by n columns
+
+#### Function Prototype
+
+::: tip API
+```lua
+tty.cursor_move_right(n: <number>)
+```
+:::
+
+#### Parameter Description
+
+| Parameter | Description |
+|-----------|-------------|
+| n | Number of columns to move right |
+
+#### Return Value
+
+| Type | Description |
+|------|-------------|
+| tty | Returns the tty module for method chaining |
+
+#### Usage
+
+```lua
+import("core.base.tty")
+
+tty.cursor_move_right(10)  -- Move cursor right 10 columns
+```
+
+## tty.cursor_move_to_col <Badge type="tip" text="v3.0.5" />
+
+- Move cursor to specific column
+
+#### Function Prototype
+
+::: tip API
+```lua
+tty.cursor_move_to_col(n: <number>)
+```
+:::
+
+#### Parameter Description
+
+| Parameter | Description |
+|-----------|-------------|
+| n | Column number to move to (1-based) |
+
+#### Return Value
+
+| Type | Description |
+|------|-------------|
+| tty | Returns the tty module for method chaining |
+
+#### Usage
+
+```lua
+import("core.base.tty")
+
+tty.cursor_move_to_col(1)  -- Move cursor to start of line
+```
+
+## tty.cursor_hide <Badge type="tip" text="v3.0.5" />
+
+- Hide cursor
+
+#### Function Prototype
+
+::: tip API
+```lua
+tty.cursor_hide()
+```
+:::
+
+#### Parameter Description
+
+No parameters
+
+#### Return Value
+
+| Type | Description |
+|------|-------------|
+| tty | Returns the tty module for method chaining |
+
+#### Usage
+
+```lua
+import("core.base.tty")
+
+tty.cursor_hide()  -- Hide cursor
+```
+
+## tty.cursor_show <Badge type="tip" text="v3.0.5" />
+
+- Show cursor
+
+#### Function Prototype
+
+::: tip API
+```lua
+tty.cursor_show()
+```
+:::
+
+#### Parameter Description
+
+No parameters
+
+#### Return Value
+
+| Type | Description |
+|------|-------------|
+| tty | Returns the tty module for method chaining |
+
+#### Usage
+
+```lua
+import("core.base.tty")
+
+tty.cursor_show()  -- Show cursor
+```
+