Doc: clarify units and directional distortion of -simplify and -segme…

…ntize (OSGeo#10087) * Update gdal_footprint.rst adding periods * Update ogr2ogr.rst clarifying units
innFactory · May 31, 2024 · 603e800 · 603e800
1 parent 123cad1
commit 603e800
Show file tree

Hide file tree

Showing 2 changed files with 14 additions and 4 deletions.
diff --git a/doc/source/programs/gdal_footprint.rst b/doc/source/programs/gdal_footprint.rst
@@ -113,16 +113,16 @@ proper mask bands.
     consecutive points of the output geometry.
     The unit of the distance is in pixels if :option:`-t_cs` equals ``pixel``,
     or otherwise in georeferenced units of the source raster.
-    This option is applied before the reprojection implied by :option:`-t_srs`
+    This option is applied before the reprojection implied by :option:`-t_srs`.
 
 .. option:: -simplify <value>
 
     The specified value of this option is the tolerance used to merge
     consecutive points of the output geometry using the
-    :cpp:func:`OGRGeometry::Simplify` method
+    :cpp:func:`OGRGeometry::Simplify` method.
     The unit of the distance is in pixels if :option:`-t_cs` equals ``pixel``,
     or otherwise in georeferenced units of the target vector dataset.
-    This option is applied after the reprojection implied by :option:`-t_srs`
+    This option is applied after the reprojection implied by :option:`-t_srs`.
 
 .. option:: -min_ring_area <value>
 

diff --git a/doc/source/programs/ogr2ogr.rst b/doc/source/programs/ogr2ogr.rst
@@ -450,9 +450,19 @@ output coordinate system or even reprojecting the features during translation.
     topology per feature, in particular for polygon geometries, but not for a
     whole layer.
 
+    The specified value of this option is the tolerance used to merge
+    consecutive points of the output geometry using the
+    :cpp:func:`OGRGeometry::Simplify` method
+    The unit of the distance is in 
+    georeferenced units of the source vector dataset.
+    This option is applied before the reprojection implied by :option:`-t_srs`
+
 .. option:: -segmentize <max_dist>
 
-    Maximum distance between 2 nodes. Used to create intermediate points.
+    The specified value of this option is the maximum distance between two
+    consecutive points of the output geometry before intermediate points are added.
+    The unit of the distance is georeferenced units of the source raster.
+    This option is applied before the reprojection implied by :option:`-t_srs`
 
 .. option:: -makevalid