MdePkg: Clean up source files

[mirror_edk2.git] / MdePkg / Include / Ppi / Capsule.h

diff --git a/MdePkg/Include/Ppi/Capsule.h b/MdePkg/Include/Ppi/Capsule.h
index c8fd72fcd8172aa00c970b8c4cb34dad89cd1b6a..cddc12ae4f43aec644c22ee68ed9a4009674e578 100644 (file)
--- a/MdePkg/Include/Ppi/Capsule.h
+++ b/MdePkg/Include/Ppi/Capsule.h
@@ -1,12 +1,12 @@
 /** @file\r
 /** @file\r

-  Defines the APIs that enable PEI services to work with \r
+  Defines the APIs that enable PEI services to work with\r

   the underlying capsule capabilities of the platform.\r
 \r
   the underlying capsule capabilities of the platform.\r
 \r

-Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>\r
-This program and the accompanying materials are licensed and made available under \r
-the terms and conditions of the BSD License that accompanies this distribution.  \r
+Copyright (c) 2015 - 2018, Intel Corporation. All rights reserved.<BR>\r
+This program and the accompanying materials are licensed and made available under\r
+the terms and conditions of the BSD License that accompanies this distribution.\r

 The full text of the license may be found at\r
 The full text of the license may be found at\r

-http://opensource.org/licenses/bsd-license.php.      \r
+http://opensource.org/licenses/bsd-license.php.\r

 \r
 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r
 \r
 THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,\r
 WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.\r


@@ -38,23 +38,23 @@ typedef struct _EFI_PEI_CAPSULE_PPI EFI_PEI_CAPSULE_PPI;
 typedef struct _EFI_PEI_CAPSULE_PPI PEI_CAPSULE_PPI;\r
 \r
 /**\r
 typedef struct _EFI_PEI_CAPSULE_PPI PEI_CAPSULE_PPI;\r
 \r
 /**\r

-  Upon determining that there is a capsule to operate on, this service \r
-  will use a series of EFI_CAPSULE_BLOCK_DESCRIPTOR entries to determine \r
-  the current location of the various capsule fragments and coalesce them \r
-  into a contiguous region of system memory.   \r
+  Upon determining that there is a capsule to operate on, this service\r
+  will use a series of EFI_CAPSULE_BLOCK_DESCRIPTOR entries to determine\r
+  the current location of the various capsule fragments and coalesce them\r
+  into a contiguous region of system memory.\r

 \r
   @param[in]  PeiServices   Pointer to the PEI Services Table.\r
   @param[out] MemoryBase    Pointer to the base of a block of memory into which the buffers will be coalesced.\r
 \r
   @param[in]  PeiServices   Pointer to the PEI Services Table.\r
   @param[out] MemoryBase    Pointer to the base of a block of memory into which the buffers will be coalesced.\r

-                            On output, this variable will hold the base address \r
+                            On output, this variable will hold the base address\r

                             of a coalesced capsule.\r
   @param[out] MemorySize    Size of the memory region pointed to by MemoryBase.\r
                             On output, this variable will contain the size of the\r
                             coalesced capsule.\r
 \r
                             of a coalesced capsule.\r
   @param[out] MemorySize    Size of the memory region pointed to by MemoryBase.\r
                             On output, this variable will contain the size of the\r
                             coalesced capsule.\r
 \r

-  @retval EFI_NOT_FOUND          If: boot modecould not be determined, or the \r
-                                 boot mode is not flash-update, or the capsule descriptors were not found. \r
-  @retval EFI_BUFFER_TOO_SMALL   The capsule could not be coalesced in the provided memory region. \r
-  @retval EFI_SUCCESS            There was no capsule, or the capsule was processed successfully. \r
+  @retval EFI_NOT_FOUND          If: boot modecould not be determined, or the\r
+                                 boot mode is not flash-update, or the capsule descriptors were not found.\r
+  @retval EFI_BUFFER_TOO_SMALL   The capsule could not be coalesced in the provided memory region.\r
+  @retval EFI_SUCCESS            There was no capsule, or the capsule was processed successfully.\r

 \r
 **/\r
 typedef\r
 \r
 **/\r
 typedef\r


