# HG changeset patch
# User Rik <rik@octave.org>
# Date 1674857351 28800
# Node ID 53b2eb3cb06a715b597a99413e47f65536d37221
# Parent  947b8c671680aabe1a8f23ce029a688ea7cfcc29# Parent  4ccdb13c160aa38b5af78958aa466d1bc67a6f5e
maint: merge stable to default

diff -r 947b8c671680 -r 53b2eb3cb06a libinterp/corefcn/graphics.cc
--- a/libinterp/corefcn/graphics.cc	Fri Jan 27 08:23:17 2023 -0800
+++ b/libinterp/corefcn/graphics.cc	Fri Jan 27 14:09:11 2023 -0800
@@ -12098,8 +12098,16 @@
 @itemize
 @item as a comma separated list of @var{property}, @var{value} pairs
 
-Here, each @var{property} is a string containing the property name, each
-@var{value} is a value of the appropriate type for the property.
+Each @var{property} is a string containing the property name, each @var{value}
+is a value of the appropriate type for the property.  When there are multiple
+handles in @var{h}, each one is assigned the same @var{value}.  For example:
+
+@example
+@group
+h = plot ([0, 1]);
+set (h, 'color', 'green');
+@end group
+@end example
 
 @item as a cell array of strings @var{properties} containing property names
 and a cell array @var{values} containing property values.
@@ -12109,15 +12117,30 @@
 values for the first entry in @var{properties}, etc.  The number of rows of
 @var{values} must be 1 or match the number of elements of @var{h}.  In the
 first case, each handle in @var{h} will be assigned the same values.  In the
-latter case, the first handle in @var{h} will be assigned the values from
-the first row of @var{values} and so on.
-
-@item as a structure array @var{pv}
-
-Here, the field names of @var{pv} represent the property names, and the
-field values give the property values.  In contrast to the previous case,
-all elements of @var{pv} will be set in all handles in @var{h} independent
-of the dimensions of @var{pv}.
+second case, the first handle in @var{h} will be assigned the values from
+the first row of @var{values} and so on.  For example:
+
+@example
+@group
+h = plot ([0, 1; 1, 0]);
+set (h, @{'color'@}, @{'green'; 'red'@});
+@end group
+@end example
+
+@item as a structure @var{pv}
+
+This is the same as the first case where the field names of @var{pv} represent
+the property names, and the field values give the property values.  As with
+the first case, it is only possible to set one value for a property which will
+be applied to all handles in @var{h}.  For example:
+
+@example
+@group
+h = plot ([0, 1]);
+props.color = 'green';
+set (h, props);
+@end group
+@end example
 @end itemize
 
 @code{set} is also used to query the list of values a named property will