diff --git a/doc/api/buffer.md b/doc/api/buffer.md
index 7b406c1fa3c310..0fc31fe02a8180 100644
--- a/doc/api/buffer.md
+++ b/doc/api/buffer.md
@@ -1235,7 +1235,9 @@ console.log(b.toString());
 // Prints: hhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhhh
 ```
 
-`value` is coerced to a `uint32` value if it is not a string or integer.
+`value` is coerced to a `uint32` value if it is not a string, `Buffer`, or
+integer. If the resulting integer is greater than `255` (decimal), `buf` will be
+filled with `0`.
 
 If the final write of a `fill()` operation falls on a multi-byte character,
 then only the bytes of that character that fit into `buf` are written: