extensions, plug-ins: fixing CamelCase on the "Plug-In Examples" items. · 34af64b7
Jehan authored Aug 10, 2024
First of all: sorry to all translators who started working on these new
strings!
We use CamelCase for our titles, and in particular "Plug-In" is
capitalized with 'I'.
Furthermore, let's use understandable titles like "Plug-In Example in C"
and not just "In C", because while the short title works OK in the menu,
it makes for very broken action names in non-contextual parts of the
software, such as the action search.
Note that we in fact have a concept of short label for actions since
commit [89772351](/GNOME/gimp/-/commit/89772351c96225950976cfb05da39788b3fb0da7 "Issue #9349: Add concept of "short" (contextual) vs "long" label for actions."). I added support for it to GEGL actions (cf. commit
[6dc5f679](/GNOME/gimp/-/commit/6dc5f6792e1c1b40925aeb6d87fe518b65dc70a3 "app: use the new GEGL metadata "gimp:menu-path" and "gimp:menu-label".")), and to a few core actions (e.g. commit [ea1205f0](/GNOME/gimp/-/commit/ea1205f094041359fd5de5c145559e24e616a10f "Issue #9349: removing 2 duplicate "*-short" actions.")).
Unfortunately I don't think I added an API yet for short label in
plug-ins. Maybe I'll add it soon. But for now, if we have to have a
single label, it should be long, so that it works in every situation.
P.S.: not sure if it's useful to keep documentation strings just
repeating the title, but for now, let's leave them.
extensions, plug-ins: fixing CamelCase on the "Plug-In Examples" items.
Jehan authored Aug 10, 2024
First of all: sorry to all translators who started working on these new
strings!
We use CamelCase for our titles, and in particular "Plug-In" is
capitalized with 'I'.
Furthermore, let's use understandable titles like "Plug-In Example in C"
and not just "In C", because while the short title works OK in the menu,
it makes for very broken action names in non-contextual parts of the
software, such as the action search.
Note that we in fact have a concept of short label for actions since
commit [89772351](/GNOME/gimp/-/commit/89772351c96225950976cfb05da39788b3fb0da7 "Issue #9349: Add concept of "short" (contextual) vs "long" label for actions."). I added support for it to GEGL actions (cf. commit
[6dc5f679](/GNOME/gimp/-/commit/6dc5f6792e1c1b40925aeb6d87fe518b65dc70a3 "app: use the new GEGL metadata "gimp:menu-path" and "gimp:menu-label".")), and to a few core actions (e.g. commit [ea1205f0](/GNOME/gimp/-/commit/ea1205f094041359fd5de5c145559e24e616a10f "Issue #9349: removing 2 duplicate "*-short" actions.")).
Unfortunately I don't think I added an API yet for short label in
plug-ins. Maybe I'll add it soon. But for now, if we have to have a
single label, it should be long, so that it works in every situation.
P.S.: not sure if it's useful to keep documentation strings just
repeating the title, but for now, let's leave them.