GUACAMOLE-724: Merge connection tiling and keyboard focus documentation.
diff --git a/src/images/client-connection-menu-multiple.png b/src/images/client-connection-menu-multiple.png
new file mode 100644
index 0000000..c85a10b
--- /dev/null
+++ b/src/images/client-connection-menu-multiple.png
Binary files differ
diff --git a/src/images/client-connection-menu.png b/src/images/client-connection-menu.png
new file mode 100644
index 0000000..a2529d8
--- /dev/null
+++ b/src/images/client-connection-menu.png
Binary files differ
diff --git a/src/images/client-panel.png b/src/images/client-panel.png
new file mode 100644
index 0000000..06155ac
--- /dev/null
+++ b/src/images/client-panel.png
Binary files differ
diff --git a/src/images/client-tiled-multi-focus.png b/src/images/client-tiled-multi-focus.png
new file mode 100644
index 0000000..6bb7b68
--- /dev/null
+++ b/src/images/client-tiled-multi-focus.png
Binary files differ
diff --git a/src/images/client-tiled.png b/src/images/client-tiled.png
new file mode 100644
index 0000000..73b9f96
--- /dev/null
+++ b/src/images/client-tiled.png
Binary files differ
diff --git a/src/images/guacamole-client-interface.png b/src/images/guacamole-client-interface.png
index 57c1dc7..6a35721 100644
--- a/src/images/guacamole-client-interface.png
+++ b/src/images/guacamole-client-interface.png
Binary files differ
diff --git a/src/using-guacamole.md b/src/using-guacamole.md
index 22fe250..9dc4484 100644
--- a/src/using-guacamole.md
+++ b/src/using-guacamole.md
@@ -82,20 +82,24 @@
The Guacamole menu provides options for:
-* Navigating back to the home screen
+* [Reading from (and writing to) the clipboard of the remote
+ desktop](using-the-clipboard)
-* Sharing the current connection
+* [Switching between active connections and displaying multiple connections at
+ once](client-connection-menu)
-* Reading from (and writing to) the clipboard of the remote desktop
+* [Navigating back to the home screen](client-user-menu)
-* Uploading and downloading files
+* [Disconnecting from the current connection entirely](client-user-menu)
-* Selecting alternative methods of typing or controlling the mouse,
- particularly for use on mobile or touchscreen devices
+* [Sharing the current connection](client-share-menu)
-* Zooming in and out of the remote display
+* [Uploading and downloading files](file-transfer)
-* Disconnecting from the current connection entirely
+* [Zooming in and out of the remote display](scaling-display)
+
+* [Selecting alternative methods of typing or controlling the mouse,
+ particularly for use on mobile or touchscreen devices](touch-devices)
(using-the-clipboard)=
@@ -115,6 +119,67 @@
text within the text area, and can manually copy it into the local clipboard if
desired.
+(client-connection-menu)=
+
+Switching and tiling connections
+--------------------------------
+
+If you have access to more than one connection, clicking the current connection
+name at the top of the Guacamole menu will open a drop-down menu containing a
+list of your other available connections:
+
+
+
+Clicking on the name of another connection in this drop-down menu will
+immediately switch to that connection. The previous connection will remain
+running as a thumbnail within a panel attached to the lower-right corner of the
+screen. This panel updates in real-time and remains visible as long as you have
+multiple active connections, even if you navigate away to another part of the
+Guacamole application:
+
+
+
+Clicking on any connection within the panel will navigate back to that
+connection, while clicking the "X" icon in the upper-right corner of the
+connection thumbnail will immediately close the connection.
+
+(client-tiling)=
+
+### Adding a connection to the current view
+
+Multiple connections may also be opened simultaneously within the same view by
+clicking the checkboxes next to the names of those connections in the
+connection menu:
+
+
+
+All connections opened in this way are automatically arranged in equally-sized
+tiles to fill the available area:
+
+
+
+With multiple connections displayed as tiles, keyboard interaction and the
+Guacamole menu will only affect the currently focused connection, as indicated
+by the blue title and border. Clicking or tapping within another connection
+will change the focus and allow keyboard interaction with _that_ connection.
+
+(client-broadcast-keyboard)=
+
+### Typing with multiple connections
+
+By holding down {kbd}`Ctrl` (to select an individual connection) or
+{kbd}`Shift` (to select a rectangle of connections), multiple connection may be
+focused at the same time. While multiple connections are focused, each key
+pressed will be broadcast across each focused connection:
+
+
+
+This is particularly useful for running the same series of commands on multiple
+computers. Further, since Guacamole automatically translates between the user's
+local keyboard layout and the keyboard layout of the remote server, _this will
+work as expected even if the keyboard layouts of focused connections do not
+match_.
+
(client-user-menu)=
Disconnecting and navigation
