Add comments and DoxyGen format for these files.

git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@5028 6f19259b-4bc3-4df7-8a09-765794883524

34 files changed, 176 insertions, 403 deletions

diff --git a/MdeModulePkg/Core/Dxe/DebugImageInfo.h b/MdeModulePkg/Core/Dxe/DebugImageInfo.h
index 006f629cf2..5f05a90a52 100644
--- a/MdeModulePkg/Core/Dxe/DebugImageInfo.h
+++ b/MdeModulePkg/Core/Dxe/DebugImageInfo.h
@@ -1,6 +1,9 @@
-/*++

+/** @file 

 

-Copyright (c) 2006, Intel Corporation                                                         

+  Support functions for managing debug image info table when loading and unloading

+  images.

+

+Copyright (c) 2006 - 2008, Intel Corporation                                                         

 All rights reserved. This program and the accompanying materials                          

 are licensed and made available under the terms and conditions of the BSD License         

 which accompanies this distribution.  The full text of the license may be found at        

@@ -9,16 +12,7 @@ http://opensource.org/licenses/bsd-license.php
 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,                     

 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.             

 

-Module Name:

-

-  DebugImageInfo.h

-    

-Abstract:

-

-  Support functions for managing debug image info table when loading and unloading

-  images.

-

---*/

+**/

 

 #ifndef __DEBUG_IMAGE_INFO_H__

 #define __DEBUG_IMAGE_INFO_H__

diff --git a/MdeModulePkg/Core/Dxe/Dispatcher/dependency.c b/MdeModulePkg/Core/Dxe/Dispatcher/dependency.c
index 84c44a10ee..62bdb14e40 100644
--- a/MdeModulePkg/Core/Dxe/Dispatcher/dependency.c
+++ b/MdeModulePkg/Core/Dxe/Dispatcher/dependency.c
@@ -1,6 +1,12 @@
-/*++ 

+/** @file

 

-Copyright (c) 2006, Intel Corporation                                                         

+  DXE Dispatcher Dependency Evaluator

+

+  This routine evaluates a dependency expression (DEPENDENCY_EXPRESSION) to determine

+  if a driver can be scheduled for execution.  The criteria for

+  schedulability is that the dependency expression is satisfied.

+

+Copyright (c) 2006 - 2008, Intel Corporation                                                         

 All rights reserved. This program and the accompanying materials                          

 are licensed and made available under the terms and conditions of the BSD License         

 which accompanies this distribution.  The full text of the license may be found at        

@@ -9,19 +15,7 @@ http://opensource.org/licenses/bsd-license.php
 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,                     

 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.             

 

-Module Name:

-

-  dependency.c

-

-Abstract:

-

-  DXE Dispatcher Dependency Evaluator

-

-  This routine evaluates a dependency expression (DEPENDENCY_EXPRESSION) to determine

-  if a driver can be scheduled for execution.  The criteria for

-  schedulability is that the dependency expression is satisfied.

-

---*/

+**/

 

 #include <DxeMain.h>

 

diff --git a/MdeModulePkg/Core/Dxe/DxeMain.h b/MdeModulePkg/Core/Dxe/DxeMain.h
index f0f57fe207..2830e10a03 100644
--- a/MdeModulePkg/Core/Dxe/DxeMain.h
+++ b/MdeModulePkg/Core/Dxe/DxeMain.h
@@ -1,5 +1,7 @@
 /**@file

-  Header file of DxeCore

+

+  The internal header file includes the common header files, defines

+  internal structure and functions used by DxeCore module.

   

 Copyright (c) 2006 - 2007, Intel Corporation                                                         

 All rights reserved. This program and the accompanying materials                          

diff --git a/MdeModulePkg/Core/Dxe/DxeMain/DxeProtocolNotify.c b/MdeModulePkg/Core/Dxe/DxeMain/DxeProtocolNotify.c
index 5c9a5b8e89..a3d4bbaaac 100644
--- a/MdeModulePkg/Core/Dxe/DxeMain/DxeProtocolNotify.c
+++ b/MdeModulePkg/Core/Dxe/DxeMain/DxeProtocolNotify.c
@@ -1,6 +1,10 @@
-/*++

+/** @file 

 

-Copyright (c) 2006 - 2007, Intel Corporation

+  This file deals with Architecture Protocol (AP) registration in

+  the Dxe Core. The mArchProtocols[] array represents a list of

+  events that represent the Architectural Protocols.

+

+Copyright (c) 2006 - 2008, Intel Corporation

 All rights reserved. This program and the accompanying materials

 are licensed and made available under the terms and conditions of the BSD License

 which accompanies this distribution.  The full text of the license may be found at

@@ -9,17 +13,7 @@ http://opensource.org/licenses/bsd-license.php
 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,

 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.

 

-Module Name:

-

-  DxeProtocolNotify.c

-

-Abstract:

-

-  This file deals with Architecture Protocol (AP) registration in

-  the Dxe Core. The mArchProtocols[] array represents a list of

-  events that represent the Architectural Protocols.

-

---*/

