spi: documentation: emphasise spi_master.setup() semantics
authorDavid Brownell <dbrownell@users.sourceforge.net>
Tue, 21 Apr 2009 19:24:49 +0000 (12:24 -0700)
committerLinus Torvalds <torvalds@linux-foundation.org>
Tue, 21 Apr 2009 20:41:50 +0000 (13:41 -0700)
commit6e538aaf50ae782a890cbc02c27950448d8193e1
tree0e61cacadc2fe403f411e52ba18539bdd52b17e2
parent14fadca793e39742f442df53391cdd1437b9262f
spi: documentation: emphasise spi_setup() semantics

This is a doc-only patch which I hope will reduce the number of
spi_master controller driver patches starting out with a common
implementation bug.

(As in: almost every spi_master driver I see starts out with its
version of this bug.  Sigh.)

It just re-emphasizes that the setup() method may be called for one
device while a transfer is active on another ...  which means that most
driver implementations shouldn't touch any registers.

Signed-off-by: David Brownell <dbrownell@users.sourceforge.net>
Signed-off-by: Andrew Morton <akpm@linux-foundation.org>
Signed-off-by: Linus Torvalds <torvalds@linux-foundation.org>
Documentation/spi/spi-summary
include/linux/spi/spi.h