[rtems commit] Header File Doxygen Enhancement Task #1

Jennifer Averett jennifer at rtems.org
Fri Dec 28 23:45:46 UTC 2012


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

Author:    Alex Ivanov <alexivanov97 at gmail.com>
Date:      Fri Dec 28 17:48:12 2012 -0600

Header File Doxygen Enhancement Task #1

---

 cpukit/include/rtems/status-checks.h           |    2 +-
 cpukit/include/rtems/userenv.h                 |    1 +
 cpukit/libblock/include/rtems/bdbuf.h          |    3 +--
 cpukit/libblock/include/rtems/ide_part_table.h |    6 +++---
 cpukit/libblock/include/rtems/ramdisk.h        |    4 +---
 cpukit/libcsupport/include/rtems/libcsupport.h |    6 ++++--
 cpukit/libcsupport/include/rtems/libio_.h      |    4 +++-
 cpukit/libcsupport/include/vmeintr.h           |    4 +++-
 cpukit/libfs/src/devfs/devfs.h                 |   10 ++++++----
 cpukit/libfs/src/rfs/rtems-rfs-shell.h         |   19 +++++++++++--------
 cpukit/libmisc/devnull/devnull.h               |    4 +++-
 cpukit/libmisc/dumpbuf/dumpbuf.h               |    4 +++-
 cpukit/libmisc/mouse/serial_mouse.h            |   16 +++++++++-------
 cpukit/libmisc/untar/untar.h                   |    4 +++-
 cpukit/libnetworking/memory.h                  |    4 ++--
 cpukit/posix/include/aio.h                     |    4 +++-
 cpukit/posix/include/mqueue.h                  |    4 +++-
 cpukit/sapi/include/rtems/io.h                 |    4 +---
 cpukit/sapi/include/rtems/timespec.h           |    8 +++-----
 cpukit/score/include/rtems/system.h            |   10 ++++++----
 20 files changed, 70 insertions(+), 51 deletions(-)

diff --git a/cpukit/include/rtems/status-checks.h b/cpukit/include/rtems/status-checks.h
index ce23e25..631c9f4 100644
--- a/cpukit/include/rtems/status-checks.h
+++ b/cpukit/include/rtems/status-checks.h
@@ -1,7 +1,7 @@
 /**
  * @file
  *
- * @brief Header file for status checks.
+ * @brief Header File for Status Checks
  *
  * @warning Do not include this file in other header files.  Use it only in
  * source files.
diff --git a/cpukit/include/rtems/userenv.h b/cpukit/include/rtems/userenv.h
index 8cc7a7c..53ec42d 100644
--- a/cpukit/include/rtems/userenv.h
+++ b/cpukit/include/rtems/userenv.h
@@ -2,6 +2,7 @@
  * @file
  *
  * @ingroup LibIOEnv
+ * @brief User Environment Support
  */
 
 /*
diff --git a/cpukit/libblock/include/rtems/bdbuf.h b/cpukit/libblock/include/rtems/bdbuf.h
index 7f1c13d..197c20d 100644
--- a/cpukit/libblock/include/rtems/bdbuf.h
+++ b/cpukit/libblock/include/rtems/bdbuf.h
@@ -2,8 +2,7 @@
  * @file
  *
  * @ingroup rtems_bdbuf
- *
- * Block device buffer management.
+ * @brief Block Device Buffer Management
  */
 
 /*
diff --git a/cpukit/libblock/include/rtems/ide_part_table.h b/cpukit/libblock/include/rtems/ide_part_table.h
index ea3dcb3..3868a3d 100644
--- a/cpukit/libblock/include/rtems/ide_part_table.h
+++ b/cpukit/libblock/include/rtems/ide_part_table.h
@@ -1,7 +1,7 @@
 /**
- * @file rtems/ide_part_table.h
- *
- * Support for "MS-DOS-style" partition tables
+ * @file
+ * 
+ * @brief "MS-DOS-style" Partition Tables Support
  */
 
 /*
diff --git a/cpukit/libblock/include/rtems/ramdisk.h b/cpukit/libblock/include/rtems/ramdisk.h
index 690864c..aaa940b 100644
--- a/cpukit/libblock/include/rtems/ramdisk.h
+++ b/cpukit/libblock/include/rtems/ramdisk.h
@@ -1,9 +1,7 @@
 /**
  * @file
  *
- * @ingroup rtems_ramdisk
- *
- * @brief RAM disk block device API.
+ * @brief RAM Disk Block Device API
  */
 
 /*
diff --git a/cpukit/libcsupport/include/rtems/libcsupport.h b/cpukit/libcsupport/include/rtems/libcsupport.h
index 2c49884..32ed8a8 100644
--- a/cpukit/libcsupport/include/rtems/libcsupport.h
+++ b/cpukit/libcsupport/include/rtems/libcsupport.h
@@ -1,6 +1,8 @@
 /**
- * @file rtems/libcsupport.h
- *
+ * @file
+ * 
+ * @brief Standard C Library Support
+ * 
  * This include file contains the information regarding the
  * RTEMS specific support for the standard C library.
  */
