Rob Landley wrote:
I think he understands he was clueless too, that's why he investigated the
failure and wrote it up for posterity.
And Ric said do not stigmatize whole classes of A) devices, B) raid,
and C) filesystems with "Pavel says...".
I don't care what "Pavel says", so you can leave the ad hominem at the door,
thanks.
See, this is exactly the problem we have with all the proposed
documentation. The reader (you) did not get what the writer (me)
was trying to say. That does not say either of us was wrong in
what we thought was meant, simply that we did not communicate.
What I meant was we did not want to accept Pavel's incorrect
documentation and post it in kernel docs.
The kernel presents abstractions, such as block device nodes. Sometimes
implementation details bubble through those abstractions. Presumably, we
agree on that so far.
We don't have any problem with documenting abstractions. But they
must be written as abstracts and accurate, not as IMO blogs.
It is not "he means well, so we will just accept it". The rule
for kernel docs should be the same as for code. If it is not
correct in all cases or causes problems, we don't accept it.
jim
--
To unsubscribe from this list: send the line "unsubscribe linux-doc" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at http://vger.kernel.org/majordomo-info.html