1 files changed, 29 insertions, 43 deletions
diff --git a/MdeModulePkg/Universal/Network/IScsiDxe/Md5.h b/MdeModulePkg/Universal/Network/IScsiDxe/Md5.h
index 365b5cbbe6..dd59626f37 100644
--- a/MdeModulePkg/Universal/Network/IScsiDxe/Md5.h
+++ b/MdeModulePkg/Universal/Network/IScsiDxe/Md5.h
@@ -1,4 +1,5 @@
-/*++
+/** @file
+  Header file for Md5
 
 Copyright (c) 2004 - 2008, Intel Corporation
 All rights reserved. This program and the accompanying materials
@@ -17,7 +18,7 @@ Abstract:
 
   Header file for Md5
 
---*/
+**/
 
 #ifndef _MD5_H_
 #define _MD5_H_
@@ -36,73 +37,58 @@ typedef struct _MD5_CTX {
   UINTN       Count;
 } MD5_CTX;
 
+/**
+  Initialize four 32-bits chaining variables and use them to do the Md5 transform.
+
+  @param  Md5Ctx[in]  the data structure of Md5
+
+  @retval EFI_SUCCESS initialization is ok
+
+**/
 EFI_STATUS
 MD5Init (
   IN MD5_CTX  *Md5Ctx
   )
-/*++
-
-Routine Description:
-
-  GC_TODO: Add function description
+;
 
-Arguments:
+/**
+  the external interface of Md5 algorithm
 
-  Md5Ctx  - GC_TODO: add argument description
+  @param  Md5Ctx[in]  the data structure of storing the original data
+                      segment and the final result.
 
-Returns:
+  @param  Data[in]    the data wanted to be transformed.
 
-  EFI_SUCCESS - GC_TODO: Add description for return value
+  @param  DataLen[in] the length of data.
 
---*/
-;
+  @retval EFI_SUCCESS the transform is ok.
 
+**/
 EFI_STATUS
 MD5Update (
   IN MD5_CTX  *Md5Ctx,
   IN VOID     *Data,
   IN UINTN    DataLen
   )
-/*++
-
-Routine Description:
-
-  GC_TODO: Add function description
-
-Arguments:
+;
 
-  Md5Ctx  - GC_TODO: add argument description
-  Data    - GC_TODO: add argument description
-  DataLen - GC_TODO: add argument description
+/**
+  accumulate the MD5 value of every data segment and generate the finial
+  result according to MD5 algorithm
 
-Returns:
+  @param  Md5Ctx[in]   the data structure of storing the original data
+                       segment and the final result.
 
-  EFI_SUCCESS - GC_TODO: Add description for return value
+  @param  HashVal[out] the final 128-bits output.
 
---*/
-;
+  @retval EFI_SUCCESS  the transform is ok.
 
+**/
 EFI_STATUS
 MD5Final (
   IN  MD5_CTX  *Md5Ctx,
   OUT UINT8    *HashVal
   )
-/*++
-
-Routine Description:
-
-  GC_TODO: Add function description
-
-Arguments:
-
-  Md5Ctx  - GC_TODO: add argument description
-  HashVal - GC_TODO: add argument description
-
-Returns:
-
-  EFI_SUCCESS - GC_TODO: Add description for return value
-
---*/
 ;
 
 #endif // _MD5_H