diff --git a/examples/APCmini.midizaprc b/examples/APCmini.midizaprc
index c80633a..7a0b78f 100644
--- a/examples/APCmini.midizaprc
+++ b/examples/APCmini.midizaprc
@@ -124,7 +124,7 @@ B5  G2
 ^F5  B3  # Bank Right
 ^F#5 C4  # Channel Left
 ^G5  C#4 # Channel Right
-# NOTE: Only Pan and Send appear to be supported in Ardour.
+# NOTE: Instr appears to be unsupported in Ardour.
 ^G#5 E3  # Track (Volume)
 ^A5  F#3 # Pan
 ^A#5 F3  # Send
diff --git a/examples/XTouchONE2.midizaprc b/examples/XTouchONE2.midizaprc
index 18c7683..fc0af0d 100644
--- a/examples/XTouchONE2.midizaprc
+++ b/examples/XTouchONE2.midizaprc
@@ -18,14 +18,14 @@ JACK_PORTS 2
 PASSTHROUGH
 SYSTEM_PASSTHROUGH
 
-# NOTE: This assumes that you use the default Mackie mode of the ONE.
-# Otherwise you may have to adjust the key mapping accordingly. I use the
-# SCRUB key as a replacement (F8 in MC mode), because I don't need that
-# function (it's not available in Ardour). If you do need that function, use
-# another one that you can spare.
-
 [MIDI]
 
+# NOTE: This assumes that you use the default Mackie mode of the ONE.
+# Otherwise you will have to adjust the mapping accordingly. I use the SCRUB
+# key as a replacement (F8 in MC mode), because I don't need that function
+# (it's not available in Ardour yet). If you need that key, use another one
+# that you can spare.
+
 F8 SHIFT ^F8 RELEASE SHIFT ^F8
 
 # Remap the shifted F1 .. F4 keys to do something useful. E.g., I have them
@@ -42,11 +42,15 @@ F8 SHIFT ^F8 RELEASE SHIFT ^F8
 ^A#4 C5
 ^B4  C#5
 
-# Since the X-Touch ONE is a single-channel controller, I find it convenient
-# to have the bank and channel switches linked up with the channel SELECT
-# switch, so that the first channel in the current bank is also selected in
-# the DAW. Therefore I have bound these functions to the shifted bank and
-# channel switches here.
+# Since the X-Touch ONE is a single-channel controller, I like to have the
+# bank and channel keys linked up with channel SELECT, so that the current
+# channel is also selected in the DAW when switching banks. Therefore I have
+# bound these functions to the shifted bank and channel keys here, but of
+# course you can change them to anything you want.
+
+# NOTE: You should configure a bank size of 1 for the ONE, so that all tracks
+# become accessible. At least that's necessary in Ardour; a suitable device
+# description for Ardour is included (see x-touch-one.device).
 
 ^A#3 A#3 C2   # BANK< SELECT
 ^B3  B3  C2   # BANK> SELECT
@@ -70,7 +74,7 @@ F8 SHIFT ^F8 RELEASE SHIFT ^F8
 
 # By default, other shifted keys in the CHANNEL and TRANSPORT sections are
 # simply passed through along with the SHIFT key as well. You can either
-# assign these combinations in the DAW, or edit them below as needed.
+# assign these combinations in the DAW, or edit the bindings below.
 
 ^C0  A#5 C0  RELEASE C0  A#5 # SHIFT REC
 ^G#0 A#5 G#0 RELEASE G#0 A#5 # SHIFT SOLO
@@ -93,7 +97,8 @@ F8 SHIFT ^F8 RELEASE SHIFT ^F8
 
 # Experiment with shifted controls. This remaps the shifted fader, encoder and
 # jog wheel on the ONE to CC1..CC3. As these controls aren't used by MCP, they
-# can be assigned freely, e.g., to some plugin parameters using MIDI learn.
+# can be assigned freely, e.g., to some plugin parameters, using MIDI learn.
+
 # NOTE: Touching the fader also emits a note message (G#8), which will get in
 # the way with MIDI learn, so we disable it here.