2004-11-08 Michael Natterer <[email protected]>

* libgimp/tmpl/gimpaspectpreview.sgml * libgimp/tmpl/gimpbrush.sgml * libgimp/tmpl/gimpbrushmenu.sgml * libgimp/tmpl/gimpbrushselect.sgml * libgimp/tmpl/gimpcontext.sgml * libgimp/tmpl/gimpdrawable.sgml * libgimp/tmpl/gimpdrawablecombobox.sgml * libgimp/tmpl/gimpdrawablepreview.sgml * libgimp/tmpl/gimpdrawabletransform.sgml * libgimp/tmpl/gimpfontmenu.sgml * libgimp/tmpl/gimpfontselect.sgml * libgimp/tmpl/gimpgradient.sgml * libgimp/tmpl/gimpgradientmenu.sgml * libgimp/tmpl/gimpgradientselect.sgml * libgimp/tmpl/gimpimage.sgml * libgimp/tmpl/gimpimagecombobox.sgml * libgimp/tmpl/gimplayer.sgml * libgimp/tmpl/gimppalette.sgml * libgimp/tmpl/gimppalettemenu.sgml * libgimp/tmpl/gimppalettes.sgml * libgimp/tmpl/gimppaletteselect.sgml * libgimp/tmpl/gimppaths.sgml * libgimp/tmpl/gimppattern.sgml * libgimp/tmpl/gimppatternmenu.sgml * libgimp/tmpl/gimppatternselect.sgml * libgimp/tmpl/gimppixbuf.sgml * libgimp/tmpl/gimppixelfetcher.sgml * libgimp/tmpl/gimpprogress.sgml * libgimp/tmpl/gimpprogressbar.sgml * libgimp/tmpl/gimpregioniterator.sgml * libgimpbase/tmpl/gimpbaseenums.sgml * libgimpbase/tmpl/gimpbasetypes.sgml * libgimpbase/tmpl/gimpchecks.sgml * libgimpbase/tmpl/gimpdatafiles.sgml * libgimpbase/tmpl/gimpmemsize.sgml * libgimpcolor/tmpl/gimpadaptivesupersample.sgml * libgimpcolor/tmpl/gimpcmyk.sgml * libgimpcolor/tmpl/gimphsv.sgml * libgimpcolor/tmpl/gimprgb.sgml * libgimpwidgets/tmpl/gimpcolorbutton.sgml * libgimpwidgets/tmpl/gimpcolorhexentry.sgml * libgimpwidgets/tmpl/gimpcolorselection.sgml * libgimpwidgets/tmpl/gimpframe.sgml * libgimpwidgets/tmpl/gimpintcombobox.sgml * libgimpwidgets/tmpl/gimpintstore.sgml * libgimpwidgets/tmpl/gimppatheditor.sgml * libgimpwidgets/tmpl/gimppreview.sgml * libgimpwidgets/tmpl/gimppreviewarea.sgml * libgimpwidgets/tmpl/gimpscrolledpreview.sgml: applied a heavily fixed and enhanced version of a patch from Cai Qian (bug #156271). Made long_desc = short_desc where we lacked a long_desc but had a short_desc. Removed unused parameters. Misc cleanups. * libgimp/libgimp-docs.sgml: added some <chapter>s. The list of libgimp modules was too long. * libgimpwidgets/libgimpwidgets-docs.sgml * libgimpwidgets/libgimpwidgets-sections.txt * libgimpwidgets/libgimpwidgets.types * libgimpwidgets/tmpl/gimpcontroller.sgml: added GimpController. git-svn-id: http://svn.gnome.org/svn/gimp/trunk@15517 f57ce169-c725-0410-9505-c4955b3f21d2
Murysya · Nov 8, 2004 · ebf5ea8 · ebf5ea8
1 parent c867a64
commit ebf5ea8
Show file tree

Hide file tree

Showing 55 changed files with 375 additions and 183 deletions.
diff --git a/devel-docs/ChangeLog b/devel-docs/ChangeLog
@@ -1,3 +1,66 @@
+2004-11-08  Michael Natterer  <[email protected]>
+
+	* libgimp/tmpl/gimpaspectpreview.sgml
+	* libgimp/tmpl/gimpbrush.sgml
+	* libgimp/tmpl/gimpbrushmenu.sgml
+	* libgimp/tmpl/gimpbrushselect.sgml
+	* libgimp/tmpl/gimpcontext.sgml
+	* libgimp/tmpl/gimpdrawable.sgml
+	* libgimp/tmpl/gimpdrawablecombobox.sgml
+	* libgimp/tmpl/gimpdrawablepreview.sgml
+	* libgimp/tmpl/gimpdrawabletransform.sgml
+	* libgimp/tmpl/gimpfontmenu.sgml
+	* libgimp/tmpl/gimpfontselect.sgml
+	* libgimp/tmpl/gimpgradient.sgml
+	* libgimp/tmpl/gimpgradientmenu.sgml
+	* libgimp/tmpl/gimpgradientselect.sgml
+	* libgimp/tmpl/gimpimage.sgml
+	* libgimp/tmpl/gimpimagecombobox.sgml
+	* libgimp/tmpl/gimplayer.sgml
+	* libgimp/tmpl/gimppalette.sgml
+	* libgimp/tmpl/gimppalettemenu.sgml
+	* libgimp/tmpl/gimppalettes.sgml
+	* libgimp/tmpl/gimppaletteselect.sgml
+	* libgimp/tmpl/gimppaths.sgml
+	* libgimp/tmpl/gimppattern.sgml
+	* libgimp/tmpl/gimppatternmenu.sgml
+	* libgimp/tmpl/gimppatternselect.sgml
+	* libgimp/tmpl/gimppixbuf.sgml
+	* libgimp/tmpl/gimppixelfetcher.sgml
+	* libgimp/tmpl/gimpprogress.sgml
+	* libgimp/tmpl/gimpprogressbar.sgml
+	* libgimp/tmpl/gimpregioniterator.sgml
+	* libgimpbase/tmpl/gimpbaseenums.sgml
+	* libgimpbase/tmpl/gimpbasetypes.sgml
+	* libgimpbase/tmpl/gimpchecks.sgml
+	* libgimpbase/tmpl/gimpdatafiles.sgml
+	* libgimpbase/tmpl/gimpmemsize.sgml
+	* libgimpcolor/tmpl/gimpadaptivesupersample.sgml
+	* libgimpcolor/tmpl/gimpcmyk.sgml
+	* libgimpcolor/tmpl/gimphsv.sgml
+	* libgimpcolor/tmpl/gimprgb.sgml
+	* libgimpwidgets/tmpl/gimpcolorbutton.sgml
+	* libgimpwidgets/tmpl/gimpcolorhexentry.sgml
+	* libgimpwidgets/tmpl/gimpcolorselection.sgml
+	* libgimpwidgets/tmpl/gimpframe.sgml
+	* libgimpwidgets/tmpl/gimpintcombobox.sgml
+	* libgimpwidgets/tmpl/gimpintstore.sgml
+	* libgimpwidgets/tmpl/gimppatheditor.sgml
+	* libgimpwidgets/tmpl/gimppreview.sgml
+	* libgimpwidgets/tmpl/gimppreviewarea.sgml
+	* libgimpwidgets/tmpl/gimpscrolledpreview.sgml: applied a heavily
+	fixed and enhanced version of a patch from Cai Qian (bug #156271).
+	Made long_desc = short_desc where we lacked a long_desc but had
+	a short_desc. Removed unused parameters. Misc cleanups.
+
+	* libgimp/libgimp-docs.sgml: added some <chapter>s. The list of
+	libgimp modules was too long.
+
+	* libgimpwidgets/libgimpwidgets-docs.sgml
+	* libgimpwidgets/libgimpwidgets-sections.txt
+	* libgimpwidgets/libgimpwidgets.types
+	* libgimpwidgets/tmpl/gimpcontroller.sgml: added GimpController.
+
 2004-11-04  Sven Neumann  <[email protected]>
 
 	* app/app-docs.sgml

diff --git a/devel-docs/libgimp/libgimp-docs.sgml b/devel-docs/libgimp/libgimp-docs.sgml
@@ -27,50 +27,64 @@
       </para>
     </partintro>
 
-    <xi:include href="xml/gimp.xml" />
-    <xi:include href="xml/gimpbrush.xml" />
-    <xi:include href="xml/gimpbrushes.xml" />
-    <xi:include href="xml/gimpchannel.xml" />
-    <xi:include href="xml/gimpcolor.xml" />
-    <xi:include href="xml/gimpcontext.xml" />
-    <xi:include href="xml/gimpconvert.xml" />
-    <xi:include href="xml/gimpdisplay.xml" />
-    <xi:include href="xml/gimpdrawable.xml" />
-    <xi:include href="xml/gimpdrawabletransform.xml" />
-    <xi:include href="xml/gimpedit.xml" />
-    <xi:include href="xml/gimpfileops.xml" />
-    <xi:include href="xml/gimpfloatingsel.xml" />
-    <xi:include href="xml/gimpfonts.xml" />
-    <xi:include href="xml/gimpgimprc.xml" />
-    <xi:include href="xml/gimpgradient.xml" />
-    <xi:include href="xml/gimpgradients.xml" />
-    <xi:include href="xml/gimpguides.xml" />
-    <xi:include href="xml/gimphelp.xml" />
-    <xi:include href="xml/gimpimage.xml" />
-    <xi:include href="xml/gimplayer.xml" />
-    <xi:include href="xml/gimpmessage.xml" />
-    <xi:include href="xml/gimppalette.xml" />
-    <xi:include href="xml/gimppalettes.xml" />
-    <xi:include href="xml/gimppaths.xml" />
-    <xi:include href="xml/gimppattern.xml" />
-    <xi:include href="xml/gimppatterns.xml" />
-    <xi:include href="xml/gimppixelfetcher.xml" />
-    <xi:include href="xml/gimppixelrgn.xml" />
-    <xi:include href="xml/gimpregioniterator.xml" />
-    <xi:include href="xml/gimpplugin.xml" />
-    <xi:include href="xml/gimpproceduraldb.xml" />
-    <xi:include href="xml/gimpprogress.xml" />
-    <xi:include href="xml/gimpselection.xml" />
-    <xi:include href="xml/gimptexttool.xml" />
-    <xi:include href="xml/gimptile.xml" />
-    <xi:include href="xml/gimptools.xml" />
-    <xi:include href="xml/gimpundo.xml" />
+    <chapter id="libgimp-general">
+      <title>Functions not Related to Specific Images</title>
+      <xi:include href="xml/gimp.xml" />
+      <xi:include href="xml/gimpcontext.xml" />
+      <xi:include href="xml/gimpgimprc.xml" />
+      <xi:include href="xml/gimphelp.xml" />
+      <xi:include href="xml/gimpmessage.xml" />
+      <xi:include href="xml/gimpplugin.xml" />
+      <xi:include href="xml/gimpproceduraldb.xml" />
+      <xi:include href="xml/gimpprogress.xml" />
+    </chapter>
 
-    <xi:include href="xml/gimpbrushselect.xml" />
-    <xi:include href="xml/gimpfontselect.xml" />
-    <xi:include href="xml/gimpgradientselect.xml" />
-    <xi:include href="xml/gimppaletteselect.xml" />
-    <xi:include href="xml/gimppatternselect.xml" />
+    <chapter id="libgimp-image">
+      <title>Manupulating Images and all their Properties</title>
+      <xi:include href="xml/gimpchannel.xml" />
+      <xi:include href="xml/gimpcolor.xml" />
+      <xi:include href="xml/gimpconvert.xml" />
+      <xi:include href="xml/gimpdisplay.xml" />
+      <xi:include href="xml/gimpdrawable.xml" />
+      <xi:include href="xml/gimpdrawabletransform.xml" />
+      <xi:include href="xml/gimpedit.xml" />
+      <xi:include href="xml/gimpfileops.xml" />
+      <xi:include href="xml/gimpfloatingsel.xml" />
+      <xi:include href="xml/gimpguides.xml" />
+      <xi:include href="xml/gimpimage.xml" />
+      <xi:include href="xml/gimplayer.xml" />
+      <xi:include href="xml/gimppaths.xml" />
+      <xi:include href="xml/gimppixelfetcher.xml" />
+      <xi:include href="xml/gimppixelrgn.xml" />
+      <xi:include href="xml/gimpregioniterator.xml" />
+      <xi:include href="xml/gimpselection.xml" />
+      <xi:include href="xml/gimptexttool.xml" />
+      <xi:include href="xml/gimptile.xml" />
+      <xi:include href="xml/gimptools.xml" />
+      <xi:include href="xml/gimpundo.xml" />
+    </chapter>
+
+    <chapter id="libgimp-data">
+      <title>Data Objects</title>
+      <xi:include href="xml/gimpbrush.xml" />
+      <xi:include href="xml/gimpbrushes.xml" />
+      <xi:include href="xml/gimpfonts.xml" />
+      <xi:include href="xml/gimpgradient.xml" />
+      <xi:include href="xml/gimpgradients.xml" />
+      <xi:include href="xml/gimppalette.xml" />
+      <xi:include href="xml/gimppalettes.xml" />
+      <xi:include href="xml/gimppattern.xml" />
+      <xi:include href="xml/gimppatterns.xml" />
+    </chapter>
+
+    <chapter id="libgimp-selectors">
+      <title>Controlling the Core's Selection Dialogs</title>
+      <xi:include href="xml/gimpbrushselect.xml" />
+      <xi:include href="xml/gimpfontselect.xml" />
+      <xi:include href="xml/gimpgradientselect.xml" />
+      <xi:include href="xml/gimppaletteselect.xml" />
+      <xi:include href="xml/gimppatternselect.xml" />
+    </chapter>
   </part>
 
   <part id="libgimpui">

diff --git a/devel-docs/libgimp/tmpl/gimpaspectpreview.sgml b/devel-docs/libgimp/tmpl/gimpaspectpreview.sgml
@@ -2,11 +2,11 @@
 GimpAspectPreview
 
 <!-- ##### SECTION Short_Description ##### -->
-
+A widget providing a preview with fixed aspect ratio.
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
-
+A widget providing a preview with fixed aspect ratio.
 </para>
 
 <!-- ##### SECTION See_Also ##### -->

diff --git a/devel-docs/libgimp/tmpl/gimpbrush.sgml b/devel-docs/libgimp/tmpl/gimpbrush.sgml
@@ -2,11 +2,11 @@
 gimpbrush
 
 <!-- ##### SECTION Short_Description ##### -->
-
+Functions operating on a single brush.
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
-
+Functions operating on a single brush.
 </para>
 
 <!-- ##### SECTION See_Also ##### -->

diff --git a/devel-docs/libgimp/tmpl/gimpbrushmenu.sgml b/devel-docs/libgimp/tmpl/gimpbrushmenu.sgml
@@ -2,11 +2,11 @@
 gimpbrushmenu
 
 <!-- ##### SECTION Short_Description ##### -->
-A widget for selecting brushes
+A widget for selecting brushes.
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
-
+A widget for selecting brushes.
 </para>
 
 <!-- ##### SECTION See_Also ##### -->

diff --git a/devel-docs/libgimp/tmpl/gimpbrushselect.sgml b/devel-docs/libgimp/tmpl/gimpbrushselect.sgml
@@ -2,11 +2,11 @@
 gimpbrushselect
 
 <!-- ##### SECTION Short_Description ##### -->
-
+Functions providing a brush selection dialog.
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
-
+Functions providing a brush selection dialog.
 </para>
 
 <!-- ##### SECTION See_Also ##### -->

diff --git a/devel-docs/libgimp/tmpl/gimpcontext.sgml b/devel-docs/libgimp/tmpl/gimpcontext.sgml
@@ -2,11 +2,11 @@
 gimpcontext
 
 <!-- ##### SECTION Short_Description ##### -->
-
+Functions to manipulate a plug-in's context.
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
-
+Functions to manipulate a plug-in's context.
 </para>
 
 <!-- ##### SECTION See_Also ##### -->

diff --git a/devel-docs/libgimp/tmpl/gimpdrawable.sgml b/devel-docs/libgimp/tmpl/gimpdrawable.sgml
@@ -61,8 +61,6 @@ Functions to manipulate drawables.
 
 @drawable_ID: 
 @Returns: 
-<!-- # Unused Parameters # -->
-@drawable: 
 
 
 <!-- ##### FUNCTION gimp_drawable_get_name ##### -->

diff --git a/devel-docs/libgimp/tmpl/gimpdrawablecombobox.sgml b/devel-docs/libgimp/tmpl/gimpdrawablecombobox.sgml
@@ -2,11 +2,11 @@
 gimpdrawablecombobox
 
 <!-- ##### SECTION Short_Description ##### -->
-
+A widget providing a popup menu of drawables.
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
-
+A widget providing a popup menu of drawables.
 </para>
 
 <!-- ##### SECTION See_Also ##### -->

diff --git a/devel-docs/libgimp/tmpl/gimpdrawablepreview.sgml b/devel-docs/libgimp/tmpl/gimpdrawablepreview.sgml
@@ -2,11 +2,11 @@
 GimpDrawablePreview
 
 <!-- ##### SECTION Short_Description ##### -->
-
+A widget providing a preview of a #GimpDrawable.
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
-
+A widget providing a preview of a #GimpDrawable.
 </para>
 
 <!-- ##### SECTION See_Also ##### -->

diff --git a/devel-docs/libgimp/tmpl/gimpdrawabletransform.sgml b/devel-docs/libgimp/tmpl/gimpdrawabletransform.sgml
@@ -43,11 +43,6 @@ gimpdrawabletransform
 @recursion_level: 
 @clip_result: 
 @Returns: 
-<!-- # Unused Parameters # -->
-@flip_type: 
-@auto_center: 
-@axis: 
-@center: 
 
 
 <!-- ##### FUNCTION gimp_drawable_transform_flip_defaults ##### -->
@@ -63,8 +58,6 @@ gimpdrawabletransform
 @interpolate: 
 @clip_result: 
 @Returns: 
-<!-- # Unused Parameters # -->
-@interpolation: 
 
 
 <!-- ##### FUNCTION gimp_drawable_transform_perspective ##### -->
@@ -106,8 +99,6 @@ gimpdrawabletransform
 @interpolate: 
 @clip_result: 
 @Returns: 
-<!-- # Unused Parameters # -->
-@interpolation: 
 
 
 <!-- ##### FUNCTION gimp_drawable_transform_rotate_simple ##### -->
@@ -140,10 +131,6 @@ gimpdrawabletransform
 @recursion_level: 
 @clip_result: 
 @Returns: 
-<!-- # Unused Parameters # -->
-@rotate_type: 
-@cx: 
-@cy: 
 
 
 <!-- ##### FUNCTION gimp_drawable_transform_rotate_defaults ##### -->
@@ -159,8 +146,6 @@ gimpdrawabletransform
 @interpolate: 
 @clip_result: 
 @Returns: 
-<!-- # Unused Parameters # -->
-@interpolation: 
 
 
 <!-- ##### FUNCTION gimp_drawable_transform_scale ##### -->
@@ -194,8 +179,6 @@ gimpdrawabletransform
 @interpolate: 
 @clip_result: 
 @Returns: 
-<!-- # Unused Parameters # -->
-@interpolation: 
 
 
 <!-- ##### FUNCTION gimp_drawable_transform_shear ##### -->
@@ -225,8 +208,6 @@ gimpdrawabletransform
 @interpolate: 
 @clip_result: 
 @Returns: 
-<!-- # Unused Parameters # -->
-@interpolation: 
 
 
 <!-- ##### FUNCTION gimp_drawable_transform_2d ##### -->
@@ -266,8 +247,6 @@ gimpdrawabletransform
 @interpolate: 
 @clip_result: 
 @Returns: 
-<!-- # Unused Parameters # -->
-@interpolation: 
 
 
 <!-- ##### FUNCTION gimp_drawable_transform_matrix ##### -->
@@ -311,7 +290,3 @@ gimpdrawabletransform
 @interpolate: 
 @clip_result: 
 @Returns: 
-<!-- # Unused Parameters # -->
-@interpolation: 
-
-
diff --git a/devel-docs/libgimp/tmpl/gimpfontmenu.sgml b/devel-docs/libgimp/tmpl/gimpfontmenu.sgml
@@ -2,11 +2,11 @@
 gimpfontmenu
 
 <!-- ##### SECTION Short_Description ##### -->
-A widget for selecting fonts
+A widget for selecting fonts.
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
-
+A widget for selecting fonts.
 </para>
 
 <!-- ##### SECTION See_Also ##### -->

diff --git a/devel-docs/libgimp/tmpl/gimpfontselect.sgml b/devel-docs/libgimp/tmpl/gimpfontselect.sgml
@@ -1,12 +1,12 @@
 <!-- ##### SECTION Title ##### -->
-gimpfonts
+gimpfontselect
 
 <!-- ##### SECTION Short_Description ##### -->
-
+Functions providing a font selection dialog.
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
-
+Functions providing a font selection dialog.
 </para>
 
 <!-- ##### SECTION See_Also ##### -->