spi: Clarify transfer_one() w.r.t. spi_finalize_current_transfer()
authorGeert Uytterhoeven <geert+renesas@linux-m68k.org>
Tue, 21 Jan 2014 15:10:06 +0000 (16:10 +0100)
committerMark Brown <broonie@linaro.org>
Tue, 21 Jan 2014 18:11:49 +0000 (18:11 +0000)
Signed-off-by: Geert Uytterhoeven <geert+renesas@linux-m68k.org>
Signed-off-by: Mark Brown <broonie@linaro.org>
include/linux/spi/spi.h

index 8c62ba74dd91d9800439038d86298f2e2477f1fe..e766e0e2fe581af98026c95a3bad52e8806b9974 100644 (file)
@@ -282,10 +282,12 @@ static inline void spi_unregister_driver(struct spi_driver *sdrv)
  * @prepare_message: set up the controller to transfer a single message,
  *                   for example doing DMA mapping.  Called from threaded
  *                   context.
- * @transfer_one: transfer a single spi_transfer. When the
- *               driver is finished with this transfer it must call
- *               spi_finalize_current_transfer() so the subsystem can issue
- *                the next transfer
+ * @transfer_one: transfer a single spi_transfer.
+ *                  - return 0 if the transfer is finished,
+ *                  - 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
  * @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