userguide: document workspace next_on_output/prev_on_output

diff --git a/docs/userguide b/docs/userguide
index dce0371f19679fb4c1284bbf6016735f73d3ffbf..f1aba9daa4cb30f8086efcbe9a17946f4b23a4ea 100644 (file)
--- a/docs/userguide
+++ b/docs/userguide
@@ -1246,8 +1246,10 @@ number or name of the workspace. To move containers to specific workspaces, use
 You can also switch to the next and previous workspace with the commands
 +workspace next+ and +workspace prev+, which is handy, for example, if you have
 workspace 1, 3, 4 and 9 and you want to cycle through them with a single key
-combination. Similarly, you can use +move workspace next+ and +move workspace
-prev+ to move a container to the next/previous workspace.
+combination. To restrict those to the current output, use +workspace
+next_on_output+ and +workspace prev_on_output+. Similarly, you can use +move
+workspace next+ and +move workspace prev+ to move a container to the
+next/previous workspace.
 
 [[back_and_forth]]
 To switch back to the previously focused workspace, use +workspace