[gimp] pdb, libgimp: fix various doc issues found by gtk-doc

[Michael Natterer <mitch src gnome org>]

commit 60b6f34737cf3bbc927d9ed9bea98df26b616efb
Author: Michael Natterer <mitch gimp org>
Date:   Sat Aug 10 11:08:06 2019 +0200

    pdb, libgimp: fix various doc issues found by gtk-doc

 libgimp/gimp_pdb.c      | 4 ++--
 libgimp/gimplegacy.c    | 2 +-
 libgimp/gimpplugin.c    | 6 +++---
 libgimp/gimpprocedure.c | 9 ++++++---
 pdb/groups/gimp.pdb     | 9 +++++----
 5 files changed, 17 insertions(+), 13 deletions(-)
---
diff --git a/libgimp/gimp_pdb.c b/libgimp/gimp_pdb.c
index 945ff47c5e..9e6d17e0a5 100644
--- a/libgimp/gimp_pdb.c
+++ b/libgimp/gimp_pdb.c
@@ -26,8 +26,8 @@
 
 
 /**
- * SECTION: Gimp
- * @title: Gimp
+ * SECTION: gimp
+ * @title: gimp
  * @short_description: Main functions needed for building a GIMP plug-in.
  *
  * Main functions needed for building a GIMP plug-in.
diff --git a/libgimp/gimplegacy.c b/libgimp/gimplegacy.c
index 7bace34b02..c88d35b2a0 100644
--- a/libgimp/gimplegacy.c
+++ b/libgimp/gimplegacy.c
@@ -1335,7 +1335,7 @@ gimp_pdb_proc_exists (const gchar *procedure_name)
 
 /**
  * gimp_pdb_proc_info:
- * @procedure: The procedure name.
+ * @procedure_name: The procedure name.
  * @blurb: A short blurb.
  * @help: Detailed procedure help.
  * @author: Author(s) of the procedure.
diff --git a/libgimp/gimpplugin.c b/libgimp/gimpplugin.c
index c845fa16fb..2f7030b6e6 100644
--- a/libgimp/gimpplugin.c
+++ b/libgimp/gimpplugin.c
@@ -530,7 +530,7 @@ gimp_plug_in_extension_enable (GimpPlugIn *plug_in)
  * Processes one message sent by GIMP and returns.
  *
  * Call this function in an endless loop after calling
- * gimp_plug_in_extension_ready() to process requests for running
+ * gimp_procedure_extension_ready() to process requests for running
  * temporary procedures.
  *
  * See gimp_plug_in_extension_enable() for an asynchronous way of
@@ -606,7 +606,7 @@ gimp_plug_in_extension_process (GimpPlugIn *plug_in,
 }
 
 /**
- * gimp_plugin_set_pdb_error_handler:
+ * gimp_plug_in_set_pdb_error_handler:
  * @plug_in: A #GimpPlugIn
  * @handler: Who is responsible for handling procedure call errors.
  *
@@ -633,7 +633,7 @@ gimp_plug_in_set_pdb_error_handler (GimpPlugIn          *plug_in,
 }
 
 /**
- * gimp_plugin_get_pdb_error_handler:
+ * gimp_plug_in_get_pdb_error_handler:
  * @plug_in: A #GimpPlugIn
  *
  * Retrieves the active error handler for procedure calls.
diff --git a/libgimp/gimpprocedure.c b/libgimp/gimpprocedure.c
index 68a7055b04..dd062d8ce9 100644
--- a/libgimp/gimpprocedure.c
+++ b/libgimp/gimpprocedure.c
@@ -305,7 +305,7 @@ gimp_procedure_real_run (GimpProcedure        *procedure,
  * has done its initialization, installed its temporary procedures and
  * is ready to run.
  *
- * <emphasis>Not calling gimp_procedure_extension_reads() from a
+ * <emphasis>Not calling gimp_procedure_extension_ready() from a
  * %GIMP_EXTENSION procedure will cause the GIMP core to lock
  * up.</emphasis>
  *
@@ -404,7 +404,8 @@ gimp_procedure_get_proc_type (GimpProcedure *procedure)
 
 /**
  * gimp_procedure_set_image_types:
- * @image_types the image types this procedure can operate on.
+ * @procedure:   A #GimpProcedure.
+ * @image_types: The image types this procedure can operate on.
  *
  * This is a comma separated list of image types, or actually drawable
  * types, that this procedure can deal with. Wildcards are possible
@@ -428,8 +429,9 @@ gimp_procedure_set_image_types (GimpProcedure *procedure,
 
 /**
  * gimp_procedure_get_image_types:
+ * @procedure:  A #GimpProcedure.
  *
- * This procedure retrieves the list of image types the procedure can
+ * This function retrieves the list of image types the procedure can
  * operate on. See gimp_procedure_set_image_types().
  *
  * Returns: The image types.
@@ -1218,6 +1220,7 @@ gimp_procedure_run (GimpProcedure        *procedure,
 
 /**
  * gimp_procedure_extension_ready:
+ * @procedure: A #GimpProcedure
  *
  * Notify the main GIMP application that the extension has been
  * properly initialized and is ready to run.
diff --git a/pdb/groups/gimp.pdb b/pdb/groups/gimp.pdb
index 3b7c4a7c12..ac065d70bf 100644
--- a/pdb/groups/gimp.pdb
+++ b/pdb/groups/gimp.pdb
@@ -189,6 +189,7 @@ sub get_parasite_list {
 CODE
     );
 }
+
 sub temp_name {
     $blurb = 'Generates a unique filename.';
 
@@ -229,16 +230,16 @@ CODE
 @procs = qw(version
             getpid
             quit
-            attach_parasite detach_parasite
+            attach_parasite
+            detach_parasite
             get_parasite
             get_parasite_list
             temp_name);
 
 %exports = (app => [@procs], lib => [@procs[0..1,3..7]]);
 
-$desc = 'Miscellaneous';
-$doc_title = 'Gimp';
-
+$desc = 'Gimp';
+$doc_title = 'gimp';
 $doc_short_desc = 'Main functions needed for building a GIMP plug-in.';
 $doc_long_desc = <<'DESC';
 Main functions needed for building a GIMP plug-in.