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__
|
||||
.SH NAME
|
||||
Xquartz \- X window system server for Quartz operating system
|
||||
Xquartz \- X window system server for Mac OSX
|
||||
.SH SYNOPSIS
|
||||
.B Xquartz
|
||||
[ options ] ...
|
||||
|
@ -13,88 +13,35 @@ 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
|
||||
windows. The X11 root window is not displayed in rootless mode as Mac
|
||||
OS X handles the desktop background.
|
||||
.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:
|
||||
.SH CUSTOMIZATION
|
||||
\fIXquartz\fP can be customized using the defaults(1) command. The available options are:
|
||||
.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
|
||||
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
|
||||
button 2. Holding down Option will simulate button 3.
|
||||
.TP 8
|
||||
.B \-nofakebuttons
|
||||
Do not emulate a 3 button mouse. This is the default.
|
||||
.TP 8
|
||||
.B "\-fakemouse2 \fImodifiers\fP"
|
||||
.B defaults write org.x.X11 fake_button2 \fImodifiers\fP
|
||||
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
|
||||
modifier names may be used: Shift, Option, Control, Command, Fn. For example,
|
||||
.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.
|
||||
modifier names may be used: {l,r,}shift, {l,r,}option, {l,r,}control, {l,r,}command, fn
|
||||
.TP 8
|
||||
.B defaults write org.x.X11 fake_button3 \fImodifiers\fP
|
||||
Equivalent to the \fB-fakemouse3\fP option.
|
||||
.TP 8
|
||||
.B defaults write org.x.X11 swap_alt_meta -boolean true
|
||||
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.
|
||||
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
|
||||
modifier names may be used: {l,r,}shift, {l,r,}option, {l,r,}control, {l,r,}command, fn
|
||||
.TP 8
|
||||
.B defaults write org.x.X11 no_quit_alert -boolean true
|
||||
Disables the alert dialog displayed when attempting to quit X11.
|
||||
.TP 8
|
||||
.B defaults write org.x.X11 no_auth -boolean true
|
||||
Stops the X server requiring that clients authenticate themselves when
|
||||
connecting. See Xsecurity(__miscmansuffix__).
|
||||
connecting. See Xsecurity(__miscmansuffix__).
|
||||
.TP 8
|
||||
.B defaults write org.x.X11 nolisten_tcp -boolean true
|
||||
Prevents the X server accepting remote connections.
|
||||
.TP 8
|
||||
.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.
|
||||
.B defaults write org.x.X11 nolisten_tcp -boolean false
|
||||
This will tell the server to listen and accept TCP connections. Doing this without enabling
|
||||
xauth is a possible security concern. See Xsecurity(__miscmansuffix__).
|
||||
.TP 8
|
||||
.B defaults write org.x.X11 enable_system_beep -boolean false
|
||||
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.
|
||||
.TP 8
|
||||
.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"
|
||||
.PP
|
||||
X(__miscmansuffix__), Xserver(1), xdm(1), xinit(1)
|
||||
.PP
|
||||
.SH AUTHORS
|
||||
XFree86 was originally ported to Mac OS X Server by John Carmack. Dave
|
||||
http://xquartz.macosforge.org
|
||||
.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.
|
||||
Torrey T. Lyons improved and integrated this code into the XFree86
|
||||
Project's mainline for the 4.0.2 release.
|
||||
|
@ -154,3 +127,9 @@ Greg Parker - Rootless support
|
|||
Toshimitsu Tanaka - Japanese localization
|
||||
.br
|
||||
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