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

pcmcia: cistpl: Demote non-conformant kernel-doc headers to standard comments

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

drivers/pcmcia/cistpl.c:88: warning: Function parameter or member 's' not described in 'set_cis_map'
drivers/pcmcia/cistpl.c:88: warning: Function parameter or member 'card_offset' not described in 'set_cis_map'
drivers/pcmcia/cistpl.c:88: warning: Function parameter or member 'flags' not described in 'set_cis_map'
drivers/pcmcia/cistpl.c:136: warning: Function parameter or member 's' not described in 'pcmcia_read_cis_mem'
drivers/pcmcia/cistpl.c:136: warning: Function parameter or member 'attr' not described in 'pcmcia_read_cis_mem'
drivers/pcmcia/cistpl.c:136: warning: Function parameter or member 'addr' not described in 'pcmcia_read_cis_mem'
drivers/pcmcia/cistpl.c:136: warning: Function parameter or member 'len' not described in 'pcmcia_read_cis_mem'
drivers/pcmcia/cistpl.c:136: warning: Function parameter or member 'ptr' not described in 'pcmcia_read_cis_mem'
drivers/pcmcia/cistpl.c:217: warning: Function parameter or member 's' not described in 'pcmcia_write_cis_mem'
drivers/pcmcia/cistpl.c:217: warning: Function parameter or member 'attr' not described in 'pcmcia_write_cis_mem'
drivers/pcmcia/cistpl.c:217: warning: Function parameter or member 'addr' not described in 'pcmcia_write_cis_mem'
drivers/pcmcia/cistpl.c:217: warning: Function parameter or member 'len' not described in 'pcmcia_write_cis_mem'
drivers/pcmcia/cistpl.c:217: warning: Function parameter or member 'ptr' not described in 'pcmcia_write_cis_mem'
drivers/pcmcia/cistpl.c:289: warning: Function parameter or member 's' not described in 'read_cis_cache'
drivers/pcmcia/cistpl.c:289: warning: Function parameter or member 'attr' not described in 'read_cis_cache'
drivers/pcmcia/cistpl.c:289: warning: Function parameter or member 'addr' not described in 'read_cis_cache'
drivers/pcmcia/cistpl.c:289: warning: Function parameter or member 'len' not described in 'read_cis_cache'
drivers/pcmcia/cistpl.c:289: warning: Function parameter or member 'ptr' not described in 'read_cis_cache'
drivers/pcmcia/cistpl.c:372: warning: Function parameter or member 's' not described in 'verify_cis_cache'
drivers/pcmcia/cistpl.c:412: warning: Function parameter or member 's' not described in 'pcmcia_replace_cis'
drivers/pcmcia/cistpl.c:412: warning: Function parameter or member 'data' not described in 'pcmcia_replace_cis'
drivers/pcmcia/cistpl.c:412: warning: Function parameter or member 'len' not described in 'pcmcia_replace_cis'

Signed-off-by: Lee Jones <lee.jones@linaro.org>
[linux@dominikbrodowski.net: removed list of CCs]
Signed-off-by: Dominik Brodowski <linux@dominikbrodowski.net>

authored by

Lee Jones and committed by
Dominik Brodowski
cc448baf f20a7596

+6 -6
+6 -6
drivers/pcmcia/cistpl.c
··· 75 75 mutex_unlock(&s->ops_mutex); 76 76 } 77 77 78 - /** 78 + /* 79 79 * set_cis_map() - map the card memory at "card_offset" into virtual space. 80 80 * 81 81 * If flags & MAP_ATTRIB, map the attribute space, otherwise ··· 126 126 #define IS_ATTR 1 127 127 #define IS_INDIRECT 8 128 128 129 - /** 129 + /* 130 130 * pcmcia_read_cis_mem() - low-level function to read CIS memory 131 131 * 132 132 * must be called with ops_mutex held ··· 206 206 } 207 207 208 208 209 - /** 209 + /* 210 210 * pcmcia_write_cis_mem() - low-level function to write CIS memory 211 211 * 212 212 * Probably only useful for writing one-byte registers. Must be called ··· 277 277 } 278 278 279 279 280 - /** 280 + /* 281 281 * read_cis_cache() - read CIS memory or its associated cache 282 282 * 283 283 * This is a wrapper around read_cis_mem, with the same interface, ··· 365 365 } 366 366 } 367 367 368 - /** 368 + /* 369 369 * verify_cis_cache() - does the CIS match what is in the CIS cache? 370 370 */ 371 371 int verify_cis_cache(struct pcmcia_socket *s) ··· 401 401 return 0; 402 402 } 403 403 404 - /** 404 + /* 405 405 * pcmcia_replace_cis() - use a replacement CIS instead of the card's CIS 406 406 * 407 407 * For really bad cards, we provide a facility for uploading a