diff --git a/PixelatorControllerSettings.md b/PixelatorControllerSettings.md
index e7da2bc..4a7f3ea 100644
--- a/PixelatorControllerSettings.md
+++ b/PixelatorControllerSettings.md
@@ -5,6 +5,8 @@ one section per file.
The file format is [JSON](http://www.json.org/)
+Some options affect data recorded in the HDF5 files produced by Pixelator scans, which are based on the [NXstxm](https://doi.org/10.1063/1.4937536) application definition of the [NeXus](https://www.nexusformat.org/) data format.
+
# Settings
## Scan Files: Directory
@@ -87,7 +89,7 @@ ScanNumber is a three digit number, starting with 001 every day.
### scripts
**changeUserScript**::
- name of the script that is run on startup and whenever the user is changed
+ name of the script that is run on startup and whenever the user is changed (not really used yet - placeholder for future features)
**Optional**: no script is run when this setting is missing
**defaultUsername**::
@@ -197,8 +199,7 @@ See source: trunk/PixelatorController/config/epics.json for an example.
## Instrument
This file defines the content of the NXinstrument group of the scan file (hdf5).
-It is a json object with as many entries as needed. One group is made inside the NXinstrument group
-per entry of this settings file, with the key used as group name.
+It is a json object with as many entries as needed. One group is made inside the NXinstrument group per entry of this settings file, with the key used as group name.
See source:trunk/PixelatorController/config/instrument.json for an example.
@@ -347,27 +348,27 @@ The following settings are available for all types of positioners:
**Default**: "n"
**positionOffset**::
- Double value defines .
+ Double value defines shift of coordinates between those communicated with the hardware controller and the user.
**Default**: 0.0
**upperSoftLimit**::
- Double value defines .
+ Double value defines largest value allowed to be requested to move to.
**Default**: 0.0
**lowerSoftLimit**::
- Double value defines .
+ Double value defines lowest value allowed to be requested to move to.
**Default**: 0.0
**coarsePositioner**::
- String value defines .
+ String value defines cooperating positioner that will handle large movements.
**Default**: "" (empty string)
**finePositioner**::
- String value defines .
+ String value defines cooperating positioner that will handle fine movements.
**Default**: "" (empty string)
**maxVelocity**::
- Double value defines .
+ Double value defines maximum rate of movement.
**Default**: 0.0
**readOnly**::
@@ -397,7 +398,7 @@ The following settings are available for all types of positioners:
**beamlineControlPosition**::
- Unsigned integer value defines .
+ Unsigned integer value defines inclusion of (value greater than zero), and position of a positioner control in the GUI.
**Default**: 0
**epsilon**::