update docs

Author: waruqi

docs/api/scripts/option-instance.md

@@ -38,6 +38,10 @@ option:set("configvar", option:name(), option:value(), {quote = false})
 
 ::: tip NOTE
 Any script scope configuration using `option:set("xxx", ...)` is completely consistent with the corresponding `set_xxx` interface in the description scope. For specific parameter descriptions, you can directly refer to the corresponding `set_xxx` interface documentation in the description scope.
+
+For example:
+- Description scope: `set_default(false)`
+- Script scope: `option:set("default", false)`
 :::
 
 ## option:add
@@ -53,6 +57,10 @@ option:add("defines", "SDL_MAIN_HANDLED")
 
 ::: tip NOTE
 Any script scope configuration using `option:add("xxx", ...)` is completely consistent with the corresponding `add_xxx` interface in the description scope. For specific parameter descriptions, you can directly refer to the corresponding `add_xxx` interface documentation in the description scope.
+
+For example:
+- Description scope: `add_defines("DEBUG", "VERSION=1")`
+- Script scope: `option:add("defines", "DEBUG", "VERSION=1")`
 :::
 
 ::: tip NOTE

docs/api/scripts/package-instance.md

@@ -36,6 +36,10 @@ package:set("defines", "SDL_MAIN_HANDLED")
 
 ::: tip NOTE
 Any script scope configuration using `package:set("xxx", ...)` is completely consistent with the corresponding `set_xxx` interface in the description scope. For specific parameter descriptions, you can directly refer to the corresponding `set_xxx` interface documentation in the description scope.
+
+For example:
+- Description scope: `set_urls("https://github.com/madler/zlib/archive/$(version).tar.gz")`
+- Script scope: `package:set("urls", "https://github.com/madler/zlib/archive/$(version).tar.gz")`
 :::
 
 ## package:add
@@ -53,6 +57,10 @@ package:add("defines", "SDL_MAIN_HANDLED")
 
 ::: tip NOTE
 Any script scope configuration using `package:add("xxx", ...)` is completely consistent with the corresponding `add_xxx` interface in the description scope. For specific parameter descriptions, you can directly refer to the corresponding `add_xxx` interface documentation in the description scope.
+
+For example:
+- Description scope: `add_deps("zlib", {configs = {shared = true}})`
+- Script scope: `package:add("deps", "zlib", {configs = {shared = true}})`
 :::
 
 ## package:license

docs/api/scripts/target-instance.md

@@ -32,6 +32,10 @@ target:set("defines", "SDL_MAIN_HANDLED")
 
 ::: tip NOTE
 Any script scope configuration using `target:set("xxx", ...)` is completely consistent with the corresponding `set_xxx` interface in the description scope. For specific parameter descriptions, you can directly refer to the corresponding `set_xxx` interface documentation in the description scope.
+
+For example:
+- Description scope: `set_kind("binary")`
+- Script scope: `target:set("kind", "binary")`
 :::
 
 ## target:add
@@ -47,6 +51,10 @@ target:add("defines", "SDL_MAIN_HANDLED")
 
 ::: tip NOTE
 Any script scope configuration using `target:add("xxx", ...)` is completely consistent with the corresponding `add_xxx` interface in the description scope. For specific parameter descriptions, you can directly refer to the corresponding `add_xxx` interface documentation in the description scope.
+
+For example:
+- Description scope: `add_files("src/*.c", {defines = "PRIVATE"})`
+- Script scope: `target:add("files", "src/*.c", {defines = "PRIVATE"})`
 :::
 
 ## target:kind

docs/zh/api/scripts/option-instance.md

@@ -41,6 +41,10 @@ option:set("configvar", option:name(), option:value(), {quote = false})
 
 ::: tip 注意
 任何脚本域下对 `option:set("xxx", ...)` 的配置，都是完全跟描述域的 `set_xxx` 接口保持一致的，具体参数说明，可以直接参考描述域下对应的 `set_xxx` 接口说明。
+
+例如：
+- 描述域：`set_default(false)`
+- 脚本域：`option:set("default", false)`
 :::
 
 ## option:add
@@ -56,6 +60,10 @@ option:add("defines", "SDL_MAIN_HANDLED")
 
 ::: tip 注意
 任何脚本域下对 `option:add("xxx", ...)` 的配置，都是完全跟描述域的 `add_xxx` 接口保持一致的，具体参数说明，可以直接参考描述域下对应的 `add_xxx` 接口说明。
+
+例如：
+- 描述域：`add_defines("DEBUG", "VERSION=1")`
+- 脚本域：`option:add("defines", "DEBUG", "VERSION=1")`
 :::
 
 ::: tip 注意

docs/zh/api/scripts/package-instance.md

@@ -38,6 +38,10 @@ package:set("defines", "SDL_MAIN_HANDLED")
 
 ::: tip 注意
 任何脚本域下对 `package:set("xxx", ...)` 的配置，都是完全跟描述域的 `set_xxx` 接口保持一致的，具体参数说明，可以直接参考描述域下对应的 `set_xxx` 接口说明。
+
+例如：
+- 描述域：`set_urls("https://github.com/madler/zlib/archive/$(version).tar.gz")`
+- 脚本域：`package:set("urls", "https://github.com/madler/zlib/archive/$(version).tar.gz")`
 :::
 
 ## package:add
@@ -55,6 +59,10 @@ package:add("defines", "SDL_MAIN_HANDLED")
 
 ::: tip 注意
 任何脚本域下对 `package:add("xxx", ...)` 的配置，都是完全跟描述域的 `add_xxx` 接口保持一致的，具体参数说明，可以直接参考描述域下对应的 `add_xxx` 接口说明。
+
+例如：
+- 描述域：`add_deps("zlib", {configs = {shared = true}})`
+- 脚本域：`package:add("deps", "zlib", {configs = {shared = true}})`
 :::
 
 ## package:license

docs/zh/api/scripts/target-instance.md

@@ -34,6 +34,10 @@ target:set("defines", "SDL_MAIN_HANDLED")
 
 ::: tip 注意
 任何脚本域下对 `target:set("xxx", ...)` 的配置，都是完全跟描述域的 `set_xxx` 接口保持一致的，具体参数说明，可以直接参考描述域下对应的 `set_xxx` 接口说明。
+
+例如：
+- 描述域：`set_kind("binary")`
+- 脚本域：`target:set("kind", "binary")`
 :::
 
 ## target:add
@@ -49,6 +53,10 @@ target:add("defines", "SDL_MAIN_HANDLED")
 
 ::: tip 注意
 任何脚本域下对 `target:add("xxx", ...)` 的配置，都是完全跟描述域的 `add_xxx` 接口保持一致的，具体参数说明，可以直接参考描述域下对应的 `add_xxx` 接口说明。
+
+例如：
+- 描述域：`add_files("src/*.c", {defines = "PRIVATE"})`
+- 脚本域：`target:add("files", "src/*.c", {defines = "PRIVATE"})`
 :::
 
 ## target:kind