GNOME.org
 

[gtkmm] Gtkmm-forge digest, Vol 1 #636 - 9 msgs

Send Gtkmm-forge mailing list submissions to
	gtkmm-forge lists sourceforge net

To subscribe or unsubscribe via the World Wide Web, visit
	https://lists.sourceforge.net/lists/listinfo/gtkmm-forge
or, via email, send a message with subject or body 'help' to
	gtkmm-forge-request lists sourceforge net

You can reach the person managing the list at
	gtkmm-forge-admin lists sourceforge net

When replying, please edit your Subject line so it is more specific
than "Re: Contents of Gtkmm-forge digest..."


gtkmm-forge is the mailing list that receives gtkmm bug reports from bugzilla.  A daily digest is sent to gtkmm-main, to encourage people to help fixing the bugs. Do not try to unsubscribe gtkmm-forge from gtkmm-list.


Today's Topics:

   1. [Bug 136427] New - API Documentation update (bugzilla-daemon widget gnome org)
   2. [Bug 136427] Changed - API Documentation update (bugzilla-daemon widget gnome org)
   3. [Bug 136396] Changed - Patching docs/reference/Makefile.am (bugzilla-daemon widget gnome org)
   4. [Bug 136427] Changed - API Documentation update (bugzilla-daemon widget gnome org)
   5. [Bug 136505] New - improving DocsParser.pm to support method mappings (bugzilla-daemon widget gnome org)
   6. [Bug 136505] Changed - improving DocsParser.pm to support method mappings (bugzilla-daemon widget gnome org)
   7. [Bug 136505] Changed - improving DocsParser.pm to support method mappings (bugzilla-daemon widget gnome org)
   8. [Bug 136505] Changed - improving DocsParser.pm to support method mappings (bugzilla-daemon widget gnome org)
   9. [Bug 136505] Changed - improving DocsParser.pm to support method mappings (bugzilla-daemon widget gnome org)

--__--__--

Message: 1
From: bugzilla-daemon widget gnome org
To: gtkmm-forge lists sourceforge net,
	Hagen Moebius Starschiffchen de
Cc: 
Date: Sat,  6 Mar 2004 23:54:29 -0500 (EST)
Subject: [gtkmm bugzilla] [Bug 136427] New - API Documentation update

Please do not reply to this email- if you want to comment on the bug, go to the
URL shown below and enter your comments there.

http://bugzilla.gnome.org/show_bug.cgi?id=136427

Changed by hagen moebius starschiffchen de 

--- shadow/136427	Sat Mar  6 23:54:29 2004
+++ shadow/136427.tmp.9219	Sat Mar  6 23:54:29 2004
@@ -0,0 +1,19 @@
+Bug#: 136427
+Product: gtkmm
+Version: 2.4
+OS: Linux
+OS Details: 
+Status: NEW   
+Resolution: 
+Severity: normal
+Priority: Normal
+Component: reference documentation
+AssignedTo: gtkmm-forge lists sourceforge net                            
+ReportedBy: Hagen Moebius Starschiffchen de               
+QAContact: gtkmm-forge lists sourceforge net
+TargetMilestone: ---
+URL: 
+Summary: API Documentation update
+
+Updated the documentation abit. The "Widgets" page should now be fully
+documented with brief descriptions.


--__--__--

Message: 2
From: bugzilla-daemon widget gnome org
To: gtkmm-forge lists sourceforge net,
	Hagen Moebius Starschiffchen de
Cc: 
Date: Sat,  6 Mar 2004 23:55:13 -0500 (EST)
Subject: [gtkmm bugzilla] [Bug 136427] Changed - API Documentation update

Please do not reply to this email- if you want to comment on the bug, go to the
URL shown below and enter your comments there.

http://bugzilla.gnome.org/show_bug.cgi?id=136427

Changed by hagen moebius starschiffchen de 

--- shadow/136427	Sat Mar  6 23:54:29 2004
+++ shadow/136427.tmp.9537	Sat Mar  6 23:55:13 2004
@@ -14,6 +14,11 @@
 TargetMilestone: ---
 URL: 
 Summary: API Documentation update
 
 Updated the documentation abit. The "Widgets" page should now be fully
 documented with brief descriptions.
+
+------- Additional Comments From Hagen Moebius Starschiffchen de  2004-03-06 23:55 -------
+Created an attachment (id=25283)
+Patch for API documentation v1
+


--__--__--

