While it's not a bug as such, that documentation was obviously written
by someone who has no business writing documentation. It's a complete
mess that only makes sense to someone who already knows the new syntax
inside and out. I too tried to use that manpage to get around a bug in
evdev and was baffled by how bad it was.

And yes, I'm a technical user having used Linux exclusively since before 1.0. 
I've also used machines and big iron that had real documentation, walls of it, 
written by technical writers. For technical users. It all was clear and 
efficient.
Technical users don't have time to test all the permutations of each option to 
see what does and doesn't work because the documentation is incomprehensible. 
That's *not* what "technical user" means.

Now while the Linux / system devs are doing their best I sometimes
wonder if those who can't write simply shouldn't. Confusing manpages
aren't really much better than no manpage...

-- 
evdev manual page is nonsensical
https://bugs.launchpad.net/bugs/88763
You received this bug notification because you are a member of Ubuntu
Bugs, which is subscribed to Ubuntu.

-- 
ubuntu-bugs mailing list
ubuntu-bugs@lists.ubuntu.com
https://lists.ubuntu.com/mailman/listinfo/ubuntu-bugs

Reply via email to