MySQL Bugs: #37100: MySQL Administrator

Bug #37100	MySQL Administrator - broken Help
Submitted:	30 May 2008 13:04	Modified:	26 May 2009 13:22
Reporter:	Colin Dean	Email Updates:
Status:	Unsupported	Impact on me:	None
Category:	MySQL Administrator	Severity:	S3 (Non-critical)
Version:	1.2.12	OS:	Linux (Fedora 7)
Assigned to:		CPU Architecture:	Any

Description:
mysql-administrator-5.0r12-1fc5.i386.rpm installs its documentation into /usr/share/doc/administrator, but running MySQL Administrator, making a connection and then clicking on Help - Contents, brings up GNOME Help Browser with an error box instead of the documentation.  The error box says:

  Could not load document

  The Uniform Resource Identifier
  ‘ghelp:////usr/share/doc/packages/mysql-administrator/administrator.html’
  is invalid or does not point to an actual file.

suggesting it's being asked to look in the wrong place.

How to repeat:
1. Install mysql-gui-tools-5.0r12-1fc5.i386.rpm and mysql-administrator-5.0r12-1fc5.i386.rpm on any recent Fedora

2. Run /usr/bin/mysql-administrator

3. Connect to a MySQL server

4. Select "Contents" from "Help" pulldown menu.
 

Suggested fix:
I would also suggest, that for Red Hat and Fedora RPMs, it would be more conventional to build them so that documentation is installed in somewhere like

  /usr/share/doc/mysql-administrator-1.2.12

as that follows the usual naming and numbering convention for RPM documentation. /usr/share/doc/administrator is far too general.

This is probably a similar packaging problem to Bug #37102 - MySQL Query Browser - Missing Help Contents.

Thank you for the bug report.

Many thanks for writing a bug report. We are on the way to implement full functionality of MySQL Administrator into MySQL Workbench. Unfortunately you are using an unsupported platform. More informations about supported platforms you will find here:

http://www.mysql.com/support/supportedplatforms/tools.html

More informations about MySQL Workbench you will find here:

http://dev.mysql.com/workbench/