xsf-docs: Changes to 'master'

[Cyril Brulebois]

 reference/dependencies.mdwn |  101 ++--
 1 file changed, 88 insertions(+), 13 deletions(-)

New commits:
commit b80193b9126ba009f70af25d38b87a7b8f9a5d91
Author: Cyril Brulebois 
Date:   Sun Feb 6 07:37:43 2011 +0100

dependencies: Add sample control and rules files.

diff --git a/reference/dependencies.mdwn b/reference/dependencies.mdwn
index dca9156..19d4fdc 100644
--- a/reference/dependencies.mdwn
+++ b/reference/dependencies.mdwn
@@ -123,3 +123,84 @@ To make it easy to compute substvars when using `dh`, a 
`dh` sequence
 (`xsf.pm`) is shipped. As of `2:1.9.4-1`, it inserts
 `dh_xsf_substvars` right before the `dh_gencontrol` call. Other
 repetitive tasks could also be automated this way.
+
+
+## Sample driver packaging
+
+The following assumes:
+
+ * The upstream build system is sane enough, which lets us run
+   `autoreconf` at build time.
+ * It is a `video` driver. For an `input` driver, replace both
+   `xviddriver` occurrences with `xinpdriver`.
+
+### Sample debian/control file
+
+Build-Depends:
+ debhelper (>= 8),
+ dh-autoreconf,
+ quilt,
+ xserver-xorg-dev (>= 2:1.9.4),
+ …
+
+Depends:
+ ${shlibs:Depends},
+ ${misc:Depends},
+ ${xviddriver:Depends},
+Provides:
+ ${xviddriver:Provides}
+
+
+### Sample debian/rules file
+
+#!/usr/bin/make -f
+
+# Configuration:
+#override_dh_auto_configure:
+#dh_auto_configure -- --with-FOO --without-BAR
+
+# Install in debian/tmp to retain control through dh_install:
+override_dh_auto_install:
+dh_auto_install --destdir=debian/tmp
+
+# Kill *.la files, and forget no-one:
+override_dh_install:
+find debian/tmp -name '*.la' -delete
+dh_install --fail-missing
+
+## Debug package:
+#override_dh_strip:
+#dh_strip --dbg-package=xserver-xorg-video-DRIVER-dbg
+
+# That's a plugin, use appropriate warning level:
+override_dh_shlibdeps:
+dh_shlibdeps -- --warnings=6
+
+%:
+dh $@ --with quilt,autoreconf,xsf --builddirectory=build/
+
+Some comments:
+
+ * `dh_auto_configure`: Commented out since there’s usually no
+   specific option to pass when building drivers. Sometimes needed to
+   get a related utility built.
+ * `dh_auto_install`: It behaves differently when operating on a
+   single package (it installs under `debian/PACKAGE` instead of
+   `debian/tmp`), so make it use `debian/tmp` in all cases. This way,
+   `dh_install` has to be used (see below). That also means that a
+   binary package (*e.g.* a debug package) can be added without
+   changing this part.
+ * `dh_install`: No point in keeping the `.la` files. Also, using
+   `--fail-missing` makes sure every file installed by upstream is
+   installed in some package, or explicitly ignored.
+ * `dh_strip`: Commented out, there’s only a few drivers shipping a
+   debug package.
+ * `dh_shlibdeps`: The comment really says it all.
+ * `dh`: The order is important! We want patching to happen before
+   autoreconfiguring (both `quilt` and `autoreconf` insert commands
+   before `dh_auto_configure`, and after `dh_clean`). Also, we build
+   out-of-tree. The `xsf` sequence is explained in the previous part.
+
+If one needs to build several flavours,
+[`fbdev`’s rules 
file](http://git.debian.org/?p=pkg-xorg/driver/xserver-xorg-video-fbdev.git;a=blob;f=debian/rules)
+can be used as an example.

commit f87c7dad87aba4c9d0fd507b950afb61cca138ad
Author: Cyril Brulebois 
Date:   Sun Feb 6 07:37:37 2011 +0100

dependencies: Document xsf's dh sequence.

diff --git a/reference/dependencies.mdwn b/reference/dependencies.mdwn
index f6987eb..dca9156 100644
--- a/reference/dependencies.mdwn
+++ b/reference/dependencies.mdwn
@@ -119,13 +119,7 @@ variable” warning messages while building. And since 
there’s a clear
 only input-related variables for input drivers, and only video-related
 variables for video drivers.
 
-
-## Possible improvements
-
-Once we’re done implementing the above stuff in `xorg-server`, and
-getting rid of deprecated features, we can do a bit more.
-
-To make it easy to compute substvars when using `dh`, we can ship a
-`dh` sequence to insert `dh_xsf_substvars` right before the
-`dh_gencontrol` call. That sequence could also be used to automate
-other stuff.
+To make it easy to compute substvars when using `dh`, a `dh` sequence
+(`xsf.pm`) is shipped. As of `2:1.9.4-1`, it inserts
+`dh_xsf_substvars` right before the `dh_gencontrol` call. Other
+repetitive tasks could also be automated this way.

commit ac1cc074195214738677fdc1c9f1a1352f38b0e9
Author: Cyril Brulebois 
Date:   Sun Feb 6 07:37:21 2011 +0100

dependencies: Mention the version where dh_xsf_substvars appeared.

diff --git a/reference/dependencies.mdwn b/reference/dependencies.mdwn
index 8725713..f6987eb 100644
--- a/reference/dependencies.mdwn
+++ b/reference/dependencies.mdwn
@@ -95,7 +95,7 @@ tweaks afterwards if nee

xsf-docs: Changes to 'master'

[Cyril Brulebois]

 reference/dependencies.mdwn |   10 +-
 1 file changed, 5 insertions(+), 5 deletions(-)

New commits:
commit 2e7f7a324f17bdc02ea008e1c54eb3da36b08cdb
Author: Cyril Brulebois 
Date:   Tue Feb 1 18:27:36 2011 +0100

dependencies: Document what got committed.

diff --git a/reference/dependencies.mdwn b/reference/dependencies.mdwn
index fa0e816..270ad71 100644
--- a/reference/dependencies.mdwn
+++ b/reference/dependencies.mdwn
@@ -46,7 +46,6 @@ two virtual packages in the `Provides` field of the server 
(for both
 `xserver-xorg-core` and `xserver-xorg-core-udeb`): `xorg-input-abi-$x`
 and `xorg-video-abi-$y`, where `$x` and `$y` are the major part of the
 version queried through `pkg-config` variables.
-***FIXME: Currently we have both major and minor.***
 
 To handle ascending compatibility for minors, we maintain in
 `debian/serverminver` the minimal version of `xserver-xorg-core` which
@@ -66,7 +65,11 @@ Example for `xinputdep`:
 
 xorg-input-abi-11, xserver-xorg-core (>= 2:1.8.99.904)
 
-***FIXME: Lies! That's currently `xorg-input-abi-11.0, …` instead.***
+To make sure we bump the `debian/serverminver` when there’s a minor
+ABI change, there’s a `abibumpcheck` target (on which `clean`
+depends), which extracts input and video ABI from the upstream header,
+and compares them to the previous ones stored in
+`debian/serverminver`, failing and diffing is something changed.
 
 
 ### Driver’s control file
@@ -126,6 +129,3 @@ To make it easy to compute substvars when using `dh`, we 
can ship a
 `dh` sequence to insert `dh_xsf_substvars` right before the
 `dh_gencontrol` call. That sequence could also be used to automate
 other stuff.
-
-We probably should have some way of tracking ABI bumps automatically,
-to make sure we bump `serverminver` when needed.


-- 
To UNSUBSCRIBE, email to debian-x-requ...@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org
Archive: http://lists.debian.org/e1pkk0s-tr...@alioth.debian.org

xsf-docs: Changes to 'master'

[Cyril Brulebois]

 index.mdwn  |4 +
 reference/dependencies.mdwn |  131 
 xsf.css |5 +
 3 files changed, 140 insertions(+)

New commits:
commit dfb93d750512f99ecbbe8e7d97db97acb6641505
Author: Cyril Brulebois 
Date:   Tue Feb 1 13:34:52 2011 +0100

dependencies: New reference document.

diff --git a/index.mdwn b/index.mdwn
index f3e1efc..ab5e152 100644
--- a/index.mdwn
+++ b/index.mdwn
@@ -8,6 +8,10 @@
  * [How to configure input](howtos/configure-input.html)
  * [How to configure outputs](howtos/use-xrandr.html)
 
+## Reference documentation
+
+ * [Dependencies between server and drivers](reference/dependencies.html)
+
 ## Other documentation
 
  * [Upstream features](upstream-features.html)
diff --git a/reference/dependencies.mdwn b/reference/dependencies.mdwn
new file mode 100644
index 000..fa0e816
--- /dev/null
+++ b/reference/dependencies.mdwn
@@ -0,0 +1,131 @@
+# Dependencies between server and drivers
+
+Cyril Brulebois 
+
+
+## Upstream-side: ABI version numbers
+
+The X server defines several
+[ABI](http://en.wikipedia.org/wiki/Application_binary_interface) in
+`hw/xfree86/common/xf86Module.h`, through the
+`SET_ABI_VERSION(maj,min)` macro. In this document, the focus is on
+`ABI_VIDEODRV_VERSION` and `ABI_XINPUT_VERSION`, which are
+respectively about `video` drivers and `input` drivers.
+
+An example of input ABI is `12.1`, `12` being the `major`, `1` being
+the `minor`.
+
+Like in usual shared libraries, the major is bumped when interfaces
+are broken. There’s no compatibility at all in that case.
+
+The minor gets bumped when interfaces are added. In other words, if a
+driver is working with `x.y`, it should also work with higher minors:
+`x.z`; `z>y`. The converse is not true, if a driver requires a given
+minor (for example because it needs a new feature, like MultiTouch),
+it won’t work with lower minors (which didn’t provide the needed
+feature). Put another way: we have ascending compatibility with the
+minors.
+
+Conclusion: We need to keep track of both major and minor.
+
+Thanks to `pkg-config` we can query them:
+
+$ pkg-config --variable=abi_videodrv xorg-server
+9.0
+$ pkg-config --variable=abi_xinput xorg-server
+12.1
+
+
+## Debian-side: Using virtual packages
+
+### Server’s build system
+
+When `xorg-server` gets built, we use `pkg-config`’s output to
+determine the current major. Through substitution variables, we add
+two virtual packages in the `Provides` field of the server (for both
+`xserver-xorg-core` and `xserver-xorg-core-udeb`): `xorg-input-abi-$x`
+and `xorg-video-abi-$y`, where `$x` and `$y` are the major part of the
+version queried through `pkg-config` variables.
+***FIXME: Currently we have both major and minor.***
+
+To handle ascending compatibility for minors, we maintain in
+`debian/serverminver` the minimal version of `xserver-xorg-core` which
+is needed. When a minor is bumped, we store the server version in that
+file. This way, drivers built afterwards will depend on a *minimal*
+version of the driver, the last which saw a minor version bump. In
+other words: they will “depend on the server version they were built
+against, or a higher/compatible one”.
+
+Both ABI and minimal server version are recorded in two files shipped
+in `xserver-xorg-dev`, to be used while building drivers:
+
+   * `/usr/share/xserver-xorg/xinputdep`
+   * `/usr/share/xserver-xorg/videodrvdep`
+
+Example for `xinputdep`:
+
+xorg-input-abi-11, xserver-xorg-core (>= 2:1.8.99.904)
+
+***FIXME: Lies! That's currently `xorg-input-abi-11.0, …` instead.***
+
+
+### Driver’s control file
+
+Drivers also use substitution variables in their control file,
+replaced at build time.
+
+# Input driver:
+Depends: ${xinpdriver:Depends}, …
+Provides: ${xinpdriver:Provides}
+
+# Video driver:
+Depends: ${xviddriver:Depends}, …
+Provides: ${xviddriver:Provides}
+
+For now, `${xinpdriver:Provides}` is always replaced with
+`xorg-driver-input`, and `${xviddriver:Provides}` is always replaced
+with `xorg-driver-video`. Hopefully provided packages will not change,
+but using substitution variables is cheap, and makes it easy to add
+tweaks afterwards if needed.
+
+
+### Driver’s build system
+
+To set those variables, we ship a `dh_xsf_substvars` script in
+`xserver-xorg-dev` starting with ***FIXME_version***, to be run before
+`dh_gencontrol`. It iterates on the packages listed by
+`dh_listpackages` (very old `debhelper` command) and does the
+following work:
+
+ * It reads variables from the files mentioned above.
+ * If a package name ends with `-udeb`, it replaces
+   `xserver-xorg-core` with `xserver-xorg-core-udeb`.
+ * If a package name ends with `-dbg`, it does nothing for this
+   package. Debug packages usually depend strictly on the non-debug
+   packages, which in turn have appropriate dependencies.
+ * If a package name starts with `xserver-xorg-input-

xsf-docs: Changes to 'master'

[Cyril Brulebois]

 Makefile |   12 +---
 xsf.css  |   11 +++
 xsf.png  |binary
 3 files changed, 20 insertions(+), 3 deletions(-)

New commits:
commit 606f4d2384bd07938c0252ba47811fe6899a329e
Author: Cyril Brulebois 
Date:   Wed Jan 19 18:34:35 2011 +0100

css: Dirty hack to use the PNG version of the logo.

Upstream bug: https://bugzilla.mozilla.org/show_bug.cgi?id=231179

diff --git a/xsf.css b/xsf.css
index 8af2227..1b7aaf6 100644
--- a/xsf.css
+++ b/xsf.css
@@ -7,6 +7,17 @@ body {
   font-family: Georgia;
 }
 
+/* Firefox before version 4 don't support SVG in backgrounds, use a
+   ugly workaround to change the background to the PNG version for
+   Mozilla-based browsers:
+ https://bugzilla.mozilla.org/show_bug.cgi?id=231179
+*/
+@-moz-document url-prefix() {
+  body {
+background-image: url("xsf.png");
+  }
+}
+
 h1 {
   margin-left: 10px;
   color: darkblue;

commit 04b0afc1d0367b337b9f8bb53f6cad345004a8eb
Author: Cyril Brulebois 
Date:   Wed Jan 19 18:31:14 2011 +0100

logo: Commit the png version exported through inkscape.

diff --git a/xsf.png b/xsf.png
new file mode 100644
index 000..19c1ec2
Binary files /dev/null and b/xsf.png differ

commit 36b74cdb500b31ccada21751501391cf5ee76ad1
Author: Cyril Brulebois 
Date:   Wed Jan 19 18:30:29 2011 +0100

makefile: Build a png version of the logo for Firefox.

diff --git a/Makefile b/Makefile
index 12710fc..d58f249 100644
--- a/Makefile
+++ b/Makefile
@@ -10,8 +10,9 @@ MDWN_TO_HTML = ./mdwn2html
 HTML_TO_PDF  = wkhtmltopdf
 CSS_FILE = xsf.css
 SVG_LOGO = xsf.svg
+PNG_LOGO = xsf.png
 
-all: html pdf
+all: html pdf $(PNG_LOGO)
 
 html: $(html_pages)
 
@@ -23,6 +24,11 @@ pdf: $(pdf_files)
 %.pdf: %.html $(CSS_FILE) $(SVG_LOGO)
$(HTML_TO_PDF) $< $@
 
+# We usually don't need to run this one, but it's easier to keep both
+# SVN and PNG logos in sync:
+$(PNG_LOGO): $(SVG_LOGO)
+   inkscape $< -e $@
+
 clean:
@echo "Removing all generated html files"
rm -f $(html_pages) $(pdf_files)

commit 1e2012bb1676a51f76d5b3ae4619fd3b45f77bb3
Author: Cyril Brulebois 
Date:   Wed Jan 19 18:26:32 2011 +0100

makefile: No-op, rename a variable.

diff --git a/Makefile b/Makefile
index 5dfa59c..12710fc 100644
--- a/Makefile
+++ b/Makefile
@@ -9,7 +9,7 @@ pdf_files = $(patsubst %.mdwn,%.pdf,$(mdwn_pages))
 MDWN_TO_HTML = ./mdwn2html
 HTML_TO_PDF  = wkhtmltopdf
 CSS_FILE = xsf.css
-LOGO_FILE= xsf.svg
+SVG_LOGO = xsf.svg
 
 all: html pdf
 
@@ -20,7 +20,7 @@ pdf: $(pdf_files)
 %.html: %.mdwn $(MDWN_TO_HTML)
$(MDWN_TO_HTML) $< $@
 
-%.pdf: %.html $(CSS_FILE) $(LOGO_FILE)
+%.pdf: %.html $(CSS_FILE) $(SVG_LOGO)
$(HTML_TO_PDF) $< $@
 
 clean:


-- 
To UNSUBSCRIBE, email to debian-x-requ...@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org
Archive: http://lists.debian.org/e1pfbvm-0007os...@alioth.debian.org

xsf-docs: Changes to 'master'

[Cyril Brulebois]

 Makefile|3 
 howtos/triage-bugs.mdwn |6 -
 xsf.css |1 
 xsf.svg |  210 +---
 4 files changed, 186 insertions(+), 34 deletions(-)

New commits:
commit 56d61f15b89893ee40313d413294850752c83457
Author: Cyril Brulebois 
Date:   Wed Jan 19 07:11:23 2011 +0100

triage-bugs: Fix typo.

diff --git a/howtos/triage-bugs.mdwn b/howtos/triage-bugs.mdwn
index acc2fe8..e523584 100644
--- a/howtos/triage-bugs.mdwn
+++ b/howtos/triage-bugs.mdwn
@@ -65,7 +65,7 @@ Categories are
 [documented on the wiki](http://wiki.debian.org/bugs.debian.org/usertags),
 and they would probably be welcome in the `intel` and `ati` cases
 above, as well as in the “multiple tools in a single bundle”
-cases.. An example of what we could achieve is the
+cases… An example of what we could achieve is the
 [devscripts bug page](http://bugs.debian.org/devscripts) (it takes
 some time to load, plenty of bugs).
 

commit af2eec9d03172cd42fad5a124eb486a16f2966e3
Author: Cyril Brulebois 
Date:   Wed Jan 19 07:07:45 2011 +0100

triage-bugs: Cheat a bit and make the pdf look nicer.

diff --git a/howtos/triage-bugs.mdwn b/howtos/triage-bugs.mdwn
index 9e98a1a..acc2fe8 100644
--- a/howtos/triage-bugs.mdwn
+++ b/howtos/triage-bugs.mdwn
@@ -6,8 +6,8 @@ Cyril Brulebois 
 ## Packaging bugs or upstream bugs?
 
 It’d be nice to get all upstream bugs tagged as such (`upstream` tag),
-forwarded upstream ( for most packages),
-and marked as such.
+forwarded upstream (which means the bugzilla instance on
+ for most packages), and marked as such.
 
 A mail to `cont...@bugs.debian.org` would look like:
 

commit 052b9391f49e02c03f393a9e19aaf0a9da45aaff
Author: Cyril Brulebois 
Date:   Wed Jan 19 07:05:06 2011 +0100

makefile: Make pdf file generation depend on the logo.

diff --git a/Makefile b/Makefile
index 055d62e..5dfa59c 100644
--- a/Makefile
+++ b/Makefile
@@ -9,6 +9,7 @@ pdf_files = $(patsubst %.mdwn,%.pdf,$(mdwn_pages))
 MDWN_TO_HTML = ./mdwn2html
 HTML_TO_PDF  = wkhtmltopdf
 CSS_FILE = xsf.css
+LOGO_FILE= xsf.svg
 
 all: html pdf
 
@@ -19,7 +20,7 @@ pdf: $(pdf_files)
 %.html: %.mdwn $(MDWN_TO_HTML)
$(MDWN_TO_HTML) $< $@
 
-%.pdf: %.html $(CSS_FILE)
+%.pdf: %.html $(CSS_FILE) $(LOGO_FILE)
$(HTML_TO_PDF) $< $@
 
 clean:

commit 691a56ae4430ec5cd9e35585900cce2d77476df7
Author: Cyril Brulebois 
Date:   Wed Jan 19 07:05:03 2011 +0100

css: Add some top margin to the authors paragraph accordingly.

diff --git a/xsf.css b/xsf.css
index 4e57253..8af2227 100644
--- a/xsf.css
+++ b/xsf.css
@@ -64,6 +64,7 @@ code, pre {
 /* Assume it's the author(s) paragraph */
 h1 + p {
   text-align: right;
+  margin-top: 40px;
   margin-bottom: 40px;
   font-size: 90%;
 }

commit b38ac8835c4d93c28c32d85b89a372ad86982eb5
Author: Cyril Brulebois 
Date:   Wed Jan 19 07:04:55 2011 +0100

logo: Mix X and Debian logos.

diff --git a/xsf.svg b/xsf.svg
index e99d747..864a1c1 100644
--- a/xsf.svg
+++ b/xsf.svg
@@ -2,35 +2,115 @@
 
 
 http://ns.adobe.com/AdobeIllustrator/10.0/";
xmlns:dc="http://purl.org/dc/elements/1.1/";
xmlns:cc="http://creativecommons.org/ns#";
xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#";
xmlns:svg="http://www.w3.org/2000/svg";
xmlns="http://www.w3.org/2000/svg";
+   xmlns:xlink="http://www.w3.org/1999/xlink";
xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd";
xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape";
-   width="160"
-   height="20"
-   id="svg2876"
+   width="80"
+   height="80"
+   id="svg2958"
version="1.1"
inkscape:version="0.47 r22583"
-   sodipodi:docname="xsf.svg">
+   sodipodi:docname="attempt3.svg">
   
+ id="defs2960">
 
+   id="perspective2966" />
 
+
+
+
+  
+  
+
+
+
+
+
+
   
   
+ inkscape:window-maximized="0" />
   
+ id="metadata2963">
 
   
 image/svg+xml
 http://purl.org/dc/dcmitype/StillImage"; />
-
   
 
   
   
-X Strike 
Force
+ transform="translate(-288.5803,-423.06919)">
+
+
+  
+  
+
+  
+  
+  
+  
+  
+  
+  
+  
+  
+  
+  
+  
+
+  
+
   
 


-- 
To UNSUBSCRIBE, email to debian-x-requ...@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org
Archive: http://lists.debian.org/e1pfrgp-oa...@alioth.debian.org

xsf-docs: Changes to 'master'

[Cyril Brulebois]

 howtos/configure-input.mdwn |   12 ++--
 index.mdwn  |2 +-
 2 files changed, 7 insertions(+), 7 deletions(-)

New commits:
commit 34b40039267f7d8d6dab3d6b2ba054943b695b53
Author: Cyril Brulebois 
Date:   Wed Jan 19 06:34:57 2011 +0100

configure-input: Tiny fixes.

diff --git a/howtos/configure-input.mdwn b/howtos/configure-input.mdwn
index 599fb74..e705d30 100644
--- a/howtos/configure-input.mdwn
+++ b/howtos/configure-input.mdwn
@@ -29,7 +29,7 @@ configure a few settings for this or that driver. Starting 
with
 
 Some packages ship a default configuration file under
 `/usr/share/X11/xorg.conf.d` with general rules to match appropriate
-hardware. The files under `/etc/X11/xorg.conf.d` takes precedence, as
+hardware. The files under `/etc/X11/xorg.conf.d` take precedence, as
 documented in the `xorg.conf` manpage.
 
 It’s probably mostly useful in the `synaptics` case, in case one wants
@@ -52,7 +52,7 @@ Quick words about the options:
 
  * They are comma-separated.
  * The list of options and a short description for each can be found
-   in the `/usr/share/X11/xkb/rules/base.lst` file (from the
+   in the `/usr/share/X11/xkb/rules/base.lst` file (shipped by the
`xkb-data` package).
  * First option: `compose:menu`. This sets the `menu` key as the
Compose key. More information about it can be found in the
@@ -125,7 +125,7 @@ can be found in the `synaptics` manpage.
 enabling tapping (upstream kept it disabled by default, Debian won’t
 deviate, no need to file bugs): `synclient TapButton1=1`; one can also
 disable the touchpad temporarily: `synclient TouchpadOff=1` to
-disable, `synclient TouchpadOff=0` to enable it again.
+disable it, `synclient TouchpadOff=0` to enable it again.
 
 Let’s check what a configuration snippet (mentioned in **General
 considerations**) would look like. Here is a fictional
@@ -153,7 +153,7 @@ Line by line walkthrough:
vertical scrolling is enabled).
 
 Settings can also be changed by various settings managers, like
-Gnome’s, or KDE’s. An example of a graphical user interface making it
+Gnome’s or KDE’s. An example of a graphical user interface making it
 possible to set options in a clicky way: `gpointing-device-settings`.
 
 There’s a palm detection setting but that relies on hardware/firmware

commit 2d832971156071c1b34806929c692655edac23e3
Author: Cyril Brulebois 
Date:   Wed Jan 19 06:21:36 2011 +0100

index: Switch input/outputs.

I like this order better.

diff --git a/index.mdwn b/index.mdwn
index b405a9d..f3e1efc 100644
--- a/index.mdwn
+++ b/index.mdwn
@@ -5,8 +5,8 @@
  * [How to report bugs](howtos/report-bugs.html)
  * [How to triage bugs](howtos/triage-bugs.html)
  * [How to use GDB](howtos/use-gdb.html)
- * [How to configure outputs](howtos/use-xrandr.html)
  * [How to configure input](howtos/configure-input.html)
+ * [How to configure outputs](howtos/use-xrandr.html)
 
 ## Other documentation
 

commit 37dd846e363a6fa1a98362ea43008003b3a9ac95
Author: Cyril Brulebois 
Date:   Wed Jan 19 06:15:01 2011 +0100

configure-input: Fix typos.

diff --git a/howtos/configure-input.mdwn b/howtos/configure-input.mdwn
index 53262cf..599fb74 100644
--- a/howtos/configure-input.mdwn
+++ b/howtos/configure-input.mdwn
@@ -152,11 +152,11 @@ Line by line walkthrough:
button. And we enable horizontal scrolling (by default, only
vertical scrolling is enabled).
 
-Settings can also be changed by various settings manager, like
+Settings can also be changed by various settings managers, like
 Gnome’s, or KDE’s. An example of a graphical user interface making it
 possible to set options in a clicky way: `gpointing-device-settings`.
 
-There’s a palm detection setting but that relies hardware/firmware
+There’s a palm detection setting but that relies on hardware/firmware
 support for the touchpad. The other tool shipped with the `synaptics`
 driver is `syndaemon`, which makes it trivial to disable the touchpad
 temporarily, when the keyboard is being used. Here’s an example:

commit 672146f8d9ecbe0385940d771a695217d812f066
Author: Cyril Brulebois 
Date:   Wed Jan 19 06:12:36 2011 +0100

index: Fix typo.

diff --git a/index.mdwn b/index.mdwn
index 8f907a2..b405a9d 100644
--- a/index.mdwn
+++ b/index.mdwn
@@ -6,7 +6,7 @@
  * [How to triage bugs](howtos/triage-bugs.html)
  * [How to use GDB](howtos/use-gdb.html)
  * [How to configure outputs](howtos/use-xrandr.html)
- * [How to configure intput](howtos/configure-input.html)
+ * [How to configure input](howtos/configure-input.html)
 
 ## Other documentation
 


-- 
To UNSUBSCRIBE, email to debian-x-requ...@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org
Archive: http://lists.debian.org/e1pfqhc-0003eq...@alioth.debian.org

xsf-docs: Changes to 'master'

[Cyril Brulebois]

 howtos/configure-input.mdwn |7 ++-
 howtos/report-bugs.mdwn |3 +++
 howtos/triage-bugs.mdwn |3 +++
 howtos/use-gdb.mdwn |3 +++
 howtos/use-xrandr.mdwn  |3 +++
 upstream-features.mdwn  |7 +--
 xsf.css |   13 +
 7 files changed, 36 insertions(+), 3 deletions(-)

New commits:
commit 3b03f91176be423feb7731c27313f06b3c4ce518
Author: Cyril Brulebois 
Date:   Wed Jan 19 06:07:58 2011 +0100

upstream-features: Fix typo.

Kill an extra whitespace while I'm at it.

diff --git a/upstream-features.mdwn b/upstream-features.mdwn
index d164c39..4c22559 100644
--- a/upstream-features.mdwn
+++ b/upstream-features.mdwn
@@ -5,12 +5,12 @@ Cyril Brulebois 
 
 Let’s collect links where one can learn more about features. It might
 make sense to ask permission to (re)use those and merge them into this
-package, in case the hostinsg sites go offline.
+package, in case the hosting sites go offline.
 
 ## Multitouch/touchpads
 
 Touchpad features, by Peter Hutterer:  
 → 

 
-What multitouch really is about, by Peter Hutterer:   
+What multitouch really is about, by Peter Hutterer:  
 → 

commit e858333b25ed34b2edc8c34489af66077efed622
Author: Cyril Brulebois 
Date:   Wed Jan 19 06:00:40 2011 +0100

configure-input: Add a warning about syndaemon.

diff --git a/howtos/configure-input.mdwn b/howtos/configure-input.mdwn
index 8ec1fdf..53262cf 100644
--- a/howtos/configure-input.mdwn
+++ b/howtos/configure-input.mdwn
@@ -162,4 +162,6 @@ driver is `syndaemon`, which makes it trivial to disable 
the touchpad
 temporarily, when the keyboard is being used. Here’s an example:
 `syndaemon -d -i 0.5` makes `syndaemon` start in background (`-d` for
 daemon mode), waiting 0.5 second before enabling the touchpad again
-after the last keypress.
+after the last keypress. Warning: it becomes quite difficult to use
+things like `Ctrl+click` in a browser, or `Alt+drag` to move
+windows.

commit 2c4b565efe72f6401cafb45c802090cc6df5256d
Author: Cyril Brulebois 
Date:   Wed Jan 19 05:55:45 2011 +0100

css: Authors are not that important, decrease font size.

diff --git a/xsf.css b/xsf.css
index 8c80293..4e57253 100644
--- a/xsf.css
+++ b/xsf.css
@@ -65,4 +65,5 @@ code, pre {
 h1 + p {
   text-align: right;
   margin-bottom: 40px;
+  font-size: 90%;
 }

commit 1ebbf8bfa9d0b97970ef6d55d4ea36d494a325c5
Author: Cyril Brulebois 
Date:   Wed Jan 19 05:50:07 2011 +0100

all: Add an author line.

Markdown is a bit annoying since it doesn't seem to allow escaping the
‘<’ character, and  makes a clickable link. Use the following trick
to display mail addresses properly:



(One could use > at the end for symmetry.)

In case of multiple authors, one can use:





diff --git a/howtos/configure-input.mdwn b/howtos/configure-input.mdwn
index e655026..8ec1fdf 100644
--- a/howtos/configure-input.mdwn
+++ b/howtos/configure-input.mdwn
@@ -1,5 +1,8 @@
 # How to configure input
 
+Cyril Brulebois 
+
+
 ## General considerations
 
 ### Rules of thumb
diff --git a/howtos/report-bugs.mdwn b/howtos/report-bugs.mdwn
index 01652d4..03cc13b 100644
--- a/howtos/report-bugs.mdwn
+++ b/howtos/report-bugs.mdwn
@@ -1,5 +1,8 @@
 # How to report bugs
 
+Cyril Brulebois 
+
+
 ## Simple as reportbug
 
 ### Initial report
diff --git a/howtos/triage-bugs.mdwn b/howtos/triage-bugs.mdwn
index ca551fe..9e98a1a 100644
--- a/howtos/triage-bugs.mdwn
+++ b/howtos/triage-bugs.mdwn
@@ -1,5 +1,8 @@
 # How to triage bugs
 
+Cyril Brulebois 
+
+
 ## Packaging bugs or upstream bugs?
 
 It’d be nice to get all upstream bugs tagged as such (`upstream` tag),
diff --git a/howtos/use-gdb.mdwn b/howtos/use-gdb.mdwn
index a2927e5..648c867 100644
--- a/howtos/use-gdb.mdwn
+++ b/howtos/use-gdb.mdwn
@@ -1,5 +1,8 @@
 # How to use gdb
 
+Cyril Brulebois 
+
+
 ## Foreword
 
 One should note that X is responsible for VT switching, meaning
diff --git a/howtos/use-xrandr.mdwn b/howtos/use-xrandr.mdwn
index 3c161ad..a3293a0 100644
--- a/howtos/use-xrandr.mdwn
+++ b/howtos/use-xrandr.mdwn
@@ -1,5 +1,8 @@
 # How to use xrandr
 
+Cyril Brulebois 
+
+
 ## Getting started
 
 ### What is xrandr?
diff --git a/upstream-features.mdwn b/upstream-features.mdwn
index 9377968..d164c39 100644
--- a/upstream-features.mdwn
+++ b/upstream-features.mdwn
@@ -1,5 +1,8 @@
 # Upstream features
 
+Cyril Brulebois 
+
+
 Let’s collect links where one can learn more about features. It might
 make sense to ask permission to (re)use those and merge them into this
 package, in case the hostinsg sites go offline.

commit b5c7fdca602b28b664535b238485b7ae1db0a97d
Author: Cyril B

xsf-docs: Changes to 'master'

[Cyril Brulebois]

 Makefile|3 
 howtos/configure-input.mdwn |  162 
 index.mdwn  |1 
 xsf.css |4 +
 4 files changed, 169 insertions(+), 1 deletion(-)

New commits:
commit 2752cbe66aefb944dd09aa69b0cedbc047f256b2
Author: Cyril Brulebois 
Date:   Wed Jan 19 04:57:49 2011 +0100

configure-input: Mention gpointing-device-settings and syndaemon.

diff --git a/howtos/configure-input.mdwn b/howtos/configure-input.mdwn
index 9afde8c..e655026 100644
--- a/howtos/configure-input.mdwn
+++ b/howtos/configure-input.mdwn
@@ -148,3 +148,15 @@ Line by line walkthrough:
  * Finally the options we want to set. We enable tapping for the first
button. And we enable horizontal scrolling (by default, only
vertical scrolling is enabled).
+
+Settings can also be changed by various settings manager, like
+Gnome’s, or KDE’s. An example of a graphical user interface making it
+possible to set options in a clicky way: `gpointing-device-settings`.
+
+There’s a palm detection setting but that relies hardware/firmware
+support for the touchpad. The other tool shipped with the `synaptics`
+driver is `syndaemon`, which makes it trivial to disable the touchpad
+temporarily, when the keyboard is being used. Here’s an example:
+`syndaemon -d -i 0.5` makes `syndaemon` start in background (`-d` for
+daemon mode), waiting 0.5 second before enabling the touchpad again
+after the last keypress.

commit 46b76a70995e505751f7aa247843bfff8250911b
Author: Cyril Brulebois 
Date:   Wed Jan 19 04:48:00 2011 +0100

configure-input: Mention synaptics configuration.

diff --git a/howtos/configure-input.mdwn b/howtos/configure-input.mdwn
index 9a6cf72..9afde8c 100644
--- a/howtos/configure-input.mdwn
+++ b/howtos/configure-input.mdwn
@@ -109,3 +109,42 @@ Line by line walkthrough:
emulation (clicking left and right buttons at the same time then no
longer acts as if the middle button was clicked). Then we swap x
and y axes, just for the fun of it.
+
+
+### synaptics configuration
+
+The `synaptics` driver comes with two tools. The more interesting one
+is `synclient`, which can be used to list available options and
+current settings: `synclient -l`. The documentation for each option
+can be found in the `synaptics` manpage.
+
+`synclient` can also be used to set options. A common example is
+enabling tapping (upstream kept it disabled by default, Debian won’t
+deviate, no need to file bugs): `synclient TapButton1=1`; one can also
+disable the touchpad temporarily: `synclient TouchpadOff=1` to
+disable, `synclient TouchpadOff=0` to enable it again.
+
+Let’s check what a configuration snippet (mentioned in **General
+considerations**) would look like. Here is a fictional
+`/etc/X11/xorg.conf.d/42-synaptics.conf`:
+
+Section "InputClass"
+Identifier "touchpad tweaked catchall"
+MatchIsTouchpad "on"
+Driver "synaptics"
+Option "TapButton1" "1"
+Option "HorizEdgeScroll" "1"
+EndSection
+
+Line by line walkthrough:
+
+ * To avoid specifying any device under `/dev/input` (`event$N` might
+   change, remember it’s about hotplug support!), we use an
+   `InputClass`.
+ * We need an identifier, the actual name doesn‘t matter.
+ * We match everything that looks like a touchpad. Meaning no generic
+   pointer, keyboard, or tablet.
+ * We specify the driver we want to use for the matched device(s).
+ * Finally the options we want to set. We enable tapping for the first
+   button. And we enable horizontal scrolling (by default, only
+   vertical scrolling is enabled).

commit d23d7ed275334585adccef0928c7b6b65ddcb541
Author: Cyril Brulebois 
Date:   Wed Jan 19 04:25:33 2011 +0100

configure-input: Mention evdev configuration.

diff --git a/howtos/configure-input.mdwn b/howtos/configure-input.mdwn
index 07a2359..9a6cf72 100644
--- a/howtos/configure-input.mdwn
+++ b/howtos/configure-input.mdwn
@@ -24,9 +24,14 @@ configure a few settings for this or that driver. Starting 
with
 `/etc/X11/xorg.conf.d`, with a `.conf` suffix, as documented in the
 `xorg.conf` manpage.
 
+Some packages ship a default configuration file under
+`/usr/share/X11/xorg.conf.d` with general rules to match appropriate
+hardware. The files under `/etc/X11/xorg.conf.d` takes precedence, as
+documented in the `xorg.conf` manpage.
+
 It’s probably mostly useful in the `synaptics` case, in case one wants
-to change default settings on a system-wide fashion. See the mouse
-section below for an example.
+to change default settings on a system-wide fashion. See the **Pointer
+configuration** section below for an example.
 
 
 ## Basic keyboard configuration
@@ -73,3 +78,34 @@ How does it propagate to X?
`invoke-rc.d udev restart` changes nothing, one has to use
`udevadm`. Properties can be inspected through:
`/sbin/udevadm info --export-db`
+
+
+## Pointer configuration
+
+### evdev configuration
+
+Available options are documen

xsf-docs: Changes to 'master'

[Cyril Brulebois]

 howtos/triage-bugs.mdwn |8 ++--
 index.mdwn  |4 
 upstream-features.mdwn  |   13 +
 3 files changed, 23 insertions(+), 2 deletions(-)

New commits:
commit f866a9ff7dd544adcb4e43a53e3e912a1c9931ea
Author: Cyril Brulebois 
Date:   Wed Jan 19 00:16:03 2011 +0100

Add some links to explanations of upstream features.

diff --git a/index.mdwn b/index.mdwn
index 61496b9..0b77258 100644
--- a/index.mdwn
+++ b/index.mdwn
@@ -7,6 +7,10 @@
  * [How to use GDB](howtos/use-gdb.html)
  * [How to configure outputs](howtos/use-xrandr.html)
 
+## Other documentation
+
+ * [Upstream features](upstream-features.html)
+
 ## Feedback
 
  * Sources for those documents are available on
diff --git a/upstream-features.mdwn b/upstream-features.mdwn
new file mode 100644
index 000..9377968
--- /dev/null
+++ b/upstream-features.mdwn
@@ -0,0 +1,13 @@
+# Upstream features
+
+Let’s collect links where one can learn more about features. It might
+make sense to ask permission to (re)use those and merge them into this
+package, in case the hostinsg sites go offline.
+
+## Multitouch/touchpads
+
+Touchpad features, by Peter Hutterer:  
+→ 

+
+What multitouch really is about, by Peter Hutterer:   
+→ 

commit fdaba1b173c22686db78b80a3f15705db9ffba65
Author: Cyril Brulebois 
Date:   Mon Jan 17 17:59:05 2011 +0100

triage-bugs: Add needs-forwarding usertag.

diff --git a/howtos/triage-bugs.mdwn b/howtos/triage-bugs.mdwn
index 1bd7e43..ca551fe 100644
--- a/howtos/triage-bugs.mdwn
+++ b/howtos/triage-bugs.mdwn
@@ -36,9 +36,13 @@ Let’s give some examples:
of teeny tiny apps).
  * `squeeze-candidate`: helps keeping a list of bugs we’d like to get
fixed in a point release (through a stable update).
+ * `needs-forwarding`: of course, it’d be nice to have all upstream
+   bugs reported upstream, but some might need special attention
+   (*e.g.* security bugs).
 
-Here’s an example of URL, for the last tag:  
-→ 

+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`


-- 
To UNSUBSCRIBE, email to debian-x-requ...@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org
Archive: http://lists.debian.org/e1pfkml-000815...@alioth.debian.org

xsf-docs: Changes to 'master'

[Cyril Brulebois]

 COPYING |2 +-
 howtos/triage-bugs.mdwn |   15 ---
 2 files changed, 9 insertions(+), 8 deletions(-)

New commits:
commit 02cd64954129ab9d0d118b8eaed6319001c5ec99
Author: Cyril Brulebois 
Date:   Sun Jan 16 05:41:20 2011 +0100

triage-bugs: Fix typo.

diff --git a/howtos/triage-bugs.mdwn b/howtos/triage-bugs.mdwn
index bc1f340..1bd7e43 100644
--- a/howtos/triage-bugs.mdwn
+++ b/howtos/triage-bugs.mdwn
@@ -67,7 +67,7 @@ Needed steps for that to happen:
  * create usercategories.
  * move usertags from `debian-x@lists.debian.org` to
`$pack...@packages.debian.org`, probably using the `bts select`
-   command to get the list over which to iterate:
+   command to get the list over which to iterate.
  * profit!
 
 To move the usertags, something like that should do the job:

commit 6104e658be13d987a52cc41394b1df81c8004e65
Author: Cyril Brulebois 
Date:   Sun Jan 16 05:40:18 2011 +0100

triage-bugs: Rephrase to get a nicer pdf output.

diff --git a/howtos/triage-bugs.mdwn b/howtos/triage-bugs.mdwn
index 116cad6..bc1f340 100644
--- a/howtos/triage-bugs.mdwn
+++ b/howtos/triage-bugs.mdwn
@@ -22,9 +22,9 @@ Another feature of the BTS is usertagging. That lets people 
keep track
 of additional tags, “attached” to a given mail address. For XSF,
 that’s `debian-x@lists.debian.org`.
 
-The list of all usertagged bugs can be seen on:
-;
-the list of all used usertags is at the bottom, in the form.
+The list of all usertagged bugs can be seen on the following page; the
+list of all used usertags is at the bottom, in the form.  
+→ 
 
 Let’s give some examples:
 
@@ -37,9 +37,10 @@ Let’s give some examples:
  * `squeeze-candidate`: helps keeping a list of bugs we’d like to get
fixed in a point release (through a stable update).
 
-Here’s an example of URL, for the last tag:
-
-— by the way one should keep an eye on the list of found/fixed
+Here’s an example of URL, for the last tag:  
+→ 

+
+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

commit ef38a624037363f8958158489920d516a55cb907
Author: Cyril Brulebois 
Date:   Sun Jan 16 04:53:43 2011 +0100

copyright: Update years.

diff --git a/COPYING b/COPYING
index 2f50c7f..31eda94 100644
--- a/COPYING
+++ b/COPYING
@@ -1,4 +1,4 @@
-© 2010 Cyril Brulebois 
+© 2010-2011 Cyril Brulebois 
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal


-- 
To UNSUBSCRIBE, email to debian-x-requ...@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org
Archive: http://lists.debian.org/e1pel9z-0003bw...@alioth.debian.org

xsf-docs: Changes to 'master'

[Cyril Brulebois]

 .gitignore  |2 +
 howtos/triage-bugs.mdwn |   85 
 index.mdwn  |1 
 3 files changed, 88 insertions(+)

New commits:
commit 6d9bde40c5dfe71e841f9dfb2a47f14e3e244def
Author: Cyril Brulebois 
Date:   Sun Jan 16 04:19:00 2011 +0100

index: Link to triage-bugs.

diff --git a/index.mdwn b/index.mdwn
index 602d3ff..61496b9 100644
--- a/index.mdwn
+++ b/index.mdwn
@@ -3,6 +3,7 @@
 ## Howtos
 
  * [How to report bugs](howtos/report-bugs.html)
+ * [How to triage bugs](howtos/triage-bugs.html)
  * [How to use GDB](howtos/use-gdb.html)
  * [How to configure outputs](howtos/use-xrandr.html)
 

commit 2d27e73ab5b6ebb47aeacf514dc3332d6663ad3f
Author: Cyril Brulebois 
Date:   Sun Jan 16 04:17:54 2011 +0100

triage-bugs: Add ideas about categories.

diff --git a/howtos/triage-bugs.mdwn b/howtos/triage-bugs.mdwn
index f3b0ab6..116cad6 100644
--- a/howtos/triage-bugs.mdwn
+++ b/howtos/triage-bugs.mdwn
@@ -39,3 +39,47 @@ Let’s give some examples:
 
 Here’s an example of URL, for the last tag:
 

+— 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.
+
+
+## Categories
+
+The BTS has yet another feature which can help, categories. That’s
+based on usertags as well, but one has to use the package address
+(`$pack...@packages.debian.org`), so that’s package-specific rather
+than team-specific.
+
+Categories are
+[documented on the wiki](http://wiki.debian.org/bugs.debian.org/usertags),
+and they would probably be welcome in the `intel` and `ati` cases
+above, as well as in the “multiple tools in a single bundle”
+cases.. An example of what we could achieve is the
+[devscripts bug page](http://bugs.debian.org/devscripts) (it takes
+some time to load, plenty of bugs).
+
+Needed steps for that to happen:
+
+ * create usercategories.
+ * move usertags from `debian-x@lists.debian.org` to
+   `$pack...@packages.debian.org`, probably using the `bts select`
+   command to get the list over which to iterate:
+ * profit!
+
+To move the usertags, something like that should do the job:
+
+# Adding usertags:
+user $packa...@packages.debian.org
+usertag X xset
+usertag Y xrandr
+user $packa...@packages.debian.org
+usertag Z i810
+
+# Removing tags which are no longer needed:
+user debian-x@lists.debian.org
+usertag X - xset
+usertag Y - xrandr
+usertag Z - i810

commit b2d02575579b921452726e22f8d0124736e3a703
Author: Cyril Brulebois 
Date:   Sun Jan 16 04:17:36 2011 +0100

triage-bugs: Cosmetics.

diff --git a/howtos/triage-bugs.mdwn b/howtos/triage-bugs.mdwn
index a226a07..f3b0ab6 100644
--- a/howtos/triage-bugs.mdwn
+++ b/howtos/triage-bugs.mdwn
@@ -4,11 +4,16 @@
 
 It’d be nice to get all upstream bugs tagged as such (`upstream` tag),
 forwarded upstream ( for most packages),
-and marked as such
-(`forwarded X https://bugs.freedesktop.org/show_bug.cgi?id=Y`).
+and marked as such.
 
-Then `bts-link` comes into play and help us tracking upstream status,
-which is pretty nice to have.
+A mail to `cont...@bugs.debian.org` would look like:
+
+tag X upstream
+forwarded X https://bugs.freedesktop.org/show_bug.cgi?id=Y
+thanks
+
+Then [`bts-link`](http://bts-link.alioth.debian.org/) comes into play
+and help us tracking upstream status, which is pretty nice to have.
 
 
 ## Usertags

commit 613163f6b97d1b2822515a37fdc4f0408e44fb60
Author: Cyril Brulebois 
Date:   Sun Jan 16 03:48:35 2011 +0100

Ignore generated html and pdf files.

diff --git a/.gitignore b/.gitignore
new file mode 100644
index 000..23f832b
--- /dev/null
+++ b/.gitignore
@@ -0,0 +1,2 @@
+*.html
+*.pdf

commit 700dfdef3d2a83e09f1c5b11ba5012ec0bd338e1
Author: Cyril Brulebois 
Date:   Sun Jan 16 03:47:44 2011 +0100

Start a doc about bug triaging.

diff --git a/howtos/triage-bugs.mdwn b/howtos/triage-bugs.mdwn
new file mode 100644
index 000..a226a07
--- /dev/null
+++ b/howtos/triage-bugs.mdwn
@@ -0,0 +1,36 @@
+# How to triage bugs
+
+## Packaging bugs or upstream bugs?
+
+It’d be nice to get all upstream bugs tagged as such (`upstream` tag),
+forwarded upstream ( for most packages),
+and marked as such
+(`forwarded X https://bugs.freedesktop.org/show_bug.cgi?id=Y`).
+
+Then `bts-link` comes into play and help us tracking upstream status,
+which is pretty nice to have.
+
+
+## Usertags
+
+Another feature of the BTS is usertagging. That lets people keep track
+of additional tags, “attached” to a given mail address. For XSF,
+that’s `debian-x@lists.debian.org`.
+
+The list of all usertagged bugs ca

xsf-docs: Changes to 'master'

[Cyril Brulebois]

 howtos/use-xrandr.mdwn |  170 +
 index.mdwn |1 
 xsf.css|8 ++
 3 files changed, 179 insertions(+)

New commits:
commit 381eeb55a710ad83a899ce9b7558493f7cda96dc
Author: Cyril Brulebois 
Date:   Thu Dec 2 13:49:26 2010 +0100

Continue typing.

diff --git a/howtos/use-xrandr.mdwn b/howtos/use-xrandr.mdwn
index 5a3d45b..3c161ad 100644
--- a/howtos/use-xrandr.mdwn
+++ b/howtos/use-xrandr.mdwn
@@ -140,3 +140,31 @@ should configure your `xorg.conf` by adding a `Virtual` 
line to the
   EndSubSection
 EndSection
 
+### Place outputs
+
+Outputs are placed using the following options:
+`--right-of`/`--left-of`/`--above`/`--below`. For instance, to place
+the `VGA1` output virtually-right of the internal panel (`LVDS1`):
+
+$ xrandr --output VGA1 --right-of LVDS1
+
+Note that hardware and memory limitations may severely restrict the
+size of your virtual screen, see the Caveats section below.
+
+## Adding new modes
+
+Under some circumstances, some modes might be missing. For instance,
+if the monitor does not report correct EDID information. Or if the
+output didn't have a CRTC available at startup because another output
+was using it and you disabled it in the meantime.
+
+If a mode exist, you may add it to one output with:
+
+$ xrandr --addmode VGA1 800x600
+
+If the mode does not exist, you may first create it by passing a modeline:
+
+$ xrandr --newmode 
+
+You may create a modeline using the `gtf` or `cvt` tools (shipped in
+the `xserver-xorg-core` package).

commit 87e2ac28207ca023b45e8241259500b1d38623ae
Author: Cyril Brulebois 
Date:   Thu Dec 2 13:17:47 2010 +0100

Restructure the document.

diff --git a/howtos/use-xrandr.mdwn b/howtos/use-xrandr.mdwn
index 5f90f5d..5a3d45b 100644
--- a/howtos/use-xrandr.mdwn
+++ b/howtos/use-xrandr.mdwn
@@ -1,6 +1,8 @@
 # How to use xrandr
 
-## What is xrandr?
+## Getting started
+
+### What is xrandr?
 
 `xrandr` is a command-line tool to interact with the X `RandR`
 extension [see [x.org](http://www.x.org/wiki/Projects/XRandR),
@@ -12,15 +14,13 @@ etc.) together with the ability to configure outputs 
dynamically
 
 **FIXME: Status across drivers?**
 
-## What about xorg.conf?
+### What consequences for xorg.conf?
 
 Starting with `squeeze`, removing the `xorg.conf` configuration file
 entirely should work well enough, but in case that doesn’t work out,
 let’s document what can be removed from it from a `RandR` point of
 view.
 
-### Mode detection
-
 With the driver detecting modes automatically, several configuration
 options become useless most of the time in your configuration file
 (xorg.conf). You might want to remove:
@@ -29,7 +29,8 @@ options become useless most of the time in your configuration 
file
  * Modes from `Display` subsection in `Screen` section.
  * `ModeLine` from the `Monitor` section.
 
-### Static dual-head configuration
+There’s also no need to keep static dual-head configuration. Some
+suggestions to get a tiny `xorg.conf`:
 
  * Drop dual `Device`/`Screen`/`Monitor` sections, a single one is
needed.
@@ -39,10 +40,7 @@ options become useless most of the time in your 
configuration file
  * Drop `RightOf`/`LeftOf` indication of the remaining `Screen` line
in `ServerLayout` section.
 
-## Using xrandr
-
-### Basics
-
+## Basic xrandr usage
 
 Once the configuration file (`xorg.conf`) is removed or updated,
 starting the server should enable some outputs by default. Their
@@ -114,7 +112,9 @@ To get back to the default mode:
 
 $ xrandr --output LVDS1 --auto
 
-### Placing outputs in a virtual screen
+## Placing outputs in a virtual screen
+
+### A bit of configuration for non-KMS setups:
 
 Let’s have a look at the maximal virtual screen size, we see
 `4096x4096` in this example:

commit 26cb076a2e2695f3ee590506e1ea07891d53a394
Author: Cyril Brulebois 
Date:   Thu Dec 2 13:12:25 2010 +0100

More stuff.

diff --git a/howtos/use-xrandr.mdwn b/howtos/use-xrandr.mdwn
index 8384027..5f90f5d 100644
--- a/howtos/use-xrandr.mdwn
+++ b/howtos/use-xrandr.mdwn
@@ -96,3 +96,47 @@ This may be useful for some buggy application that don’t 
support
 multiple outputs well. Also, due to CRTC limitations (see the Caveats
 section below), it is often required to disable one output before
 enabling another since most hardware only support 2 at the same time.
+
+### Changing the mode
+
+With the above `xrandr` output, you may change the `LVDS1` mode to
+`1024x768` using:
+
+$ xrandr --output LVDS1 --mode 1024x768
+
+The refresh rate may also be changed, either at the same time or
+independently:
+
+$ xrandr --output LVDS1 --mode 1024x768 --rate 75
+$ xrandr --output LVDS1 --rate 75
+
+To get back to the default mode:
+
+$ xrandr --output LVDS1 --auto
+
+### Placing outputs in a virtual screen
+
+Let’s have a look at the maximal virtual screen size, we see
+`4096x4096` in this example:
+
+$ xrandr|head -1
+Screen 0: mini

xsf-docs: Changes to 'master'

[Cyril Brulebois]

 COPYING   |   19 +++
 mdwn2html |1 +
 2 files changed, 20 insertions(+)

New commits:
commit 0d56fca1617970c3d636b5a2647c3a8ce00ae670
Author: Cyril Brulebois 
Date:   Wed Dec 1 22:42:17 2010 +0100

Specify content type through a meta tag.

Apparently, iceweasel-4.0b7 is stupid enough to be unable to read the
declared encoding in the XML header. Sigh.

diff --git a/mdwn2html b/mdwn2html
index d55c672..6d9d7e2 100755
--- a/mdwn2html
+++ b/mdwn2html
@@ -30,6 +30,7 @@ sed "s#@@title@@#$title#" > $html <@@title@@
 
 
+
 
 
 EOF

commit cccaae01e00e762e36c7bd4cbc40d160156e3484
Author: Cyril Brulebois 
Date:   Wed Dec 1 22:36:25 2010 +0100

Add a COPYING file, with MIT/X licensing.

diff --git a/COPYING b/COPYING
new file mode 100644
index 000..2f50c7f
--- /dev/null
+++ b/COPYING
@@ -0,0 +1,19 @@
+© 2010 Cyril Brulebois 
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.


-- 
To UNSUBSCRIBE, email to debian-x-requ...@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org
Archive: http://lists.debian.org/e1pnuv3-0003gh...@alioth.debian.org

xsf-docs: Changes to 'master'

[Cyril Brulebois]

 Makefile   |9 ++---
 index.mdwn |   10 +-
 2 files changed, 15 insertions(+), 4 deletions(-)

New commits:
commit ccca5296481e7916057d5b2557a2d726dbeae5c5
Author: Cyril Brulebois 
Date:   Wed Dec 1 22:06:18 2010 +0100

Document how we appreciate feedback.

diff --git a/index.mdwn b/index.mdwn
index 966d944..24e4f5d 100644
--- a/index.mdwn
+++ b/index.mdwn
@@ -4,3 +4,10 @@
 
  * [How to report bugs](howtos/report-bugs.html)
  * [How to use GDB](howtos/use-gdb.html)
+
+## Feedback
+
+ * Sources for those documents are available on
+   [git.debian.org](http://git.debian.org/?p=pkg-xorg/debian/xsf-docs.git).
+ * Patches, suggestions, flames, etc. are welcome, using the
+   [debian-x](http://lists.debian.org/debian-x/) mailing list.

commit a29508790e4dbb7c97349d1c1bb636da47f21e48
Author: Cyril Brulebois 
Date:   Wed Dec 1 21:59:59 2010 +0100

Add a link to report-bugs from the index.

diff --git a/index.mdwn b/index.mdwn
index bb676e7..966d944 100644
--- a/index.mdwn
+++ b/index.mdwn
@@ -2,4 +2,5 @@
 
 ## Howtos
 
-[How to use GDB](howtos/use-gdb.html)
+ * [How to report bugs](howtos/report-bugs.html)
+ * [How to use GDB](howtos/use-gdb.html)

commit 4023140982f45230799133d0ded1193eff092c93
Author: Cyril Brulebois 
Date:   Wed Dec 1 21:59:43 2010 +0100

Make it possible to build either html or pdf.

diff --git a/Makefile b/Makefile
index 347d9e4..3ab3881 100644
--- a/Makefile
+++ b/Makefile
@@ -9,8 +9,11 @@ pdf_files = $(patsubst %.mdwn,%.pdf,$(mdwn_pages))
 MDWN_TO_HTML = ./mdwn2html
 HTML_TO_PDF  = wkhtmltopdf
 
-all: $(html_pages) $(pdf_files)
-   @echo "All done."
+all: html pdf
+
+html: $(html_pages)
+
+pdf: $(pdf_files)
 
 %.html: %.mdwn $(MDWN_TO_HTML)
$(MDWN_TO_HTML) $< $@
@@ -23,4 +26,4 @@ clean:
rm -f $(html_pages) $(pdf_files)
 
 
-.PHONY: clean
+.PHONY: clean html pdf all


-- 
To UNSUBSCRIBE, email to debian-x-requ...@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org
Archive: http://lists.debian.org/e1pntsn-0004hf...@alioth.debian.org

xsf-docs: Changes to 'master'

[Cyril Brulebois]

New branch 'master' available with the following commits:
commit 3fdfc1d41f3114aef6c9625c9fd9b21ec467cfe3
Author: Cyril Brulebois 
Date:   Wed Dec 1 21:29:24 2010 +0100

Adjust titles.

commit 435daeaac8cffddc1f153c15682dff8bf485ba04
Author: Cyril Brulebois 
Date:   Wed Dec 1 21:25:05 2010 +0100

Adjust colours.

commit 751107c30ae2ab6a47f8f1fa0edb7f7f194d4619
Author: Cyril Brulebois 
Date:   Wed Dec 1 21:06:17 2010 +0100

Mention xserver-xorg-core-dbg as needed package.

commit f109019104c3d42b523a6d050719f7cd2ba72e9b
Author: Cyril Brulebois 
Date:   Wed Dec 1 20:58:49 2010 +0100

Re-order stuff in the CSS.

commit 27047e3be4cae7b811daa1aabc9643f295f9aa23
Author: Cyril Brulebois 
Date:   Wed Dec 1 20:32:56 2010 +0100

Use justified text.

commit 172a983ed706f8dcb99d4df7506e0e1be0f6eaac
Author: Cyril Brulebois 
Date:   Wed Dec 1 20:25:46 2010 +0100

Add report-bugs howto.

commit 3b28a1ce7d4144b6ac5cb7057e96746fa7f521f2
Author: Cyril Brulebois 
Date:   Wed Dec 1 20:24:39 2010 +0100

Include a background image.

commit 8eb45306774b709eaa74b57b264328958411716d
Author: Cyril Brulebois 
Date:   Wed Dec 1 18:29:58 2010 +0100

Add page breaks for the generated PDF files.

But do not add a page break for the first h2; that's determined by the
h1 then h2 sequence, which is written “h1 + h2” in CSS.

commit 917e579f381117b63d4c93fc4d1b2ed9bd89fdcf
Author: Cyril Brulebois 
Date:   Wed Dec 1 18:28:21 2010 +0100

Mention SIGPIPE and backtraces.

commit 5000977d2708a472fcc6007fa7b2e0708a8353c1
Author: Cyril Brulebois 
Date:   Wed Dec 1 18:02:04 2010 +0100

Restructure.

commit 4155b8e393f1c1bb70e19c75b190ef76252c09fa
Author: Cyril Brulebois 
Date:   Wed Dec 1 18:01:50 2010 +0100

Tweak the CSS.

commit a76e1e0fc54ea02286be574328a668d1186c13f9
Author: Cyril Brulebois 
Date:   Wed Dec 1 17:49:39 2010 +0100

More stuff about gdb.

commit b2088e17278501bd7f1e309f5a3bdd19a2fa0766
Author: Cyril Brulebois 
Date:   Wed Dec 1 17:19:53 2010 +0100

Use a tiny trick to use a CSS file.

That makes it work for top-level and a depth of 1 directory. That should
be sufficient for now, and doesn't require hardcoding a '/xsf.css' href.

commit cc5f21652f8a8dde7a3726a43ce8816677903cd9
Author: Cyril Brulebois 
Date:   Wed Dec 1 17:19:13 2010 +0100

Clean pdf files as well.

commit 1314e9d6669c9df1ce24e274b30aefe884dc9461
Author: Cyril Brulebois 
Date:   Wed Dec 1 17:18:49 2010 +0100

Clean stuff.

commit 2255fa3ba574544e1e33a62486cbf3e2a6e1d7c6
Author: Cyril Brulebois 
Date:   Wed Dec 1 17:18:33 2010 +0100

Generate PDF as well.

commit f19bf3704f6e6c8cfd67cf19829eb1c3f823fdd6
Author: Cyril Brulebois 
Date:   Wed Dec 1 16:16:25 2010 +0100

Add index.

commit 80aa83960cee4eecb7883714f3792b80e24d7caa
Author: Cyril Brulebois 
Date:   Wed Dec 1 15:44:33 2010 +0100

Add machinery.

commit d439aec54894bbd94c8d2420b1dd5788cfb33fd2
Author: Cyril Brulebois 
Date:   Wed Dec 1 15:12:17 2010 +0100

Initial commit.


-- 
To UNSUBSCRIBE, email to debian-x-requ...@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmas...@lists.debian.org
Archive: http://lists.debian.org/e1pntbt-0007bv...@alioth.debian.org