[gimp] devel-docs: update the libgimp docs

[Michael Natterer <mitch src gnome org>]

commit 6cb027f4029b34d5ceffcf2964a797e699903f66
Author: Michael Natterer <mitch gimp org>
Date:   Sat Aug 10 11:08:33 2019 +0200

    devel-docs: update the libgimp docs

 devel-docs/libgimp/Makefile.am           |   5 ++
 devel-docs/libgimp/libgimp3-docs.sgml    |   7 +-
 devel-docs/libgimp/libgimp3-sections.txt | 112 +++++++++++++++++++------------
 devel-docs/libgimp/libgimp3.types        |   1 +
 4 files changed, 81 insertions(+), 44 deletions(-)
---
diff --git a/devel-docs/libgimp/Makefile.am b/devel-docs/libgimp/Makefile.am
index 9546e61de0..44ae005d26 100644
--- a/devel-docs/libgimp/Makefile.am
+++ b/devel-docs/libgimp/Makefile.am
@@ -32,6 +32,11 @@ CFILE_GLOB = $(DOC_SOURCE_DIR)/*.c
 
 # Header files to ignore when scanning
 IGNORE_HFILES = \
+       gimp-debug.h            \
+       gimp-private.h          \
+       gimp-shm.h              \
+       gimppdb-private.h       \
+       gimppdbprocedure.h      \
        gimpgpcompat.h          \
        gimpgpparams.h          \
        gimpplugin-private.h    \
diff --git a/devel-docs/libgimp/libgimp3-docs.sgml b/devel-docs/libgimp/libgimp3-docs.sgml
index c398e8a691..5e15984503 100644
--- a/devel-docs/libgimp/libgimp3-docs.sgml
+++ b/devel-docs/libgimp/libgimp3-docs.sgml
@@ -32,11 +32,12 @@
       <xi:include href="xml/gimphelp.xml" />
       <xi:include href="xml/gimpmessage.xml" />
       <xi:include href="xml/gimpplugin.xml" />
+      <xi:include href="xml/gimppdb.xml" />
       <xi:include href="xml/gimpprocedure.xml" />
       <xi:include href="xml/gimpparamspecs.xml" />
-      <xi:include href="xml/gimpproceduraldb.xml" />
       <xi:include href="xml/gimpprogress.xml" />
       <xi:include href="xml/gimpdebug.xml" />
+      <xi:include href="xml/gimplegacy.xml" />
     </chapter>
 
     <chapter id="libgimp-image">
@@ -161,6 +162,10 @@
     <title>Index of new symbols in GIMP 2.10.14</title>
     <xi:include href="xml/api-index-2.10.14.xml"><xi:fallback /></xi:include>
   </index>
+  <index role="2.3.0" id="api-index-3-0">
+    <title>Index of new symbols in GIMP 3.0</title>
+    <xi:include href="xml/api-index-3.0.xml"><xi:fallback /></xi:include>
+  </index>
   <index role="deprecated" id="api-index-deprecated">
     <title>Index of deprecated symbols</title>
     <xi:include href="xml/api-index-deprecated.xml"><xi:fallback /></xi:include>
diff --git a/devel-docs/libgimp/libgimp3-sections.txt b/devel-docs/libgimp/libgimp3-sections.txt
index efbd2e9c5b..5f1f977636 100644
--- a/devel-docs/libgimp/libgimp3-sections.txt
+++ b/devel-docs/libgimp/libgimp3-sections.txt
@@ -1,21 +1,18 @@
 <SECTION>
 <FILE>gimp</FILE>
+<TITLE>Gimp</TITLE>
 gimp_get_data
 gimp_get_data_size
 gimp_set_data
 GIMP_MAIN
 gimp_main
+gimp_get_plug_in
+gimp_get_pdb
 gimp_quit
-gimp_extension_ack
-gimp_extension_enable
-gimp_extension_process
-gimp_run_procedure_with_array
 gimp_get_pdb_error
 gimp_get_pdb_status
 gimp_tile_width
 gimp_tile_height
-gimp_shm_ID
-gimp_shm_addr
 gimp_show_help_button
 gimp_export_color_profile
 gimp_export_exif
@@ -48,31 +45,34 @@ GimpRunProc
 GimpPlugInInfo
 GimpParamDef
 GimpParamData
+GimpParam
 MAIN
-gimp_plug_in_info_set_callbacks
-gimp_param_from_int32
-gimp_param_get_int32
-gimp_param_from_status
-gimp_param_get_status
-gimp_param_from_string
-gimp_param_get_string
 gimp_main_legacy
 gimp_install_procedure
 gimp_install_temp_proc
 gimp_uninstall_temp_proc
+gimp_extension_ack
+gimp_extension_enable
+gimp_extension_process
 gimp_run_procedure
 gimp_run_procedure2
+gimp_run_procedure_array
 gimp_destroy_params
 gimp_destroy_paramdefs
 gimp_plugin_domain_register
 gimp_plugin_help_register
 gimp_plugin_menu_branch_register
+gimp_plugin_set_pdb_error_handler
+gimp_plugin_get_pdb_error_handler
 gimp_plugin_menu_register
 gimp_plugin_icon_register
-<SUBSECTION Standard>
-GIMP_TYPE_PARAM
-GimpParam
-gimp_param_get_type
+gimp_pdb_temp_name
+gimp_pdb_dump
+gimp_pdb_query
+gimp_pdb_proc_exists
+gimp_pdb_proc_info
+gimp_pdb_proc_arg
+gimp_pdb_proc_val
 </SECTION>
 
 <SECTION>
@@ -850,8 +850,10 @@ gimp_plug_in_add_temp_procedure
 gimp_plug_in_remove_temp_procedure
 gimp_plug_in_get_temp_procedures
 gimp_plug_in_get_temp_procedure
-gimp_plugin_set_pdb_error_handler
-gimp_plugin_get_pdb_error_handler
+gimp_plug_in_extension_enable
+gimp_plug_in_extension_process
+gimp_plug_in_set_pdb_error_handler
+gimp_plug_in_get_pdb_error_handler
 <SUBSECTION Standard>
 GIMP_IS_PLUG_IN
 GIMP_IS_PLUG_IN_CLASS
@@ -865,27 +867,64 @@ GimpPlugInPrivate
 gimp_plug_in_get_type
 </SECTION>
 
+<SECTION>
+<FILE>gimppdb</FILE>
+<TITLE>GimpPDB</TITLE>
+gimp_pdb_procedure_exists
+gimp_pdb_lookup_procedure
+gimp_pdb_run_procedure
+gimp_pdb_run_procedure_valist
+gimp_pdb_run_procedure_array
+gimp_pdb_temp_procedure_name
+gimp_pdb_dump_to_file
+gimp_pdb_query_procedures
+gimp_pdb_proc_argument
+gimp_pdb_proc_return_value
+gimp_pdb_get_data
+gimp_pdb_get_data_size
+gimp_pdb_set_data
+<SUBSECTION Standard>
+GIMP_IS_PDB
+GIMP_IS_PDB_CLASS
+GIMP_PDB
+GIMP_PDB_CLASS
+GIMP_PDB_GET_CLASS
+GIMP_TYPE_PDB
+GimpPDB
+GimpPDBClass
+GimpPDBPrivate
+gimp_pdb_get_type
+</SECTION>
+
 <SECTION>
 <FILE>gimpprocedure</FILE>
 <TITLE>GimpProcedure</TITLE>
 GimpRunFunc
 gimp_procedure_new
 gimp_procedure_get_plug_in
-gimp_procedure_get_proc_type
-gimp_procedure_set_strings
 gimp_procedure_get_name
+gimp_procedure_get_proc_type
+gimp_procedure_set_image_types
+gimp_procedure_get_image_types
+gimp_procedure_set_menu_label
 gimp_procedure_get_menu_label
+gimp_procedure_add_menu_path
+gimp_procedure_get_menu_paths
+gimp_procedure_set_documentation
 gimp_procedure_get_blurb
 gimp_procedure_get_help
 gimp_procedure_get_help_id
-gimp_procedure_get_author
+gimp_procedure_set_attribution
+gimp_procedure_get_authors
 gimp_procedure_get_copyright
 gimp_procedure_get_date
-gimp_procedure_get_image_types
-gimp_procedure_set_icon
-gimp_procedure_get_icon
-gimp_procedure_add_menu_path
-gimp_procedure_get_menu_paths
+gimp_procedure_set_icon_name
+gimp_procedure_set_icon_file
+gimp_procedure_set_icon_pixbuf
+gimp_procedure_get_icon_type
+gimp_procedure_get_icon_name
+gimp_procedure_get_icon_file
+gimp_procedure_get_icon_pixbuf
 gimp_procedure_add_argument
 gimp_procedure_add_return_value
 gimp_procedure_get_arguments
@@ -893,6 +932,7 @@ gimp_procedure_get_return_values
 gimp_procedure_new_arguments
 gimp_procedure_new_return_values
 gimp_procedure_run
+gimp_procedure_extension_ready
 <SUBSECTION Standard>
 GIMP_IS_PROCEDURE
 GIMP_IS_PROCEDURE_CLASS
@@ -1010,20 +1050,6 @@ gimp_param_selection_id_get_type
 gimp_param_vectors_id_get_type
 </SECTION>
 
-<SECTION>
-<FILE>gimpproceduraldb</FILE>
-gimp_procedural_db_temp_name
-gimp_procedural_db_get_data
-gimp_procedural_db_set_data
-gimp_procedural_db_dump
-gimp_procedural_db_query
-gimp_procedural_db_proc_exists
-gimp_procedural_db_proc_info
-gimp_procedural_db_proc_arg
-gimp_procedural_db_proc_val
-gimp_procedural_db_get_data_size
-</SECTION>
-
 <SECTION>
 <FILE>gimpprogress</FILE>
 GimpProgressVtable
@@ -1218,14 +1244,12 @@ GIMP_ZOOM_PREVIEW_GET_CLASS
 <TITLE>GimpItemComboBox</TITLE>
 GimpItemConstraintFunc
 GimpDrawableComboBox
-GimpDrawableConstraintFunc
 gimp_drawable_combo_box_new
 GimpChannelComboBox
 gimp_channel_combo_box_new
 GimpLayerComboBox
 gimp_layer_combo_box_new
 GimpVectorsComboBox
-GimpVectorsConstraintFunc
 gimp_vectors_combo_box_new
 <SUBSECTION Standard>
 GIMP_TYPE_LAYER_COMBO_BOX
@@ -1364,6 +1388,7 @@ gimp_palette_select_button_get_palette
 gimp_palette_select_button_set_palette
 <SUBSECTION Standard>
 GimpPaletteSelectButtonClass
+GimpPaletteSelectButtonPrivate
 GIMP_PALETTE_SELECT_BUTTON
 GIMP_IS_PALETTE_SELECT_BUTTON
 GIMP_TYPE_PALETTE_SELECT_BUTTON
@@ -1382,6 +1407,7 @@ gimp_pattern_select_button_get_pattern
 gimp_pattern_select_button_set_pattern
 <SUBSECTION Standard>
 GimpPatternSelectButtonClass
+GimpPatternSelectButtonPrivate
 GIMP_PATTERN_SELECT_BUTTON
 GIMP_IS_PATTERN_SELECT_BUTTON
 GIMP_TYPE_PATTERN_SELECT_BUTTON
diff --git a/devel-docs/libgimp/libgimp3.types b/devel-docs/libgimp/libgimp3.types
index 763981d4b0..446358f26e 100644
--- a/devel-docs/libgimp/libgimp3.types
+++ b/devel-docs/libgimp/libgimp3.types
@@ -14,6 +14,7 @@ gimp_image_combo_box_get_type
 gimp_layer_combo_box_get_type
 gimp_palette_select_button_get_type
 gimp_pattern_select_button_get_type
+gimp_pdb_get_type
 gimp_plug_in_get_type
 gimp_proc_browser_dialog_get_type
 gimp_procedure_get_type