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

git-svn-id: https://edk2.svn.sourceforge.net/svnroot/edk2/trunk/edk2@10238 6f19259b-4bc3-4df7-8a09-765794883524
This commit is contained in:
myronporter 2010-03-13 01:03:39 +00:00
parent 809bd7b3c9
commit 634366733d
5 changed files with 69 additions and 55 deletions

View File

@ -1,17 +1,18 @@
/** @file /** @file
GUID and Name is used to configure PcdBootState to DynamicHii PCD, which can GUID and Name are used to configure PcdBootState to DynamicHii PCD, which can
make EDKII core work with EDK implementation. make EDKII core work with the EDK implementation.
EDK implementation may depend on this guid variable to check boot state. But The EDK implementation may depend on this guid variable to check the boot state.
EDKII core uses the dynamic PcdBootState to save boot state. To be compatible to EDK implementation, However, the EDKII core uses a dynamic PcdBootState to save the boot state. To be compatible with EDK implementations,
BootStateGuid and BootStateName will be used to configure PcdBootState to DynamicHii PCD to BootStateGuid and BootStateName are used to configure PcdBootState to DynamicHii PCD to
save boot state as variable. save the boot state as a variable.
Copyright (c) 2010, Intel Corporation Copyright (c) 2010, Intel Corporation. All rights reserved<BR>
Portions copyright (c) 2008-2009 Apple Inc. All rights reserved.<BR>
All rights reserved. This program and the accompanying materials All rights reserved. This program and the accompanying materials
are licensed and made available under the terms and conditions of the BSD License 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 which accompanies this distribution. The full text of the license may be found at
http://opensource.org/licenses/bsd-license.php http://opensource.org/licenses/bsd-license.php.
THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.

View File

@ -2,11 +2,12 @@
GUID and data structures for communication between SMM Base on SMM Base2 Thunk driver GUID and data structures for communication between SMM Base on SMM Base2 Thunk driver
and SmmBaseHelper driver. and SmmBaseHelper driver.
Copyright (c) 2009 - 2010, Intel Corporation Copyright (c) 2009 - 2010, Intel Corporation. All rights reserved<BR>
Portions copyright (c) 2008-2009 Apple Inc. All rights reserved.<BR>
All rights reserved. This program and the accompanying materials All rights reserved. This program and the accompanying materials
are licensed and made available under the terms and conditions of the BSD License 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 which accompanies this distribution. The full text of the license may be found at
http://opensource.org/licenses/bsd-license.php http://opensource.org/licenses/bsd-license.php.
THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.

View File

@ -1,11 +1,12 @@
/** @file /** @file
Provides functions for language conversion between ISO 639-2 and RFC 4646 styles. Provides functions for language conversion between ISO 639-2 and RFC 4646 styles.
Copyright (c) 2009 - 2010, Intel Corporation<BR> Copyright (c) 2006 - 2010, Intel Corporation. All rights reserved<BR>
Portions copyright (c) 2008-2009 Apple Inc. All rights reserved.<BR>
All rights reserved. This program and the accompanying materials All rights reserved. This program and the accompanying materials
are licensed and made available under the terms and conditions of the BSD License 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 which accompanies this distribution. The full text of the license may be found at
http://opensource.org/licenses/bsd-license.php http://opensource.org/licenses/bsd-license.php.
THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
@ -28,7 +29,7 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
representing an RFC 4646 language code containing only representing an RFC 4646 language code containing only
either a ISO 639-1 or ISO 639-2 primary language subtag. either a ISO 639-1 or ISO 639-2 primary language subtag.
This string is Null-terminated. This string is Null-terminated.
@param[in] Iso639Language Pointer to a 3-letter ASCII string that represents @param[in] Iso639Language The pointer to a 3-letter ASCII string that represents
an ISO 639-2 language code. This string is not required an ISO 639-2 language code. This string is not required
to be Null-terminated. to be Null-terminated.
@ -53,8 +54,10 @@ ConvertIso639ToRfc4646 (
If Iso639Language is NULL, then ASSERT(). If Iso639Language is NULL, then ASSERT().
@param[out] Iso639Language Pointers to a buffer large enough for a 3-letter ASCII string @param[out] Iso639Language Pointers to a buffer large enough for a 3-letter ASCII string
representing an ISO 639-2 language code. The string is Null-terminated. representing an ISO 639-2 language code. The string
@param[in] Rfc4646Language Pointer to a RFC 4646 language code string. This string is terminated is Null-terminated.
@param[in] Rfc4646Language The pointer to a RFC 4646 language code string.
This string is terminated
by a NULL or a ';' character. by a NULL or a ';' character.
@retval TRUE Language code converted successfully. @retval TRUE Language code converted successfully.
@ -79,8 +82,10 @@ ConvertRfc4646ToIso639 (
@retval NULL Invalid ISO 639-2 language code found. @retval NULL Invalid ISO 639-2 language code found.
@retval NULL Out of memory. @retval NULL Out of memory.
@return Pointer to the allocate buffer containing the Null-terminated converted language codes string. @return The pointer to the allocate buffer containing the
This string is composed of one or more RFC4646 language codes each of which has only Null-terminated converted language codes string.
This string is composed of one or more RFC4646
language codes each of which has only
ISO 639-1 2-letter primary language subtag. ISO 639-1 2-letter primary language subtag.
**/ **/
@ -97,13 +102,15 @@ ConvertLanguagesIso639ToRfc4646 (
If Rfc4646Languages is NULL, then ASSERT. If Rfc4646Languages is NULL, then ASSERT.
@param[in] Rfc4646Languages Pointers to a Null-terminated RFC 4646 language codes string containing @param[in] Rfc4646Languages Pointers to a Null-terminated RFC 4646 language codes
one or more RFC 4646 language codes. string containing one or more RFC 4646 language codes.
@retval NULL Invalid or unsupported RFC 4646 language code found. @retval NULL Invalid or unsupported RFC 4646 language code found.
@retval NULL Out of memory. @retval NULL Out of memory.
@return Pointer to the allocate buffer containing the Null-terminated converted language codes string. @return The pointer to the allocate buffer containing the
This string is composed of one or more ISO 639-2 language codes. Null-terminated converted language codes string.
This string is composed of one or more ISO 639-2
language codes.
**/ **/
CHAR8 * CHAR8 *

View File

@ -1,11 +1,13 @@
/** @file /** @file
This PPI is the same as the PPI in the framework PciCfg, with one exception: this PPI does not include a modify API, while the PPI in the framework PciCfg does. This PPI is the same as the PPI in the framework PciCfg, with one exception.
Specifically, this PPI does not include a modify API, while the PPI in the framework PciCfg does.
Copyright (c) 2008 - 2010, Intel Corporation Copyright (c) 2008 - 2010, Intel Corporation. All rights reserved<BR>
Portions copyright (c) 2008-2009 Apple Inc. All rights reserved.<BR>
All rights reserved. This program and the accompanying materials All rights reserved. This program and the accompanying materials
are licensed and made available under the terms and conditions of the BSD License 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 which accompanies this distribution. The full text of the license may be found at
http://opensource.org/licenses/bsd-license.php http://opensource.org/licenses/bsd-license.php.
THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
@ -23,19 +25,21 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
typedef struct _ECP_PEI_PCI_CFG_PPI ECP_PEI_PCI_CFG_PPI; typedef struct _ECP_PEI_PCI_CFG_PPI ECP_PEI_PCI_CFG_PPI;
/** /**
PCI read and write operation. A PCI read and write operation.
Writes to or reads from a given location in the PCI configuration space. Writes to, or reads from, a given location in the PCI configuration space.
@param PeiServices An indirect pointer to the PEI Services Table published by the PEI Foundation. @param PeiServices An indirect pointer to the PEI Services Table
@param This Pointer to local data for the interface. published by the PEI Foundation.
@param This The pointer to local data for the interface.
@param Width The width of the access. Enumerated in bytes. @param Width The width of the access. Enumerated in bytes.
@param Address The physical address of the access. The format of @param Address The physical address of the access. The format of
the address is described by EFI_PEI_PCI_CFG_PPI_PCI_ADDRESS. the address is described by EFI_PEI_PCI_CFG_PPI_PCI_ADDRESS.
@param Buffer A pointer to the buffer of data. @param Buffer A pointer to the buffer of data.
@retval EFI_SUCCESS The function completed successfully. @retval EFI_SUCCESS The function completed successfully.
@retval EFI_DEVICE_ERROR There was a problem with the transaction. @retval EFI_DEVICE_ERROR There was a problem with the transaction.
@retval EFI_DEVICE_NOT_READY The device is not capable of supporting the operation at this time. @retval EFI_DEVICE_NOT_READY The device is not capable of supporting the
operation at this time.
**/ **/
typedef typedef
EFI_STATUS EFI_STATUS

View File

@ -3,11 +3,12 @@
The lite print protocol defines only one print function to The lite print protocol defines only one print function to
print the format unicode string. print the format unicode string.
Copyright (c) 2006 - 2008, Intel Corporation Copyright (c) 2006 - 2010, Intel Corporation. All rights reserved<BR>
Portions copyright (c) 2008-2009 Apple Inc. All rights reserved.<BR>
All rights reserved. This program and the accompanying materials All rights reserved. This program and the accompanying materials
are licensed and made available under the terms and conditions of the BSD License 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 which accompanies this distribution. The full text of the license may be found at
http://opensource.org/licenses/bsd-license.php http://opensource.org/licenses/bsd-license.php.
THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS, THE PROGRAM IS DISTRIBUTED UNDER THE BSD LICENSE ON AN "AS IS" BASIS,
WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED. WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
@ -26,17 +27,17 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
typedef struct _EFI_PRINT_PROTOCOL EFI_PRINT_PROTOCOL; typedef struct _EFI_PRINT_PROTOCOL EFI_PRINT_PROTOCOL;
/** /**
Produces a Null-terminated Unicode string in an output buffer based on Produces a Null-terminated Unicode string in an output buffer, based on
a Null-terminated Unicode format string and a VA_LIST argument list a Null-terminated Unicode format string and a VA_LIST argument list.
Produces a Null-terminated Unicode string in the output buffer specified by StartOfBuffer Produces a Null-terminated Unicode string in the output buffer specified by StartOfBuffer
and BufferSize. and BufferSize.
The Unicode string is produced by parsing the format string specified by FormatString. The Unicode string is produced by parsing the format string specified by FormatString.
Arguments are pulled from the variable argument list specified by Marker based on the Arguments are pulled from the variable argument list specified by Marker based on the
contents of the format string. contents of the format string.
The number of Unicode characters in the produced output buffer is returned not including The number of Unicode characters in the produced output buffer is returned, not including
the Null-terminator. the Null-terminator.
If BufferSize is 0 or 1, then no output buffer is produced and 0 is returned. If BufferSize is 0 or 1, then no output buffer is produced, and 0 is returned.
If BufferSize > 1 and StartOfBuffer is NULL, then ASSERT(). If BufferSize > 1 and StartOfBuffer is NULL, then ASSERT().
If BufferSize > 1 and StartOfBuffer is not aligned on a 16-bit boundary, then ASSERT(). If BufferSize > 1 and StartOfBuffer is not aligned on a 16-bit boundary, then ASSERT().
@ -46,13 +47,13 @@ typedef struct _EFI_PRINT_PROTOCOL EFI_PRINT_PROTOCOL;
PcdMaximumUnicodeStringLength Unicode characters not including the Null-terminator, then PcdMaximumUnicodeStringLength Unicode characters not including the Null-terminator, then
ASSERT(). ASSERT().
If PcdMaximumUnicodeStringLength is not zero, and produced Null-terminated Unicode string If PcdMaximumUnicodeStringLength is not zero, and produced Null-terminated Unicode string
contains more than PcdMaximumUnicodeStringLength Unicode characters not including the contains more than PcdMaximumUnicodeStringLength Unicode characters, not including the
Null-terminator, then ASSERT(). Null-terminator, then ASSERT().
@param StartOfBuffer A pointer to the output buffer for the produced Null-terminated @param StartOfBuffer A pointer to the output buffer for the produced Null-terminated
Unicode string. Unicode string.
@param BufferSize The size, in bytes, of the output buffer specified by StartOfBuffer. @param BufferSize The size, in bytes, of the output buffer specified by StartOfBuffer.
@param FormatString Null-terminated Unicode format string. @param FormatString A Null-terminated Unicode format string.
@param Marker VA_LIST marker for the variable argument list. @param Marker VA_LIST marker for the variable argument list.
@return The number of Unicode characters in the produced output buffer not including the @return The number of Unicode characters in the produced output buffer not including the
@ -69,9 +70,9 @@ UINTN
); );
/** /**
The EFI_PRINT_PROTOCOL provides one service to produce a Null-terminated Unicode string EFI_PRINT_PROTOCOL provides one service to produce a Null-terminated Unicode string,
based on a Null-terminated Unicode format string and a VA_LIST argument list and fill into based on a Null-terminated Unicode format string and a VA_LIST argument list, and fills into
the buffer as output the buffer as output.
**/ **/
struct _EFI_PRINT_PROTOCOL { struct _EFI_PRINT_PROTOCOL {
UNI_VSPRINT VSPrint; UNI_VSPRINT VSPrint;