@@ -36,7 +36,7 @@ compiling and uploading sketches (programs) for Arduino
3636Normally, running the arduino command starts the IDE, optionally loading
3737any .ino files specified on the commandline.
3838
39- Alternatively, if *--verify* or *--upload* is given, no graphical
39+ Alternatively, if any of the following command line options is given, no graphical
4040interface will be shown and instead a one-off verify (compile) or upload
4141will be done. A single .ino file should be given. If the sketch contains
4242multiple .ino files, any one can be specified on the commandline, but
@@ -75,9 +75,6 @@ OPTIONS
7575{empty}::
7676 If this option is not passed, the value from the current
7777 preferences is used (e.g., the last board selected in the IDE).
78- If this option is given, the value passed is written to the
79- preferences file and rememberd for subsequent runs (except when
80- *--no-save-prefs* is passed).
8178
8279*--port* __portname__::
8380 Select the serial port to perform upload of the sketch.
@@ -88,13 +85,10 @@ OPTIONS
8885{empty}::
8986 If this option is not passed, the value from the current
9087 preferences is used (e.g., the last port selected in the IDE).
91- If this option is given, the value passed is written to the
92- preferences file and rememberd for subsequent runs (except when
93- *--no-save-prefs* is passed).
9488
9589*--verbose-build*::
9690 Enable verbose mode during build. If this option is not given,
97- verbose mode during build is disabled regardless of the current
91+ verbose mode during build is * disabled* regardless of the current
9892 preferences.
9993
10094{empty}::
@@ -103,7 +97,7 @@ OPTIONS
10397
10498*--verbose-upload*::
10599 Enable verbose mode during upload. If this option is not given,
106- verbose mode during upload is disabled regardless of the current
100+ verbose mode during upload is * disabled* regardless of the current
107101 preferences.
108102
109103{empty}::
@@ -131,24 +125,17 @@ OPTIONS
131125 validated: Invalid names will be set but never used, invalid
132126 values might lead to an error later on.
133127
134- {empty}::
135- If this option is given, the value passed is written to the
136- preferences file and rememberd for subsequent runs (except when
137- *--no-save-prefs* is passed).
138-
139- *--no-save-prefs*::
140- Do not save any (changed) preferences to *preferences.txt*.
128+ *--save-prefs*::
129+ Save any (changed) preferences to *preferences.txt*. In particular
130+ *--board*, *--port*, *--pref*, *--verbose*, *--verbose-build* and
131+ *--verbose-upload* may alter the current preferences.
141132
142133*--upload*::
143134 Build and upload the sketch.
144135
145136*--verify*::
146137 Build the sketch.
147138
148- *--noop*::
149- Immediately quit after processing the commandline. This can be
150- used to just set preferences with *--pref*.
151-
152139*--get-pref __preference__*::
153140 Prints the value of the given preference to the standard output
154141 stream. When the value does not exist, nothing is printed and
@@ -244,7 +231,7 @@ re-use any previous build results in that directory.
244231
245232Change the selected board and build path and do nothing else.
246233
247- arduino --pref build.path=/path/to/sketch/build --board arduino:avr:uno --noop
234+ arduino --pref build.path=/path/to/sketch/build --board arduino:avr:uno --save-prefs
248235
249236HISTORY
250237-------
@@ -272,13 +259,12 @@ HISTORY
272259 longer shown. Error messages still use a graphical popup and on
273260 Windows, the splash screen is still shown.
274261
275- 1.5.7 ::
276- Introduced *--no- save-prefs* and *--noop *.
262+ 1.5.8 ::
263+ Introduced *--save-prefs*.
277264
278265{empty}::
279- *--board* and *--port* options are now saved to the preferences
280- file, just like *--pref*. The *--verbose* options still only
281- apply to the current run.
266+ *--pref* options are now not saved to the preferences file, just
267+ like *--board* and *--port*, unless *--save-prefs* is specified.
282268
283269{empty}::
284270 A path passed to *--preferences-file*, or set in the
0 commit comments