159 lines
5.8 KiB
Groff
159 lines
5.8 KiB
Groff
.\" $XFree86: xc/programs/Xserver/hw/darwin/XDarwin.man,v 1.4 2002/01/09 18:01:58 torrey Exp $
|
|
.\"
|
|
.TH XQUARTZ 1 __vendorversion__
|
|
.SH NAME
|
|
Xquartz \- X window system server for Quartz operating system
|
|
.SH SYNOPSIS
|
|
.B Xquartz
|
|
[ options ] ...
|
|
.SH DESCRIPTION
|
|
.I Xquartz
|
|
is the X window server for Mac OS X provided by Apple.
|
|
.I Xquartz
|
|
runs in parallel with Aqua in rootless mode. In rootless mode, the X
|
|
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:
|
|
.TP 8
|
|
.B \-fakebuttons
|
|
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"
|
|
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 com.apple.x11 enable_fake_buttons -boolean true
|
|
Equivalent to the \fB-fakebuttons\fP command line option.
|
|
.TP 8
|
|
.B defaults write com.apple.x11 fake_button2 \fImodifiers\fP
|
|
Equivalent to the \fB-fakemouse2\fP option.
|
|
.TP 8
|
|
.B defaults write com.apple.x11 fake_button3 \fImodifiers\fP
|
|
Equivalent to the \fB-fakemouse3\fP option.
|
|
.TP 8
|
|
.B defaults write com.apple.x11 swap_alt_meta -boolean true
|
|
Equivalent to the \fB-swapAltMeta\fP option.
|
|
.TP 8
|
|
.B defaults write com.apple.x11 keymap_file \fIfilename\fP
|
|
Equivalent to the \fB-keymap\fP option.
|
|
.TP 8
|
|
.B defaults write com.apple.x11 no_quit_alert -boolean true
|
|
Disables the alert dialog displayed when attempting to quit X11.
|
|
.TP 8
|
|
.B defaults write com.apple.x11 no_auth -boolean true
|
|
Stops the X server requiring that clients authenticate themselves when
|
|
connecting. See Xsecurity(__miscmansuffix__).
|
|
.TP 8
|
|
.B defaults write com.apple.x11 nolisten_tcp -boolean true
|
|
Prevents the X server accepting remote connections.
|
|
.TP 8
|
|
.B defaults write com.apple.x11 xinit_kills_server -boolean false
|
|
Stops the X server exiting when the xinitrc script terminates.
|
|
.TP 8
|
|
.B defaults write com.apple.x11 fullscreen_hotkeys -boolean false
|
|
Allows system hotkeys to be handled while in X11 fullscreen mode.
|
|
.TP 8
|
|
.B defaults write com.apple.x11 enable_system_beep -boolean false
|
|
Don't use the standard system beep effect for X11 alerts.
|
|
.TP 8
|
|
.B defaults write com.apple.x11 enable_key_equivalents -boolean false
|
|
Disable menu keyboard equivalents while X11 windows are focused.
|
|
.TP 8
|
|
.B defaults write com.apple.x11 depth \fIdepth\fP
|
|
Equivalent to the \fB-depth\fP option.
|
|
.SH "SEE ALSO"
|
|
.PP
|
|
X(__miscmansuffix__), XFree86(1), Xserver(1), xdm(1), xinit(1)
|
|
.PP
|
|
.SH AUTHORS
|
|
XFree86 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.
|
|
.PP
|
|
The following members of the XonX Team contributed to the following
|
|
releases (in alphabetical order):
|
|
.TP 4
|
|
XFree86 4.1.0:
|
|
.br
|
|
Rob Braun - Darwin x86 support
|
|
.br
|
|
Torrey T. Lyons - Project Lead
|
|
.br
|
|
Andreas Monitzer - Cocoa version of XDarwin front end
|
|
.br
|
|
Gregory Robert Parker - Original Quartz implementation
|
|
.br
|
|
Christoph Pfisterer - Dynamic shared X libraries
|
|
.br
|
|
Toshimitsu Tanaka - Japanese localization
|
|
.TP 4
|
|
XFree86 4.2.0:
|
|
.br
|
|
Rob Braun - Darwin x86 support
|
|
.br
|
|
Pablo Di Noto - Spanish localization
|
|
.br
|
|
Paul Edens - Dutch localization
|
|
.br
|
|
Kyunghwan Kim - Korean localization
|
|
.br
|
|
Mario Klebsch - Non-US keyboard support
|
|
.br
|
|
Torrey T. Lyons - Project Lead
|
|
.br
|
|
Andreas Monitzer - German localization
|
|
.br
|
|
Patrik Montgomery - Swedish localization
|
|
.br
|
|
Greg Parker - Rootless support
|
|
.br
|
|
Toshimitsu Tanaka - Japanese localization
|
|
.br
|
|
Olivier Verdier - French localization
|