GNOME Bugzilla – Bug 744553
ATK docs provide no guidance for allowed values of some text attributes
Last modified: 2021-06-10 11:27:23 UTC
ATK provides insufficient documentation to implementors about allowed range of values of certain text attributes. Specifically: - "ATK_TEXT_ATTR_WEIGHT: The weight of the characters." - I have no idea what values I can put into this attribute based on this documentation. - "ATK_TEXT_ATTR_LANGUAGE: The language used" - Likewise. - "ATK_TEXT_ATTR_INVALID: Invalid attribute, like bad spelling or grammar." - Likewise. All other attributes are sufficiently documented, i.e. specify which values are valid, e.g.: - "ATK_TEXT_ATTR_STYLE: The slant style of the text, if set. Values are "normal", "oblique" or "italic"" Source of the documentation seems to be in atk/atktext.h.
Also one more thing: with colors, the format of the value is nicely specified: "@ATK_TEXT_ATTR_BG_COLOR: The background color. The value is an RGB value of the format "%u,%u,%u"" But I don't get what is the range of each of the integers, i.e. is it 0-255 (as I would expect), or 0-65535 (as testing with Orca suggests, at least when doing ORCA+F in gnome-terminal to learn its background color)?
GNOME is going to shut down bugzilla.gnome.org in favor of gitlab.gnome.org. As part of that, we are mass-closing older open tickets in bugzilla.gnome.org which have not seen updates for a longer time (resources are unfortunately quite limited so not every ticket can get handled). If you can still reproduce the situation described in this ticket in a recent and supported software version of atk, then please follow https://wiki.gnome.org/GettingInTouch/BugReportingGuidelines and create a ticket at https://gitlab.gnome.org/GNOME/atk/-/issues/ Thank you for your understanding and your help.