xwin/man/XWin.man

3 XWin \- X Server for the Cygwin environment on Microsoft Windows
20 appears as a single \fIWindows\fP window and all X windows are contained
25 * \fIMulti-Window\fP: In this mode \fIXWin\fP uses its own integrated
26 window manager in order to handle the top-level X windows, in such a
29 * \fIRootless\fP: In this mode the X server works in a window
31 pattern) is hidden from view, so only top-level X windows are seen.
40 .TP 8
43 Each X screen appears as a single \fIWindows\fP window and all X windows are
45 .TP 8
46 .B \-multiwindow
47 Each top-level X window appears in its own \fIWindows\fP window.
48 Also start the integrated \fIWindows\fP-based window manager.
49 .TP 8
50 .B \-rootless
52 The X server works on a window covering the whole screen but the root window
54 .TP 8
55 .B \-mwextwm
57 The mode combines \fB\-rootless\fP mode drawing with native \fIWindows\fP
60 \fBNOTE:\fP \fI-multiwindow\fP mode uses its own internal window manager.
66 The default behaviour is to create a single screen 0 that is roughly the
68 decorations and the task-bar).
70 Screen specific parameters can be applied as a
72 before any \fB\-screen\fP parameter.  Screen specific parameters placed after
73 the first \fB\-screen\fP parameter will apply only to the immediately
74 preceeding \fB\-screen\fP parameter.
75 .TP 8
76 .B \-[no]multimonitors or \-[no]multiplemonitors
77 Create a screen 0 that covers all monitors [the primary monitor] on a system with
80 (This is similar to the 'merged framebuffer' or 'pseudo-xinerama' mode provided by
82 This option is currently enabled by default in \fB\-multiwindow\fP mode.
83 .TP 8
84 .B "\-screen \fIscreen_number\fP [\fIW\fP \fIH\fP [\fIX\fP \fIY\fP] | [[\fIW\fPx\fIH\fP[+\fIX\fP+\f…
92 Additionally a
101 .I "  -screen 0 @1 ; on 1st monitor using its full resolution (the default)"
103 .I "  -screen 0 800x600+100+100@2 ; on 2nd monitor offset 100,100 size 800x600"
105 .I "  -screen 0 1024x768@3        ; on 3rd monitor size 1024x768"
109 in \fB-multiwindow\fP or \fB-rootless\fP mode.
110 .TP 8
111 .B "\-fullscreen"
114 Currently \fB\-fullscreen\fP may only be applied to one X screen.
115 .TP 8
116 .B \-nodecoration
117 Do not give the Cygwin/X window a \fIWindows\fP window border, title bar,
119 This parameter is ignored when the \fB\-fullscreen\fP parameter is specified.
120 .TP 8
121 .B \-scrollbars
122 Alternative name for \fB\-resize=scrollbars\fP.
125 .TP 8
126 .B \-resize[=none|scrollbars|randr]
128 The default is \fBnone\fP if \fB\-fullscreen\fP is used, \fBrandr\fP otherwise.
131 .IP \fB\-resize=none\fP 8
134 In windowed mode, if the window has decorations, a fixed frame is used.
136 Alternative name is \fB\-noresize\fP.
138 .IP \fB\-resize=scrollbars\fP 8
141 In windowed mode, if the window has decorations, a resizing frame is used.
147 This parameter is ignored in \fB-multiwindow\fP or \fB-rootless\fP mode.
148 Alternative name is \fB\-scrollbars\fP.
150 .IP \fB\-resize=randr\fP 8
153 In windowed mode, if the window has decorations, a resizing frame is used.
160 In \fB-multiwindow\fP or \fB-rootless\fP mode, if the X screen is
161 of the same dimensions as a Windows monitor or the virtual desktop,
168 .IP \fB\-resize\fP 8
169 on its own is equivalent to \fB\-resize=randr\fP
173 .TP 8
174 .B \-[no]hostintitle
180 .TP 8
181 .B \-[no]clipboard
184 .TP 8
185 .B "\-emulate3buttons [\fItimeout\fP]"
186 Emulate a three button mouse; pressing both buttons within
192 a two button mouse without scroll wheel.  Default is to enable this
193 option if  \fIWindows\fP reports a two button mouse, disabled otherwise.
194 .TP 8
195 .B \-[no]keyhook
196 Enable [disable] a low-level keyboard hook for catching
199 .TP 8
200 .B \-lesspointer
206 This parameter has no effect unless \fB-swcursor\fP is also specified.
207 .TP 8
208 .B \-[no]primary
211 .TP 8
212 .B \-swcursor
214 .TP 8
215 .B \-[no]trayicon
216 Do not create a tray icon.  Default is to create one
218 \fB\-notrayicon\fP, then enable it for specific screens with
219 \fB\-trayicon\fP for those screens.
220 .TP 8
221 .B \-nounicodeclipboard
222 Do not use Unicode clipboard even if on a NT-based platform.
223 .TP 8
224 .B \-[no]unixkill
225 Enable or disable the \fICtrl-Alt-Backspace\fP key combination as a
226 signal to exit the X Server.  The \fICtrl-Alt-Backspace\fP key combination
228 .TP 8
229 .B \-[no]wgl
232 .TP 8
233 .B \-[no]winkill
234 Enable or disable the \fIAlt-F4\fP key combination as a signal to exit the
236 The \fIAlt-F4\fP key combination is enabled by default.
239 .TP 8
240 .B "\-clipupdates \fInum_boxes\fP"
241 Specify an optional threshold, above which the regions in a shadow
242 update operation will be collected into a GDI clipping region.  The
243 clipping region is then used to do a single bit block transfer that is
246 the clipping region, thus there may not be much benefit for a small
248 functionality does not provide a benefit at any number of boxes; we
252 .TP 8
253 .B "\-engine \fIengine_type_id\fP"
267 Shadow DirectDraw Non-Locking
271 .TP 8
272 .B "\-depth \fIdepth\fP"
274 fullscreen with a DirectDraw engine.  This parameter is ignored if
275 \fB\-fullscreen\fP is not specified.
276 .TP 8
277 .B "\-refresh \fIrate_in_Hz\fP"
279 fullscreen with a DirectDraw engine.  This parameter is ignored if
280 \fB\-fullscreen\fP is not specified.
286 .TP 8
287 .B \-help
288 Write a help text listing supported command line options and their description to the console.
289 .TP 8
290 .B \-ignoreinput
293 .TP 8
294 .B "\-logfile \fIfilename\fP"
298 .TP 8
299 .B "\-logverbose \fIlevel\fP"
307 values will yield a still more detailed debug output.
308 .TP 8
309 .B "\-xkblayout \fIlayout\fP"
310 .TP 8
311 .B "\-xkbmodel \fImodel\fP"
312 .TP 8
313 .B "\-xkboptions \fIoption\fP"
314 .TP 8
315 .B "\-xkbrules \fIrule\fP"
316 .TP 8
317 .B "\-xkbvariant \fIvariant\fp"
319 a particular keyboard map as the X server starts.  The behavior is similar
322 See the \fIxkeyboard-config\fP(@miscmansuffix@) manual page for a list of
328 For example, in order to load a German layout for a pc105 keyboard, use the options:
330 .I " \-xkblayout de \-xkbmodel pc105"
335 The default is to select a keyboard configuration matching your current layout as
342 .TP 8
343 .B \-emulatepseudo
344 Create a depth 8 PseudoColor visual when running in depths 15, 16, 24,
348 This option is intended to allow applications which only work with a depth 8
354 from which it was called and to a log file that by default is located at \fI
366 modes that have a tray icon.
369 window that \fIXWin -multiwindow\fP produces for each top-level X
373 \fIXWin -multiwindow\fP produces for each top-level X-window.
376 \fXWin I-multiwindow\fP produces for each top-level X window.
386 setxkbmap(1), xkeyboard-config(@miscmansuffix@).
395 look also at the output of \fIXWin -help\fP in order to
405 Habacker, Colin Harrison, Matthieu Herrb, Alan Hourihane, Pierre A