Update to doxygen comments.

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

diff --git a/EdkCompatibilityPkg/Compatibility/ReadOnlyVariable2ToReadOnlyVariableThunk/ReadOnlyVariable2ToReadOnlyVariableThunk.c b/EdkCompatibilityPkg/Compatibility/ReadOnlyVariable2ToReadOnlyVariableThunk/ReadOnlyVariable2ToReadOnlyVariableThunk.c
index ee8156573c4c41fd8ed10eb5ec1bdbe2119f947d..d7d4df6ebc94c4d882a0834e1f76380c58a90285 100644 (file)
--- a/EdkCompatibilityPkg/Compatibility/ReadOnlyVariable2ToReadOnlyVariableThunk/ReadOnlyVariable2ToReadOnlyVariableThunk.c
+++ b/EdkCompatibilityPkg/Compatibility/ReadOnlyVariable2ToReadOnlyVariableThunk/ReadOnlyVariable2ToReadOnlyVariableThunk.c
@@ -116,6 +116,21 @@ Returns:
   return PeiServicesInstallPpi (&mPpiListVariable);\r
 }\r
 \r
+/**\r
+  Provide the read variable functionality of the variable services.\r
+\r
+  @param  PeiServices           General purpose services available to every PEIM.\r
+  @param  VariableName          The variable name\r
+  @param  VendorGuid            The vendor's GUID\r
+  @param  Attributes            Pointer to the attribute\r
+  @param  DataSize              Size of data\r
+  @param  Data                  Pointer to data\r
+\r
+  @retval EFI_SUCCESS           The interface could be successfully installed\r
+  @retval EFI_NOT_FOUND         The variable could not be discovered\r
+  @retval EFI_BUFFER_TOO_SMALL  The caller buffer is not large enough\r
+\r
+**/\r
 EFI_STATUS\r
 EFIAPI\r
 PeiGetVariable (\r
@@ -126,35 +141,6 @@ PeiGetVariable (
   IN OUT    UINTN                           *DataSize,\r
   OUT       VOID                            *Data\r
   )\r
-/*++\r
-\r
-Routine Description:\r
-\r
-  Provide the read variable functionality of the variable services.\r
-\r
-Arguments:\r
-\r
-  PeiServices - General purpose services available to every PEIM.\r
-\r
-  VariableName     - The variable name\r
-\r
-  VendorGuid       - The vendor's GUID\r
-\r
-  Attributes       - Pointer to the attribute\r
-\r
-  DataSize         - Size of data\r
-\r
-  Data             - Pointer to data\r
-\r
-Returns:\r
-\r
-  EFI_SUCCESS           - The interface could be successfully installed\r
-\r
-  EFI_NOT_FOUND         - The variable could not be discovered\r
-\r
-  EFI_BUFFER_TOO_SMALL  - The caller buffer is not large enough\r
-\r
---*/\r
 {\r
   EFI_STATUS                     Status;\r
   EFI_PEI_READ_ONLY_VARIABLE_PPI *ReadOnlyVariable;\r
@@ -177,6 +163,21 @@ Returns:
                              );\r
 }\r
 \r
