Committing changes to the comments, after review with engineers.

[mirror_edk2.git] / IntelFrameworkPkg / Include / Guid / Capsule.h

diff --git a/IntelFrameworkPkg/Include/Guid/Capsule.h b/IntelFrameworkPkg/Include/Guid/Capsule.h
index 90c82cb20eba3417cbdff1170af8594c73d9a182..6413cbabf492774805be9004aaec417e9fd87522 100644 (file)
--- a/IntelFrameworkPkg/Include/Guid/Capsule.h
+++ b/IntelFrameworkPkg/Include/Guid/Capsule.h
@@ -17,8 +17,6 @@
 #ifndef _CAPSULE_GUID_H__\r
 #define _CAPSULE_GUID_H__\r
 \r
-#include <PiPei.h>\r
-\r
 //\r
 // This is the GUID of the capsule header of the image on disk.\r
 //\r
@@ -38,14 +36,14 @@
 \r
 ///\r
 /// Bits in the flags field of the capsule header\r
-/// This flag is set if the capsule can support setup changes and clear if it cannot.\r
+/// This flag is set if the capsule can support setup changes, and cleared if it cannot.\r
 ///\r
 #define EFI_CAPSULE_HEADER_FLAG_SETUP 0x00000001\r
 \r
 #define CAPSULE_BLOCK_DESCRIPTOR_SIGNATURE  SIGNATURE_32 ('C', 'B', 'D', 'S')\r
 \r
 //\r
-// An array of these describe the blocks that make up a capsule for\r
+// An array of these structs describe the blocks that make up a capsule for\r
 // a capsule update.\r
 //\r
 typedef struct {\r
@@ -73,14 +71,14 @@ typedef struct {
   ///\r
   UINT32    HeaderSize;\r
   ///\r
-  /// A bit-mapped list describing the capsule¡¯s attributes. \r
+  /// A bit-mapped list describing the capsule's attributes. \r
   /// All undefined bits should be written as zero (0)\r
   ///\r
   UINT32    Flags;\r
   ///\r
   /// The length in bytes (27,415 for an image containing 27,415 bytes) of the entire image\r
-  /// including all headers. If the this value is greater than the size of the data presented in\r
-  /// the capsule body, this means that the image is separated across multiple media. If this\r
+  /// including all headers. If this value is greater than the size of the data presented in\r
+  /// the capsule body, the image is separated across multiple media. If this\r
   /// value is less than the size of the data, it is an error.\r
   ///\r
   UINT32    CapsuleImageSize;\r
@@ -121,7 +119,7 @@ typedef struct {
   UINT32    OffsetToAuthorInformation;\r
   ///\r
   /// The offset in bytes from the beginning of the header to the start of human-readable\r
-  /// text that describes the revision of the capsule and/or the capsule¡¯s contents. This\r
+  /// text that describes the revision of the capsule and/or the capsule's contents. This\r
   /// value must be less than OffsetToCapsuleBody.\r
   ///\r
   UINT32    OffsetToRevisionInformation;\r