Bug 250688 - [WPE][GTK] Remove most property nicks/blurbs
Summary: [WPE][GTK] Remove most property nicks/blurbs
Status: RESOLVED FIXED
Alias: None
Product: WebKit
Classification: Unclassified
Component: WebKitGTK (show other bugs)
Version: WebKit Nightly Build
Hardware: PC Linux
: P2 Normal
Assignee: Michael Catanzaro
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2023-01-16 14:13 PST by Michael Catanzaro
Modified: 2023-01-17 00:47 PST (History)
1 user (show)

See Also:


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Michael Catanzaro 2023-01-16 14:13:10 PST
GObject property nicks and blurbs are mostly useless and require thinking to write, so we should get rid of almost all of them. This is especially beneficial for translators: most (but not all) of our nicks and blurbs are translated, and it's wasted effort to translate something that is never used. GTK has already removed its nicks and blurbs in https://gitlab.gnome.org/GNOME/gtk/-/issues/4904, and we should follow.

Well, mostly. An exception is WebKitSettings. MiniBrowser is using the nicks and blurbs to programatically create its settings dialog. This is probably the best use of nicks and blurbs that I've ever seen. Keep the nicks and blurbs here to not break this. I've also not touched the deprecated GTK DOM API, since all of these files will be deleted in the distant future, and none of them are marked for translation, so they're not actively hurting anything.

Other known uses of nicks and blurbs:

 * GStreamer supposedly uses these for its documentation. (We don't; gi-docgen does not look at them.)
 * Glade uses these, but Glade is deprecated in favor of Cambalache, which does not.
Comment 1 Michael Catanzaro 2023-01-16 15:00:20 PST
Pull request: https://github.com/WebKit/WebKit/pull/8704
Comment 2 EWS 2023-01-17 00:47:34 PST
Committed 258973@main (645b9044d236): <https://commits.webkit.org/258973@main>

Reviewed commits have been landed. Closing PR #8704 and removing active labels.