xorg-server-1.4/hw/darwin/quartz/XDarwinStartup.man

   1 .\" $XFree86: xc/programs/Xserver/hw/darwin/bundle/XDarwinStartup.man,v 1.1 2002/02/05 19:16:14 torrey Exp $
   2 .TH XDarwinStartup 1
   3 .SH NAME
   4 XDarwinStartup - Startup program for the XDarwin X window server
   5 .SH SYNOPSIS
   6 .B XDarwinStartup
   7 [\fI-iokit\fP]
   8 [\fI-fullscreen\fP]
   9 [\fI-rootless\fP]
  10 [\fI-quartz\fP]
  11 [\fI-idle\fP]
  12 [\fIoptions\fP]
  13 .SH DESCRIPTION
  14 The \fIXDarwin(1)\fP X window server can be run in a variety of different
  15 modes and is actually two different executables. The IOKit X server,
  16 XDarwin, is used when running from the console. It is most commonly
  17 located in __XBinDir__. The Quartz X server, for running in parallel with
  18 Aqua, is a full-fledged Mac OS X application that can be started from
  19 the Finder. Its application bundle is XDarwin.app, which is typically
  20 located in /Applications.
  21 .I XDarwinStartup
  22 allows easy switching between these X servers and auto-detection of the
  23 appropriate one to use when launching from the command line.
  24 When run without any arguments,
  25 .I XDarwinStartup
  26 will start the Quartz X server if the Core Graphics window server
  27 is currently running. Otherwise it will start the IOKit X server.
  28 .PP
  29 To locate the Quartz X server,
  30 .I XDarwinStartup
  31 will try to read the soft link at __XBinDir__/XDarwinQuartz.
  32 This is typically a soft link to the executable of the XDarwin.app
  33 application. If this fails,
  34 .I XDarwinStartup
  35 will call Launch Services to locate XDarwin.app.
  36 .PP
  37 To start the IOKit X server,
  38 .I XDarwinStartup
  39 will run the XDarwin executable, which should be present in the
  40 user's path.
  41 .SH OPTIONS
  42 .I XDarwinStartup
  43 accepts and passes on all options to the X server it
  44 launches. In addition the following options have specific effects:
  45 .TP 8
  46 .B \-iokit
  47 Launch the IOKit X server.
  48 .TP 8
  49 .B \-fullscreen
  50 Launch the Quartz X server to run in full screen mode.
  51 .TP 8
  52 .B \-rootless
  53 Launch the Quartz X server to run in rootless mode.
  54 .TP 8
  55 .B \-quartz
  56 Launch the Quartz X server.
  57 .TP 8
  58 .B \-idle
  59 Pause and do nothing. This option is used by XDarwin.app when it is
  60 started from the Finder.
  61 .SH FILES
  62 .TP 30
  63 __XBinDir__/XDarwin
  64 IOKit mode X server
  65 .TP 30
  66 /Applications/XDarwin.app
  67 Quartz mode X server
  68 .TP 30
  69 __XBinDir__/XDarwinQuartz
  70 Soft link to Quartz mode X server executable
  71 .SH SEE ALSO
  72 XDarwin(1)
  73 .SH BUGS
  74 The path to XDarwinQuartz should not be hard coded.
  75