sh: Fix up broken kerneldoc comments.

These were completely unparseable, so fix them up.

Signed-off-by: Paul Mundt <lethal@linux-sh.org>
This commit is contained in:
Paul Mundt 2008-08-04 12:51:06 +09:00
parent 617870632d
commit 6a9545bd95
4 changed files with 24 additions and 37 deletions

View File

@ -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)
{

View File

@ -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

View File

@ -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.
*

View File

@ -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 @@ out:
}
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)