Fix comments in public headers that refer to "raw bytes"
Several functions have a |buffer| parameter with a comment that refers
to "raw bytes". This does not make sense, so remove them. Instead, add
comments to the corresponding |buflen| parameters to indiciate they are
in bytes.
Change-Id: Ib3b969e9e606761f87ad8cb202eeec1f53a583a2
Reviewed-on: https://pdfium-review.googlesource.com/c/pdfium/+/56950
Reviewed-by: Henrique Nakashima <hnakashima@chromium.org>
Commit-Queue: Henrique Nakashima <hnakashima@chromium.org>
diff --git a/public/fpdf_attachment.h b/public/fpdf_attachment.h
index e92c058..791a90b 100644
--- a/public/fpdf_attachment.h
+++ b/public/fpdf_attachment.h
@@ -138,8 +138,8 @@
// INT_MAX is supported.
//
// attachment - handle to an attachment.
-// contents - buffer holding the file data to be written in raw bytes.
-// len - length of file data.
+// contents - buffer holding the file data to write to |attachment|.
+// len - length of file data in bytes.
//
// Returns true if successful.
FPDF_EXPORT FPDF_BOOL FPDF_CALLCONV
@@ -154,8 +154,8 @@
// returned length is 0.
//
// attachment - handle to an attachment.
-// buffer - buffer for holding the file data in raw bytes.
-// buflen - length of the buffer.
+// buffer - buffer for holding the file data from |attachment|.
+// buflen - length of the buffer in bytes.
//
// Returns the length of the file.
FPDF_EXPORT unsigned long FPDF_CALLCONV
diff --git a/public/fpdf_edit.h b/public/fpdf_edit.h
index b2865b1..d7b02e6 100644
--- a/public/fpdf_edit.h
+++ b/public/fpdf_edit.h
@@ -645,8 +645,8 @@
// the decoded image data.
//
// image_object - handle to an image object.
-// buffer - buffer for holding the decoded image data in raw bytes.
-// buflen - length of the buffer.
+// buffer - buffer for holding the decoded image data.
+// buflen - length of the buffer in bytes.
//
// Returns the length of the decoded image data.
FPDF_EXPORT unsigned long FPDF_CALLCONV
@@ -659,8 +659,8 @@
// |buflen| is longer than the length of the raw image data.
//
// image_object - handle to an image object.
-// buffer - buffer for holding the raw image data in raw bytes.
-// buflen - length of the buffer.
+// buffer - buffer for holding the raw image data.
+// buflen - length of the buffer in bytes.
//
// Returns the length of the raw image data.
FPDF_EXPORT unsigned long FPDF_CALLCONV
