Refine the function comments in ConfigKeywordHandler.c and
HiiDatabase.h.

Cc: Liming Gao <[email protected]>
Cc: Eric Dong <[email protected]>
Contributed-under: TianoCore Contribution Agreement 1.0
Signed-off-by: Dandan Bi <[email protected]>
Reviewed-by: Eric Dong <[email protected]>
---
 MdeModulePkg/Universal/HiiDatabaseDxe/ConfigKeywordHandler.c | 12 +++++++-----
 MdeModulePkg/Universal/HiiDatabaseDxe/HiiDatabase.h          | 12 +++++++-----
 2 files changed, 14 insertions(+), 10 deletions(-)

diff --git a/MdeModulePkg/Universal/HiiDatabaseDxe/ConfigKeywordHandler.c 
b/MdeModulePkg/Universal/HiiDatabaseDxe/ConfigKeywordHandler.c
index 0deaf20..5e7aca9 100644
--- a/MdeModulePkg/Universal/HiiDatabaseDxe/ConfigKeywordHandler.c
+++ b/MdeModulePkg/Universal/HiiDatabaseDxe/ConfigKeywordHandler.c
@@ -1,9 +1,9 @@
 /** @file
 Implementation of interfaces function for EFI_CONFIG_KEYWORD_HANDLER_PROTOCOL.
 
-Copyright (c) 2015, Intel Corporation. All rights reserved.<BR>
+Copyright (c) 2015 - 2016, 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
 which accompanies this distribution.  The full text of the license may be 
found at
 http://opensource.org/licenses/bsd-license.php
 
@@ -2752,12 +2752,13 @@ Done:
   @param KeywordString    A null-terminated string in <MultiKeywordResp> 
format. 
 
   @param Progress         On return, points to a character in the 
KeywordString. 
                           Points to the string's NULL terminator if the 
request 
                           was successful. Points to the most recent '&' before 
-                          the first failing string element if the request was 
-                          not successful.
+                          the first failing name / value pair (or the beginning
+                          of the string if the failure is in the first name / 
value
+                          pair) if the request was not successful.
 
   @param ProgressErr      If during the processing of the KeywordString there 
was
                           a failure, this parameter gives additional 
information 
                           about the possible source of the problem. The 
various 
                           errors are defined in "Related Definitions" below.
@@ -3030,12 +3031,13 @@ Done:
                         keywords in the system for the NameSpaceId specified 
are 
                         returned in the Results field.
   
   @param Progress       On return, points to a character in the KeywordString. 
Points
                         to the string's NULL terminator if the request was 
successful. 
-                        Points to the most recent '&' before the first failing 
string
-                        element if the request was not successful.
+                        Points to the most recent '&' before the first failing 
name / value
+                        pair (or the beginning of the string if the failure is 
in the first
+                        name / value pair) if the request was not successful.
                         
   @param ProgressErr    If during the processing of the KeywordString there 
was a
                         failure, this parameter gives additional information 
about the 
                         possible source of the problem. See the definitions in 
SetData()
                         for valid value definitions.
diff --git a/MdeModulePkg/Universal/HiiDatabaseDxe/HiiDatabase.h 
b/MdeModulePkg/Universal/HiiDatabaseDxe/HiiDatabase.h
index bb0090a..6e28df7 100644
--- a/MdeModulePkg/Universal/HiiDatabaseDxe/HiiDatabase.h
+++ b/MdeModulePkg/Universal/HiiDatabaseDxe/HiiDatabase.h
@@ -1,9 +1,9 @@
 /** @file
 Private structures definitions in HiiDatabase.
 
-Copyright (c) 2007 - 2015, Intel Corporation. All rights reserved.<BR>
+Copyright (c) 2007 - 2016, 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
 which accompanies this distribution.  The full text of the license may be 
found at
 http://opensource.org/licenses/bsd-license.php
 
@@ -1856,12 +1856,13 @@ HiiGetAltCfg (
   @param KeywordString    A null-terminated string in <MultiKeywordResp> 
format. 
 
   @param Progress         On return, points to a character in the 
KeywordString. 
                           Points to the string's NULL terminator if the 
request 
                           was successful. Points to the most recent '&' before 
-                          the first failing string element if the request was 
-                          not successful.
+                          the first failing name / value pair (or the beginning
+                          of the string if the failure is in the first name / 
value
+                          pair) if the request was not successful.
 
   @param ProgressErr      If during the processing of the KeywordString there 
was
                           a failure, this parameter gives additional 
information 
                           about the possible source of the problem. The 
various 
                           errors are defined in "Related Definitions" below.
@@ -1925,12 +1926,13 @@ EfiConfigKeywordHandlerSetData (
                         keywords in the system for the NameSpaceId specified 
are 
                         returned in the Results field.
   
   @param Progress       On return, points to a character in the KeywordString. 
Points
                         to the string's NULL terminator if the request was 
successful. 
-                        Points to the most recent '&' before the first failing 
string
-                        element if the request was not successful.
+                        Points to the most recent '&' before the first failing 
name / value
+                        pair (or the beginning of the string if the failure is 
in the first
+                        name / value pair) if the request was not successful.
                         
   @param ProgressErr    If during the processing of the KeywordString there 
was a
                         failure, this parameter gives additional information 
about the 
                         possible source of the problem. See the definitions in 
SetData()
                         for valid value definitions.
-- 
1.9.5.msysgit.1

_______________________________________________
edk2-devel mailing list
[email protected]
https://lists.01.org/mailman/listinfo/edk2-devel

Reply via email to