# HG changeset patch
# User Nicholas R. Jankowski <jankowski.nicholas@gmail.com>
# Date 1710270151 14400
# Node ID 3e0b916d4666e23e843b8c0348d57b1a6dd72c81
# Parent  16aa98e2c3e71af6136ce1c80472f0beb9038245# Parent  773c6bd1963034b0508a9fbf29e7dad22238c69e
maint: Merge stable to default.

diff -r 16aa98e2c3e7 -r 3e0b916d4666 scripts/plot/draw/patch.m
--- a/scripts/plot/draw/patch.m	Mon Mar 11 17:44:36 2024 +0100
+++ b/scripts/plot/draw/patch.m	Tue Mar 12 15:02:31 2024 -0400
@@ -71,10 +71,25 @@
 ## The optional return value @var{h} is a graphics handle to the created patch
 ## object.
 ##
-## Programming Note: The full list of properties is documented at
-## @ref{Patch Properties}.  Useful patch properties include:
-## @qcode{"cdata"}, @qcode{"edgecolor"}, @qcode{"facecolor"}, @qcode{"faces"},
-## and @qcode{"facevertexcdata"}.
+## Programming Notes:
+## @enumerate
+## @item
+## The full list of properties is documented at @ref{Patch Properties}.
+## Useful patch properties include: @qcode{"cdata"}, @qcode{"edgecolor"},
+## @qcode{"facecolor"}, @qcode{"faces"}, @qcode{"vertices"}, and
+## @qcode{"facevertexcdata"}.
+## @item
+## Properties specifying patch geometry (@qcode{"xdata"}, @qcode{"ydata"},
+## @qcode{"zdata"}, @qcode{"faces"}, @qcode{"vertices"}) should be specified
+## before other properties to avoid unexpected plot outputs or errors.
+## @item
+## Unexpected geometry results can occur from mixing x-y-z and
+## face-vertex forms of defining geometry.
+## @item
+## Unexpected patch color results can occur from using @qcode{"cdata"} color
+## definitons with face-vertex defined geometry or @qcode{"facecentercdata"}
+## color definitions with x-y-z defined geometry.
+## @end enumerate
 ## @seealso{fill, get, set}
 ## @end deftypefn