add comments for protocol/print.h and retire ReadOnlyVariableThunkPresent

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

3 files changed, 31 insertions, 29 deletions

diff --git a/EdkCompatibilityPkg/Compatibility/Include/Ppi/EcpPciCfg.h b/EdkCompatibilityPkg/Compatibility/Include/Ppi/EcpPciCfg.h
index 19bd8a8ae4..a58c9dc764 100644
--- a/EdkCompatibilityPkg/Compatibility/Include/Ppi/EcpPciCfg.h
+++ b/EdkCompatibilityPkg/Compatibility/Include/Ppi/EcpPciCfg.h
@@ -22,7 +22,23 @@ WITHOUT WARRANTIES OR REPRESENTATIONS OF ANY KIND, EITHER EXPRESS OR IMPLIED.
 

 typedef struct _ECP_PEI_PCI_CFG_PPI ECP_PEI_PCI_CFG_PPI;

 

+/**

+  PCI read and write operation.

+  

+  Write to/read 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  This                              Pointer to local data for the interface.

+  @param  Width                            The width of the access. Enumerated in bytes.

+                                                    See EFI_PEI_PCI_CFG_PPI_WIDTH above.

+  @param  Address                         The physical address of the access. The format of

+                                                    the address is described by EFI_PEI_PCI_CFG_PPI_PCI_ADDRESS.

+  @param  Buffer                            A pointer to the buffer of data..

+  @retval EFI_SUCCESS                   The function completed successfully.

+  @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.

+**/

 typedef

 EFI_STATUS

 (EFIAPI *ECP_PEI_PCI_CFG_PPI_IO) (

@@ -33,6 +49,16 @@ EFI_STATUS
   IN OUT VOID                 *Buffer

   );

 

+/**

+  The ECP_PEI_PCI_CFG_PPI interfaces are used to abstract accesses to PCI 

+  controllers behind a PCI root bridge controller.

+  @param Read

+  PCI read services.  See the Read() function description.

+  @param Write

+  PCI write services.  See the Write() function description.

+

+**/

+

 struct _ECP_PEI_PCI_CFG_PPI {

   ECP_PEI_PCI_CFG_PPI_IO  Read;

   ECP_PEI_PCI_CFG_PPI_IO  Write;

diff --git a/EdkCompatibilityPkg/Compatibility/Include/Ppi/ReadOnlyVariableThunkPresent.h b/EdkCompatibilityPkg/Compatibility/Include/Ppi/ReadOnlyVariableThunkPresent.h
deleted file mode 100644
index 9ca395d3b8..0000000000
--- a/EdkCompatibilityPkg/Compatibility/Include/Ppi/ReadOnlyVariableThunkPresent.h
+++ /dev/null
@@ -1,28 +0,0 @@
-/** @file

-  PPI published by the ReadOnlyVariable to ReadOnlyVariable2 or ReadOnlyVariable2 to ReadOnlyVariable

-  thunking PEIM to mark that such module has already been excuted.

-

-  This PPI is referenced in Edk2/EdkCompatibility/Compatibility/ReadOnlyVariable2ToReadOnlyVariable 

-  and Edk2/EdkCompatibility/Compatibility/ReadOnlyVariable2ToReadOnlyVariable.

-

-Copyright (c) 2006 - 2008, Intel Corporation. <BR>

-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.

-

-**/

-

-#ifndef _PEI_READONLY_VARIABLE_THUNK_PRESENT_H_

-#define _PEI_READONLY_VARIABLE_THUNK_PRESENT_H_

-

-#define PEI_READONLY_VARIABLE_THUNK_PRESENT_GUID  \

-  { 0xe84e9e0b, 0xb5dd, 0x4d08, { 0x9e, 0x46, 0x82, 0x1f, 0xf, 0x14, 0xe9, 0x1b } }

-

-extern EFI_GUID                     gPeiReadonlyVariableThunkPresentPpiGuid;

-

-#endif

-

diff --git a/EdkCompatibilityPkg/Compatibility/Include/Protocol/Print.h b/EdkCompatibilityPkg/Compatibility/Include/Protocol/Print.h
index 3e26c520f9..5c0426232a 100644
--- a/EdkCompatibilityPkg/Compatibility/Include/Protocol/Print.h
+++ b/EdkCompatibilityPkg/Compatibility/Include/Protocol/Print.h
@@ -68,7 +68,11 @@ UINTN
   IN  VA_LIST       Marker

   );

 

-

+/**

+   The 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 

+   the buffer as output

+**/

 struct _EFI_PRINT_PROTOCOL {

   UNI_VSPRINT               VSPrint;

 };