<qandadiv id="troubleshooting">
<title>&title-troubleshooting;</title>

<qandaentry>
<question id="q-fatal-error">
<para>&project; failed with "Fatal Error". What does this mean?</para>
</question>
<answer>
<para>The Fatal Error is a general error message. More specific information
what caused this is available in <filename>&file-log;</filename>. Please
check the common error messages in <link linkend="errors">the Section called  
<emphasis>&title-errors;</emphasis></link>. If your error is not mentioned 
proceed with <xref linkend="q-error-message-not-listed"></xref></para> 
</answer>
</qandaentry>

<qandaentry>
<question id="q-log-file-location">
<para>Is there a log file that I can look at for diagnostic
information and error messages?</para>
</question>
<answer>
<para>Yes.  The &project; log file is located at
<filename>&file-log;</filename>.  You will find solutions to the most
common error messages in <link linkend="errors">the Section called
<emphasis>&title-errors;</emphasis></link>.</para>
</answer>
</qandaentry>


<qandaentry>
<question id="q-error-message-interpretation">
<para>I have a specific error message, what does it mean?</para>
</question>
<answer>
<para>See the &title-errors; section for help with specific error
messages.  Return to this section if you do not find a specific answer
for the error message that you have.</para>
</answer>
</qandaentry>


<qandaentry>
<question id="q-error-message-not-listed">
<para>I have a specific error message that is not addressed in the
&title-errors; section.</para>
</question>
<answer>
<para>Search the <ulink url="&project-url-ml-search;">&project;
mailing list archives</ulink> to see if the error message has already
been reported and/or addressed.  Report the error message to the
&project-ml; mailing list, how the
error message was caused, and the behavior of the X Server after the
error message was generated (exit, freeze, etc.), only if the error
message has not been reported, if the circumstances that produced the
error message are significantly different from other reports, or if
you have additional information regarding the error message to
contribute. Please include <filename>&file-log;</filename> in your mail.
This may help us identify the cause of your problem quicker.</para>
</answer>
</qandaentry>


<qandaentry>
<question id="q-but-report-ignored">
<para>My bug report the &project; mailing list was ignored.  What do I
do now?</para>
</question>
<answer>
<para>Some bug reports are deliberately ignored by project members if
the bug in question was recently dealt with; did you <ulink
url="&project-url-ml-search;">search the mailing list archives</ulink>
for a solution to your problem before submitting your bug report?
Some bug reports are ignored if they do not contain sufficient
information to understand the situation that produces the bug; did
your bug report have enough information?  Some bug reports are missed
or forgotten, thus some valid bug reports do not receive a reply;
simply resubmit such bug reports that have not received a response
within 7 days of submission.</para>
</answer>
</qandaentry>

<qandaentry>
<question id="freeze-at-startup">
<para>Why does &project; freeze right after startup?</para>
</question>

<answer>
<para>Zone Alarm 5 is known to break &project;. As a result you'll see
this line (or a similar) as last output in <filename>&file-log;</filename>
<screen>Rules = "xorg" Model = "pc101" Layout = "us" Variant = "(null)" Options = "(null)"</screen>
Disabling Zone Alarm will not solve this problem. You can only uninstall Zone Alarm 5 and switch to an earlier version (4.5 is known to work) or use a different
personal firewall.
</para>
</answer>
<answer>
<para>Another reason is <filename>/tmp</filename> mounted in textmode. This does
only happen with the <parameter>-multiwindow</parameter> and 
<parameter>-clipboard</parameter> switches because of the extra threads within
&project;. 
</para>
<para>You can remount <filename>/tmp</filename> to binmode with these commands:
<screen>mount -b "$(cygpath -m /tmp)" /tmp
</screen>

If this fails with an error message stating insufficient rights, try

<screen>mount -b -u "$(cygpath -m /tmp)" /tmp
</screen>
</para>
</answer>
</qandaentry>


<qandaentry>
<question id="poor-performance">
<para>&project; has very poor performance. What's the reason?</para>
</question>

<answer>
<para>Most likely you have installed some kind of personal firewall, VPN 
software or any other software that modifies the TCP/IP stack of Windows.
Especially Webwasher and some other filtering software are known to slow
down the network traffic.</para>
</answer>

<answer>
<para>Some online virus scanners like Symantec Antivirus do slowdown &project;
a lot. They scan every file access and network traffic which causes serious 
processing overhead beyond that from the X11 protocol and the unix emulation
layer.</para>
<para>So far there is no known solution but to disable the virus scanner
completely.</para> 
</answer>

