From a0685f893f73d04ca0c3db8cdac6f59a7b13af4a 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 426d542aa3..4948748de4 100644 --- a/docs/en/api-guides/tools/idf-py.rst +++ b/docs/en/api-guides/tools/idf-py.rst @@ -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 `.