Skip to contentSkip to conversation

DocBook: update comments

PATCH New Martin Waitz 1 participant 1 message May 24, 2005

Subsystems (5)
lore
Share & tools
lore
#0 lore raw

PATCH 1/1 DocBook: update comments

DocBook: update comments

This patch updates some comments to match code changes.

---
 Documentation/DocBook/kernel-api.tmpl |    2 +-
 drivers/pnp/card.c                    |    3 +--
 drivers/pnp/manager.c                 |    1 +
 fs/sysfs/file.c                       |    5 +++--
 mm/memory.c                           |    2 +-
 5 files changed, 7 insertions(+), 6 deletions(-)
mm/memory.c +1 -1
Index: linux-docbook/mm/memory.c
===================================================================
@@ -1483,7 +1483,7 @@ restart:
  * unmap_mapping_range - unmap the portion of all mmaps
  * in the specified address_space corresponding to the specified
  * page range in the underlying file.
- * @address_space: the address space containing mmaps to be unmapped.
+ * @mapping: the address space containing mmaps to be unmapped.
  * @holebegin: byte in first page to unmap, relative to the start of
  * the underlying file.  This will be rounded down to a PAGE_SIZE
  * boundary.  Note that this is different from vmtruncate(), which
drivers/pnp/card.c +1 -2
Index: linux-docbook/drivers/pnp/card.c
===================================================================
@@ -259,7 +259,6 @@ int pnp_add_card_device(struct pnp_card 
 
 /**
  * pnp_remove_card_device- removes a device from the specified card
- * @card: pointer to the card to remove from
  * @dev: pointer to the device to remove
  */
 
@@ -274,7 +273,7 @@ void pnp_remove_card_device(struct pnp_d
 
 /**
  * pnp_request_card_device - Searches for a PnP device under the specified card
- * @lcard: pointer to the card link, cannot be NULL
+ * @clink: pointer to the card link, cannot be NULL
  * @id: pointer to a PnP ID structure that explains the rules for finding the device
  * @from: Starting place to search from. If NULL it will start from the begining.
  */
drivers/pnp/manager.c +1 -0
Index: linux-docbook/drivers/pnp/manager.c
===================================================================
@@ -390,6 +390,7 @@ fail:
  * pnp_manual_config_dev - Disables Auto Config and Manually sets the resource table
  * @dev: pointer to the desired device
  * @res: pointer to the new resource config
+ * @mode: 0 or PNP_CONFIG_FORCE
  *
  * This function can be used by drivers that want to manually set thier resources.
  */
fs/sysfs/file.c +3 -2
Index: linux-docbook/fs/sysfs/file.c
===================================================================
@@ -13,7 +13,7 @@
 #define to_subsys(k) container_of(k,struct subsystem,kset.kobj)
 #define to_sattr(a) container_of(a,struct subsys_attribute,attr)
 
-/**
+/*
  * Subsystem file operations.
  * These operations allow subsystems to have files that can be 
  * read/written. 
@@ -191,8 +191,9 @@ fill_write_buffer(struct sysfs_buffer * 
 
 /**
  *	flush_write_buffer - push buffer to kobject.
- *	@file:		file pointer.
+ *	@dentry:	dentry to the attribute
  *	@buffer:	data buffer for file.
+ *	@count:		number of bytes
  *
  *	Get the correct pointers for the kobject and the attribute we're
  *	dealing with, then call the store() method for the attribute, 
Documentation/DocBook/kernel-api.tmpl +1 -1
Index: linux-docbook/Documentation/DocBook/kernel-api.tmpl
===================================================================
@@ -266,7 +266,7 @@ X!Ekernel/module.c
   <chapter id="hardware">
      <title>Hardware Interfaces</title>
      <sect1><title>Interrupt Handling</title>
-!Iarch/i386/kernel/irq.c
+!Ikernel/irq/manage.c
      </sect1>
 
      <sect1><title>Resources Management</title>
Signature · 1 line
Martin Waitz