Message: 3
From: bugzilla-daemon widget gnome org
To: gtkmm-forge lists sourceforge net,
	Hagen Moebius Starschiffchen de
Cc: 
Date: Sun,  7 Mar 2004 08:40:39 -0500 (EST)
Subject: [gtkmm bugzilla] [Bug 136396] Changed - Patching docs/reference/Makefile.am

Please do not reply to this email- if you want to comment on the bug, go to the
URL shown below and enter your comments there.

http://bugzilla.gnome.org/show_bug.cgi?id=136396

Changed by murrayc murrayc com 

--- shadow/136396	Sat Mar  6 22:30:38 2004
+++ shadow/136396.tmp.1229	Sun Mar  7 08:40:39 2004
@@ -1,13 +1,13 @@
 Bug#: 136396
 Product: gtkmm
 Version: 2.4
 OS: Linux
 OS Details: 
-Status: REOPENED   
-Resolution: 
+Status: RESOLVED   
+Resolution: FIXED
 Severity: normal
 Priority: Normal
 Component: build
 AssignedTo: gtkmm-forge lists sourceforge net                            
 ReportedBy: Hagen Moebius Starschiffchen de               
 TargetMilestone: ---
@@ -64,6 +64,10 @@
 
 ------- Additional Comments From Hagen Moebius Starschiffchen de  2004-03-06 22:30 -------
 tee has a bit of strange behavior: it buffers.
 This makes the output jumpy, consider this before commiting.
 But as you say: only a few ppl will see this and I don't know if they
 care.
+
+------- Additional Comments From murrayc murrayc com  2004-03-07 08:40 -------
+This is really good. Now people will always have the list of warnings
+too look at. Well done and thanks.


--__--__--

Message: 4
From: bugzilla-daemon widget gnome org
To: gtkmm-forge lists sourceforge net,
	Hagen Moebius Starschiffchen de
Cc: 
Date: Sun,  7 Mar 2004 09:18:55 -0500 (EST)
Subject: [gtkmm bugzilla] [Bug 136427] Changed - API Documentation update

Please do not reply to this email- if you want to comment on the bug, go to the
URL shown below and enter your comments there.

http://bugzilla.gnome.org/show_bug.cgi?id=136427

Changed by murrayc murrayc com 

--- shadow/136427	Sat Mar  6 23:55:13 2004
+++ shadow/136427.tmp.10275	Sun Mar  7 09:18:55 2004
@@ -1,13 +1,13 @@
 Bug#: 136427
 Product: gtkmm
 Version: 2.4
 OS: Linux
 OS Details: 
-Status: NEW   
-Resolution: 
+Status: RESOLVED   
+Resolution: FIXED
 Severity: normal
 Priority: Normal
 Component: reference documentation
 AssignedTo: gtkmm-forge lists sourceforge net                            
 ReportedBy: Hagen Moebius Starschiffchen de               
 QAContact: gtkmm-forge lists sourceforge net
@@ -19,6 +19,10 @@
 documented with brief descriptions.
 
 ------- Additional Comments From Hagen Moebius Starschiffchen de  2004-03-06 23:55 -------
 Created an attachment (id=25283)
 Patch for API documentation v1
 
+
+------- Additional Comments From murrayc murrayc com  2004-03-07 09:18 -------
+Great. I removed a mention of "GtkSeparatorToolItem" from the docs,
+but committed it. Thanks.


--__--__--

Message: 5
From: bugzilla-daemon widget gnome org
To: gtkmm-forge lists sourceforge net,
	Hagen Moebius Starschiffchen de
Cc: 
Date: Sun,  7 Mar 2004 18:39:57 -0500 (EST)
Subject: [gtkmm bugzilla] [Bug 136505] New - improving DocsParser.pm to support method mappings

Please do not reply to this email- if you want to comment on the bug, go to the
URL shown below and enter your comments there.

http://bugzilla.gnome.org/show_bug.cgi?id=136505

Changed by hagen moebius starschiffchen de 