diff --git a/cpukit/libcsupport/include/rtems/libio_.h b/cpukit/libcsupport/include/rtems/libio_.h
index 6ef4b6c..c8e91de 100644
--- a/cpukit/libcsupport/include/rtems/libio_.h
+++ b/cpukit/libcsupport/include/rtems/libio_.h
@@ -1,6 +1,8 @@
 /**
- * @file rtems/libio_.h
+ * @file
  *
+ * @brief LibIO Internal Interface
+ * 
  * This file is the libio internal interface.
  */
 
diff --git a/cpukit/libcsupport/include/vmeintr.h b/cpukit/libcsupport/include/vmeintr.h
index 7e88bd0..4fdc8ac 100644
--- a/cpukit/libcsupport/include/vmeintr.h
+++ b/cpukit/libcsupport/include/vmeintr.h
@@ -1,5 +1,7 @@
 /**
- * @file rtems/vmeintr.h
+ * @file
+ * 
+ * @brief VMEbus Interface Library
  *
  *  This file is the specification for the VMEbus interface library
  *  which should be provided by all BSPs for VMEbus Single Board
diff --git a/cpukit/libfs/src/devfs/devfs.h b/cpukit/libfs/src/devfs/devfs.h
index 2317b10..0f5e248 100644
--- a/cpukit/libfs/src/devfs/devfs.h
+++ b/cpukit/libfs/src/devfs/devfs.h
@@ -1,8 +1,10 @@
 /**
-*  @file  libfs/devfs/devfs.h
-*
-*  This include file contains all constants and structures associated
-*  with the 'device-only' filesystem.
+* @file 
+* 
+* @brief 'device-only' File System Support
+*  
+* This include file contains all constants and structures associated
+* with the 'device-only' filesystem.
 */
 
 #ifndef _RTEMS_DEVFS_H
diff --git a/cpukit/libfs/src/rfs/rtems-rfs-shell.h b/cpukit/libfs/src/rfs/rtems-rfs-shell.h
index f4e5622..135290d 100644
--- a/cpukit/libfs/src/rfs/rtems-rfs-shell.h
+++ b/cpukit/libfs/src/rfs/rtems-rfs-shell.h
@@ -1,17 +1,20 @@
-/*
- *  COPYRIGHT (c) 2010 Chris Johns <chrisj at rtems.org>
- *
- *  The license and distribution terms for this file may be
- *  found in the file LICENSE in this distribution or at
- *  http://www.rtems.com/license/LICENSE.
- */
 /**
  * @file
  *
+ * 
  * @ingroup rtems-rfs
+ * @brief RTEMS File Systems Shell Commands
  *
  * RTEMS File Systems Shell commands provide a CLI interface to support and
- * development od the RFS file system.
+ * development of the RFS file system.
+ */
+
+/*
+ *  COPYRIGHT (c) 2010 Chris Johns <chrisj at rtems.org>
+ *
+ *  The license and distribution terms for this file may be
+ *  found in the file LICENSE in this distribution or at
+ *  http://www.rtems.com/license/LICENSE.
  */
 
 #if !defined (_RTEMS_RFS_SHELL_H_)
diff --git a/cpukit/libmisc/devnull/devnull.h b/cpukit/libmisc/devnull/devnull.h
index 84e1475..61fa60a 100644
--- a/cpukit/libmisc/devnull/devnull.h
+++ b/cpukit/libmisc/devnull/devnull.h
@@ -1,6 +1,8 @@
 /**
- * @file rtems/devnull.h
+ * @file
  *
+ * @brief RTEMS /dev/null Device Driver
+ * 
  * This include file defines the interface to the RTEMS /dev/null
  * device driver.
  */
diff --git a/cpukit/libmisc/dumpbuf/dumpbuf.h b/cpukit/libmisc/dumpbuf/dumpbuf.h
index d03274a..02e5304 100644
--- a/cpukit/libmisc/dumpbuf/dumpbuf.h
+++ b/cpukit/libmisc/dumpbuf/dumpbuf.h
@@ -1,6 +1,8 @@
 /**
- * @file rtems/dumpbuf.h
+ * @file
  *
+ * @brief Print a Memory Buffer
+ * 
  * This file defines the interface to the RTEMS methods to print a
  * memory buffer in a style similar to many ROM monitors and debuggers.
  */
