Test and document filling behavior of self-intersecting polygons

1 files changed, 6 insertions, 2 deletions

diff --git a/src/gd.c b/src/gd.c
index e2c41e1..2d9803e 100644
--- a/src/gd.c
+++ b/src/gd.c
@@ -3467,8 +3467,8 @@ BGD_DECLARE(void) gdImagePolygon (gdImagePtr im, gdPointPtr p, int n, int c)
  *
  * Parameters:
  *   im - The image.
- *   p  - The vertices.
- *   n  - The number of vertices as array of <gdPoint>s.
+ *   p  - The vertices as array of <gdPoint>s.
+ *   n  - The number of vertices.
  *   c  - The color
  *
  * See also:
@@ -3506,6 +3506,10 @@ BGD_DECLARE(void) gdImageOpenPolygon (gdImagePtr im, gdPointPtr p, int n, int c)
  *
  * Draws a filled polygon
  *
+ * The polygon is filled using the even-odd fillrule what can leave unfilled
+ * regions inside of self-intersecting polygons. This behavior might change in
+ * a future version.
+ *
  * Parameters:
  *   im - The image.
  *   p  - The vertices as array of <gdPoint>s.