--- shadow/136505	Sun Mar  7 18:39:57 2004
+++ shadow/136505.tmp.17771	Sun Mar  7 18:39:57 2004
@@ -0,0 +1,83 @@
+Bug#: 136505
+Product: glibmm
+Version: 2.4.x
+OS: Linux
+OS Details: 
+Status: NEW   
+Resolution: 
+Severity: normal
+Priority: Normal
+Component: documentation
+AssignedTo: gtkmm-forge lists sourceforge net                            
+ReportedBy: Hagen Moebius Starschiffchen de               
+TargetMilestone: ---
+URL: 
+Summary: improving DocsParser.pm to support method mappings
+
+OK, this is just a first glance at the functionality.
+
+1)
+The idea is to change the policy of the DocsParser. At the moment it reads
+the docs.xml file and builds a hashed list of all functions described
+inside. After thatit reads the docs_override.xml file. Everytime it
+encounters a function name already in the hashlist (read from docs.xml) it
+completely deletes all information stored for that function and builds a
+new entry, now containing only data from the docs_override.xml.
+
+I changed this so the parser now only changes the data that really is newly
+set in the docs_override.xml.
+
+docs.xml:
+<function name="somefunction">
+    <description>Function's description.</description>
+    <return>Returns some value</return>
+</function>
+
+docs_override.xml:
+<function name="somefunction">
+    <description>A new description</description>
+</function>
+
+This fragment results in a function "somefunction" with the description "A
+new description" and the return "Returns some value". So only the
+description is overridden by the docs_override.xml.
+
+
+2)
+I added a new tag named <mapping>. it has no cdata content and supports the
+property class="...".
+
+doc_override.xml:
+<function name="somefunction">
+    <mapping class="Style">
+</function>
+
+This definition maps the function "somefunction" into the class "Style".
+Actually it just says "this function belongs to a class" so the outputter
+knows it has to drop the first parameter from the parameter list (as it is
+the pointer to the object [in gtk])
+
+1) + 2)
+To make this clear once more. There is no need for two declarations as
+above. docs_override.xml now MAY look like this (though it is not a MUST,
+it MAY also contain two declarations):
+
+<function name="somefunction">
+    <description>A new description</description>
+    <mapping class="Style">
+</function>
+
+Which achives the cumulative result from 1) and 2).
+function = "somefunction"
+description = "A new description"
+return = "Returns some value"
+mapping = Style
+
+
+3)
+There is one addition to the regular expressions at the end of the file. It
+allows names to contain numbers like x1, x2, y1, y2 in gdk/gdkmm/region.h.
+
+We have to take a second look at this regexp ... it does NOT do what it
+promises: the trailing underscore from index_ is not removed. (see
+gtk/gtkmm/treemodel.h:303)


--__--__--

Message: 6
From: bugzilla-daemon widget gnome org
To: gtkmm-forge lists sourceforge net,
	Hagen Moebius Starschiffchen de
Cc: 
Date: Sun,  7 Mar 2004 18:40:39 -0500 (EST)
Subject: [gtkmm bugzilla] [Bug 136505] Changed - improving DocsParser.pm to support method mappings

Please do not reply to this email- if you want to comment on the bug, go to the
URL shown below and enter your comments there.

http://bugzilla.gnome.org/show_bug.cgi?id=136505

Changed by hagen moebius starschiffchen de 

--- shadow/136505	Sun Mar  7 18:39:57 2004
+++ shadow/136505.tmp.18104	Sun Mar  7 18:40:39 2004
@@ -78,6 +78,11 @@
 There is one addition to the regular expressions at the end of the file. It
 allows names to contain numbers like x1, x2, y1, y2 in gdk/gdkmm/region.h.
 
 We have to take a second look at this regexp ... it does NOT do what it
 promises: the trailing underscore from index_ is not removed. (see
 gtk/gtkmm/treemodel.h:303)
+
+------- Additional Comments From Hagen Moebius Starschiffchen de  2004-03-07 18:40 -------
+Created an attachment (id=25309)
+Attempts to fix some gmmproc misbehavior
+


--__--__--

Message: 7
From: bugzilla-daemon widget gnome org
To: gtkmm-forge lists sourceforge net,
	Hagen Moebius Starschiffchen de
Cc: 
Date: Sun,  7 Mar 2004 18:51:54 -0500 (EST)
Subject: [gtkmm bugzilla] [Bug 136505] Changed - improving DocsParser.pm to support method mappings

Please do not reply to this email- if you want to comment on the bug, go to the
URL shown below and enter your comments there.

http://bugzilla.gnome.org/show_bug.cgi?id=136505

Changed by murrayc murrayc com 

--- shadow/136505	Sun Mar  7 18:40:39 2004
+++ shadow/136505.tmp.20565	Sun Mar  7 18:51:53 2004
@@ -83,6 +83,20 @@
 gtk/gtkmm/treemodel.h:303)
 
 ------- Additional Comments From Hagen Moebius Starschiffchen de  2004-03-07 18:40 -------
 Created an attachment (id=25309)
 Attempts to fix some gmmproc misbehavior
 
