diff --git a/llama.h b/llama.h
index b0eec3a37..bf7c8475d 100644
--- a/llama.h
+++ b/llama.h
@@ -302,12 +302,14 @@ extern "C" {
     LLAMA_API float llama_rope_freq_scale_train(const struct llama_model * model);
 
     // Functions to access the model's GGUF metadata scalar values
-    // Note: array values are not returned by these functions
+    // - The functions return the length of the string on success, or -1 on failure
+    // - The output string is always null-terminated and cleared on failure
+    // - GGUF array values are not supported by these functions
 
     // Get metadata value as a string by key name
     LLAMA_API int llama_model_meta_val_str(const struct llama_model * model, const char * key, char * buf, size_t buf_size);
 
-    // Get number of metadata key/value pairs
+    // Get the number of metadata key/value pairs
     LLAMA_API int llama_model_meta_count(const struct llama_model * model);
 
     // Get metadata key name by index