7 files changed, 46 insertions, 16 deletions
diff --git a/cpukit/include/rtems/bspIo.h b/cpukit/include/rtems/bspIo.h
index 372dbd4970..537100927f 100644
--- a/cpukit/include/rtems/bspIo.h
+++ b/cpukit/include/rtems/bspIo.h
@@ -1,9 +1,12 @@
-/* bspIo.h
- *
- *  This include file contains declaration of interface that
- *  will be provided by the file contained in this directory.
+/**
+ * @file rtems/bspIo.h
  *
+ * This include file defines the interface to kernel print methods.
+ */
+
+/*
  *  COPYRIGHT (c) 1998 valette@crf.canon.fr
+ *  COPYRIGHT (c) 2011 On-Line Applications Research Corporation.
  *
  *  The license and distribution terms for this file may be
  *  found in the file LICENSE in this distribution or at
diff --git a/cpukit/include/rtems/concat.h b/cpukit/include/rtems/concat.h
index 02d45f21a4..22036b464e 100644
--- a/cpukit/include/rtems/concat.h
+++ b/cpukit/include/rtems/concat.h
@@ -1,3 +1,9 @@
+/**
+ * @file rtems/concat.h
+ *
+ * This include file defines ANSI concatenation macros.
+ */
+
 /*
  *  Copyright (c) 2004,2005 Ralf Corsepius, Ulm, Germany.
  *
diff --git a/cpukit/include/rtems/endian.h b/cpukit/include/rtems/endian.h
index 1321d244c2..90a7caeaa1 100644
--- a/cpukit/include/rtems/endian.h
+++ b/cpukit/include/rtems/endian.h
@@ -1,3 +1,9 @@
+/**
+ * @file rtems/endian.h
+ *
+ * This include file provides endian information about the target.
+ */
+
 /*
  *  $Id$
  */
diff --git a/cpukit/include/rtems/fs.h b/cpukit/include/rtems/fs.h
index cd8a8d5457..84b18370b5 100644
--- a/cpukit/include/rtems/fs.h
+++ b/cpukit/include/rtems/fs.h
@@ -1,7 +1,11 @@
-/*
- *  Some basic filesystem types
+/**
+ * @file rtems/fs.h
  *
- *  COPYRIGHT (c) 1989-1999.
+ * This file defines basic filesystem types
+ */
+
+/*
+ *  COPYRIGHT (c) 1989-2011.
  *  On-Line Applications Research Corporation (OAR).
  *
  *  The license and distribution terms for this file may be
diff --git a/cpukit/include/rtems/irq.h b/cpukit/include/rtems/irq.h
index 0da13067b4..154a28e067 100644
--- a/cpukit/include/rtems/irq.h
+++ b/cpukit/include/rtems/irq.h
@@ -1,8 +1,11 @@
-/*
- *
- *  This include file describe the data structure and the functions implemented
- *  by rtems to write interrupt handlers.
+/**
+ * @file rtems/irq.h
  *
+ * This include file describe the data structure and the functions implemented
+ * by rtems to write interrupt handlers.
+ */
+
+/*
  *  CopyRight (C) 1998 valette@crf.canon.fr
  *
  *  This code is heavilly inspired by the public specification of STREAM V2
diff --git a/cpukit/include/rtems/pci.h b/cpukit/include/rtems/pci.h
index 0b47d9275c..50ce0af1e6 100644
--- a/cpukit/include/rtems/pci.h
+++ b/cpukit/include/rtems/pci.h
@@ -1,6 +1,10 @@
-/*
+/**
+ * @file rtems/pci.h
  *
- *  PCI defines and function prototypes
+ * PCI defines and function prototypes
+ */
+
+/*
  *  Copyright 1994, Drew Eckhardt
  *  Copyright 1997, 1998 Martin Mares <mj@atrey.karlin.mff.cuni.cz>
  *
diff --git a/cpukit/include/rtems/userenv.h b/cpukit/include/rtems/userenv.h
index b16374a6dc..ca27c54b15 100644
--- a/cpukit/include/rtems/userenv.h
+++ b/cpukit/include/rtems/userenv.h
@@ -1,7 +1,11 @@
-/*
- *  Libio Internal Information
+/**
+ * @file rtems/userenv.h
  *
- *  COPYRIGHT (c) 1989-1999.
+ * This file defines the interface for POSIX per-process environment.
+ */
+
+/*
+ *  COPYRIGHT (c) 1989-2011.
  *  On-Line Applications Research Corporation (OAR).
  *
  *  The license and distribution terms for this file may be