renamed menu_path parameter to menu_label and added a pointer to

2004-12-28  Sven Neumann  <sven@gimp.org>

	* libgimp/gimp.[ch] (gimp_install_procedure, gimp_install_temp_proc):
	renamed menu_path parameter to menu_label and added a pointer to
	gimp_plugin_menu_register()

	* app/widgets/gimpsizebox.c (gimp_size_box_constructor): removed
	unused variables.

ChangeLog

@@ -1,3 +1,12 @@
+2004-12-28  Sven Neumann  <sven@gimp.org>
+
+	* libgimp/gimp.[ch] (gimp_install_procedure, gimp_install_temp_proc):
+	renamed menu_path parameter to menu_label and added a pointer to
+	gimp_plugin_menu_register()
+
+	* app/widgets/gimpsizebox.c (gimp_size_box_constructor): removed
+	unused variables.
+
 2004-12-28  Sven Neumann  <sven@gimp.org>
 
 	* app/paint/gimpbrushcore.c (gimp_brush_core_subsample_mask):

NEWS

@@ -9,7 +9,7 @@ to GIMP version 2.4.
 Bugs fixed in GIMP 2.2.1
 ========================
 
-- added python logo to EXTRA_DIST so it shows up in the tarball (bug #)
+- added python logo to EXTRA_DIST so it shows up in the tarball (bug #161716)
 - fixed mempory corruption in FracalExplorer plug-in (bug #161729)
 - fixed crash in gradient editor (bug #161411)
 - fixed crash in unsharp mask plug-in preview code (bug #157910)
@@ -18,6 +18,10 @@ Bugs fixed in GIMP 2.2.1
 - removed broken asc2img Script-Fu
 - fixed channel drag-n-drop (bug #161877)
 - fixed misbehaviour of entries in Scale and Resize dialogs (bug #161756)
-- speed up preview in Motion Blur plug-in
+- speed up preview in several plug-ins
 - fixed bug in Despeckle plug-in that caused it to run very slowly
   (bug #162129)
+- fixed a crash in the error dialog (bug #162147)
+- fixed parameter value range in Weave script (bug #162182)
+- fixed crash in brush preview (bug #162232)
+- minor improvements to the API docs

app/widgets/gimpsizebox.c

@@ -202,12 +202,8 @@ gimp_size_box_constructor (GType                  type,
   GObject            *object;
   GimpSizeBox        *box;
   GtkWidget          *entry;
-  GtkWidget          *table;
   GtkWidget          *hbox;
-  GtkWidget          *chain;
   GtkWidget          *label;
-  GtkObject          *adjustment;
-  GList              *focus_chain = NULL;
   GimpSizeBoxPrivate *priv;
 
   object = G_OBJECT_CLASS (parent_class)->constructor (type, n_params, params);

devel-docs/libgimp/tmpl/gimp.sgml

@@ -184,13 +184,15 @@ all other GIMP Library headers.
 @author: 
 @copyright: 
 @date: 
-@menu_path: 
+@menu_label: 
 @image_types: 
 @type: 
 @n_params: 
 @n_return_vals: 
 @params: 
 @return_vals: 
+<!-- # Unused Parameters # -->
+@menu_path: 
 
 
 <!-- ##### FUNCTION gimp_install_temp_proc ##### -->
@@ -204,7 +206,7 @@ all other GIMP Library headers.
 @author: 
 @copyright: 
 @date: 
-@menu_path: 
+@menu_label: 
 @image_types: 
 @type: 
 @n_params: 
@@ -212,6 +214,8 @@ all other GIMP Library headers.
 @params: 
 @return_vals: 
 @run_proc: 
+<!-- # Unused Parameters # -->
+@menu_path: 
 
 
 <!-- ##### FUNCTION gimp_uninstall_temp_proc ##### -->

libgimp/gimp.c

@@ -484,8 +484,8 @@ gimp_quit (void)
  * @author:        the procedure's author(s).
  * @copyright:     the procedure's copyright.
  * @date:          the date the procedure was added.
- * @menu_path:     the procedure's menu path, or #NULL if the procedure has
+ * @menu_label:    the label to use for the procedure's menu entry,
- *                 no menu entry.
+ *                 or #NULL if the procedure has no menu entry.
  * @image_types:   the drawable types the procedure can handle.
  * @type:          the type of the procedure.
  * @n_params:      the number of parameters the procedure takes.
@@ -506,11 +506,13 @@ gimp_quit (void)
  * optional but then you shouldn't write procedures without proper
  * documentation, should you.
  *
- * @menu_path can be #NULL, or a string in the form
+ * @menu_label defines the label that should be used for the
- * "<Domain>/Path/To/My/Menu"
+ * procedure's menu entry (use #NULL if the procedure shouldn't have a
- * (e.g. "<Image>/Filters/Render/Useless") if you want your
+ * menu entry).  The position where to register in the menu hierarchy
- * procedure to be available via a menu.  Allowed prefixes are
+ * is choosen using gimp_plugin_menu_register().  This function also
- * <Toolbox>, <Image>, <Load> and <Save>
+ * still accepts the old (pre-2.2) way of registering a menu entry and
+ * takes a string in the form "<Domain>/Path/To/My/Menu"
+ * (e.g. "<Image>/Filters/Render/Useless").
  *
  * @type must be one of #GIMP_PLUGIN or #GIMP_EXTENSION. Note that
  * temporary procedures must be installed using
@@ -538,7 +540,7 @@ gimp_install_procedure (const gchar        *name,
 			const gchar        *author,
 			const gchar        *copyright,
 			const gchar        *date,
-			const gchar        *menu_path,
+			const gchar        *menu_label,
 			const gchar        *image_types,
 			GimpPDBProcType     type,
 			gint                n_params,
@@ -561,7 +563,7 @@ gimp_install_procedure (const gchar        *name,
   proc_install.author       = (gchar *) author;
   proc_install.copyright    = (gchar *) copyright;
   proc_install.date         = (gchar *) date;
-  proc_install.menu_path    = (gchar *) menu_path;
+  proc_install.menu_path    = (gchar *) menu_label;
   proc_install.image_types  = (gchar *) image_types;
   proc_install.type         = type;
   proc_install.nparams      = n_params;
@@ -582,7 +584,7 @@ gimp_install_procedure (const gchar        *name,
  * @author:        the procedure's author(s).
  * @copyright:     the procedure's copyright.
  * @date:          the date the procedure was added.
- * @menu_path:     the procedure's menu path, or #NULL if the procedure has
+ * @menu_label:    the procedure's menu label, or #NULL if the procedure has
  *                 no menu entry.
  * @image_types:   the drawable types the procedure can handle.
  * @type:          the type of the procedure.
@@ -619,7 +621,7 @@ gimp_install_temp_proc (const gchar        *name,
 			const gchar        *author,
 			const gchar        *copyright,
 			const gchar        *date,
-			const gchar        *menu_path,
+			const gchar        *menu_label,
 			const gchar        *image_types,
 			GimpPDBProcType     type,
 			gint                n_params,
@@ -639,7 +641,7 @@ gimp_install_temp_proc (const gchar        *name,
   gimp_install_procedure (name,
 			  blurb, help,
 			  author, copyright, date,
-			  menu_path,
+			  menu_label,
 			  image_types,
 			  type,
 			  n_params, n_return_vals,

libgimp/gimp.h

@@ -232,7 +232,7 @@ void          gimp_install_procedure   (const gchar        *name,
                                         const gchar        *author,
                                         const gchar        *copyright,
                                         const gchar        *date,
-                                        const gchar        *menu_path,
+                                        const gchar        *menu_label,
                                         const gchar        *image_types,
                                         GimpPDBProcType     type,
                                         gint                n_params,
@@ -248,7 +248,7 @@ void          gimp_install_temp_proc   (const gchar        *name,
                                         const gchar        *author,
                                         const gchar        *copyright,
                                         const gchar        *date,
-                                        const gchar        *menu_path,
+                                        const gchar        *menu_label,
                                         const gchar        *image_types,
                                         GimpPDBProcType     type,
                                         gint                n_params,