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

tty: n_gsm: Demote obvious abuse of kernel-doc and supply other missing docss

Fixes the following W=1 kernel build warning(s):

drivers/tty/n_gsm.c:85: warning: Function parameter or member 'ref' not described in 'gsm_mux_net'
drivers/tty/n_gsm.c:85: warning: Function parameter or member 'dlci' not described in 'gsm_mux_net'
drivers/tty/n_gsm.c:664: warning: Function parameter or member 'dlci' not described in 'gsm_data_kick'
drivers/tty/n_gsm.c:1015: warning: Function parameter or member 'clen' not described in 'gsm_process_modem'

Cc: Greg Kroah-Hartman <gregkh@linuxfoundation.org>
Cc: Jiri Slaby <jirislaby@kernel.org>
Signed-off-by: Lee Jones <lee.jones@linaro.org>
Link: https://lore.kernel.org/r/20201104193549.4026187-19-lee.jones@linaro.org
Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>

authored by

Lee Jones and committed by
Greg Kroah-Hartman
b410e35d 7789c1f1

+3 -1
+3 -1
drivers/tty/n_gsm.c
··· 74 74 #define MAX_MTU 1500 75 75 #define GSM_NET_TX_TIMEOUT (HZ*10) 76 76 77 - /** 77 + /* 78 78 * struct gsm_mux_net - network interface 79 79 * 80 80 * Created when net interface is initialized. ··· 651 651 /** 652 652 * gsm_data_kick - poke the queue 653 653 * @gsm: GSM Mux 654 + * @dlci: DLCI sending the data 654 655 * 655 656 * The tty device has called us to indicate that room has appeared in 656 657 * the transmit queue. Ram more data into the pipe if we have any ··· 1006 1005 * @tty: virtual tty bound to the DLCI 1007 1006 * @dlci: DLCI to affect 1008 1007 * @modem: modem bits (full EA) 1008 + * @clen: command length 1009 1009 * 1010 1010 * Used when a modem control message or line state inline in adaption 1011 1011 * layer 2 is processed. Sort out the local modem state and throttles