+**/

 

 #include <DxeMain.h>

 

diff --git a/MdeModulePkg/Core/Dxe/Event/event.c b/MdeModulePkg/Core/Dxe/Event/event.c
index 81f0b1af10..13949169a0 100644
--- a/MdeModulePkg/Core/Dxe/Event/event.c
+++ b/MdeModulePkg/Core/Dxe/Event/event.c
@@ -1,6 +1,8 @@
-/*++

+/** @file 

+

+  UEFI Event support functions implemented in this file.

 

-Copyright (c) 2006 - 2007, Intel Corporation

+Copyright (c) 2006 - 2008, Intel Corporation

 All rights reserved. This program and the accompanying materials

 are licensed and made available under the terms and conditions of the BSD License

 which accompanies this distribution.  The full text of the license may be found at

@@ -9,15 +11,7 @@ http://opensource.org/licenses/bsd-license.php
 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,

 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.

 

-Module Name:

-

-    event.c

-

-Abstract:

-

-    EFI Event support

-

---*/

+**/

 

 

 #include <DxeMain.h>

diff --git a/MdeModulePkg/Core/Dxe/Event/execdata.c b/MdeModulePkg/Core/Dxe/Event/execdata.c
index a6d388ac21..fa36e9f16b 100644
--- a/MdeModulePkg/Core/Dxe/Event/execdata.c
+++ b/MdeModulePkg/Core/Dxe/Event/execdata.c
@@ -1,6 +1,8 @@
-/*++

+/** @file 

 

-Copyright (c) 2006, Intel Corporation                                                         

+  Event data is declared in this file. 

+  

+Copyright (c) 2006 - 2008, Intel Corporation                                                         

 All rights reserved. This program and the accompanying materials                          

 are licensed and made available under the terms and conditions of the BSD License         

 which accompanies this distribution.  The full text of the license may be found at        

@@ -9,18 +11,7 @@ http://opensource.org/licenses/bsd-license.php
 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,                     

 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.             

 

-Module Name:

-  

-  execdata.c

-

-Abstract:

-

-

-

-

-Revision History

-

---*/

+**/

 

 #include <DxeMain.h>

 

diff --git a/MdeModulePkg/Core/Dxe/Event/timer.c b/MdeModulePkg/Core/Dxe/Event/timer.c
index 0f886f96d3..7a49c2a3bd 100644
--- a/MdeModulePkg/Core/Dxe/Event/timer.c
+++ b/MdeModulePkg/Core/Dxe/Event/timer.c
@@ -1,6 +1,8 @@
-/*++

+/** @file 

+

+  Core Timer Services

 

-Copyright (c) 2006, Intel Corporation

+Copyright (c) 2006 - 2008, Intel Corporation

 All rights reserved. This program and the accompanying materials

 are licensed and made available under the terms and conditions of the BSD License

 which accompanies this distribution.  The full text of the license may be found at

@@ -9,17 +11,7 @@ http://opensource.org/licenses/bsd-license.php
 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,

 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.

 

-Module Name:

-

-  timer.c

-

-Abstract:

-

-  EFI Event support

-

-Revision History

-

---*/

+**/

 

 

 #include <DxeMain.h>

diff --git a/MdeModulePkg/Core/Dxe/Event/tpl.c b/MdeModulePkg/Core/Dxe/Event/tpl.c
index 437665faed..694d731712 100644
--- a/MdeModulePkg/Core/Dxe/Event/tpl.c
+++ b/MdeModulePkg/Core/Dxe/Event/tpl.c
@@ -1,6 +1,8 @@
-/*++

+/** @file 

+

+  Task priority (TPL) function 

 

-Copyright (c) 2006, Intel Corporation                                                         

+Copyright (c) 2006 - 2008, Intel Corporation                                                         

 All rights reserved. This program and the accompanying materials                          

 are licensed and made available under the terms and conditions of the BSD License         

 which accompanies this distribution.  The full text of the license may be found at        

@@ -9,15 +11,7 @@ http://opensource.org/licenses/bsd-license.php
 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,                     

 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.             

 

-Module Name:

-

-    tpl.c

-

-Abstract:

-

-    Task priority function    

-

---*/

+**/

 

 #include <DxeMain.h>

 

