Update manual pages

1 files changed, 10 insertions, 8 deletions

diff --git a/doc/man/align_detector.1.md b/doc/man/align_detector.1.md
index c31e8758..aa5f5061 100644
--- a/doc/man/align_detector.1.md
+++ b/doc/man/align_detector.1.md
@@ -18,7 +18,8 @@ DESCRIPTION
 **align_detector** refines the detector geometry based on the calibration data
 written by **indexamajig**.  The refinement takes into account all the
 inter-dependencies between crystal orientations, cell parameters and the panel
-positions, but is nevertheless very fast.  This is achieved using the
+positions, as if a single large minimisation had been performed with all frames
+at once.  The algorithm is nevertheless very fast - this is achieved using the
 Millepede-II algorithm.  For more information, see
 https://www.desy.de/~kleinwrt/MP2/doc/html/index.html
 
@@ -29,11 +30,12 @@ section **Detector hierarchy**.
 Next, run **indexamajig** as usual, but with option **--mille**.  This will
 produce several files named **mille-data-0.bin**, **mille-data-1.bin**,
 **mille-data-2.bin** and so on - as many files as there were indexamajig
-subprocesses (set with **indexamajig -j**).
+subprocesses (set with **indexamajig -j**).  Use option **--mille-dir** to
+put these files in a useful location.
 
-Finally, run **align_detector**, giving it the input geometry file, the "Mille" files, a refinement
-level and a filename for the updated geometry file.  The input geometry file
-must match the file used for the indexamajig run.
+Finally, run **align_detector**, giving it the input geometry file, the "Mille"
+files, a refinement level and a filename for the updated geometry file.  The
+input geometry file must match the file used for the indexamajig run.
 
 Refinement level **0** allows only the overall detector position to vary.
 Higher levels allow groups of panels to move according to the hierarchy.  For
@@ -58,15 +60,15 @@ at https://gitlab.desy.de/claus.kleinwort/millepede-ii
 OPTIONS
 =======
 
-**-g** _input.geom_
+**-g** _input.geom_, **--geometry**=_input.geom_
 : Specify the input geometry filename.
 
-**-o** _output.geom_
+**-o** _output.geom_, **--output**=_output.geom_
 : Specify the output geometry filename.
 : Note that the geometry file will be re-written, meaning that any formatting
 : and comments will be lost.
 
-**-l** _level_
+**-l** _level_, **--level**=_level_
 : Specify the refinement level.  **-l 0** refines the overall detector position
 : only.  The maximum refinement level is determined by the hierarchy of the
 : detector.