Minor grammatical work--mostly adding periods. Items with ONLY period added did not have the heading date changed, but Items with content changes had heading copyright dates updated. Sending separately a list of files missing Doxygen @param and @return information. (PENDING)

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

1 files changed, 132 insertions, 119 deletions

diff --git a/MdePkg/Library/SmmMemoryAllocationLib/MemoryAllocationLib.c b/MdePkg/Library/SmmMemoryAllocationLib/MemoryAllocationLib.c
index 3a539e3643..f8ab33a44a 100644
--- a/MdePkg/Library/SmmMemoryAllocationLib/MemoryAllocationLib.c
+++ b/MdePkg/Library/SmmMemoryAllocationLib/MemoryAllocationLib.c
@@ -32,9 +32,10 @@
 /**

   Allocates one or more 4KB pages of a certain memory type.

 

-  Allocates the number of 4KB pages of a certain memory type and returns a pointer to the allocated

-  buffer.  The buffer returned is aligned on a 4KB boundary.  If Pages is 0, then NULL is returned.

-  If there is not enough memory remaining to satisfy the request, then NULL is returned.

+  Allocates the number of 4KB pages of a certain memory type and returns a pointer 

+  to the allocated buffer.  The buffer returned is aligned on a 4KB boundary.  If 

+  Pages is 0, then NULL is returned.   If there is not enough memory remaining to 

+  satisfy the request, then NULL is returned.

 

   @param  MemoryType            The type of memory to allocate.

   @param  Pages                 The number of 4 KB pages to allocate.

@@ -65,10 +66,10 @@ InternalAllocatePages (
 /**

   Allocates one or more 4KB pages of type EfiBootServicesData.

 

-  Allocates the number of 4KB pages of type EfiBootServicesData and returns a pointer to the

-  allocated buffer.  The buffer returned is aligned on a 4KB boundary.  If Pages is 0, then NULL

-  is returned.  If there is not enough memory remaining to satisfy the request, then NULL is

-  returned.

+  Allocates the number of 4KB pages of type EfiBootServicesData and returns a pointer 

+  to the allocated buffer.  The buffer returned is aligned on a 4KB boundary.  If 

+  Pages is 0, then NULL is returned.  If there is not enough memory remaining to 

+  satisfy the request, then NULL is returned.

 

   @param  Pages                 The number of 4 KB pages to allocate.

 

@@ -87,10 +88,10 @@ AllocatePages (
 /**

   Allocates one or more 4KB pages of type EfiRuntimeServicesData.

 

-  Allocates the number of 4KB pages of type EfiRuntimeServicesData and returns a pointer to the

-  allocated buffer.  The buffer returned is aligned on a 4KB boundary.  If Pages is 0, then NULL

-  is returned.  If there is not enough memory remaining to satisfy the request, then NULL is

-  returned.

+  Allocates the number of 4KB pages of type EfiRuntimeServicesData and returns a 

+  pointer to the allocated buffer.  The buffer returned is aligned on a 4KB boundary.  

+  If Pages is 0, then NULL is returned.  If there is not enough memory remaining 

+  to satisfy the request, then NULL is returned.

 

   @param  Pages                 The number of 4 KB pages to allocate.

 

@@ -109,10 +110,10 @@ AllocateRuntimePages (
 /**

   Allocates one or more 4KB pages of type EfiReservedMemoryType.

 

-  Allocates the number of 4KB pages of type EfiReservedMemoryType and returns a pointer to the

-  allocated buffer.  The buffer returned is aligned on a 4KB boundary.  If Pages is 0, then NULL

-  is returned.  If there is not enough memory remaining to satisfy the request, then NULL is

-  returned.

+  Allocates the number of 4KB pages of type EfiReservedMemoryType and returns a 

+  pointer to the allocated buffer.  The buffer returned is aligned on a 4KB boundary.  

+  If Pages is 0, then NULL is returned.  If there is not enough memory remaining 

+  to satisfy the request, then NULL is returned.

 

   @param  Pages                 The number of 4 KB pages to allocate.

 

@@ -132,13 +133,13 @@ AllocateReservedPages (
   Frees one or more 4KB pages that were previously allocated with one of the page allocation

   functions in the Memory Allocation Library.

 

-  Frees the number of 4KB pages specified by Pages from the buffer specified by Buffer.  Buffer

-  must have been allocated on a previous call to the page allocation services of the Memory

-  Allocation Library.  If it is not possible to free allocated pages, then this function will

-  perform no actions.

+  Frees the number of 4KB pages specified by Pages from the buffer specified by Buffer.  

+  Buffer must have been allocated on a previous call to the page allocation services 

+  of the Memory Allocation Library.  If it is not possible to free allocated pages, 

+  then this function will perform no actions.

   

-  If Buffer was not allocated with a page allocation function in the Memory Allocation Library,

-  then ASSERT().

+  If Buffer was not allocated with a page allocation function in the Memory Allocation 

+  Library, then ASSERT().

   If Pages is zero, then ASSERT().

  

   @param  Buffer                The pointer to the buffer of pages to free.

@@ -162,15 +163,16 @@ FreePages (
 /**

   Allocates one or more 4KB pages of a certain memory type at a specified alignment.

 

-  Allocates the number of 4KB pages specified by Pages of a certain memory type with an alignment

-  specified by Alignment.  The allocated buffer is returned.  If Pages is 0, then NULL is returned.

-  If there is not enough memory at the specified alignment remaining to satisfy the request, then

-  NULL is returned.

+  Allocates the number of 4KB pages specified by Pages of a certain memory type 

+  with an alignment specified by Alignment.  The allocated buffer is returned.  

+  If Pages is 0, then NULL is returned. If there is not enough memory at the 

+  specified alignment remaining to satisfy the request, then NULL is returned.

   If Alignment is not a power of two and Alignment is not zero, then ASSERT().

 

   @param  MemoryType            The type of memory to allocate.

   @param  Pages                 The number of 4 KB pages to allocate.

-  @param  Alignment             The requested alignment of the allocation.  Must be a power of two.

+  @param  Alignment             The requested alignment of the allocation.  

+                                Must be a power of two.

                                 If Alignment is zero, then byte alignment is used.

 

   @return A pointer to the allocated buffer or NULL if allocation fails.

@@ -247,15 +249,16 @@ InternalAllocateAlignedPages (
 /**

   Allocates one or more 4KB pages of type EfiBootServicesData at a specified alignment.

 

-  Allocates the number of 4KB pages specified by Pages of type EfiBootServicesData with an

-  alignment specified by Alignment.  The allocated buffer is returned.  If Pages is 0, then NULL is

-  returned.  If there is not enough memory at the specified alignment remaining to satisfy the

-  request, then NULL is returned.

+  Allocates the number of 4KB pages specified by Pages of type EfiBootServicesData 

+  with an alignment specified by Alignment.  The allocated buffer is returned.  

+  If Pages is 0, then NULL is returned.  If there is not enough memory at the 

+  specified alignment remaining to satisfy the request, then NULL is returned.

   

   If Alignment is not a power of two and Alignment is not zero, then ASSERT().

 

   @param  Pages                 The number of 4 KB pages to allocate.

-  @param  Alignment             The requested alignment of the allocation.  Must be a power of two.

+  @param  Alignment             The requested alignment of the allocation.  

+                                Must be a power of two.

                                 If Alignment is zero, then byte alignment is used.

 

   @return A pointer to the allocated buffer or NULL if allocation fails.

@@ -274,15 +277,16 @@ AllocateAlignedPages (
 /**

   Allocates one or more 4KB pages of type EfiRuntimeServicesData at a specified alignment.

 

-  Allocates the number of 4KB pages specified by Pages of type EfiRuntimeServicesData with an

-  alignment specified by Alignment.  The allocated buffer is returned.  If Pages is 0, then NULL is

-  returned.  If there is not enough memory at the specified alignment remaining to satisfy the

-  request, then NULL is returned.

+  Allocates the number of 4KB pages specified by Pages of type EfiRuntimeServicesData 

+  with an alignment specified by Alignment.  The allocated buffer is returned.  

+  If Pages is 0, then NULL is returned.  If there is not enough memory at the 

+  specified alignment remaining to satisfy the request, then NULL is returned.

   

   If Alignment is not a power of two and Alignment is not zero, then ASSERT().

 

   @param  Pages                 The number of 4 KB pages to allocate.

-  @param  Alignment             The requested alignment of the allocation.  Must be a power of two.

+  @param  Alignment             The requested alignment of the allocation.  

+                                Must be a power of two.

                                 If Alignment is zero, then byte alignment is used.

 

   @return A pointer to the allocated buffer or NULL if allocation fails.

@@ -301,15 +305,16 @@ AllocateAlignedRuntimePages (
 /**

   Allocates one or more 4KB pages of type EfiReservedMemoryType at a specified alignment.

 

-  Allocates the number of 4KB pages specified by Pages of type EfiReservedMemoryType with an

-  alignment specified by Alignment.  The allocated buffer is returned.  If Pages is 0, then NULL is

-  returned.  If there is not enough memory at the specified alignment remaining to satisfy the

-  request, then NULL is returned.

+  Allocates the number of 4KB pages specified by Pages of type EfiReservedMemoryType 

+  with an alignment specified by Alignment.  The allocated buffer is returned.  

+  If Pages is 0, then NULL is returned.  If there is not enough memory at the 

+  specified alignment remaining to satisfy the request, then NULL is returned.

   

   If Alignment is not a power of two and Alignment is not zero, then ASSERT().

 

   @param  Pages                 The number of 4 KB pages to allocate.

-  @param  Alignment             The requested alignment of the allocation.  Must be a power of two.

+  @param  Alignment             The requested alignment of the allocation.  

+                                Must be a power of two.

                                 If Alignment is zero, then byte alignment is used.

 

   @return A pointer to the allocated buffer or NULL if allocation fails.

@@ -329,13 +334,13 @@ AllocateAlignedReservedPages (
   Frees one or more 4KB pages that were previously allocated with one of the aligned page

   allocation functions in the Memory Allocation Library.

 

-  Frees the number of 4KB pages specified by Pages from the buffer specified by Buffer.  Buffer

-  must have been allocated on a previous call to the aligned page allocation services of the Memory

-  Allocation Library.  If it is not possible to free allocated pages, then this function will 

-  perform no actions.

+  Frees the number of 4KB pages specified by Pages from the buffer specified by 

+  Buffer.  Buffer must have been allocated on a previous call to the aligned page 

+  allocation services of the Memory Allocation Library.  If it is not possible to 

+  free allocated pages, then this function will perform no actions.

   

-  If Buffer was not allocated with an aligned page allocation function in the Memory Allocation

-  Library, then ASSERT().

+  If Buffer was not allocated with an aligned page allocation function in the 

+  Memory Allocation Library, then ASSERT().

   If Pages is zero, then ASSERT().

   

   @param  Buffer                The pointer to the buffer of pages to free.

@@ -359,9 +364,10 @@ FreeAlignedPages (
 /**

   Allocates a buffer of a certain pool type.

 

-  Allocates the number bytes specified by AllocationSize of a certain pool type and returns a

-  pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is

-  returned.  If there is not enough memory remaining to satisfy the request, then NULL is returned.

+  Allocates the number bytes specified by AllocationSize of a certain pool type 

+  and returns a pointer to the allocated buffer.  If AllocationSize is 0, then a 

+  valid buffer of 0 size is returned.  If there is not enough memory remaining to 

+  satisfy the request, then NULL is returned.

 

   @param  MemoryType            The type of memory to allocate.

   @param  AllocationSize        The number of bytes to allocate.

@@ -388,9 +394,10 @@ InternalAllocatePool (
 /**

   Allocates a buffer of type EfiBootServicesData.

 

-  Allocates the number bytes specified by AllocationSize of type EfiBootServicesData and returns a

-  pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is

-  returned.  If there is not enough memory remaining to satisfy the request, then NULL is returned.

+  Allocates the number bytes specified by AllocationSize of type EfiBootServicesData 

+  and returns a pointer to the allocated buffer.  If AllocationSize is 0, then a 

+  valid buffer of 0 size is returned.  If there is not enough memory remaining to 

+  satisfy the request, then NULL is returned.

 

   @param  AllocationSize        The number of bytes to allocate.

 

@@ -409,9 +416,10 @@ AllocatePool (
 /**

   Allocates a buffer of type EfiRuntimeServicesData.

 

-  Allocates the number bytes specified by AllocationSize of type EfiRuntimeServicesData and returns

-  a pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is

-  returned.  If there is not enough memory remaining to satisfy the request, then NULL is returned.

+  Allocates the number bytes specified by AllocationSize of type EfiRuntimeServicesData 

+  and returns a pointer to the allocated buffer.  If AllocationSize is 0, then a 

+  valid buffer of 0 size is returned.  If there is not enough memory remaining to 

+  satisfy the request, then NULL is returned.

 

   @param  AllocationSize        The number of bytes to allocate.

 

@@ -430,9 +438,10 @@ AllocateRuntimePool (
 /**

   Allocates a buffer of type EfiReservedMemoryType.

 

-  Allocates the number bytes specified by AllocationSize of type EfiReservedMemoryType and returns

-  a pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is

-  returned.  If there is not enough memory remaining to satisfy the request, then NULL is returned.

+  Allocates the number bytes specified by AllocationSize of type EfiReservedMemoryType 

+  and returns a pointer to the allocated buffer.  If AllocationSize is 0, then a 

+  valid buffer of 0 size is returned.  If there is not enough memory remaining to 

+  satisfy the request, then NULL is returned.

 

   @param  AllocationSize        The number of bytes to allocate.

 

@@ -451,10 +460,10 @@ AllocateReservedPool (
 /**

   Allocates and zeros a buffer of a certain pool type.

 

-  Allocates the number bytes specified by AllocationSize of a certain pool type, clears the buffer

-  with zeros, and returns a pointer to the allocated buffer.  If AllocationSize is 0, then a valid

-  buffer of 0 size is returned.  If there is not enough memory remaining to satisfy the request,

-  then NULL is returned.

+  Allocates the number bytes specified by AllocationSize of a certain pool type, 

+  clears the buffer with zeros, and returns a pointer to the allocated buffer.  

+  If AllocationSize is 0, then a valid buffer of 0 size is returned.  If there is 

+  not enough memory remaining to satisfy the request, then NULL is returned.

 

   @param  PoolType              The type of memory to allocate.

   @param  AllocationSize        The number of bytes to allocate and zero.

@@ -480,10 +489,10 @@ InternalAllocateZeroPool (
 /**

   Allocates and zeros a buffer of type EfiBootServicesData.

 

-  Allocates the number bytes specified by AllocationSize of type EfiBootServicesData, clears the

-  buffer with zeros, and returns a pointer to the allocated buffer.  If AllocationSize is 0, then a

-  valid buffer of 0 size is returned.  If there is not enough memory remaining to satisfy the

-  request, then NULL is returned.

+  Allocates the number bytes specified by AllocationSize of type EfiBootServicesData, 

+  clears the buffer with zeros, and returns a pointer to the allocated buffer.  

+  If AllocationSize is 0, then a valid buffer of 0 size is returned.  If there is 

+  not enough memory remaining to satisfy the request, then NULL is returned.

 

   @param  AllocationSize        The number of bytes to allocate and zero.

 

@@ -502,10 +511,10 @@ AllocateZeroPool (
 /**

   Allocates and zeros a buffer of type EfiRuntimeServicesData.

 

-  Allocates the number bytes specified by AllocationSize of type EfiRuntimeServicesData, clears the

-  buffer with zeros, and returns a pointer to the allocated buffer.  If AllocationSize is 0, then a

-  valid buffer of 0 size is returned.  If there is not enough memory remaining to satisfy the

-  request, then NULL is returned.

+  Allocates the number bytes specified by AllocationSize of type EfiRuntimeServicesData, 

+  clears the buffer with zeros, and returns a pointer to the allocated buffer.  

+  If AllocationSize is 0, then a valid buffer of 0 size is returned.  If there is 

+  not enough memory remaining to satisfy the request, then NULL is returned.

 

   @param  AllocationSize        The number of bytes to allocate and zero.

 

@@ -524,10 +533,10 @@ AllocateRuntimeZeroPool (
 /**

   Allocates and zeros a buffer of type EfiReservedMemoryType.

 

-  Allocates the number bytes specified by AllocationSize of type EfiReservedMemoryType, clears the

-  buffer with zeros, and returns a pointer to the allocated buffer.  If AllocationSize is 0, then a

-  valid buffer of 0 size is returned.  If there is not enough memory remaining to satisfy the

-  request, then NULL is returned.

+  Allocates the number bytes specified by AllocationSize of type EfiReservedMemoryType, 

+  clears the   buffer with zeros, and returns a pointer to the allocated buffer.  

+  If AllocationSize is 0, then a valid buffer of 0 size is returned.  If there is 

+  not enough memory remaining to satisfy the request, then NULL is returned.

 

   @param  AllocationSize        The number of bytes to allocate and zero.

 

@@ -546,11 +555,11 @@ AllocateReservedZeroPool (
 /**

   Copies a buffer to an allocated buffer of a certain pool type.

 

-  Allocates the number bytes specified by AllocationSize of a certain pool type, copies

-  AllocationSize bytes from Buffer to the newly allocated buffer, and returns a pointer to the

-  allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.  If there

-  is not enough memory remaining to satisfy the request, then NULL is returned.

-  If Buffer is NULL, then ASSERT().

+  Allocates the number bytes specified by AllocationSize of a certain pool type, 

+  copies AllocationSize bytes from Buffer to the newly allocated buffer, and returns 

+  a pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer 

+  of 0 size is returned.  If there is not enough memory remaining to satisfy the 

+  request, then NULL is returned. If Buffer is NULL, then ASSERT().

   If AllocationSize is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT(). 

 

   @param  PoolType              The type of pool to allocate.

@@ -582,10 +591,11 @@ InternalAllocateCopyPool (
 /**

   Copies a buffer to an allocated buffer of type EfiBootServicesData.

 

-  Allocates the number bytes specified by AllocationSize of type EfiBootServicesData, copies

-  AllocationSize bytes from Buffer to the newly allocated buffer, and returns a pointer to the

-  allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.  If there

-  is not enough memory remaining to satisfy the request, then NULL is returned.

+  Allocates the number bytes specified by AllocationSize of type EfiBootServicesData, 

+  copies AllocationSize bytes from Buffer to the newly allocated buffer, and returns 

+  a pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer 

+  of 0 size is returned.  If there is not enough memory remaining to satisfy the 

+  request, then NULL is returned.

   

   If Buffer is NULL, then ASSERT().

   If AllocationSize is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT(). 

@@ -609,10 +619,11 @@ AllocateCopyPool (
 /**

   Copies a buffer to an allocated buffer of type EfiRuntimeServicesData.

 

-  Allocates the number bytes specified by AllocationSize of type EfiRuntimeServicesData, copies

-  AllocationSize bytes from Buffer to the newly allocated buffer, and returns a pointer to the

-  allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.  If there

-  is not enough memory remaining to satisfy the request, then NULL is returned.

+  Allocates the number bytes specified by AllocationSize of type EfiRuntimeServicesData, 

+  copies AllocationSize bytes from Buffer to the newly allocated buffer, and returns 

+  a pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer 

+  of 0 size is returned.  If there is not enough memory remaining to satisfy the 

+  request, then NULL is returned.

   

   If Buffer is NULL, then ASSERT().

   If AllocationSize is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT(). 

@@ -636,10 +647,11 @@ AllocateRuntimeCopyPool (
 /**

   Copies a buffer to an allocated buffer of type EfiReservedMemoryType.

 

-  Allocates the number bytes specified by AllocationSize of type EfiReservedMemoryType, copies

-  AllocationSize bytes from Buffer to the newly allocated buffer, and returns a pointer to the

-  allocated buffer.  If AllocationSize is 0, then a valid buffer of 0 size is returned.  If there

-  is not enough memory remaining to satisfy the request, then NULL is returned.

+  Allocates the number bytes specified by AllocationSize of type EfiReservedMemoryType, 

+  copies AllocationSize bytes from Buffer to the newly allocated buffer, and returns 

+  a pointer to the allocated buffer.  If AllocationSize is 0, then a valid buffer 

+  of 0 size is returned.  If there is not enough memory remaining to satisfy the 

+  request, then NULL is returned.

   

   If Buffer is NULL, then ASSERT().

   If AllocationSize is greater than (MAX_ADDRESS - Buffer + 1), then ASSERT(). 

@@ -670,14 +682,14 @@ AllocateReservedCopyPool (
   If NewSize is 0, then a valid buffer of 0 size is  returned.  If there is not 

   enough memory remaining to satisfy the request, then NULL is returned.

   

-  If the allocation of the new buffer is successful and the smaller of NewSize and OldSize

-  is greater than (MAX_ADDRESS - OldBuffer + 1), then ASSERT().

+  If the allocation of the new buffer is successful and the smaller of NewSize 

+  and OldSize is greater than (MAX_ADDRESS - OldBuffer + 1), then ASSERT().

 

   @param  PoolType       The type of pool to allocate.

   @param  OldSize        The size, in bytes, of OldBuffer.

   @param  NewSize        The size, in bytes, of the buffer to reallocate.

-  @param  OldBuffer      The buffer to copy to the allocated buffer.  This is an optional 

-                         parameter that may be NULL.

+  @param  OldBuffer      The buffer to copy to the allocated buffer.  This is an 

+                         optional parameter that may be NULL.

 

   @return A pointer to the allocated buffer or NULL if allocation fails.

 

@@ -710,13 +722,13 @@ InternalReallocatePool (
   If NewSize is 0, then a valid buffer of 0 size is  returned.  If there is not 

   enough memory remaining to satisfy the request, then NULL is returned.

   

-  If the allocation of the new buffer is successful and the smaller of NewSize and OldSize

-  is greater than (MAX_ADDRESS - OldBuffer + 1), then ASSERT().

+  If the allocation of the new buffer is successful and the smaller of NewSize 

+  and OldSize is greater than (MAX_ADDRESS - OldBuffer + 1), then ASSERT().

 

   @param  OldSize        The size, in bytes, of OldBuffer.

   @param  NewSize        The size, in bytes, of the buffer to reallocate.

-  @param  OldBuffer      The buffer to copy to the allocated buffer.  This is an optional 

-                         parameter that may be NULL.

+  @param  OldBuffer      The buffer to copy to the allocated buffer.  This is an 

+                         optional parameter that may be NULL.

 

   @return A pointer to the allocated buffer or NULL if allocation fails.

 

@@ -736,19 +748,19 @@ ReallocatePool (
   Reallocates a buffer of type EfiRuntimeServicesData.

 

   Allocates and zeros the number bytes specified by NewSize from memory of type

-  EfiRuntimeServicesData.  If OldBuffer is not NULL, then the smaller of OldSize and 

-  NewSize bytes are copied from OldBuffer to the newly allocated buffer, and 

+  EfiRuntimeServicesData.  If OldBuffer is not NULL, then the smaller of OldSize 

+  and NewSize bytes are copied from OldBuffer to the newly allocated buffer, and 

   OldBuffer is freed.  A pointer to the newly allocated buffer is returned.  

   If NewSize is 0, then a valid buffer of 0 size is  returned.  If there is not 

   enough memory remaining to satisfy the request, then NULL is returned.

 

-  If the allocation of the new buffer is successful and the smaller of NewSize and OldSize

-  is greater than (MAX_ADDRESS - OldBuffer + 1), then ASSERT().

+  If the allocation of the new buffer is successful and the smaller of NewSize 

+  and OldSize is greater than (MAX_ADDRESS - OldBuffer + 1), then ASSERT().

 

   @param  OldSize        The size, in bytes, of OldBuffer.

   @param  NewSize        The size, in bytes, of the buffer to reallocate.

-  @param  OldBuffer      The buffer to copy to the allocated buffer.  This is an optional 

-                         parameter that may be NULL.

+  @param  OldBuffer      The buffer to copy to the allocated buffer.  This is an 

+                         optional parameter that may be NULL.

 

   @return A pointer to the allocated buffer or NULL if allocation fails.

 

@@ -768,19 +780,19 @@ ReallocateRuntimePool (
   Reallocates a buffer of type EfiReservedMemoryType.

 

   Allocates and zeros the number bytes specified by NewSize from memory of type

-  EfiReservedMemoryType.  If OldBuffer is not NULL, then the smaller of OldSize and 

-  NewSize bytes are copied from OldBuffer to the newly allocated buffer, and 

+  EfiReservedMemoryType.  If OldBuffer is not NULL, then the smaller of OldSize 

+  and NewSize bytes are copied from OldBuffer to the newly allocated buffer, and 

   OldBuffer is freed.  A pointer to the newly allocated buffer is returned.  

   If NewSize is 0, then a valid buffer of 0 size is  returned.  If there is not 

   enough memory remaining to satisfy the request, then NULL is returned.

 

-  If the allocation of the new buffer is successful and the smaller of NewSize and OldSize

-  is greater than (MAX_ADDRESS - OldBuffer + 1), then ASSERT().

+  If the allocation of the new buffer is successful and the smaller of NewSize 

+  and OldSize is greater than (MAX_ADDRESS - OldBuffer + 1), then ASSERT().

 

   @param  OldSize        The size, in bytes, of OldBuffer.

   @param  NewSize        The size, in bytes, of the buffer to reallocate.

-  @param  OldBuffer      The buffer to copy to the allocated buffer.  This is an optional 

-                         parameter that may be NULL.

+  @param  OldBuffer      The buffer to copy to the allocated buffer.  This is an 

+                         optional parameter that may be NULL.

 

   @return A pointer to the allocated buffer or NULL if allocation fails.

 

@@ -797,15 +809,16 @@ ReallocateReservedPool (
 }

 

 /**

-  Frees a buffer that was previously allocated with one of the pool allocation functions in the

-  Memory Allocation Library.

+  Frees a buffer that was previously allocated with one of the pool allocation 

+  functions in the Memory Allocation Library.

 

-  Frees the buffer specified by Buffer.  Buffer must have been allocated on a previous call to the

-  pool allocation services of the Memory Allocation Library.  If it is not possible to free pool

-  resources, then this function will perform no actions.

+  Frees the buffer specified by Buffer.  Buffer must have been allocated on a 

+  previous call to the pool allocation services of the Memory Allocation Library.  

+  If it is not possible to free pool resources, then this function will perform 

+  no actions.

   

-  If Buffer was not allocated with a pool allocation function in the Memory Allocation Library,

-  then ASSERT().

+  If Buffer was not allocated with a pool allocation function in the Memory 

+  Allocation Library, then ASSERT().

 

   @param  Buffer                The pointer to the buffer to free.