Code Scrub of MdePkg/Inlcude/Library

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

MdePkg/Include/Library/FvbServiceLib.h

@@ -32,6 +32,7 @@
 
 **/
 EFI_STATUS
+EFIAPI
 EfiFvbReadBlock (
   IN UINTN                                        Instance,
   IN EFI_LBA                                      Lba,
@@ -58,6 +59,7 @@ EfiFvbReadBlock (
 
 **/
 EFI_STATUS
+EFIAPI
 EfiFvbWriteBlock (
   IN UINTN                                        Instance,
   IN EFI_LBA                                      Lba,
@@ -78,6 +80,7 @@ EfiFvbWriteBlock (
 
 **/
 EFI_STATUS
+EFIAPI
 EfiFvbEraseBlock (
   IN UINTN                                Instance,
   IN EFI_LBA                              Lba
@@ -97,6 +100,7 @@ EfiFvbEraseBlock (
 
 **/
 EFI_STATUS
+EFIAPI
 EfiFvbGetVolumeAttributes (
   IN UINTN                                Instance,
   OUT EFI_FVB_ATTRIBUTES                  *Attributes
@@ -118,6 +122,7 @@ EfiFvbGetVolumeAttributes (
 
 **/
 EFI_STATUS
+EFIAPI
 EfiFvbSetVolumeAttributes (
   IN     UINTN                                Instance,
   IN OUT EFI_FVB_ATTRIBUTES                   *Attributes
@@ -137,6 +142,7 @@ EfiFvbSetVolumeAttributes (
 
 **/
 EFI_STATUS
+EFIAPI
 EfiFvbGetPhysicalAddress (
   IN UINTN                                Instance,
   OUT EFI_PHYSICAL_ADDRESS                *BaseAddress
@@ -160,6 +166,7 @@ EfiFvbGetPhysicalAddress (
 
 **/
 EFI_STATUS
+EFIAPI
 EfiFvbGetBlockSize (
   IN UINTN                                        Instance,
   IN EFI_LBA                                      Lba,
@@ -184,6 +191,7 @@ EfiFvbGetBlockSize (
 
 **/
 EFI_STATUS
+EFIAPI
 EfiFvbEraseCustomBlockRange (
   IN UINTN                                Instance,
   IN EFI_LBA                              StartLba,

MdePkg/Include/Library/HiiLib.h

@@ -90,8 +90,6 @@ HiiLibAddPackages (
   @param  HiiHandle                The handle that was previously registered to the data base that is requested for removal.
                                              List later.
 
-  @return  VOID
-
 **/
 VOID
 EFIAPI

MdePkg/Include/Library/IfrSupportLib.h

@@ -427,8 +427,7 @@ CreateStringOpCode (
 
   @param Str     String to be converted
 
-  @retval VOID
-  
+ 
 **/
 VOID
 EFIAPI
@@ -653,7 +652,6 @@ SetBrowserData (
   @retval EFI_INVALID_PARAMETER  One of the parameters was invalid.
 
 **/
-
 EFI_STATUS
 EFIAPI
 IfrLibCreatePopUp (

MdePkg/Include/Library/MemoryAllocationLib.h

@@ -617,6 +617,15 @@ FreeAlignedPool (
   IN VOID   *Buffer
   );
 
+
+/**
+  Frees buffer that were previously allocated with one of the
+  memory allocation functions in the Memory Allocation Library.
+
+  @param  Buffer                Pointer to the buffer of pages
+                                to free.
+
+**/
 VOID
 EFIAPI
 SafeFreePool (

MdePkg/Include/Library/PciCf8Lib.h

@@ -1000,7 +1000,7 @@ PciCf8BitFieldAndThenOr32 (
   @param  Size          Size in bytes of the transfer.
   @param  Buffer        Pointer to a buffer receiving the data read.
 
-  @return Size
+  @return Size read from StartAddress.
 
 **/
 UINTN
@@ -1033,7 +1033,7 @@ PciCf8ReadBuffer (
   @param  Size          Size in bytes of the transfer.
   @param  Buffer        Pointer to a buffer containing the data to write.
 
-  @return Size
+  @return Size written to StartAddress.
 
 **/
 UINTN

MdePkg/Include/Library/PciExpressLib.h

@@ -970,7 +970,7 @@ PciExpressBitFieldAndThenOr32 (
   @param  Size          Size in bytes of the transfer.
   @param  Buffer        Pointer to a buffer receiving the data read.
 
-  @return Size
+  @return Size read daata from StartAddress.
 
 **/
 UINTN
@@ -1002,7 +1002,7 @@ PciExpressReadBuffer (
   @param  Size          Size in bytes of the transfer.
   @param  Buffer        Pointer to a buffer containing the data to write.
 
-  @return Size
+  @return Size written to StartAddress.
 
 **/
 UINTN

MdePkg/Include/Library/PciLib.h

@@ -997,7 +997,7 @@ PciReadBuffer (
   @param  Size          Size in bytes of the transfer.
   @param  Buffer        Pointer to a buffer containing the data to write.
 
-  @return Size
+  @return Size written to StartAddress.
 
 **/
 UINTN

MdePkg/Include/Library/PeiPiLib.h

@@ -35,8 +35,7 @@
                                           parent firmware volume name and firmware volume file. If it did not originally come
                                           from a firmware file, these should be NULL
   
-    @retval  VOID
-  
+ 
   **/
 
 VOID

MdePkg/Include/Library/ScsiLib.h

@@ -248,6 +248,7 @@ ScsiRequestSenseCommand (
 
 **/
 EFI_STATUS
+EFIAPI
 ScsiReadCapacityCommand (
   IN  EFI_SCSI_IO_PROTOCOL  *ScsiIo,
   IN  UINT64                Timeout,

MdePkg/Include/Library/UefiApplicationEntryPoint.h

@@ -62,8 +62,6 @@ EfiMain (
 
   @param  Status Status returned by the application that is exiting.
   
-  @retval VOID
-
 **/
 VOID
 EFIAPI
@@ -79,8 +77,6 @@ Exit (
   @param  ImageHandle ImageHandle of the loaded driver.
   @param  SystemTable Pointer to the EFI System Table.
   
-  @retval VOID
-
 **/
 VOID
 EFIAPI
@@ -97,7 +93,6 @@ ProcessLibraryConstructorList (
   @param  ImageHandle ImageHandle of the loaded driver.
   @param  SystemTable Pointer to the EFI System Table.
 
-  @retval VOID
 **/
 VOID
 EFIAPI

MdePkg/Include/Library/UefiLib.h

@@ -772,6 +772,8 @@ EfiGetNameGuidFromFwVolDevicePathNode (
   @param ...      VARARG list consumed to process Format.
   If Format is NULL, then ASSERT().
   If Format is not aligned on a 16-bit boundary, then ASSERT().
+  
+  @return Number of Unicode characters printed to ConOut.
 
 **/
 UINTN
@@ -795,6 +797,8 @@ Print (
   @param ...      VARARG list consumed to process Format.
   If Format is NULL, then ASSERT().
   If Format is not aligned on a 16-bit boundary, then ASSERT().
+  
+  @return Number of Unicode characters printed to StdErr.
 
 **/
 UINTN
@@ -818,6 +822,8 @@ ErrorPrint (
   @param ...      VARARG list consumed to process Format.
   If Format is NULL, then ASSERT().
   If Format is not aligned on a 16-bit boundary, then ASSERT().
+  
+  @return Number of ASCII characters printed to ConOut.
 
 **/
 UINTN
@@ -841,6 +847,8 @@ AsciiPrint (
   @param ...      VARARG list consumed to process Format.
   If Format is NULL, then ASSERT().
   If Format is not aligned on a 16-bit boundary, then ASSERT().
+  
+  @return Number of ASCII characters printed to ConErr.
 
 **/
 UINTN

MdePkg/Include/Library/UsbLib.h

@@ -212,6 +212,7 @@ UsbGetReportRequest (
 
 **/
 EFI_STATUS
+EFIAPI
 UsbGetDescriptor (
   IN  EFI_USB_IO_PROTOCOL     *UsbIo,
   IN  UINT16                  Value,