diff --git a/cpukit/libmisc/mouse/serial_mouse.h b/cpukit/libmisc/mouse/serial_mouse.h
index a84bf7f..44d4633 100644
--- a/cpukit/libmisc/mouse/serial_mouse.h
+++ b/cpukit/libmisc/mouse/serial_mouse.h
@@ -1,13 +1,15 @@
 /**
- * @file rtems/serial_mouse.h
+ * @file
+ * 
+ * @brief Serial Mouse Driver
  *
- *  This file describes the Serial Mouse Driver for all boards.
- *  This driver assumes that the BSP or application will provide
- *  an implementation of the method bsp_get_serial_mouse_device()
- *  which tells the driver what serial port device to open() and
- *  what type of mouse is connected.
+ * This file describes the Serial Mouse Driver for all boards.
+ * This driver assumes that the BSP or application will provide
+ * an implementation of the method bsp_get_serial_mouse_device()
+ * which tells the driver what serial port device to open() and
+ * what type of mouse is connected.
  *
- *  This driver relies on the Mouse Parser Engine.
+ * This driver relies on the Mouse Parser Engine.
  */
 
 /*
diff --git a/cpukit/libmisc/untar/untar.h b/cpukit/libmisc/untar/untar.h
index 81cbd0e..84b0efe 100644
--- a/cpukit/libmisc/untar/untar.h
+++ b/cpukit/libmisc/untar/untar.h
@@ -1,6 +1,8 @@
 /**
- * @file rtems/untar.h
+ * @file
  *
+ * @brief Untar an Image
+ * 
  * This file defines the interface to methods which can untar an image.
  */
 
diff --git a/cpukit/libnetworking/memory.h b/cpukit/libnetworking/memory.h
index 99fdb5e..ee8bd40 100644
--- a/cpukit/libnetworking/memory.h
+++ b/cpukit/libnetworking/memory.h
@@ -1,7 +1,7 @@
 /**
- * @file memory.h
+ * @file
  *
- * Dummy include file for FreeBSD routines
+ * @brief Dummy Include File for FreeBSD Routines
  */
 
 #include <string.h>
diff --git a/cpukit/posix/include/aio.h b/cpukit/posix/include/aio.h
index f4f824a..3ad7a40 100644
--- a/cpukit/posix/include/aio.h
+++ b/cpukit/posix/include/aio.h
@@ -1,6 +1,8 @@
 /**
- * @file aio.h
+ * @file
  *
+ * @brief POSIX Asynchronous Input and Output
+ * 
  * This file contains the definitions related to POSIX Asynchronous
  * Input and Output,
  */
diff --git a/cpukit/posix/include/mqueue.h b/cpukit/posix/include/mqueue.h
index a35d94c..0f937f5 100644
--- a/cpukit/posix/include/mqueue.h
+++ b/cpukit/posix/include/mqueue.h
@@ -1,6 +1,8 @@
 /**
- * @file mqueue.h
+ * @file
  *
+ * @brief POSIX Message Queues
+ * 
  * This file contains the definitions related to POSIX Message Queues.
  * 
  * The structure of the routines is identical to that of POSIX
diff --git a/cpukit/sapi/include/rtems/io.h b/cpukit/sapi/include/rtems/io.h
index 2a268fa..8f02a34 100644
--- a/cpukit/sapi/include/rtems/io.h
+++ b/cpukit/sapi/include/rtems/io.h
@@ -1,9 +1,7 @@
 /**
  * @file
  *
- * @ingroup ClassicIO
- *
- * @brief Classic Input/Output Manager API.
+ * @brief Classic Input/Output Manager API
  * 
  * This file emulates the old Classic RTEMS IO manager directives
  * which register and lookup names using the in-memory filesystem.
diff --git a/cpukit/sapi/include/rtems/timespec.h b/cpukit/sapi/include/rtems/timespec.h
index d502de3..fcea746 100644
--- a/cpukit/sapi/include/rtems/timespec.h
+++ b/cpukit/sapi/include/rtems/timespec.h
@@ -1,11 +1,9 @@
 /**
- *  @file  rtems/sapi/timespec.h
+ * @file
  *
- *  @ingroup 
+ * @brief Timespec API
  *
- *  @brief Timespec API
- *
- *  This include file contains API for manipulating timespecs.
+ * This include file contains API for manipulating timespecs.
  */
 
 /*
diff --git a/cpukit/score/include/rtems/system.h b/cpukit/score/include/rtems/system.h
index 46f080b..96318f7 100644
--- a/cpukit/score/include/rtems/system.h
+++ b/cpukit/score/include/rtems/system.h
@@ -1,9 +1,11 @@
 /**
- *  @file  rtems/system.h
+ * @file
+ * 
+ * @brief Information Included in Every Function in the Executive
  *
- *  This include file contains information that is included in every
- *  function in the executive.  This must be the first include file
- *  included in all internal RTEMS files.
+ * This include file contains information that is included in every
+ * function in the executive.  This must be the first include file
+ * included in all internal RTEMS files.
  */
 
 /*




More information about the vc mailing list