> I did stop, many years ago, in part because I was tired of this sort of thread.

Reading this makes me sad. So this is why we can't have nice things in free software for end users! I, for one, will try to remember to stop and think before criticizing any free software project from now on.

How can I help improve the documentation?

they go on these rants because the documentation is so dam poor. The OP lists blatant contradictions. Your response further up would be quite helpful in the code and/or in the documentation. I work in the embedded space and often read data sheets with similar contradictions or errors. It's almost like the documentation has to be as good as the code and idea. What good is the best mouse trap if no one knows how to use it. Poor documentation is a pet peeve of mine too and it's the poorly documented DBUS stuff is why I never bothered to even try to learn more about it.

What? hp has his own Wikipedia page:

> R. S. H. P. is an American computer engineer and entrepreneur. He is known in the free software community due to his work on HAL, GNOME, Metacity, GConf, and D-BUS.

hp, thank you for all the software you wrote.