Grammatical and disclaimer changes (does not follow internal C coding stds.)

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

9 files changed, 188 insertions, 187 deletions

diff --git a/IntelFrameworkPkg/Include/Framework/BootScript.h b/IntelFrameworkPkg/Include/Framework/BootScript.h
index cf846ec86b..b315a8a278 100644
--- a/IntelFrameworkPkg/Include/Framework/BootScript.h
+++ b/IntelFrameworkPkg/Include/Framework/BootScript.h
@@ -2,14 +2,14 @@
   This file contains the boot script defintions that are shared between the 

   Boot Script Executor PPI and the Boot Script Save Protocol.

 

-  Copyright (c) 2009, Intel Corporation

-  All rights reserved. This program and the accompanying materials

-  are licensed and made available under the terms and conditions of the BSD License

-  which accompanies this distribution.  The full text of the license may be found at

-  http://opensource.org/licenses/bsd-license.php

-

-  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,

-  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.

+Copyright (c) 2009 - 2010, Intel Corporation.  All rights reserved<BR>

+This program and the accompanying materials are licensed and made available under 

+the terms and conditions of the BSD License that accompanies this distribution.  

+The full text of the license may be found at

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

+    

+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,                     

+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.

 

 **/

 

@@ -18,28 +18,28 @@
 

 #include <PiDxe.h>

 ///

-/// The framework implementation defines follow opcode which is different from PI specification: 

-/// To add FRAMEWORK_ prefix to avoid naming conflict.

+/// The framework implementation defines follow opcode that are different from the PI specification: 

+/// Add FRAMEWORK_ prefix to avoid naming conflict.

 ///

-/// S3 Boot Script Table identifier

+/// S3 Boot Script Table identifier.

 ///

 #define FRAMEWORK_EFI_ACPI_S3_RESUME_SCRIPT_TABLE               0x00

 ///

-/// The opcode is to add a record for memory reads of the memory location and continues when the 

-/// exit criteria is satisfied or after a defined duration.

+/// The opcode is used to add a record for memory reads of the memory location and continues when the 

+/// exit criteria is satisfied, or after a defined duration.

 ///

 #define FRAMEWORK_EFI_BOOT_SCRIPT_MEM_POLL_OPCODE               0x09

 ///

-/// The opcode is to add a record for dispatching specified arbitrary code into a specified

+/// The opcode is used to add a record for dispatching specified arbitrary code into a specified

 /// boot script table.

 ///

 #define FRAMEWORK_EFI_BOOT_SCRIPT_DISPATCH_2_OPCODE             0x0D

 ///

-/// The opcode indicate the start of the boot script table.

+/// The opcode indicates the start of the boot script table.

 ///

 #define FRAMEWORK_EFI_BOOT_SCRIPT_TABLE_OPCODE                  0xAA

 ///

-/// The opcode indicate the end of the boot script table.

+/// The opcode indicates the end of the boot script table.

 ///

 #define FRAMEWORK_EFI_BOOT_SCRIPT_TERMINATE_OPCODE              0xFF

 

diff --git a/IntelFrameworkPkg/Include/Framework/DxeCis.h b/IntelFrameworkPkg/Include/Framework/DxeCis.h
index 899b514723..4c5fc43c15 100644
--- a/IntelFrameworkPkg/Include/Framework/DxeCis.h
+++ b/IntelFrameworkPkg/Include/Framework/DxeCis.h
@@ -2,14 +2,14 @@
   Include file for definitions in the Intel Platform Innovation Framework for EFI

   Driver Execution Environment Core Interface Specification (DXE CIS) Version 0.91.

 

-  Copyright (c) 2007 - 2010, Intel Corporation

-  All rights reserved. This program and the accompanying materials

-  are licensed and made available under the terms and conditions of the BSD License

-  which accompanies this distribution.  The full text of the license may be found at

-  http://opensource.org/licenses/bsd-license.php

-

-  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,

-  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.

+Copyright (c) 2007 - 2010, Intel Corporation.  All rights reserved<BR>

+This program and the accompanying materials are licensed and made available under 

+the terms and conditions of the BSD License that accompanies this distribution.  

+The full text of the license may be found at

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

+    

+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,                     

+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.

 

 **/

 

@@ -23,7 +23,7 @@
   the  SMM Services Table to execute a procedure on enabled APs.  The context 

   the AP should use durng execution is specified by Buffer.

   

-  @param[in]  Buffer   Pointer to the procedure's argument.

+  @param[in]  Buffer   The pointer to the procedure's argument.

 

 **/

 typedef

@@ -33,7 +33,7 @@ VOID
   );

 

 ///

-/// Framework EFI Runtime Services Table as extension to EFI 1.10 Runtime Services Table

