Commit cc448baf authored Mar 12, 2021 by Lee Jones Committed by Dominik Brodowski Mar 15, 2021

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>

parent f20a7596

drivers/pcmcia/cistpl.c

+6 −6

Original line number	Diff line number	Diff line
		@@ -75,7 +75,7 @@ void release_cis_mem(struct pcmcia_socket *s)
		mutex_unlock(&s->ops_mutex);
		}

		/**
		/*
		* set_cis_map() - map the card memory at "card_offset" into virtual space.
		*
		* If flags & MAP_ATTRIB, map the attribute space, otherwise
		@@ -126,7 +126,7 @@ static void __iomem set_cis_map(struct pcmcia_socket s,
		#define IS_ATTR 1
		#define IS_INDIRECT 8

		/**
		/*
		* pcmcia_read_cis_mem() - low-level function to read CIS memory
		*
		* must be called with ops_mutex held
		@@ -206,7 +206,7 @@ int pcmcia_read_cis_mem(struct pcmcia_socket *s, int attr, u_int addr,
		}


		/**
		/*
		* pcmcia_write_cis_mem() - low-level function to write CIS memory
		*
		* Probably only useful for writing one-byte registers. Must be called
		@@ -277,7 +277,7 @@ int pcmcia_write_cis_mem(struct pcmcia_socket *s, int attr, u_int addr,
		}


		/**
		/*
		* read_cis_cache() - read CIS memory or its associated cache
		*
		* This is a wrapper around read_cis_mem, with the same interface,
		@@ -365,7 +365,7 @@ void destroy_cis_cache(struct pcmcia_socket *s)
		}
		}

		/**
		/*
		* verify_cis_cache() - does the CIS match what is in the CIS cache?
		*/
		int verify_cis_cache(struct pcmcia_socket *s)
		@@ -401,7 +401,7 @@ int verify_cis_cache(struct pcmcia_socket *s)
		return 0;
		}

		/**
		/*
		* pcmcia_replace_cis() - use a replacement CIS instead of the card's CIS
		*
		* For really bad cards, we provide a facility for uploading a