Merge branch 'fix/update_argument_file_docs_v5.5' into 'release/v5.5'

docs(tools): Enclosed @argument_file with quotations (v5.5)

See merge request espressif/esp-idf!45275
This commit is contained in:
Roland Dobai
2026-01-19 19:25:21 +01:00
2 changed files with 4 additions and 4 deletions
+2 -2
View File
@@ -295,9 +295,9 @@ For example, let's have a file `custom_flash.txt`:
flash --baud 115200
Then the command can be executed as: ``idf.py @custom_flash.txt monitor``
Then the command can be executed as: ``idf.py "@custom_flash.txt" monitor``
Arguments from a file can be combined with additional command line arguments, and multiple files annotated with ``@`` can be used simultaneously. For instance, if there is a second file ``another_config.txt``, both can be utilized by specifying ``idf.py @custom_flash.txt @another_config.txt monitor``.
Arguments from a file can be combined with additional command line arguments, and multiple files annotated with ``@`` can be used simultaneously. For instance, if there is a second file ``another_config.txt``, both can be utilized by specifying ``idf.py "@custom_flash.txt" "@another_config.txt" monitor``.
A further example of how this argument file can be used, e.g., creating configuration profile files via @filename, is in the :example_file:`Multiple Build Configurations Example <build_system/cmake/multi_config/README.md>`.
+2 -2
View File
@@ -295,9 +295,9 @@ uf2 二进制文件也可以通过 :ref:`idf.py uf2 <generate-uf2-binary>` 生
flash --baud 115200
运行命令:``idf.py @custom_flash.txt monitor``
运行命令:``idf.py "@custom_flash.txt" monitor``
文件中的参数可以与额外的命令行参数结合使用,也支持同时使用带有 ``@`` 标注的多个文件。例如,另有一个文件 ``another_config.txt``,此时,可以通过指定 ``idf.py @custom_flash.txt @another_config.txt monitor`` 同时使用两个文件。
文件中的参数可以与额外的命令行参数结合使用,也支持同时使用带有 ``@`` 标注的多个文件。例如,另有一个文件 ``another_config.txt``,此时,可以通过指定 ``idf.py "@custom_flash.txt" "@another_config.txt" monitor`` 同时使用两个文件。
关于参数文件的更多示例,如通过 @filename 创建配置文件概要,请参阅 :example_file:`多个构建配置示例 <build_system/cmake/multi_config/README.md>`