diff --git a/PixelatorControllerSettings.md b/PixelatorControllerSettings.md
index aa96944..0abdb4d 100644
--- a/PixelatorControllerSettings.md
+++ b/PixelatorControllerSettings.md
@@ -127,7 +127,7 @@ They are read until no more data is missing.
**nexusBookmark**::
A JSON structure that presents a set of "label" and "target" values that is passed to the user interface to simplify user navigation between different parts of the available file system. For example:
-```
+```json
"NeXusBookmarks" : [
{
"label" : "today e-mnt",
@@ -145,7 +145,7 @@ They are read until no more data is missing.
"label" : "PLV",
"target" : "/home/control/PLV"
}
- ],
+ ]
```
@@ -232,7 +232,49 @@ log4cpp.appender.stdout.layout=org.apache.log4cpp.PatternLayout
log4cpp.appender.stdout.layout.ConversionPattern=%d [%t] %-5p %c - %m%n
log4cpp.category.ch_semafor_stxm.test=INFO
```
-## Microscope Control
-This file contains a JSON structure that provides named positions and is passed to the user interface. This can be used to configure buttons that move positioners to predefined positions (e.g. "OSA out").
-🔴Where is the code that handles this? Maybe there is more flexibility?
\ No newline at end of file
+## Microscope Control
+This file contains a JSON structure that provides _named positions_ and is passed to the user interface. This can be used to configure buttons that move a positioner (or set of positioners) to a predefined value (e.g. "OSA out" could move OSAX to -3000 and OSAY to 4000). The JSON structure contains one field called "InOut", whose value is another structure with the name of each field corresponding to a separate _named position_. Each of these _named position_ fields contains a list (one entry per involved positioner) of structure with 3 fields:
+
+ **positioner**::
+ String value defining the positioner to be moved.
+
+ **positionIn**::
+ Double value defining the "in" value of the positioner.
+
+ **positionOut**::
+ Double value defining the "out" value of the positioner.
+
+Example:
+```json
+{
+ "InOut" : {
+ "OSA" : [
+ {
+ "positionIn" : 0.0,
+ "positionOut" : -3000.0,
+ "positioner" : "OSAX"
+ },
+ {
+ "positionIn" : 0.0,
+ "positionOut" : 4000.0,
+ "positioner" : "OSAY"
+ }
+ ],
+ "Sample" : [
+ {
+ "positionIn" : 5000.0,
+ "positionOut" : 10000.0,
+ "positioner" : "CoarseZ"
+ }
+ ],
+ "ZonePlate" : [
+ {
+ "positionIn" : -5000,
+ "positionOut" : -18000.0,
+ "positioner" : "Zoneplate"
+ }
+ ]
+ }
+}
+```
\ No newline at end of file