summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorBaruch Siach <baruch@tkos.co.il>2014-01-25 22:36:13 +0200
committerMark Brown <broonie@linaro.org>2014-01-27 18:43:36 +0000
commit6e5f52674ff0756e61a8879f6232b9ac33735cba (patch)
treea9e9c23ca06b64513fdd45878bbe0e54f03abd30
parent8b8b773e6b611e6629ac01f85d401c949d153546 (diff)
downloadlinux-stable-6e5f52674ff0756e61a8879f6232b9ac33735cba.tar.gz
linux-stable-6e5f52674ff0756e61a8879f6232b9ac33735cba.tar.bz2
linux-stable-6e5f52674ff0756e61a8879f6232b9ac33735cba.zip
spi: spi.h: clarify the documentation of transfer_one
Explicitly note the transfer_one and transfer_one_message are mutually exclusive, to make the text a little more newcomers friendly. Signed-off-by: Baruch Siach <baruch@tkos.co.il> Signed-off-by: Mark Brown <broonie@linaro.org>
-rw-r--r--include/linux/spi/spi.h5
1 files changed, 4 insertions, 1 deletions
diff --git a/include/linux/spi/spi.h b/include/linux/spi/spi.h
index a1d4ca290862..ad050f0dd39d 100644
--- a/include/linux/spi/spi.h
+++ b/include/linux/spi/spi.h
@@ -287,7 +287,10 @@ static inline void spi_unregister_driver(struct spi_driver *sdrv)
* - return 1 if the transfer is still in progress. When
* the driver is finished with this transfer it must
* call spi_finalize_current_transfer() so the subsystem
- * can issue the next transfer
+ * can issue the next transfer. Note: transfer_one and
+ * transfer_one_message are mutually exclusive; when both
+ * are set, the generic subsystem does not call your
+ * transfer_one callback.
* @unprepare_message: undo any work done by prepare_message().
* @cs_gpios: Array of GPIOs to use as chip select lines; one per CS
* number. Any individual value may be -ENOENT for CS lines that