Incremental commit on PR

doc/source/dem_class.md

@@ -21,11 +21,11 @@ Below, a summary of the {class}`~xdem.DEM` object and its methods.
 ## Object definition and attributes
 
 A {class}`~xdem.DEM` is a {class}`~geoutils.Raster` with an additional georeferenced vertical dimension stored in the attribute {attr}`~xdem.DEM.vcrs`.
-It inherits the **four main attributes** of {class}`~geoutils.Raster` which are {attr}`~xdem.DEM.data`, 
+It inherits the **four main attributes** of {class}`~geoutils.Raster` which are {attr}`~xdem.DEM.data`,
 {attr}`~xdem.DEM.transform`, {attr}`~xdem.DEM.crs` and {attr}`~xdem.DEM.nodata`.
 
-Many other useful raster attributes, such as {attr}`~xdem.DEM.bounds` and {attr}`~xdem.DEM.res` and raster methods 
-such {attr}`~xdem.DEM.reproject` or {attr}`~xdem.DEM.crop` are available through the {class}`~geoutils.Raster` object. 
+Many other useful raster attributes, such as {attr}`~xdem.DEM.bounds` and {attr}`~xdem.DEM.res` and raster methods
+such {attr}`~xdem.DEM.reproject` or {attr}`~xdem.DEM.crop` are available through the {class}`~geoutils.Raster` object.
 
 ```{important}
 Below, we only cover a few core aspects linked to the {class}`~geoutils.Raster` object. For more details, see [GeoUtils' Raster documentation page](https://geoutils.readthedocs.io/en/stable/raster_class.html).
@@ -69,6 +69,3 @@ dem.save("mydem.tif")
 import os
 os.remove("mydem.tif")
 ```
-
-
-

doc/source/elevation_objects.md

@@ -1,7 +1,7 @@
 (elevation-objects)=
 # Elevation data objects
 
-Elevation data objects of xDEM inherit their characteristics from raster and vector objects of 
+Elevation data objects of xDEM inherit their characteristics from raster and vector objects of
 our sister-package [GeoUtils](https://geoutils.readthedocs.io/en/stable/).
 
 ```{toctree}

doc/source/elevation_point_cloud.md

@@ -14,4 +14,4 @@ kernelspec:
 
 # The elevation point cloud ({class}`~xdem.EPC`)
 
-In construction, planned for 2024.
+In construction, planned for 2024.

xdem/misc.py

@@ -168,6 +168,9 @@ def decorator(decorated: Callable) -> Callable:  # type: ignore
                 )
                 other_doc = other_doc.replace(resolution_section, "")
 
+        # Remove docstring examples
+        other_doc = other_doc.split(":examples:")[0]
+
         decorated.__doc__ = other_doc
 
         return decorated