diff --git a/MdeModulePkg/Core/Dxe/Exec.h b/MdeModulePkg/Core/Dxe/Exec.h
index 5df700113d..7ead363a3b 100644
--- a/MdeModulePkg/Core/Dxe/Exec.h
+++ b/MdeModulePkg/Core/Dxe/Exec.h
@@ -1,6 +1,8 @@
-/*++

+/** @file 

+

+  UEFI Event support functions and structure.

 

-Copyright (c) 2006, Intel Corporation                                                         

+Copyright (c) 2006 - 2008, Intel Corporation                                                         

 All rights reserved. This program and the accompanying materials                          

 are licensed and made available under the terms and conditions of the BSD License         

 which accompanies this distribution.  The full text of the license may be found at        

@@ -9,15 +11,7 @@ http://opensource.org/licenses/bsd-license.php
 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,                     

 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.             

 

-Module Name:

-  

-  exec.h

-

-Abstract:

-    

-  EFI Event support

-

---*/

+**/

 

 #ifndef _EXEC_H_

 #define _EXEC_H_

diff --git a/MdeModulePkg/Core/Dxe/FwVol/Ffs.c b/MdeModulePkg/Core/Dxe/FwVol/Ffs.c
index 23c84b34f8..b62fab9cd9 100644
--- a/MdeModulePkg/Core/Dxe/FwVol/Ffs.c
+++ b/MdeModulePkg/Core/Dxe/FwVol/Ffs.c
@@ -1,6 +1,8 @@
-/*++

+/** @file 

+

+  FFS file access utilities.

 

-Copyright (c) 2006, Intel Corporation                                                         

+Copyright (c) 2006 - 2008, Intel Corporation                                                         

 All rights reserved. This program and the accompanying materials                          

 are licensed and made available under the terms and conditions of the BSD License         

 which accompanies this distribution.  The full text of the license may be found at        

@@ -9,15 +11,7 @@ http://opensource.org/licenses/bsd-license.php
 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,                     

 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.             

 

-Module Name:

-

-  Ffs.c

-

-Abstract:

-

-  FFS file access utilities.

-

---*/

+**/

 

 

 #include <DxeMain.h>

diff --git a/MdeModulePkg/Core/Dxe/FwVol/FwVolAttrib.c b/MdeModulePkg/Core/Dxe/FwVol/FwVolAttrib.c
index 280978ed1a..54abc0bfd6 100644
--- a/MdeModulePkg/Core/Dxe/FwVol/FwVolAttrib.c
+++ b/MdeModulePkg/Core/Dxe/FwVol/FwVolAttrib.c
@@ -1,6 +1,8 @@
-/*++

+/** @file 

+

+  Implements get/set firmware volume attributes

 

-Copyright (c) 2006, Intel Corporation                                                         

+Copyright (c) 2006 - 2008, Intel Corporation                                                         

 All rights reserved. This program and the accompanying materials                          

 are licensed and made available under the terms and conditions of the BSD License         

 which accompanies this distribution.  The full text of the license may be found at        

@@ -9,15 +11,7 @@ http://opensource.org/licenses/bsd-license.php
 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,                     

 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.             

 

-Module Name:

-

-  FwVolAttrib.c

-

-Abstract:

-

-  Implements get/set firmware volume attributes

-

---*/

+**/

 

 #include <DxeMain.h>

 

diff --git a/MdeModulePkg/Core/Dxe/FwVol/FwVolRead.c b/MdeModulePkg/Core/Dxe/FwVol/FwVolRead.c
index becc19e999..5b5b6599e5 100644
--- a/MdeModulePkg/Core/Dxe/FwVol/FwVolRead.c
+++ b/MdeModulePkg/Core/Dxe/FwVol/FwVolRead.c
@@ -1,6 +1,8 @@
-/*++

+/** @file 

+

+  Implements functions to read firmware file

 

-Copyright (c) 2006, Intel Corporation                                                         

+Copyright (c) 2006 - 2008, Intel Corporation                                                         

 All rights reserved. This program and the accompanying materials                          

 are licensed and made available under the terms and conditions of the BSD License         

 which accompanies this distribution.  The full text of the license may be found at        

@@ -9,15 +11,7 @@ http://opensource.org/licenses/bsd-license.php
 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,                     

 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.             

 

-Module Name:

-

-  FwVolRead.c

-

-Abstract:

-

-  Implements read firmware file

-

---*/

+**/

 

 #include <DxeMain.h>

 

diff --git a/MdeModulePkg/Core/Dxe/FwVol/FwVolWrite.c b/MdeModulePkg/Core/Dxe/FwVol/FwVolWrite.c
index bf075dca86..a053a96d43 100644
--- a/MdeModulePkg/Core/Dxe/FwVol/FwVolWrite.c
+++ b/MdeModulePkg/Core/Dxe/FwVol/FwVolWrite.c
@@ -1,6 +1,8 @@
-/*++

+/** @file 

+

+  Implements functions to write firmware file

 

-Copyright (c) 2006, Intel Corporation                                                         

+Copyright (c) 2006 - 2008, Intel Corporation                                                         

 All rights reserved. This program and the accompanying materials                          

 are licensed and made available under the terms and conditions of the BSD License         

 which accompanies this distribution.  The full text of the license may be found at        

@@ -9,15 +11,7 @@ http://opensource.org/licenses/bsd-license.php
 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,                     

 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.             

 

-Module Name:

-

-  FwVolWrite.c

-

-Abstract:

-

-  Implements write firmware file

-

---*/

