Log in

activity wholist changelog info go back go back go forward go forward
The Joy Of Docs - now if you've got a pair of headphones...
you'd better get 'em on and get 'em cranked up
The Joy Of Docs
I'm currently fighting the Intel graphics driver on Ironlake (Core i3/i5/i7). It's nice that I have some documentation for it? Except that a typical page looks like this:

Strong work guys.

Tags: , ,
music: placebo - you don't care about us

pong! (x7) || ping?
zaitcev From: zaitcev Date: April 6th, 2010 11:44 pm (UTC) (link)
If someone fixed https://bugs.freedesktop.org/show_bug.cgi?id=26600, I would be just fine with what we have now. I am not on a laptop, so I do not care about multiply outputs. But yeah, this looks pretty damning. Although, at least they documented it. Someone else would just throw it all into impossible to find, secret errata.
ajaxxx From: ajaxxx Date: April 7th, 2010 11:37 am (UTC) (link)
Well, they posted the docs, then took them down with no explanation, and haven't re-posted them. Good thing they're under a CC license that allows redistribution.
From: (Anonymous) Date: April 7th, 2010 09:27 am (UTC) (link)


I only see orange, but no green!
From: (Anonymous) Date: April 7th, 2010 04:46 pm (UTC) (link)

Re: green?

3 and 5 are missing as well
From: ext_68502 Date: April 7th, 2010 06:45 pm (UTC) (link)

This game is fun!

I see five problems with that chunk of documentation:

1. The most obvious, there is no "green = works" in the table.
2. There is both white and orange in the table; do one of those mean "works?"
c. The first note in the list below isn't numbered. Probably should be number 1, or maybe not.
d. Notes 3 and 5 are referenced in the table, but are not defined below.
5. Notes 8, 9, and 10 are listed below, but not represented in the table.

How many problems can you find, assuming technical accuracy of the content? ;-)
ajaxxx From: ajaxxx Date: April 8th, 2010 03:42 am (UTC) (link)

Re: This game is fun!

Other fun things:

- Notes mention HDMI, but table does not
- eDP, LVDS, TV, and CRT each only exist once on the chip, so if orange is "green", it's sort of vacuous; why bother to say that output A can be on if output A is on?
From: (Anonymous) Date: April 7th, 2010 10:04 pm (UTC) (link)
I guess the lesson here is.. don't let colorblind people write docs :p
pong! (x7) || ping?