Second set of changes based on a review of the code comments in the Include directory for typos, grammar issues, and language clarity.

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

1 files changed, 11 insertions, 34 deletions

diff --git a/MdePkg/Include/Base.h b/MdePkg/Include/Base.h
index 4c806e1..287c193 100644
--- a/MdePkg/Include/Base.h
+++ b/MdePkg/Include/Base.h
@@ -333,18 +333,9 @@ struct _LIST_ENTRY {
 //  }

 //

 

-/**

-  Return the size of argument that has been aligned to sizeof (UINTN).

-

-  @param  n    The parameter size is to be aligned.

-

-  @return The aligned size

-**/

-#define _INT_SIZE_OF(n) ((sizeof (n) + sizeof (UINTN) - 1) &~(sizeof (UINTN) - 1))

-

 #if defined(__GNUC__)

 //

-// Use GCC builtin macros for variable argument lists.

+// Use GCC built-in macros for variable argument lists.

 //

 typedef __builtin_va_list VA_LIST;

 

@@ -355,6 +346,15 @@ typedef __builtin_va_list VA_LIST;
 #define VA_END(Marker)               __builtin_va_end (Marker)

 

 #else

+/**

+  Return the size of argument that has been aligned to sizeof (UINTN).

+

+  @param  n    The parameter size to be aligned.

+

+  @return The aligned size

+**/

+#define _INT_SIZE_OF(n) ((sizeof (n) + sizeof (UINTN) - 1) &~(sizeof (UINTN) - 1))

+

 ///

 /// Pointer to the start of a variable argument list. Same as CHAR8 *.

 ///

@@ -409,29 +409,6 @@ typedef CHAR8 *VA_LIST;
 

 #endif

 

-///

-/// Pointer to the start of a variable argument list stored in a memory buffer. Same as UINT8 *.

-///

-typedef UINTN  *BASE_LIST;

-

-/**

-  Returns an argument of a specified type from a variable argument list and updates 

-  the pointer to the variable argument list to point to the next argument. 

-

-  This function returns an argument of the type specified by TYPE from the beginning 

-  of the variable argument list specified by Marker.  Marker is then updated to point 

-  to the next argument in the variable argument list.  The method for computing the 

-  pointer to the next argument in the argument list is CPU specific following the EFIAPI ABI.

-

-  @param   Marker   Pointer to the beginning of a variable argument list.

-  @param   TYPE     The type of argument to retrieve from the beginning 

-                    of the variable argument list.

-  

-  @return  An argument of the type specified by TYPE.

-

-**/

-#define BASE_ARG(Marker, TYPE) (*(TYPE *)((UINT8 *)(Marker = (BASE_LIST)((UINT8 *)Marker + _INT_SIZE_OF (TYPE))) - _INT_SIZE_OF (TYPE)))

-

 /**

   Macro that returns the byte offset of a field in a data structure. 

 

@@ -455,7 +432,7 @@ typedef UINTN  *BASE_LIST;
 

   This function computes the offset, in bytes, of field specified by Field from the beginning 

   of the  data structure specified by TYPE.  This offset is subtracted from Record, and is 

-  used to return a pointer to a data structure of the type specified by TYPE.If the data type 

+  used to return a pointer to a data structure of the type specified by TYPE. If the data type 

   specified by TYPE does not contain the field specified by Field, then the module will not compile. 

    

   @param   Record   Pointer to the field specified by Field within a data structure of type TYPE.