xorg: Changes to 'xsf-docs'
xsf-docs/howto/report-bugs.mdwn | 3 +
xsf-docs/howto/triage-bugs.mdwn | 8 ++-
xsf-docs/index.mdwn | 1
xsf-docs/reference/squeeze-backports.mdwn | 65 ++++++++++++++++++++++++++++++
4 files changed, 74 insertions(+), 3 deletions(-)
New commits:
commit 9833fa5dffd02cb908309a83a44a200dcd3dd9d7
Author: Cyril Brulebois <kibi@debian.org>
Date: Mon Feb 21 04:04:06 2011 +0100
index: Link to squeeze-backports.
diff --git a/xsf-docs/index.mdwn b/xsf-docs/index.mdwn
index 3a516bd..0e30322 100644
--- a/xsf-docs/index.mdwn
+++ b/xsf-docs/index.mdwn
@@ -22,6 +22,7 @@ metapackage (under `/usr/share/doc/xorg`), starting with `wheezy`.
## Reference documentation
* [Dependencies between server and drivers](reference/dependencies.html)
+ * [Backports policy for squeeze](reference/squeeze-backports.html)
* [Upstream contacts](reference/upstream-contacts.html)
## Other documentation
commit 902ebb749f699e5bb444fe5e861335c9bcf0586d
Author: Cyril Brulebois <kibi@debian.org>
Date: Mon Feb 21 04:03:16 2011 +0100
reference/squeeze-backports: New document.
diff --git a/xsf-docs/reference/squeeze-backports.mdwn b/xsf-docs/reference/squeeze-backports.mdwn
new file mode 100644
index 0000000..89b923f
--- /dev/null
+++ b/xsf-docs/reference/squeeze-backports.mdwn
@@ -0,0 +1,65 @@
+# Backports policy for squeeze
+
+Cyril Brulebois <kibi@debian.org>
+
+
+## Proposed plans
+
+If one forgets about libraries and clients, a whole X stack boils down
+to: the server itself, input and video drivers, libdrm, and mesa.
+
+Since upgrading the server means upgrading all input and video drivers
+(more than 50 source packages), that’s certainly too much to backport,
+since we’re already trying to support `stable` (through stable
+updates), `testing`/`unstable`, and `experimental`. For example, in
+February 2011, that means `xorg-server` 1.7 in `stable`, 1.9 in
+`unstable` (and “soon” in `testing`), and 1.10 in `experimental`.
+
+So the plan is to keep `xorg-server` as it is in `squeeze` (possibly
+preparing/testing targeted fix if appropriate), and backporting
+drivers when possible. With API/ABI updates, the minimal server
+version required tend to get raised from time to time, but usually
+drivers can be built against a rather large range of server
+versions. In case a driver stop building against the server available
+in `stable`, we’ll likely stick to the highest version still building
+against it, and then tell people to upgrade the whole stack if they
+need something more recent (unless some trivial cherry-picking is
+possible, of course).
+
+The plan is to backport a few drivers on a possibly regular fashion,
+and other drivers upon request.
+
+
+### Input drivers
+
+ * `evdev`: Linux-only keyboard & mouse/pointer driver.
+ * `keyboard` and `mouse`: Needed for non-Linux ports.
+ * `synaptics`: Better touchpad support than `evdev`.
+
+
+### Video drivers
+
+ * `ati`, `mach64`, `r128`: Drivers for ATI cards.
+ * `intel`: Driver for Intel cards.
+ * `nouveau`: Driver for NVidia cards.
+ * `fbdev` and `vesa`: Generic drivers.
+ * `dummy`: Dummy driver, suitable when there’s no monitor connected.
+
+
+### Libraries
+
+The important libraries are `libdrm` and `mesa`. The former will
+likely get pulled at some point by a driver, so a backport will be
+needed for this library. The latter is under very heavy development,
+so one may want to try a new release or a snapshot without having to
+upgrade everything to `unstable`. It’s a huge package to build, so we
+[documented how to build it](../howto/build-mesa.html) locally. But
+there’s some hope to make some weekly or daily builds available at
+some point.
+
+
+### Kernel
+
+Some of those drivers might need a more recent kernel version than
+the one in `squeeze`, but hopefully it’ll be available through
+`squeeze-backports` as well.
commit a46a56813275a2c336bede0dbbd63ab54c37e6c6
Author: Cyril Brulebois <kibi@debian.org>
Date: Mon Feb 21 03:31:22 2011 +0100
report-bugs: Link to use-gdb.
diff --git a/xsf-docs/howto/report-bugs.mdwn b/xsf-docs/howto/report-bugs.mdwn
index 6fc7140..15b36df 100644
--- a/xsf-docs/howto/report-bugs.mdwn
+++ b/xsf-docs/howto/report-bugs.mdwn
@@ -21,6 +21,9 @@ Note: In case this metapackage wasn’t used to install your X stack,
report a bug against `xserver-xorg` instead. And if that one isn’t
installed either, go for `xserver-xorg-core`.
+If a backtrace shows up in the X log, it’s much appreciated to try and
+get a [full backtrace using gdb](use-gdb.html).
+
### Follow-up with more info
commit e28961893d9b141475e72d50a9dc3a4ff6eba761
Author: Cyril Brulebois <kibi@debian.org>
Date: Fri Feb 18 23:53:24 2011 +0100
triage-bugs: Mention “exclude=tag:squeeze-accepted”.
diff --git a/xsf-docs/howto/triage-bugs.mdwn b/xsf-docs/howto/triage-bugs.mdwn
index e523584..8ee3f94 100644
--- a/xsf-docs/howto/triage-bugs.mdwn
+++ b/xsf-docs/howto/triage-bugs.mdwn
@@ -49,9 +49,11 @@ Here’s an example of URL, for the last tags:
By the way one should keep an eye on the list of found/fixed
versions since those bugs are likely marked as resolved (in `unstable`
-or `experimental`), but might still affect a stable release. Maybe we
-just need to have both `squeeze-candidate` and `squeeze-accepted`, and
-swap usertags when the stable upload happens.
+or `experimental`), but might still affect a stable release.
+
+To list the bugs marked `squeeze-candidate` but not
+`squeeze-accepted`:
+→ <http://bugs.debian.org/cgi-bin/pkgreport.cgi?users=debian-x@lists.debian.org&tag=squeeze-candidate&exclude=tag:squeeze-accepted>
## Categories
Reply to: