riverctl: add -focused-output for option commands

This is more convenient for interactive usage and makes using the same
bindings across multiple outputs easy.

1 files changed, 6 insertions, 5 deletions

diff --git a/doc/riverctl.1.scd b/doc/riverctl.1.scd
index 3424ea4..cbb3896 100644
--- a/doc/riverctl.1.scd
+++ b/doc/riverctl.1.scd
@@ -284,19 +284,20 @@ A complete list may be found in _/usr/include/linux/input-event-codes.h_
 
 River has various options that are saved in a typed key-value store. It also
 allows users to store arbitrary custom options in the store. Options are
-scoped either globally or per-output if the -output flag is passed with the
-name of the output as obtained from the xdg-output protocol.
+scoped either globally or per-output if the *-output* flag is passed with the
+name of the output as obtained from the xdg-output protocol. Alternatively,
+the currently focused output may be targeted with the *-focused-output* flag.
 
-*declare-option* [-output _output_name_] _name_ _type_ _value_
+*declare-option* [*-output* _output_name_|*-focused-output*] _name_ _type_ _value_
 	Declare a new option with the given _type_ and inital _value_. If
 	the option already exists with the given _type_, it is still set
 	to _value_. If the option already exists with a different type,
 	nothing happens.
 
-*get-option* [-output _output_name_] _name_
+*get-option* [*-output* _output_name_|*-focused-output*] _name_
 	Print the current value of the given option to stdout.
 
-*set-option* [-output _output_name_] _name_ _value_
+*set-option* [*-output* _output_name_|*-focused-output*] _name_ _value_
 	Set the value of the specified option to _value_.
 
 River declares certain default options for all outputs.