Comments in HAL_spi_STM32F1.cpp

Marlin/src/HAL/HAL_STM32F1/HAL_spi_STM32F1.cpp

 }
 
 /**
- * @brief  Initializes SPI port to required speed rate and transfer mode (MSB, SPI MODE 0)
+ * @brief  Initialize SPI port to required speed rate and transfer mode (MSB, SPI MODE 0)
  *
  * @param  spiRate Rate as declared in HAL.h (speed do not match AVR)
  * @return Nothing
 }
 
 /**
- * @brief  Receives a single byte from the SPI port.
+ * @brief  Receive a single byte from the SPI port.
  *
  * @return Byte received
  *
 }
 
 /**
- * @brief  Receives a number of bytes from the SPI port to a buffer
+ * @brief  Receive a number of bytes from the SPI port to a buffer
  *
  * @param  buf   Pointer to starting address of buffer to write to.
  * @param  nbyte Number of bytes to receive.
 }
 
 /**
- * @brief  Sends a single byte on SPI port
+ * @brief  Send a single byte on SPI port
  *
  * @param  b Byte to send
  *
   SPI.endTransaction();
 }
 
-/** Begin SPI transaction, set clock, bit order, data mode */
+/**
+ * @brief  Begin SPI transaction, set clock, bit order, data mode
+ *
+ * @param  spiClock   Clock setting
+ * @param  bitOrder   Bit Order setting
+ * @param  dataMode   Data Mode setting
+ * @return Nothing
+ *
+ * @details Uses an SPI Config via SPISettings
+ */
 void spiBeginTransaction(uint32_t spiClock, uint8_t bitOrder, uint8_t dataMode) {
   spiConfig = SPISettings(spiClock, (BitOrder)bitOrder, dataMode);
   SPI.beginTransaction(spiConfig);