@@ -66,12 +66,12 @@ EFI_STATUS
   );\r
 \r
 /**\r
   );\r
 \r
 /**\r

-  Determine if a capsule needs to be processed. \r
+  Determine if a capsule needs to be processed.\r

   The means by which the presence of a capsule is determined is platform\r
   The means by which the presence of a capsule is determined is platform\r

-  specific. For example, an implementation could be driven by the presence \r
-  of a Capsule EFI Variable containing a list of EFI_CAPSULE_BLOCK_DESCRIPTOR \r
+  specific. For example, an implementation could be driven by the presence\r
+  of a Capsule EFI Variable containing a list of EFI_CAPSULE_BLOCK_DESCRIPTOR\r

   entries. If present, return EFI_SUCCESS, otherwise return EFI_NOT_FOUND.\r
   entries. If present, return EFI_SUCCESS, otherwise return EFI_NOT_FOUND.\r

-    \r
+\r

   @param[in] PeiServices   Pointer to the PEI Services Table.\r
 \r
   @retval EFI_SUCCESS     If a capsule is available.\r
   @param[in] PeiServices   Pointer to the PEI Services Table.\r
 \r
   @retval EFI_SUCCESS     If a capsule is available.\r


@@ -87,9 +87,9 @@ EFI_STATUS
 /**\r
   The Capsule PPI service that gets called after memory is available. The\r
   capsule coalesce function, which must be called first, returns a base\r
 /**\r
   The Capsule PPI service that gets called after memory is available. The\r
   capsule coalesce function, which must be called first, returns a base\r

-  address and size. Once the memory init PEIM has discovered memory, \r
-  it should call this function and pass in the base address and size \r
-  returned by the Coalesce() function. Then this function can create a \r
+  address and size. Once the memory init PEIM has discovered memory,\r
+  it should call this function and pass in the base address and size\r
+  returned by the Coalesce() function. Then this function can create a\r

   capsule HOB and return.\r
 \r
   @par Notes:\r
   capsule HOB and return.\r
 \r
   @par Notes:\r


@@ -97,7 +97,7 @@ EFI_STATUS
     actual capsule update.\r
 \r
   @param[in] PeiServices   Pointer to the PEI Services Table.\r
     actual capsule update.\r
 \r
   @param[in] PeiServices   Pointer to the PEI Services Table.\r

-  @param[in] CapsuleBase   Address returned by the capsule coalesce function. \r
+  @param[in] CapsuleBase   Address returned by the capsule coalesce function.\r

   @param[in] CapsuleSize   Value returned by the capsule coalesce function.\r
 \r
   @retval EFI_VOLUME_CORRUPTED   CapsuleBase does not appear to point to a\r
   @param[in] CapsuleSize   Value returned by the capsule coalesce function.\r
 \r
   @retval EFI_VOLUME_CORRUPTED   CapsuleBase does not appear to point to a\r


@@ -110,13 +110,13 @@ EFI_STATUS
 (EFIAPI *EFI_PEI_CAPSULE_CREATE_STATE)(\r
   IN EFI_PEI_SERVICES  **PeiServices,\r
   IN VOID              *CapsuleBase,\r
 (EFIAPI *EFI_PEI_CAPSULE_CREATE_STATE)(\r
   IN EFI_PEI_SERVICES  **PeiServices,\r
   IN VOID              *CapsuleBase,\r

-  IN UINTN             CapsuleSize  \r
+  IN UINTN             CapsuleSize\r

   );\r
 \r
 ///\r
 /// This PPI provides several services in PEI to work with the underlying\r
   );\r
 \r
 ///\r
 /// This PPI provides several services in PEI to work with the underlying\r

-/// capsule capabilities of the platform.  These services include the ability \r
-/// for PEI to coalesce a capsule from a scattered set of memory locations \r
+/// capsule capabilities of the platform.  These services include the ability\r
+/// for PEI to coalesce a capsule from a scattered set of memory locations\r

 /// into a contiguous space in memory, detect if a capsule is present for\r
 /// processing, and once memory is available, create a HOB for the capsule.\r
 ///\r
 /// into a contiguous space in memory, detect if a capsule is present for\r
 /// processing, and once memory is available, create a HOB for the capsule.\r
 ///\r