Update of /cvsroot/fink/scripts/installer/dmg/doc/x11
In directory
sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv27660/scripts/installer/dmg/doc/x11
Modified Files:
x11.en.html
Log Message:
X11 update mk.2
Index: x11.en.html
===================================================================
RCS file: /cvsroot/fink/scripts/installer/dmg/doc/x11/x11.en.html,v
retrieving revision 1.19
retrieving revision 1.20
diff -u -d -r1.19 -r1.20
--- x11.en.html 8 Jun 2005 01:22:11 -0000 1.19
+++ x11.en.html 9 Jun 2005 01:44:40 -0000 1.20
@@ -21,7 +21,7 @@
describe the current situation and the many options you have to use
X11 with or without Fink.
</p>
- <h2>Contents</h2><ul><li><a href="#intro"><b>1
Introduction</b></a><ul><li><a href="#intro.def-x11">1.1 What is
X11?</a></li><li><a href="#intro.def-macosx">1.2 What is Mac OS
X?</a></li><li><a href="#intro.def-darwin">1.3 What is Darwin?</a></li><li><a
href="#intro.def-xfree86">1.4 What is XFree86?</a></li><li><a
href="#intro.def-xtools">1.5 What is Xtools?</a></li><li><a
href="#intro.client-server">1.6 Client and Server</a></li><li><a
href="#intro.rootless">1.7 What does rootless mean?</a></li><li><a
href="#intro.wm">1.8 What is a window manager?</a></li><li><a
href="#intro.desktop">1.9 What are Quartz/Aqua, Gnome, and
KDE?</a></li></ul></li><li><a href="#history"><b>2 History</b></a><ul><li><a
href="#history.early">2.1 The early days</a></li><li><a
href="#history.xonx-forms">2.2 XonX forms</a></li><li><a
href="#history.root-or-not">2.3 To root or not to root</a></li></ul></li><li><a
href="#inst-xfree86"><b>3 Getting and Installing X11</b></a><ul><li><a
href="#inst-xfree
86.fink">3.1 Installing X11 via Fink</a></li><li><a
href="#inst-xfree86.apple-binary">3.2 Apple's Binaries</a></li><li><a
href="#inst-xfree86.official-binary">3.3 The Official Binaries</a></li><li><a
href="#inst-xfree86.official-source">3.4 The Official Source</a></li><li><a
href="#inst-xfree86.latest-cvs">3.5 The Latest Development
Source</a></li><li><a href="#inst-xfree86.macgimp">3.6 MacGimp</a></li><li><a
href="#inst-xfree86.switching-x11">3.7 Replacing X11</a></li><li><a
href="#inst-xfree86.fink-summary">3.8 Fink package
summary</a></li></ul></li><li><a href="#run-xfree86"><b>4 Starting
X11</b></a><ul><li><a href="#run-xfree86.darwin">4.1 Darwin</a></li><li><a
href="#run-xfree86.macosx-41">4.2 Mac OS X + XFree86 4.x.y</a></li><li><a
href="#run-xfree86.starting-apples-x11">4.3 Starting Apple's X11</a></li><li><a
href="#run-xfree86.xinitrc">4.4 The .xinitrc File</a></li></ul></li><li><a
href="#xtools"><b>5 Xtools</b></a><ul><li><a href="#xtools.install">5.1
Installing Xto
ols</a></li><li><a href="#xtools.run">5.2 Running Xtools</a></li><li><a
href="#xtools.opengl">5.3 OpenGL Notes</a></li></ul></li><li><a
href="#other"><b>6 Other X11 Possibilities</b></a><ul><li><a
href="#other.vnc">6.1 VNC</a></li><li><a href="#other.wiredx">6.2
WiredX</a></li><li><a href="#other.exodus">6.3 eXodus</a></li></ul></li><li><a
href="#trouble"><b>7 Troubleshooting XFree86</b></a><ul><li><a
href="#trouble.immedate-quit">7.1 When I launch XDarwin, it quits
+ <h2>Contents</h2><ul><li><a href="#intro"><b>1
Introduction</b></a><ul><li><a href="#intro.def-x11">1.1 What is
X11?</a></li><li><a href="#intro.def-macosx">1.2 What is Mac OS
X?</a></li><li><a href="#intro.def-darwin">1.3 What is Darwin?</a></li><li><a
href="#intro.def-xfree86">1.4 What is XFree86?</a></li><li><a
href="#intro.def-xtools">1.5 What is Xtools?</a></li><li><a
href="#intro.client-server">1.6 Client and Server</a></li><li><a
href="#intro.rootless">1.7 What does rootless mean?</a></li><li><a
href="#intro.wm">1.8 What is a window manager?</a></li><li><a
href="#intro.desktop">1.9 What are Quartz/Aqua, Gnome, and
KDE?</a></li></ul></li><li><a href="#history"><b>2 History</b></a><ul><li><a
href="#history.early">2.1 The early days</a></li><li><a
href="#history.xonx-forms">2.2 XonX forms</a></li><li><a
href="#history.root-or-not">2.3 To root or not to root</a></li></ul></li><li><a
href="#inst-xfree86"><b>3 Getting and Installing X11</b></a><ul><li><a
href="#inst-xfree
86.fink">3.1 Installing X11 via Fink</a></li><li><a
href="#inst-xfree86.apple-binary">3.2 Apple's Binaries</a></li><li><a
href="#inst-xfree86.official-binary">3.3 The Official Binaries</a></li><li><a
href="#inst-xfree86.official-source">3.4 The Official Source</a></li><li><a
href="#inst-xfree86.latest-cvs">3.5 The Latest Development
Source</a></li><li><a href="#inst-xfree86.switching-x11">3.6 Replacing
X11</a></li><li><a href="#inst-xfree86.fink-summary">3.7 Fink package
summary</a></li></ul></li><li><a href="#run-xfree86"><b>4 Starting
X11</b></a><ul><li><a href="#run-xfree86.darwin">4.1 Darwin</a></li><li><a
href="#run-xfree86.macosx-41">4.2 Mac OS X + XFree86 4.x.y</a></li><li><a
href="#run-xfree86.starting-xorg">4.3 Starting X.org</a></li><li><a
href="#run-xfree86.starting-apples-x11">4.4 Starting Apple's X11</a></li><li><a
href="#run-xfree86.applex11tools">4.5 The applex11tools package</a></li><li><a
href="#run-xfree86.xinitrc">4.6 The .xinitrc File</a></li><li><a href=
"#run-xfree86.oroborosx">4.7 OroborOSX</a></li></ul></li><li><a
href="#xtools"><b>5 Xtools</b></a><ul><li><a href="#xtools.install">5.1
Installing Xtools</a></li><li><a href="#xtools.run">5.2 Running
Xtools</a></li><li><a href="#xtools.opengl">5.3 OpenGL
Notes</a></li></ul></li><li><a href="#other"><b>6 Other X11
Possibilities</b></a><ul><li><a href="#other.vnc">6.1 VNC</a></li><li><a
href="#other.wiredx">6.2 WiredX</a></li><li><a href="#other.exodus">6.3
eXodus</a></li></ul></li><li><a href="#trouble"><b>7 Troubleshooting
XFree86</b></a><ul><li><a href="#trouble.immedate-quit">7.1 When I launch
XDarwin, it quits
or crashes almost immediately</a></li><li><a href="#trouble.black">7.2 Black
icons in the GNOME panel or in the
menu of a GNOME application</a></li><li><a href="#trouble.keyboard">7.3 The
keyboard doesn't work in XFree86</a></li><li><a href="#trouble.delete-key">7.4
The Backspace key doesn't work</a></li><li><a href="#trouble.locale">7.5
"Warning: locale not supported by C library"</a></li></ul></li><li><a
href="#tips"><b>8 Usage Tips</b></a><ul><li><a href="#tips.terminal-app">8.1
Launching X11 apps from Terminal.app</a></li><li><a href="#tips.open">8.2
Launching Aqua apps from an xterm</a></li><li><a href="#tips.copy-n-paste">8.3
Copy and Paste</a></li></ul></li></ul><h2><a name="intro">1
Introduction</a></h2>
@@ -409,41 +409,26 @@
<p>
The XFree86 project has an official binary distribution of XFree86
-4.2.0, which can be upgraded to 4.2.1.1 with patches.
-You can find it on your local <a
href="http://www.xfree86.org/MIRRORS.shtml";>XFree86 mirror</a> in
-the directory <tt style="white-space:
nowrap;">4.2.0/binaries/Darwin-ppc-5.x</tt>.
-Be sure to get the <tt style="white-space: nowrap;">Xprog.tgz</tt> and <tt
style="white-space: nowrap;">Xquartz.tgz</tt>
-tarballs even though they are marked as optional.
-If you're unsure what you need, just download the whole directory.
-Run the <tt style="white-space: nowrap;">Xinstall.sh</tt> script as root to
install the stuff.
-(You might want to read the <a
href="http://www.xfree86.org/4.2.0/Install.html";>official
-instructions</a> before installing.) If you prefer, you can use the <a
href="http://prdownloads.sourceforge.net/xonx/XInstall_10.1.sit?download";>binary</a>
from XonX, which uses identical source but is easier to use. In either case,
download, unzip and run the following upgrades:</p>
- <ol>
- <li>10.1 users: <a
href="http://prdownloads.sourceforge.net/xonx/XFree86_4.2.0.1-10.1.zip?download";>4.2.0
-> 4.2.0.1 upgrade</a>. 10.2 users: <a
href="http://prdownloads.sourceforge.net/xonx/XFree86_4.2.0.1-10.2.zip?download";>4.2.0
-> 4.2.0.1 upgrade</a>
- </li>
- <li>10.1 and 10.2 users: <a
href="http://prdownloads.sourceforge.net/xonx/XFree86_4.2.1.1.zip?download";>4.2.0.1
-> 4.2.1.1 upgrade</a>
- </li>
- </ol>
- <p>There is an official binary distribution of XFree86
-4.3.0, as well, on the<a href="http://www.xfree86.org/MIRRORS.shtml";>XFree86
mirrors</a> in
-the directory <tt style="white-space:
nowrap;">4.3.0/binaries/Darwin-ppc-6.x</tt>.
+4.5.0. You can find it on your local <a
href="http://www.xfree86.org/mirrors";>XFree86 mirror</a> in
+the directory <tt style="white-space:
nowrap;">4.5.0/binaries/Darwin-ppc-6.x</tt> (or <tt style="white-space:
nowrap;">4.5.0/binaries/Darwin-ppc-5.x</tt> for OS 10.1).
Be sure to get the <tt style="white-space: nowrap;">Xprog.tgz</tt> and <tt
style="white-space: nowrap;">Xquartz.tgz</tt>
-tarballs even though they are marked as optional.
+tarballs even though they are marked as "optional".
If you're unsure what you need, just download the whole directory.
Run the <tt style="white-space: nowrap;">Xinstall.sh</tt> script as root to
install the stuff.
-(You might want to read the <a
href="http://www.xfree86.org/4.3.0/Install.html";>official
+(You might want to read the <a
href="http://www.xfree86.org/4.5.0/Install.html";>official
instructions</a> before installing.)</p>
- <p>Whichever version you install, you've now got XFree86 with a server
that can do fullscreen, or
+
+ <p>You've now got XFree86 with a server that can do fullscreen, or
rootless under Mac OS X.
</p>
<h3><a name="inst-xfree86.official-source">3.4 The Official Source</a></h3>
<p>
-If you've got the time to spare, you can build XFree86 4.2.0 from
+If you've got the time to spare, you can build XFree86 4.5 from
source.
You can find the source on your local <a
href="http://www.xfree86.org/MIRRORS.shtml";>XFree86 mirror</a> in
-the directory <tt style="white-space: nowrap;">4.2.0/source</tt>.
+the directory <tt style="white-space: nowrap;">4.5.0/source</tt>.
Grab all three <tt style="white-space: nowrap;">X420src-#.tgz</tt> tarballs
and extract them in
the same directory.
You can customize the build by putting macro definitions in the file
@@ -483,25 +468,8 @@
</p>
- <h3><a name="inst-xfree86.macgimp">3.6 MacGimp</a></h3>
-
- <p>
-The downloadable installer which was offered by the MacGimp people
-during 2001
-did not contain XFree86.
-(It would overwrite some XFree86 configuration files, though.)
-</p>
- <p>
-The CD that <a href="http://www.macgimp.com/";>MacGimp, Inc.</a>
-offers for sale reportedly contains XFree86.
-It's not quite clear what version it is; it may be a mix of
-4.0.3, 4.1.0 and a development snapshot.
-The server does rootless mode, using a patch from the time before
-4.1.0.
-</p>
-
-
- <h3><a name="inst-xfree86.switching-x11">3.7 Replacing X11</a></h3>
+
+ <h3><a name="inst-xfree86.switching-x11">3.6 Replacing X11</a></h3>
<p>
If you have already installed one of the Fink X11 packages but for one reason
or another
@@ -546,16 +514,13 @@
<tt style="white-space: nowrap;">X11.app</tt>, depending on what you had
installed. Make sure to check your <tt style="white-space:
nowrap;">.xinitrc</tt> if you are removing Apple's X11 to
make sure that you aren't trying to run <tt style="white-space:
nowrap;">quartz-wm</tt>. You can now install whatever new X11 variety you
want, manually or via Fink.</p>
- <h3><a name="inst-xfree86.fink-summary">3.8 Fink package summary</a></h3>
+ <h3><a name="inst-xfree86.fink-summary">3.7 Fink package summary</a></h3>
<p>
A quick summary of the install options and the Fink packages you
should install:
</p>
- <table border="0" cellpadding="0" cellspacing="10"><tr
valign="bottom"><th align="left">Install Type</th><th align="left">Fink
packages</th></tr><tr valign="top"><td>XFree86-4.2.1.x (10.2 only)</td><td>
- <p><tt style="white-space: nowrap;">xfree86-base</tt> and <tt
style="white-space: nowrap;">xfree86-rootless</tt> (and their <tt
style="white-space: nowrap;">-shlibs</tt>)</p>
- <p>or <tt style="white-space: nowrap;">xfree86-base-threaded</tt>
and <tt style="white-space: nowrap;">xfree86-rootless-threaded</tt> (and <tt
style="white-space: nowrap;">-shlibs</tt>)</p>
- </td></tr><tr valign="top"><td>XFree86-4.4 or 4.5 (10.3 and
10.4)</td><td>
+ <table border="0" cellpadding="0" cellspacing="10"><tr
valign="bottom"><th align="left">Install Type</th><th align="left">Fink
packages</th></tr><tr valign="top"><td>XFree86-4.4.0 or 4.5.0 (10.3 and
10.4)</td><td>
<p>
<tt style="white-space: nowrap;">xfree86</tt> and <tt
style="white-space: nowrap;">xfree86-shlibs</tt>
</p>
@@ -563,13 +528,18 @@
<p><tt style="white-space: nowrap;">xorg</tt> and <tt
style="white-space: nowrap;">xorg-shlibs</tt></p>
</td></tr><tr valign="top"><td>Apple's X11 (all versions)</td><td>
<p>
- <tt style="white-space: nowrap;">system-xfree86</tt> and <tt
style="white-space: nowrap;">system-xfree86-shlibs</tt> (+<tt
style="white-space: nowrap;">system-xfree86-dev</tt> for building)</p>
+ <tt style="white-space: nowrap;">system-xfree86</tt> and <tt
style="white-space: nowrap;">system-xfree86-shlibs</tt> (+<tt
style="white-space: nowrap;">system-xfree86-dev</tt> for building X11-based
packages)</p>
</td></tr><tr valign="top"><td>XFree86-4.x official binaries</td><td>
<p>
- <tt style="white-space: nowrap;">system-xfree86</tt> only
(+splitoffs)</p>
+ <tt style="white-space: nowrap;">system-xfree86</tt> and <tt
style="white-space: nowrap;">system-xfree86-shlibs</tt> (+<tt
style="white-space: nowrap;">system-xfree86-dev</tt> for building X11-based
packages)
+ </p>
</td></tr><tr valign="top"><td>XFree86-4.x built from source, or
from the latest CVS source</td><td>
<p>
- <tt style="white-space: nowrap;">system-xfree86</tt> only
(+splitoffs)</p>
+ <tt style="white-space: nowrap;">system-xfree86</tt> and <tt
style="white-space: nowrap;">system-xfree86-shlibs</tt> (+<tt
style="white-space: nowrap;">system-xfree86-dev</tt> for building X11-based
packages)
+ </p>
+ </td></tr><tr valign="top"><td>XFree86-4.2.1.x (10.2 only) or 4.2.0
(10.1 only)</td><td>
+ <p><tt style="white-space: nowrap;">xfree86-base</tt> and <tt
style="white-space: nowrap;">xfree86-rootless</tt> (and their <tt
style="white-space: nowrap;">-shlibs</tt>)</p>
+ <p>or <tt style="white-space: nowrap;">xfree86-base-threaded</tt>
and <tt style="white-space: nowrap;">xfree86-rootless-threaded</tt> (and <tt
style="white-space: nowrap;">-shlibs</tt>)</p>
</td></tr></table>
<h2><a name="run-xfree86">4 Starting X11</a></h2>
@@ -625,10 +595,10 @@
<h3><a name="run-xfree86.macosx-41">4.2 Mac OS X + XFree86 4.x.y</a></h3>
- <p>
+ <p>
There are basically two ways to start XFree86 under Mac OS X.
-One is double-clicking the XDarwin.app application in your
-Applications folder. This will let you choose between full
+One is double-clicking the <tt style="white-space: nowrap;">XDarwin.app</tt>
application in your
+<tt style="white-space: nowrap;">Applications</tt> folder. This will let you
choose between full
screen and rootless mode in a dialog at startup. You can disable
the dialog and set XDarwin always to use the mode of your
choice in the Preferences dialog.
@@ -640,7 +610,7 @@
</p>
<p>
The other way to start XFree86 under Mac OS X is via
-<tt style="white-space: nowrap;">startx</tt> from Terminal.app.
+<tt style="white-space: nowrap;">startx</tt> from <tt style="white-space:
nowrap;">Terminal.app</tt>.
If you start the server this way, you must tell it that it should run
in parallel with Quartz.
You do this by passing the <tt style="white-space: nowrap;">-fullscreen</tt>
option, like this:
@@ -654,23 +624,32 @@
NOTE: prior to 4.2, <tt style="white-space: nowrap;">-quartz</tt> was used for
fullscreen mode.
</p>
<p>
-If the server you have supports rootless operation,
-you can start it in rootless mode with the
+
+You can start it in rootless mode with the
<tt style="white-space: nowrap;">-rootless</tt> option:</p>
<pre>startx -- -rootless</pre>
<p>
The <tt style="white-space: nowrap;">-quartz</tt> option no longer selects
fullscreen mode,
but rather uses the default mode set in the preferences.
</p>
- <p>As of 4.3, if you use <tt style="white-space: nowrap;">startx</tt>
without arguments, the startup dialog box will come up.</p>
+ <p>As of version 4.3, if you use <tt style="white-space:
nowrap;">startx</tt> without arguments, the startup dialog box will come up.</p>
- <h3><a name="run-xfree86.starting-apples-x11">4.3 Starting Apple's
X11</a></h3>
+ <h3><a name="run-xfree86.starting-xorg">4.3 Starting X.org</a></h3>
- <p>
- Functionally, Apple's X11 works similarly to XFree86 (e.g. using a <tt
style="white-space: nowrap;">.xinitrc</tt> file to control the clients that are
launched on startup). The normal way to run it is by double-clicking the
<b>X11.app</b> icon (whose default location is <tt style="white-space:
nowrap;">/Applications/Utilities</tt>).</p>
+ <p>X.org works identically to XFree86 in all respects.</p>
+
+ <h3><a name="run-xfree86.starting-apples-x11">4.4 Starting Apple's
X11</a></h3>
+
+ <p>
+ Functionally, Apple's X11 works similarly to XFree86 (e.g. using a <tt
style="white-space: nowrap;">.xinitrc</tt> file to control the clients that are
launched on startup). The normal way to run it is by double-clicking the <tt
style="white-space: nowrap;">X11.app</tt> icon (whose default location is <tt
style="white-space: nowrap;">/Applications/Utilities</tt>). You can use <tt
style="white-space: nowrap;">startx</tt>, as well, but it doesn't have a
commmand-line option to set the display mode; <tt style="white-space:
nowrap;">X11.app</tt> will start up in whatever mode was previously set in its
Preferences.</p>
<p>If you don't set up a different window manager you will be running Apple's
<tt style="white-space: nowrap;">quartz-wm</tt> window manager.
<b>X11.app</b>'s Preferences give the option to switch between fullscreen and
rootless modes without restarting. However, this doesn't work for quartz-wm;
it is necessary to choose a different window manager (e.g. in <tt
style="white-space: nowrap;">.xinitrc</tt>)</p>
- <h3><a name="run-xfree86.xinitrc">4.4 The .xinitrc File</a></h3>
+ <h3><a name="run-xfree86.applex11tools">4.5 The applex11tools
package</a></h3>
+
+ <p>Fink's <tt style="white-space: nowrap;">applex11tools</tt> package
allows the use of <tt style="white-space: nowrap;">X11.app</tt> and <tt
style="white-space: nowrap;">quartz-wm</tt> under OS 10.3 and later with
XFree86 4.4 or later or X.org.</p>
+ <p>To install this package you must enable the <a
href="http://fink.sourceforge.net/faq/usage-fink.php#unstable";>unstable
tree</a>, and have <tt style="white-space: nowrap;">X11User.pkg</tt> somewhere
within <tt style="white-space: nowrap;">/Users</tt> or <tt style="white-space:
nowrap;">/Volumes</tt>. <tt style="white-space: nowrap;">X11.app</tt> will be
installed in the <tt style="white-space: nowrap;">Applications</tt> folder
within your Fink tree. You can now use either <tt style="white-space:
nowrap;">X11.app</tt> or <tt style="white-space: nowrap;">XDarwin.app</tt>.</p>
+
+ <h3><a name="run-xfree86.xinitrc">4.6 The .xinitrc File</a></h3>
<p>
If a file named <tt style="white-space: nowrap;">.xinitrc</tt> exists in your
home
@@ -684,7 +663,7 @@
</p>
<p>
When there is no <tt style="white-space: nowrap;">.xinitrc</tt> file in your
home
-directory, XFree86 will use its default file,
+directory, X11 will use its default file,
<tt style="white-space: nowrap;">/private/etc/X11/xinit/xinitrc</tt>.
You can use the default file as a starting point for your own
.xinitrc:
@@ -752,7 +731,14 @@
/sw/bin/startkde >/tmp/kde.log 2>&1
</pre>
- <h2><a name="xtools">5 Xtools</a></h2>
+ <h3><a name="run-xfree86.oroborosx">4.7 OroborOSX</a></h3>
+
+ <p><a href="oroborosx.sourceforge.net">OroborOSX</a> is a an alternative
to the X11.app and XDarwin display servers. It requires a preexisting X11
installation to work. <tt style="white-space: nowrap;">X11.app</tt> or <tt
style="white-space: nowrap;">XDarwin.app</tt> continue to function, as well</p>
+ <p>When run, <b>OroborOSX</b> starts its own rootless-only window manager,
and doesn't read in either the system's <tt style="white-space:
nowrap;">xinitrc</tt> or user's <tt style="white-space: nowrap;">.xinitrc</tt>
files. After starting, it does have a menu option to execute <tt
style="white-space: nowrap;">.xinitrc</tt>. However, it does have its own
method to set up applications to run when it starts.
+It also provides a mechanism to start X11 applications from the Finder via
startup scripts.</p>
+<p>For more information visit the <a
href="oroborosx.sourceforge.net">OroborOSX homepage</a>.</p>
+
+<h2><a name="xtools">5 Xtools</a></h2>
<h3><a name="xtools.install">5.1 Installing Xtools</a></h3>
@@ -1281,4 +1267,4 @@
provided the document and this copyright notice remain complete and
unmodified. Any commercial reproduction and any online publication
requires the explicit consent of the author.</p><hr>
-<p>Generated from <i>$Fink: x11.en.xml,v 1.14 2005/06/08 01:09:20 alexkhansen
Exp $</i></p></body></html>
+<p>Generated from <i>$Fink: x11.en.xml,v 1.15 2005/06/09 01:36:14 alexkhansen
Exp $</i></p></body></html>
-------------------------------------------------------
This SF.Net email is sponsored by: NEC IT Guy Games. How far can you shotput
a projector? How fast can you ride your desk chair down the office luge track?
If you want to score the big prize, get to know the little guy.
Play to win an NEC 61" plasma display: http://www.necitguy.com/?r=20
_______________________________________________
Fink-commits mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/fink-commits