+
+------- Additional Comments From murrayc murrayc com  2004-03-07 18:51 -------
+1) I'm not sure that this is a good idea, because it makes it
+impossible to use gtk_overrides.xml to remove something - for
+instance, to remove any return type. But that is not actually needed,
+so OK.
+
+2) I would prefer "of-object" to "mapping". That's more like the .defs
+file format. I think it should mention the C typename, such as
+GtkStyle instead of a C++ class, because these are C docs for C functions.
+
+3) So this is not a regression?
+
+Could you revise the patch for 2) - then I will commit it.


--__--__--

Message: 8
From: bugzilla-daemon widget gnome org
To: gtkmm-forge lists sourceforge net,
	Hagen Moebius Starschiffchen de
Cc: 
Date: Sun,  7 Mar 2004 19:26:12 -0500 (EST)
Subject: [gtkmm bugzilla] [Bug 136505] Changed - improving DocsParser.pm to support method mappings

Please do not reply to this email- if you want to comment on the bug, go to the
URL shown below and enter your comments there.

http://bugzilla.gnome.org/show_bug.cgi?id=136505

Changed by hagen moebius starschiffchen de 

--- shadow/136505	Sun Mar  7 18:51:53 2004
+++ shadow/136505.tmp.28517	Sun Mar  7 19:26:12 2004
@@ -97,6 +97,32 @@
 file format. I think it should mention the C typename, such as
 GtkStyle instead of a C++ class, because these are C docs for C functions.
 
 3) So this is not a regression?
 
 Could you revise the patch for 2) - then I will commit it.
+
+------- Additional Comments From Hagen Moebius Starschiffchen de  2004-03-07 19:26 -------
+1) Actually this is possible. Even better than before:
+
+docs_overrides.xml:
+<function name="somefunction">
+    <return></return>
+</function>
+
+does exactly the job. Even better because it leaves the description
+and the parameter list untouched. This wouldn't be possible without
+the patch. You'd have to rewrite the complete entry from docs.xml
+(except the return)
+
+2) I can understand your argument, however I would like to say this:
+docs_overrides.xml is exactly NOT to describe C functions.
+docs_overrides.xml is the step from C to C++. If we'd make
+docs_overrides.xml contain C++ documentation it also could be used to
+describe overloaded functions, constructors, destructors and so on.
+Well, just my 5 pence, just say: "no" and I will make it like so:
+
+<of-object object="GtkStyle" />
+
+3) No. This didn't work before either. Look at your
+doxygen-warnings.txt file it contains warnings about these trailing
+underscores. This update just addresses the numbers.


--__--__--

Message: 9
From: bugzilla-daemon widget gnome org
To: gtkmm-forge lists sourceforge net,
	Hagen Moebius Starschiffchen de
Cc: 
Date: Sun,  7 Mar 2004 19:35:52 -0500 (EST)
Subject: [gtkmm bugzilla] [Bug 136505] Changed - improving DocsParser.pm to support method mappings

Please do not reply to this email- if you want to comment on the bug, go to the
URL shown below and enter your comments there.

http://bugzilla.gnome.org/show_bug.cgi?id=136505

Changed by murrayc murrayc com 

--- shadow/136505	Sun Mar  7 19:26:12 2004
+++ shadow/136505.tmp.30374	Sun Mar  7 19:35:52 2004
@@ -1,13 +1,13 @@
 Bug#: 136505
 Product: glibmm
 Version: 2.4.x
 OS: Linux
 OS Details: 
-Status: NEW   
-Resolution: 
+Status: RESOLVED   
+Resolution: FIXED
 Severity: normal
 Priority: Normal
 Component: documentation
 AssignedTo: gtkmm-forge lists sourceforge net                            
 ReportedBy: Hagen Moebius Starschiffchen de               
 TargetMilestone: ---
@@ -123,6 +123,9 @@
 
 <of-object object="GtkStyle" />
 
 3) No. This didn't work before either. Look at your
 doxygen-warnings.txt file it contains warnings about these trailing
 underscores. This update just addresses the numbers.
+
+------- Additional Comments From murrayc murrayc com  2004-03-07 19:35 -------
+Yeah, OK. Committed.



--__--__--

_______________________________________________
Gtkmm-forge mailing list
Gtkmm-forge lists sourceforge net
https://lists.sourceforge.net/lists/listinfo/gtkmm-forge


End of Gtkmm-forge Digest
[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]