+**/

 

 #include <DxeMain.h>

 

diff --git a/MdeModulePkg/Core/Dxe/FwVolBlock.h b/MdeModulePkg/Core/Dxe/FwVolBlock.h
index 1ba25c3282..9cd17326c9 100644
--- a/MdeModulePkg/Core/Dxe/FwVolBlock.h
+++ b/MdeModulePkg/Core/Dxe/FwVolBlock.h
@@ -1,6 +1,9 @@
-/*++

+/** @file 

 

-Copyright (c) 2006, Intel Corporation                                                         

+  Firmware Volume Block protocol functions.  

+  Consumes FV hobs and creates appropriate block protocols. 

+  

+Copyright (c) 2006 - 2008, Intel Corporation                                                         

 All rights reserved. This program and the accompanying materials                          

 are licensed and made available under the terms and conditions of the BSD License         

 which accompanies this distribution.  The full text of the license may be found at        

@@ -9,19 +12,7 @@ http://opensource.org/licenses/bsd-license.php
 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,                     

 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.             

 

-Module Name:

-

-  FwVolBlock.h

-

-Abstract:

-

-  Firmware Volume Block protocol..  Consumes FV hobs and creates

-  appropriate block protocols.

-

-  Also consumes NT_NON_MM_FV envinronment variable and produces appropriate

-  block protocols fro them also... (this is TBD)

-

---*/

+**/

 

 #ifndef _FWVOL_BLOCK_H_

 #define _FWVOL_BLOCK_H_

diff --git a/MdeModulePkg/Core/Dxe/FwVolDriver.h b/MdeModulePkg/Core/Dxe/FwVolDriver.h
index 27492b8077..6469670d04 100644
--- a/MdeModulePkg/Core/Dxe/FwVolDriver.h
+++ b/MdeModulePkg/Core/Dxe/FwVolDriver.h
@@ -1,8 +1,9 @@
 /**@file

+

   Firmware File System protocol. Layers on top of Firmware

   Block protocol to produce a file abstraction of FV based files.

   

-Copyright (c) 2006, Intel Corporation                                                         

+Copyright (c) 2006 - 2008, Intel Corporation                                                         

 All rights reserved. This program and the accompanying materials                          

 are licensed and made available under the terms and conditions of the BSD License         

 which accompanies this distribution.  The full text of the license may be found at        

diff --git a/MdeModulePkg/Core/Dxe/Gcd/gcd.c b/MdeModulePkg/Core/Dxe/Gcd/gcd.c
index 3cadab29dc..23477be047 100644
--- a/MdeModulePkg/Core/Dxe/Gcd/gcd.c
+++ b/MdeModulePkg/Core/Dxe/Gcd/gcd.c
@@ -1,6 +1,10 @@
-/*++

+/** @file 

+

+    The file contains the GCD related services in the EFI Boot Services Table.

+    The GCD services are used to manage the memory and I/O regions that 

+    are accessible to the CPU that is executing the DXE core.

 

-Copyright (c) 2006, Intel Corporation                                                         

+Copyright (c) 2006 - 2008, Intel Corporation                                                         

 All rights reserved. This program and the accompanying materials                          

 are licensed and made available under the terms and conditions of the BSD License         

 which accompanies this distribution.  The full text of the license may be found at        

@@ -9,16 +13,7 @@ http://opensource.org/licenses/bsd-license.php
 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,                     

 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.             

 

-Module Name:

-

-    gcd.c

-

-Abstract:

-    The file contains the GCD related services in the EFI Boot Services Table.

-    The GCD services are used to manage the memory and I/O regions that 

-    are accessible to the CPU that is executing the DXE core.

-

---*/

+**/

 

 #include <DxeMain.h>

 

diff --git a/MdeModulePkg/Core/Dxe/Hand/DriverSupport.c b/MdeModulePkg/Core/Dxe/Hand/DriverSupport.c
index bafb48ab1e..72ebc8e897 100644
--- a/MdeModulePkg/Core/Dxe/Hand/DriverSupport.c
+++ b/MdeModulePkg/Core/Dxe/Hand/DriverSupport.c
@@ -1,6 +1,8 @@
-/*++

+/** @file 

+

+  Support functions to connect/disconnect UEFI Driver model Protocol

 

-Copyright (c) 2006, Intel Corporation                                                         

+Copyright (c) 2006 - 2008, Intel Corporation                                                         

 All rights reserved. This program and the accompanying materials                          

 are licensed and made available under the terms and conditions of the BSD License         

 which accompanies this distribution.  The full text of the license may be found at        

@@ -9,17 +11,7 @@ http://opensource.org/licenses/bsd-license.php
 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,                     

 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.             

 

-Module Name:

-

-    DriverSupport.c

-    

-Abstract:

-

-    EFI Driver Support Protocol

-

-Revision History

-

---*/

