Merge pull request #163 from FeXd/delay

delay.xml added with documentation based on its java equivalent

Author: jdf

Reference/api_en/delay.xml

@@ -0,0 +1,37 @@
+<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
+<root>
+<name>delay()</name>
+
+<category>Environment</category>
+
+<subcategory></subcategory>
+
+<example>
+<notest />
+<noimage />
+<code><![CDATA[
+def draw():
+    line(random(100), random(100), random(100), random(100))
+    delay(1000)
+]]></code>
+</example>
+
+<description><![CDATA[
+The delay() function halts for a specified time. Delay times are specified in thousandths of a second. For example, running delay(3000) will stop the program for three seconds and delay(500) will stop the program for a half-second.<br />
+<br />
+The screen only updates when the end of draw() is reached, so delay() cannot be used to slow down drawing. For instance, you cannot use delay() to control the timing of an animation.
+]]></description>
+
+<syntax>
+delay(<c>time</c>)
+</syntax>
+
+<parameter>
+<label>time</label>
+<description><![CDATA[int: milliseconds to pause before running draw() again]]></description>
+</parameter>
+
+<related>frameRate_var</related>
+<related>draw</related>
+
+</root>