pinctrl: intel: Fix kernel doc format, i.e. add return sections

Kernel doc validator is not happy:

  pinctrl-intel.c:865: warning: No description found for return value of 'intel_gpio_to_pin'
  pinctrl-intel.c:904: warning: No description found for return value of 'intel_pin_to_gpio'
  2 warnings

Add return sections to the kernel documentation of the above mentioned
functions.

Signed-off-by: Andy Shevchenko <andriy.shevchenko@linux.intel.com>
Acked-by: Mika Westerberg <mika.westerberg@linux.intel.com>
This commit is contained in:
Andy Shevchenko 2022-05-20 00:26:45 +03:00
parent 56da7dc5eb
commit 7b923e67a4

View File

@ -858,6 +858,9 @@ static const struct pinctrl_desc intel_pinctrl_desc = {
* When coming through gpiolib irqchip, the GPIO offset is not * When coming through gpiolib irqchip, the GPIO offset is not
* automatically translated to pinctrl pin number. This function can be * automatically translated to pinctrl pin number. This function can be
* used to find out the corresponding pinctrl pin. * used to find out the corresponding pinctrl pin.
*
* Return: a pin number and pointers to the community and pad group, which
* the pin belongs to, or negative error code if translation can't be done.
*/ */
static int intel_gpio_to_pin(struct intel_pinctrl *pctrl, unsigned int offset, static int intel_gpio_to_pin(struct intel_pinctrl *pctrl, unsigned int offset,
const struct intel_community **community, const struct intel_community **community,
@ -899,6 +902,8 @@ static int intel_gpio_to_pin(struct intel_pinctrl *pctrl, unsigned int offset,
* @pin: pin number * @pin: pin number
* *
* Translate the pin number of pinctrl to GPIO offset * Translate the pin number of pinctrl to GPIO offset
*
* Return: a GPIO offset, or negative error code if translation can't be done.
*/ */
static __maybe_unused int intel_pin_to_gpio(struct intel_pinctrl *pctrl, int pin) static __maybe_unused int intel_pin_to_gpio(struct intel_pinctrl *pctrl, int pin)
{ {