[gtkmm] Gtkmm-forge digest, Vol 1 #152 - 18 msgs
- From: gtkmm-forge-request lists sourceforge net
- To: gtkmm-forge lists sourceforge net
- Subject: [gtkmm] Gtkmm-forge digest, Vol 1 #152 - 18 msgs
- Date: Mon, 08 Jul 2002 10:49:12 -0700
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.
Today's Topics:
1. [Bug 87591] New - Misleading line in TextView documentation (bugzilla-daemon widget gnome org)
2. [Bug 87016] Changed - Not all classes have overview docs (bugzilla-daemon widget gnome org)
3. [Bug 87016] Changed - Not all classes have overview docs (bugzilla-daemon widget gnome org)
4. [Bug 87016] Changed - Not all classes have overview docs (bugzilla-daemon widget gnome org)
5. [Bug 87582] Changed - Lacking documentation for get_selected() (bugzilla-daemon widget gnome org)
6. [Bug 87016] Changed - Not all classes have overview docs (bugzilla-daemon widget gnome org)
7. [Bug 87016] Changed - Not all classes have overview docs (bugzilla-daemon widget gnome org)
8. [Bug 87016] Changed - Not all classes have overview docs (bugzilla-daemon widget gnome org)
9. [Bug 87016] Changed - Not all classes have overview docs (bugzilla-daemon widget gnome org)
10. [Bug 87016] Changed - Not all classes have overview docs (bugzilla-daemon widget gnome org)
11. [Bug 87016] Changed - Not all classes have overview docs (bugzilla-daemon widget gnome org)
12. [Bug 87016] Changed - Not all classes have overview docs (bugzilla-daemon widget gnome org)
13. [Bug 87016] Changed - Not all classes have overview docs (bugzilla-daemon widget gnome org)
14. [Bug 87016] Changed - Not all classes have overview docs (bugzilla-daemon widget gnome org)
15. [Bug 87016] Changed - Not all classes have overview docs (bugzilla-daemon widget gnome org)
16. [Bug 87016] Changed - Not all classes have overview docs (bugzilla-daemon widget gnome org)
17. [Bug 87016] Changed - Not all classes have overview docs (bugzilla-daemon widget gnome org)
18. [Bug 87591] Changed - Misleading line in TextView documentation (bugzilla-daemon widget gnome org)
--__--__--
Message: 1
From: bugzilla-daemon widget gnome org
To: gtkmm-forge lists sourceforge net
Cc:
Date: Sun, 7 Jul 2002 15:25:26 -0400 (EDT)
Subject: [gtkmm bugzilla] [Bug 87591] New - Misleading line in TextView documentation
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=87591
Changed by morten wtf dk
--- shadow/87591 Sun Jul 7 15:25:26 2002
+++ shadow/87591.tmp.28046 Sun Jul 7 15:25:26 2002
@@ -0,0 +1,28 @@
+Bug#: 87591
+Product: gtkmm
+Version: 2.0
+OS: Linux
+OS Details:
+Status: NEW
+Resolution:
+Severity: minor
+Priority: Normal
+Component: reference documentation
+AssignedTo: gtkmm-forge lists sourceforge net
+ReportedBy: morten wtf dk
+QAContact: gtkmm-forge lists sourceforge net
+TargetMilestone: ---
+URL:
+Cc:
+Summary: Misleading line in TextView documentation
+
+The documentation for Gtk::TextView::get_attributes():
+
+ The return value is a copy owned by the caller of this function, and
+should be freed.
+
+Am I right to assume that this line shouldn't be there? Since you don't
+"free" things in C++, it will be destroyed when it gets out of scope, which
+is what any C++ programmer would expect.
+
+I will create a patch if my assumptions are right.
--__--__--
Message: 2
From: bugzilla-daemon widget gnome org
To: gtkmm-forge lists sourceforge net, murrayc usa net
Cc:
Date: Sun, 7 Jul 2002 21:50:30 -0400 (EDT)
Subject: [gtkmm bugzilla] [Bug 87016] Changed - Not all classes have overview docs
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=87016
Changed by morten wtf dk
--- shadow/87016 Mon Jul 1 12:04:22 2002
+++ shadow/87016.tmp.2813 Sun Jul 7 21:50:30 2002
@@ -18,6 +18,11 @@
We don't reuse the GTK+ reference documentation for the classes themselves,
just for the methods. Someone needs to look at every class (e.g. every *.hg
file and add an appropriate Doxygen description. Many already exists. You
should look at the gtk+ API reference (www.gtkmm.org) and reword it
appropriately.
+
+------- Additional Comments From morten wtf dk 2002-07-07 21:50 -------
+Created an attachment (id=9701)
+Patch to add descriptions for several classes.
+
--__--__--
Message: 3
From: bugzilla-daemon widget gnome org
To: gtkmm-forge lists sourceforge net, murrayc usa net
Cc:
Date: Sun, 7 Jul 2002 21:53:48 -0400 (EDT)
Subject: [gtkmm bugzilla] [Bug 87016] Changed - Not all classes have overview docs
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=87016
Changed by morten wtf dk
--- shadow/87016 Sun Jul 7 21:50:30 2002
+++ shadow/87016.tmp.3166 Sun Jul 7 21:53:48 2002
@@ -23,6 +23,18 @@
appropriately.
------- Additional Comments From morten wtf dk 2002-07-07 21:50 -------
Created an attachment (id=9701)
Patch to add descriptions for several classes.
+
+------- Additional Comments From morten wtf dk 2002-07-07 21:53 -------
+I noticed that the description of some classes has a small
+introduction text, e.g.:
+
+/** Alignment Container
+ * Normally, a widget is allocated at least as much size as it
+requests, and,[...]
+
+
+Is there a greater purpose for the "Alignment Container" bit? It
+doesn't look very good in the doxygen output.
--__--__--
Message: 4
From: bugzilla-daemon widget gnome org
To: gtkmm-forge lists sourceforge net
Cc:
Date: Mon, 8 Jul 2002 03:39:35 -0400 (EDT)
Subject: [gtkmm bugzilla] [Bug 87016] Changed - Not all classes have overview docs
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=87016
Changed by murrayc usa net
--- shadow/87016 Sun Jul 7 21:53:48 2002
+++ shadow/87016.tmp.17320 Mon Jul 8 03:39:35 2002
@@ -35,6 +35,10 @@
* Normally, a widget is allocated at least as much size as it
requests, and,[...]
Is there a greater purpose for the "Alignment Container" bit? It
doesn't look very good in the doxygen output.
+
+------- Additional Comments From murrayc usa net 2002-07-08 03:39 -------
+Doxygen uses the first sentence at the top of the page. There is no
+way not to have a first sentence.
--__--__--
Message: 5
From: bugzilla-daemon widget gnome org
To: gtkmm-forge lists sourceforge net, morten wtf dk
Cc:
Date: Mon, 8 Jul 2002 03:41:50 -0400 (EDT)
Subject: [gtkmm bugzilla] [Bug 87582] Changed - Lacking documentation for get_selected()
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=87582
Changed by murrayc usa net
--- shadow/87582 Sun Jul 7 14:08:49 2002
+++ shadow/87582.tmp.17765 Mon Jul 8 03:41:50 2002
@@ -1,13 +1,13 @@
Bug#: 87582
Product: gtkmm
Version: 2.0
OS: Linux
OS Details:
-Status: NEW
-Resolution:
+Status: RESOLVED
+Resolution: FIXED
Severity: minor
Priority: Normal
Component: reference documentation
AssignedTo: gtkmm-forge lists sourceforge net
ReportedBy: morten wtf dk
QAContact: gtkmm-forge lists sourceforge net
@@ -20,6 +20,9 @@
were selected.
------- Additional Comments From morten wtf dk 2002-07-07 14:08 -------
Created an attachment (id=9693)
Patch
+
+------- Additional Comments From murrayc usa net 2002-07-08 03:41 -------
+Applied.
--__--__--
Message: 6
From: bugzilla-daemon widget gnome org
To: gtkmm-forge lists sourceforge net
Cc:
Date: Mon, 8 Jul 2002 03:50:43 -0400 (EDT)
Subject: [gtkmm bugzilla] [Bug 87016] Changed - Not all classes have overview docs
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=87016
Changed by murrayc usa net
--- shadow/87016 Mon Jul 8 03:39:35 2002
+++ shadow/87016.tmp.19324 Mon Jul 8 03:50:43 2002
@@ -39,6 +39,9 @@
Is there a greater purpose for the "Alignment Container" bit? It
doesn't look very good in the doxygen output.
------- Additional Comments From murrayc usa net 2002-07-08 03:39 -------
Doxygen uses the first sentence at the top of the page. There is no
way not to have a first sentence.
+
+------- Additional Comments From murrayc usa net 2002-07-08 03:50 -------
+Applied. I guess that this bug needs to stay open for other widgets.
--__--__--
Message: 7
From: bugzilla-daemon widget gnome org
To: gtkmm-forge lists sourceforge net, murrayc usa net
Cc:
Date: Mon, 8 Jul 2002 06:19:30 -0400 (EDT)
Subject: [gtkmm bugzilla] [Bug 87016] Changed - Not all classes have overview docs
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=87016
Changed by morten wtf dk
--- shadow/87016 Mon Jul 8 03:50:43 2002
+++ shadow/87016.tmp.11943 Mon Jul 8 06:19:30 2002
@@ -42,6 +42,15 @@
------- Additional Comments From murrayc usa net 2002-07-08 03:39 -------
Doxygen uses the first sentence at the top of the page. There is no
way not to have a first sentence.
------- Additional Comments From murrayc usa net 2002-07-08 03:50 -------
Applied. I guess that this bug needs to stay open for other widgets.
+
+------- Additional Comments From morten wtf dk 2002-07-08 06:19 -------
+I think you misunderstood me, look at the Gtk::Alignment documentation:
+
+http://gtkmm.org/gtkmm2/reference/html/classGtk_1_1Alignment.html
+
+It doesn't look very pretty with the two first words there.
+
+
--__--__--
Message: 8
From: bugzilla-daemon widget gnome org
To: gtkmm-forge lists sourceforge net
Cc:
Date: Mon, 8 Jul 2002 06:36:51 -0400 (EDT)
Subject: [gtkmm bugzilla] [Bug 87016] Changed - Not all classes have overview docs
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=87016
Changed by murrayc usa net
--- shadow/87016 Mon Jul 8 06:19:30 2002
+++ shadow/87016.tmp.14593 Mon Jul 8 06:36:51 2002
@@ -51,6 +51,12 @@
http://gtkmm.org/gtkmm2/reference/html/classGtk_1_1Alignment.html
It doesn't look very pretty with the two first words there.
+
+------- Additional Comments From murrayc usa net 2002-07-08 06:36 -------
+I guess that a full stop would fix that.
+
+OK. Also, see item 11 here about highlighting:
+http://www.stack.nl/~dimitri/doxygen/faq.html
--__--__--
Message: 9
From: bugzilla-daemon widget gnome org
To: gtkmm-forge lists sourceforge net, murrayc usa net
Cc:
Date: Mon, 8 Jul 2002 06:53:01 -0400 (EDT)
Subject: [gtkmm bugzilla] [Bug 87016] Changed - Not all classes have overview docs
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=87016
Changed by morten wtf dk
--- shadow/87016 Mon Jul 8 06:36:51 2002
+++ shadow/87016.tmp.17174 Mon Jul 8 06:53:01 2002
@@ -57,6 +57,20 @@
------- Additional Comments From murrayc usa net 2002-07-08 06:36 -------
I guess that a full stop would fix that.
OK. Also, see item 11 here about highlighting:
http://www.stack.nl/~dimitri/doxygen/faq.html
+
+------- Additional Comments From morten wtf dk 2002-07-08 06:53 -------
+OK, thats the first part of the problem. The second part is that:
+
+"Alignment Container Normally, a widget is allocated at least[..]"
+Doesn't sound or look very good when you read it in English.
+
+I investigated and looked through the doxygen manual (sorry, can't
+find an online version) - it seems that you can add a brief comment
+with \brief, and it will stack nicely up on the top of the page, with
+a link to the detailed documentation. The brief comment is also used
+on the class-overview page.
+
+I think we should add this to all classes, if you agree, I can do it.
--__--__--
Message: 10
From: bugzilla-daemon widget gnome org
To: gtkmm-forge lists sourceforge net, murrayc usa net
Cc:
Date: Mon, 8 Jul 2002 07:00:38 -0400 (EDT)
Subject: [gtkmm bugzilla] [Bug 87016] Changed - Not all classes have overview docs
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=87016
Changed by morten wtf dk
--- shadow/87016 Mon Jul 8 06:53:01 2002
+++ shadow/87016.tmp.18371 Mon Jul 8 07:00:38 2002
@@ -10,13 +10,12 @@
Component: reference documentation
AssignedTo: gtkmm-forge lists sourceforge net
ReportedBy: murrayc usa net
QAContact: gtkmm-forge lists sourceforge net
TargetMilestone: ---
URL:
-Cc:
Summary: Not all classes have overview docs
We don't reuse the GTK+ reference documentation for the classes themselves,
just for the methods. Someone needs to look at every class (e.g. every *.hg
file and add an appropriate Doxygen description. Many already exists. You
should look at the gtk+ API reference (www.gtkmm.org) and reword it
--__--__--
Message: 11
From: bugzilla-daemon widget gnome org
To: gtkmm-forge lists sourceforge net
Cc: morten wtf dk
Date: Mon, 8 Jul 2002 07:46:38 -0400 (EDT)
Subject: [gtkmm bugzilla] [Bug 87016] Changed - Not all classes have overview docs
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=87016
Changed by murrayc usa net
--- shadow/87016 Mon Jul 8 07:00:38 2002
+++ shadow/87016.tmp.25330 Mon Jul 8 07:46:38 2002
@@ -70,6 +70,11 @@
find an online version) - it seems that you can add a brief comment
with \brief, and it will stack nicely up on the top of the page, with
a link to the detailed documentation. The brief comment is also used
on the class-overview page.
I think we should add this to all classes, if you agree, I can do it.
+
+------- Additional Comments From murrayc usa net 2002-07-08 07:46 -------
+I was suggesting a full stop after "Alignment Container", so I don't
+understand what you mean. We already have brief comments at the top -
+they are the _first sentences_.
--__--__--
Message: 12
From: bugzilla-daemon widget gnome org
To: gtkmm-forge lists sourceforge net, murrayc usa net
Cc:
Date: Mon, 8 Jul 2002 08:06:42 -0400 (EDT)
Subject: [gtkmm bugzilla] [Bug 87016] Changed - Not all classes have overview docs
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=87016
Changed by morten wtf dk
--- shadow/87016 Mon Jul 8 07:46:38 2002
+++ shadow/87016.tmp.28479 Mon Jul 8 08:06:42 2002
@@ -75,6 +75,10 @@
I think we should add this to all classes, if you agree, I can do it.
------- Additional Comments From murrayc usa net 2002-07-08 07:46 -------
I was suggesting a full stop after "Alignment Container", so I don't
understand what you mean. We already have brief comments at the top -
they are the _first sentences_.
+
+------- Additional Comments From morten wtf dk 2002-07-08 08:06 -------
+Ah. I didn't read the rest of the doxygen documentation, you don't
+need \brief when JAVADOC_AUTOBRIEF is turned on, which it is in gtkmm.
--__--__--
Message: 13
From: bugzilla-daemon widget gnome org
To: gtkmm-forge lists sourceforge net, murrayc usa net
Cc:
Date: Mon, 8 Jul 2002 10:21:59 -0400 (EDT)
Subject: [gtkmm bugzilla] [Bug 87016] Changed - Not all classes have overview docs
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=87016
Changed by morten wtf dk
--- shadow/87016 Mon Jul 8 08:06:42 2002
+++ shadow/87016.tmp.16766 Mon Jul 8 10:21:59 2002
@@ -79,6 +79,11 @@
understand what you mean. We already have brief comments at the top -
they are the _first sentences_.
------- Additional Comments From morten wtf dk 2002-07-08 08:06 -------
Ah. I didn't read the rest of the doxygen documentation, you don't
need \brief when JAVADOC_AUTOBRIEF is turned on, which it is in gtkmm.
+
+------- Additional Comments From morten wtf dk 2002-07-08 10:21 -------
+Created an attachment (id=9708)
+Patch to add more descriptions.
+
--__--__--
Message: 14
From: bugzilla-daemon widget gnome org
To: gtkmm-forge lists sourceforge net, murrayc usa net
Cc:
Date: Mon, 8 Jul 2002 10:25:21 -0400 (EDT)
Subject: [gtkmm bugzilla] [Bug 87016] Changed - Not all classes have overview docs
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=87016
Changed by morten wtf dk
--- shadow/87016 Mon Jul 8 10:21:59 2002
+++ shadow/87016.tmp.17493 Mon Jul 8 10:25:21 2002
@@ -84,6 +84,17 @@
need \brief when JAVADOC_AUTOBRIEF is turned on, which it is in gtkmm.
------- Additional Comments From morten wtf dk 2002-07-08 10:21 -------
Created an attachment (id=9708)
Patch to add more descriptions.
+
+------- Additional Comments From morten wtf dk 2002-07-08 10:25 -------
+Documentation for quite a few methods in widget.hg (and in some other
+files) have the old documentation notation, e.g.:
+
+//: Show a widget.
+
+Is there a reason why this hasn't been changed to the new syntax, or
+is it a bug?
+
+
--__--__--
Message: 15
From: bugzilla-daemon widget gnome org
To: gtkmm-forge lists sourceforge net
Cc: morten wtf dk
Date: Mon, 8 Jul 2002 11:16:30 -0400 (EDT)
Subject: [gtkmm bugzilla] [Bug 87016] Changed - Not all classes have overview docs
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=87016
Changed by murrayc usa net
--- shadow/87016 Mon Jul 8 10:25:21 2002
+++ shadow/87016.tmp.27393 Mon Jul 8 11:16:30 2002
@@ -95,6 +95,11 @@
//: Show a widget.
Is there a reason why this hasn't been changed to the new syntax, or
is it a bug?
+
+------- Additional Comments From murrayc usa net 2002-07-08 11:16 -------
+They are probably bugs. But we really need to check whether the
+--enable--fulldocs feature is reusing appropriate documentation from
+GTK+ instead.
--__--__--
Message: 16
From: bugzilla-daemon widget gnome org
To: gtkmm-forge lists sourceforge net
Cc: morten wtf dk
Date: Mon, 8 Jul 2002 12:20:22 -0400 (EDT)
Subject: [gtkmm bugzilla] [Bug 87016] Changed - Not all classes have overview docs
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=87016
Changed by murrayc usa net
--- shadow/87016 Mon Jul 8 11:16:30 2002
+++ shadow/87016.tmp.5987 Mon Jul 8 12:20:22 2002
@@ -100,6 +100,11 @@
------- Additional Comments From murrayc usa net 2002-07-08 11:16 -------
They are probably bugs. But we really need to check whether the
--enable--fulldocs feature is reusing appropriate documentation from
GTK+ instead.
+
+------- Additional Comments From murrayc usa net 2002-07-08 12:20 -------
+Applied. Uploaded docs.
+
+I guess that you are getting this from the GTK+ docs, right?
--__--__--
Message: 17
From: bugzilla-daemon widget gnome org
To: gtkmm-forge lists sourceforge net, murrayc usa net
Cc:
Date: Mon, 8 Jul 2002 12:29:55 -0400 (EDT)
Subject: [gtkmm bugzilla] [Bug 87016] Changed - Not all classes have overview docs
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=87016
Changed by morten wtf dk
--- shadow/87016 Mon Jul 8 12:20:22 2002
+++ shadow/87016.tmp.8762 Mon Jul 8 12:29:55 2002
@@ -105,6 +105,9 @@
GTK+ instead.
------- Additional Comments From murrayc usa net 2002-07-08 12:20 -------
Applied. Uploaded docs.
I guess that you are getting this from the GTK+ docs, right?
+
+------- Additional Comments From morten wtf dk 2002-07-08 12:29 -------
+Right.
--__--__--
Message: 18
From: bugzilla-daemon widget gnome org
To: gtkmm-forge lists sourceforge net, morten wtf dk
Cc:
Date: Mon, 8 Jul 2002 13:21:02 -0400 (EDT)
Subject: [gtkmm bugzilla] [Bug 87591] Changed - Misleading line in TextView documentation
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=87591
Changed by murrayc usa net
--- shadow/87591 Sun Jul 7 15:25:26 2002
+++ shadow/87591.tmp.20322 Mon Jul 8 13:21:02 2002
@@ -23,6 +23,10 @@
Am I right to assume that this line shouldn't be there? Since you don't
"free" things in C++, it will be destroyed when it gets out of scope, which
is what any C++ programmer would expect.
I will create a patch if my assumptions are right.
+
+------- Additional Comments From murrayc usa net 2002-07-08 13:21 -------
+Yes, you are correct. You might need to use the gtk_docs_override.xml
+file for this. You mean get_default_attributes(), I guess.
--__--__--
_______________________________________________
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]