@@ -36,7 +36,7 @@ compiling and uploading sketches (programs) for Arduino
36
36
Normally, running the arduino command starts the IDE, optionally loading
37
37
any .ino files specified on the commandline.
38
38
39
- Alternatively, if *--verify* or *--upload* is given, no graphical
39
+ Alternatively, if any of the following command line options is given, no graphical
40
40
interface will be shown and instead a one-off verify (compile) or upload
41
41
will be done. A single .ino file should be given. If the sketch contains
42
42
multiple .ino files, any one can be specified on the commandline, but
@@ -75,9 +75,6 @@ OPTIONS
75
75
{empty}::
76
76
If this option is not passed, the value from the current
77
77
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).
81
78
82
79
*--port* __portname__::
83
80
Select the serial port to perform upload of the sketch.
@@ -88,13 +85,10 @@ OPTIONS
88
85
{empty}::
89
86
If this option is not passed, the value from the current
90
87
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).
94
88
95
89
*--verbose-build*::
96
90
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
98
92
preferences.
99
93
100
94
{empty}::
@@ -103,7 +97,7 @@ OPTIONS
103
97
104
98
*--verbose-upload*::
105
99
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
107
101
preferences.
108
102
109
103
{empty}::
@@ -131,24 +125,17 @@ OPTIONS
131
125
validated: Invalid names will be set but never used, invalid
132
126
values might lead to an error later on.
133
127
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.
141
132
142
133
*--upload*::
143
134
Build and upload the sketch.
144
135
145
136
*--verify*::
146
137
Build the sketch.
147
138
148
- *--noop*::
149
- Immediately quit after processing the commandline. This can be
150
- used to just set preferences with *--pref*.
151
-
152
139
*--get-pref __preference__*::
153
140
Prints the value of the given preference to the standard output
154
141
stream. When the value does not exist, nothing is printed and
@@ -244,7 +231,7 @@ re-use any previous build results in that directory.
244
231
245
232
Change the selected board and build path and do nothing else.
246
233
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
248
235
249
236
HISTORY
250
237
-------
@@ -272,13 +259,12 @@ HISTORY
272
259
longer shown. Error messages still use a graphical popup and on
273
260
Windows, the splash screen is still shown.
274
261
275
- 1.5.7 ::
276
- Introduced *--no- save-prefs* and *--noop *.
262
+ 1.5.8 ::
263
+ Introduced *--save-prefs*.
277
264
278
265
{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.
282
268
283
269
{empty}::
284
270
A path passed to *--preferences-file*, or set in the
0 commit comments