[PATCH] kernel-api docbook: fix content problems

From: Randy Dunlap
Date: Thu Oct 18 2007 - 17:13:26 EST


From: Randy Dunlap <randy.dunlap@xxxxxxxxxx>

Fix kernel-api docbook contents problems.

docproc: linux-2.6.23-git13/include/asm-x86/unaligned_32.h: No such file or directory
Warning(linux-2.6.23-git13//include/linux/list.h:482): bad line: of list entry
Warning(linux-2.6.23-git13//mm/filemap.c:864): No description found for parameter 'ra'
Warning(linux-2.6.23-git13//block/ll_rw_blk.c:3760): No description found for parameter 'req'
Warning(linux-2.6.23-git13//include/linux/input.h:1077): No description found for parameter 'private'
Warning(linux-2.6.23-git13//include/linux/input.h:1077): No description found for parameter 'cdev'

Signed-off-by: Randy Dunlap <randy.dunlap@xxxxxxxxxx>
---
Documentation/DocBook/kernel-api.tmpl | 2 +-
block/ll_rw_blk.c | 2 +-
include/linux/input.h | 4 +++-
include/linux/list.h | 3 +--
mm/filemap.c | 2 +-
5 files changed, 7 insertions(+), 6 deletions(-)

--- linux-2.6.23-git13.orig/Documentation/DocBook/kernel-api.tmpl
+++ linux-2.6.23-git13/Documentation/DocBook/kernel-api.tmpl
@@ -46,7 +46,7 @@

<sect1><title>Atomic and pointer manipulation</title>
!Iinclude/asm-x86/atomic_32.h
-!Iinclude/asm-x86/unaligned_32.h
+!Iinclude/asm-x86/unaligned.h
</sect1>

<sect1><title>Delaying, scheduling, and timer routines</title>
--- linux-2.6.23-git13.orig/include/linux/list.h
+++ linux-2.6.23-git13/include/linux/list.h
@@ -478,8 +478,7 @@ static inline void list_splice_init_rcu(
pos = n, n = pos->next)

/**
- * list_for_each_prev_safe - iterate over a list backwards safe against removal
- of list entry
+ * list_for_each_prev_safe - iterate over a list backwards safe against removal of list entry
* @pos: the &struct list_head to use as a loop cursor.
* @n: another &struct list_head to use as temporary storage
* @head: the head for your list.
--- linux-2.6.23-git13.orig/mm/filemap.c
+++ linux-2.6.23-git13/mm/filemap.c
@@ -840,7 +840,7 @@ static void shrink_readahead_size_eio(st
/**
* do_generic_mapping_read - generic file read routine
* @mapping: address_space to be read
- * @_ra: file's readahead state
+ * @ra: file's readahead state
* @filp: the file to read
* @ppos: current file position
* @desc: read_descriptor
--- linux-2.6.23-git13.orig/block/ll_rw_blk.c
+++ linux-2.6.23-git13/block/ll_rw_blk.c
@@ -3739,7 +3739,7 @@ EXPORT_SYMBOL(end_dequeued_request);

/**
* end_request - end I/O on the current segment of the request
- * @rq: the request being processed
+ * @req: the request being processed
* @uptodate: error value or 0/1 uptodate flag
*
* Description:
--- linux-2.6.23-git13.orig/include/linux/input.h
+++ linux-2.6.23-git13/include/linux/input.h
@@ -1005,13 +1005,15 @@ struct ff_effect {
* @going_away: marks devices that are in a middle of unregistering and
* causes input_open_device*() fail with -ENODEV.
* @dev: driver model's view of this device
+ * @cdev: union for struct device pointer
* @h_list: list of input handles associated with the device. When
* accessing the list dev->mutex must be held
* @node: used to place the device onto input_dev_list
*/
struct input_dev {
-
+ /* private: */
void *private; /* do not use */
+ /* public: */

const char *name;
const char *phys;
-
To unsubscribe from this list: send the line "unsubscribe linux-kernel" in
the body of a message to majordomo@xxxxxxxxxxxxxxx
More majordomo info at http://vger.kernel.org/majordomo-info.html
Please read the FAQ at http://www.tux.org/lkml/