Update MdePkg/Include/Ppi according to code review comments.

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

diff --git a/MdePkg/Include/Ppi/Decompress.h b/MdePkg/Include/Ppi/Decompress.h
index 51ef963246c7b8d5da584f33cd4c55419ff2ba4a..074b057928a1934cc2420dd82533280bd876b925 100644 (file)
--- a/MdePkg/Include/Ppi/Decompress.h
+++ b/MdePkg/Include/Ppi/Decompress.h
@@ -1,7 +1,7 @@
 /** @file\r
   Provides decompression services to the PEI Foundatoin.\r
 \r
-  Copyright (c) 2006, Intel Corporation                                                         \r
+  Copyright (c) 2006 - 2008, Intel Corporation                                                         \r
   All rights reserved. This program and the accompanying materials                          \r
   are licensed and made available under the terms and conditions of the BSD License         \r
   which accompanies this distribution.  The full text of the license may be found at        \r
@@ -23,52 +23,51 @@
 \r
 typedef struct _EFI_PEI_DECOMPRESS_PPI  EFI_PEI_DECOMPRESS_PPI;\r
 \r
-/**                                                              \r
+/** \r
+  Decompress a single compression section in a firmware file.\r
+                                                               \r
   Decompresses the data in a compressed section and returns it\r
   as a series of standard PI Firmware File Sections. The\r
   required memory is allocated from permanent memory.\r
 \r
-  @param This         Points to this instance of the\r
-                      EFI_PEI_DECOMPRESS_PEI PPI. InputSection Points to\r
-                      the compressed section.\r
-\r
-  @param OutputBuffer Holds the returned pointer to the\r
-                      decompressed sections.\r
-\r
-  @param OutputSize   Holds the returned size of the decompress\r
-                      section streams.\r
+  @param This                   Points to this instance of the\r
+                                EFI_PEI_DECOMPRESS_PEI PPI.\r
+  @param InputSection           Points to the compressed section.\r
+  @param OutputBuffer           Holds the returned pointer to the\r
+                                decompressed sections.\r
+  @param OutputSize             Holds the returned size of the decompress\r
+                                section streams.\r
 \r
   @retval EFI_SUCCESS           The section was decompressed\r
                                 successfully. OutputBuffer contains the\r
                                 resulting data and OutputSize contains\r
                                 the resulting size.\r
-\r
   @retval EFI_OUT_OF_RESOURCES  Unable to allocate sufficient\r
                                 memory to hold the decompressed data.\r
-\r
   @retval EFI_UNSUPPORTED       The compression type specified\r
                                 in the compression header is unsupported.\r
+\r
 **/\r
 typedef\r
 EFI_STATUS\r
 (EFIAPI *EFI_PEI_DECOMPRESS_DECOMPRESS)(\r
-  IN CONST  EFI_PEI_DECOMPRESS_PPI  *This,\r
-  IN CONST  EFI_COMPRESSION_SECTION *InputSection,\r
-  OUT       VOID                    **OutputBuffer,\r
-  OUT       UINTN                   *OutputSize\r
+  IN  CONST EFI_PEI_DECOMPRESS_PPI  *This,\r
+  IN  CONST EFI_COMPRESSION_SECTION *InputSection,\r
+  OUT VOID                           **OutputBuffer,\r
+  OUT UINTN                          *OutputSize\r
 );\r
 \r
 \r
-/**                                                              \r
-  This PPI's single member function decompresses a compression\r
-  encapsulated section. It is used by the PEI Foundation to\r
-  process sectioned files. Prior to the installation of this PPI,\r
-  compression sections will be ignored.\r
-\r
-  @param  Decompress  Decompress a single compression section in\r
-                     a firmware file.\r
-**/\r
+///\r
+/// This PPI's single member function decompresses a compression\r
+/// encapsulated section. It is used by the PEI Foundation to\r
+/// process sectioned files. Prior to the installation of this PPI,\r
+/// compression sections will be ignored.\r
+///\r
 struct _EFI_PEI_DECOMPRESS_PPI {\r
+  ///\r
+  /// Decompress a single compression section in a firmware file.\r
+  ///\r
   EFI_PEI_DECOMPRESS_DECOMPRESS Decompress;\r
 };\r
 \r