From 37c810fb3f73f4e2c9c66ce46416f4b4fa94f21a Mon Sep 17 00:00:00 2001
From: mkuehbach <markus.kuehbach@physik.hu-berlin.de>
Date: Sun, 29 Sep 2024 14:51:21 +0200
Subject: [PATCH] Guiding user on how to detail aperture geometry

---
 base_classes/NXaperture.nxdl.xml | 4 +++-
 1 file changed, 3 insertions(+), 1 deletion(-)

diff --git a/base_classes/NXaperture.nxdl.xml b/base_classes/NXaperture.nxdl.xml
index cef93d0d9..32964dc6a 100644
--- a/base_classes/NXaperture.nxdl.xml
+++ b/base_classes/NXaperture.nxdl.xml
@@ -26,6 +26,8 @@
       A beamline aperture.
 
       Note, the group was incorrectly documented as deprecated, but it is not and it is in common use.
+      
+      You can specify the geometry of the aperture using either NXoff_geometry or for simpler geometry shape and size.
     </doc>
     <!--TODO compare with "screens" in SHADOW-->
     <field name="depends_on" type="NX_CHAR">
@@ -66,7 +68,7 @@
     </group>
     <group type="NXgeometry" deprecated="Use the field `depends_on` and :ref:`NXtransformations` to position the aperture and :ref:`NXoff_geometry` to describe its shape">
         <doc>
-            location and shape of aperture
+            Location and shape of aperture
             
             .. TODO: documentation needs improvement, contributions welcome