aboutsummaryrefslogtreecommitdiff
path: root/doc/man/crystfel_geometry.5.md
diff options
context:
space:
mode:
Diffstat (limited to 'doc/man/crystfel_geometry.5.md')
-rw-r--r--doc/man/crystfel_geometry.5.md13
1 files changed, 10 insertions, 3 deletions
diff --git a/doc/man/crystfel_geometry.5.md b/doc/man/crystfel_geometry.5.md
index ecaf60bf..640771ee 100644
--- a/doc/man/crystfel_geometry.5.md
+++ b/doc/man/crystfel_geometry.5.md
@@ -529,13 +529,20 @@ Groups can themselves be combined into higher-level groups, for example:
group_all = abc,def
-This defines a group called *all** which contains both of the groups created
+This defines a group called **all** which contains both of the groups created
above.
The highest-level group should always be called **all**.
-If the detector consists of only one panel, CrystFEL will automatically create
-the **all** group containing it.
+All members of a group need to be defined before defining the group. This
+means that the group definitions must come **after** the panel definitions, and
+the groups should be defined from the bottom to top level of the hierarchy -
+the **all** group coming last.
+
+If you do not define any groups, CrystFEL will automatically create the **all**
+group for you, containing all panels in a flat hierarchy. This allows basic
+geometry refinement (level zero, see **align_detector**) to work without any
+extra work.
The **group** system replaces the **rigid_group** system used in older versions
of CrystFEL. If the geometry file contains any **rigid_group** lines, they