[rtems commit] libfs: Doxygen Enhancement GCI Task #7

Gedare Bloom gedare at rtems.org
Tue Dec 11 23:50:36 UTC 2012


Module:    rtems
Branch:    master
Commit:    9bff3752de7125340a963a0054dd4be92c86d5cd
Changeset: http://git.rtems.org/rtems/commit/?id=9bff3752de7125340a963a0054dd4be92c86d5cd

Author:    Mathew Kallada <matkallada at gmail.com>
Date:      Tue Dec 11 18:54:46 2012 -0500

libfs: Doxygen Enhancement GCI Task #7

http://www.google-melange.com/gci/task/view/google/gci2012/8006219

---

 cpukit/libfs/src/devfs/devfs.h           |   22 +++++++++++++++++++---
 cpukit/libfs/src/devfs/devfs_eval.c      |    7 +++++++
 cpukit/libfs/src/devfs/devfs_init.c      |    7 +++++++
 cpukit/libfs/src/devfs/devfs_mknod.c     |    7 +++++++
 cpukit/libfs/src/devfs/devfs_node_type.c |    7 +++++++
 cpukit/libfs/src/devfs/devioctl.c        |    7 +++++++
 cpukit/libfs/src/devfs/devopen.c         |    7 +++++++
 cpukit/libfs/src/devfs/devread.c         |    7 +++++++
 cpukit/libfs/src/devfs/devwrite.c        |    7 +++++++
 9 files changed, 75 insertions(+), 3 deletions(-)

