From 59e50d0486e996c70f2b668f7082874f4f206418 Mon Sep 17 00:00:00 2001 From: Marek Fiala Date: Mon, 5 Jan 2026 16:20:42 +0100 Subject: [PATCH] docs(tools): Updated argument via file with quotations Closes https://github.com/espressif/esp-idf/issues/18077 --- docs/en/api-guides/tools/idf-py.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/en/api-guides/tools/idf-py.rst b/docs/en/api-guides/tools/idf-py.rst index dbe26d106cc..f670a443e12 100644 --- a/docs/en/api-guides/tools/idf-py.rst +++ b/docs/en/api-guides/tools/idf-py.rst @@ -292,9 +292,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 `.