Tooltips in the documentation
Hello, the boost documentation is often excellent. It is very nice to see so many libraries being documented in the same way, which makes it a pleasant reading. However, some of it (generated by Quickbook?) show a tooltip at the cursor location. I find it slightly annoying and not very helpful. Is this choice by design or by accident? Does anyone here find the tooltip useful? Maybe I am the only one slightly annoyed by it? Regards, Daniel Lidström Stockholm, Sweden
Daniel Lidström wrote:
Hello,
the boost documentation is often excellent. It is very nice to see so many libraries being documented in the same way, which makes it a pleasant reading. However, some of it (generated by Quickbook?) show a tooltip at the cursor location. I find it slightly annoying and not very helpful. Is this choice by design or by accident? Does anyone here find the tooltip useful? Maybe I am the only one slightly annoyed by it?
Regards,
Daniel Lidström Stockholm, Sweden
You're not the only one to find this behaviour annoying. I've thought about posting in this list about the issue, too.
On 5/7/2010 12:56 AM, Daniel Lidström wrote:
the boost documentation is often excellent. It is very nice to see so many libraries being documented in the same way, which makes it a pleasant reading. However, some of it (generated by Quickbook?) show a tooltip at the cursor location. I find it slightly annoying and not very helpful.
Where? Can you give an example? -- Eric Niebler BoostPro Computing http://www.boostpro.com
AMDG Eric Niebler wrote:
On 5/7/2010 12:56 AM, Daniel Lidström wrote:
the boost documentation is often excellent. It is very nice to see so many libraries being documented in the same way, which makes it a pleasant reading. However, some of it (generated by Quickbook?) show a tooltip at the cursor location. I find it slightly annoying and not very helpful.
Where? Can you give an example?
Most pages have this. For example, http://www.boost.org/libs/spirit/doc/html/index.html It's because docbook generates a title attribute for the divs. In Christ, Steven Watanabe
Eric Niebler wrote:
On 5/7/2010 12:56 AM, Daniel Lidström wrote:
the boost documentation is often excellent. It is very nice to see so many libraries being documented in the same way, which makes it a pleasant reading. However, some of it (generated by Quickbook?) show a tooltip at the cursor location. I find it slightly annoying and not very helpful.
Where? Can you give an example?
Using FireFox v3.6.3, a tooltip describing the page/section will appear under the mouse pointer. At, for instance: http://www.boost.org/doc/libs/1_43_0/doc/html/proto.html A tooltip with the text "Chapter 15. Boost.Proto" is shown. Similar for all subpages and/or subsections of subpages.
On Fri, May 7, 2010 at 1:56 PM, Lee Richmond
Eric Niebler wrote:
On 5/7/2010 12:56 AM, Daniel Lidström wrote:
the boost documentation is often excellent. It is very nice to see so many libraries being documented in the same way, which makes it a pleasant reading. However, some of it (generated by Quickbook?) show a tooltip at the cursor location. I find it slightly annoying and not very helpful.
Where? Can you give an example?
Using FireFox v3.6.3, a tooltip describing the page/section will appear under the mouse pointer.
At, for instance: http://www.boost.org/doc/libs/1_43_0/doc/html/proto.html
A tooltip with the text "Chapter 15. Boost.Proto" is shown. Similar for all subpages and/or subsections of subpages.
I concur, it has bugged me too, even to the extent of making a greasemonkey script that strips the title's/alt's of divs on the boost site.
AMDG OvermindDL1 wrote:
On Fri, May 7, 2010 at 1:56 PM, Lee Richmond
wrote: Using FireFox v3.6.3, a tooltip describing the page/section will appear under the mouse pointer.
At, for instance: http://www.boost.org/doc/libs/1_43_0/doc/html/proto.html
A tooltip with the text "Chapter 15. Boost.Proto" is shown. Similar for all subpages and/or subsections of subpages.
I concur, it has bugged me too, even to the extent of making a greasemonkey script that strips the title's/alt's of divs on the boost site.
So, it's fairly easy to override html.title.attribute if we want to get rid of this. Will there be any problems if /all/ uses of title get removed? I would favor this, if it works, since html.title.attribute is a major bottleneck in the html generation. In Christ, Steven Watanabe
On 8 May 2010 05:21, Steven Watanabe
So, it's fairly easy to override html.title.attribute if we want to get rid of this. Will there be any problems if /all/ uses of title get removed? I would favor this, if it works, since html.title.attribute is a major bottleneck in the html generation.
That's fine with me. Docbook uses the html title attribute incorrectly most of the time. I think the only place it gets it right is when linking within docbook documents, but that doesn't add much value in our documentation. Daniel
From: boost-users-bounces@lists.boost.org [mailto:boost-users-bounces@lists.boost.org] On Behalf Of Daniel James
On 8 May 2010 05:21, Steven Watanabe
wrote: So, it's fairly easy to override html.title.attribute if we want to get rid of this. Will there be any problems if /all/ uses of title get removed? I would favor this, if it works, since html.title.attribute is a major bottleneck in the html generation.
That's fine with me. Docbook uses the html title attribute incorrectly most of the time. I think the only place it gets it right is when linking within docbook documents, but that doesn't add much value in our documentation.
Daniel
Thank you very much! It's always nice to see such open-mindness here at Boost :-) Regards, Daniel Lidström Stockholm, Sweden
participants (6)
-
Daniel James
-
Daniel Lidström
-
Eric Niebler
-
Lee Richmond
-
OvermindDL1
-
Steven Watanabe