Gnome2(3)

📦
version 1.048 · 2 versions
, in fedora 43

💖 Gnome2 💖

okay bestie, so this is the Gnome2 page from the User Contributed Perl Documentation — and before you even scroll, know that she is DEPRECATED, capital letters, no cap. She's a Perl interface to the 2.x series of the GNOME libraries. Iconic? Yes. Alive? ...we'll get there. 🫶

✨ NAME ✨

Gnome2 — (DEPRECATED) Perl interface to the 2.x series of the GNOME libraries

🌸 SYNOPSIS 🌸

use Gnome2;
Gnome2::Program->init ($appname, $appversion);
my $app = Gnome2::App->new ($appname);
$app->show;
Gtk2->main;

🦋 ABSTRACT 🦋

(DEPRECATED) Perl bindings to the 2.x series of the GNOME libraries. This module lets you vibe with the libgnome and libgnomeui libraries so you can build GNOME applications. 💅

💀 DESCRIPTION 💀

NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE

okay so, deep breath. 😭 This module has been deprecated by the Gtk-Perl project. What that means, fr fr:

  • She will no longer be updated with security patches, bug fixes, or when changes are made in the Perl ABI.
  • The Git repo for this module has been archived (made read-only), and it will no longer be possible to submit new commits to it.
  • You are more than welcome to ask about this module on the Gtk-Perl mailing list, but their priorities going forward will be maintaining 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 this module, if you wish — but (and this is important, bestie) you will 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. 👑

NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE NOTICE

Since this module tries to stick very closely to the C API, the documentation found at

http://developer.gnome.org/libgnome

and

http://developer.gnome.org/libgnomeui

is the canonical reference. 📚

In addition to that, there's also the automatically generated API documentation: Gnome2::index(3pm).

The mapping described in Gtk2::api(3pm) also applies to this module.

To discuss this module, ask questions and flame/praise the authors, join gtk-perl-list@gnome.org at lists.gnome.org. 🫶

🙈 MISSING METHODS 🙈

these ones said "not me" and dipped, so here's what to use instead:

  • gnome_app_fill_menu_with_data
  • gnome_app_fill_menu_custom

Use gnome_app_fill_menu instead.

  • gnome_app_fill_toolbar_with_data
  • gnome_app_fill_toolbar_custom

Use gnome_app_fill_toolbar instead.

  • gnome_app_create_menus_interp
  • gnome_app_create_menus_with_data
  • gnome_app_create_menus_custom

Use gnome_app_create_menus instead.

  • gnome_app_create_toolbar_interp
  • gnome_app_create_toolbar_with_data
  • gnome_app_create_toolbar_custom

Use gnome_app_create_toolbar instead.

  • gnome_app_insert_menus_custom
  • gnome_app_insert_menus_with_data
  • gnome_app_insert_menus_interp

Use gnome_app_insert_menus instead.

🎀 RENAMED METHODS 🎀

she got a glow-up and a new name, periodt:

  • gnome_program_get — Gnome2::Program->get has been renamed to ->get_program to avoid a clash with GObject->get.
  • gnome_popup_menu_attach — Gtk2::Menu->attach has been renamed to ->attach_to to avoid a clash with gtk_menu_attach.
  • gnome_popup_menu_append — Gtk2::Menu->append has been renamed to ->append_from to avoid a clash with gtk_menu_shell_append.

🌈 DIFFERENT CALL SIGNATURES OR SEMANTICS 🌈

  • gnome_client_set_restart_command
  • gnome_client_set_discard_command
  • gnome_client_set_resign_command
  • gnome_client_set_shutdown_command
  • gnome_client_set_clone_command

Instead of argc and argv you simply pass in a list. so much chiller, honestly.

  • gnome_program_init — Gnome2::Program->init automagically fills argc and argv, so just omit these parameters. ✨

👑 SEE ALSO 👑

perl(1), Gnome2::index(3pm), Glib(3pm), Gtk2(3pm), Gtk2::api(3pm).

💜 AUTHOR 💜

muppet <scott at asofyet dot org> did the initial stuff.

Torsten Schoenfeld <kaffeetisch at gmx dot de> took over between 0.34 and 0.36, and implemented lots of tests and missing functionality, and corrected several of muppet's mistakes. we love a glow-up arc. 🫶

Copyright (C) 2003-2006, 2013 by the gtk2-perl team (see the file AUTHORS)

This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser 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 LICENSE file in the top level of this distribution for the complete license terms.

and that's the whole page, bestie 🦋 this was perl v5.42.0, dated 2025-07-25, and yes — she's still filed under Gnome2(3) in the User Contributed Perl Documentation. archived, deprecated, but never forgotten. 💅✨

📦 where this page comes from