Minor grammatical work--mostly adding periods. Items with ONLY period added did...

[mirror_edk2.git] / MdePkg / Library / PeiPciSegmentLibPciCfg2 / PciSegmentLib.c

diff --git a/MdePkg/Library/PeiPciSegmentLibPciCfg2/PciSegmentLib.c b/MdePkg/Library/PeiPciSegmentLibPciCfg2/PciSegmentLib.c
index 04284ebcae3c32f41d2bdf753cb1de55394a1810..0d960c5b936799984792da4febc9d5fc39fb2591 100644 (file)
--- a/MdePkg/Library/PeiPciSegmentLibPciCfg2/PciSegmentLib.c
+++ b/MdePkg/Library/PeiPciSegmentLibPciCfg2/PciSegmentLib.c
@@ -6,7 +6,7 @@
   licensed and made available under the terms and conditions of\r
   the BSD License which accompanies this distribution.  The full\r
   text of the license may be found at\r
   licensed and made available under the terms and conditions of\r
   the BSD License which accompanies this distribution.  The full\r
   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


@@ -37,7 +37,7 @@
 /**\r
   Translate PCI Lib address into format of PCI CFG2 PPI.\r
 \r
 /**\r
   Translate PCI Lib address into format of PCI CFG2 PPI.\r
 \r

-  @param  A  Address that encodes the PCI Bus, Device, Function and\r
+  @param  A  The address that encodes the PCI Bus, Device, Function and\r

              Register.\r
 \r
 **/\r
              Register.\r
 \r
 **/\r


@@ -49,7 +49,7 @@
 \r
   This internal function retrieves PCI CFG2 PPI from PPI database.\r
 \r
 \r
   This internal function retrieves PCI CFG2 PPI from PPI database.\r
 \r

-  @param  Address       Address that encodes the PCI Segment, Bus, Device, Function and Register.\r
+  @param  Address       The address that encodes the PCI Segment, Bus, Device, Function and Register.\r

 \r
   @return The pointer to PCI CFG2 PPI.\r
 \r
 \r
   @return The pointer to PCI CFG2 PPI.\r
 \r


