home *** CD-ROM | disk | FTP | other *** search
/ Enter 1999 April - Disc 1 / enter_04_1999_1.iso / OS2 / XFREE86 / XDOC.ZIP / XFree86 / lib / X11 / doc / QuickStart.doc < prev    next >
Encoding:
Text File  |  1999-01-09  |  28.9 KB  |  859 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.                       Quick-Start Guide to XFree86 Setup
  11.  
  12.                                    Joe Moss
  13.  
  14.                                27 February 1998
  15.  
  16.  
  17.  
  18.                                    Abstract
  19.  
  20.           Current releases of XFree86 include several tools that can help
  21.      to automate the process of server configuration. Much of the existing
  22.      documentation, however, describes how to do the job manually, includ-
  23.      ing many technical details.       For those users with esoteric hard-
  24.      ware or with the desire to get their hands dirty under the hood, this
  25.      is great, but many users are using common hardware and just want to
  26.      get X up and running quickly.  This guide is for them.
  27.  
  28.  
  29.  
  30. 1.  Before You Start
  31.  
  32. There are a few bits of information that you will need to have before you can
  33. setup the server:
  34.  
  35.       The model name of your video card
  36.             Make sure you know the exact model name of the card.  It may help
  37.             to also know the graphics chipset, RAMDAC, and clock chip used on
  38.             your card.
  39.  
  40.       The amount of memory on your video card
  41.             Find out how many megabytes of RAM are on your video card.
  42.  
  43.       Whether or not your card is VGA compatible
  44.             Most cards these days are VGA compatible, but for example, if you
  45.             have and older monochrome card, it might not be.
  46.  
  47.       Your monitor's specifications
  48.             Specifically, you need to know the horizontal sync rate(s), and
  49.             vertical refresh rate(s).  These are important!  Consult your moni-
  50.             tor's manual.
  51.  
  52.       The protocol used by your mouse
  53.             It will help speed up the process, if you know which protocol is
  54.             used by your mouse to communicate. Some mice are capable of using
  55.             two different protocols, although the method of switching between
  56.             them varies.  In some cases, with new Plug-n-Play mice, the proto-
  57.             col can be determined automatically.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64. Quick-Start Guide to XFree86 Setup                                            1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. Quick-Start Guide to XFree86 Setup                                            2
  71.  
  72.  
  73.  
  74. 2.  What to Do - An Overview
  75.  
  76. There are three tools that can be used to set up XFree86:
  77.  
  78.    o XF86Setup
  79.  
  80.    o xf86config
  81.  
  82.    o xvidtune
  83.  
  84. XF86Setup primarily uses a graphical user interface and is the preferred tool
  85. for initial setup, but there are a few cases where it can't be used.  If you
  86. are using a card that is not VGA compatible, have a fixed-frequency monitor, or
  87. are running OS/2, you'll not be able to use XF86Setup, read about xf86config
  88. instead.  If you have limited RAM or a slow system, you might be better off
  89. using xf86config as well.
  90.  
  91. The xf86config program is text based only, but works for almost any hardware
  92. combination.  If you have a fixed frequency monitor that won't work with stan-
  93. dard text modes, you will have to read the necessary documentation and do the
  94. configuration manually.
  95.  
  96. To get things looking just right, you may need to use xvidtune, a program that
  97. allows you to make adjustments to the displayed image (e.g. make it wider, move
  98. it a little to the left, etc.).  XF86Setup will allow you to run xvidtune at
  99. the appropriate time; if you use xf86config, you can use xvidtune afterwards.
  100.  
  101.       All of these are explained in detail in the following sections.  If
  102. you're the type that doesn't like to read the documentation, but would rather
  103. just try and figure your way through things, you can just type XF86Setup now.
  104. If you have problems, the documentation will still be here.
  105.  
  106. Although it is possible to use XF86Setup from within X to make changes to your
  107. existing configuration, such use is not specifically documented here.  These
  108. instructions are primarily for those initially setting up XFree86 on their sys-
  109. tem.
  110.  
  111.  
  112. 3.  Using XF86Setup
  113.  
  114. XF86Setup will first check around to make sure certain files are installed and
  115. that you are running as root.  If a problem is found, it will display a message
  116. and exit.  Correct the problem (e.g. install the missing files) and run it
  117. again.
  118.  
  119. XF86Setup is internationalized. If you are Japanese and set the LANG environ-
  120. ment variable to ja, japan, japanese, etc., XF86Setup's screen can be
  121. Japanized. But it is necessary that XF86Setup is built with Japanized Tcl/Tk.
  122. Other language can be added, if you prepare its own directory under the direc-
  123. tory XF86Setup/texts. Please see under the directory XF86Setup/texts/generic.
  124.  
  125. 3.1  Initial questions
  126.  
  127. If you have an existing XF86Config file, you will be asked if you would like to
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. Quick-Start Guide to XFree86 Setup                                            3
  137.  
  138.  
  139.  
  140. use it to set the default values of various configuration settings.  If you've
  141. already got an (at least somewhat) working configuration you will want to do
  142. this.
  143.  
  144. If you are running on an OS which has a mouse driver in the kernel (e.g. SCO or
  145. SVR4), you may be asked if you'd like to use it.
  146.  
  147. Once the questions (if any) are completed, you will see a message indicating
  148. that the program is ready to switch into graphics mode.  Just press Enter.  If
  149. you don't get a graphics screen saying Welcome to XFree86 Setup within a
  150. minute, something has probably hung, you can try pressing Ctrl-Alt-Backspace to
  151. switch back to text mode and you'll probably have to use xf86config instead of
  152. XF86Setup.
  153.  
  154. 3.2  Configuration areas
  155.  
  156. Once the VGA16 server is started, and once the program has finished loading,
  157. you will see a screen with six buttons along the top and three along the bot-
  158. tom.  The buttons along the top correspond to the general categories of config-
  159. uration settings.  They can be done in any order.  Each of these areas is
  160. explained in detail below.  The bottom row consists of the Abort, Done, and
  161. Help buttons.
  162.  
  163. Abort does as it name implies. It exits the program without saving any changes
  164. that have been made. The one possible exception is the link to the mouse
  165. device. Any change to that is made as soon as Apply is selected.
  166.  
  167. Done should be selected when you've finished configuration in each of the vari-
  168. ous categories.
  169.  
  170. The Help can be pressed at any time to get on-line help regarding the current
  171. configuration screen.
  172.  
  173. You should start with configuring your mouse as it will make things a lot eas-
  174. ier to perform the configuration of other categories.
  175.  
  176. 3.2.1  Mouse
  177.  
  178. The mouse configuration screen is used to get the mouse working properly.
  179. There are key bindings for everything so that you can easily configure the
  180. mouse, if it's not already working.
  181.  
  182. The screen includes a representation of a white mouse with three buttons.  As
  183. you move your mouse it should show the pointer coordinates on the mouse and the
  184. buttons should turn black as you press the corresponding button on your mouse.
  185. If that is not happening, then your mouse is not correctly configured.
  186.  
  187. Along the top are some rows of buttons corresponding to the various possible
  188. protocols. There will also be several buttons and a couple of sliders for other
  189. settings, a visual representation of the mouse, and a button to apply any
  190. changes.  There may also be an entry box in which the device can be set along
  191. with a list of possible devices.
  192.  
  193. First try moving your mouse around and see if the pointer moves correctly.  If
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. Quick-Start Guide to XFree86 Setup                                            4
  203.  
  204.  
  205.  
  206. so, try testing that the buttons are working properly.  If those are working as
  207. desired, go ahead and go on to another configuration area.
  208.  
  209. If the mouse pointer doesn't move at all, you need to fix either the mouse
  210. device or the protocol (or both).  You can press 'n' followed by a Tab, to move
  211. to the list of mouse devices and select a different one.  Pressing 'p' will
  212. pick the next available protocol on the list (protocols that are not available
  213. on your OS will be greyed-out).  If you have a PnP mouse, it may be easiest to
  214. just select "Auto" as the protocol.  After changing these, press 'a' to apply
  215. the changes and try again.  Repeat the process until you are getting some
  216. response from your mouse.
  217.  
  218. If the mouse pointer or button indicators do something when you move the mouse,
  219. but the pointer is not moving properly, you probably have the wrong protocol
  220. selected.  Try with a different one.
  221.  
  222. Most mice these days use the Microsoft protocol, the second most common is
  223. MouseSystems.  Some mice do both.  These dual-protocol mice have various meth-
  224. ods of switching between the two protocols.  Some have a switch on the mouse
  225. itself.  Some are switched by sending a certain signal to the mouse when open-
  226. ing a connection to the mouse.  These signals can be controlled by using dif-
  227. ferent combinations of the 'ClearDTR' and 'ClearRTS' settings.  Other mice
  228. require a button to be depressed when the mouse is opened (when the mouse
  229. driver first tries to talk to it).  If your mouse uses this method, hold down
  230. the appropriate button while selecting apply (pressing 'a').
  231.  
  232. Once the mouse pointer is moving correctly, test that all three buttons are
  233. working properly. If your mouse only has two buttons, select 'Emulate3Buttons'
  234. and you should be able to press both buttons simultaneously to emulate the
  235. missing middle button.  If not all of the buttons are working, try changing the
  236. 'ChordMiddle' setting or you may be using a protocol that is similar to that of
  237. your mouse, but not quite right.
  238.  
  239. 3.2.2  Keyboard
  240.  
  241. You need to specify the model and layout of your keyboard (and press apply) if
  242. they are not already correct.  The graphical representation of the keyboard
  243. will be updated when you choose a different model.
  244.  
  245. For non-U.S. keyboards you may wish to choose a variant from the list (at this
  246. time there is only one available variant: nodeadkeys>).
  247.  
  248. You can also pick from the options to the right, if you wish.
  249.  
  250. 3.2.3  Card
  251.  
  252. Pick your card from the list.
  253.  
  254. If there are README files that may pertain to your card the 'Read README file'
  255. button will then be usable (i.e. not greyed out).  Please read them.
  256.  
  257. If your card is not in the list, or if there are any special settings listed in
  258. the README file as required by your card, you can press the 'Detailed Setup'
  259. button to make sure that the required settings are selected.  Otherwise, you're
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. Quick-Start Guide to XFree86 Setup                                            5
  269.  
  270.  
  271.  
  272. finished with configuring your card.
  273.  
  274. To use 'Detailed Setup': First select the appropriate server for your card.
  275. Then read the README file corresponding to the selected server by pressing the
  276. 'Read README file' button (it won't do anything, if there is no README).
  277.  
  278. Next, pick the chipset, and Ramdac of your card, if directed by the README
  279. file.  In most cases, you don't need to select these, as the server will detect
  280. (probe) them automatically.
  281.  
  282. The clockchip should generally be picked, if your card has one, as these are
  283. often impossible to probe (the exception is when the clockchip is built into
  284. one of the other chips).
  285.  
  286. Choose whatever options are appropriate (again, according to the README).
  287.  
  288. You can also set the maximum speed of your Ramdac.  Some Ramdacs are available
  289. with various speed ratings.  The max speed cannot be detected by the server so
  290. it will use the speed rating of the slowest version of the specified Ramdac, if
  291. you don't specify one.
  292.  
  293. Additionally, you can also specify the amount of RAM on your card, though the
  294. server will usually be able to detect this.
  295.  
  296. 3.2.4  Modeselect
  297.  
  298. Use this one to pick which depth you prefer to use (this determines how many
  299. colors can be displayed at a time) and to select all of the modes you are
  300. interested in possibly using.
  301.  
  302. Your hardware may not be able to support all of depth and mode combinations
  303. that can be selected.  Any unsupported combinations will automatically be
  304. rejected by the server when it tries to startup.  Note also that if you select
  305. multiple modes, you will get a virtual screen as large as the largest of the
  306. usable modes.
  307.  
  308. 3.2.5  Monitor
  309.  
  310. Enter the horizontal and vertical frequency ranges that your monitor supports
  311. in the corresponding entry boxes near the top of the screen.  You can enter
  312. specific frequencies or ranges of frequencies (separated by hyphens).  If the
  313. monitor supports several different frequencies or ranges, list them all, sepa-
  314. rated by commas.
  315.  
  316. If you can not find this information in you monitor's manual, pick one of the
  317. choices from the list of common monitor capabilities.  The program will use
  318. conservative values for each of these, so you'll get better performance if you
  319. type in the correct values from your monitor manual.
  320.  
  321. 3.2.6  Other
  322.  
  323. You can probably just skip this one.
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334. Quick-Start Guide to XFree86 Setup                                            6
  335.  
  336.  
  337.  
  338. 3.2.7  Completing the configuration
  339.  
  340. Once you've finished with the above, press the 'Done' button and then the
  341. 'Okay' button which will appear. You will then be switched back to text mode.
  342.  
  343. 3.3  Back to text mode
  344.  
  345. The program will now attempt to start the appropriate server for your card,
  346. with all of the configuration settings you selected.  If for some reason it is
  347. unable to start the server, you have likely selected an improper setting and
  348. will be asked if you would like to return to the graphical configuration screen
  349. and try again.
  350.  
  351. 3.4  The second server
  352.  
  353. This is unlikely to happen, but if when the server starts, the display is
  354. unreadable, try pressing Ctrl-Alt-+ (using the plus on the numeric keypad) to
  355. switch to a different video mode.
  356.  
  357. The display will show an entry box and three buttons.
  358.  
  359. The first button allows you to run xvidtune to adjust your video modes.  One
  360. important point to keep in mind when using xvidtune is that switching video
  361. modes with Ctrl-Alt-+ is disabled while xvidtune is running.  You must use the
  362. 'Next' and 'Prev' buttons to switch modes.  Because of this, you should be
  363. careful not to move the mouse when pressing either of these.  If by some chance
  364. the mode you switch to doesn't produce a readable display on your monitor, you
  365. can then just press the mouse button again to move to the next (hopefully read-
  366. able) mode.
  367.  
  368. The second button causes the settings you've made to be written to the filename
  369. given in the entry box.  After saving the settings a message will appear indi-
  370. cating that it has finished. Just press the 'Okay' button and you're done.
  371.  
  372. And the third button causes the program to exit without saving any of the con-
  373. figuration settings.
  374.  
  375. 3.5  Ending text
  376.  
  377. You are returned to text mode and the program will print a `Configuration com-
  378. plete.' message.  You should now have a usable configuration file and can start
  379. the X server by whichever method you wish (usually either the 'startx' command
  380. or via 'xdm').
  381.  
  382.  
  383. 4.  Running xf86config
  384.  
  385. From a text screen, run the xf86config program.  This program should be run as
  386. root (although not absolutely necessary, it will allow xf86config to do more of
  387. the work for you).  You can press your interrupt character (usually Control-C
  388. or perhaps Delete), at any time to stop the program, if you need to.  You can
  389. just start it over again.
  390.  
  391. The xf86config program provides instructions on screen as to what you need to
  392.  
  393.  
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400. Quick-Start Guide to XFree86 Setup                                            7
  401.  
  402.  
  403.  
  404. do.  Following are some notes that document the various stages in the process.
  405. They should help you get through the process quickly and provide some documen-
  406. tation for those people who like to know what they're getting themselves into,
  407. before running a program.
  408.  
  409. 4.1  The intro screen
  410.  
  411. First, xf86config begins by telling you a few things like the fact that it can
  412. help you setup an XF86Config file or that you can do the job yourself with an
  413. editor.  Just read what it says and press Enter when done.
  414.  
  415. 4.2  Getting your PATH right
  416.  
  417. The program will next check that you have the directory /usr/X11R6 (the stan-
  418. dard installation directory) on your system and tell you that it needs to be in
  419. your PATH environment variable.
  420.  
  421. It will also check if you have the /usr/X386 directory as used by older (pre
  422. 3.0) versions of XFree86.  If by chance you do, it will warn you that
  423. /usr/X11R6 must be before /usr/X386 in your PATH.
  424.  
  425. If everything is okay, just press Enter and go on, otherwise press Control-C to
  426. exit and make any necessary changes and restart xf86config.
  427.  
  428. 4.3  Mouse setup
  429.  
  430. Pick the mouse type from the menu and enter the name of the device to which
  431. mouse is connected, as directed.
  432.  
  433. If you are using an OS (e.g. SVR4, SCO) that has a built in mouse driver that
  434. the Xserver could use, you'll need to edit the XF86Config file to setup your
  435. mouse, so just pick any mouse from the list and press enter when asked for the
  436. device.
  437.  
  438. If you don't know which protocol your mouse uses, you'll just have to guess
  439. (the xf86config program will give you some hints as to which might be most
  440. likely) and then see the troubleshooting section if it doesn't work when you
  441. run the server.
  442.  
  443. The xf86config program has not been updated to allow you to select the latest
  444. mouse protocols, so you may have to edit the config file by hand after xf86con-
  445. fig has finished.
  446.  
  447. 4.4  Keyboard setup
  448.  
  449. Simply answer yes to the question regarding keyboard setup.
  450.  
  451. If there is some reason you need to use the right-alt and control keys for
  452. something else, you can enter no.
  453.  
  454. 4.5  Monitor setup
  455.  
  456. Setting up a monitor consists of entering the specifications of your monitor
  457. and a description of the model and manufacturer.
  458.  
  459.  
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466. Quick-Start Guide to XFree86 Setup                                            8
  467.  
  468.  
  469.  
  470. You are first asked for the horizontal sync rate.  It is VERY important to
  471. enter the correct value(s) from the manual. If one of the ranges given matches
  472. the rate of your monitor, then pick it, otherwise pick custom and enter the
  473. values from your manual.
  474.  
  475. Next is the vertical refresh rate. Again, it is VERY important that this param-
  476. eter be specified correctly.  Enter it in a manner similar to the horizontal
  477. sync rate.
  478.  
  479. If either rate is mis-specified, it can result in damage to your monitor.
  480.  
  481. Finally, you are asked for an "identifier", your monitor manufacturer, and
  482. model.  You can just press enter to get through these quickly.
  483.  
  484. 4.6  Selecting your card
  485.  
  486. You are next asked if you would like to view the database of cards.  Picking
  487. your card from the list will cause the answers to the questions in the next two
  488. sections to be filled in for you and so can save a little time.
  489.  
  490. If your card does not appear in the list, just press q and enter to skip on to
  491. the next step - where you'll have to answer the questions yourself.
  492.  
  493. 4.7  Server selection
  494.  
  495. If you selected your card in the previous step, then server selection is easy -
  496. just use the recommendation from the database.
  497.  
  498. If you have a card which uses one of the chipsets for which a specific server
  499. exists (Mach8, Mach32, Mach64, AGX/XGA, 8514/A, S3, I128, P9000) you'll want to
  500. pick the accel option.
  501.  
  502. Otherwise you'll probably want to use the SVGA server.
  503.  
  504. Next, answer yes when the program asks if you want it to set the symbolic link
  505. for you.  If you picked the accel option, you'll also need to indicate which
  506. particular accelerated server to link to.
  507.  
  508. 4.8  Screen/Video configuration
  509.  
  510. Pick the appropriate option from the list to indicate the amount of memory on
  511. your video card.
  512.  
  513. Then you are asked to provide and identifier, the manufacturer, and the model
  514. of your card.  You can just press enter to skip through these, if you wish.
  515.  
  516. Next, the program will ask for the type of RAMDAC and Clockchip on your card.
  517. If your card was in the database, you should just to tell it to use the values
  518. from the database.
  519.  
  520. If you don't have one of the listed RAMDACs or Clockchips on your card, just
  521. press enter when asked what type you have.  If you do not have a programmable
  522. clock chip, the program will next attempt to probe to find out what clock rates
  523. are supported by your clock chip.
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532. Quick-Start Guide to XFree86 Setup                                            9
  533.  
  534.  
  535.  
  536. 4.9  Mode Selection
  537.  
  538. Now you get to tell the program which video modes you would like to be able to
  539. run.
  540.  
  541. The program will show you the common modes that should work with your card
  542. (some might not work with your monitor, but if you've correctly specified the
  543. monitor's sync rates, the X server will just ignore them when it runs).
  544.  
  545. You could just accept the settings as they are given, but you'll probably wish
  546. to reverse the order.  For example, if you have a card with 1 Meg RAM, it will
  547. list the modes
  548.  
  549.                "640x480" "800x600" "1024x768" for 8bpp
  550.  
  551.  
  552. Select 1 to change the settings for 8bpp and the type 432 to select the reverse
  553. order.
  554.  
  555. When you've select the modes, in the order you wish, select option 4 to con-
  556. tinue.
  557.  
  558. 4.10  Creating the XF86Config file
  559.  
  560. The program will now ask if you would like to write the configuration settings
  561. you've selected to the file XF86Config. Answer yes.
  562.  
  563. 4.11  Some final notes
  564.  
  565. Lastly, the program tells you that it's finished its part of this process and
  566. counsels you to check the file before using it.  The next section covers the
  567. changes that are most likely to be needed.
  568.  
  569.  
  570. 5.  Fixing the XF86Config file
  571.  
  572. Use an editor to look at the XF86Config file. Here are some things that may
  573. need to be changed:
  574.  
  575.    o If you are running an operating system which has built-in mouse support,
  576.      you'll want to change the Pointer section.  Specifically, you should set
  577.      the Protocol to OSMouse (SCO) or Xqueue (SVR4, some SVR3) and you should
  578.      remove the Device line.
  579.  
  580.    o If you are running a system with the Xqueue event driver and would like to
  581.      use it, change the Protocol setting in the Keyboard section to Xqueue.
  582.  
  583. Once you are satisfied that the configuration is correct, copy the XF86Config
  584. file to /usr/X11R6/lib/X11 and run the 'startx' command.
  585.  
  586. You should now have a running X server.  If it's running but the display
  587. doesn't look as good as you think it should (i.e.  it doesn't fill the whole
  588. screen, it's off-center, it's wrapping around on one side, etc.) see the sec-
  589. tion on xvidtune.  If there is some other problem, see the troubleshooting
  590.  
  591.  
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598. Quick-Start Guide to XFree86 Setup                                           10
  599.  
  600.  
  601.  
  602. section.
  603.  
  604.  
  605. 6.  Running xvidtune
  606.  
  607. If you need to make adjustments to the video display, xvidtune is the tool to
  608. use.
  609.  
  610. Simply enter the command xvidtune from a shell prompt within an xterm.  Read
  611. the warning and click on OK.  Next click on the Auto button.
  612.  
  613. Now click on whatever combination of Up/Down/Left/Right
  614. Shorter/Taller/Wider/Narrower is need to adjust the display to your liking.
  615.  
  616. If you are using a recent S3-based card there will be some extra buttons and
  617. entries at the bottom (InvertVCLK, EarlySC, and Blank Delays). These can help
  618. solve problems of the display wrapping around a few pixels.
  619.  
  620. Once the display has been adjusted properly, press the show button to printout
  621. the correct ModeLine to put in the XF86Config to make the server always use the
  622. current display settings.  To aid in copying this information to your XF86Con-
  623. fig file, the modeline is also made the current selection allowing you to just
  624. paste it into your editor.
  625.  
  626. If you would like to adjust your other modes, you can click on the Next and
  627. Prev buttons to switch modes.
  628.  
  629. When you are through using xvidtune simply press on the Quit button.
  630.  
  631.  
  632. 7.  Troubleshooting
  633.  
  634. Since you're reading this, something must not have gone the way you had hoped
  635. (or else you just really enjoy reading).
  636.  
  637. Below are listed some common problems that may occur during configuration and
  638. some hints for solving them.  However, there are just too many different combi-
  639. nations of hardware and software configurations, and, well, just too many
  640. things that can go wrong, for this document and the tools it documents, to
  641. cover every case.
  642.  
  643. If after trying the steps in the previous sections and checking the hints in
  644. this section, you still are unable to get your system working, you'll have to
  645. read the full documentation.  Read the README file for your card and OS (if
  646. they exist), the XFree86 Configuration Guide (README.Config), and the XF86Con-
  647. fig man page.
  648.  
  649. You should also look at the XFree86 FAQ <URL:http://www.XFree86.org/FAQ> for
  650. more up-to-date information, especially if you are trying to configure a fairly
  651. new card.
  652.  
  653. If all else fails, you can try posting a message to comp.windows.x.i386unix or
  654. comp.os.linux.x or send email to XFree86@XFree86.org.
  655.  
  656.  
  657.  
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664. Quick-Start Guide to XFree86 Setup                                           11
  665.  
  666.  
  667.  
  668. 7.1  The mouse doesn't move correctly, it stays in one area of the screen
  669.  
  670. You've selected the wrong protocol for your mouse. Try a different one.
  671.  
  672. 7.2  The server doesn't start, it says the mouse is busy.
  673.  
  674. Well, it's probably right.  This most often happens on Linux systems that have
  675. gpm running.  Kill the gpm process and try startx again.
  676.  
  677. 7.3  The middle button doesn't work.
  678.  
  679. There's no easy answer to this one.  It's a lot of trial and error.  You need
  680. to make sure you're running the right protocol for your mouse.
  681.  
  682. Many three button mice are "dual protocol" which means that they have both a
  683. 2-button and 3-button mode. The way to get the mouse to switch into 3-button
  684. mode (which usually then uses MouseSystems protocol) varies between different
  685. models.
  686.  
  687. You may need to slide a switch on the mouse or hold down the middle button when
  688. starting the server.  Other methods of switching modes can be done by the
  689. server, you just have to find the right combination of settings for your mouse.
  690. See the Pointer section of the XF86Config man page for a complete list of set-
  691. tings.
  692.  
  693. 7.4  The display is shifted to the left/right/top/bottom
  694.  
  695. See the section on xvidtune.
  696.  
  697. 7.5  I don't appear to have xf86config or xvidtune on my system
  698.  
  699. Hmmm. A couple of possibilities:
  700.  
  701.   1.  Your PATH is not set correctly. Make sure it includes the bin directory
  702.       for the XFree86 binaries (usually, /usr/X11R6/bin
  703.  
  704.   2.  You don't have a complete installation of XFree86.  Go back to wherever
  705.       you got XFree86 and get the missing pieces.
  706.  
  707.      Generated from XFree86: xc/programs/Xserver/hw/xfree86/doc/sgml/QStart.sgml,v 3.4.2.3 1998/04/29 04:18:31 dawes Exp $
  708.  
  709.  
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.  
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730. Quick-Start Guide to XFree86 Setup                                           12
  731.  
  732.  
  733.  
  734.  
  735.  
  736.  
  737.  
  738.  
  739.  
  740.  
  741.  
  742.  
  743.  
  744.  
  745.  
  746.  
  747.  
  748.  
  749.  
  750.  
  751.  
  752.  
  753.  
  754.  
  755.  
  756.  
  757.  
  758.  
  759.  
  760.  
  761.  
  762.  
  763.  
  764.  
  765.  
  766.  
  767.  
  768.  
  769.  
  770.  
  771.  
  772.  
  773.  
  774.  
  775.  
  776.  
  777.  
  778.  
  779.  
  780.  
  781.  
  782.  
  783.  
  784.  
  785.  
  786.  
  787.  
  788.  
  789.  
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.  
  797.  
  798.  
  799.  
  800.                                    CONTENTS
  801.  
  802.  
  803.  
  804. 1. Before You Start ......................................................... 1
  805.  
  806. 2. What to Do - An Overview ................................................. 2
  807.  
  808. 3. Using XF86Setup .......................................................... 2
  809.    3.1  Initial questions ................................................... 2
  810.    3.2  Configuration areas ................................................. 3
  811.    3.3  Back to text mode ................................................... 6
  812.    3.4  The second server ................................................... 6
  813.    3.5  Ending text ......................................................... 6
  814.  
  815. 4. Running xf86config ....................................................... 6
  816.    4.1  The intro screen .................................................... 7
  817.    4.2  Getting your PATH right ............................................. 7
  818.    4.3  Mouse setup ......................................................... 7
  819.    4.4  Keyboard setup ...................................................... 7
  820.    4.5  Monitor setup ....................................................... 7
  821.    4.6  Selecting your card ................................................. 8
  822.    4.7  Server selection .................................................... 8
  823.    4.8  Screen/Video configuration .......................................... 8
  824.    4.9  Mode Selection ...................................................... 9
  825.    4.10 Creating the XF86Config file ........................................ 9
  826.    4.11 Some final notes .................................................... 9
  827.  
  828. 5. Fixing the XF86Config file ............................................... 9
  829.  
  830. 6. Running xvidtune ........................................................ 10
  831.  
  832. 7. Troubleshooting ......................................................... 10
  833.    7.1  The mouse doesn't move correctly, it stays in one area of the
  834.         screen ............................................................. 11
  835.    7.2  The server doesn't start, it says the mouse is busy. ............... 11
  836.    7.3  The middle button doesn't work. .................................... 11
  837.    7.4  The display is shifted to the left/right/top/bottom ................ 11
  838.    7.5  I don't appear to have xf86config or xvidtune on my system ......... 11
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.  
  856.                                        i
  857.  
  858.  
  859.