Bug #14752 Dead links in inline help
Submitted: 8 Nov 2005 15:40 Modified: 1 Dec 2006 12:38
Reporter: Gisbert Selke (Basic Quality Contributor) Email Updates:
Status: Closed Impact on me:
Category:MySQL Query Browser Severity:S3 (Non-critical)
Version:1.1.17 OS:Windows (Win XP)
Assigned to: Mike Lischke CPU Architecture:Any
Tags: Generic

[8 Nov 2005 15:40] Gisbert Selke
The links within the inline help (at least for syntax and functions) are dead.
They refer, e.g., to file <installdir/doc/manual.html, but this file doesn't exist. It is in fact called mysqlqb_statements.html. 
Likewise function help: links refer to <installdir>/doc/manual_SQL_syntax.html, but it should be mysqlqb_functions.html. 
Other links go to <installdir>index.html and to installdir>manual_Clients.html. all of which do not exist, either.

See also bug #6083: This has come up in the past, but apparently has not been fixed permanently.

Quickest fix for at least some problems: copy file mysqlb_statements.html to manual.html in same directory, and mysqlb_functions.html to manual_SQL_syntax.html.

How to repeat:
Open inline help for syntax (say), scroll to anything looking like a link, and click.
[10 Nov 2005 8:06] Valeriy Kravchuk
A screenshot of inline help for Functions in QB 1.1.17

Attachment: qb_inline_help.png (image/png, text), 47.47 KiB.

[10 Nov 2005 8:09] Valeriy Kravchuk
Thank you for a problem report. Sorry, but I was not able to repeat the behaviour you described with 1.1.17 just installed on XP. See the screenshot I had upload already.

Please, provide the additional information on how to repeat the problem. Exact sequence of steps.
[14 Nov 2005 17:47] Gisbert Selke
Screenshot: QueryBrowser (also showing external file name)

Attachment: QBdoc1.png (image/png, text), 22.18 KiB.

[14 Nov 2005 17:48] Gisbert Selke
Screenshot: QueryBrowser (also showing external file name of link in text)

Attachment: QBdoc_link_manual.png (image/png, text), 6.83 KiB.

[14 Nov 2005 17:49] Gisbert Selke
Screenshot: QueryBrowser (also showing external file name of link to table of contents)

Attachment: QBdoc_link_toc.png (image/png, text), 6.72 KiB.

[14 Nov 2005 17:55] Gisbert Selke
I added three screenshots: 
QBdoc1.png show the name of the help file (mysqlqb_statements.html).  QBdoc_link_manual.png shows the file name that the link visible near the lower end of QBdoc1.png points to: manual.html.
QBdoc_link_toc.png shows the file name that the link near the upper end of QBdoc1.png points to: manual_toc.html.
The latter two files are not part of the current QueryBrowser distribution. So trying to follow these links takes you to Nirvana. 
If you cannot reproduce this behaviour, could you check whether these files actually reside on your disk? If you installed a clean QueryBrowser, they shouldn't/couldn't, but they might be left over from earlier installations at your site.
[17 Nov 2005 17:28] Valeriy Kravchuk
Thank you for the additional clarification. 

Yes, all the links at the INSERT online help page are really broken in 1.1.17.
[1 Dec 2006 12:38] Mike Lischke
Thank you for your bug report. This issue has been committed to our source repository of that product and will be incorporated into the next release.

If necessary, you can access the source repository and build the latest available version, including the bug fix. More information about accessing the source trees is available at


PS: This issue is not entirely fixed. Only internal links have been corrected. External links, i.e. those into the online MySQL manual, still need corrections. This will be done later as part of the worklog task to create all necessary inline helph files automatically from the current docs.