+**/

 

 #include <DxeMain.h>

 

diff --git a/MdeModulePkg/Core/Dxe/Hand/Notify.c b/MdeModulePkg/Core/Dxe/Hand/Notify.c
index f48fee76cb..8d64a5c883 100644
--- a/MdeModulePkg/Core/Dxe/Hand/Notify.c
+++ b/MdeModulePkg/Core/Dxe/Hand/Notify.c
@@ -1,6 +1,8 @@
-/*++

+/** @file 

+

+  UEFI notify infrastructure

 

-Copyright (c) 2006, Intel Corporation                                                         

+Copyright (c) 2006 - 2008, Intel Corporation                                                         

 All rights reserved. This program and the accompanying materials                          

 are licensed and made available under the terms and conditions of the BSD License         

 which accompanies this distribution.  The full text of the license may be found at        

@@ -9,19 +11,7 @@ http://opensource.org/licenses/bsd-license.php
 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,                     

 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.             

 

-Module Name:

-

-  notify.c

-

-Abstract:

-

-  EFI notify infrastructure

-

-

-

-Revision History

-

---*/

+**/

 

 #include <DxeMain.h>

 

diff --git a/MdeModulePkg/Core/Dxe/Hand/handle.c b/MdeModulePkg/Core/Dxe/Hand/handle.c
index 42d96ff465..36d81997c9 100644
--- a/MdeModulePkg/Core/Dxe/Hand/handle.c
+++ b/MdeModulePkg/Core/Dxe/Hand/handle.c
@@ -1,6 +1,8 @@
-/*++

+/** @file 

+

+  UEFI handle & protocol handling

 

-Copyright (c) 2006 - 2007, Intel Corporation                                                         

+Copyright (c) 2006 - 2008, Intel Corporation                                                         

 All rights reserved. This program and the accompanying materials                          

 are licensed and made available under the terms and conditions of the BSD License         

 which accompanies this distribution.  The full text of the license may be found at        

@@ -9,19 +11,7 @@ http://opensource.org/licenses/bsd-license.php
 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,                     

 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.             

 

-Module Name:

-

-  handle.c

-

-Abstract:

-

-  EFI handle & protocol handling

-

-

-

-Revision History

-

---*/

+**/

 

 #include <DxeMain.h>

 

diff --git a/MdeModulePkg/Core/Dxe/Hand/locate.c b/MdeModulePkg/Core/Dxe/Hand/locate.c
index 54d72c30a2..959e988831 100644
--- a/MdeModulePkg/Core/Dxe/Hand/locate.c
+++ b/MdeModulePkg/Core/Dxe/Hand/locate.c
@@ -1,6 +1,8 @@
-/*++

+/** @file 

+

+  Locate handle functions 

 

-Copyright (c) 2006, Intel Corporation                                                         

+Copyright (c) 2006 - 2008, Intel Corporation                                                         

 All rights reserved. This program and the accompanying materials                          

 are licensed and made available under the terms and conditions of the BSD License         

 which accompanies this distribution.  The full text of the license may be found at        

@@ -9,17 +11,7 @@ http://opensource.org/licenses/bsd-license.php
 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,                     

 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.             

 

-Module Name:

-

-  locate.c

-

-Abstract:

-

-  Locate handle functions    

-

-Revision History

-

---*/

+**/

 

 #include <DxeMain.h>

 

diff --git a/MdeModulePkg/Core/Dxe/Image.h b/MdeModulePkg/Core/Dxe/Image.h
index eeeb3ab717..e233104a50 100644
--- a/MdeModulePkg/Core/Dxe/Image.h
+++ b/MdeModulePkg/Core/Dxe/Image.h
@@ -1,6 +1,8 @@
-/*++

-

-Copyright (c) 2006, Intel Corporation

+/** @file 

+  

+  Data structure and functions to load and unload PeImage.

+  

+Copyright (c) 2006 - 2008, Intel Corporation

 All rights reserved. This program and the accompanying materials

 are licensed and made available under the terms and conditions of the BSD License

 which accompanies this distribution.  The full text of the license may be found at

@@ -9,15 +11,7 @@ http://opensource.org/licenses/bsd-license.php
 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,

 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.

 

-Module Name:

-

-  Image.h

-

-Abstract:

-

-Revision History

-

---*/

+**/

 

 

 #ifndef _IMAGE_H_

