Xpra: Ticket #2572: Man page cleanup

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 protocol:// syntax.

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.



Sun, 02 Feb 2020 17:11:55 GMT - Bill Randle: attachment set

man page diff


Mon, 03 Feb 2020 02:44:32 GMT - Antoine Martin: status changed; resolution set

Thanks!

Applied in r25133. (r25134 for v3.0.x)


Sat, 23 Jan 2021 05:54:56 GMT - migration script:

this ticket has been moved to: https://github.com/Xpra-org/xpra/issues/2572