Please provide examples in --help and README.md

[Nowaker]

I've tried to use mons but I can't achieve anything I want. Here's my tries, all failed:

1. mons -S DisplayPort-0,DisplayPort-1:left,DisplayPort-2:right
2. mons -S DisplayPort-0,DisplayPort-1:L,DisplayPort-2:R 3. mons -S

Output of mons:

% mons
Monitors: 3
Mode: selection
0:*  DisplayPort-0 (enabled)         
1:   DisplayPort-1 (enabled)
2:   DisplayPort-2 (enabled)

At this point, I have no idea how to use -S parameter.

  -S <mon1>,<mon2>:<pos>
        Only enables two monitors with specified ids. The specified position
        places the second monitor on the right (R) or at the top (T).

Please provide examples in --help as well as README.md to make things clear.

EDIT: Apparently, better examples are in the README.md below, but I didn't scroll down far enough. First part of README.md is the same output as in --help so I didn't scroll down further. In this case, I'm asking for better output of --help only as README.md is good enough.

EDIT 2: I still don't know how to configure three monitors. I tried mons -S 1,0:R,2:R and I got this - far from what I wanted:

% mons             
Monitors: 3
Mode: selection
0:*  DisplayPort-0 (enabled)         
1:   DisplayPort-1 (enabled)
2:   DisplayPort-2     # <--- why not enabled?

[Ventto]

Hi @Nowaker,
Thanks for the feedback.

I think throw your comment that the usage is a bit confusing.
The -S option appears in the More monitors section but it is meant to select exclusively two monitor among several and places both of them.

So you can only use this option as following: mons -S 1,0:R but not mons -S 1,0:R,2:R where you are trying to place a third monitor.

[FichteFoll]

I ran into the same pitfall and only found out how this option is supposed to be used after reading the readme. It was not obvious to me that we are supposed to use the numbers to refer to monitors from the --help usage information.

I can see now that it mentions using "monitor ids" and that the --primary option refers to a monitor name, but it is not explained what this "id" is since the name is also unique and used as the identifier for xrandr operations, for example.