Re: documentation bugs

[Alper Ersoy <dirt gtk org>]

Hello,

Tim Janik:
> beast-gxk.3.texi:58: Macro `ifxmlelse' called on line 58 with too many args.

A-ha!  Evil commas again.  Since the text you write there is fed to
a macro as-is, you have to protect your commas with @ signs.
Otherwise makeinfo will think there are "too many args".

> with recent CVS, can you look into this please?

Sure!

> and i've added another docu bug to the TODO:
> - the html description for @func from bstutils.c:bst_gmask_foreach()
>   is messed up [alper]

That's not another bug, they are the same.

> i'd apprechiate if you could figure what's going on there.

Ok.  Patch attached.

Later,

-- 
Alper Ersoy
? config.h.in
Index: ChangeLog
===================================================================
RCS file: /cvs/gnome/beast/ChangeLog,v
retrieving revision 1.282
diff -u -p -r1.282 ChangeLog
--- ChangeLog	1 Apr 2003 05:48:19 -0000	1.282
+++ ChangeLog	1 Apr 2003 20:28:26 -0000
@@ -1,3 +1,10 @@
+Tue Apr  1 23:17:27 2003  Alper Ersoy  <dirt@gtk.org>
+
+	* beast-gtk/bstutils.c: prefixed comma with at-sign to avoid makeinfo
+	problems in bst_gmask_get_atail().
+
+	* docs/generated/texinfo.dtd: added comma entity.
+
 Tue Apr  1 06:45:33 2003  Tim Janik  <timj@gtk.org>
 
 	* beast-gtk/bstdefs.h: removed BST_TOOLTIPS, changed code to make
Index: beast-gtk/bstutils.c
===================================================================
RCS file: /cvs/gnome/beast/beast-gtk/bstutils.c,v
retrieving revision 1.36
diff -u -p -r1.36 bstutils.c
--- beast-gtk/bstutils.c	1 Apr 2003 05:48:21 -0000	1.36
+++ beast-gtk/bstutils.c	1 Apr 2003 20:28:30 -0000
@@ -722,7 +722,7 @@ bst_gmask_get_atail (BstGMask *mask)
 /**
  * bst_gmask_foreach
  * @mask:     valid #BstGMask
- * @func:     foreach function as: void func(GtkWidget*, gpointer data);
+ * @func:     foreach function as: void func(GtkWidget*@, gpointer data);
  * @data:     data passed in to @func
  *
  * Invoke @func() with each of the widgets set for this
Index: docs/generated/texinfo.dtd
===================================================================
RCS file: /cvs/gnome/beast/docs/generated/texinfo.dtd,v
retrieving revision 1.2
diff -u -p -r1.2 texinfo.dtd
--- docs/generated/texinfo.dtd	30 Dec 2002 00:09:02 -0000	1.2
+++ docs/generated/texinfo.dtd	1 Apr 2003 20:28:32 -0000
@@ -6,3 +6,4 @@
 <!ENTITY linebreak "<linebreak/>">
 <!ENTITY dots      "<dots/>">
 <!ENTITY space     "<space/>">
+<!ENTITY cedil     ", ">