Bug#856654: xdotool: please add examples for set_desktop —relative in manpage

[Daniel Kahn Gillmor]

Control: forwarded 856654 https://github.com/jordansissel/xdotool/pull/166

> Please add examples for "set_desktop --relative" — it's not immediately
> clear that you have to use "--" in order that negative numbers are parsed
> correctly:

Hi Lamby--

thanks for the suggestion.

I've forwarded it upstream.

Regards,

--dkg

Bug#856654: xdotool: please add examples for set_desktop —relative in manpage

[Chris Lamb]

Source: xdotool
Version: 1:3.20160805.1-3
Severity: wishlist
Tags: patch

Hi,

Please add examples for "set_desktop --relative" — it's not immediately
clear that you have to use "--" in order that negative numbers are parsed
correctly:


$ xdotool set_desktop --relative -1
set_desktop: unrecognized option '-1'
Usage: set_desktop desktop
--relative- Move relative to the current desktop. Negative values OK

$ xdotool set_desktop --relative -- -1
 

Patch attached.


Regards,

-- 
  ,''`.
 : :'  : Chris Lamb
 `. `'`  la...@debian.org / chris-lamb.co.uk
   `-
diff --git a/xdotool.pod b/xdotool.pod
index 8651ae0..3a77659 100644
--- a/xdotool.pod
+++ b/xdotool.pod
@@ -837,6 +837,13 @@ current desktop.
 
 =back
 
+Examples:
+ # Change to desktop #5
+ xdotool set_desktop 5
+
+ # Change to the previous desktop. (Note the use of "--")
+ xdotool set_desktop --relative -- -1
+
 =item B
 
 Output the current desktop in view.