diff --git a/MdeModulePkg/Core/Dxe/Image/Image.c b/MdeModulePkg/Core/Dxe/Image/Image.c
index ff22c9b0f5..094d837f3c 100644
--- a/MdeModulePkg/Core/Dxe/Image/Image.c
+++ b/MdeModulePkg/Core/Dxe/Image/Image.c
@@ -1,6 +1,8 @@
-/*++

+/** @file 

+

+  Core image handling services to load and unload PeImage.

 

-Copyright (c) 2006 - 2007, Intel Corporation

+Copyright (c) 2006 - 2008, Intel Corporation

 All rights reserved. This program and the accompanying materials

 are licensed and made available under the terms and conditions of the BSD License

 which accompanies this distribution.  The full text of the license may be found at

@@ -9,15 +11,7 @@ http://opensource.org/licenses/bsd-license.php
 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,

 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.

 

-Module Name:

-

-  Image.c

-

-Abstract:

-

-  Core image handling services

-

---*/

+**/

 

 #include <DxeMain.h>

 //

diff --git a/MdeModulePkg/Core/Dxe/Image/ImageFile.c b/MdeModulePkg/Core/Dxe/Image/ImageFile.c
index b9c8c657b8..7ff867e181 100644
--- a/MdeModulePkg/Core/Dxe/Image/ImageFile.c
+++ b/MdeModulePkg/Core/Dxe/Image/ImageFile.c
@@ -1,5 +1,7 @@
-/*++

-

+/** @file

+  

+  Handle services to image file. 

+   

 Copyright (c) 2006 - 2008, Intel Corporation

 All rights reserved. This program and the accompanying materials

 are licensed and made available under the terms and conditions of the BSD License

@@ -9,19 +11,7 @@ http://opensource.org/licenses/bsd-license.php
 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,

 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.

 

-Module Name:

-

-  ImageFile.c

-

-

-Abstract:

-

-

-

-

-Revision History

-

---*/

+**/

 

 #include <DxeMain.h>

 

diff --git a/MdeModulePkg/Core/Dxe/Library.h b/MdeModulePkg/Core/Dxe/Library.h
index 8d41bd251b..7c15c938e2 100644
--- a/MdeModulePkg/Core/Dxe/Library.h
+++ b/MdeModulePkg/Core/Dxe/Library.h
@@ -1,6 +1,8 @@
-/*++

+/** @file 

+

+  Internal functions shared in DxeCore module.

 

-Copyright (c) 2006, Intel Corporation                                                         

+Copyright (c) 2006 - 2008, Intel Corporation                                                         

 All rights reserved. This program and the accompanying materials                          

 are licensed and made available under the terms and conditions of the BSD License         

 which accompanies this distribution.  The full text of the license may be found at        

@@ -9,14 +11,6 @@ http://opensource.org/licenses/bsd-license.php
 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,                     

 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.             

 

-Module Name:

-

-  Library.h

-

-Abstract:

-

-Revision History

-

 --*/

 

 #ifndef _DXE_LIBRARY_H_

diff --git a/MdeModulePkg/Core/Dxe/Mem/Page.c b/MdeModulePkg/Core/Dxe/Mem/Page.c
index 97179dec85..daf00f237d 100644
--- a/MdeModulePkg/Core/Dxe/Mem/Page.c
+++ b/MdeModulePkg/Core/Dxe/Mem/Page.c
@@ -1,6 +1,8 @@
-/*++

+/** @file

+

+  UEFI Memory page management functions.

 

-Copyright (c) 2007, Intel Corporation                                                         

+Copyright (c) 2007 - 2008, Intel Corporation                                                         

 All rights reserved. This program and the accompanying materials                          

 are licensed and made available under the terms and conditions of the BSD License         

 which accompanies this distribution.  The full text of the license may be found at        

@@ -9,18 +11,7 @@ http://opensource.org/licenses/bsd-license.php
 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,                     

 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.             

 

-Module Name:

-

-  page.c

-

-Abstract:

-

-  EFI Memory page management

-

-

-Revision History

-

---*/

+**/

 

 #include <DxeMain.h>

 

diff --git a/MdeModulePkg/Core/Dxe/Mem/memdata.c b/MdeModulePkg/Core/Dxe/Mem/memdata.c
index 83a130dee3..6995e513ad 100644
--- a/MdeModulePkg/Core/Dxe/Mem/memdata.c
+++ b/MdeModulePkg/Core/Dxe/Mem/memdata.c
@@ -1,6 +1,8 @@
-/*++

+/** @file 

 

-Copyright (c) 2006, Intel Corporation                                                         

+  Global data used in memory service

+

+Copyright (c) 2006 - 2008, Intel Corporation                                                         

 All rights reserved. This program and the accompanying materials                          

 are licensed and made available under the terms and conditions of the BSD License         

 which accompanies this distribution.  The full text of the license may be found at        

@@ -9,18 +11,7 @@ http://opensource.org/licenses/bsd-license.php
 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,                     

 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.             

 

-Module Name:

-

-  memdata.c

-

-Abstract:

-

-  Global data used in memory service

-

-

-Revision History

-

---*/