+/**\r
+  Provide the get next variable functionality of the variable services.\r
+\r
+  @param  PeiServices           General purpose services available to every PEIM.\r
+  @param  VariabvleNameSize     The variable name's size.\r
+  @param  VariableName          A pointer to the variable's name.\r
+  @param  VariableGuid          A pointer to the EFI_GUID structure.\r
+  @param  VariableNameSize      Size of the variable name\r
+  @param  VariableName          The variable name\r
+  @param  VendorGuid            The vendor's GUID\r
+\r
+  @retval EFI_SUCCESS           The interface could be successfully installed\r
+  @retval EFI_NOT_FOUND         The variable could not be discovered\r
+\r
+**/\r
 EFI_STATUS\r
 EFIAPI\r
 PeiGetNextVariableName (\r
@@ -185,32 +186,6 @@ PeiGetNextVariableName (
   IN OUT CHAR16                             *VariableName,\r
   IN OUT EFI_GUID                           *VariableGuid\r
   )\r
-/*++\r
-\r
-Routine Description:\r
-\r
-  Provide the get next variable functionality of the variable services.\r
-\r
-Arguments:\r
-\r
-  PeiServices        - General purpose services available to every PEIM.\r
-  VariabvleNameSize  - The variable name's size.\r
-  VariableName       - A pointer to the variable's name.\r
-  VariableGuid       - A pointer to the EFI_GUID structure.\r
-\r
-  VariableNameSize - Size of the variable name\r
-\r
-  VariableName     - The variable name\r
-\r
-  VendorGuid       - The vendor's GUID\r
-\r
-Returns:\r
-\r
-  EFI_SUCCESS - The interface could be successfully installed\r
-\r
-  EFI_NOT_FOUND - The variable could not be discovered\r
-\r
---*/\r
 {\r
   EFI_STATUS                     Status;\r
   EFI_PEI_READ_ONLY_VARIABLE_PPI *ReadOnlyVariable;\r

diff --git a/EdkCompatibilityPkg/Compatibility/ReadOnlyVariableToReadOnlyVariable2Thunk/ReadOnlyVariableToReadOnlyVariable2Thunk.c b/EdkCompatibilityPkg/Compatibility/ReadOnlyVariableToReadOnlyVariable2Thunk/ReadOnlyVariableToReadOnlyVariable2Thunk.c
index 06dd4ccff3d2d187eee4eeffe5d59ac815836b49..fcb6fb53f1e0df6443f3d0e20fbfafed6cc1ca57 100644 (file)
--- a/EdkCompatibilityPkg/Compatibility/ReadOnlyVariableToReadOnlyVariable2Thunk/ReadOnlyVariableToReadOnlyVariable2Thunk.c
+++ b/EdkCompatibilityPkg/Compatibility/ReadOnlyVariableToReadOnlyVariable2Thunk/ReadOnlyVariableToReadOnlyVariable2Thunk.c
@@ -74,7 +74,7 @@ EFI_PEI_PPI_DESCRIPTOR     mPpiListVariable = {
 \r
   @retval EFI_SUCCESS If the gEfiPeiReadOnlyVariablePpiGuid interface could be successfully installed.\r
 \r
---*/\r
+**/\r
 EFI_STATUS\r
 EFIAPI\r
 PeimInitializeReadOnlyVariable (\r
@@ -98,6 +98,21 @@ PeimInitializeReadOnlyVariable (
   return (*PeiServices)->InstallPpi (PeiServices, &mPpiListVariable);\r
 }\r
 \r
+/**\r
+  Provide the read variable functionality of the variable services.\r
+\r
+  @param  PeiServices           General purpose services available to every PEIM.\r
+  @param  VariableName          The variable name\r
+  @param  VendorGuid            The vendor's GUID\r
+  @param  Attributes            Pointer to the attribute\r
+  @param  DataSize              Size of data\r
+  @param  Data                  Pointer to data\r
+\r
+  @retval EFI_SUCCESS           The interface could be successfully installed\r
+  @retval EFI_NOT_FOUND         The variable could not be discovered\r
+  @retval EFI_BUFFER_TOO_SMALL  The caller buffer is not large enough\r
+\r
+**/\r
 EFI_STATUS\r
 EFIAPI\r
 PeiGetVariable (\r
@@ -108,35 +123,6 @@ PeiGetVariable (
   IN  OUT UINTN         *DataSize,\r
   OUT VOID              *Data\r
   )\r
-/*++\r
-\r
-Routine Description:\r
-\r
-  Provide the read variable functionality of the variable services.\r
-\r
-Arguments:\r
-\r
-  PeiServices - General purpose services available to every PEIM.\r
-\r
-  VariableName     - The variable name\r
-\r
-  VendorGuid       - The vendor's GUID\r
-\r
-  Attributes       - Pointer to the attribute\r
-\r
-  DataSize         - Size of data\r
-\r
-  Data             - Pointer to data\r
-\r
-Returns:\r
-\r
-  EFI_SUCCESS           - The interface could be successfully installed\r
-\r
-  EFI_NOT_FOUND         - The variable could not be discovered\r
-\r
-  EFI_BUFFER_TOO_SMALL  - The caller buffer is not large enough\r
-\r
---*/\r
 {\r
   EFI_STATUS                      Status;\r
   EFI_PEI_READ_ONLY_VARIABLE2_PPI *ReadOnlyVariable2;\r
@@ -160,6 +146,21 @@ Returns:
                               );\r
 }\r
 \r
+/**\r
+  Provide the get next variable functionality of the variable services.\r
+\r
+  @param  PeiServices           General purpose services available to every PEIM.\r
+  @param  VariabvleNameSize     The variable name's size.\r
+  @param  VariableName          A pointer to the variable's name.\r
+  @param  VariableGuid          A pointer to the EFI_GUID structure.\r
+  @param  VariableNameSize      Size of the variable name\r
+  @param  VariableName          The variable name\r
+  @param  VendorGuid            The vendor's GUID\r
+\r
+  @retval EFI_SUCCESS           The interface could be successfully installed\r
+  @retval EFI_NOT_FOUND         The variable could not be discovered\r
+\r
+**/\r
 EFI_STATUS\r
 EFIAPI\r
 PeiGetNextVariableName (\r
@@ -168,32 +169,6 @@ PeiGetNextVariableName (
   IN OUT CHAR16        *VariableName,\r
   IN OUT EFI_GUID      *VendorGuid\r
   )\r
-/*++\r
-\r
-Routine Description:\r
-\r
-  Provide the get next variable functionality of the variable services.\r
-\r
-Arguments:\r
-\r
-  PeiServices        - General purpose services available to every PEIM.\r
-  VariabvleNameSize  - The variable name's size.\r
-  VariableName       - A pointer to the variable's name.\r
-  VariableGuid       - A pointer to the EFI_GUID structure.\r
-\r
-  VariableNameSize - Size of the variable name\r
-\r
-  VariableName     - The variable name\r
-\r
-  VendorGuid       - The vendor's GUID\r
-\r
-Returns:\r
-\r
-  EFI_SUCCESS - The interface could be successfully installed\r
-\r
-  EFI_NOT_FOUND - The variable could not be discovered\r
-\r
---*/\r
 {\r
   EFI_STATUS                      Status;\r
   EFI_PEI_READ_ONLY_VARIABLE2_PPI *ReadOnlyVariable2;\r