Donate to e Foundation | Murena handsets with /e/OS | Own a part of Murena! Learn more

Commit 6a9545bd authored by Paul Mundt's avatar Paul Mundt
Browse files

sh: Fix up broken kerneldoc comments. 



These were completely unparseable, so fix them up.

Signed-off-by: default avatarPaul Mundt <lethal@linux-sh.org>
parent 61787063

arch/sh/include/asm/tlb_64.h

+3 −9
Original line number Diff line number Diff line
@@ -21,11 +21,9 @@ 
#ifndef __ASSEMBLY__



/**

 * for_each_dtlb_entry

 * for_each_dtlb_entry - Iterate over free (non-wired) DTLB entries

 *

 * @tlb:	TLB entry

 *

 * Iterate over free (non-wired) DTLB entries

 */

#define for_each_dtlb_entry(tlb)		\

	for (tlb  = cpu_data->dtlb.first;	\
@@ -33,11 +31,9 @@ 
	     tlb += cpu_data->dtlb.step)



/**

 * for_each_itlb_entry

 * for_each_itlb_entry - Iterate over free (non-wired) ITLB entries

 *

 * @tlb:	TLB entry

 *

 * Iterate over free (non-wired) ITLB entries

 */

#define for_each_itlb_entry(tlb)		\

	for (tlb  = cpu_data->itlb.first;	\
@@ -45,11 +41,9 @@ 
	     tlb += cpu_data->itlb.step)



/**

 * __flush_tlb_slot

 * __flush_tlb_slot - Flushes TLB slot @slot.

 *

 * @slot:	Address of TLB slot.

 *

 * Flushes TLB slot @slot.

 */

static inline void __flush_tlb_slot(unsigned long long slot)

{

arch/sh/kernel/cpu/sh4/sq.c

+1 −1
Original line number Diff line number Diff line
@@ -199,7 +199,7 @@ EXPORT_SYMBOL(sq_remap); 


/**

 * sq_unmap - Unmap a Store Queue allocation

 * @map: Pre-allocated Store Queue mapping.

 * @vaddr: Pre-allocated Store Queue mapping.

 *

 * Unmaps the store queue allocation @map that was previously created by

 * sq_remap(). Also frees up the pte that was previously inserted into

arch/sh/mm/tlb-sh5.c

+6 −14
Original line number Diff line number Diff line
@@ -15,9 +15,7 @@ 
#include <asm/mmu_context.h>



/**

 * sh64_tlb_init

 *

 * Perform initial setup for the DTLB and ITLB.

 * sh64_tlb_init - Perform initial setup for the DTLB and ITLB.

 */

int __init sh64_tlb_init(void)

{
@@ -46,9 +44,7 @@ int __init sh64_tlb_init(void) 
}



/**

 * sh64_next_free_dtlb_entry

 *

 * Find the next available DTLB entry

 * sh64_next_free_dtlb_entry - Find the next available DTLB entry

 */

unsigned long long sh64_next_free_dtlb_entry(void)

{
@@ -56,9 +52,7 @@ unsigned long long sh64_next_free_dtlb_entry(void) 
}



/**

 * sh64_get_wired_dtlb_entry

 *

 * Allocate a wired (locked-in) entry in the DTLB

 * sh64_get_wired_dtlb_entry - Allocate a wired (locked-in) entry in the DTLB

 */

unsigned long long sh64_get_wired_dtlb_entry(void)

{
@@ -71,12 +65,10 @@ unsigned long long sh64_get_wired_dtlb_entry(void) 
}



/**

 * sh64_put_wired_dtlb_entry

 * sh64_put_wired_dtlb_entry - Free a wired (locked-in) entry in the DTLB.

 *

 * @entry:	Address of TLB slot.

 *

 * Free a wired (locked-in) entry in the DTLB.

 *

 * Works like a stack, last one to allocate must be first one to free.

 */

int sh64_put_wired_dtlb_entry(unsigned long long entry)
@@ -115,7 +107,7 @@ int sh64_put_wired_dtlb_entry(unsigned long long entry) 
}



/**

 * sh64_setup_tlb_slot

 * sh64_setup_tlb_slot - Load up a translation in a wired slot.

 *

 * @config_addr:	Address of TLB slot.

 * @eaddr:		Virtual address.
@@ -154,7 +146,7 @@ inline void sh64_setup_tlb_slot(unsigned long long config_addr, 
}



/**

 * sh64_teardown_tlb_slot

 * sh64_teardown_tlb_slot - Teardown a translation.

 *

 * @config_addr:	Address of TLB slot.

 *

drivers/sh/maple/maple.c

+14 −13
Original line number Diff line number Diff line
@@ -147,13 +147,13 @@ static void maple_release_device(struct device *dev) 
	kfree(mdev);

}



/*

/**

 * maple_add_packet - add a single instruction to the queue

 * @mdev - maple device

 * @function - function on device being queried

 * @command - maple command to add

 * @length - length of command string (in 32 bit words)

 * @data - remainder of command string

 * @mdev: maple device

 * @function: function on device being queried

 * @command: maple command to add

 * @length: length of command string (in 32 bit words)

 * @data: remainder of command string

 */

int maple_add_packet(struct maple_device *mdev, u32 function, u32 command,

	size_t length, void *data)
@@ -194,14 +194,15 @@ int maple_add_packet(struct maple_device *mdev, u32 function, u32 command, 
}

EXPORT_SYMBOL_GPL(maple_add_packet);



/*

/**

 * maple_add_packet_sleeps - add a single instruction to the queue

 *  - waits for lock to be free

 * @mdev - maple device

 * @function - function on device being queried

 * @command - maple command to add

 * @length - length of command string (in 32 bit words)

 * @data - remainder of command string

 * @mdev: maple device

 * @function: function on device being queried

 * @command: maple command to add

 * @length: length of command string (in 32 bit words)

 * @data: remainder of command string

 *

 * Same as maple_add_packet(), but waits for the lock to become free.

 */

int maple_add_packet_sleeps(struct maple_device *mdev, u32 function,

	u32 command, size_t length, void *data)