Coding style modification.

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

3 files changed, 84 insertions, 84 deletions

diff --git a/IntelFrameworkModulePkg/Bus/Isa/Ps2MouseDxe/CommPs2.c b/IntelFrameworkModulePkg/Bus/Isa/Ps2MouseDxe/CommPs2.c
index 679179ddd0..4236d70702 100644
--- a/IntelFrameworkModulePkg/Bus/Isa/Ps2MouseDxe/CommPs2.c
+++ b/IntelFrameworkModulePkg/Bus/Isa/Ps2MouseDxe/CommPs2.c
@@ -23,7 +23,7 @@ EFI_STATUS
 KbcSelfTest (

   IN EFI_ISA_IO_PROTOCOL                  *IsaIo

   )

-/*++

+/**

 

 Routine Description:

 

@@ -38,7 +38,7 @@ Returns:
   EFI_DEVICE_ERROR - GC_TODO: Add description for return value

   EFI_SUCCESS - GC_TODO: Add description for return value

 

---*/

+**/

 {

   EFI_STATUS  Status;

   UINT8       Data;

@@ -92,7 +92,7 @@ EFI_STATUS
 KbcEnableAux (

   IN EFI_ISA_IO_PROTOCOL                  *IsaIo

   )

-/*++

+/**

 

 Routine Description:

 

@@ -106,7 +106,7 @@ Returns:
 

   GC_TODO: add return values

 

---*/

+**/

 {

   //

   // Send 8042 enable mouse command

@@ -118,7 +118,7 @@ EFI_STATUS
 KbcDisableAux (

   IN EFI_ISA_IO_PROTOCOL                  *IsaIo

   )

-/*++

+/**

 

 Routine Description:

 

@@ -132,7 +132,7 @@ Returns:
 

   GC_TODO: add return values

 

---*/

+**/

 {

   //

   // Send 8042 disable mouse command

@@ -144,7 +144,7 @@ EFI_STATUS
 KbcEnableKb (

   IN EFI_ISA_IO_PROTOCOL                  *IsaIo

   )

-/*++

+/**

 

 Routine Description:

 

@@ -158,7 +158,7 @@ Returns:
 

   GC_TODO: add return values

 

---*/

+**/

 {

   //

   // Send 8042 enable keyboard command

@@ -170,7 +170,7 @@ EFI_STATUS
 KbcDisableKb (

   IN EFI_ISA_IO_PROTOCOL                  *IsaIo

   )

-/*++

+/**

 

 Routine Description:

 

@@ -184,7 +184,7 @@ Returns:
 

   GC_TODO: add return values

 

---*/

+**/

 {

   //

   // Send 8042 disable keyboard command

@@ -197,7 +197,7 @@ CheckKbStatus (
   IN EFI_ISA_IO_PROTOCOL                  *IsaIo,

   OUT BOOLEAN                             *KeyboardEnable

   )

-/*++

+/**

 

 Routine Description:

 

@@ -212,7 +212,7 @@ Returns:
 

   EFI_SUCCESS - GC_TODO: Add description for return value

 

---*/

+**/

 {

   EFI_STATUS  Status;

   UINT8       Data;

@@ -245,7 +245,7 @@ EFI_STATUS
 PS2MouseReset (

   IN EFI_ISA_IO_PROTOCOL                  *IsaIo

   )

-/*++

+/**

 

 Routine Description:

 

@@ -261,7 +261,7 @@ Returns:
   EFI_DEVICE_ERROR - GC_TODO: Add description for return value

   EFI_SUCCESS - GC_TODO: Add description for return value

 

---*/

+**/

 {

   EFI_STATUS  Status;

   UINT8       Data;

@@ -301,7 +301,7 @@ PS2MouseSetSampleRate (
   IN EFI_ISA_IO_PROTOCOL                  *IsaIo,

   IN MOUSE_SR                             SampleRate

   )

-/*++

+/**

 

 Routine Description:

 

@@ -316,7 +316,7 @@ Returns:
 

   GC_TODO: add return values

 

---*/

+**/

 {

   EFI_STATUS  Status;

 

@@ -338,7 +338,7 @@ PS2MouseSetResolution (
   IN EFI_ISA_IO_PROTOCOL                  *IsaIo,

   IN MOUSE_RE                             Resolution

   )

-/*++

+/**

 

 Routine Description:

 

@@ -353,7 +353,7 @@ Returns:
 

   GC_TODO: add return values

 

---*/

+**/

 {

   EFI_STATUS  Status;

 

@@ -375,7 +375,7 @@ PS2MouseSetScaling (
   IN EFI_ISA_IO_PROTOCOL                  *IsaIo,

   IN MOUSE_SF                             Scaling

   )

-/*++

+/**

 

 Routine Description:

 

@@ -390,7 +390,7 @@ Returns:
 

   GC_TODO: add return values

 

---*/

+**/

 {

   UINT8 Command;

 

@@ -406,7 +406,7 @@ EFI_STATUS
 PS2MouseEnable (

   IN EFI_ISA_IO_PROTOCOL                  *IsaIo

   )

-/*++

+/**

 

 Routine Description:

 

@@ -420,7 +420,7 @@ Returns:
 

   GC_TODO: add return values

 

---*/

+**/

 {

   //

   // Send auxiliary command to enable mouse

@@ -432,7 +432,7 @@ EFI_STATUS
 PS2MouseGetPacket (

   PS2_MOUSE_DEV     *MouseDev

   )

-/*++

+/**

 

 Routine Description:

 

@@ -447,7 +447,7 @@ Returns:
   EFI_NOT_READY -  Mouse Device not ready to input data packet, or some error happened during getting the packet

   EFI_SUCCESS - The data packet is gotten successfully.

 

---*/

+**/

 {

   EFI_STATUS  Status;

   BOOLEAN     KeyboardEnable;

@@ -576,7 +576,7 @@ PS2MouseRead (
   IN OUT UINTN                            *BufSize,

   IN  UINTN                               State

   )

-/*++

+/**

 

 Routine Description:

 

@@ -593,7 +593,7 @@ Returns:
 

   GC_TODO: add return values

 

---*/

+**/

 {

   EFI_STATUS  Status;

   UINTN       BytesRead;

@@ -642,7 +642,7 @@ Out8042Command (
   IN EFI_ISA_IO_PROTOCOL                  *IsaIo,

   IN UINT8                                Command

   )

-/*++

+/**

 

 Routine Description:

 

@@ -657,7 +657,7 @@ Returns:
 

   EFI_SUCCESS - GC_TODO: Add description for return value

 

---*/

+**/

 {

   EFI_STATUS  Status;

   UINT8       Data;

@@ -688,7 +688,7 @@ Out8042Data (
   IN EFI_ISA_IO_PROTOCOL                  *IsaIo,

   IN UINT8                                Data

   )

-/*++

+/**

 

 Routine Description:

 

@@ -703,7 +703,7 @@ Returns:
 

   EFI_SUCCESS - GC_TODO: Add description for return value

 

---*/

+**/

 {

   EFI_STATUS  Status;

   UINT8       temp;

@@ -731,7 +731,7 @@ In8042Data (
   IN EFI_ISA_IO_PROTOCOL                  *IsaIo,

   IN OUT UINT8                            *Data

   )

-/*++

+/**

 

 Routine Description:

 

@@ -747,7 +747,7 @@ Returns:
   EFI_TIMEOUT - GC_TODO: Add description for return value

   EFI_SUCCESS - GC_TODO: Add description for return value

 

---*/

+**/

 {

   UINTN Delay;

   UINT8 temp;

@@ -783,7 +783,7 @@ Out8042AuxCommand (
   IN UINT8                                Command,

   IN BOOLEAN                              Resend

   )

-/*++

+/**

 

 Routine Description:

 

@@ -802,7 +802,7 @@ Returns:
   EFI_DEVICE_ERROR - GC_TODO: Add description for return value

   EFI_SUCCESS - GC_TODO: Add description for return value

 

---*/

+**/

 {

   EFI_STATUS  Status;

   UINT8       Data;

@@ -874,7 +874,7 @@ Out8042AuxData (
   IN EFI_ISA_IO_PROTOCOL                  *IsaIo,

   IN UINT8                                Data

   )

-/*++

+/**

 

 Routine Description:

 

@@ -889,7 +889,7 @@ Returns:
 

   EFI_SUCCESS - GC_TODO: Add description for return value

 

---*/

+**/

 {

   EFI_STATUS  Status;

   UINT8       Temp;

@@ -927,7 +927,7 @@ In8042AuxData (
   IN EFI_ISA_IO_PROTOCOL                  *IsaIo,

   IN OUT UINT8                            *Data

   )

-/*++

+/**

 

 Routine Description:

 

@@ -942,7 +942,7 @@ Returns:
 

   EFI_SUCCESS - GC_TODO: Add description for return value

 

---*/

+**/

 {

   EFI_STATUS  Status;

 

@@ -963,7 +963,7 @@ EFI_STATUS
 CheckForInput (

   IN EFI_ISA_IO_PROTOCOL                  *IsaIo

   )

-/*++

+/**

 

 Routine Description:

 

@@ -978,7 +978,7 @@ Returns:
   EFI_NOT_READY - GC_TODO: Add description for return value

   EFI_SUCCESS - GC_TODO: Add description for return value

 

---*/

+**/

 {

   UINT8 Data;

 

@@ -999,7 +999,7 @@ WaitInputEmpty (
   IN EFI_ISA_IO_PROTOCOL                  *IsaIo,

   IN UINTN                                Timeout

   )

-/*++

+/**

 

 Routine Description:

 

@@ -1015,7 +1015,7 @@ Returns:
   EFI_TIMEOUT - GC_TODO: Add description for return value

   EFI_SUCCESS - GC_TODO: Add description for return value

 

---*/

+**/

 {

   UINTN Delay;

   UINT8 Data;

@@ -1048,7 +1048,7 @@ WaitOutputFull (
   IN EFI_ISA_IO_PROTOCOL                  *IsaIo,

   IN UINTN                                Timeout

   )

-/*++

+/**

 

 Routine Description:

 

@@ -1064,7 +1064,7 @@ Returns:
   EFI_TIMEOUT - GC_TODO: Add description for return value

   EFI_SUCCESS - GC_TODO: Add description for return value

 

---*/

+**/

 {

   UINTN Delay;

   UINT8 Data;

diff --git a/IntelFrameworkModulePkg/Bus/Isa/Ps2MouseDxe/CommPs2.h b/IntelFrameworkModulePkg/Bus/Isa/Ps2MouseDxe/CommPs2.h
index 3180d26680..4bba9d2488 100644
--- a/IntelFrameworkModulePkg/Bus/Isa/Ps2MouseDxe/CommPs2.h
+++ b/IntelFrameworkModulePkg/Bus/Isa/Ps2MouseDxe/CommPs2.h
@@ -106,7 +106,7 @@ EFI_STATUS
 KbcSelfTest (

   IN EFI_ISA_IO_PROTOCOL                  *IsaIo

   )

-/*++

+/**

 

 Routine Description:

 

@@ -120,14 +120,14 @@ Returns:
 

   GC_TODO: add return values

 

---*/

+**/

 ;

 

 EFI_STATUS

 KbcEnableAux (

   IN EFI_ISA_IO_PROTOCOL                  *IsaIo

   )

-/*++

+/**

 

 Routine Description:

 

@@ -141,14 +141,14 @@ Returns:
 

   GC_TODO: add return values

 

---*/

+**/

 ;

 

 EFI_STATUS

 KbcDisableAux (

   IN EFI_ISA_IO_PROTOCOL                  *IsaIo

   )

-/*++

+/**

 

 Routine Description:

 

@@ -162,14 +162,14 @@ Returns:
 

   GC_TODO: add return values

 

---*/

+**/

 ;

 

 EFI_STATUS

 KbcEnableKb (

   IN EFI_ISA_IO_PROTOCOL                  *IsaIo

   )

-/*++

+/**

 

 Routine Description:

 

@@ -183,14 +183,14 @@ Returns:
 

   GC_TODO: add return values

 

---*/

+**/

 ;

 

 EFI_STATUS

 KbcDisableKb (

   IN EFI_ISA_IO_PROTOCOL                  *IsaIo

   )

-/*++

+/**

 

 Routine Description:

 

@@ -204,7 +204,7 @@ Returns:
 

   GC_TODO: add return values

 

---*/

+**/

 ;

 

 EFI_STATUS

@@ -212,7 +212,7 @@ CheckKbStatus (
   IN EFI_ISA_IO_PROTOCOL                  *IsaIo,

   OUT BOOLEAN                             *KeyboardEnable

   )

-/*++

+/**

 

 Routine Description:

 

@@ -227,14 +227,14 @@ Returns:
 

   GC_TODO: add return values

 

---*/

+**/

 ;

 

 EFI_STATUS

 PS2MouseReset (

   IN EFI_ISA_IO_PROTOCOL                  *IsaIo

   )

-/*++

+/**

 

 Routine Description:

 

@@ -248,7 +248,7 @@ Returns:
 

   GC_TODO: add return values

 

---*/

+**/

 ;

 

 EFI_STATUS

@@ -256,7 +256,7 @@ PS2MouseSetSampleRate (
   IN EFI_ISA_IO_PROTOCOL                  *IsaIo,

   IN MOUSE_SR                             SampleRate

   )

-/*++

+/**

 

 Routine Description:

 

@@ -271,7 +271,7 @@ Returns:
 

   GC_TODO: add return values

 

---*/

+**/

 ;

 

 EFI_STATUS

@@ -279,7 +279,7 @@ PS2MouseSetResolution (
   IN EFI_ISA_IO_PROTOCOL                  *IsaIo,

   IN MOUSE_RE                             Resolution

   )

-/*++

+/**

 

 Routine Description:

 

@@ -294,7 +294,7 @@ Returns:
 

   GC_TODO: add return values

 

---*/

+**/

 ;

 

 EFI_STATUS

@@ -302,7 +302,7 @@ PS2MouseSetScaling (
   IN EFI_ISA_IO_PROTOCOL                  *IsaIo,

   IN MOUSE_SF                             Scaling

   )

-/*++

+/**

 

 Routine Description:

 

@@ -317,14 +317,14 @@ Returns:
 

   GC_TODO: add return values

 

---*/

+**/

 ;

 

 EFI_STATUS

 PS2MouseEnable (

   IN EFI_ISA_IO_PROTOCOL                  *IsaIo

   )

-/*++

+/**

 

 Routine Description:

 

@@ -338,14 +338,14 @@ Returns:
 

   GC_TODO: add return values

 

---*/

+**/

 ;

 

 EFI_STATUS

 PS2MouseGetPacket (

   PS2_MOUSE_DEV     *MouseDev

   )

-/*++

+/**

 

 Routine Description:

 

@@ -359,7 +359,7 @@ Returns:
 

   GC_TODO: add return values

 

---*/

+**/

 ;

 

 EFI_STATUS

diff --git a/IntelFrameworkModulePkg/Bus/Isa/Ps2MouseDxe/Ps2Mouse.c b/IntelFrameworkModulePkg/Bus/Isa/Ps2MouseDxe/Ps2Mouse.c
index e500180597..53ce99e6ab 100644
--- a/IntelFrameworkModulePkg/Bus/Isa/Ps2MouseDxe/Ps2Mouse.c
+++ b/IntelFrameworkModulePkg/Bus/Isa/Ps2MouseDxe/Ps2Mouse.c
@@ -35,7 +35,7 @@ PS2MouseDriverSupported (
   IN EFI_HANDLE                     Controller,

   IN EFI_DEVICE_PATH_PROTOCOL       *RemainingDevicePath

   )

-/*++

+/**

 

 Routine Description:

 

@@ -45,7 +45,7 @@ Arguments:
 

 Returns:

 

---*/

+**/

 // GC_TODO:    This - add argument and description to function comment

 // GC_TODO:    Controller - add argument and description to function comment

 // GC_TODO:    RemainingDevicePath - add argument and description to function comment

@@ -115,7 +115,7 @@ PS2MouseDriverStart (
   IN EFI_HANDLE                     Controller,

   IN EFI_DEVICE_PATH_PROTOCOL       *RemainingDevicePath

   )

-/*++

+/**

 

 Routine Description:

     Start protocol interfaces for the mouse device handles.

@@ -129,7 +129,7 @@ Returns:
     EFI_SUCCESS             - This driver is added to DeviceHandle.

     other                               - Errors occurred.

 

---*/

+**/

 {

   EFI_STATUS                          Status;

   EFI_STATUS                          EmptyStatus;

@@ -390,7 +390,7 @@ PS2MouseDriverStop (
   IN UINTN                          NumberOfChildren,

   IN EFI_HANDLE                     *ChildHandleBuffer

   )

-/*++

+/**

 

   Routine Description:

 

@@ -398,7 +398,7 @@ PS2MouseDriverStop (
 

   Returns:

 

---*/

+**/

 // GC_TODO:    This - add argument and description to function comment

 // GC_TODO:    Controller - add argument and description to function comment

 // GC_TODO:    NumberOfChildren - add argument and description to function comment

@@ -489,7 +489,7 @@ MouseReset (
   IN EFI_SIMPLE_POINTER_PROTOCOL    *This,

   IN BOOLEAN                        ExtendedVerification

   )

-/*++

+/**

 

 Routine Description:

 

@@ -505,7 +505,7 @@ Returns:
  EFI_SUCCESS         - The command byte is written successfully.

  EFI_DEVICE_ERROR    - Errors occurred during reseting keyboard.

 

---*/

+**/

 {

   EFI_STATUS    Status;

   PS2_MOUSE_DEV *MouseDev;

@@ -609,7 +609,7 @@ BOOLEAN
 CheckMouseConnect (

   IN  PS2_MOUSE_DEV     *MouseDev

   )

-/*++

+/**

 

 Routine Description:

 

@@ -624,7 +624,7 @@ Returns:
   TRUE                - Keyboard in System.

   FALSE               - Keyboard not in System.

 

---*/

+**/

 {

   EFI_STATUS     Status;

 

@@ -642,7 +642,7 @@ MouseGetState (
   IN EFI_SIMPLE_POINTER_PROTOCOL    *This,

   IN OUT EFI_SIMPLE_POINTER_STATE   *State

   )

-/*++

+/**

 

 Routine Description:

 

@@ -659,7 +659,7 @@ Returns:
   EFI_NOT_READY - GC_TODO: Add description for return value

   EFI_SUCCESS - GC_TODO: Add description for return value

 

---*/

+**/

 {

   PS2_MOUSE_DEV *MouseDev;

   EFI_TPL       OldTpl;

@@ -695,7 +695,7 @@ MouseWaitForInput (
   IN  EFI_EVENT               Event,

   IN  VOID                    *Context

   )

-/*++

+/**

 

 Routine Description:

 

@@ -706,7 +706,7 @@ Arguments:
 

 Returns:

 

---*/

+**/

 // GC_TODO:    Event - add argument and description to function comment

 // GC_TODO:    Context - add argument and description to function comment

 {

@@ -730,7 +730,7 @@ PollMouse (
   IN EFI_EVENT  Event,

   IN VOID       *Context

   )

-/*++

+/**

 

 Routine Description:

 

@@ -746,7 +746,7 @@ Returns:
 

   None

 

---*/

+**/

 {

   PS2_MOUSE_DEV *MouseDev;