XQuartz: Updated man page
(cherry picked from commit6932d0d19e
) (cherry picked from commit8e3da36b6b
)
This commit is contained in:
parent
7430bb9093
commit
700e8bf33f
|
@ -1,6 +1,6 @@
|
||||||
.TH XQUARTZ 1 __vendorversion__
|
.TH XQUARTZ 1 __vendorversion__
|
||||||
.SH NAME
|
.SH NAME
|
||||||
Xquartz \- X window system server for Quartz operating system
|
Xquartz \- X window system server for Mac OSX
|
||||||
.SH SYNOPSIS
|
.SH SYNOPSIS
|
||||||
.B Xquartz
|
.B Xquartz
|
||||||
[ options ] ...
|
[ options ] ...
|
||||||
|
@ -13,72 +13,24 @@ window system and Mac OS X share your display. The root window of the
|
||||||
X11 display is the size of the screen and contains all the other
|
X11 display is the size of the screen and contains all the other
|
||||||
windows. The X11 root window is not displayed in rootless mode as Mac
|
windows. The X11 root window is not displayed in rootless mode as Mac
|
||||||
OS X handles the desktop background.
|
OS X handles the desktop background.
|
||||||
.SH OPTIONS
|
.SH CUSTOMIZATION
|
||||||
.PP
|
\fIXquartz\fP can be customized using the defaults(1) command. The available options are:
|
||||||
In addition to the normal server options described in the \fIXserver(1)\fP
|
|
||||||
manual page, \fIXquartz\fP accepts the following command line switches:
|
|
||||||
.TP 8
|
.TP 8
|
||||||
.B \-fakebuttons
|
.B defaults write org.x.X11 enable_fake_buttons -boolean true
|
||||||
Emulates a 3 button mouse using modifier keys. By default, the Command modifier
|
Emulates a 3 button mouse using modifier keys. By default, the Command modifier
|
||||||
is used to emulate button 2 and Option is used for button 3. Thus, clicking the
|
is used to emulate button 2 and Option is used for button 3. Thus, clicking the
|
||||||
first mouse button while holding down Command will act like clicking
|
first mouse button while holding down Command will act like clicking
|
||||||
button 2. Holding down Option will simulate button 3.
|
button 2. Holding down Option will simulate button 3.
|
||||||
.TP 8
|
.TP 8
|
||||||
.B \-nofakebuttons
|
.B defaults write org.x.X11 fake_button2 \fImodifiers\fP
|
||||||
Do not emulate a 3 button mouse. This is the default.
|
|
||||||
.TP 8
|
|
||||||
.B "\-fakemouse2 \fImodifiers\fP"
|
|
||||||
Change the modifier keys used to emulate the second mouse button. By default,
|
Change the modifier keys used to emulate the second mouse button. By default,
|
||||||
Command is used to emulate the second button. Any combination of the following
|
Command is used to emulate the second button. Any combination of the following
|
||||||
modifier names may be used: Shift, Option, Control, Command, Fn. For example,
|
modifier names may be used: {l,r,}shift, {l,r,}option, {l,r,}control, {l,r,}command, fn
|
||||||
.B \-fakemouse2 """Option,Shift""
|
|
||||||
will set holding Option, Shift and clicking on button one as equivalent to
|
|
||||||
clicking the second mouse button.
|
|
||||||
.TP 8
|
|
||||||
.B "\-fakemouse3 \fImodifiers\fP"
|
|
||||||
Change the modifier keys used to emulate the third mouse button. By default,
|
|
||||||
Option is used to emulate the third button. Any combination of the following
|
|
||||||
modifier names may be used: Shift, Option, Control, Command, Fn. For example,
|
|
||||||
.B \-fakemouse3 """Control,Shift""
|
|
||||||
will set holding Control, Shift and clicking on button one as equivalent to
|
|
||||||
clicking the third mouse button.
|
|
||||||
.TP 8
|
|
||||||
.B "\-swapAltMeta"
|
|
||||||
Swaps the meaning of the Alt and Meta modifier keys.
|
|
||||||
.TP 8
|
|
||||||
.B "\-keymap \fIfile\fP"
|
|
||||||
On startup \fIXquartz\fP translates a Darwin keymapping into an X keymap.
|
|
||||||
The default is to read this keymapping from USA.keymapping. With this option
|
|
||||||
the keymapping will be read from \fIfile\fP instead. If the file's path is
|
|
||||||
not specified, it will be searched for in Library/Keyboards/ underneath the
|
|
||||||
following directories (in order): ~, /, /Network, /System.
|
|
||||||
.TP 8
|
|
||||||
.B \-nokeymap
|
|
||||||
On startup \fIXquartz\fP translates a Darwin keymapping into an X keymap.
|
|
||||||
With this option \fIXquartz\fP queries the kernel for the current keymapping
|
|
||||||
instead of reading it from a file. This will often fail on newer kernels.
|
|
||||||
.TP 8
|
|
||||||
.B "\-depth \fIdepth\fP"
|
|
||||||
Specifies the color bit depth to use. Currently only 15, and 24 color
|
|
||||||
bits per pixel are supported. If not specified, defaults to the depth
|
|
||||||
of the main display.
|
|
||||||
.SH CUSTOMIZATION
|
|
||||||
\fIXquartz\fP can also be customized using the defaults(1) command. The available options are:
|
|
||||||
.TP 8
|
|
||||||
.B defaults write org.x.X11 enable_fake_buttons -boolean true
|
|
||||||
Equivalent to the \fB-fakebuttons\fP command line option.
|
|
||||||
.TP 8
|
|
||||||
.B defaults write org.x.X11 fake_button2 \fImodifiers\fP
|
|
||||||
Equivalent to the \fB-fakemouse2\fP option.
|
|
||||||
.TP 8
|
.TP 8
|
||||||
.B defaults write org.x.X11 fake_button3 \fImodifiers\fP
|
.B defaults write org.x.X11 fake_button3 \fImodifiers\fP
|
||||||
Equivalent to the \fB-fakemouse3\fP option.
|
Change the modifier keys used to emulate the second mouse button. By default,
|
||||||
.TP 8
|
Command is used to emulate the second button. Any combination of the following
|
||||||
.B defaults write org.x.X11 swap_alt_meta -boolean true
|
modifier names may be used: {l,r,}shift, {l,r,}option, {l,r,}control, {l,r,}command, fn
|
||||||
Equivalent to the \fB-swapAltMeta\fP option.
|
|
||||||
.TP 8
|
|
||||||
.B defaults write org.x.X11 keymap_file \fIfilename\fP
|
|
||||||
Equivalent to the \fB-keymap\fP option.
|
|
||||||
.TP 8
|
.TP 8
|
||||||
.B defaults write org.x.X11 no_quit_alert -boolean true
|
.B defaults write org.x.X11 no_quit_alert -boolean true
|
||||||
Disables the alert dialog displayed when attempting to quit X11.
|
Disables the alert dialog displayed when attempting to quit X11.
|
||||||
|
@ -87,14 +39,9 @@ Disables the alert dialog displayed when attempting to quit X11.
|
||||||
Stops the X server requiring that clients authenticate themselves when
|
Stops the X server requiring that clients authenticate themselves when
|
||||||
connecting. See Xsecurity(__miscmansuffix__).
|
connecting. See Xsecurity(__miscmansuffix__).
|
||||||
.TP 8
|
.TP 8
|
||||||
.B defaults write org.x.X11 nolisten_tcp -boolean true
|
.B defaults write org.x.X11 nolisten_tcp -boolean false
|
||||||
Prevents the X server accepting remote connections.
|
This will tell the server to listen and accept TCP connections. Doing this without enabling
|
||||||
.TP 8
|
xauth is a possible security concern. See Xsecurity(__miscmansuffix__).
|
||||||
.B defaults write org.x.X11 xinit_kills_server -boolean false
|
|
||||||
Stops the X server exiting when the xinitrc script terminates.
|
|
||||||
.TP 8
|
|
||||||
.B defaults write org.x.X11 fullscreen_hotkeys -boolean false
|
|
||||||
Allows system hotkeys to be handled while in X11 fullscreen mode.
|
|
||||||
.TP 8
|
.TP 8
|
||||||
.B defaults write org.x.X11 enable_system_beep -boolean false
|
.B defaults write org.x.X11 enable_system_beep -boolean false
|
||||||
Don't use the standard system beep effect for X11 alerts.
|
Don't use the standard system beep effect for X11 alerts.
|
||||||
|
@ -103,13 +50,39 @@ Don't use the standard system beep effect for X11 alerts.
|
||||||
Disable menu keyboard equivalents while X11 windows are focused.
|
Disable menu keyboard equivalents while X11 windows are focused.
|
||||||
.TP 8
|
.TP 8
|
||||||
.B defaults write org.x.X11 depth \fIdepth\fP
|
.B defaults write org.x.X11 depth \fIdepth\fP
|
||||||
Equivalent to the \fB-depth\fP option.
|
Specifies the color bit depth to use. Currently only 15, and 24 color
|
||||||
|
bits per pixel are supported. If not specified, or a value of -1 is specified,
|
||||||
|
defaults to the depth of the main display.
|
||||||
|
.TP 8
|
||||||
|
.B defaults write org.x.X11 sync_keymap -boolean true
|
||||||
|
Keep the X11 keymap up to date with the OSX system keymap.
|
||||||
|
.SH OPTIONS
|
||||||
|
.PP
|
||||||
|
In addition to the normal server options described in the \fIXserver(1)\fP
|
||||||
|
manual page, \fIXquartz\fP accepts the following command line switches:
|
||||||
|
.TP 8
|
||||||
|
.B \-fakebuttons
|
||||||
|
Same as enable_fake_buttons above with value true.
|
||||||
|
.TP 8
|
||||||
|
.B \-nofakebuttons
|
||||||
|
Same as enable_fake_buttons above with value false.
|
||||||
|
.TP 8
|
||||||
|
.B "\-fakemouse2 \fImodifiers\fP"
|
||||||
|
Same as fake_button2 above.
|
||||||
|
.TP 8
|
||||||
|
.B "\-fakemouse3 \fImodifiers\fP"
|
||||||
|
Same as fake_button3 above.
|
||||||
|
.TP 8
|
||||||
|
.B "\-depth \fIdepth\fP"
|
||||||
|
Same as depth above.
|
||||||
.SH "SEE ALSO"
|
.SH "SEE ALSO"
|
||||||
.PP
|
.PP
|
||||||
X(__miscmansuffix__), Xserver(1), xdm(1), xinit(1)
|
X(__miscmansuffix__), Xserver(1), xdm(1), xinit(1)
|
||||||
.PP
|
.PP
|
||||||
.SH AUTHORS
|
http://xquartz.macosforge.org
|
||||||
XFree86 was originally ported to Mac OS X Server by John Carmack. Dave
|
.PP
|
||||||
|
.SH AUTHORS / HISTORY
|
||||||
|
X11 was originally ported to Mac OS X Server by John Carmack. Dave
|
||||||
Zarzycki used this as the basis of his port of XFree86 4.0 to Darwin 1.0.
|
Zarzycki used this as the basis of his port of XFree86 4.0 to Darwin 1.0.
|
||||||
Torrey T. Lyons improved and integrated this code into the XFree86
|
Torrey T. Lyons improved and integrated this code into the XFree86
|
||||||
Project's mainline for the 4.0.2 release.
|
Project's mainline for the 4.0.2 release.
|
||||||
|
@ -154,3 +127,9 @@ Greg Parker - Rootless support
|
||||||
Toshimitsu Tanaka - Japanese localization
|
Toshimitsu Tanaka - Japanese localization
|
||||||
.br
|
.br
|
||||||
Olivier Verdier - French localization
|
Olivier Verdier - French localization
|
||||||
|
.PP
|
||||||
|
Code from Apple's X11.app (which was based on XFree86 4.1) was integrated into X.org's XDarwin DDX by Ben Byer for xorg-server-1.2.
|
||||||
|
The XDarwin DDX was renamed Xquartz to more accurately reflect its state (the pure-darwin backend was removed).
|
||||||
|
Jeremy Huddleston took over as project lead and brought the project up to the X.org 1.4 server branch.
|
||||||
|
.PP
|
||||||
|
Jeremy Huddleston <jeremyhu@apple.com> is the current maintainer.
|
||||||
|
|
Loading…
Reference in New Issue
Block a user