[gnumeric] Change src/func-builtin.c to new description type

[Andreas J. Guelzow <guelzow src gnome org>]

commit e3b71b5457394d5a2b88ca6f39741ac1d17013ae
Author: Andreas J. Guelzow <aguelzow pyrshep ca>
Date:   Sun Jun 28 19:31:17 2009 -0600

    Change src/func-builtin.c to new description type
    
    2009-06-28 Andreas J. Guelzow <aguelzow pyrshep ca>
    
    	* src/func-builtin.c (help_sum): change to new description type
    	(help_product): ditto
    	(help_gnumeric_version): ditto

 ChangeLog          |    6 ++++
 src/func-builtin.c |   65 +++++++++++++++++----------------------------------
 2 files changed, 28 insertions(+), 43 deletions(-)
---
diff --git a/ChangeLog b/ChangeLog
index ae888dd..a1899f9 100644
--- a/ChangeLog
+++ b/ChangeLog
@@ -1,5 +1,11 @@
 2009-06-28 Andreas J. Guelzow <aguelzow pyrshep ca>
 
+	* src/func-builtin.c (help_sum): change to new description type
+	(help_product): ditto
+	(help_gnumeric_version): ditto
+
+2009-06-28 Andreas J. Guelzow <aguelzow pyrshep ca>
+
 	* schemas/gnumeric-general.schemas.in: add schema for 
 	  long format toolbar and fix other toolbar schemas
 	* src/GNOME_Gnumeric-gtk.xml.in: provide a long version of 
diff --git a/src/func-builtin.c b/src/func-builtin.c
index 56e34c9..7563f21 100644
--- a/src/func-builtin.c
+++ b/src/func-builtin.c
@@ -38,22 +38,14 @@
 /***************************************************************************/
 
 static GnmFuncHelp const help_sum[] = {
-    { GNM_FUNC_HELP_OLD,
-	N_("@FUNCTION=SUM\n"
-	   "@SYNTAX=SUM(value1, value2, ...)\n"
-
-	   "@DESCRIPTION="
-	   "SUM computes the sum of all the values and cells referenced "
-	   "in the argument list.\n\n"
-	   "* This function is Excel compatible."
-	   "\n"
-	   "@EXAMPLES=\n"
-	   "Let us assume that the cells A1, A2, ..., A5 contain numbers "
-	   "11, 15, 17, 21, and 43.  Then\n"
-	   "SUM(A1:A5) equals 107.")
-    },
-    { GNM_FUNC_HELP_SEEALSO, "AVERAGE,COUNT" },
-    { GNM_FUNC_HELP_END }
+	{ GNM_FUNC_HELP_NAME, N_("Sum:sum of the given values")},
+	{ GNM_FUNC_HELP_ARG, N_("values:a list of values to add")},
+	{ GNM_FUNC_HELP_DESCRIPTION, N_("SUM computes the sum of all the values and cells referenced in the argument list.")},
+	{ GNM_FUNC_HELP_EXCEL, N_("This function is Excel compatible.") },
+	{ GNM_FUNC_HELP_ODF, N_("This function is OpenFormula compatible.") },
+	{ GNM_FUNC_HELP_EXAMPLES, N_("=SUM(11,15,17,21,43)") },
+	{ GNM_FUNC_HELP_SEEALSO, "AVERAGE,COUNT"},
+	{ GNM_FUNC_HELP_END }
 };
 
 GnmValue *
@@ -70,21 +62,15 @@ gnumeric_sum (GnmFuncEvalInfo *ei, int argc, GnmExprConstPtr const *argv)
 /***************************************************************************/
 
 static GnmFuncHelp const help_product[] = {
-    { GNM_FUNC_HELP_OLD,
-	N_("@FUNCTION=PRODUCT\n"
-	   "@SYNTAX=PRODUCT(value1, value2, ...)\n"
-
-	   "@DESCRIPTION="
-	   "PRODUCT returns the product of all the values and cells "
-	   "referenced in the argument list.\n\n"
-	   "* This function is Excel compatible.  In particular, this means "
-	   "that if all cells are empty, the result will be 0.\n"
-	   "\n"
-	   "@EXAMPLES=\n"
-	   "PRODUCT(2,5,9) equals 90.")
-    },
-    { GNM_FUNC_HELP_SEEALSO, "SUM,COUNT,G_PRODUCT" },
-    { GNM_FUNC_HELP_END }
+	{ GNM_FUNC_HELP_NAME, N_("PRODUCT:product  of the given values")},
+	{ GNM_FUNC_HELP_ARG, N_("values:a list of values to multiply")},
+	{ GNM_FUNC_HELP_DESCRIPTION, N_("Product computes the product of all the values and cells referenced in the argument list.")},
+	{ GNM_FUNC_HELP_NOTE, N_("If all cells are empty, the result will be 0.") },
+	{ GNM_FUNC_HELP_EXCEL, N_("This function is Excel compatible.") },
+	{ GNM_FUNC_HELP_ODF, N_("This function is OpenFormula compatible.") },
+	{ GNM_FUNC_HELP_EXAMPLES, N_("=PRODUCT(2,5,9)") },
+	{ GNM_FUNC_HELP_SEEALSO, "SUM,COUNT,G_PRODUCT"},
+	{ GNM_FUNC_HELP_END }
 };
 
 static int
@@ -111,18 +97,11 @@ gnumeric_product (GnmFuncEvalInfo *ei, int argc, GnmExprConstPtr const *argv)
 /***************************************************************************/
 
 static GnmFuncHelp const help_gnumeric_version[] = {
-    { GNM_FUNC_HELP_OLD,
-	N_("@FUNCTION=GNUMERIC_VERSION\n"
-	   "@SYNTAX=GNUMERIC_VERSION()\n"
-
-	   "@DESCRIPTION="
-	   "GNUMERIC_VERSION returns the version of gnumeric as a string."
-
-	   "\n"
-	   "@EXAMPLES=\n"
-	   "GNUMERIC_VERSION().")
-    },
-    { GNM_FUNC_HELP_END }
+ 	{ GNM_FUNC_HELP_NAME, N_("GNUMERIC_VERSION:the current version of GNumeric")},
+	{ GNM_FUNC_HELP_DESCRIPTION, N_("GNUMERIC_VERSION returns the version of gnumeric as a string.")},
+	{ GNM_FUNC_HELP_EXAMPLES, N_("=GNUMERIC_VERSION()") },
+	{ GNM_FUNC_HELP_SEEALSO, ""},
+	{ GNM_FUNC_HELP_END }
 };
 
 static GnmValue *