10-27-2021, 07:07 PM
(10-27-2021, 10:59 AM)arya Wrote: 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.
Personally, I think it is fine as it is. I have no second thoughts about what that means.
Otherwise since we are now talking about default values, what are these other attributes? What are the default values for each? How to we make sure that the doc changes if the value changes?
OTOH, this is programming. You can try things in a couple of minutes (which is all the better because sometimes the doc can be wrong)