(guacamole-manual) 01/01: GUACAMOLE-1026: Update documentation for freerdp3 support.

[al...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

aleitner pushed a commit to branch rdp3-support
in repository https://gitbox.apache.org/repos/asf/guacamole-manual.git

commit 96d121c69594164954efa3fdd5e18f450339ff0c
Author: Alex Leitner <al...@keepersecurity.com>
AuthorDate: Mon Aug 26 15:19:26 2024 -0400

    GUACAMOLE-1026: Update documentation for freerdp3 support.
---
 src/installing-guacamole.md | 8 +++++++-
 src/troubleshooting.md      | 9 +++++----
 2 files changed, 12 insertions(+), 5 deletions(-)

diff --git a/src/installing-guacamole.md b/src/installing-guacamole.md
index 6695f90..d5d5a58 100644
--- a/src/installing-guacamole.md
+++ b/src/installing-guacamole.md
@@ -460,6 +460,13 @@ fail outright, and you will need to install the missing dependency. If, after
 running `configure`, you find support for something you wanted is missing,
 simply install the corresponding dependencies and run `configure` again.
 
+During the configure process, the script will attempt to detect the version of
+FreeRDP installed on your system. It will first look for FreeRDP version 3,
+indicated as freerdp3 ............ yes. If FreeRDP version 3 is not found, it will
+then check for FreeRDP version 2, which would be shown as
+freerdp2 ............ yes. The output will reflect the specific version found,
+ensuring that the build process aligns with the available FreeRDP library.
+
 :::{important}
 All protocols that require a terminal (Kubernetes, SSH, and telnet) require
 that fonts are installed on the Guacamole server in order to function, as
@@ -767,4 +774,3 @@ it will immediately and transparently fall back to using HTTP.
 WebSocket is supported in Guacamole for Tomcat 7.0.37 or higher, Jetty 8 or
 higher, and any servlet container supporting JSR 356, the standardized Java API
 for WebSocket.
-
diff --git a/src/troubleshooting.md b/src/troubleshooting.md
index dc62767..55d61dc 100644
--- a/src/troubleshooting.md
+++ b/src/troubleshooting.md
@@ -364,9 +364,11 @@ If libguac-client-rdp cannot load this plugin, support for any features which
 leverage static virtual channels will not work, and the reason will be logged.
 A likely explanation is that libguac-client-rdp was built from source, and the
 directory specified for FreeRDP's installation location was incorrect. For
-FreeRDP to be able to find plugins, those plugins must be placed in the
-`freerdp2/` subdirectory of whichever directory contains the `libfreerdp2.so`
-library.
+FreeRDP to be able to find plugins, those plugins must be placed in the correct
+subdirectory relative to the version of FreeRDP installed. For FreeRDP 2, plugins
+should be placed within the `freerdp2/` subdirectory of whichever directory
+contains `libfreerdp2.so`, and similarly, for FreeRDP 3, plugins should be placed
+in the `freerdp3/` subdirectory of whichever directory contains `libfreerdp3.so`.
 
 #### Server requested unsupported clipboard data type
 
@@ -539,4 +541,3 @@ an instruction to have a length prefix, which must be composed entirely of
 numeric characters (digits 0 through 9). If a non-numeric character is read,
 then something has gone wrong during transmission. This usually indicates a bug
 in the client plugin in use, guacd, or libguac.
-