Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

misc: genwqe: card_sysfs: Demote function/file headers from kerneldoc

There has been no attempt to provide documentation for these function's
arguments, so align with the remainder of the file and just treat
them as standards function headers.

Fixes the following W=1 kernel build warnings:

drivers/misc/genwqe/card_sysfs.c:32: warning: cannot understand function prototype: 'const char * const genwqe_types[] = '
drivers/misc/genwqe/card_sysfs.c:150: warning: Function parameter or member 'dev' not described in 'curr_bitstream_show'
drivers/misc/genwqe/card_sysfs.c:150: warning: Function parameter or member 'attr' not described in 'curr_bitstream_show'
drivers/misc/genwqe/card_sysfs.c:150: warning: Function parameter or member 'buf' not described in 'curr_bitstream_show'
drivers/misc/genwqe/card_sysfs.c:166: warning: Function parameter or member 'dev' not described in 'next_bitstream_show'
drivers/misc/genwqe/card_sysfs.c:166: warning: Function parameter or member 'attr' not described in 'next_bitstream_show'
drivers/misc/genwqe/card_sysfs.c:166: warning: Function parameter or member 'buf' not described in 'next_bitstream_show'
drivers/misc/genwqe/card_sysfs.c:271: warning: Function parameter or member 'kobj' not described in 'genwqe_is_visible'
drivers/misc/genwqe/card_sysfs.c:271: warning: Function parameter or member 'attr' not described in 'genwqe_is_visible'
drivers/misc/genwqe/card_sysfs.c:271: warning: Function parameter or member 'n' not described in 'genwqe_is_visible'

Cc: Michael Jung <mijung@gmx.net>
Cc: Michael Ruettger <michael@ibmra.de>
Cc: Frank Haverkamp <haver@linux.ibm.com>
Cc: Joerg-Stephan Vogt <jsvogt@de.ibm.com>
Signed-off-by: Lee Jones <lee.jones@linaro.org>
Link: https://lore.kernel.org/r/20200701083118.45744-3-lee.jones@linaro.org
Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>

authored by

Lee Jones and committed by
Greg Kroah-Hartman
ac36fdb1 7adb55bd

+4 -4
+4 -4
drivers/misc/genwqe/card_sysfs.c
··· 1 1 // SPDX-License-Identifier: GPL-2.0-only 2 - /** 2 + /* 3 3 * IBM Accelerator Family 'GenWQE' 4 4 * 5 5 * (C) Copyright IBM Corp. 2013 ··· 129 129 } 130 130 static DEVICE_ATTR_RO(base_clock); 131 131 132 - /** 132 + /* 133 133 * curr_bitstream_show() - Show the current bitstream id 134 134 * 135 135 * There is a bug in some old versions of the CPLD which selects the ··· 156 156 } 157 157 static DEVICE_ATTR_RO(curr_bitstream); 158 158 159 - /** 159 + /* 160 160 * next_bitstream_show() - Show the next activated bitstream 161 161 * 162 162 * IO_SLC_CFGREG_SOFTRESET: This register can only be accessed by the PF. ··· 260 260 NULL, 261 261 }; 262 262 263 - /** 263 + /* 264 264 * genwqe_is_visible() - Determine if sysfs attribute should be visible or not 265 265 * 266 266 * VFs have restricted mmio capabilities, so not all sysfs entries