X11: Allow custom WM_CLASS instance via --name <name>

doc/build.md

@@ -64,7 +64,7 @@ To reset permanent access, use the command:
   sudo vtm --mouse 0
   ```
 
-#### Deinstallation
+#### Uninstallation
 
 ```bash
 # Reset permanent access for pointing devices if it was set
@@ -99,7 +99,7 @@ If you prefer to perform a system-wide installation to the default path `/usr/lo
   ```bash
   sudo ./vtm --install
   ```
-- Deinstallation:
+- Uninstallation:
   ```bash
   sudo vtm --uninstall
   ```

doc/command-line-options.md

@@ -13,7 +13,7 @@ vtm -i | -u | -a [mode] | -v | -?
 <script relay via piped redirection> | vtm [ -p <id> ]
 ```
 
-> Without options, vtm runs Desktop Client, running an additional instance with Desktop Server in background if it is not running.
+> Without options, vtm runs both Desktop Server and Desktop Client.
 
 Option                  | Description
 ------------------------|-------------------------------------------------------
@@ -23,31 +23,32 @@ Option                  | Description
 `-t`, `--tui`           | Force TUI mode.
 `-g`, `--gui`           | Force GUI mode.
 `-i`, `--install`       | Perform system-wide installation. Allow Desktop Server to run in user context in Session 0 on Windows.<br>Placing Desktop Server in Session 0 allows console applications to run independently of the user's GUI login session. Note: This prevents GUI applications from running from the vtm desktop environment. See "Session 0 Isolation" on the Web for details.<br>Elevated privileges required.
-`-u`, `--uninstall`     | Perform system-wide deinstallation.<br>Elevated privileges required.
-`-0`, `--session0`      | Use Session 0 to run Desktop Server in background. For Windows only.
+`-u`, `--uninstall`     | Perform system-wide uninstallation.<br>Elevated privileges required.
+`-0`, `--session0`      | Use Session 0 to run Desktop Server in the background. For Windows only.
+`-name`, `--name <inst>`| Specify a custom WM_CLASS instance name. For X11/Xwayland only.
 `-a`, `--mouse [mode]`  | Set/reset persistent access to mouse devices for all users on Linux platform (excluding Android).<br>Run `sudo vtm --mouse 0` to reset access.<br>Elevated privileges required.
 `-q`, `--quiet`         | Disable logging.
-`-x`, `--script <cmds>` | Specifies script commands to be run by the desktop when ready.
-`-c`, `--config <file>` | Specifies a settings file to load or plain xml-data to merge.
-`-p`, `--pin <id>`      | Specifies the desktop id it will be pinned to.
+`-x`, `--script <cmds>` | Specify script commands to execute.
+`-c`, `--config <file>` | Specify a settings file to load or plain XML data to overlay.
+`-p`, `--pin <id>`      | Specify the desktop id to pin to.
 `-s`, `--server`        | Run Desktop Server.
-`-d`, `--daemon`        | Run Desktop Server in background.
+`-d`, `--daemon`        | Run Desktop Server in the background.
 `-m`, `--monitor`       | Run Log Monitor.
-`-r`, `--`, `--run`     | Run desktop applet standalone.
-`<type>`                | Desktop applet to run.
-`<args...>`             | Desktop applet arguments.
-`--env <var=val>`       | Set environment variable.
-`--cwd <path>`          | Set current working directory.
+`-r`, `--`, `--run`     | Run a desktop applet standalone.
+`<type>`                | Desktop applet type to run.
+`<args...>`             | Arguments for the desktop applet.
+`--env <var=val>`       | Set an environment variable.
+`--cwd <path>`          | Set the current working directory.
 `--fonts [v[erbose]]`   | Print available fonts (with horizontal scrolling).
 
 #### Inline configuration
 
-The plain xml-data could be specified in place of `<file>` in `--config <file>` option:
+The plain XML data could be specified in place of `<file>` in `--config <file>` option:
 - `command-line`:
   ```cmd
   vtm -c "<config><terminal><scrollback size=1000000/></terminal></config>" -r term
   ```
-  or (using compact syntax)
+  or using the compact syntax:
 - `command-line`:
   ```cmd
   vtm -c "<config/terminal/scrollback size=1000000/>" -r term
@@ -69,12 +70,12 @@ To reset permanent access, use the command:
 
 Applet                     | Type | Arguments
 ---------------------------|------|------------------------------------------
-Teletype Console (default) | vtty | CUI application with arguments to run
-Terminal Console           | term | CUI application with arguments to run
-DirectVT Gateway           | dtvt | DirectVT-aware application to run
+Teletype Console (default) | vtty | CUI application to run, along with its arguments
+Terminal Console           | term | CUI application to run, along with its arguments
+DirectVT Gateway           | dtvt | DirectVT-capable application to run
 DirectVT Gateway with TTY  | dtty | CUI application to run, forwarding DirectVT I/O
 
-The following commands have a short form:
+The following commands support short forms:
   - `vtm -r vtty <cui_app...>` can be shortened to `vtm <cui_app...>`.
   - `vtm -r dtty ssh <user@host dtvt_app...>` can be shortened to `vtm ssh <user@host dtvt_app...>`.
 

src/netxs/desktopio/application.hpp

@@ -21,7 +21,7 @@ namespace netxs::app
 
 namespace netxs::app::shared
 {
-    static const auto version = "v2026.09.27";
+    static const auto version = "v2026.09.28";
     static const auto repository = "https://github.com/directvt/vtm";
     static const auto usr_config = "~/.config/vtm/settings.xml"s;
     static const auto sys_config = "/etc/vtm/settings.xml"s;

src/netxs/desktopio/directvt.hpp

@@ -1094,10 +1094,10 @@ namespace netxs::directvt
                 : stream{ kind }
             { }
 
-            cell                           state; // bitmap: .
-            core                           image; // bitmap: .
-            ui16                           last_int_index{}; // bitmap: The last received image index (hot index, we do not check indexes twice in a row).
-            ui16                           last_ext_index{}; // bitmap: The last received image index (hot index, we do not check indexes twice in a row).
+            cell state; // bitmap: .
+            core image; // bitmap: .
+            ui16 last_int_index{}; // bitmap: The last received image index (hot index, we do not check indexes twice in a row).
+            ui16 last_ext_index{}; // bitmap: The last received image index (hot index, we do not check indexes twice in a row).
 
             enum : byte
             {