[Ubuntu Wiki] Update of "X/Troubleshooting" by penalvch

[Ubuntu Wiki]

Dear Wiki user,

You have subscribed to a wiki page or wiki category on "Ubuntu Wiki" for change notification.

The "X/Troubleshooting" page has been changed by penalvch:
http://wiki.ubuntu.com/X/Troubleshooting?action=diff&rev1=61&rev2=62

Comment:
Initial consolidation of X/Debugging et. al. into X/Troubleshooting.

  <<Include(X/MenuBar)>>
- For hard bugs the analysis phase is the most important, and most challenging part of bug work.  Depending on how the bug is behaving, there are multiple directions to investigate the issue.  Here's some different approaches:
+ ||<tablestyle="float:right; background: #FFFFFF; margin: 0 0 1em 1em;" style="padding:2.0em;"> {{https://launchpadlibrarian.net/10142846/xswat-192.png}} ||
+ ||<tablestyle="float:right; font-size: 0.9em; width:40%; background:#F1F1ED; margin: 0 0 1em 1em;" style="padding:0.5em;"><<TableOfContents>>||
  
- === Common Problems ===
+ = Identifying if the issue is a bug or not =
+ 
+ If you aren't sure if you have encountered a software bug in Ubuntu, then you would want to seek help in determining if the issue is a bug or not from [[https://help.ubuntu.com/community/ReportingBugs|here]].
+ 
+ If you have confirmed the issue is a bug, please read on.
+ 
+ = Determining which type of bug you have =
+ 
+ Not all bugs where X seems to be the root cause are in fact an X related bug. Hence, here is documentation on potential root causes:
+ 
+ Booting
+  * [[https://help.ubuntu.com/community/BootOptions|Boot Options]]
+  * [[DebuggingKernelBoot|Debugging Kernel Boot Problems]]
+ 
+ Display Issues
+  * [[X/Troubleshooting/3D|3D / GLX corruption and other issues]]
+  * [[Kernel/Debugging/Backlight|Backlight issues]]
+  * [[X/Troubleshooting/BlankScreen|Blank Screen on startup issues]]
+  * [[X/i8xxUnsupported|i855 is Unsupported]] - Explanation of why i845, i855, i865, etc. chips aren't supported
+  * [[X/Troubleshooting/HugeFonts|Fonts displayed way too big]]
+  * [[X/Troubleshooting/Freeze|Freeze issues]]
+  * [[X/Troubleshooting/IntelPerformance|Intel graphics performance issues]]
+  * [[X/MonitorDetection|Monitor detection]]
+  * [[X/Troubleshooting/Resolution|Resolution detection]]
+  * [[X/Troubleshooting/VideoDriverDetection|Video driver detection]]
+ 
  General Issues
   * [[X/Glossary|Glossary]] - Common error messages and terminology
   * [[X/Troubleshooting/HighCPU|High CPU usage issues]]
   * [[X/Troubleshooting/HighMemory|High memory usage issues]]
+  * [[X/Bugs/Transitions|X Transitions]] - Explanation for "installing xserver-xorg-core would break existing software"
+  * [[X/Troubleshooting/XError|Program received an X Window System error]]
   * [[DebuggingKernelSuspend|Suspend and Resume issues]]
-  * [[X/Troubleshooting/XError|Program received an X Window System error]]
-  * [[X/Bugs/Transitions|X Transitions]] - Explanation for "installing xserver-xorg-core would break existing software"
- 
- Display Issues
-  * [[X/Troubleshooting/VideoDriverDetection|Video driver detection]]
-  * [[X/MonitorDetection|Monitor detection]]
-  * [[X/Troubleshooting/Resolution|Resolution detection]]
-  * [[X/Troubleshooting/Freeze|Freeze issues]]
-  * [[Kernel/Debugging/Backlight|Backlight issues]]
-  * [[X/Troubleshooting/BlankScreen|Blank Screen on startup issues]]
-  * [[X/Troubleshooting/3D|3D / GLX corruption and other issues]]
-  * [[X/Troubleshooting/HugeFonts|Fonts displayed way too big]]
-  * [[X/Troubleshooting/IntelPerformance|Intel graphics performance issues]]
-  * [[X/i8xxUnsupported|i855 is Unsupported]] - Explanation of why i845, i855, i865, etc. chips aren't supported
  
  Input Issues
+  * [[DebuggingKeyboardDetection|Keyboard detection]]
   * [[Hotkeys/Troubleshooting|Multimedia hotkey problems]]
-  * [[DebuggingKeyboardDetection|Keyboard detection]]
   * [[DebuggingTouchpadDetection|Touchpad detection]]
  
- === Troubleshooting Techniques ===
- Booting
-  * [[https://help.ubuntu.com/community/BootOptions|Boot Options]]
-  * [[DebuggingKernelBoot|Debugging Kernel Boot Problems]]
+ = Reporting a confirmed X bug to Launchpad =
+ 
+ == Initial filing of the report ==
+ 
+ First, one will want to familiarize themselves with how to report bugs effectively as per [[https://wiki.ubuntu.com/ReportingBugs|here]].
+ 
+ Once this is reviewed, please file a new bug report with Ubuntu via a terminal:
+ {{{
+ ubuntu-bug xorg
+ }}} Please ensure you have the package xdiagnose installed, and that you click the Yes button for attaching additional debugging information.
+ 
+ == Including enough information for a developer to work on it ==
+ 
+ One will want to answer the following questions: 
+  * Does the report include debugging information from the relevant article relating to the reported issue?
+  * Is this a regression?
+  * Does this happen in the latest version of Ubuntu?
+  * Does this happen in the latest version available from upstream?
+ 
+ = Debugging techniques =
+ 
   * [[X/NonGraphicalBoot|Non-Graphical Booting]] - Running X manually, without a display manager (like lightdm, kdm, gdm...)
   * [[X/Debugging/WirelessWithoutX|Wireless Without X]] - How to get a wireless network connection without X.
   * [[X/Debugging/WiredWithoutRouter|Direct Wired Without WAP]] - How to connect two laptops with direct ethernet cord.
  
- Crashes and Freezes 
+ Crashes and Freezes
   * [[X/Backtracing|X Backtracing]] - How to collect a backtrace for an X crash
-  * [[X/FixingCrashes|X Crash Fixing]] - How to fix X crashes
   * [[X/InterpretingIntelGpuDump|Interpreting GPU Dumps]] - Ringbuffers, batchbuffers, and the meaning of `intel_gpu_dump` output
   * [[X/DebuggingWithValgrind|Valgrind]] - Debugging memory leaks
  
  Other Techniques
+  * [[X/Dev/DeviceTreeHWDetection|Device Tree]]
   * [[X/Bisecting|X Bisecting]] - Using bisection techniques to solve regressions or backport fixes
   * [[X/Testing/Touch]] - Touchscreen and multi-touch testing
+ 
+ = Triaging and tagging X bugs =
+ 
+ Please see [[https://wiki.ubuntu.com/X/Triaging|here]] for more on triaging X bugs, and [[https://wiki.ubuntu.com/X/Tagging|here]] for tagging.
+ 
+ = Fixing an X crash =
+ 
+  * For more on this, please see [[https://wiki.ubuntu.com/X/FixingCrashes|here]].
-  * [[X/Quirks|X Quirks]] - Fixes for some common hardware-specific issues
+  * [[X/Quirks|X Quirks]] - Fixes for some common hardware-specific issues.
-  * [[X/Dev/DeviceTreeHWDetection|Device Tree]]
+ 
+ = Other Resources =
+ 
+  * [[https://help.ubuntu.com/community/Video|Video Resources]] at help.ubuntu.com
+  * For installing [[https://help.ubuntu.com/community/BinaryDriverHowto/AMD|fglrx]] or [[https://help.ubuntu.com/community/BinaryDriverHowto/Nvidia|nvidia]] proprietary drivers.
  
  ----
  CategoryDebugging