documented gimpmatrix

--Sven

devel-docs/libgimp/libgimp-decl.txt

@@ -2549,72 +2549,72 @@ typedef double GimpMatrix[3][3];
 <FUNCTION>
 <NAME>gimp_matrix_transform_point</NAME>
 <RETURNS>void  </RETURNS>
-GimpMatrix, double, double,double *, double *
+GimpMatrix  matrix,gdouble     x,gdouble     y,gdouble    *newx,gdouble    *newy
 </FUNCTION>
 <FUNCTION>
 <NAME>gimp_matrix_mult</NAME>
 <RETURNS>void  </RETURNS>
-GimpMatrix, GimpMatrix
+GimpMatrix  matrix1,GimpMatrix  matrix2
 </FUNCTION>
 <FUNCTION>
 <NAME>gimp_matrix_identity</NAME>
 <RETURNS>void  </RETURNS>
-GimpMatrix
+GimpMatrix  matrix
 </FUNCTION>
 <FUNCTION>
 <NAME>gimp_matrix_translate</NAME>
 <RETURNS>void  </RETURNS>
-GimpMatrix, double, double
+GimpMatrix  matrix,gdouble     x,gdouble     y
 </FUNCTION>
 <FUNCTION>
 <NAME>gimp_matrix_scale</NAME>
 <RETURNS>void  </RETURNS>
-GimpMatrix, double, double
+GimpMatrix  matrix,gdouble     x,gdouble     y
 </FUNCTION>
 <FUNCTION>
 <NAME>gimp_matrix_rotate</NAME>
 <RETURNS>void  </RETURNS>
-GimpMatrix, double
+GimpMatrix  matrix,gdouble     theta
 </FUNCTION>
 <FUNCTION>
 <NAME>gimp_matrix_xshear</NAME>
 <RETURNS>void  </RETURNS>
-GimpMatrix, double
+GimpMatrix  matrix,gdouble     amount
 </FUNCTION>
 <FUNCTION>
 <NAME>gimp_matrix_yshear</NAME>
 <RETURNS>void  </RETURNS>
-GimpMatrix, double
+GimpMatrix  matrix,gdouble     amount
 </FUNCTION>
 <FUNCTION>
 <NAME>gimp_matrix_determinant</NAME>
-<RETURNS>double  </RETURNS>
-GimpMatrix
+<RETURNS>gdouble  </RETURNS>
+GimpMatrix  matrix
 </FUNCTION>
 <FUNCTION>
 <NAME>gimp_matrix_invert</NAME>
 <RETURNS>void  </RETURNS>
-GimpMatrix m, GimpMatrix m_inv
+GimpMatrix  matrix,GimpMatrix  matrix_inv
 </FUNCTION>
 <FUNCTION>
 <NAME>gimp_matrix_duplicate</NAME>
 <RETURNS>void  </RETURNS>
-GimpMatrix src, GimpMatrix target
+GimpMatrix  src,GimpMatrix  target
 </FUNCTION>
 <FUNCTION>
 <NAME>gimp_matrix_is_diagonal</NAME>
-<RETURNS>int  </RETURNS>
-GimpMatrix m
+<RETURNS>gboolean  </RETURNS>
+GimpMatrix  matrix
 </FUNCTION>
 <FUNCTION>
 <NAME>gimp_matrix_is_identity</NAME>
-<RETURNS>int  </RETURNS>
-GimpMatrix m
+<RETURNS>gboolean  </RETURNS>
+GimpMatrix  matrix
 </FUNCTION>
 <FUNCTION>
 <NAME>gimp_matrix_is_simple</NAME>
-<RETURNS>int  </RETURNS>
-GimpMatrix m
+<RETURNS>gboolean  </RETURNS>
+GimpMatrix  matrix
 </FUNCTION>
 <MACRO>
 <NAME>PARASITE_PERSISTENT</NAME>

devel-docs/libgimp/tmpl/gimpcolorspace.sgml

@@ -22,10 +22,6 @@ gimpcolorspace
 @red: 
 @green: 
 @blue: 
-<!-- # Unused Parameters # -->
-@Param1: 
-@Param2: 
-@Param3: 
 
 
 <!-- ##### FUNCTION gimp_hsv_to_rgb ##### -->
@@ -36,10 +32,6 @@ gimpcolorspace
 @hue: 
 @saturation: 
 @value: 
-<!-- # Unused Parameters # -->
-@Param1: 
-@Param2: 
-@Param3: 
 
 
 <!-- ##### FUNCTION gimp_rgb_to_hls ##### -->
@@ -50,10 +42,6 @@ gimpcolorspace
 @red: 
 @green: 
 @blue: 
-<!-- # Unused Parameters # -->
-@Param1: 
-@Param2: 
-@Param3: 
 
 
 <!-- ##### FUNCTION gimp_rgb_to_l ##### -->
@@ -65,10 +53,6 @@ gimpcolorspace
 @green: 
 @blue: 
 @Returns: 
-<!-- # Unused Parameters # -->
-@Varargs: 
-@Varargs: 
-@Varargs: 
 
 
 <!-- ##### FUNCTION gimp_hls_to_rgb ##### -->
@@ -79,10 +63,6 @@ gimpcolorspace
 @hue: 
 @lightness: 
 @saturation: 
-<!-- # Unused Parameters # -->
-@Param1: 
-@Param2: 
-@Param3: 
 
 
 <!-- ##### FUNCTION gimp_rgb_to_hsv_double ##### -->
@@ -93,10 +73,6 @@ gimpcolorspace
 @red: 
 @green: 
 @blue: 
