synfig-osx/trunk/launcher/Xquartz.man

   1 .\" $XFree86: xc/programs/Xserver/hw/darwin/XDarwin.man,v 1.4 2002/01/09 18:01:58 torrey Exp $
   2 .\"
   3 .TH XQUARTZ 1 __vendorversion__
   4 .SH NAME
   5 Xquartz \- X window system server for Quartz operating system
   6 .SH SYNOPSIS
   7 .B Xquartz
   8 [ options ] ...
   9 .SH DESCRIPTION
  10 .I Xquartz
  11 is the X window server for Mac OS X provided by Apple.
  12 .I Xquartz
  13 runs in parallel with Aqua in rootless mode. In rootless mode, the X
  14 window system and Mac OS X share your display.  The root window of the
  15 X11 display is the size of the screen and contains all the other
  16 windows. The X11 root window is not displayed in rootless mode as Mac
  17 OS X handles the desktop background.
  18 .SH OPTIONS
  19 .PP
  20 In addition to the normal server options described in the \fIXserver(1)\fP
  21 manual page, \fIXquartz\fP accepts the following command line switches:
  22 .TP 8
  23 .B \-fakebuttons
  24 Emulates a 3 button mouse using modifier keys. By default, the Command modifier
  25 is used to emulate button 2 and Option is used for button 3. Thus, clicking the
  26 first mouse button while holding down Command will act like clicking
  27 button 2. Holding down Option will simulate button 3.
  28 .TP 8
  29 .B \-nofakebuttons
  30 Do not emulate a 3 button mouse. This is the default.
  31 .TP 8
  32 .B "\-fakemouse2 \fImodifiers\fP"
  33 Change the modifier keys used to emulate the second mouse button. By default,
  34 Command is used to emulate the second button. Any combination of the following
  35 modifier names may be used: Shift, Option, Control, Command, Fn. For example,
  36 .B \-fakemouse2 """Option,Shift""
  37 will set holding Option, Shift and clicking on button one as equivalent to
  38 clicking the second mouse button.
  39 .TP 8
  40 .B "\-fakemouse3 \fImodifiers\fP"
  41 Change the modifier keys used to emulate the third mouse button. By default,
  42 Option is used to emulate the third button. Any combination of the following
  43 modifier names may be used: Shift, Option, Control, Command, Fn. For example,
  44 .B \-fakemouse3 """Control,Shift""
  45 will set holding Control, Shift and clicking on button one as equivalent to
  46 clicking the third mouse button.
  47 .TP 8
  48 .B "\-swapAltMeta"
  49 Swaps the meaning of the Alt and Meta modifier keys.
  50 .TP 8
  51 .B "\-keymap \fIfile\fP"
  52 On startup \fIXquartz\fP translates a Darwin keymapping into an X keymap.
  53 The default is to read this keymapping from USA.keymapping. With this option
  54 the keymapping will be read from \fIfile\fP instead. If the file's path is
  55 not specified, it will be searched for in Library/Keyboards/ underneath the
  56 following directories (in order): ~, /, /Network, /System.
  57 .TP 8
  58 .B \-nokeymap
  59 On startup \fIXquartz\fP translates a Darwin keymapping into an X keymap.
  60 With this option \fIXquartz\fP queries the kernel for the current keymapping
  61 instead of reading it from a file. This will often fail on newer kernels.
  62 .TP 8
  63 .B "\-depth \fIdepth\fP"
  64 Specifies the color bit depth to use. Currently only 15, and 24 color
  65 bits per pixel are supported. If not specified, defaults to the depth
  66 of the main display.
  67 .SH CUSTOMIZATION
  68 \fIXquartz\fP can also be customized using the defaults(1) command. The available options are:
  69 .TP 8
  70 .B defaults write com.apple.x11 enable_fake_buttons -boolean true
  71 Equivalent to the \fB-fakebuttons\fP command line option.
  72 .TP 8
  73 .B defaults write com.apple.x11 fake_button2 \fImodifiers\fP
  74 Equivalent to the \fB-fakemouse2\fP option.
  75 .TP 8
  76 .B defaults write com.apple.x11 fake_button3 \fImodifiers\fP
  77 Equivalent to the \fB-fakemouse3\fP option.
  78 .TP 8
  79 .B defaults write com.apple.x11 swap_alt_meta -boolean true
  80 Equivalent to the \fB-swapAltMeta\fP option.
  81 .TP 8
  82 .B defaults write com.apple.x11 keymap_file \fIfilename\fP
  83 Equivalent to the \fB-keymap\fP option.
  84 .TP 8
  85 .B defaults write com.apple.x11 no_quit_alert -boolean true
  86 Disables the alert dialog displayed when attempting to quit X11.
  87 .TP 8
  88 .B defaults write com.apple.x11 no_auth -boolean true
  89 Stops the X server requiring that clients authenticate themselves when
  90 connecting. See Xsecurity(__miscmansuffix__).
  91 .TP 8
  92 .B defaults write com.apple.x11 nolisten_tcp -boolean true
  93 Prevents the X server accepting remote connections.
  94 .TP 8
  95 .B defaults write com.apple.x11 xinit_kills_server -boolean false
  96 Stops the X server exiting when the xinitrc script terminates.
  97 .TP 8
  98 .B defaults write com.apple.x11 fullscreen_hotkeys -boolean false
  99 Allows system hotkeys to be handled while in X11 fullscreen mode.
 100 .TP 8
 101 .B defaults write com.apple.x11 enable_system_beep -boolean false
 102 Don't use the standard system beep effect for X11 alerts.
 103 .TP 8
 104 .B defaults write com.apple.x11 enable_key_equivalents -boolean false
 105 Disable menu keyboard equivalents while X11 windows are focused.
 106 .TP 8
 107 .B defaults write com.apple.x11 depth \fIdepth\fP
 108 Equivalent to the \fB-depth\fP option.
 109 .SH "SEE ALSO"
 110 .PP
 111 X(__miscmansuffix__), XFree86(1), Xserver(1), xdm(1), xinit(1)
 112 .PP
 113 .SH AUTHORS
 114 XFree86 was originally ported to Mac OS X Server by John Carmack. Dave
 115 Zarzycki used this as the basis of his port of XFree86 4.0 to Darwin 1.0.
 116 Torrey T. Lyons improved and integrated this code into the XFree86
 117 Project's mainline for the 4.0.2 release.
 118 .PP
 119 The following members of the XonX Team contributed to the following
 120 releases (in alphabetical order):
 121 .TP 4
 122 XFree86 4.1.0:
 123 .br
 124 Rob Braun - Darwin x86 support
 125 .br
 126 Torrey T. Lyons - Project Lead
 127 .br
 128 Andreas Monitzer - Cocoa version of XDarwin front end
 129 .br
 130 Gregory Robert Parker - Original Quartz implementation
 131 .br
 132 Christoph Pfisterer - Dynamic shared X libraries
 133 .br
 134 Toshimitsu Tanaka - Japanese localization
 135 .TP 4
 136 XFree86 4.2.0:
 137 .br
 138 Rob Braun - Darwin x86 support
 139 .br
 140 Pablo Di Noto - Spanish localization
 141 .br
 142 Paul Edens - Dutch localization
 143 .br
 144 Kyunghwan Kim - Korean localization
 145 .br
 146 Mario Klebsch - Non-US keyboard support
 147 .br
 148 Torrey T. Lyons - Project Lead
 149 .br
 150 Andreas Monitzer - German localization
 151 .br
 152 Patrik Montgomery - Swedish localization
 153 .br
 154 Greg Parker - Rootless support
 155 .br
 156 Toshimitsu Tanaka - Japanese localization
 157 .br
 158 Olivier Verdier - French localization