2003-01-17 Michael Natterer <mitch@gimp.org> One more Plug-In cleanup, it's still a mess... * app/plug-in/plug-in-def.[ch]: renamed "gboolean query" field to "needs_query". Added setters for all values. Added g_return_if_fail() stuff to all functions. * app/plug-in/plug-in-proc.[ch]: added plug_in_proc_def_new(). Removed the "gboolean data_only" parameter from plug_in_proc_def_destroy() and renamed it to plug_in_proc_def_free(). Added plug_in_proc_def_get_progname() which handles GIMP_TEMPORARY procedures correctly. * app/plug-in/plug-in-rc.c: use the new stuff above. * app/plug-in/plug-in.[ch]: renamed field "user_data" to "plug_in_def" and added a comment that it is valid only during query() and init(). Use the new APIs above. Pass meaningful locale_domains and help_paths when adding temporary procedures (fixes Scrip-Fu menu translation the right way (TM)). Cleanup. * app/plug-in/plug-ins.[ch]: renamed plug_ins_def_add() to plug_ins_def_add_from_rc(). Renamed plug_ins_proc_def_[add|remove]() to plug_ins_temp_proc_def_[add|remove](). Added "Gimp" parameters to plug_ins_help_path() and plug_ins_locale_domain(). Removed unused pre-1.2 cruft "gimprc_prof_defs" and plug_ins_image_types(). Reverse gimp->load_procs and gimp->save_procs after all procedures are registered. Removed Script-Fu translation hack. Reordered stuff. * app/gui/plug-in-menus.[ch]: changed accordingly. Named all public functions plug_in_menus_*(). Fixed Script-Fu menu translation by using plug_in_proc_def_get_progname(). Cleanup. * app/gui/file-open-menu.c * app/gui/file-save-menu.c: don't g_slist_reverse() gimp->load_procs and gimp->save_procs here. * app/gui/toolbox-menu.c * app/gui/image-menu.c * tools/pdbgen/pdb/help.pdb * tools/pdbgen/pdb/plug_in.pdb: changed accordingly. * app/pdb/help_cmds.c * app/pdb/plug_in_cmds.c: regenerated. Unrelated: * app/gui/image-menu.c * app/widgets/gimpitemfactory.c: s/"tearoff1"/"tearoff"/g. I don't get why the "1" was there. Minor cleanup.
60 lines
2 KiB
Text
60 lines
2 KiB
Text
# The GIMP -- an image manipulation program
|
|
# Copyright (C) 1995 Spencer Kimball and Peter Mattis
|
|
|
|
# This program is free software; you can redistribute it and/or modify
|
|
# it under the terms of the GNU General Public License as published by
|
|
# the Free Software Foundation; either version 2 of the License, or
|
|
# (at your option) any later version.
|
|
|
|
# This program 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 General Public License for more details.
|
|
|
|
# You should have received a copy of the GNU General Public License
|
|
# along with this program; if not, write to the Free Software
|
|
# Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
|
|
|
|
# "Perlized" from C source by Sven Neumann <sven@gimp.org>
|
|
|
|
sub pdb_misc {
|
|
$author = $copyright = 'Michael Natterer <mitch@gimp.org>';
|
|
$date = '2000';
|
|
}
|
|
|
|
sub help {
|
|
$blurb = "Load a help page.";
|
|
|
|
$help = <<HELP;
|
|
This procedure loads the specified help page into the helpbrowser or what ever
|
|
is configured as help viewer. The location of the help page is given relative
|
|
to the help rootdir. The help rootdir is determined from the prog_name: if
|
|
prog_name is NULL, we use the help rootdir of the main GIMP installation,
|
|
if the plug-in's full executable name is passed as prog_name, the GIMP
|
|
will use this information to look up the help path the plug-in has registered
|
|
before with gimp-plugin-help-register.
|
|
HELP
|
|
|
|
&pdb_misc;
|
|
|
|
@inargs = (
|
|
{ name => 'prog_name', type => 'string',
|
|
desc => 'The plug-in\'s executable name or an empty string' },
|
|
{ name => 'help_page', type => 'string',
|
|
desc => 'The location of the help page' }
|
|
);
|
|
|
|
%invoke = (
|
|
success => 'TRUE',
|
|
code => 'gimp_help (gimp, plug_ins_help_path (gimp, prog_name), help_page);'
|
|
);
|
|
}
|
|
|
|
@headers = qw(<sys/types.h> "plug-in/plug-ins.h" "widgets/gimphelp.h");
|
|
|
|
@procs = qw(help);
|
|
%exports = (app => [@procs], lib => [@procs]);
|
|
|
|
$desc = 'Help procedures';
|
|
|
|
1;
|