From looking at the code, it appears the use of CONNECTIONSTRING applies to the start, start-desktop modes and shadow modes, as well sd attach and control. I think it would make things clearer to show this in the synopsis entries and update the examples to use the newer preferred
The example entry:
xpra attach ssh://foo@frodo:7
is just plain wrong and won't work. I kept having problems attaching to a remote server until I looked closer at the CONNECTIONSTRINGS section and realized the example should have been:
xpra attach ssh://foo@frodo/7
There also seems to be a misplaced : in the upgrade synopsis entries, where it shows
:[DISPLAY] rather than
[:DISPLAY]. It wasn't clear if upgrade supports a connection string.
I've attached a proposed diff for the man page. You are welcome to use all or none. As a final note, there is no
documentation component for tickets, so I used packaging.
man page diff
this ticket has been moved to: https://github.com/Xpra-org/xpra/issues/2572