Code Scrub the common includes in MdePkg.

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

MdePkg/Library/PeiPiLib/PeiPiLib.c

@@ -50,8 +50,6 @@ CONST EFI_PEI_FIRMWARE_VOLUME_INFO_PPI mFvInfoPpiTemplate = {
                                           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
 EFIAPI

MdePkg/Library/PeiServicesTablePointerLibIdt/PeiServicesTablePointer.c

@@ -23,7 +23,8 @@
   base addres is used to save the EFI_PEI_SERVICES**.
   For x64, the eight-bytes field immediately prior to new IDT
   base addres is used to save the EFI_PEI_SERVICES**
-  @retval  The pointer to PeiServices.
+  
+  @return  The pointer to PeiServices.
 
 **/
 EFI_PEI_SERVICES **
@@ -43,14 +44,15 @@ GetPeiServicesTablePointer (
 
 /**
   
-  The function returns the pointer to PeiServicee following
+  The function sets the pointer to PeiServicee following
   PI1.0.
   
   For IA32, the four-bytes field immediately prior to new IDT
   base addres is used to save the EFI_PEI_SERVICES**.
   For x64, the eight-bytes field immediately prior to new IDT
   base addres is used to save the EFI_PEI_SERVICES**
-  @retval  The pointer to PeiServices.
+  
+  @param PeiServicesTablePointer  The pointer to PeiServices.
 
 **/
 VOID

MdePkg/Library/PeiServicesTablePointerLibKr7/PeiServicesTablePointer.c

@@ -23,7 +23,7 @@
   The function returns the pointer to PeiServices.
   It will ASSERT() if the pointer to PeiServices is NULL.
 
-  @retval  The pointer to PeiServices.
+  @return  The pointer to PeiServices.
 
 **/
 EFI_PEI_SERVICES **

MdePkg/Library/UefiApplicationEntryPoint/ApplicationEntryPoint.c

@@ -72,8 +72,6 @@ _ModuleEntryPoint (
 
   @param  Status Status returned by the application that is exiting.
   
-  @retval VOID
-
 **/
 VOID
 EFIAPI

MdePkg/Library/UefiDriverEntryPoint/DriverEntryPoint.c

@@ -28,12 +28,11 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
   protocols produced and deallocates pool used by the driver.  Called by the core
   when unloading the driver.
 
-  @param  ImageHandle
+  @param  ImageHandle ImageHandle of the loaded driver.
 
-  @retval EFI_SUCCESS
+  @return Status returned by all unload().
 
 **/
-STATIC
 EFI_STATUS
 EFIAPI
 _DriverUnloadHandler (

MdePkg/Library/UefiScsiLib/UefiScsiLib.c

@@ -52,6 +52,7 @@
 
 **/
 EFI_STATUS
+EFIAPI
 ScsiTestUnitReadyCommand (
   IN  EFI_SCSI_IO_PROTOCOL  *ScsiIo,
   IN  UINT64                Timeout,
@@ -140,6 +141,7 @@ ScsiTestUnitReadyCommand (
 
 **/
 EFI_STATUS
+EFIAPI
 ScsiInquiryCommand (
   IN  EFI_SCSI_IO_PROTOCOL  *ScsiIo,
   IN  UINT64                Timeout,
@@ -241,6 +243,7 @@ ScsiInquiryCommand (
 
 **/
 EFI_STATUS
+EFIAPI
 ScsiModeSense10Command (
   IN  EFI_SCSI_IO_PROTOCOL    *ScsiIo,
   IN  UINT64                  Timeout,
@@ -337,6 +340,7 @@ ScsiModeSense10Command (
 
 **/
 EFI_STATUS
+EFIAPI
 ScsiRequestSenseCommand (
   IN  EFI_SCSI_IO_PROTOCOL  *ScsiIo,
   IN  UINT64                Timeout,
@@ -426,6 +430,7 @@ ScsiRequestSenseCommand (
 
 **/
 EFI_STATUS
+EFIAPI
 ScsiReadCapacityCommand (
   IN  EFI_SCSI_IO_PROTOCOL  *ScsiIo,
   IN  UINT64                Timeout,
@@ -528,6 +533,7 @@ ScsiReadCapacityCommand (
 
 **/
 EFI_STATUS
+EFIAPI
 ScsiRead10Command (
   IN  EFI_SCSI_IO_PROTOCOL  *ScsiIo,
   IN  UINT64                Timeout,
@@ -629,6 +635,7 @@ ScsiRead10Command (
 
 **/
 EFI_STATUS
+EFIAPI
 ScsiWrite10Command (
   IN  EFI_SCSI_IO_PROTOCOL  *ScsiIo,
   IN  UINT64                Timeout,
@@ -694,3 +701,4 @@ ScsiWrite10Command (
 
   return Status;
 }
+

MdePkg/Library/UefiUsbLib/Hid.c

@@ -24,12 +24,12 @@
   @param  HidDescriptor     Caller allocated buffer to store Usb hid descriptor if
                             successfully returned.
 
-  @return EFI_SUCCESS
-  @return EFI_DEVICE_ERROR
-  @return EFI_TIMEOUT
+  @return Status of getting HID descriptor through USB I/O
+          protocol's UsbControlTransfer().
 
 **/
 EFI_STATUS
+EFIAPI
 UsbGetHidDescriptor (
   IN  EFI_USB_IO_PROTOCOL        *UsbIo,
   IN  UINT8                      InterfaceNum,
@@ -73,12 +73,12 @@ UsbGetHidDescriptor (
   @param  DescriptorBuffer  Caller allocated buffer to store Usb report descriptor
                             if successfully returned.
 
-  @return EFI_SUCCESS
-  @return EFI_DEVICE_ERROR
-  @return EFI_TIMEOUT
+  @return Status of getting Report Class descriptor through USB
+          I/O protocol's UsbControlTransfer().
 
 **/
 EFI_STATUS
+EFIAPI
 UsbGetReportDescriptor (
   IN  EFI_USB_IO_PROTOCOL     *UsbIo,
   IN  UINT8                   InterfaceNum,
@@ -117,18 +117,18 @@ UsbGetReportDescriptor (
 }
 
 /**
-  Get Hid Protocol Request.
+  Get Hid Protocol Request
 
   @param  UsbIo             EFI_USB_IO_PROTOCOL.
-  @param  Interface         Which interface the caller wants to get protocol.
+  @param  Interface         Which interface the caller wants to get protocol
   @param  Protocol          Protocol value returned.
 
-  @return EFI_SUCCESS
-  @return EFI_DEVICE_ERROR
-  @return EFI_TIMEOUT
+  @return Status of getting Protocol Request through USB I/O
+          protocol's UsbControlTransfer().
 
 **/
 EFI_STATUS
+EFIAPI
 UsbGetProtocolRequest (
   IN EFI_USB_IO_PROTOCOL     *UsbIo,
   IN UINT8                   Interface,
@@ -168,19 +168,21 @@ UsbGetProtocolRequest (
 }
 
 
+
 /**
   Set Hid Protocol Request.
 
   @param  UsbIo             EFI_USB_IO_PROTOCOL.
-  @param  Interface         Which interface the caller wants to set protocol.
+  @param  Interface         Which interface the caller wants to
+                            set protocol.
   @param  Protocol          Protocol value the caller wants to set.
 
-  @return EFI_SUCCESS
-  @return EFI_DEVICE_ERROR
-  @return EFI_TIMEOUT
+  @return Status of setting Protocol Request through USB I/O
+          protocol's UsbControlTransfer().
 
 **/
 EFI_STATUS
+EFIAPI
 UsbSetProtocolRequest (
   IN EFI_USB_IO_PROTOCOL     *UsbIo,
   IN UINT8                   Interface,
@@ -227,12 +229,12 @@ UsbSetProtocolRequest (
   @param  ReportId          Which report the caller wants to set.
   @param  Duration          Idle rate the caller wants to set.
 
-  @return EFI_SUCCESS
-  @return EFI_DEVICE_ERROR
-  @return EFI_TIMEOUT
+  @return Status of setting IDLE Request through USB I/O
+          protocol's UsbControlTransfer().
 
 **/
 EFI_STATUS
+EFIAPI
 UsbSetIdleRequest (
   IN EFI_USB_IO_PROTOCOL     *UsbIo,
   IN UINT8                   Interface,
@@ -280,12 +282,12 @@ UsbSetIdleRequest (
   @param  ReportId          Which report the caller wants to get.
   @param  Duration          Idle rate the caller wants to get.
 
-  @return EFI_SUCCESS
-  @return EFI_DEVICE_ERROR
-  @return EFI_TIMEOUT
+  @return Status of getting IDLE Request through USB I/O
+          protocol's UsbControlTransfer().
 
 **/
 EFI_STATUS
+EFIAPI
 UsbGetIdleRequest (
   IN  EFI_USB_IO_PROTOCOL     *UsbIo,
   IN  UINT8                   Interface,
@@ -326,6 +328,7 @@ UsbGetIdleRequest (
 }
 
 
+
 /**
   Hid Set Report request.
 
@@ -336,12 +339,12 @@ UsbGetIdleRequest (
   @param  ReportLen         Length of report descriptor.
   @param  Report            Report Descriptor buffer.
 
-  @return EFI_SUCCESS
-  @return EFI_DEVICE_ERROR
-  @return EFI_TIMEOUT
+  @return Status of setting Report Request through USB I/O
+          protocol's UsbControlTransfer().
 
 **/
 EFI_STATUS
+EFIAPI
 UsbSetReportRequest (
   IN EFI_USB_IO_PROTOCOL     *UsbIo,
   IN UINT8                   Interface,
@@ -394,12 +397,12 @@ UsbSetReportRequest (
   @param  ReportLen         Length of report descriptor.
   @param  Report            Caller allocated buffer to store Report Descriptor.
 
-  @return EFI_SUCCESS
-  @return EFI_DEVICE_ERROR
-  @return EFI_TIMEOUT
+  @return Status of getting Report Request through USB I/O
+          protocol's UsbControlTransfer().
 
 **/
 EFI_STATUS
+EFIAPI
 UsbGetReportRequest (
   IN EFI_USB_IO_PROTOCOL     *UsbIo,
   IN UINT8                   Interface,