--- a/doc/upplay.txt
+++ b/doc/upplay.txt
@@ -38,6 +38,24 @@
 
 You can clear the current playlist by clicking the broom icon above it on
 the right.
+
+=== Saved seek position mode
+
+If "Save seek position when switching tracks" is set in the preferences,
+then, when double-clicking a track in the playlist, the play will start at
+a saved seek position instead of the beginning.
+
+- If the playlist is in repeat mode, the saved position will be the last
+  place where the track was paused
+- If the playlist is in normal mode, the saved position will be the last
+  position played (before previously switching tracks).
+
+This can be useful for playing tracks in parallel for comparison purposes.
+
+The "saved pause position" mode works with a single track, so play will
+restart at the same position every time you double-click (repeat play of a
+passage).
+
 
 == Directory browser section