@@ -92,7 +92,7 @@ InternalGetPciCfg2Ppi (
   It reads and returns the PCI configuration register specified by Address,\r
   the width of data is specified by Width.\r
 \r
   It reads and returns the PCI configuration register specified by Address,\r
   the width of data is specified by Width.\r
 \r

-  @param  Address Address that encodes the PCI Bus, Device, Function and\r
+  @param  Address The address that encodes the PCI Bus, Device, Function and\r

                   Register.\r
   @param  Width   Width of data to read\r
 \r
                   Register.\r
   @param  Width   Width of data to read\r
 \r


@@ -130,7 +130,7 @@ PeiPciSegmentLibPciCfg2ReadWorker (
   value specified by Data. The width of data is specifed by Width.\r
   Data is returned.\r
 \r
   value specified by Data. The width of data is specifed by Width.\r
   Data is returned.\r
 \r

-  @param  Address Address that encodes the PCI Bus, Device, Function and\r
+  @param  Address The address that encodes the PCI Bus, Device, Function and\r

                   Register.\r
   @param  Width   Width of data to write\r
   @param  Data    The value to write.\r
                   Register.\r
   @param  Width   Width of data to write\r
   @param  Data    The value to write.\r


@@ -167,7 +167,7 @@ PeiPciSegmentLibPciCfg2WriteWorker (
   \r
   If any reserved bits in Address are set, then ASSERT().\r
 \r
   \r
   If any reserved bits in Address are set, then ASSERT().\r
 \r

-  @param  Address Address that encodes the PCI Bus, Device, Function and\r
+  @param  Address The address that encodes the PCI Bus, Device, Function and\r

                   Register.\r
   \r
   @retval RETURN_SUCCESS           The PCI device was registered for runtime access.\r
                   Register.\r
   \r
   @retval RETURN_SUCCESS           The PCI device was registered for runtime access.\r


@@ -197,7 +197,7 @@ PciSegmentRegisterForRuntimeAccess (
   \r
   If any reserved bits in Address are set, then ASSERT().\r
   \r
   \r
   If any reserved bits in Address are set, then ASSERT().\r
   \r

-  @param  Address   Address that encodes the PCI Segment, Bus, Device, Function, and Register.\r
+  @param  Address   The address that encodes the PCI Segment, Bus, Device, Function, and Register.\r

 \r
   @return The 8-bit PCI configuration register specified by Address.\r
 \r
 \r
   @return The 8-bit PCI configuration register specified by Address.\r
 \r


@@ -221,7 +221,7 @@ PciSegmentRead8 (
   \r
   If any reserved bits in Address are set, then ASSERT().\r
 \r
   \r
   If any reserved bits in Address are set, then ASSERT().\r
 \r

-  @param  Address     Address that encodes the PCI Segment, Bus, Device, Function, and Register.\r
+  @param  Address     The address that encodes the PCI Segment, Bus, Device, Function, and Register.\r

   @param  Value       The value to write.\r
 \r
   @return The value written to the PCI configuration register.\r
   @param  Value       The value to write.\r
 \r
   @return The value written to the PCI configuration register.\r


@@ -250,7 +250,7 @@ PciSegmentWrite8 (
   \r
   If any reserved bits in Address are set, then ASSERT().\r
 \r
   \r
   If any reserved bits in Address are set, then ASSERT().\r
 \r

-  @param  Address   Address that encodes the PCI Segment, Bus, Device, Function, and Register.\r
+  @param  Address   The address that encodes the PCI Segment, Bus, Device, Function, and Register.\r

   @param  OrData    The value to OR with the PCI configuration register.\r
 \r
   @return The value written to the PCI configuration register.\r
   @param  OrData    The value to OR with the PCI configuration register.\r
 \r
   @return The value written to the PCI configuration register.\r


@@ -276,7 +276,7 @@ PciSegmentOr8 (
   This function must guarantee that all PCI read and write operations are serialized.\r
   If any reserved bits in Address are set, then ASSERT().\r
 \r
   This function must guarantee that all PCI read and write operations are serialized.\r
   If any reserved bits in Address are set, then ASSERT().\r
 \r

-  @param  Address   Address that encodes the PCI Segment, Bus, Device, Function, and Register.\r
+  @param  Address   The address that encodes the PCI Segment, Bus, Device, Function, and Register.\r

   @param  AndData   The value to AND with the PCI configuration register.\r
 \r
   @return The value written to the PCI configuration register.\r
   @param  AndData   The value to AND with the PCI configuration register.\r
 \r
   @return The value written to the PCI configuration register.\r


@@ -305,7 +305,7 @@ PciSegmentAnd8 (
   \r
   If any reserved bits in Address are set, then ASSERT().\r
 \r
   \r
   If any reserved bits in Address are set, then ASSERT().\r
 \r

-  @param  Address   Address that encodes the PCI Segment, Bus, Device, Function, and Register.\r
+  @param  Address   The address that encodes the PCI Segment, Bus, Device, Function, and Register.\r

   @param  AndData    The value to AND with the PCI configuration register.\r
   @param  OrData    The value to OR with the PCI configuration register.\r
 \r
   @param  AndData    The value to AND with the PCI configuration register.\r
   @param  OrData    The value to OR with the PCI configuration register.\r
 \r


@@ -335,7 +335,7 @@ PciSegmentAndThenOr8 (
   If EndBit is greater than 7, then ASSERT().\r
   If EndBit is less than StartBit, then ASSERT().\r
 \r
   If EndBit is greater than 7, then ASSERT().\r
   If EndBit is less than StartBit, then ASSERT().\r
 \r

-  @param  Address   PCI configuration register to read.\r
+  @param  Address   The PCI configuration register to read.\r

   @param  StartBit  The ordinal of the least significant bit in the bit field.\r
                     Range 0..7.\r
   @param  EndBit    The ordinal of the most significant bit in the bit field.\r
   @param  StartBit  The ordinal of the least significant bit in the bit field.\r
                     Range 0..7.\r
   @param  EndBit    The ordinal of the most significant bit in the bit field.\r


@@ -368,12 +368,12 @@ PciSegmentBitFieldRead8 (
   If EndBit is greater than 7, then ASSERT().\r
   If EndBit is less than StartBit, then ASSERT().\r
 \r
   If EndBit is greater than 7, then ASSERT().\r
   If EndBit is less than StartBit, then ASSERT().\r
 \r

-  @param  Address   PCI configuration register to write.\r
+  @param  Address   The PCI configuration register to write.\r

   @param  StartBit  The ordinal of the least significant bit in the bit field.\r
                     Range 0..7.\r
   @param  EndBit    The ordinal of the most significant bit in the bit field.\r
                     Range 0..7.\r
   @param  StartBit  The ordinal of the least significant bit in the bit field.\r
                     Range 0..7.\r
   @param  EndBit    The ordinal of the most significant bit in the bit field.\r
                     Range 0..7.\r

-  @param  Value     New value of the bit field.\r
+  @param  Value     The new value of the bit field.\r

 \r
   @return The value written back to the PCI configuration register.\r
 \r
 \r
   @return The value written back to the PCI configuration register.\r
 \r


@@ -409,7 +409,7 @@ PciSegmentBitFieldWrite8 (
   If EndBit is greater than 7, then ASSERT().\r
   If EndBit is less than StartBit, then ASSERT().\r
 \r
   If EndBit is greater than 7, then ASSERT().\r
   If EndBit is less than StartBit, then ASSERT().\r
 \r

-  @param  Address   PCI configuration register to write.\r
+  @param  Address   The PCI configuration register to write.\r

   @param  StartBit  The ordinal of the least significant bit in the bit field.\r
                     Range 0..7.\r
   @param  EndBit    The ordinal of the most significant bit in the bit field.\r
   @param  StartBit  The ordinal of the least significant bit in the bit field.\r
                     Range 0..7.\r
   @param  EndBit    The ordinal of the most significant bit in the bit field.\r


@@ -450,7 +450,7 @@ PciSegmentBitFieldOr8 (
   If EndBit is greater than 7, then ASSERT().\r
   If EndBit is less than StartBit, then ASSERT().\r
 \r
   If EndBit is greater than 7, then ASSERT().\r
   If EndBit is less than StartBit, then ASSERT().\r
 \r

-  @param  Address   PCI configuration register to write.\r
+  @param  Address   The PCI configuration register to write.\r

   @param  StartBit  The ordinal of the least significant bit in the bit field.\r
                     Range 0..7.\r
   @param  EndBit    The ordinal of the most significant bit in the bit field.\r
   @param  StartBit  The ordinal of the least significant bit in the bit field.\r
                     Range 0..7.\r
   @param  EndBit    The ordinal of the most significant bit in the bit field.\r


@@ -493,7 +493,7 @@ PciSegmentBitFieldAnd8 (
   If EndBit is greater than 7, then ASSERT().\r
   If EndBit is less than StartBit, then ASSERT().\r
 \r
   If EndBit is greater than 7, then ASSERT().\r
   If EndBit is less than StartBit, then ASSERT().\r
 \r

-  @param  Address   PCI configuration register to write.\r
+  @param  Address   The PCI configuration register to write.\r

   @param  StartBit  The ordinal of the least significant bit in the bit field.\r
                     Range 0..7.\r
   @param  EndBit    The ordinal of the most significant bit in the bit field.\r
   @param  StartBit  The ordinal of the least significant bit in the bit field.\r
                     Range 0..7.\r
   @param  EndBit    The ordinal of the most significant bit in the bit field.\r


@@ -529,7 +529,7 @@ PciSegmentBitFieldAndThenOr8 (
   If any reserved bits in Address are set, then ASSERT().\r
   If Address is not aligned on a 16-bit boundary, then ASSERT().\r
   \r
   If any reserved bits in Address are set, then ASSERT().\r
   If Address is not aligned on a 16-bit boundary, then ASSERT().\r
   \r

-  @param  Address   Address that encodes the PCI Segment, Bus, Device, Function, and Register.\r
+  @param  Address   The address that encodes the PCI Segment, Bus, Device, Function, and Register.\r

 \r
   @return The 16-bit PCI configuration register specified by Address.\r
 \r
 \r
   @return The 16-bit PCI configuration register specified by Address.\r
 \r


@@ -554,7 +554,7 @@ PciSegmentRead16 (
   If any reserved bits in Address are set, then ASSERT().\r
   If Address is not aligned on a 16-bit boundary, then ASSERT().\r
 \r
   If any reserved bits in Address are set, then ASSERT().\r
   If Address is not aligned on a 16-bit boundary, then ASSERT().\r
 \r

-  @param  Address     Address that encodes the PCI Segment, Bus, Device, Function, and Register.\r
+  @param  Address     The address that encodes the PCI Segment, Bus, Device, Function, and Register.\r

   @param  Value       The value to write.\r
 \r
   @return The parameter of Value.\r
   @param  Value       The value to write.\r
 \r
   @return The parameter of Value.\r


@@ -586,7 +586,7 @@ PciSegmentWrite16 (
   If any reserved bits in Address are set, then ASSERT().\r
   If Address is not aligned on a 16-bit boundary, then ASSERT().\r
 \r
   If any reserved bits in Address are set, then ASSERT().\r
   If Address is not aligned on a 16-bit boundary, then ASSERT().\r
 \r

-  @param  Address Address that encodes the PCI Segment, Bus, Device, Function and\r
+  @param  Address The address that encodes the PCI Segment, Bus, Device, Function and\r

                   Register.\r
   @param  OrData  The value to OR with the PCI configuration register.\r
 \r
                   Register.\r
   @param  OrData  The value to OR with the PCI configuration register.\r
 \r


@@ -615,7 +615,7 @@ PciSegmentOr16 (
   If any reserved bits in Address are set, then ASSERT().\r
   If Address is not aligned on a 16-bit boundary, then ASSERT().\r
   \r
   If any reserved bits in Address are set, then ASSERT().\r
   If Address is not aligned on a 16-bit boundary, then ASSERT().\r
   \r

-  @param  Address   Address that encodes the PCI Segment, Bus, Device, Function, and Register.\r
+  @param  Address   The address that encodes the PCI Segment, Bus, Device, Function, and Register.\r

   @param  AndData   The value to AND with the PCI configuration register.\r
 \r
   @return The value written to the PCI configuration register.\r
   @param  AndData   The value to AND with the PCI configuration register.\r
 \r
   @return The value written to the PCI configuration register.\r


@@ -645,7 +645,7 @@ PciSegmentAnd16 (
   If any reserved bits in Address are set, then ASSERT().\r
   If Address is not aligned on a 16-bit boundary, then ASSERT().\r
 \r
   If any reserved bits in Address are set, then ASSERT().\r
   If Address is not aligned on a 16-bit boundary, then ASSERT().\r
 \r

-  @param  Address   Address that encodes the PCI Segment, Bus, Device, Function, and Register.\r
+  @param  Address   The address that encodes the PCI Segment, Bus, Device, Function, and Register.\r

   @param  AndData    The value to AND with the PCI configuration register.\r
   @param  OrData    The value to OR with the PCI configuration register.\r
 \r
   @param  AndData    The value to AND with the PCI configuration register.\r
   @param  OrData    The value to OR with the PCI configuration register.\r
 \r


@@ -676,7 +676,7 @@ PciSegmentAndThenOr16 (
   If EndBit is greater than 15, then ASSERT().\r
   If EndBit is less than StartBit, then ASSERT().\r
 \r
   If EndBit is greater than 15, then ASSERT().\r
   If EndBit is less than StartBit, then ASSERT().\r
 \r

-  @param  Address   PCI configuration register to read.\r
+  @param  Address   The PCI configuration register to read.\r

   @param  StartBit  The ordinal of the least significant bit in the bit field.\r
                     Range 0..15.\r
   @param  EndBit    The ordinal of the most significant bit in the bit field.\r
   @param  StartBit  The ordinal of the least significant bit in the bit field.\r
                     Range 0..15.\r
   @param  EndBit    The ordinal of the most significant bit in the bit field.\r


@@ -710,12 +710,12 @@ PciSegmentBitFieldRead16 (
   If EndBit is greater than 15, then ASSERT().\r
   If EndBit is less than StartBit, then ASSERT().\r
 \r
   If EndBit is greater than 15, then ASSERT().\r
   If EndBit is less than StartBit, then ASSERT().\r
 \r

-  @param  Address   PCI configuration register to write.\r
+  @param  Address   The PCI configuration register to write.\r

   @param  StartBit  The ordinal of the least significant bit in the bit field.\r
                     Range 0..15.\r
   @param  EndBit    The ordinal of the most significant bit in the bit field.\r
                     Range 0..15.\r
   @param  StartBit  The ordinal of the least significant bit in the bit field.\r
                     Range 0..15.\r
   @param  EndBit    The ordinal of the most significant bit in the bit field.\r
                     Range 0..15.\r

-  @param  Value     New value of the bit field.\r
+  @param  Value     The new value of the bit field.\r

 \r
   @return The value written back to the PCI configuration register.\r
 \r
 \r
   @return The value written back to the PCI configuration register.\r
 \r


@@ -746,7 +746,7 @@ PciSegmentBitFieldWrite16 (
   If EndBit is greater than 15, then ASSERT().\r
   If EndBit is less than StartBit, then ASSERT().\r
 \r
   If EndBit is greater than 15, then ASSERT().\r
   If EndBit is less than StartBit, then ASSERT().\r
 \r

-  @param  Address   PCI configuration register to write.\r
+  @param  Address   The PCI configuration register to write.\r

   @param  StartBit  The ordinal of the least significant bit in the bit field.\r
                     Range 0..15.\r
   @param  EndBit    The ordinal of the most significant bit in the bit field.\r
   @param  StartBit  The ordinal of the least significant bit in the bit field.\r
                     Range 0..15.\r
   @param  EndBit    The ordinal of the most significant bit in the bit field.\r


@@ -788,7 +788,7 @@ PciSegmentBitFieldOr16 (
   If EndBit is greater than 7, then ASSERT().\r
   If EndBit is less than StartBit, then ASSERT().\r
 \r
   If EndBit is greater than 7, then ASSERT().\r
   If EndBit is less than StartBit, then ASSERT().\r
 \r

-  @param  Address   Address that encodes the PCI Segment, Bus, Device, Function, and Register.\r
+  @param  Address   The address that encodes the PCI Segment, Bus, Device, Function, and Register.\r

   @param  StartBit  The ordinal of the least significant bit in the bit field.\r
                     The ordinal of the least significant bit in a byte is bit 0.\r
   @param  EndBit    The ordinal of the most significant bit in the bit field.\r
   @param  StartBit  The ordinal of the least significant bit in the bit field.\r
                     The ordinal of the least significant bit in a byte is bit 0.\r
   @param  EndBit    The ordinal of the most significant bit in the bit field.\r


@@ -831,7 +831,7 @@ PciSegmentBitFieldAnd16 (
   If EndBit is greater than 15, then ASSERT().\r
   If EndBit is less than StartBit, then ASSERT().\r
 \r
   If EndBit is greater than 15, then ASSERT().\r
   If EndBit is less than StartBit, then ASSERT().\r
 \r

-  @param  Address   PCI configuration register to write.\r
+  @param  Address   The PCI configuration register to write.\r

   @param  StartBit  The ordinal of the least significant bit in the bit field.\r
                     Range 0..15.\r
   @param  EndBit    The ordinal of the most significant bit in the bit field.\r
   @param  StartBit  The ordinal of the least significant bit in the bit field.\r
                     Range 0..15.\r
   @param  EndBit    The ordinal of the most significant bit in the bit field.\r


@@ -867,7 +867,7 @@ PciSegmentBitFieldAndThenOr16 (
   If any reserved bits in Address are set, then ASSERT().\r
   If Address is not aligned on a 32-bit boundary, then ASSERT().\r
 \r
   If any reserved bits in Address are set, then ASSERT().\r
   If Address is not aligned on a 32-bit boundary, then ASSERT().\r
 \r

-  @param  Address   Address that encodes the PCI Segment, Bus, Device, Function, and Register.\r
+  @param  Address   The address that encodes the PCI Segment, Bus, Device, Function, and Register.\r

 \r
   @return The 32-bit PCI configuration register specified by Address.\r
 \r
 \r
   @return The 32-bit PCI configuration register specified by Address.\r
 \r


@@ -892,7 +892,7 @@ PciSegmentRead32 (
   If any reserved bits in Address are set, then ASSERT().\r
   If Address is not aligned on a 32-bit boundary, then ASSERT().\r
 \r
   If any reserved bits in Address are set, then ASSERT().\r
   If Address is not aligned on a 32-bit boundary, then ASSERT().\r
 \r

-  @param  Address     Address that encodes the PCI Segment, Bus, Device, Function, and Register.\r
+  @param  Address     The address that encodes the PCI Segment, Bus, Device, Function, and Register.\r

   @param  Value       The value to write.\r
 \r
   @return The parameter of Value.\r
   @param  Value       The value to write.\r
 \r
   @return The parameter of Value.\r


@@ -922,7 +922,7 @@ PciSegmentWrite32 (
   If any reserved bits in Address are set, then ASSERT().\r
   If Address is not aligned on a 32-bit boundary, then ASSERT().\r
 \r
   If any reserved bits in Address are set, then ASSERT().\r
   If Address is not aligned on a 32-bit boundary, then ASSERT().\r
 \r

-  @param  Address   Address that encodes the PCI Segment, Bus, Device, Function, and Register.\r
+  @param  Address   The address that encodes the PCI Segment, Bus, Device, Function, and Register.\r

   @param  OrData    The value to OR with the PCI configuration register.\r
 \r
   @return The value written to the PCI configuration register.\r
   @param  OrData    The value to OR with the PCI configuration register.\r
 \r
   @return The value written to the PCI configuration register.\r


@@ -950,7 +950,7 @@ PciSegmentOr32 (
   If any reserved bits in Address are set, then ASSERT().\r
   If Address is not aligned on a 32-bit boundary, then ASSERT().\r
 \r
   If any reserved bits in Address are set, then ASSERT().\r
   If Address is not aligned on a 32-bit boundary, then ASSERT().\r
 \r

-  @param  Address   Address that encodes the PCI Segment, Bus, Device, Function, and Register.\r
+  @param  Address   The address that encodes the PCI Segment, Bus, Device, Function, and Register.\r

   @param  AndData   The value to AND with the PCI configuration register.\r
 \r
   @return The value written to the PCI configuration register.\r
   @param  AndData   The value to AND with the PCI configuration register.\r
 \r
   @return The value written to the PCI configuration register.\r


@@ -980,7 +980,7 @@ PciSegmentAnd32 (
   If any reserved bits in Address are set, then ASSERT().\r
   If Address is not aligned on a 32-bit boundary, then ASSERT().\r
 \r
   If any reserved bits in Address are set, then ASSERT().\r
   If Address is not aligned on a 32-bit boundary, then ASSERT().\r
 \r

-  @param  Address   Address that encodes the PCI Segment, Bus, Device, Function, and Register.\r
+  @param  Address   The address that encodes the PCI Segment, Bus, Device, Function, and Register.\r

   @param  AndData   The value to AND with the PCI configuration register.\r
   @param  OrData    The value to OR with the PCI configuration register.\r
 \r
   @param  AndData   The value to AND with the PCI configuration register.\r
   @param  OrData    The value to OR with the PCI configuration register.\r
 \r


@@ -1011,7 +1011,7 @@ PciSegmentAndThenOr32 (
   If EndBit is greater than 31, then ASSERT().\r
   If EndBit is less than StartBit, then ASSERT().\r
 \r
   If EndBit is greater than 31, then ASSERT().\r
   If EndBit is less than StartBit, then ASSERT().\r
 \r

-  @param  Address   PCI configuration register to read.\r
+  @param  Address   The PCI configuration register to read.\r

   @param  StartBit  The ordinal of the least significant bit in the bit field.\r
                     Range 0..31.\r
   @param  EndBit    The ordinal of the most significant bit in the bit field.\r
   @param  StartBit  The ordinal of the least significant bit in the bit field.\r
                     Range 0..31.\r
   @param  EndBit    The ordinal of the most significant bit in the bit field.\r


@@ -1045,12 +1045,12 @@ PciSegmentBitFieldRead32 (
   If EndBit is greater than 31, then ASSERT().\r
   If EndBit is less than StartBit, then ASSERT().\r
 \r
   If EndBit is greater than 31, then ASSERT().\r
   If EndBit is less than StartBit, then ASSERT().\r
 \r

-  @param  Address   PCI configuration register to write.\r
+  @param  Address   The PCI configuration register to write.\r

   @param  StartBit  The ordinal of the least significant bit in the bit field.\r
                     Range 0..31.\r
   @param  EndBit    The ordinal of the most significant bit in the bit field.\r
                     Range 0..31.\r
   @param  StartBit  The ordinal of the least significant bit in the bit field.\r
                     Range 0..31.\r
   @param  EndBit    The ordinal of the most significant bit in the bit field.\r
                     Range 0..31.\r

-  @param  Value     New value of the bit field.\r
+  @param  Value     The new value of the bit field.\r

 \r
   @return The value written back to the PCI configuration register.\r
 \r
 \r
   @return The value written back to the PCI configuration register.\r
 \r


@@ -1086,7 +1086,7 @@ PciSegmentBitFieldWrite32 (
   If EndBit is greater than 31, then ASSERT().\r
   If EndBit is less than StartBit, then ASSERT().\r
 \r
   If EndBit is greater than 31, then ASSERT().\r
   If EndBit is less than StartBit, then ASSERT().\r
 \r

-  @param  Address   PCI configuration register to write.\r
+  @param  Address   The PCI configuration register to write.\r

   @param  StartBit  The ordinal of the least significant bit in the bit field.\r
                     Range 0..31.\r
   @param  EndBit    The ordinal of the most significant bit in the bit field.\r
   @param  StartBit  The ordinal of the least significant bit in the bit field.\r
                     Range 0..31.\r
   @param  EndBit    The ordinal of the most significant bit in the bit field.\r


@@ -1128,7 +1128,7 @@ PciSegmentBitFieldOr32 (
   If EndBit is less than StartBit, then ASSERT().\r
   \r
 \r
   If EndBit is less than StartBit, then ASSERT().\r
   \r
 \r

-  @param  Address   PCI configuration register to write.\r
+  @param  Address   The PCI configuration register to write.\r

   @param  StartBit  The ordinal of the least significant bit in the bit field.\r
                     Range 0..31.\r
   @param  EndBit    The ordinal of the most significant bit in the bit field.\r
   @param  StartBit  The ordinal of the least significant bit in the bit field.\r
                     Range 0..31.\r
   @param  EndBit    The ordinal of the most significant bit in the bit field.\r


@@ -1171,7 +1171,7 @@ PciSegmentBitFieldAnd32 (
   If EndBit is greater than 31, then ASSERT().\r
   If EndBit is less than StartBit, then ASSERT().\r
 \r
   If EndBit is greater than 31, then ASSERT().\r
   If EndBit is less than StartBit, then ASSERT().\r
 \r

-  @param  Address   PCI configuration register to write.\r
+  @param  Address   The PCI configuration register to write.\r

   @param  StartBit  The ordinal of the least significant bit in the bit field.\r
                     Range 0..31.\r
   @param  EndBit    The ordinal of the most significant bit in the bit field.\r
   @param  StartBit  The ordinal of the least significant bit in the bit field.\r
                     Range 0..31.\r
   @param  EndBit    The ordinal of the most significant bit in the bit field.\r


@@ -1213,10 +1213,10 @@ PciSegmentBitFieldAndThenOr32 (
   If ((StartAddress & 0xFFF) + Size) > 0x1000, then ASSERT().\r
   If Size > 0 and Buffer is NULL, then ASSERT().\r
 \r
   If ((StartAddress & 0xFFF) + Size) > 0x1000, then ASSERT().\r
   If Size > 0 and Buffer is NULL, then ASSERT().\r
 \r

-  @param  StartAddress  Starting address that encodes the PCI Segment, Bus, Device,\r
+  @param  StartAddress  The starting address that encodes the PCI Segment, Bus, Device,\r

                         Function and Register.\r
                         Function and Register.\r

-  @param  Size          Size in bytes of the transfer.\r
-  @param  Buffer        Pointer to a buffer receiving the data read.\r
+  @param  Size          The size in bytes of the transfer.\r
+  @param  Buffer        The pointer to a buffer receiving the data read.\r

 \r
   @return Size\r
 \r
 \r
   @return Size\r
 \r


@@ -1312,10 +1312,10 @@ PciSegmentReadBuffer (
   If ((StartAddress & 0xFFF) + Size) > 0x1000, then ASSERT().\r
   If Size > 0 and Buffer is NULL, then ASSERT().\r
 \r
   If ((StartAddress & 0xFFF) + Size) > 0x1000, then ASSERT().\r
   If Size > 0 and Buffer is NULL, then ASSERT().\r
 \r

-  @param  StartAddress  Starting address that encodes the PCI Segment, Bus, Device,\r
+  @param  StartAddress  The starting address that encodes the PCI Segment, Bus, Device,\r

                         Function and Register.\r
                         Function and Register.\r

-  @param  Size          Size in bytes of the transfer.\r
-  @param  Buffer        Pointer to a buffer containing the data to write.\r
+  @param  Size          The size in bytes of the transfer.\r
+  @param  Buffer        The pointer to a buffer containing the data to write.\r

 \r
   @return The parameter of Size.\r
 \r
 \r
   @return The parameter of Size.\r
 \r