Custom GParam flags usage is unclear and possible bug in documentation of maximum user shift
Submitted by Heinrich Fink
Link to original bug (#770077)
Description
In gobject/gparam.h, the documentation of G_PARAM_USER_SHIFT defines the maximum user shift count to be 10:
/**
- G_PARAM_USER_SHIFT:
- Minimum shift count to be used for user defined flags, to be stored in
- #GParamSpec.flags. The maximum allowed is 10. */
Since the shift count is set to 8, this effectively means we can't define more than three user-defined flags, which doesn't seem very practical.
Also, it would be good to know, why G_PARAM_EXPLICIT_NOTIFY and G_PARAM_DEPRECATED start at shift-count 30, and why those flags are not simply continued directly after G_PARAM_STATIC_BLURB.
This seems all a bit unclear and confusing to me. Does someone have an explanation for this, or is this simply a bug in the documentation?