Questions about how to use API gimp_layer_new()

[arya]

OK. I got it. Do you think the document should be improved? Otherwise, it may confuse developers like me.

For example, the document of gimp_layer_new() should be 

Quote:Other attributes such as layer mask modes, and offsets should be set with explicit procedure calls, if you need to set non-default values for attributes.

with the red clause added.