-<!-- # Unused Parameters # -->
-@Param1: 
-@Param2: 
-@Param3: 
 
 
 <!-- ##### FUNCTION gimp_hsv_to_rgb_double ##### -->
@@ -107,10 +83,6 @@ gimpcolorspace
 @hue: 
 @saturation: 
 @value: 
-<!-- # Unused Parameters # -->
-@Param1: 
-@Param2: 
-@Param3: 
 
 
 <!-- ##### FUNCTION gimp_rgb_to_hsv4 ##### -->
@@ -122,11 +94,6 @@ gimpcolorspace
 @red: 
 @green: 
 @blue: 
-<!-- # Unused Parameters # -->
-@Param1: 
-@Param2: 
-@Param3: 
-@Param4: 
 
 
 <!-- ##### FUNCTION gimp_hsv_to_rgb4 ##### -->
@@ -138,11 +105,6 @@ gimpcolorspace
 @hue: 
 @saturation: 
 @value: 
-<!-- # Unused Parameters # -->
-@Param1: 
-@Param2: 
-@Param3: 
-@Param4: 
 
 
 <!-- ##### MACRO INTENSITY_RED ##### -->

devel-docs/libgimp/tmpl/gimpmatrix.sgml

@@ -2,11 +2,15 @@
 gimpmatrix
 
 <!-- ##### SECTION Short_Description ##### -->
-
+Utilities to set up and manipulate 3x3 transformation matrices.
 
 <!-- ##### SECTION Long_Description ##### -->
 <para>
-
+When doing image manipulation you will often need 3x3 transformation
+matrices that define translation, rotation, scaling, shearing and 
+arbitrary perspective transformations using a 3x3 matrix. Here you'll 
+find a set of utility functions to set up those matrices and to perform 
+basic matrix manipulations and tests.
 </para>
 
 <!-- ##### SECTION See_Also ##### -->
@@ -25,11 +29,11 @@ gimpmatrix
 
 </para>
 
-@Param1: 
-@Param2: 
-@Param3: 
-@Param4: 
-@Param5: 
+@matrix: 
+@x: 
+@y: 
+@newx: 
+@newy: 
 
 
 <!-- ##### FUNCTION gimp_matrix_mult ##### -->
@@ -37,8 +41,8 @@ gimpmatrix
 
 </para>
 
-@Param1: 
-@Param2: 
+@matrix1: 
+@matrix2: 
 
 
 <!-- ##### FUNCTION gimp_matrix_identity ##### -->
@@ -46,7 +50,7 @@ gimpmatrix
 
 </para>
 
-@Param1: 
+@matrix: 
 
 
 <!-- ##### FUNCTION gimp_matrix_translate ##### -->
@@ -54,9 +58,9 @@ gimpmatrix
 
 </para>
 
-@Param1: 
-@Param2: 
-@Param3: 
+@matrix: 
+@x: 
+@y: 
 
 
 <!-- ##### FUNCTION gimp_matrix_scale ##### -->
@@ -64,9 +68,9 @@ gimpmatrix
 
 </para>
 
-@Param1: 
-@Param2: 
-@Param3: 
+@matrix: 
+@x: 
+@y: 
 
 
 <!-- ##### FUNCTION gimp_matrix_rotate ##### -->
@@ -74,8 +78,8 @@ gimpmatrix
 
 </para>
 
-@Param1: 
-@Param2: 
+@matrix: 
+@theta: 
 
 
 <!-- ##### FUNCTION gimp_matrix_xshear ##### -->
@@ -83,8 +87,8 @@ gimpmatrix
 
 </para>
 
-@Param1: 
-@Param2: 
+@matrix: 
+@amount: 
 
 
 <!-- ##### FUNCTION gimp_matrix_yshear ##### -->
@@ -92,8 +96,8 @@ gimpmatrix
 
 </para>
 
-@Param1: 
-@Param2: 
+@matrix: 
+@amount: 
 
 
 <!-- ##### FUNCTION gimp_matrix_determinant ##### -->
@@ -101,7 +105,7 @@ gimpmatrix
 
 </para>
 
-@Param1: 
+@matrix: 
 @Returns: 
 
 
@@ -110,8 +114,8 @@ gimpmatrix
 
 </para>
 
-@m: 
-@m_inv: 
+@matrix: 
+@matrix_inv: 
 
 
 <!-- ##### FUNCTION gimp_matrix_duplicate ##### -->
@@ -128,7 +132,7 @@ gimpmatrix
 
 </para>
 
-@m: 
+@matrix: 
 @Returns: 
 
 
@@ -137,7 +141,7 @@ gimpmatrix
 
 </para>
 
-@m: 
+@matrix: 
 @Returns: 
 
 
@@ -146,7 +150,7 @@ gimpmatrix
 
 </para>
 
-@m: 
+@matrix: 
 @Returns: 
 
 

devel-docs/libgimp/tmpl/gimpmenu.sgml

@@ -48,8 +48,6 @@ gimpmenu
 @mask_data: 
 @dialog_closing: 
 @user_data: 
-<!-- # Unused Parameters # -->
-@Param1: 
 
 
 <!-- ##### USER_FUNCTION GRunPatternCallback ##### -->
@@ -64,8 +62,6 @@ gimpmenu
 @mask_data: 
 @dialog_closing: 
 @user_data: 
-<!-- # Unused Parameters # -->
-@Param1: 
 
 
 <!-- ##### USER_FUNCTION GRunGradientCallback ##### -->
@@ -78,8 +74,6 @@ gimpmenu
 @grad_data: 
 @dialog_closing: 
 @user_data: 
-<!-- # Unused Parameters # -->
-@Param1: 
 
 
 <!-- ##### FUNCTION gimp_image_menu_new ##### -->