From 9f857ce84a2fbe7ca972a34e20913aa813364f40 Mon Sep 17 00:00:00 2001
From: Peter Kokot <peterkokot@gmail.com>
Date: Sat, 22 Mar 2025 12:33:07 +0100
Subject: [PATCH] FindCoin3D: Update documentation

---
 Modules/FindCoin3D.cmake | 32 ++++++++++++++++++++++++++------
 1 file changed, 26 insertions(+), 6 deletions(-)

diff --git a/Modules/FindCoin3D.cmake b/Modules/FindCoin3D.cmake
index f517f3ba37..1d89c604e0 100644
--- a/Modules/FindCoin3D.cmake
+++ b/Modules/FindCoin3D.cmake
@@ -5,18 +5,38 @@
 FindCoin3D
 ----------
 
-Find Coin3D (Open Inventor)
+Finds Coin3D (Open Inventor).
 
 Coin3D is an implementation of the Open Inventor API.  It provides
 data structures and algorithms for 3D visualization.
 
-This module defines the following variables
+Result Variables
+^^^^^^^^^^^^^^^^
 
-::
+This module defines the following variables:
 
-  COIN3D_FOUND         - system has Coin3D - Open Inventor
-  COIN3D_INCLUDE_DIRS  - where the Inventor include directory can be found
-  COIN3D_LIBRARIES     - Link to this to use Coin3D
+``Coin3D_FOUND``
+  True if Coin3D, Open Inventor was found.  For backward compatibility, the
+  ``COIN3D_FOUND`` variable is also set to the same value.
+
+Cache Variables
+^^^^^^^^^^^^^^^
+
+The following cache variables may also be set:
+
+``COIN3D_INCLUDE_DIRS``
+  Directory containing the Open Inventor header files (``Inventor/So.h``).
+``COIN3D_LIBRARIES``
+  Coin3D libraries required for linking.
+
+Examples
+^^^^^^^^
+
+Finding Coin3D:
+
+.. code-block:: cmake
+
+  find_package(Coin3D)
 #]=======================================================================]
 
 if (WIN32)