xorg: Changes to 'xsf-docs'
xsf-docs/faq/general.mdwn | 39 +++++++++++++++++++++++++++
xsf-docs/howtos/configure-input.mdwn | 9 ++++++
xsf-docs/index.mdwn | 6 +++-
xsf-docs/mdwn2html | 4 ++
xsf-docs/reference/upstream-contacts.mdwn | 43 ++++++++++++++++++++++++++++++
5 files changed, 99 insertions(+), 2 deletions(-)
New commits:
commit 1f8582d42b0a019b778d1cfcc53b8391e114c57d
Author: Cyril Brulebois <kibi@debian.org>
Date: Sat Feb 12 17:22:59 2011 +0100
configure-input: Mention InputHotplugGuide on the wiki.
diff --git a/xsf-docs/howtos/configure-input.mdwn b/xsf-docs/howtos/configure-input.mdwn
index bd00f3e..442dca4 100644
--- a/xsf-docs/howtos/configure-input.mdwn
+++ b/xsf-docs/howtos/configure-input.mdwn
@@ -5,6 +5,15 @@ Cyril Brulebois <kibi@debian.org>
## General considerations
+### Foreword
+
+The Debian wiki also contains an
+[inupt hotplug guide](http://wiki.debian.org/XStrikeForce/InputHotplugGuide)
+which contains some context around X’s input subsystem. The present
+document is meant to be an executive summary, and might miss some
+bits. (**FIXME:** Merge those bits.)
+
+
### Rules of thumb
In this documentation, only the last part of the driver’s name will be
commit 5b260ec96131fcbbd635ecf5c5efd4a7036f2dda
Author: Cyril Brulebois <kibi@debian.org>
Date: Sat Feb 12 17:01:00 2011 +0100
index: No need to mention “locally”.
diff --git a/xsf-docs/index.mdwn b/xsf-docs/index.mdwn
index 8bbafc0..93ed6f5 100644
--- a/xsf-docs/index.mdwn
+++ b/xsf-docs/index.mdwn
@@ -17,7 +17,7 @@ metapackage (under `/usr/share/doc/xorg`), starting with `wheezy`.
* [How to use GDB](howtos/use-gdb.html)
* [How to configure input](howtos/configure-input.html)
* [How to configure outputs](howtos/use-xrandr.html)
- * [How to build mesa locally](howtos/build-mesa.html)
+ * [How to build mesa](howtos/build-mesa.html)
## Reference documentation
commit 6f1df613b7932480830e33eb9f45677118930712
Author: Cyril Brulebois <kibi@debian.org>
Date: Sat Feb 12 16:58:18 2011 +0100
faq/general: New document.
diff --git a/xsf-docs/faq/general.mdwn b/xsf-docs/faq/general.mdwn
new file mode 100644
index 0000000..8e86196
--- /dev/null
+++ b/xsf-docs/faq/general.mdwn
@@ -0,0 +1,39 @@
+# General FAQ
+
+Cyril Brulebois <kibi@debian.org>
+
+
+## Video drivers
+
+### Intel driver
+
+ * *Why isn’t it working?*
+ KMS is mandatory, as documented in its `README.Debian` (view it
+ online:
+ [git.debian.org](http://git.debian.org/?p=pkg-xorg/driver/xserver-xorg-video-intel.git;a=blob;f=debian/README.Debian)). You
+ probably disabled KMS or didn’t include it in your kernel
+ configuration if you’re using a custom kernel.
+
+ * *X is crashing all the time with my “old” Intel card. What can I do?*
+ Unfortunately, old cards are not very well supported, and you can’t
+ do much more than switching to a generic driver, like `fbdev` or
+ `vesa`, as documented in `README.Debian` (view it online:
+ [git.debian.org](http://git.debian.org/?p=pkg-xorg/driver/xserver-xorg-video-intel.git;a=blob;f=debian/README.Debian)). Please
+ note that you need to disable `KMS` if you want to use the `vesa`
+ driver. A minimal `xorg.conf` would look like:
+
+ Section "Device"
+ Identifier "MyBuggyCard"
+ Driver "fbdev"
+ EndSection
+
+
+### Nouveau driver
+
+ * *Why isn’t it working?*
+ Since it’s still considered experimental by its authors, the
+ interfaces aren’t stable yet, so the driver has particular
+ dependencies on the kernel, which are documented in `README.Debian`
+ (view it online:
+ [for squeeze](http://git.debian.org/?p=pkg-xorg/driver/xserver-xorg-video-nouveau.git;a=blob;f=debian/README.Debian;h=27ced6b1bf5102a5b72525318439efdfb330745d;hb=6c2f12ca18f55b55d49e083d86d87d970ce53a07),
+ [for sid](http://git.debian.org/?p=pkg-xorg/driver/xserver-xorg-video-nouveau.git;a=blob;f=debian/README.Debian)).
diff --git a/xsf-docs/index.mdwn b/xsf-docs/index.mdwn
index f5b1cba..8bbafc0 100644
--- a/xsf-docs/index.mdwn
+++ b/xsf-docs/index.mdwn
@@ -6,6 +6,9 @@ These documents are shipped in the
[xserver-xorg](http://packages.debian.org/xserver-xorg&exact=1)
metapackage (under `/usr/share/doc/xorg`), starting with `wheezy`.
+## Getting started
+
+ * [General FAQ](faq/general.html)
## Howtos
commit e69f5396b84a8c21e89fc5ebb1b19eafde40d1e5
Author: Cyril Brulebois <kibi@debian.org>
Date: Fri Feb 11 12:38:57 2011 +0100
upstream-contacts: Fix mesa address.
diff --git a/xsf-docs/reference/upstream-contacts.mdwn b/xsf-docs/reference/upstream-contacts.mdwn
index 2322a13..c8b3940 100644
--- a/xsf-docs/reference/upstream-contacts.mdwn
+++ b/xsf-docs/reference/upstream-contacts.mdwn
@@ -33,7 +33,7 @@ Driver-specific:
Other:
* DRM: `dri-devel@lists.freedesktop.org`
- * Mesa: `mesa3d-dev@lists.sourceforge.net`
+ * Mesa: `mesa-dev@lists.freedesktop.org`
* Pixman: `pixman@lists.freedesktop.org`
* Wayland: `wayland-devel@lists.freedesktop.org`
* XCB: `xcb@lists.freedesktop.org`
commit b5ff94a90b19526c719ecd3815ab969d49767085
Author: Cyril Brulebois <kibi@debian.org>
Date: Thu Feb 10 22:40:21 2011 +0100
upstream-contacts: Add wayland.
diff --git a/xsf-docs/reference/upstream-contacts.mdwn b/xsf-docs/reference/upstream-contacts.mdwn
index 0a3c93a..2322a13 100644
--- a/xsf-docs/reference/upstream-contacts.mdwn
+++ b/xsf-docs/reference/upstream-contacts.mdwn
@@ -35,6 +35,7 @@ Other:
* DRM: `dri-devel@lists.freedesktop.org`
* Mesa: `mesa3d-dev@lists.sourceforge.net`
* Pixman: `pixman@lists.freedesktop.org`
+ * Wayland: `wayland-devel@lists.freedesktop.org`
* XCB: `xcb@lists.freedesktop.org`
* XKeyboardConfig/xkb-data: `xkb@listserv.bat.ru` — source:
[XKeyboardConfig](http://www.freedesktop.org/wiki/Software/XKeyboardConfig/Development)
commit 1235019427596b72a4574ac3737f8b5dcf50a260
Author: Cyril Brulebois <kibi@debian.org>
Date: Thu Feb 10 22:39:24 2011 +0100
upstream-contacts: New document.
diff --git a/xsf-docs/index.mdwn b/xsf-docs/index.mdwn
index 75fc2d1..f5b1cba 100644
--- a/xsf-docs/index.mdwn
+++ b/xsf-docs/index.mdwn
@@ -19,6 +19,7 @@ metapackage (under `/usr/share/doc/xorg`), starting with `wheezy`.
## Reference documentation
* [Dependencies between server and drivers](reference/dependencies.html)
+ * [Upstream contacts](reference/upstream-contacts.html)
## Other documentation
diff --git a/xsf-docs/reference/upstream-contacts.mdwn b/xsf-docs/reference/upstream-contacts.mdwn
new file mode 100644
index 0000000..0a3c93a
--- /dev/null
+++ b/xsf-docs/reference/upstream-contacts.mdwn
@@ -0,0 +1,42 @@
+# Upstream contacts
+
+Cyril Brulebois <kibi@debian.org>
+
+
+## Getting announcements
+
+ * Almost everything: `xorg-announce@lists.freedesktop.org`
+ * Mesa: `mesa-announce@lists.freedesktop.org`
+
+*(Source: [XorgMailingLists](http://wiki.x.org/wiki/XorgMailingLists))*
+
+
+## Developer lists
+
+
+Almost everything:
+
+ * `xorg-devel@lists.freedesktop.org` — doc:
+ [SubmittingPatches](http://wiki.x.org/wiki/Development/Documentation/SubmittingPatches)
+ — module maintainers:
+ [MAINTAINERS](http://cgit.freedesktop.org/xorg/doc/xorg-docs/tree/MAINTAINERS)
+
+Driver-specific:
+
+ * ATI: `xorg-driver-ati@lists.x.org`
+ * Intel: `intel-gfx@lists.freedesktop.org` — doc:
+ [How to file a good bug report](http://intellinuxgraphics.org/how_to_report_bug.html)
+ * Nouveau: `nouveau@lists.freedesktop.org`
+ * VMMouse & VMWare: `thellstrom@vmware.com` — source:
+ [vmware wikipage](http://wiki.x.org/wiki/vmware)
+
+Other:
+
+ * DRM: `dri-devel@lists.freedesktop.org`
+ * Mesa: `mesa3d-dev@lists.sourceforge.net`
+ * Pixman: `pixman@lists.freedesktop.org`
+ * XCB: `xcb@lists.freedesktop.org`
+ * XKeyboardConfig/xkb-data: `xkb@listserv.bat.ru` — source:
+ [XKeyboardConfig](http://www.freedesktop.org/wiki/Software/XKeyboardConfig/Development)
+
+*(Source: [XorgMailingLists](http://wiki.x.org/wiki/XorgMailingLists))*
commit a086b3d232b1a13015ba12bf03be0767ffb8fcf9
Author: Cyril Brulebois <kibi@debian.org>
Date: Thu Feb 10 21:40:32 2011 +0100
Use the unprocessed title.
diff --git a/xsf-docs/mdwn2html b/xsf-docs/mdwn2html
index 95f3a16..64c1574 100755
--- a/xsf-docs/mdwn2html
+++ b/xsf-docs/mdwn2html
@@ -17,6 +17,9 @@ if ! which markdown >/dev/null; then
exit 1
fi
+# Remember the title, assume it has no formatting:
+title=$(head -1 $mdwn|sed -e 's/^#//')
+
# Add a link back to the index:
if [ "$mdwn" != "index.mdwn" ]; then
path=$(dirname $mdwn)/
@@ -34,7 +37,6 @@ fi
markdown $mdwn.tmp > $html.tmp
# Include html headers, include title:
-title=$(head -1 $html.tmp|sed -e 's,</\?h1>,,g')
sed "s#@@title@@#$title#" > $html <<EOF
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
Reply to: