From: Randy Dunlap <rdunlap@xenotime.net>

Various core kernel-doc cleanups:
- add missing function parameters in ipc, irq/manage, kernel/sys,
  kernel/sysctl, and mm/slab;
- move description to just above function for kernel_restart()

Signed-off-by: Randy Dunlap <rdunlap@xenotime.net>
Signed-off-by: Andrew Morton <akpm@osdl.org>
---

 ipc/util.c          |    9 +++++----
 kernel/irq/manage.c |    1 +
 kernel/sys.c        |   15 +++++++++------
 kernel/sysctl.c     |    1 +
 mm/slab.c           |    1 +
 5 files changed, 17 insertions(+), 10 deletions(-)

diff -puN ipc/util.c~more-kernel-doc-cleanups-additions ipc/util.c
--- devel/ipc/util.c~more-kernel-doc-cleanups-additions	2005-10-23 15:54:51.000000000 -0700
+++ devel-akpm/ipc/util.c	2005-10-23 15:54:51.000000000 -0700
@@ -410,7 +410,8 @@ void ipc_rcu_getref(void *ptr)
 }
 
 /**
- *	ipc_schedule_free	- free ipc + rcu space
+ * ipc_schedule_free - free ipc + rcu space
+ * @head: RCU callback structure for queued work
  * 
  * Since RCU callback function is called in bh,
  * we need to defer the vfree to schedule_work
@@ -427,10 +428,10 @@ static void ipc_schedule_free(struct rcu
 }
 
 /**
- *	ipc_immediate_free	- free ipc + rcu space
- *
- *	Free from the RCU callback context
+ * ipc_immediate_free - free ipc + rcu space
+ * @head: RCU callback structure that contains pointer to be freed
  *
+ * Free from the RCU callback context
  */
 static void ipc_immediate_free(struct rcu_head *head)
 {
diff -puN kernel/irq/manage.c~more-kernel-doc-cleanups-additions kernel/irq/manage.c
--- devel/kernel/irq/manage.c~more-kernel-doc-cleanups-additions	2005-10-23 15:54:51.000000000 -0700
+++ devel-akpm/kernel/irq/manage.c	2005-10-23 15:54:51.000000000 -0700
@@ -24,6 +24,7 @@ cpumask_t __cacheline_aligned pending_ir
 
 /**
  *	synchronize_irq - wait for pending IRQ handlers (on other CPUs)
+ *	@irq: interrupt number to wait for
  *
  *	This function waits for any pending IRQ handlers for this interrupt
  *	to complete before returning. If you use this function while
diff -puN kernel/sys.c~more-kernel-doc-cleanups-additions kernel/sys.c
--- devel/kernel/sys.c~more-kernel-doc-cleanups-additions	2005-10-23 15:54:51.000000000 -0700
+++ devel-akpm/kernel/sys.c	2005-10-23 15:54:51.000000000 -0700
@@ -375,18 +375,21 @@ void emergency_restart(void)
 }
 EXPORT_SYMBOL_GPL(emergency_restart);
 
-/**
- *	kernel_restart - reboot the system
- *
- *	Shutdown everything and perform a clean reboot.
- *	This is not safe to call in interrupt context.
- */
 void kernel_restart_prepare(char *cmd)
 {
 	notifier_call_chain(&reboot_notifier_list, SYS_RESTART, cmd);
 	system_state = SYSTEM_RESTART;
 	device_shutdown();
 }
+
+/**
+ *	kernel_restart - reboot the system
+ *	@cmd: pointer to buffer containing command to execute for restart
+ *		or NULL
+ *
+ *	Shutdown everything and perform a clean reboot.
+ *	This is not safe to call in interrupt context.
+ */
 void kernel_restart(char *cmd)
 {
 	kernel_restart_prepare(cmd);
diff -puN kernel/sysctl.c~more-kernel-doc-cleanups-additions kernel/sysctl.c
--- devel/kernel/sysctl.c~more-kernel-doc-cleanups-additions	2005-10-23 15:54:51.000000000 -0700
+++ devel-akpm/kernel/sysctl.c	2005-10-23 15:54:51.000000000 -0700
@@ -2131,6 +2131,7 @@ int proc_dointvec_jiffies(ctl_table *tab
  * @filp: the file structure
  * @buffer: the user buffer
  * @lenp: the size of the user buffer
+ * @ppos: pointer to the file position
  *
  * Reads/writes up to table->maxlen/sizeof(unsigned int) integer
  * values from/to the user buffer, treated as an ASCII string. 
diff -puN mm/slab.c~more-kernel-doc-cleanups-additions mm/slab.c
--- devel/mm/slab.c~more-kernel-doc-cleanups-additions	2005-10-23 15:54:51.000000000 -0700
+++ devel-akpm/mm/slab.c	2005-10-23 15:54:51.000000000 -0700
@@ -3271,6 +3271,7 @@ static void drain_array_locked(kmem_cach
 
 /**
  * cache_reap - Reclaim memory from caches.
+ * @unused: unused parameter
  *
  * Called from workqueue/eventd every few seconds.
  * Purpose:
_