Group of Reference updates

REAS · REAS · commit 1b2dfbf08e48 · 2015-09-16T22:03:56.000-07:00
diff --git a/content/api_en/arc.xml b/content/api_en/arc.xml
@@ -39,7 +39,9 @@ arc(50, 50, 80, 80, 0, PI+QUARTER_PI, PIE);
 <description><![CDATA[
 Draws an arc to the screen. Arcs are drawn along the outer edge of an ellipse defined by the <b>a</b>, <b>b</b>, <b>c</b>, and <b>d</b> parameters. The origin of the arc's ellipse may be changed with the <b>ellipseMode()</b> function. Use the <b>start</b> and <b>stop</b> parameters to specify the angles (in radians) at which to draw the arc.<br />
 <br />
-There are three ways to draw an arc; the rendering technique used is defined by the optional seventh paramter. The three options, depicted in the above examples, are PIE, OPEN, and CHORD. The default mode is the OPEN stroke with a PIE fill.
+There are three ways to draw an arc; the rendering technique used is defined by the optional seventh parameter. The three options, depicted in the above examples, are PIE, OPEN, and CHORD. The default mode is the OPEN stroke with a PIE fill.<br />
+<br />
+In some cases, the <b>arc()</b> function isn't accurate enough for smooth drawing. For example, the shape may jitter on screen when rotating slowly. If you're having an issue with how arcs are rendered, you'll need to draw the arc yourself with <b>beginShape()</b>/<b>endShape()</b> or a <b>PShape</b>.
 ]]></description>
 
 </root>
diff --git a/content/api_en/beginContour.xml b/content/api_en/beginContour.xml
@@ -32,7 +32,7 @@ endShape(CLOSE);
 </example>
 
 <description><![CDATA[
-Use the <b>beginContour()</b> and <b>endContour()</b> function to create negative shapes within shapes such as the center of the letter 'O'. <b>beginContour()</b> begins recording vertices for the shape and <b>endContour()</b> stops recording. The vertices that define a negative shape must "wind" in the opposite direction from the exterior shape. First draw vertices for the exterior shape in clockwise order, then for internal shapes, draw vertices counter-clockwise.<br />
+Use the <b>beginContour()</b> and <b>endContour()</b> function to create negative shapes within shapes such as the center of the letter 'O'. <b>beginContour()</b> begins recording vertices for the shape and <b>endContour()</b> stops recording. The vertices that define a negative shape must "wind" in the opposite direction from the exterior shape. First draw vertices for the exterior shape in clockwise order, then for internal shapes, draw vertices counterclockwise.<br />
 <br />
 These functions can only be used within a <b>beginShape()</b>/<b>endShape()</b> pair and transformations such as <b>translate()</b>, <b>rotate()</b>, and <b>scale()</b> do not work within a <b>beginContour()</b>/<b>endContour()</b> pair. It is also not possible to use other shapes, such as <b>ellipse()</b> or <b>rect()</b> within.
 ]]></description>
diff --git a/content/api_en/endContour.xml b/content/api_en/endContour.xml
@@ -32,7 +32,7 @@ endShape(CLOSE);
 </example>
 
 <description><![CDATA[
-Use the <b>beginContour()</b> and <b>endContour()</b> function to create negative shapes within shapes such as the center of the letter 'O'. <b>beginContour()</b> begins recording vertices for the shape and <b>endContour()</b> stops recording. The vertices that define a negative shape must "wind" in the opposite direction from the exterior shape. First draw vertices for the exterior shape in clockwise order, then for internal shapes, draw vertices counter-clockwise.<br />
+Use the <b>beginContour()</b> and <b>endContour()</b> function to create negative shapes within shapes such as the center of the letter 'O'. <b>beginContour()</b> begins recording vertices for the shape and <b>endContour()</b> stops recording. The vertices that define a negative shape must "wind" in the opposite direction from the exterior shape. First draw vertices for the exterior shape in clockwise order, then for internal shapes, draw vertices counterclockwise.<br />
 <br />
 These functions can only be used within a <b>beginShape()</b>/<b>endShape()</b> pair and transformations such as <b>translate()</b>, <b>rotate()</b>, and <b>scale()</b> do not work within a <b>beginContour()</b>/<b>endContour()</b> pair. It is also not possible to use other shapes, such as <b>ellipse()</b> or <b>rect()</b> within.
 ]]></description>
diff --git a/content/api_en/hint.xml b/content/api_en/hint.xml
@@ -9,9 +9,7 @@
 <type></type>
 
 <description><![CDATA[
-This command is used to enable or disable special features that control how graphics are drawn. In the course of developing Processing, we have to make many decisions about tradeoffs between performance and visual quality. We put significant effort into determining what makes most sense for the largest number of users, and then use functions like the hint() command to allow people to tune the settings for their particular sketch. 
-<br /><br />
-Implementing a <b>hint()</b> is a last resort that's used when a more elegant solution cannot be found. Some options might graduate to standard features instead of hints over time, or be added and removed between (major) releases.
+This command is used to enable or disable special features that control how graphics are drawn. In the course of developing Processing, we had to make hard decisions about tradeoffs between performance and visual quality. We put significant effort into determining what makes most sense for the largest number of users, and then use functions like <b>hint()</b> to allow people to tune the settings for their particular sketch. Implementing a <b>hint()</b> is a last resort that's used when a more elegant solution cannot be found. Some options might graduate to standard features instead of hints over time, or be added and removed between (major) releases.
 <br /><br />
 Hints that are used by the default (Java2D) renderer:
 <br /><br />
@@ -33,7 +31,7 @@ Hints for use with P3D only:
 <br /><br />
 <b>hint(DISABLE_OPTIMIZED_STROKE)</b> - It forces the P3D renderer to draw each shape (including its strokes) separately, instead of batching them into larger groups for better performance. One consequence of this is that 2D items drawn with P3D are correctly stacked on the screen, depending on the order in which they were drawn. Otherwise, glitches such as the stroke lines being drawn on top of the interior of all the shapes will occur. However, this hint can make rendering substantially slower, so it is recommended to use it only when drawing a small amount of shapes. For drawing two-dimensional scenes, use the P2D renderer instead, which doesn't need the hint to properly stack shapes and their strokes.
 <br /><br />
-<b>hint(ENABLE_STROKE_PERSPECTIVE)</b> - This causes stroke geometry (lines and points) to be affected by the perspective, meaning that they will look smaller as they move away from the camera. 
+<b>hint(ENABLE_STROKE_PERSPECTIVE)</b> - This causes stroke geometry (lines and points) to be affected by the perspective, meaning that they will look smaller as they move away from the camera.
 ]]></description>
 
 </root>
diff --git a/content/api_en/include/logicalNOT.xml b/content/api_en/include/logicalNOT.xml
@@ -15,7 +15,20 @@ boolean a = false;
 if (!a) {
   rect(30, 20, 50, 50);
 }
-a = true;
+if (a) {
+  line(20, 10, 90, 80);
+  line(20, 80, 90, 10);
+}
+]]></code>
+</example>
+
+<example>
+<image>logicalNOT.png</image>
+<code><![CDATA[
+boolean a = true;
+if (!a) {
+  rect(30, 20, 50, 50);
+}
 if (a) {
   line(20, 10, 90, 80);
   line(20, 80, 90, 10);
diff --git a/content/api_media/logicalNOT.png b/content/api_media/logicalNOT.png
diff --git a/content/api_media/logicalNOT_2.png b/content/api_media/logicalNOT_2.png
