MySQL Bugs: #14752: Dead links in inline help

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:	None
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

Description:
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.

A screenshot of inline help for Functions in QB 1.1.17

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

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.

Screenshot: QueryBrowser (also showing external file name)

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

Screenshot: QueryBrowser (also showing external file name of link in text)

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

Screenshot: QueryBrowser (also showing external file name of link to table of contents)

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

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.

Thank you for the additional clarification. 

Yes, all the links at the INSERT online help page are really broken in 1.1.17.

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

    http://dev.mysql.com/doc/en/installing-source.html

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.