@@ -41,9 +41,14 @@ public final class Runnable extends com.google.api.client.json.GenericJson {
41
41
private java .lang .Boolean alwaysRun ;
42
42
43
43
/**
44
- * This flag allows a Runnable to continue running in the background while the Task executes
45
- * subsequent Runnables. This is useful to provide services to other Runnables (or to provide
46
- * debugging support tools like SSH servers).
44
+ * Normally, a runnable that doesn't exit causes its task to fail. However, you can set this field
45
+ * to `true` to configure a background runnable. Background runnables are allowed continue running
46
+ * in the background while the task executes subsequent runnables. For example, background
47
+ * runnables are useful for providing services to other runnables or providing debugging-support
48
+ * tools like SSH servers. Specifically, background runnables are killed automatically (if they
49
+ * have not already exited) a short time after all foreground runnables have completed. Even
50
+ * though this is likely to result in a non-zero exit status for the background runnable, these
51
+ * automatic kills are not treated as task failures.
47
52
* The value may be {@code null}.
48
53
*/
49
54
@ com .google .api .client .util .Key
@@ -81,8 +86,9 @@ public final class Runnable extends com.google.api.client.json.GenericJson {
81
86
private Environment environment ;
82
87
83
88
/**
84
- * Normally, a non-zero exit status causes the Task to fail. This flag allows execution of other
85
- * Runnables to continue instead.
89
+ * Normally, a runnable that returns a non-zero exit status fails and causes the task to fail.
90
+ * However, you can set this field to `true` to allow the task to continue executing its other
91
+ * runnables even if this runnable fails.
86
92
* The value may be {@code null}.
87
93
*/
88
94
@ com .google .api .client .util .Key
@@ -135,19 +141,29 @@ public Runnable setAlwaysRun(java.lang.Boolean alwaysRun) {
135
141
}
136
142
137
143
/**
138
- * This flag allows a Runnable to continue running in the background while the Task executes
139
- * subsequent Runnables. This is useful to provide services to other Runnables (or to provide
140
- * debugging support tools like SSH servers).
144
+ * Normally, a runnable that doesn't exit causes its task to fail. However, you can set this field
145
+ * to `true` to configure a background runnable. Background runnables are allowed continue running
146
+ * in the background while the task executes subsequent runnables. For example, background
147
+ * runnables are useful for providing services to other runnables or providing debugging-support
148
+ * tools like SSH servers. Specifically, background runnables are killed automatically (if they
149
+ * have not already exited) a short time after all foreground runnables have completed. Even
150
+ * though this is likely to result in a non-zero exit status for the background runnable, these
151
+ * automatic kills are not treated as task failures.
141
152
* @return value or {@code null} for none
142
153
*/
143
154
public java .lang .Boolean getBackground () {
144
155
return background ;
145
156
}
146
157
147
158
/**
148
- * This flag allows a Runnable to continue running in the background while the Task executes
149
- * subsequent Runnables. This is useful to provide services to other Runnables (or to provide
150
- * debugging support tools like SSH servers).
159
+ * Normally, a runnable that doesn't exit causes its task to fail. However, you can set this field
160
+ * to `true` to configure a background runnable. Background runnables are allowed continue running
161
+ * in the background while the task executes subsequent runnables. For example, background
162
+ * runnables are useful for providing services to other runnables or providing debugging-support
163
+ * tools like SSH servers. Specifically, background runnables are killed automatically (if they
164
+ * have not already exited) a short time after all foreground runnables have completed. Even
165
+ * though this is likely to result in a non-zero exit status for the background runnable, these
166
+ * automatic kills are not treated as task failures.
151
167
* @param background background or {@code null} for none
152
168
*/
153
169
public Runnable setBackground (java .lang .Boolean background ) {
@@ -230,17 +246,19 @@ public Runnable setEnvironment(Environment environment) {
230
246
}
231
247
232
248
/**
233
- * Normally, a non-zero exit status causes the Task to fail. This flag allows execution of other
234
- * Runnables to continue instead.
249
+ * Normally, a runnable that returns a non-zero exit status fails and causes the task to fail.
250
+ * However, you can set this field to `true` to allow the task to continue executing its other
251
+ * runnables even if this runnable fails.
235
252
* @return value or {@code null} for none
236
253
*/
237
254
public java .lang .Boolean getIgnoreExitStatus () {
238
255
return ignoreExitStatus ;
239
256
}
240
257
241
258
/**
242
- * Normally, a non-zero exit status causes the Task to fail. This flag allows execution of other
243
- * Runnables to continue instead.
259
+ * Normally, a runnable that returns a non-zero exit status fails and causes the task to fail.
260
+ * However, you can set this field to `true` to allow the task to continue executing its other
261
+ * runnables even if this runnable fails.
244
262
* @param ignoreExitStatus ignoreExitStatus or {@code null} for none
245
263
*/
246
264
public Runnable setIgnoreExitStatus (java .lang .Boolean ignoreExitStatus ) {
0 commit comments