+/// The Framework EFI Runtime Services Table as an extension to the EFI 1.10 Runtime Services Table.

 ///

 typedef struct {

   //

@@ -64,14 +64,14 @@ typedef struct {
   EFI_GET_NEXT_HIGH_MONO_COUNT      GetNextHighMonotonicCount;

   EFI_RESET_SYSTEM                  ResetSystem;

   ///

-  /// Framework extension to EFI 1.10 runtime table

-  /// It was moved to a protocol to not conflict with UEFI 2.0

+  /// A Framework extension to the EFI 1.10 runtime table.

+  /// It was moved to a protocol to avoid conflict with UEFI 2.0.

   ///

   EFI_REPORT_STATUS_CODE            ReportStatusCode;

 } FRAMEWORK_EFI_RUNTIME_SERVICES;

 

 ///

-/// Framework EFI Boot Services Table which comply with DxeCis spec.

+/// The Framework EFI Boot Services Table. Complies with the DxeCis specification.

 ///

 typedef struct {

   ///

diff --git a/IntelFrameworkPkg/Include/Framework/FirmwareVolumeHeader.h b/IntelFrameworkPkg/Include/Framework/FirmwareVolumeHeader.h
index 22bef125e4..ba5f20bacb 100644
--- a/IntelFrameworkPkg/Include/Framework/FirmwareVolumeHeader.h
+++ b/IntelFrameworkPkg/Include/Framework/FirmwareVolumeHeader.h
@@ -1,19 +1,19 @@
 /** @file

-  Defines data structure that is the volume header found at the beginning of

+  Defines the data structure that is the volume header found at the beginning of

   all firmware volumes that are either memory mapped or have an

   associated FirmwareVolumeBlock protocol.

 

-  Copyright (c) 2006-2009, Intel Corporation

-  All rights reserved. This program and the accompanying materials

-  are licensed and made available under the terms and conditions of the BSD License

-  which accompanies this distribution.  The full text of the license may be found at

-  http://opensource.org/licenses/bsd-license.php

-

-  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,

-  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.

+Copyright (c) 2006 - 2010, Intel Corporation.  All rights reserved<BR>

+This program and the accompanying materials are licensed and made available under 

+the terms and conditions of the BSD License that accompanies this distribution.  

+The full text of the license may be found at

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

+    

+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,                     

+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.

 

   @par Revision Reference:

-  These definitions are from Firmware Volume Block Spec 0.9.

+  These definitions are from the Firmware Volume Block Spec 0.9.

 

 **/

 

@@ -21,7 +21,7 @@
 #define __EFI_FIRMWARE_VOLUME_HEADER_H__

 

 ///

-/// Firmware Volume Block Attributes bit definitions

+/// Firmware Volume Block Attributes bit definitions.

 ///@{

 #define EFI_FVB_READ_DISABLED_CAP   0x00000001

 #define EFI_FVB_READ_ENABLED_CAP    0x00000002

@@ -65,9 +65,9 @@
                                 EFI_FVB_LOCK_CAP \

                               )

 

-/** A parameterized macro defining a boolean expression which tests the state of a particular bit.

+/** A parameterized macro defining a boolean expression that tests the state of a particular bit.

   *

-  * @param FvbAttributes  Indicates test for CLEAR if EFI_FVB_ERASE_POLARITY is 1, else test for SET

+  * @param FvbAttributes  Indicates a test for CLEAR if EFI_FVB_ERASE_POLARITY is 1, else test for SET.

   *

   * @param TestAttributes The set of bits to test.

   *

@@ -79,7 +79,7 @@
       ((FvbAttributes & EFI_FVB_ERASE_POLARITY) ? (((~TestAttributes) & Bit) == Bit) : ((TestAttributes & Bit) == Bit)) \

     )

 

-/// A simple macro defined as the set of all FV Block Attribute bits which indicate status.

+/// A simple macro defined as the set of all FV Block Attribute bits that indicate status.

 #define EFI_FVB_STATUS    (EFI_FVB_READ_STATUS | EFI_FVB_WRITE_STATUS | EFI_FVB_LOCK_STATUS)

 

 #endif  /* __EFI_FIRMWARE_VOLUME_HEADER_H__ */

diff --git a/IntelFrameworkPkg/Include/Framework/FirmwareVolumeImageFormat.h b/IntelFrameworkPkg/Include/Framework/FirmwareVolumeImageFormat.h
index 0185887bda..f4d2c6fbfc 100644
--- a/IntelFrameworkPkg/Include/Framework/FirmwareVolumeImageFormat.h
+++ b/IntelFrameworkPkg/Include/Framework/FirmwareVolumeImageFormat.h
@@ -3,17 +3,17 @@
   images loaded via the FirmwareVolume protocol.  The Firmware Volume specification

   is the basis for these definitions.

 

-  Copyright (c) 2006, Intel Corporation                                                         

-  All rights reserved. This program and the accompanying materials                          

-  are licensed and made available under the terms and conditions of the BSD License         

-  which accompanies this distribution.  The full text of the license may be found at        

-  http://opensource.org/licenses/bsd-license.php                                            

-

-  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,                     

-  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.             

+Copyright (c) 2006 - 2010, Intel Corporation.  All rights reserved<BR>

+This program and the accompanying materials are licensed and made available under 

+the terms and conditions of the BSD License that accompanies this distribution.  

+The full text of the license may be found at

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

+    

+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,                     

+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.             

 

   @par Revision Reference:

-  These definitions are from Firmware Volume Spec 0.9.

+  These definitions are from the Firmware Volume Spec 0.9.

 

 **/

 

diff --git a/IntelFrameworkPkg/Include/Framework/FrameworkInternalFormRepresentation.h b/IntelFrameworkPkg/Include/Framework/FrameworkInternalFormRepresentation.h
index a5579c4db2..534452767f 100644
--- a/IntelFrameworkPkg/Include/Framework/FrameworkInternalFormRepresentation.h
+++ b/IntelFrameworkPkg/Include/Framework/FrameworkInternalFormRepresentation.h
@@ -3,17 +3,17 @@
   Framework IFR is primarily consumed by the EFI presentation engine, and produced by EFI

   internal application and drivers as well as all add-in card option-ROM drivers

 

-  Copyright (c) 2007 - 2009, Intel Corporation                                                         

-  All rights reserved. This program and the accompanying materials                          

-  are licensed and made available under the terms and conditions of the BSD License         

-  which accompanies this distribution.  The full text of the license may be found at        

-  http://opensource.org/licenses/bsd-license.php                                            

-

-  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,                     

-  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.             

+Copyright (c) 2007 - 2010, Intel Corporation.  All rights reserved<BR>

+This program and the accompanying materials are licensed and made available under 

+the terms and conditions of the BSD License that accompanies this distribution.  

+The full text of the license may be found at

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

+    

+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,                     

+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.             

 

   @par Revision Reference:

-  These definitions are from Framework Specification HII 0.92.

+  These definitions are from the Framework Specification HII 0.92.

 

 **/

 

@@ -33,7 +33,7 @@ typedef UINT16  STRING_REF;
 #define FRAMEWORK_EFI_IFR_CHECKBOX_OP             0x06

 #define FRAMEWORK_EFI_IFR_NUMERIC_OP              0x07

 #define FRAMEWORK_EFI_IFR_PASSWORD_OP             0x08

-#define FRAMEWORK_EFI_IFR_ONE_OF_OPTION_OP        0x09  ///< ONEOF OPTION field

+#define FRAMEWORK_EFI_IFR_ONE_OF_OPTION_OP        0x09  ///< ONEOF OPTION field.

 #define FRAMEWORK_EFI_IFR_SUPPRESS_IF_OP          0x0A

 #define EFI_IFR_END_FORM_OP                       0x0B

 #define EFI_IFR_HIDDEN_OP                         0x0C

@@ -49,7 +49,7 @@ typedef UINT16  STRING_REF;
 #define FRAMEWORK_EFI_IFR_AND_OP                  0x15

 #define FRAMEWORK_EFI_IFR_OR_OP                   0x16

 #define FRAMEWORK_EFI_IFR_NOT_OP                  0x17

-#define EFI_IFR_END_IF_OP                         0x18  ///< for endif of inconsistentif, suppressif, grayoutif

+#define EFI_IFR_END_IF_OP                         0x18  ///< For endif of inconsistentif, suppressif, grayoutif.

 #define EFI_IFR_GRAYOUT_IF_OP                     0x19

 #define FRAMEWORK_EFI_IFR_DATE_OP                 0x1A

 #define FRAMEWORK_EFI_IFR_TIME_OP                 0x1B

@@ -79,7 +79,7 @@ typedef UINT16  STRING_REF;
 #define EFI_IFR_FLAG_RESET_REQUIRED     0x10

 #define EFI_IFR_FLAG_LATE_CHECK         0x20

 

-#define EFI_NON_DEVICE_CLASS              0x00  ///< Useful when you do not want something in the Device Manager

+#define EFI_NON_DEVICE_CLASS              0x00  ///< Useful when you do not want something in the Device Manager.

 #define EFI_DISK_DEVICE_CLASS             0x01

 #define EFI_VIDEO_DEVICE_CLASS            0x02

 #define EFI_NETWORK_DEVICE_CLASS          0x04

@@ -90,11 +90,11 @@ typedef UINT16  STRING_REF;
 #define EFI_SETUP_APPLICATION_SUBCLASS    0x00

 #define EFI_GENERAL_APPLICATION_SUBCLASS  0x01

 #define EFI_FRONT_PAGE_SUBCLASS           0x02

-#define EFI_SINGLE_USE_SUBCLASS           0x03  ///< Used to display a single entity and then exit

+#define EFI_SINGLE_USE_SUBCLASS           0x03  ///< Used to display a single entity ,and then exit.

 

 ///

 /// Used to flag dynamically created op-codes. This is meaningful to the IFR Library set

-/// and the browser since we need to distinguish between compiled NV map data and created data.

+/// and the browser because we need to distinguish between compiled NV map data and created data.

 /// We do not allow new entries to be created in the NV map dynamically, but we do need

 /// to display this information correctly.  To dynamically create op-codes and assume that their

 /// data will be saved, ensure that the NV starting location they refer to is pre-defined in the

@@ -120,7 +120,7 @@ typedef struct {
   EFI_PHYSICAL_ADDRESS              CallbackHandle;

   UINT16                            Class;

   UINT16                            SubClass;

-  UINT16                            NvDataSize; ///< set once, size of the NV data as defined in the script

+  UINT16                            NvDataSize; ///< Set once; the size of the NV data as defined in the script.

 } FRAMEWORK_EFI_IFR_FORM_SET;

 

 typedef struct {

@@ -145,7 +145,7 @@ typedef struct {
   STRING_REF                        Text;

   STRING_REF                        TextTwo;

   UINT8                             Flags;  ///< This is included solely for purposes of interactive/dynamic support.

-  UINT16                            Key;    ///< Value to be passed to caller to identify this particular op-code

+  UINT16                            Key;    ///< The value to be passed to the caller to identify this particular op-code.

 } FRAMEWORK_EFI_IFR_TEXT;

 

 //

@@ -155,9 +155,9 @@ typedef struct {
   FRAMEWORK_EFI_IFR_OP_HEADER       Header;

   UINT16                            FormId;

   STRING_REF                        Prompt;

-  STRING_REF                        Help;   ///< The string Token for the context-help

+  STRING_REF                        Help;   ///< The string Token for the context-help.

   UINT8                             Flags;  ///< This is included solely for purposes of interactive/dynamic support.

-  UINT16                            Key;    ///< Value to be passed to caller to identify this particular op-code

+  UINT16                            Key;    ///< The value to be passed to the caller to identify this particular op-code.

 } FRAMEWORK_EFI_IFR_REF;

 

 typedef struct {

@@ -175,48 +175,48 @@ typedef struct {
 typedef struct {

   FRAMEWORK_EFI_IFR_OP_HEADER       Header;

   UINT16                            QuestionId; ///< The ID designating what the question is about...

-  UINT8                             Width;      ///< The Size of the Data being saved

-  STRING_REF                        Prompt;     ///< The String Token for the Prompt

-  STRING_REF                        Help;       ///< The string Token for the context-help

+  UINT8                             Width;      ///< The Size of the Data being saved.

+  STRING_REF                        Prompt;     ///< The String Token for the Prompt.

+  STRING_REF                        Help;       ///< The string Token for the context-help.

 } FRAMEWORK_EFI_IFR_ONE_OF;

 

 typedef struct {

   FRAMEWORK_EFI_IFR_OP_HEADER       Header;

-  UINT16                            QuestionId; ///< The offset in NV for storage of the data

-  UINT8                             MaxEntries; ///< The maximum number of options in the ordered list (=size of NVStore)

-  STRING_REF                        Prompt;     ///< The string token for the prompt

-  STRING_REF                        Help;       ///< The string token for the context-help

+  UINT16                            QuestionId; ///< The offset in NV for storage of the data.

+  UINT8                             MaxEntries; ///< The maximum number of options in the ordered list (=size of NVStore).

+  STRING_REF                        Prompt;     ///< The string token for the prompt.

+  STRING_REF                        Help;       ///< The string token for the context-help.

 } FRAMEWORK_EFI_IFR_ORDERED_LIST;

 

 typedef struct {

   FRAMEWORK_EFI_IFR_OP_HEADER       Header;

   UINT16                            QuestionId; ///< The ID designating what the question is about...

-  UINT8                             Width;      ///< The Size of the Data being saved

-  STRING_REF                        Prompt;     ///< The String Token for the Prompt

-  STRING_REF                        Help;       ///< The string Token for the context-help

-  UINT8                             Flags;      ///< If non-zero, means that it is the default option

-  UINT16                            Key;        ///< Value to be passed to caller to identify this particular op-code

+  UINT8                             Width;      ///< The Size of the Data being saved.

+  STRING_REF                        Prompt;     ///< The String Token for the Prompt.

+  STRING_REF                        Help;       ///< The string Token for the context-help.

+  UINT8                             Flags;      ///< If non-zero, it means that it is the default option.

+  UINT16                            Key;        ///< Value to be passed to caller to identify this particular op-code.

 } FRAMEWORK_EFI_IFR_CHECKBOX, EFI_IFR_CHECK_BOX;

 

 typedef struct {

   FRAMEWORK_EFI_IFR_OP_HEADER       Header;

-  STRING_REF                        Option;     ///< The string token describing the option

-  UINT16                            Value;      ///< The value associated with this option that is stored in the NVRAM

-  UINT8                             Flags;      ///< If non-zero, means that it is the default option

-  UINT16                            Key;        ///< Value to be passed to caller to identify this particular op-code

+  STRING_REF                        Option;     ///< The string token describing the option.

+  UINT16                            Value;      ///< The value associated with this option that is stored in the NVRAM.

+  UINT8                             Flags;      ///< If non-zero, it means that it is the default option.

+  UINT16                            Key;        ///< Value to be passed to caller to identify this particular op-code.

 } FRAMEWORK_EFI_IFR_ONE_OF_OPTION;

 

 typedef struct {

   FRAMEWORK_EFI_IFR_OP_HEADER       Header;

   UINT16                            QuestionId; ///< The ID designating what the question is about...

-  UINT8                             Width;      ///< The Size of the Data being saved

-  STRING_REF                        Prompt;     ///< The String Token for the Prompt

-  STRING_REF                        Help;       ///< The string Token for the context-help

+  UINT8                             Width;      ///< The Size of the Data being saved.

+  STRING_REF                        Prompt;     ///< The String Token for the Prompt.

+  STRING_REF                        Help;       ///< The string Token for the context-help.

   UINT8                             Flags;      ///< This is included solely for purposes of interactive/dynamic support.

-  UINT16                            Key;        ///< Value to be passed to caller to identify this particular op-code

+  UINT16                            Key;        ///< The value to be passed to caller to identify this particular op-code.

   UINT16                            Minimum;

   UINT16                            Maximum;

-  UINT16                            Step;       ///< Zero means manual input, otherwise, arrow selection is called for

+  UINT16                            Step;       ///< Zero means manual input. Otherwise, arrow selection is called for.

   UINT16                            Default;

 } FRAMEWORK_EFI_IFR_NUMERIC;

 

@@ -243,26 +243,26 @@ typedef struct {
 typedef struct {

   FRAMEWORK_EFI_IFR_OP_HEADER       Header;

   UINT16                            QuestionId;///< The ID designating what the question is about...

-  UINT8                             Width;     ///< The Size of the Data being saved

-  STRING_REF                        Prompt;    ///< The String Token for the Prompt

-  STRING_REF                        Help;      ///< The string Token for the context-help

+  UINT8                             Width;     ///< The Size of the Data being saved.

+  STRING_REF                        Prompt;    ///< The String Token for the Prompt.

+  STRING_REF                        Help;      ///< The string Token for the context-help.

   UINT8                             Flags;     ///< This is included solely for purposes of interactive/dynamic support.

-  UINT16                            Key;       ///< Value to be passed to caller to identify this particular op-code

-  UINT8                             MinSize;   ///< Minimum allowable sized password

-  UINT8                             MaxSize;   ///< Maximum allowable sized password

+  UINT16                            Key;       ///< The value to be passed to caller to identify this particular op-code.

+  UINT8                             MinSize;   ///< Minimum allowable sized password.

+  UINT8                             MaxSize;   ///< Maximum allowable sized password.

   UINT16                            Encoding;

 } FRAMEWORK_EFI_IFR_PASSWORD;

 

 typedef struct {

   FRAMEWORK_EFI_IFR_OP_HEADER       Header;

   UINT16                            QuestionId; ///< The ID designating what the question is about...

-  UINT8                             Width;      ///< The Size of the Data being saved 

-  STRING_REF                        Prompt;     ///< The String Token for the Prompt

-  STRING_REF                        Help;       ///< The string Token for the context-help

+  UINT8                             Width;      ///< The Size of the Data being saved. 

+  STRING_REF                        Prompt;     ///< The String Token for the Prompt.

+  STRING_REF                        Help;       ///< The string Token for the context-help.

   UINT8                             Flags;      ///< This is included solely for purposes of interactive/dynamic support.

-  UINT16                            Key;        ///< Value to be passed to caller to identify this particular op-code

-  UINT8                             MinSize;    ///< Minimum allowable sized password

-  UINT8                             MaxSize;    ///< Maximum allowable sized password

+  UINT16                            Key;        ///< The value to be passed to caller to identify this particular op-code.

+  UINT8                             MinSize;    ///< Minimum allowable sized password.

+  UINT8                             MaxSize;    ///< Maximum allowable sized password.

 } FRAMEWORK_EFI_IFR_STRING;

 

 typedef struct {

@@ -277,7 +277,7 @@ typedef struct {
 

 ///

 /// Inconsistent with specification here:

-/// Following defintion may not comply with Framework Specification HII 0.92. To 

+/// The following defintion may not comply with Framework Specification HII 0.92. To 

 /// keep the inconsistant is for implementation needed.

 ///@{

 typedef struct {

@@ -298,30 +298,30 @@ typedef struct {
 

 typedef struct {

   FRAMEWORK_EFI_IFR_OP_HEADER       Header;

-  UINT16                            QuestionId;   ///< offset into variable storage

-  UINT8                             Width;        ///< size of variable storage

-  UINT16                            Value;        ///< value to compare against

+  UINT16                            QuestionId;   ///< The offset into variable storage.

+  UINT8                             Width;        ///< The size of variable storage.

+  UINT16                            Value;        ///< The value to compare against.

 } FRAMEWORK_EFI_IFR_EQ_ID_VAL;

 

 typedef struct {

   FRAMEWORK_EFI_IFR_OP_HEADER       Header;

-  UINT16                            QuestionId;   ///< offset into variable storage

-  UINT8                             Width;        ///< size of variable storage

+  UINT16                            QuestionId;   ///< The offset into variable storage.

+  UINT8                             Width;        ///< The size of variable storage.

   UINT16                            ListLength;

   UINT16                            ValueList[1];

 } FRAMEWORK_EFI_IFR_EQ_ID_LIST;

 

 typedef struct {

   FRAMEWORK_EFI_IFR_OP_HEADER       Header;

-  UINT16                            QuestionId1;  ///< offset into variable storage for first value to compare

-  UINT8                             Width;        ///< size of variable storage (must be same for both)

-  UINT16                            QuestionId2;  ///< offset into variable storage for second value to compare

+  UINT16                            QuestionId1;  ///< The offset into variable storage for first value to compare.

+  UINT8                             Width;        ///< The size of variable storage (must be same for both).

+  UINT16                            QuestionId2;  ///< The offset into variable storage for second value to compare.

 } FRAMEWORK_EFI_IFR_EQ_ID_ID;

 

 typedef struct {

   FRAMEWORK_EFI_IFR_OP_HEADER       Header;

-  UINT16                            VariableId;   ///< offset into variable storage

-  UINT16                            Value;        ///< value to compare against

+  UINT16                            VariableId;   ///< The offset into variable storage.

+  UINT16                            Value;        ///< The value to compare against.

 } EFI_IFR_EQ_VAR_VAL;

 ///@}

 

@@ -354,19 +354,19 @@ typedef struct {
   FRAMEWORK_EFI_IFR_OP_HEADER       Header;

   STRING_REF                        Help;

   STRING_REF                        Text;

-  STRING_REF                        TextTwo;    ///< optional text

+  STRING_REF                        TextTwo;    ///< Optional text.

 } EFI_IFR_INVENTORY;

 

 typedef struct {

   FRAMEWORK_EFI_IFR_OP_HEADER       Header;

-  EFI_GUID                          Guid;       ///< GUID for the variable

-  UINT16                            VarId;      ///< variable store ID, as referenced elsewhere in the form

-  UINT16                            Size;       ///< size of the variable storage

+  EFI_GUID                          Guid;       ///< GUID for the variable.

+  UINT16                            VarId;      ///< The variable store ID, as referenced elsewhere in the form.

+  UINT16                            Size;       ///< The size of the variable storage.

 } FRAMEWORK_EFI_IFR_VARSTORE;

 

 typedef struct {

   FRAMEWORK_EFI_IFR_OP_HEADER       Header;

-  UINT16                            VarId;      ///< variable store ID, as referenced elsewhere in the form

+  UINT16                            VarId;      ///< The variable store ID, as referenced elsewhere in the form.

 } EFI_IFR_VARSTORE_SELECT;

 

 ///

@@ -377,20 +377,20 @@ typedef struct {
 ///

 typedef struct {

   FRAMEWORK_EFI_IFR_OP_HEADER       Header;

-  UINT16                            VarId;          ///< variable store ID, as referenced elsewhere in the form

-  UINT16                            SecondaryVarId; ///< variable store ID, as referenced elsewhere in the form

+  UINT16                            VarId;          ///< The variable store ID, as referenced elsewhere in the form.

+  UINT16                            SecondaryVarId; ///< The variable store ID, as referenced elsewhere in the form.

 } EFI_IFR_VARSTORE_SELECT_PAIR;

 

 ///

-/// Save defaults and restore defaults have same structure

+/// Save defaults and restore defaults have same structure.

 ///

 #define EFI_IFR_RESTORE_DEFAULTS  EFI_IFR_SAVE_DEFAULTS

 

 typedef struct {

   FRAMEWORK_EFI_IFR_OP_HEADER       Header;

-  STRING_REF                        Title;        ///< The string token for the banner title

-  UINT16                            LineNumber;   ///< 1-based line number

-  UINT8                             Alignment;    ///< left, center, or right-aligned

+  STRING_REF                        Title;        ///< The string token for the banner title.

+  UINT16                            LineNumber;   ///< 1-based line number.

+  UINT8                             Alignment;    ///< Left, center, or right-aligned.

 } EFI_IFR_BANNER;

 

 #define EFI_IFR_BANNER_ALIGN_LEFT   0

diff --git a/IntelFrameworkPkg/Include/Framework/Hob.h b/IntelFrameworkPkg/Include/Framework/Hob.h
index 810a51fe07..91187504ea 100644
--- a/IntelFrameworkPkg/Include/Framework/Hob.h
+++ b/IntelFrameworkPkg/Include/Framework/Hob.h
@@ -1,17 +1,17 @@
 /** @file

   This file defines the data structures per HOB specification v0.9.

 

-  Copyright (c) 2007 - 2009, Intel Corporation

-  All rights reserved. This program and the accompanying materials

-  are licensed and made available under the terms and conditions of the BSD License

-  which accompanies this distribution.  The full text of the license may be found at

-  http://opensource.org/licenses/bsd-license.php

-

-  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,

-  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.

+Copyright (c) 2007 - 2010, Intel Corporation.  All rights reserved<BR>

+This program and the accompanying materials are licensed and made available under 

+the terms and conditions of the BSD License that accompanies this distribution.  

+The full text of the license may be found at

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

+    

+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,                     

+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.

 

   @par Revision Reference:

-  These definitions are from HOB Spec 0.9 but not adopted by PI specs.

+  These definitions are from the HOB Spec 0.9 that were not adopted by the PI specifications.

 

 **/

 

@@ -19,9 +19,9 @@
 #define _HOB_H_

 

 ///

-/// Capsule volume HOB -- identical to a firmware volume

-/// This macro is defined  to comply with hob Framework Spec. And the marco has been

-/// retired in PI1.0 spec.  

+/// Capsule volume HOB -- identical to a firmware volume.

+/// This macro is defined to comply with the hob Framework Spec. And the marco was

+/// retired in the PI1.0 specification.  

 ///

 #define EFI_HOB_TYPE_CV           0x0008

 

diff --git a/IntelFrameworkPkg/Include/Framework/PeiCis.h b/IntelFrameworkPkg/Include/Framework/PeiCis.h
index 042ec269fe..8aad13a92b 100644
--- a/IntelFrameworkPkg/Include/Framework/PeiCis.h
+++ b/IntelFrameworkPkg/Include/Framework/PeiCis.h
@@ -1,15 +1,15 @@
 /** @file

-  Include file for definitions in the Intel Platform Innovation Framework for EFI

+  The Include file for definitions in the Intel Platform Innovation Framework for EFI

   Pre-EFI Initialization Core Interface Specification (PEI CIS) Version 0.91.

 

-  Copyright (c) 2006 - 2009, Intel Corporation                                                         

-  All rights reserved. This program and the accompanying materials                          

-  are licensed and made available under the terms and conditions of the BSD License         

-  which accompanies this distribution.  The full text of the license may be found at        

-  http://opensource.org/licenses/bsd-license.php                                            

-

-  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,                     

-  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.             

+Copyright (c) 2006 - 2010, Intel Corporation.  All rights reserved<BR>

+This program and the accompanying materials are licensed and made available under 

+the terms and conditions of the BSD License that accompanies this distribution.  

+The full text of the license may be found at

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

+    

+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,                     

+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.             

 

 **/

 

@@ -38,7 +38,7 @@ typedef struct _FRAMEWORK_EFI_PEI_SERVICES FRAMEWORK_EFI_PEI_SERVICES;
   The PEI Dispatcher will invoke each PEIM one time.  During this pass, the PEI 

   Dispatcher will pass control to the PEIM at the AddressOfEntryPoint in the PE Header. 

 

-  @param  FfsHeader        Pointer to the FFS file header.

+  @param  FfsHeader        The pointer to the FFS file header.

   @param  PeiServices      Describes the list of possible PEI Services.

 

   @return Status code

@@ -59,7 +59,7 @@ EFI_STATUS
 

   @param  PeiServices      An indirect pointer to the EFI_PEI_SERVICES table published by the PEI Foundation.

   @param  Instance         This instance of the firmware volume to find. The value 0 is the Boot Firmware Volume (BFV).

-  @param  FwVolHeader      Pointer to the firmware volume header of the volume to return.

+  @param  FwVolHeader      The pointer to the firmware volume header of the volume to return.

 

   @retval EFI_SUCCESS           The volume was found.

   @retval EFI_NOT_FOUND         The volume was not found.

@@ -82,10 +82,10 @@ EFI_STATUS
 

   @param  PeiServices      An indirect pointer to the EFI_PEI_SERVICES table published by the PEI Foundation.

   @param  SearchType       A filter to find files only of this type.

-  @param  FwVolHeader      Pointer to the firmware volume header of the volume to search. This parameter 

+  @param  FwVolHeader      The pointer to the firmware volume header of the volume to search. This parameter 

                            must point to a valid FFS volume.

-  @param  FileHeader       Pointer to the current file from which to begin searching. This pointer will be 

-                           updated upon return to reflect the file found.

+  @param  FileHeader       The pointer to the current file from which to begin searching. Upon return this pointer will be 

+                           updated to reflect the file found.

 

   @retval EFI_SUCCESS      The file was found.

   @retval EFI_NOT_FOUND    The file was not found.

@@ -125,15 +125,15 @@ EFI_STATUS
 

 ///

 ///  FRAMEWORK_EFI_PEI_SERVICES is a collection of functions whose implementation is provided by the PEI

-///  Foundation. The table is located in the temporary or permanent memory, depending upon the capabilities 

+///  Foundation. The table may be located in the temporary or permanent memory, depending upon the capabilities 

 ///  and phase of execution of PEI.

 ///  

 ///  These services fall into various classes, including the following:

-///  - Managing the boot mode

-///  - Allocating both early and permanent memory

-///  - Supporting the Firmware File System (FFS)

-///  - Abstracting the PPI database abstraction

-///  - Creating Hand-Off Blocks (HOBs)

+///  - Managing the boot mode.

+///  - Allocating both early and permanent memory.

+///  - Supporting the Firmware File System (FFS).

+///  - Abstracting the PPI database abstraction.

+///  - Creating Hand-Off Blocks (HOBs).

 ///        

 struct _FRAMEWORK_EFI_PEI_SERVICES {

   EFI_TABLE_HEADER                  Hdr;

@@ -179,7 +179,7 @@ struct _FRAMEWORK_EFI_PEI_SERVICES {
   EFI_PEI_RESET_SYSTEM              ResetSystem;

   ///

   /// Inconsistent with specification here: 

-  /// In Framework Spec, PeiCis0.91, CpuIo and PciCfg is NOT pointers. 

+  /// In Framework Spec, PeiCis0.91, CpuIo and PciCfg are NOT pointers. 

   ///

   

   //

@@ -189,7 +189,7 @@ struct _FRAMEWORK_EFI_PEI_SERVICES {
   EFI_PEI_PCI_CFG_PPI               *PciCfg;

 };

 ///

-/// Enumeration of reset types defined in Framework Spec PeiCis

+/// Enumeration of reset types defined in the Framework Specification PeiCis.

 ///

 typedef enum {

   ///

diff --git a/IntelFrameworkPkg/Include/Framework/SmmCis.h b/IntelFrameworkPkg/Include/Framework/SmmCis.h
index 5ad5d56eb9..4ac9926a98 100644
--- a/IntelFrameworkPkg/Include/Framework/SmmCis.h
+++ b/IntelFrameworkPkg/Include/Framework/SmmCis.h
@@ -2,14 +2,14 @@
   Include file for definitions in the Intel Platform Innovation Framework for EFI

   System Management Mode Core Interface Specification (SMM CIS) version 0.91.

 

-  Copyright (c) 2007 - 2010, Intel Corporation

-  All rights reserved. This program and the accompanying materials

-  are licensed and made available under the terms and conditions of the BSD License

-  which accompanies this distribution.  The full text of the license may be found at

-  http://opensource.org/licenses/bsd-license.php

-

-  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,

-  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.

+Copyright (c) 2007 - 2010, Intel Corporation.  All rights reserved<BR>

+This program and the accompanying materials are licensed and made available under 

+the terms and conditions of the BSD License that accompanies this distribution.  

+The full text of the license may be found at

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

+    

+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,                     

+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.

 

 **/

 

@@ -30,13 +30,14 @@ typedef struct _EFI_SMM_SYSTEM_TABLE      EFI_SMM_SYSTEM_TABLE;
 #define EFI_SMM_SYSTEM_TABLE_REVISION (0 << 16) | (0x09)

 

 /**

-  Allocates pool memory from SMRAM for IA-32 or runtime memory for

+  Allocates pool memory from SMRAM for IA-32, or runtime memory for

   the Itanium processor family.

 

-  @param  PoolType         The type of pool to allocate. The only supported type is EfiRuntimeServicesData

+  @param  PoolType         The type of pool to allocate. The only supported type 

+                           is EfiRuntimeServicesData.

   @param  Size             The number of bytes to allocate from the pool.

-  @param  Buffer           A pointer to a pointer to the allocated buffer if the call

-                           succeeds; undefined otherwise.

+  @param  Buffer           A pointer to a pointer to the allocated buffer if the 

+                           call succeeds.  Otherwise, undefined.

 

   @retval EFI_SUCCESS           The requested number of bytes was allocated.

   @retval EFI_OUT_OF_RESOURCES  The pool requested could not be allocated.

@@ -56,7 +57,7 @@ EFI_STATUS
 /**

   Returns pool memory to the system.

 

-  @param  Buffer           Pointer to the buffer to free.

+  @param  Buffer           The pointer to the buffer to free.

 

   @retval EFI_SUCCESS           The memory was returned to the system.

   @retval EFI_INVALID_PARAMETER Buffer was invalid.

@@ -75,8 +76,8 @@ EFI_STATUS
   Allocates memory pages from the system.

 

   @param  Type             The type of allocation to perform.

-  @param  MemoryType       The only supported type is EfiRuntimeServicesData

-  @param  NumberofPages    The number of contiguous 4 KB pages to allocate

+  @param  MemoryType       The only supported type is EfiRuntimeServicesData.

+  @param  NumberofPages    The number of contiguous 4 KB pages to allocate.

   @param  Memory           Pointer to a physical address. On input, the way in which

                            the address is used depends on the value of Type. On output, the address

                            is set to the base of the page range that was allocated.

@@ -85,7 +86,7 @@ EFI_STATUS
   @retval EFI_OUT_OF_RESOURCES  The pages requested could not be allocated.

   @retval EFI_NOT_FOUND         The requested pages could not be found.

   @retval EFI_INVALID_PARAMETER Type is not AllocateAnyPages or AllocateMaxAddress

-                                or AllocateAddress. Or MemoryType is in the range EfiMaxMemoryType..0x7FFFFFFF.

+                                or AllocateAddress. Or, MemoryType is in the range EfiMaxMemoryType..0x7FFFFFFF.

   @note  Inconsistent with specification here:

          In the Framework Spec, this definition is named EFI_SMM_ALLOCATE_PAGES.  

          To avoid a naming conflict, the definition here is renamed.

@@ -102,7 +103,7 @@ EFI_STATUS
 /**

   Frees memory pages for the system.

 

-  @param  Memory           The base physical address of the pages to be freed

+  @param  Memory           The base physical address of the pages to be freed.

   @param  NumberOfPages    The number of contiguous 4 KB pages to free.

 

   @retval EFI_SUCCESS           The requested memory pages were freed.

@@ -502,9 +503,9 @@ struct _EFI_SMM_SYSTEM_TABLE {
   // MP service

   //

   

-  ///Inconsistent with specification here:

-  ///  In Framework Spec, this definition does not exist. This method is introduced in PI1.1 spec for 

-  ///  implementation needed.

+  /// Inconsistent with specification here:

+  ///  In Framework Spec, this definition does not exist. This method is introduced in PI1.1 specification for 

+  ///  the implementation needed.

   EFI_SMM_STARTUP_THIS_AP             SmmStartupThisAp;

 

   //

diff --git a/IntelFrameworkPkg/Include/Framework/StatusCode.h b/IntelFrameworkPkg/Include/Framework/StatusCode.h
index 440bf09d0c..60708458bb 100644
--- a/IntelFrameworkPkg/Include/Framework/StatusCode.h
+++ b/IntelFrameworkPkg/Include/Framework/StatusCode.h
@@ -2,14 +2,14 @@
   Status Code Definitions, according to Intel Platform Innovation Framework

   for EFI Status Codes Specification

 

-  Copyright (c) 2007, Intel Corporation

-  All rights reserved. This program and the accompanying materials

-  are licensed and made available under the terms and conditions of the BSD License

-  which accompanies this distribution.  The full text of the license may be found at

-  http://opensource.org/licenses/bsd-license.php

-

-  THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,

-  WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.

+Copyright (c) 2007 - 2010, Intel Corporation.  All rights reserved<BR>

+This program and the accompanying materials are licensed and made available under 

+the terms and conditions of the BSD License that accompanies this distribution.  

+The full text of the license may be found at

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

+    

+THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,                     

+WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.

 

   @par Revision Reference:

   Intel Platform Innovation Framework for EFI Status Codes Specification