+**/

 

 #include <DxeMain.h>

 

diff --git a/MdeModulePkg/Core/Dxe/Mem/pool.c b/MdeModulePkg/Core/Dxe/Mem/pool.c
index 664df1422a..6a98cdcca1 100644
--- a/MdeModulePkg/Core/Dxe/Mem/pool.c
+++ b/MdeModulePkg/Core/Dxe/Mem/pool.c
@@ -1,6 +1,8 @@
-/*++

+/** @file 

+

+  UEFI Memory pool management functions.

 

-Copyright (c) 2006, Intel Corporation                                                         

+Copyright (c) 2006 - 2008, Intel Corporation                                                         

 All rights reserved. This program and the accompanying materials                          

 are licensed and made available under the terms and conditions of the BSD License         

 which accompanies this distribution.  The full text of the license may be found at        

@@ -9,17 +11,7 @@ http://opensource.org/licenses/bsd-license.php
 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,                     

 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.             

 

-Module Name:

-

-  pool.c

-

-Abstract:

-

-  EFI Memory pool management

-

-Revision History

-

---*/

+**/

 

 #include <DxeMain.h>

 

diff --git a/MdeModulePkg/Core/Dxe/Misc/DebugImageInfo.c b/MdeModulePkg/Core/Dxe/Misc/DebugImageInfo.c
index 3512477c8f..90e5738532 100644
--- a/MdeModulePkg/Core/Dxe/Misc/DebugImageInfo.c
+++ b/MdeModulePkg/Core/Dxe/Misc/DebugImageInfo.c
@@ -1,6 +1,9 @@
-/*++

+/** @file 

+

+  Support functions for managing debug image info table when loading and unloading

+  images.

 

-Copyright (c) 2006 - 2007, Intel Corporation                                                         

+Copyright (c) 2006 - 2008, Intel Corporation                                                         

 All rights reserved. This program and the accompanying materials                          

 are licensed and made available under the terms and conditions of the BSD License         

 which accompanies this distribution.  The full text of the license may be found at        

@@ -9,16 +12,7 @@ http://opensource.org/licenses/bsd-license.php
 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,                     

 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.             

 

-Module Name:

-

-  DebugImageInfo.c

-    

-Abstract:

-

-  Support functions for managing debug image info table when loading and unloading

-  images.

-

---*/

+**/

 

 #include <DxeMain.h>

 

diff --git a/MdeModulePkg/Core/Dxe/Misc/InstallConfigurationTable.c b/MdeModulePkg/Core/Dxe/Misc/InstallConfigurationTable.c
index 677a2108bf..26db2fbc1f 100644
--- a/MdeModulePkg/Core/Dxe/Misc/InstallConfigurationTable.c
+++ b/MdeModulePkg/Core/Dxe/Misc/InstallConfigurationTable.c
@@ -1,6 +1,8 @@
-/*++

+/** @file 

+

+  UEFI Miscellaneous boot Services InstallConfigurationTable service

 

-Copyright (c) 2006 - 2007, Intel Corporation                                                         

+Copyright (c) 2006 - 2008, Intel Corporation                                                         

 All rights reserved. This program and the accompanying materials                          

 are licensed and made available under the terms and conditions of the BSD License         

 which accompanies this distribution.  The full text of the license may be found at        

@@ -9,16 +11,7 @@ http://opensource.org/licenses/bsd-license.php
 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,                     

 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.             

 

-Module Name:

-

-  InstallConfigurationTable.c

-

-

-Abstract:

-

-  Tiano Miscellaneous Services InstallConfigurationTable service

-

---*/

+**/

 

 #include <DxeMain.h>

 

diff --git a/MdeModulePkg/Core/Dxe/Misc/SetWatchdogTimer.c b/MdeModulePkg/Core/Dxe/Misc/SetWatchdogTimer.c
index c11c926e06..94e8db35ab 100644
--- a/MdeModulePkg/Core/Dxe/Misc/SetWatchdogTimer.c
+++ b/MdeModulePkg/Core/Dxe/Misc/SetWatchdogTimer.c
@@ -1,6 +1,8 @@
-/*++

+/** @file 

+

+  UEFI Miscellaneous boot Services SetWatchdogTimer service implementation

 

-Copyright (c) 2006, Intel Corporation                                                         

+Copyright (c) 2006 - 2008, Intel Corporation                                                         

 All rights reserved. This program and the accompanying materials                          

 are licensed and made available under the terms and conditions of the BSD License         

 which accompanies this distribution.  The full text of the license may be found at        

@@ -9,15 +11,7 @@ http://opensource.org/licenses/bsd-license.php
 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,                     

 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.             

 

-Module Name:

-

-    SetWatchdogTimer.c

-

-Abstract:

-

-    Tiano Miscellaneous Services SetWatchdogTimer service implementation

-

---*/

