From 79e4c20a076ec08490797595626407027e9e8b03 Mon Sep 17 00:00:00 2001 From: Ulrich Sibiller Date: Mon, 17 Dec 2018 22:33:52 +0100 Subject: manpage: add -sync (partially) fixes ArcticaProject/nx-libs#666 --- nx-X11/programs/Xserver/hw/nxagent/man/nxagent.1 | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/nx-X11/programs/Xserver/hw/nxagent/man/nxagent.1 b/nx-X11/programs/Xserver/hw/nxagent/man/nxagent.1 index 9dd4c8485..23bf5de77 100644 --- a/nx-X11/programs/Xserver/hw/nxagent/man/nxagent.1 +++ b/nx-X11/programs/Xserver/hw/nxagent/man/nxagent.1 @@ -199,6 +199,12 @@ e.g.: display number string written to STDERR is beautified with some human-readable (machine-parseable) text. .TP 8 +.B \-sync +This option tells \fBnxagent\fR to synchronize its window and graphics +operations with the real server. This is a useful option for +debugging, but it will slow down \fBnxagent\fR's performance +considerably. It should not be used unless absolutely necessary. +.TP 8 .B \-deferglyphs \fIwhichfonts\fP specifies the types of fonts for which the server should attempt to use deferred glyph loading. \fIwhichfonts\fP can be all (all fonts), -- cgit v1.2.3 From 0b454d2d3c88d0bb42f111baa644429a624ba628 Mon Sep 17 00:00:00 2001 From: Ulrich Sibiller Date: Mon, 17 Dec 2018 22:34:15 +0100 Subject: manpage: add -full (partially) fixes ArcticaProject/nx-libs#666 --- nx-X11/programs/Xserver/hw/nxagent/man/nxagent.1 | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/nx-X11/programs/Xserver/hw/nxagent/man/nxagent.1 b/nx-X11/programs/Xserver/hw/nxagent/man/nxagent.1 index 23bf5de77..531caa71f 100644 --- a/nx-X11/programs/Xserver/hw/nxagent/man/nxagent.1 +++ b/nx-X11/programs/Xserver/hw/nxagent/man/nxagent.1 @@ -205,6 +205,17 @@ operations with the real server. This is a useful option for debugging, but it will slow down \fBnxagent\fR's performance considerably. It should not be used unless absolutely necessary. .TP 8 +.B \-full +This option tells \fBnxagent\fR to utilize full regeneration of real +server objects and reopen a new connection to the real server each +time \fBnxagent\fR regenerates. The sample server implementation +regenerates all objects in the server when the last client of this +server terminates. When this happens, \fBnxagent\fR by default +maintains the same top-level window and the same real server +connection in each new generation. If the user selects full +regeneration, even the top-level window and the connection to the real +server will be regenerated for each server generation. +.TP 8 .B \-deferglyphs \fIwhichfonts\fP specifies the types of fonts for which the server should attempt to use deferred glyph loading. \fIwhichfonts\fP can be all (all fonts), -- cgit v1.2.3 From 3b508010de68ece72d725921dbdf032efc955190 Mon Sep 17 00:00:00 2001 From: Ulrich Sibiller Date: Mon, 17 Dec 2018 22:34:43 +0100 Subject: manpage: add -class (partially) fixes ArcticaProject/nx-libs#666 --- nx-X11/programs/Xserver/hw/nxagent/man/nxagent.1 | 32 ++++++++++++++++++++++++ 1 file changed, 32 insertions(+) diff --git a/nx-X11/programs/Xserver/hw/nxagent/man/nxagent.1 b/nx-X11/programs/Xserver/hw/nxagent/man/nxagent.1 index 531caa71f..a7b3cdd47 100644 --- a/nx-X11/programs/Xserver/hw/nxagent/man/nxagent.1 +++ b/nx-X11/programs/Xserver/hw/nxagent/man/nxagent.1 @@ -216,6 +216,38 @@ connection in each new generation. If the user selects full regeneration, even the top-level window and the connection to the real server will be regenerated for each server generation. .TP 8 +.B \-class \fIstring\fP +This option specifies the default visual class of the nested server. +It is similar to the +.B \-cc +option from the set of standard options except that it will accept a string +rather than a number for the visual class specification. +The +.I string +must be one of the following six values: +.BR StaticGray , +.BR GrayScale , +.BR StaticColor , +.BR PseudoColor , +.BR TrueColor , +or +.BR DirectColor . +If both the +.B \-class +and +.B \-cc +options are specified, the last instance of either option takes precedence. +The class of the default visual of the nested server need not be the same as the +class of the default visual of the real server, but it must be supported by the +real server. +Use +.BR xdpyinfo (__appmansuffix__) +to obtain a list of supported visual classes on the real server before +starting \fBnxagent\fR. If the user chooses a static class, all the +colors in the default color map will be preallocated. If the user +chooses a dynamic class, colors in the default color map will be +available to individual clients for allocation. +.TP 8 .B \-deferglyphs \fIwhichfonts\fP specifies the types of fonts for which the server should attempt to use deferred glyph loading. \fIwhichfonts\fP can be all (all fonts), -- cgit v1.2.3 From 51664049f23c9806a7fb6ce3ec5004f1dc4472ca Mon Sep 17 00:00:00 2001 From: Ulrich Sibiller Date: Mon, 17 Dec 2018 22:35:18 +0100 Subject: manpage: add -depth (partially) fixes ArcticaProject/nx-libs#666 --- nx-X11/programs/Xserver/hw/nxagent/man/nxagent.1 | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/nx-X11/programs/Xserver/hw/nxagent/man/nxagent.1 b/nx-X11/programs/Xserver/hw/nxagent/man/nxagent.1 index a7b3cdd47..ddc8e2b60 100644 --- a/nx-X11/programs/Xserver/hw/nxagent/man/nxagent.1 +++ b/nx-X11/programs/Xserver/hw/nxagent/man/nxagent.1 @@ -253,6 +253,15 @@ specifies the types of fonts for which the server should attempt to use deferred glyph loading. \fIwhichfonts\fP can be all (all fonts), none (no fonts), or 16 (16 bit fonts only). .TP 8 +.B \-depth \fIint\fP +This option specifies the default visual depth of the nested server. +The depth of the default visual of the nested server need not be the +same as the depth of the default visual of the real server, but it +must be supported by the real server. Use +.BR xdpyinfo (__appmansuffix__) +to obtain a list of supported visual depths on the real server before +starting \fBnxagent\fR. +.TP 8 .B \-dpi \fIresolution\fP sets the resolution for all screens, in dots per inch. To be used when the server cannot determine the screen size(s) from the -- cgit v1.2.3 From 338e2051020f5a9895574d597325b1bcc67d4d3b Mon Sep 17 00:00:00 2001 From: Ulrich Sibiller Date: Mon, 17 Dec 2018 22:35:35 +0100 Subject: manpage: add -geometry (partially) fixes ArcticaProject/nx-libs#666 --- nx-X11/programs/Xserver/hw/nxagent/man/nxagent.1 | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/nx-X11/programs/Xserver/hw/nxagent/man/nxagent.1 b/nx-X11/programs/Xserver/hw/nxagent/man/nxagent.1 index ddc8e2b60..575ebd08a 100644 --- a/nx-X11/programs/Xserver/hw/nxagent/man/nxagent.1 +++ b/nx-X11/programs/Xserver/hw/nxagent/man/nxagent.1 @@ -262,6 +262,25 @@ must be supported by the real server. Use to obtain a list of supported visual depths on the real server before starting \fBnxagent\fR. .TP 8 +.B \-geometry \fIW\fBx\fIH\fB+\fIX\fB+\fIY\fP +This option specifies the geometry parameters for the top-level +\fBnxagent\fR window. See \(lqGEOMETRY SPECIFICATIONS\(rq in +.BR X (__miscmansuffix__) +for a discusson of this option's syntax. This window corresponds to +the root window of the nested server. The width +.I W +and height +.I H +specified with this option will be the maximum width and height of +each top-level \fBnxagent\fR window. \fBnxagent\fR will allow the +user to make any top-level window smaller, but it will not actually +change the size of the nested server root window. If this option is +not specified, \fBnxagent\fR will choose +.I W +and +.I H +to be 3/4ths the dimensions of the root window of the real server. +.TP 8 .B \-dpi \fIresolution\fP sets the resolution for all screens, in dots per inch. To be used when the server cannot determine the screen size(s) from the -- cgit v1.2.3 From b8138d97d5b9259aab1372aa47c425c99d23f5fd Mon Sep 17 00:00:00 2001 From: Ulrich Sibiller Date: Mon, 17 Dec 2018 22:36:07 +0100 Subject: manpage: add/extend -dpi/-autodpi (partially) fixes ArcticaProject/nx-libs#666 --- nx-X11/programs/Xserver/hw/nxagent/man/nxagent.1 | 21 +++++++++++++++++---- 1 file changed, 17 insertions(+), 4 deletions(-) diff --git a/nx-X11/programs/Xserver/hw/nxagent/man/nxagent.1 b/nx-X11/programs/Xserver/hw/nxagent/man/nxagent.1 index 575ebd08a..8ef1d639b 100644 --- a/nx-X11/programs/Xserver/hw/nxagent/man/nxagent.1 +++ b/nx-X11/programs/Xserver/hw/nxagent/man/nxagent.1 @@ -282,9 +282,14 @@ and to be 3/4ths the dimensions of the root window of the real server. .TP 8 .B \-dpi \fIresolution\fP -sets the resolution for all screens, in dots per inch. -To be used when the server cannot determine the screen size(s) from the -hardware. +sets the resolution for all screens, in dots per inch. If this option +is not specified \fBnxagent\fR will assume 96. There's also +.B \-autodpi +which will clone the real server's dpi. Note that the resolution specified via +.B \-dpi +is a per session setting. It cannot be changed on reconnect! This means that +clients may look "wrong" when reconnecting a session that had been +started with a different dpi than the current real xserver. .TP 8 .B dpms enables DPMS (display power management services), where supported. The @@ -468,7 +473,15 @@ auto-disconnect timeout in seconds (minimum allowed: 60) don't exit if there are no clients in rootless mode .TP 8 .B \-autodpi -detect real server's DPI and set it in the agent session; the \fI-dpi \fR cmdline option overrides \fI-autodpi\fR +detect real server's DPI and set it in the agent session; the +.B \-dpi\fP cmdline option overrides +.B \-autodpi\fP. +Note that using +.B \-autodpi +will also adapt the DPI on reconnect which will cause +newly started clients respecting the new DPI while clients that had +been started before the reconnect still use the old DPI. This may lead +to applications looking "weird". .TP 8 .B \-nomagicpixel disable magic pixel support at session startup, can be re-enabled via nx/nx option on session -- cgit v1.2.3 From b405b962f192acbc74dca7777026b70a5a85e526 Mon Sep 17 00:00:00 2001 From: Ulrich Sibiller Date: Mon, 17 Dec 2018 22:36:34 +0100 Subject: manpage: add -name (partially) fixes ArcticaProject/nx-libs#666 --- nx-X11/programs/Xserver/hw/nxagent/man/nxagent.1 | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/nx-X11/programs/Xserver/hw/nxagent/man/nxagent.1 b/nx-X11/programs/Xserver/hw/nxagent/man/nxagent.1 index 8ef1d639b..2bd74c86e 100644 --- a/nx-X11/programs/Xserver/hw/nxagent/man/nxagent.1 +++ b/nx-X11/programs/Xserver/hw/nxagent/man/nxagent.1 @@ -325,6 +325,11 @@ sets the maximum big request to .I size MB. .TP 8 +.B \-name string +This option specifies the name of the top-level \fBnxagent\fR window as +.IR string . +The default value is the program name. +.TP 8 .B \-nolisten \fItrans-type\fP disables a transport type. For example, TCP/IP connections can be disabled with -- cgit v1.2.3 From c8947d8aadd62c51ab7da272445d9fad4b6dd84f Mon Sep 17 00:00:00 2001 From: Ulrich Sibiller Date: Mon, 17 Dec 2018 22:36:44 +0100 Subject: manpage: reformat some lines --- nx-X11/programs/Xserver/hw/nxagent/man/nxagent.1 | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/nx-X11/programs/Xserver/hw/nxagent/man/nxagent.1 b/nx-X11/programs/Xserver/hw/nxagent/man/nxagent.1 index 2bd74c86e..3b616272a 100644 --- a/nx-X11/programs/Xserver/hw/nxagent/man/nxagent.1 +++ b/nx-X11/programs/Xserver/hw/nxagent/man/nxagent.1 @@ -249,8 +249,8 @@ chooses a dynamic class, colors in the default color map will be available to individual clients for allocation. .TP 8 .B \-deferglyphs \fIwhichfonts\fP -specifies the types of fonts for which the server should attempt to use -deferred glyph loading. \fIwhichfonts\fP can be all (all fonts), +specifies the types of fonts for which the server should attempt to +use deferred glyph loading. \fIwhichfonts\fP can be all (all fonts), none (no fonts), or 16 (16 bit fonts only). .TP 8 .B \-depth \fIint\fP @@ -489,8 +489,8 @@ been started before the reconnect still use the old DPI. This may lead to applications looking "weird". .TP 8 .B \-nomagicpixel -disable magic pixel support at session startup, can be re-enabled via nx/nx option on session -resumption +disable magic pixel support at session startup, can be re-enabled via +nx/nx option on session resumption .TP 8 .B \-norender disable the use of the render extension -- cgit v1.2.3