← Back to branch summary

~ubuntu-branches/ubuntu/precise/xorg-server/precise

« back to all changes in this revision

Viewing changes to hw/xquartz/doc/Xquartz.man.pre

  • Committer: Bazaar Package Importer
  • Author(s): Christopher James Halse Rogers
  • Date: 2011-01-31 19:45:19 UTC
  • mfrom: (1.1.38 upstream) (0.1.19 experimental)
  • Revision ID: james.westby@ubuntu.com-20110131194519-fx30d1zsg83invba
Tags: 2:1.9.99.901+git20110131.be3be758-0ubuntu1
https://launchpad.net/bugs/406226
https://launchpad.net/bugs/247537
https://launchpad.net/bugs/500102
https://launchpad.net/bugs/614993
https://launchpad.net/bugs/371405
https://launchpad.net/bugs/459512
https://launchpad.net/bugs/633593
* Merge from (unreleased) debian-experimental.  Remaining Ubuntu changes:
  - rules:
    + Disable SELinux, libaudit-dev is not in main yet. (LP: #406226)
    + Enable xcsecurity. (LP: #247537)
    + Add --with-extra-module-dir to support GL alternatives.
  - control: 
    + Xvfb depends on xauth, x11-xkb-utils. (LP: #500102)
    + Add breaks for incompatible drivers. (LP: #614993)
    + Drop libaudit-dev from build-deps.
  - local/xvfb-run*: Add correct docs about error codes. (LP #328205)
  - debian/patches:
    + 100_rethrow_signals.patch:
      When aborting, re-raise signals for apport
    + 109_fix-swcursor-crash.patch:
      Avoid dereferencing null pointer while reloading cursors during
      resume. (LP: #371405)
    + 111_armel-drv-fallbacks.patch:
      Add support for armel driver fallbacks.
    + 121_only_switch_vt_when_active.diff:
      Add a check to prevent the X server from changing the VT when killing
      GDM from the console.
    + 122_xext_fix_card32_overflow_in_xauth.patch:
      Fix server crash when “xauth generate” is called with large timeout.
    + 157_check_null_modes.patch, 162_null_crtc_in_rotation.patch,
      166_nullptr_xinerama_keyrepeat.patch, 167_nullptr_xisbread.patch
      169_mipointer_nullptr_checks.patch,
      172_cwgetbackingpicture_nullptr_check.patch:
      Fix various segfaults in xserver by checking pointers for NULL
      values before dereferencing them.
    + 165_man_xorg_conf_no_device_ident.patch
      Correct man page
    + 168_glibc_trace_to_stderr.patch:
      Report abort traces to stderr instead of terminal
    + 184_virtual_devices_autodetect.patch:
      Use vesa for qemu device, which is not supported by cirrus
    + 188_default_primary_to_first_busid.patch:
      Pick the first device and carry on (LP: #459512)
    + 190_cache-xkbcomp_output_for_fast_start_up.patch:
    + 191-Xorg-add-an-extra-module-path.patch:
      Add support for the alternatives module path.
    + 198_nohwaccess.patch:
      Adds a -nohwaccess argument to make X not access the hardware
      ports directly.
    + 200_randr-null.patch:
      Clarify a pointer initialization.
    + 206_intel_8xx_default_to_fbdev.patch:
      Makes 8xx class intel GPUs default to fbdev for stability. (LP: #633593)
* Refresh 121_only_switch_vt_when_active.diff for new upstream.
* Drop 187_edid_quirk_hp_nc8430.patch; upstream.
* Drop 189_xserver_1.5.0_bg_none_root.patch; functionality now upstream.
* Refresh 190_cache-xkbcomp_output_for_fast_start_up.patch for new upstream.
* Drop 197_xvfb-randr.patch:
  - miRandR, which this used, has been removed from the server. 
* Drop 204_fix-neg-sync-transition.patch; upstream.
* Drop 207_dga_master_device.patch; upstream.
* Drop 208_switch_on_release.diff; upstream.
* debian/patches/209_add_legacy_bgnone_option.patch:
  - Add "-nr" as a synonym for "-background none" to ease the transition from
    the old 189_xserver_1.5.0_bg_none_root.patch patch.  Can be dropped once
    all the ?DM have been updated to use the new option.
* debian/control:
  - Add Breaks: to xserver-xorg-video-8 and current fglrx.  These proprietary
    drivers don't yet have appropriate dependency information, so manually
    handle them here to prevent broken upgrades.

Show diffs side-by-side

added added

removed removed

Lines of Context:
hw/xquartz/doc/Xquartz.man.pre
1
 
.TH XQUARTZ 1 __vendorversion__
2
 
.SH NAME
3
 
Xquartz \- X window system server for Mac OSX
4
 
.SH SYNOPSIS
5
 
.B Xquartz
6
 
[ options ] ...
7
 
.SH DESCRIPTION
8
 
.I Xquartz
9
 
is the X window server for Mac OS X provided by Apple.
10
 
.I Xquartz
11
 
runs in parallel with Aqua in rootless mode. In rootless mode, the X
12
 
window system and Mac OS X share your display.  The root window of the
13
 
X11 display is the size of the screen and contains all the other
14
 
windows. The X11 root window is not displayed in rootless mode as Mac
15
 
OS X handles the desktop background.
16
 
.SH CUSTOMIZATION
17
 
\fIXquartz\fP can be customized using the defaults(1) command. The available options are:
18
 
.TP 8
19
 
.B defaults write __laucnd_id_prefix__.X11 enable_fake_buttons -boolean true
20
 
Emulates a 3 button mouse using modifier keys. By default, the Command modifier
21
 
is used to emulate button 2 and Option is used for button 3. Thus, clicking the
22
 
first mouse button while holding down Command will act like clicking
23
 
button 2. Holding down Option will simulate button 3.
24
 
.TP 8
25
 
.B defaults write __laucnd_id_prefix__.X11 fake_button2 \fImodifiers\fP
26
 
Change the modifier keys used to emulate the second mouse button. By default,
27
 
Command is used to emulate the second button. Any combination of the following
28
 
modifier names may be used: {l,r,}shift, {l,r,}option, {l,r,}control, {l,r,}command, fn
29
 
.TP 8
30
 
.B defaults write __laucnd_id_prefix__.X11 fake_button3 \fImodifiers\fP
31
 
Change the modifier keys used to emulate the second mouse button. By default,
32
 
Command is used to emulate the second button. Any combination of the following
33
 
modifier names may be used: {l,r,}shift, {l,r,}option, {l,r,}control, {l,r,}command, fn
34
 
.TP 8
35
 
.B defaults write __laucnd_id_prefix__.X11 fullscreen_hotkeys -boolean true
36
 
Enable OSX hotkeys while in fullscreen
37
 
.TP 8
38
 
.B defaults write __laucnd_id_prefix__.X11 fullscreen_menu -boolean true
39
 
Show the OSX menu while in fullscreen
40
 
.TP 8
41
 
.B defaults write __laucnd_id_prefix__.X11 no_quit_alert -boolean true
42
 
Disables the alert dialog displayed when attempting to quit X11.
43
 
.TP 8
44
 
.B defaults write __laucnd_id_prefix__.X11 no_auth -boolean true
45
 
Stops the X server requiring that clients authenticate themselves when
46
 
connecting.  See Xsecurity(__miscmansuffix__).
47
 
.TP 8
48
 
.B defaults write __laucnd_id_prefix__.X11 nolisten_tcp -boolean false
49
 
This will tell the server to listen and accept TCP connections.  Doing this without enabling
50
 
xauth is a possible security concern.  See Xsecurity(__miscmansuffix__).
51
 
.TP 8
52
 
.B defaults write __laucnd_id_prefix__.X11 enable_system_beep -boolean false
53
 
Don't use the standard system beep effect for X11 alerts.
54
 
.TP 8
55
 
.B defaults write __laucnd_id_prefix__.X11 enable_key_equivalents -boolean false
56
 
Disable menu keyboard equivalents while X11 windows are focused.
57
 
.TP 8
58
 
.B defaults write __laucnd_id_prefix__.X11 depth \fIdepth\fP
59
 
Specifies the color bit depth to use. Currently only 15, and 24 color
60
 
bits per pixel are supported. If not specified, or a value of -1 is specified,
61
 
defaults to the depth of the main display.
62
 
.TP 8
63
 
.B defaults write __laucnd_id_prefix__.X11 sync_keymap -boolean true
64
 
Keep the X11 keymap up to date with the OSX system keymap.
65
 
.TP 8
66
 
.B defaults write __laucnd_id_prefix__.X11 option_sends_alt -boolean true
67
 
The Option key will send Alt_L and Alt_R instead of Mode_switch.
68
 
.TP 8
69
 
.B defaults write __laucnd_id_prefix__.X11 sync_pasteboard -boolean true
70
 
Enable syncing between the OSX pasteboard and clipboard/primary selection buffers in X11.  This option needs to be true for any of the other pasteboard sync options to have an effect.
71
 
.TP 8
72
 
.B defaults write __laucnd_id_prefix__.X11 sync_pasteboard_to_clipboard -boolean true
73
 
Update the X11 CLIPBOARD when the OSX NSPasteboard is updated.
74
 
.TP 8
75
 
.B defaults write __laucnd_id_prefix__.X11 sync_pasteboard_to_primary -boolean true
76
 
Update the the X11 PRIMARY buffer when the OSX NSPasteboard is updated.
77
 
.TP 8
78
 
.B defaults write __laucnd_id_prefix__.X11 sync_clipboard_to_pasteboard -boolean true
79
 
Update the the OSX NSPasteboard when the X11 CLIPBOARD is updated.  Note that enabling this option causes the clipboard synchronization to act as a clipboard manager in X11.  This makes it impossible to use xclipboard, klipper, or any other such clipboard managers.  If you want to use any of these programs, you must disable this option.
80
 
.TP 8
81
 
.B defaults write __laucnd_id_prefix__.X11 sync_primary_on_select -boolean true
82
 
This option defaults to false and is provided only "for experts."  It updates the NSPasteboard whenever a new X11 selection is made (rather than requiring you to hit cmd-c to copy the selection to the NSPasteboard).  Since the X11 protocol does not require applications to send notification when they change selection, this might not work in all cases (if you run into this problem, try selecting text in another application first, then selecting the text you want).
83
 
.TP 8
84
 
.B defaults write __laucnd_id_prefix__.X11 enable_test_extensions -boolean true
85
 
This option defaults to false and is only accessible through the command line.  Enable this option to turn on the DEC-XTRAP, RECORD, and XTEST extensions in the server.
86
 
.SH OPTIONS
87
 
.PP
88
 
In addition to the normal server options described in the \fIXserver(1)\fP
89
 
manual page, \fIXquartz\fP accepts the following command line switches:
90
 
.TP 8
91
 
.B \-fakebuttons
92
 
Same as enable_fake_buttons above with value true.
93
 
.TP 8
94
 
.B \-nofakebuttons
95
 
Same as enable_fake_buttons above with value false.
96
 
.TP 8
97
 
.B "\-fakemouse2 \fImodifiers\fP"
98
 
Same as fake_button2 above.
99
 
.TP 8
100
 
.B "\-fakemouse3 \fImodifiers\fP"
101
 
Same as fake_button3 above.
102
 
.TP 8
103
 
.B "\-depth \fIdepth\fP"
104
 
Same as depth above.
105
 
.SH "SEE ALSO"
106
 
.PP
107
 
X(__miscmansuffix__), Xserver(1), xdm(1), xinit(1)
108
 
.PP
109
 
http://xquartz.macosforge.org
110
 
.PP
111
 
.SH AUTHORS / HISTORY
112
 
X11 was originally ported to Mac OS X Server by John Carmack.  Dave
113
 
Zarzycki used this as the basis of his port of XFree86 4.0 to Darwin 1.0.
114
 
Torrey T. Lyons improved and integrated this code into the XFree86
115
 
Project's mainline for the 4.0.2 release.
116
 
.PP
117
 
The following members of the XonX Team contributed to the following
118
 
releases (in alphabetical order):
119
 
.TP 4
120
 
XFree86 4.1.0:
121
 
.br
122
 
Rob Braun - Darwin x86 support
123
 
.br
124
 
Torrey T. Lyons - Project Lead
125
 
.br
126
 
Andreas Monitzer - Cocoa version of XDarwin front end
127
 
.br
128
 
Gregory Robert Parker - Original Quartz implementation
129
 
.br
130
 
Christoph Pfisterer - Dynamic shared X libraries
131
 
.br
132
 
Toshimitsu Tanaka - Japanese localization
133
 
.TP 4
134
 
XFree86 4.2.0:
135
 
.br
136
 
Rob Braun - Darwin x86 support
137
 
.br
138
 
Pablo Di Noto - Spanish localization
139
 
.br
140
 
Paul Edens - Dutch localization
141
 
.br
142
 
Kyunghwan Kim - Korean localization
143
 
.br
144
 
Mario Klebsch - Non-US keyboard support
145
 
.br
146
 
Torrey T. Lyons - Project Lead
147
 
.br
148
 
Andreas Monitzer - German localization
149
 
.br
150
 
Patrik Montgomery - Swedish localization
151
 
.br
152
 
Greg Parker - Rootless support
153
 
.br
154
 
Toshimitsu Tanaka - Japanese localization
155
 
.br
156
 
Olivier Verdier - French localization
157
 
.PP
158
 
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.
159
 
The XDarwin DDX was renamed Xquartz to more accurately reflect its state (the pure-darwin backend was removed).
160
 
Jeremy Huddleston took over as project lead and brought the project up to the X.org 1.4 server branch.
161
 
.PP
162
 
Jeremy Huddleston <jeremyhu@apple.com> is the current maintainer.