Gtk2::Spell(3)

✨ Gtk2::Spell — the tea ☕

okay bestie, so this is the manual page for Gtk2::Spell, and before you get attached — it's DEPRECATED 💀. Like, the whole thing. I'm gonna tell you everything anyway because you deserve to know, but keep that in your back pocket.

---

🌸 SYNOPSIS 🌸

here's the vibe, copy-paste ready:

use Gtk2;
use Gtk2::Spell;

$txtview = Gtk2::TextView->new;
$spell = Gtk2::Spell->new_attach($txtview);
$spell2 = Gtk2::Spell->get_from_text_view($txtview);
# $spell2 will be the same object as $spell
$spell->set_language(SOME_LANG);
$spell->recheck_all;
$spell->detach;

and yes, $spell2 really is the same object as $spell, not a copy. slay.

---

🦋 ABSTRACT 🦋

DEPRECATED Perl bindings to GtkSpell, used in concert with Gtk2::TextView. that's the whole thing, no notes.

---

💅 DESCRIPTION 💅

NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE

okay so this is the part where I have to be the bearer of bad news 😭

This module has been deprecated by the Gtk-Perl project. Translation? It's not getting updated anymore — no security patches, no bug fixes, and nothing when the Perl ABI changes. The Git repo for this module has been archived (made read-only), so you literally cannot submit new commits to it. Not me being dramatic, that's just facts.

You're more than welcome to ask about this module on the Gtk-Perl mailing list! 🫶 But heads up: their priorities going forward are maintaining the Gtk-Perl modules that are supported and maintained upstream, and this module is neither. 💀

Since this module is licensed under the LGPL v2.1, you may also fork it if you want to — but you'll need to use a different name for it on CPAN, and the Gtk-Perl team requests that you use your own resources (mailing list, Git repos, bug trackers, etc.) to maintain your fork going forward. so like, your fork, your problem bestie 💖

• Perl URL: https://gitlab.gnome.org/GNOME/perl-gtk2-spell
• Upstream URL: http://gtkspell.sourceforge.net/
• Last upstream version: 2.0.16
• Last upstream release date: 2009-10-22
• Migration path for this module: G:O:I
• Migration module URL: https://metacpan.org/pod/Glib::Object::Introspection

NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE

okay now the actual function of this thing, because it does do something cute:

Perl bindings to GtkSpell, used in concert with Gtk2::TextView. It provides mis-spelled word highlighting in red 🔥 and offers a right click pop-up menu with suggested corrections. genuinely iconic behaviour, honestly.

---

🎀 FUNCTIONS 🎀

• $spell = Gtk2::Spell->new(GTK2_TEXT_VIEW)
• $spell = Gtk2::Spell->new_attach(GTK2_TEXT_VIEW) — creates and returns a brand new Gtk2::Spell object attached to GTK2_TEXT_VIEW. yes, both of these exist, and yes, they look like the same thing. I just report the facts 💅
• $spell->set_language(LANG_STR) — sets the language that the underlying spell-checker is gonna use. According to the GtkSpell API reference, this "appears to be a locale specifier." that's the official word, quotes and all, I'm not gonna pretend I know more than the docs 🫠
• $spell->recheck_all — rechecks the spelling of the entire text view buffer. the whole thing. all of it. no skimming ✨
• Gtk2::Spell->get_from_text_view(GTK2_TEXT_VIEW) — returns the Gtk2::Spell object attached to the given Gtk2::TextBuffer, or undef if there isn't one attached. (yes, the argument is a text view, and the description says text buffer. that's what it says, bestie, I'm not touching it 😭)
• $spell->detach — detaches the Gtk2::Spell from it's associated text view. bye 👋

---

🌈 SEE ALSO 🌈

perl(1), Glib(1), Gtk2(1).

---

👑 AUTHOR 👑

rwmcfa1 <rwmcfa1@neces.com>

---

💖 COPYRIGHT AND LICENSE 💖

Copyright 2003 by rwmcfa1

Copyright 2003 by the gtk2-perl team.

This library is free software; you can redistribute it and/or modify it under the terms of the GNU Library General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version.

This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Library General Public License for more details.

You should have received a copy of the GNU Library General Public License along with this library; if not, see https://www.gnu.org/licenses/.

---

and that's the whole page, bestie 🧚 this one was shipped with perl v5.42.0 and dated 2025-07-25 — so like, go forth and highlight those typos, or better yet, go find the migration module. mwah 💋