<answer>
<para>[Dr. Edward Wornar] Certain programs that are installed by various 
drivers and software packages can consume an incredible amount of system
resources and processing time.  One known example of such a program is
<filename>ATI2evxx.exe</filename>, a utility installed with some ATI
Technologies graphics card drivers.  <ulink
url="&atw-home;">&atw;</ulink> has information on
<filename>ATI2evxx.exe</filename> on their <ulink
url="&atw-url-tasklist-a;">&atw-title-tasklist-a;</ulink> page.  You
may want to try disabling, one-by-one,
<filename>ATI2evxx.exe</filename> and other such programs until you
find the program that is causing the slowdown.</para>
</answer>
</qandaentry>


<qandaentry>
<question id="microsoft-services-for-unix">
<para>I have Microsoft Services for Unix installed and can't type anything. 
Help me!!!</para>
</question>
<answer>
<para>Microsoft Services for Unix set some environment variables which 
points &project; to outdated or not existing files. These variables are
<screen>XAPPLRESDIR
XCMSDB
XKEYSYMDB
XNLSPATH
</screen>
To have &project; work correctly you have to unset at least <parameter>
XKEYSYMDB</parameter>. 
</para>
<para>
Reported by Juan Medina, Pavel Rozenboim
</para>
</answer>
</qandaentry>

<qandaentry>
<question id="q-tasklist-programs-slow">
<para>&project; is extremely slow, especially when using XDMCP to
connect to remote machines.</para>
</question>
<answer>
<para>see <xref linkend="poor-performance"/>.</para>
</answer>
</qandaentry>

<qandaentry>
<question id="q-trackpoint">
<para>Simulated mouse wheel scrolling doesn't work with a TrackPoint mouse
(found on IBM laptops) or Synaptics Touchpads</para>
</question>

<answer>
<para>[Gerald S. Williams] The TrackPoint driver tries to send scroll
up/down messages to the default scrollbar in a window.  &project; does
not use Windows scrollbars for X Client windows, so we must configure
the TrackPoint driver to send standard WM_MOUSEWHEEL messages to the
&project; window.  This can be done by editing the TrackPoint
configuration that can be found in the
<filename>tp4table.dat</filename> and/or
<filename>tp4scrol.dat</filename> files, which are usually located in
<filename class="directory">%SYSTEM_ROOT%\System32\</filename>,
<filename class="directory">%PROGRAMFILES%\Synaptics\SynTP\</filename> or
<filename class="directory">%PROGRAMFILES%\Lenovo\Trackpoint\</filename>.
</para>

<para>
Add the following to the <quote>Pass 0 rules</quote>section and then
restart your computer to ensure the driver reloads it's settings.
<screen>
; X Windows
*,*,XWin.exe,*,*,*,WheelStd,0,9
</screen>
</para>
</answer>
</qandaentry>

<qandaentry>
<question id="no-rootwindow-with-run">
<para>Why is the root window not shown in normal mode?</para>
</question>
<answer>
<para>This question should be obsolete.</para>
</answer>
</qandaentry>

<qandaentry>
<question id="cross-as-pointer">
<para>Why is the cross the default cursor in multiwindow mode?</para>
</question>
<answer>
<para>This question should be obsolete</para>
<para>To workaround this add the command <screen>run xsetroot -cursor_name left_ptr -fg white -bg black</screen> to <filename>startxwin.bat</filename></para>
</answer>
</qandaentry>

<qandaentry>
<question id="xterm-not-resizing">
<para>How can I adjust the linewidth in bash after resizing XTerm?</para>
</question>
<answer>
<para>We think this question is probably obsolete</para>
<para>Try starting <filename>resize</filename>.</para>
</answer>
</qandaentry>

<qandaentry>
<question id="numlock-modifier">
<para>Why do some menus not work if Num-Lock is on?</para>
</question>
<answer>
<para>The problem are programs which treat Num-Lock as modifier similar to Control. The programs expect a plain click but received some strange Num-Lock-Click combination and can't associate this with the action "open menu".</para>
</answer>
</qandaentry>

<!-- Template question and answer. 
<qandaentry>
<question id="">
<para></para>
</question>
<answer>
<para></para>
</answer>
</qandaentry>
-->

</qandadiv>
