Update comments regarding dictionary keys in public APIS.
Change-Id: I6420fb5a92c4121d68e9db91c822ea53655ae605
Reviewed-on: https://pdfium-review.googlesource.com/14730
Reviewed-by: dsinclair <dsinclair@chromium.org>
Commit-Queue: Lei Zhang <thestig@chromium.org>
diff --git a/public/fpdf_annot.h b/public/fpdf_annot.h
index b927638..1fbc366 100644
--- a/public/fpdf_annot.h
+++ b/public/fpdf_annot.h
@@ -343,7 +343,7 @@
// Check if |annot|'s dictionary has |key| as a key.
//
// annot - handle to an annotation.
-// key - the key to look for.
+// key - the key to look for, encoded in UTF-8.
//
// Returns true if |key| exists.
FPDF_EXPORT FPDF_BOOL FPDF_CALLCONV FPDFAnnot_HasKey(FPDF_ANNOTATION annot,
@@ -353,7 +353,7 @@
// Get the type of the value corresponding to |key| in |annot|'s dictionary.
//
// annot - handle to an annotation.
-// key - the key to look for.
+// key - the key to look for, encoded in UTF-8.
//
// Returns the type of the dictionary value.
FPDF_EXPORT FPDF_OBJECT_TYPE FPDF_CALLCONV
@@ -365,7 +365,7 @@
// FPDF_OBJECT_STRING after this function call succeeds.
//
// annot - handle to an annotation.
-// key - the key to the dictionary entry to be set, encoded in UTF16-LE.
+// key - the key to the dictionary entry to be set, encoded in UTF-8.
// value - the string value to be set, encoded in UTF16-LE.
//
// Returns true if successful.
@@ -384,7 +384,7 @@
// be added to |buffer| and the return value would be 0.
//
// annot - handle to an annotation.
-// key - the key to the requested dictionary entry.
+// key - the key to the requested dictionary entry, encoded in UTF-8.
// buffer - buffer for holding the value string, encoded in UTF16-LE.
// buflen - length of the buffer.
//
@@ -402,7 +402,7 @@
// longer needed.
//
// annot - handle to an annotation.
-// key - the key to the requested dictionary entry.
+// key - the key to the requested dictionary entry, encoded in UTF-8.
//
// Returns a handle to the linked annotation object, or NULL on failure.
FPDF_EXPORT FPDF_ANNOTATION FPDF_CALLCONV