+**/

 

 #include <DxeMain.h>

 

diff --git a/MdeModulePkg/Core/Dxe/Misc/Stall.c b/MdeModulePkg/Core/Dxe/Misc/Stall.c
index c251f31dc9..db32c1fa3a 100644
--- a/MdeModulePkg/Core/Dxe/Misc/Stall.c
+++ b/MdeModulePkg/Core/Dxe/Misc/Stall.c
@@ -1,6 +1,8 @@
-/*++

+/** @file 

+

+  UEFI Miscellaneous boot Services Stall service implementation

 

-Copyright (c) 2006, Intel Corporation

+Copyright (c) 2006 - 2008, Intel Corporation

 All rights reserved. This program and the accompanying materials

 are licensed and made available under the terms and conditions of the BSD License

 which accompanies this distribution.  The full text of the license may be found at

@@ -9,15 +11,7 @@ http://opensource.org/licenses/bsd-license.php
 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,

 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.

 

-Module Name:

-

-    Stall.c

-

-Abstract:

-

-    Tiano Miscellaneous Services Stall service implementation

-

---*/

+**/

 

 //

 // Include statements

diff --git a/MdeModulePkg/Core/Dxe/gcd.h b/MdeModulePkg/Core/Dxe/gcd.h
index 445821e913..2672e1ec91 100644
--- a/MdeModulePkg/Core/Dxe/gcd.h
+++ b/MdeModulePkg/Core/Dxe/gcd.h
@@ -1,6 +1,9 @@
-/*++

+/** @file 

 

-Copyright (c) 2006, Intel Corporation                                                         

+  GCD Operations and data structure used to 

+  convert from GCD attributes to EFI Memory Map attributes.

+  

+Copyright (c) 2006 - 2008, Intel Corporation                                                         

 All rights reserved. This program and the accompanying materials                          

 are licensed and made available under the terms and conditions of the BSD License         

 which accompanies this distribution.  The full text of the license may be found at        

@@ -9,15 +12,7 @@ http://opensource.org/licenses/bsd-license.php
 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,                     

 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.             

 

-Module Name:

-

-    gcd.h

-

-Abstract:

-

-Revision History

-

---*/

+**/

 

 #ifndef _GCD_H

 #define _GCD_H

diff --git a/MdeModulePkg/Core/Dxe/hand.h b/MdeModulePkg/Core/Dxe/hand.h
index c61af16234..98669dea35 100644
--- a/MdeModulePkg/Core/Dxe/hand.h
+++ b/MdeModulePkg/Core/Dxe/hand.h
@@ -1,6 +1,8 @@
-/*++

+/** @file 

+

+  Support functions for managing protocol.

 

-Copyright (c) 2006, Intel Corporation                                                         

+Copyright (c) 2006 - 2008, Intel Corporation                                                         

 All rights reserved. This program and the accompanying materials                          

 are licensed and made available under the terms and conditions of the BSD License         

 which accompanies this distribution.  The full text of the license may be found at        

@@ -9,19 +11,7 @@ http://opensource.org/licenses/bsd-license.php
 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,                     

 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.             

 

-Module Name:

-

-  hand.h

-

-Abstract:

-

-  EFI internal protocol definitions

-

-

-

-Revision History

-

---*/

+**/

 

 #ifndef  _HAND_H_

 #define  _HAND_H_

diff --git a/MdeModulePkg/Core/Dxe/imem.h b/MdeModulePkg/Core/Dxe/imem.h
index 3337700eda..a9df0ba5b0 100644
--- a/MdeModulePkg/Core/Dxe/imem.h
+++ b/MdeModulePkg/Core/Dxe/imem.h
@@ -1,6 +1,8 @@
-/*++

+/** @file 

+  

+  Data structure and functions to allocate and free memory space.

 

-Copyright (c) 2006, Intel Corporation                                                         

+Copyright (c) 2006 - 2008, Intel Corporation                                                         

 All rights reserved. This program and the accompanying materials                          

 are licensed and made available under the terms and conditions of the BSD License         

 which accompanies this distribution.  The full text of the license may be found at        

@@ -9,17 +11,6 @@ http://opensource.org/licenses/bsd-license.php
 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,                     

 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.             

 

-Module Name:

-

-  imem.h

-

-Abstract:

-

-  Head file to imem.h

-

-

-Revision History

-

 --*/

 

 #ifndef _IMEM_H_