diff --git a/cpukit/libfs/src/devfs/devfs.h b/cpukit/libfs/src/devfs/devfs.h
index 4155dd6..3fd1fab 100644
--- a/cpukit/libfs/src/devfs/devfs.h
+++ b/cpukit/libfs/src/devfs/devfs.h
@@ -13,10 +13,16 @@
 #ifdef __cplusplus
 extern "C" {
 #endif
-
 /**
- *  This structure define the type of device table
+ * @defgroup DevFsDeviceTable Define Device Table Type
+ *
+ * @ingroup DevFs
+ *
+ * @brief This structure defines the type of device table
+ *
+ * @{
  */
+
 typedef struct {
   /** This member points to device name which is not a null-terminated string */
   const char               *name;
@@ -56,11 +62,15 @@ static inline const devFS_data *devFS_get_data(
   return (const devFS_data *) loc->mt_entry->immutable_fs_info;
 }
 
+/**
+ *  @brief Evaluate Patch
+ */
 extern void devFS_eval_path(
   rtems_filesystem_eval_path_context_t *ctx
 );
 
 /**
+ *  @brief Maps Open Operation to rtems_io_open
  *  This handler maps open operation to rtems_io_open.
  *  @param iop This is the RTEMS's internal representation of file.
  *  @param pathname a null-terminated string that starts with /dev.
@@ -90,6 +100,7 @@ extern int devFS_close(
 
 
 /**
+ *  @brief Maps Read Operation to rtems_io_read
  *  This handler maps read operation to rtems_io_read.
  *  @param iop This is the RTEMS's internal representation of file
  *  @param  buffer memory location to store read data
@@ -106,6 +117,7 @@ extern ssize_t devFS_read(
 
 
 /**
+ *  @brief Writes Operation to rtems_io_write
  *  This handler maps write operation to rtems_io_write.
  *  @param iop This is the RTEMS's internal representation of file
  *  @param buffer data to be written
@@ -122,6 +134,7 @@ extern ssize_t devFS_write(
 
 
 /**
+ *  @brief Maps ioctl Operation to rtems_io_ioctl
  *  This handler maps ioctl operation to rtems_io_ioctl.
  *  @param iop This is the RTEMS's internal representation of file
  *  @param command io control command
@@ -159,6 +172,7 @@ extern int devFS_stat(
 
 
 /**
+ *  @brief Invoked upon Determination of a Node Type
  *  This routine is invoked upon determination of a node type.
  *  Since this is a device-only filesystem, so there is only
  *  one node type in the system.
@@ -173,6 +187,7 @@ extern rtems_filesystem_node_types_t devFS_node_type(
 );
 
 /**
+ *  @brief Creates an item in the main device table.
  *  This routine is invoked upon registration of a new device
  *  file. It is responsible for creating a item in the main
  *  device table. This routine searches the device table in
@@ -192,6 +207,7 @@ extern int devFS_mknod(
 
 
 /**
+ *  @brief Creates the Main Device Table
  *  This routine is invoked upon rtems filesystem initialization.
  *  It is responsible for creating the main device table,
  *  initializing it to a known state, and set device file operation
@@ -225,7 +241,7 @@ extern int devFS_initialize(
  */
 
 extern void devFS_Show(void);
-
+/** @} */
 #ifdef __cplusplus
 }
 #endif
diff --git a/cpukit/libfs/src/devfs/devfs_eval.c b/cpukit/libfs/src/devfs/devfs_eval.c
index 6af27d6..a313afc 100644
--- a/cpukit/libfs/src/devfs/devfs_eval.c
+++ b/cpukit/libfs/src/devfs/devfs_eval.c
@@ -1,3 +1,10 @@
+/**
+ * @file
+ *
+ * @brief Evaluate Patch
+ * @ingroup DevFsDeviceTable Define Device Table Type
+ */
+
 /*
  *  The license and distribution terms for this file may be
  *  found in the file LICENSE in this distribution or at
diff --git a/cpukit/libfs/src/devfs/devfs_init.c b/cpukit/libfs/src/devfs/devfs_init.c
index 7ec3d9f..e0dbe2f 100644
--- a/cpukit/libfs/src/devfs/devfs_init.c
+++ b/cpukit/libfs/src/devfs/devfs_init.c
@@ -1,3 +1,10 @@
+/**
+ * @file
+ *
+ * @brief Creates the Main Device Table
+ * @ingroup DevFsDeviceTable Define Device Table Type
+ */
+
 /*
  *  The license and distribution terms for this file may be
  *  found in the file LICENSE in this distribution or at
diff --git a/cpukit/libfs/src/devfs/devfs_mknod.c b/cpukit/libfs/src/devfs/devfs_mknod.c
index a2ab08a..eeee4d8 100644
--- a/cpukit/libfs/src/devfs/devfs_mknod.c
+++ b/cpukit/libfs/src/devfs/devfs_mknod.c
@@ -1,3 +1,10 @@
+/**
+ * @file
+ *
+ * @brief Creates an item in the main device table.
+ * @ingroup DevFsDeviceTable Define Device Table Type
+ */
+
 /*
  *  The license and distribution terms for this file may be
  *  found in the file LICENSE in this distribution or at
diff --git a/cpukit/libfs/src/devfs/devfs_node_type.c b/cpukit/libfs/src/devfs/devfs_node_type.c
index db92c6c..ed9ee86 100644
--- a/cpukit/libfs/src/devfs/devfs_node_type.c
+++ b/cpukit/libfs/src/devfs/devfs_node_type.c
@@ -1,3 +1,10 @@
+/**
+ * @file
+ *
+ * @brief Invoked upon Determination of a Node Type
+ * @ingroup DevFsDeviceTable Define Device Table Type
+ */
+
 /*
  *  The license and distribution terms for this file may be
  *  found in the file LICENSE in this distribution or at
diff --git a/cpukit/libfs/src/devfs/devioctl.c b/cpukit/libfs/src/devfs/devioctl.c
index e1d62c4..2c5e7db 100644
--- a/cpukit/libfs/src/devfs/devioctl.c
+++ b/cpukit/libfs/src/devfs/devioctl.c
@@ -1,3 +1,10 @@
+/**
+ * @file
+ *
+ * @brief Maps ioctl Operation to rtems_io_ioctl
+ * @ingroup DevFsDeviceTable Define Device Table Type
+ */
+
 /*
  *  The license and distribution terms for this file may be
  *  found in the file LICENSE in this distribution or at
diff --git a/cpukit/libfs/src/devfs/devopen.c b/cpukit/libfs/src/devfs/devopen.c
index 26450ab..2bd68a5 100644
--- a/cpukit/libfs/src/devfs/devopen.c
+++ b/cpukit/libfs/src/devfs/devopen.c
@@ -1,3 +1,10 @@
+/**
+ * @file
+ *
+ * @brief Maps Open Operation to rtems_io_open
+ * @ingroup DevFsDeviceTable Define Device Table Type
+ */
+
 /*
  *  The license and distribution terms for this file may be
  *  found in the file LICENSE in this distribution or at
diff --git a/cpukit/libfs/src/devfs/devread.c b/cpukit/libfs/src/devfs/devread.c
index 25d69b0..dac88e1 100644
--- a/cpukit/libfs/src/devfs/devread.c
+++ b/cpukit/libfs/src/devfs/devread.c
@@ -1,3 +1,10 @@
+/**
+ * @file
+ *
+ * @brief DevFS Read
+ * @ingroup Read Operation to rtems_io_read
+ */
+
 /*
  *  The license and distribution terms for this file may be
  *  found in the file LICENSE in this distribution or at
diff --git a/cpukit/libfs/src/devfs/devwrite.c b/cpukit/libfs/src/devfs/devwrite.c
index 57e7fdb..93087e2 100644
--- a/cpukit/libfs/src/devfs/devwrite.c
+++ b/cpukit/libfs/src/devfs/devwrite.c
@@ -1,3 +1,10 @@
+/**
+ * @file
+ *
+ * @brief Writes Operation to rtems_io_write
+ * @ingroup DevFsDeviceTable Define Device Table Type
+ */
+
 /*
  *  The license and distribution terms for this file may be
  *  found in the file LICENSE in this distribution or at




More information about the vc mailing list