[Caml-list] caml_alloc_final() user data size - error in doc?

[Jun Inoue <jun.lambda@gmail.com>]

Hello, I'm writing a binding for a C library, and I came across this
statement in the manual:

> caml_alloc_final(n, f, used, max) returns a fresh custom block of size n
> words, with finalization function f. The first word is reserved for storing
> the custom operations; the other n-1 words are available for your data.

The implementation of caml_alloc_final(n, f, ...) just calls
caml_alloc_custom(caml_final_custom_operations(f), n * sizeof(value), ...),
but the documentation of the latter function says nothing about the storage
for custom operations, so this doesn't add up.

According to the source code, caml_alloc_final (n, f, ...) seems to
allocate space for n user-defined words, not n-1.  Is this a bug in
the documentation, or is it intended for some reason that
caml_alloc_final() provides only n-1 words of usable storage?

-- 
Jun Inoue