From a32a18f5c55ff8cf1a5b3e9f586355e266414b38 Mon Sep 17 00:00:00 2001
From: dlegland <david.legland@inrae.fr>
Date: Mon, 28 Feb 2022 14:13:42 +0100
Subject: [PATCH] geom3d/polygonCentroid3d.m: update doc header

---
 matGeom/geom3d/polygonCentroid3d.m | 12 ++++++++----
 1 file changed, 8 insertions(+), 4 deletions(-)

diff --git a/matGeom/geom3d/polygonCentroid3d.m b/matGeom/geom3d/polygonCentroid3d.m
index b572f589..9ea69dcd 100644
--- a/matGeom/geom3d/polygonCentroid3d.m
+++ b/matGeom/geom3d/polygonCentroid3d.m
@@ -1,9 +1,13 @@
 function centroid = polygonCentroid3d(varargin)
-%POLYGONCENTROID3D Centroid (or center of mass) of a polygon.
+%POLYGONCENTROID3D Centroid (or center of mass) of a polygon.
 %
 %   PTC = polygonCentroid3d(POLY)
 %   Computes center of mass of a polygon defined by POLY. POLY is a N-by-3
-%   array of double containing coordinates of polygon vertices.
+%   array of double containing coordinates of polygon vertices. The result
+%   PTC is given as a 1-by-3 numeric array.
+%   The algorithm assumes (1) that the vertices of the polygon are within
+%   the same plane and (2) that the planar projection of the polygon (on
+%   the embedding plane) do not self-intersect.
 %
 %   PTC = polygonCentroid3d(VX, VY, VZ)
 %   Specifies vertex coordinates as three separate arrays.
@@ -16,12 +20,12 @@
 %         5.0000    5.0000    10.0000
 %
 %   See also
-%   polygons3d, polygonArea3d, polygonCentroid
+%     polygons3d, polygonArea3d, polygonCentroid, planePosition, planePoint
 %
 
 % ------
 % Author: David Legland
-% e-mail: david.legland@inra.fr
+% e-mail: david.legland@inrae.fr
 % Created: 2007-09-18
 % Copyright 2007 INRA - CEPIA Nantes - MIAJ (Jouy-en-Josas).