core/builtins/repeat.cif
changeset 0 7f656887cf89
child 66 2a78c4ff2eab
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/core/builtins/repeat.cif	Wed Jun 23 15:52:26 2010 +0100
@@ -0,0 +1,42 @@
+# repeat.cif
+# 
+# Copyright (c) 2010 Accenture. All rights reserved.
+# This component and the accompanying materials are made available
+# under the terms of the "Eclipse Public License v1.0"
+# which accompanies this distribution, and is available
+# at the URL "http://www.eclipse.org/legal/epl-v10.html".
+# 
+# Initial Contributors:
+# Accenture - Initial contribution
+#
+
+==name repeat
+
+==short-description
+
+Execute a command-line multiple times.
+
+==long-description
+
+On each iteration, the environment variable C<REPEAT_COUNT> is set to an integer value representing the iteration number currently being processed. This can be used, for example, to produce unique file names.
+
+==argument uint count
+
+The number of repetitions to perform. If set to zero, will repeat indefinitely.
+
+==argument string command last
+
+The command to run.
+
+==option bool k keep-going
+
+If an iteration returns an error, proceed with the next iteration. Ordinarily execution will abort if an error is returned.
+
+==option int w wait
+
+If specified, wait this number of milliseconds between iterations.
+
+==copyright
+
+Copyright (c) 2006-2010 Accenture. All rights reserved.
+