Bug #114671 The README of mysql-test contains a dead link.

• Submitted: 17 Apr 20:22
• Modified: 14 May 19:06
• Reporter: J-F Aiven Gagné (OCA)
• Status: Verified
• Category: MySQL Server: Documentation
• Severity: S3 (Non-critical)
• Version: 8.0, 8.3.0
• OS: Any
• CPU Architecture: Any

[17 Apr 20:22] J-F Aiven Gagné

Description:
Hi,

in the README of mysql-test [1], there is a dead link [2].

[1]: https://github.com/mysql/mysql-server/blob/trunk/mysql-test/README

[2]: http://dev.mysql.com/doc/mysql/en/mysql-test-suite.html

It looks like this section of the doc disappeared in 5.6.  The 5.5 doc [3] includes a section "24.1.2 The MySQL Test Suite", and the whole section "24 Extending MySQL" disappeared from the 5.6 doc [4].

[3]: https://downloads.mysql.com/docs/refman-5.5-en.pdf

[4]: https://downloads.mysql.com/docs/refman-5.6-en.pdf

From what I understand, the "Extending MySQL" documentation has been refactored into the "MySQL source code documentation" [5].  This "MySQL source code documentation" includes a section "Testing Tools" [6], so the README of mysql-test should probably link to this "Testing Tools" section.

[5]: https://dev.mysql.com/doc/dev/mysql-server/

[6]: https://dev.mysql.com/doc/dev/mysql-server/latest/PAGE_TESTING_TOOLS.html

Many thanks for looking into this,

Jean-François Gagné

How to repeat:
Try the [2] link in the README of mysql-test [1].

[1]: https://github.com/mysql/mysql-server/blob/trunk/mysql-test/README

[2]: http://dev.mysql.com/doc/mysql/en/mysql-test-suite.html

Suggested fix:
Update the link, either to the section "Testing Tools" [6] of the "MySQL source code documentation" [5], or to a better place.

[5]: https://dev.mysql.com/doc/dev/mysql-server/

[6]: https://dev.mysql.com/doc/dev/mysql-server/latest/PAGE_TESTING_TOOLS.html

[18 Apr 4:58] MySQL Verification Team

Hello J-F Aiven Gagné,

Thank you for the report and feedback.

regards,
Umesh

[14 May 19:06] J-F Aiven Gagné

Same dead link when a mtr test fails with 8.4.0 (I guess same for 8.0):

mysql-test$ ./mtr <a test that will fail>
[...]
Completed: Failed 1/2 tests, 50.00% were successful.

Failing test(s): [...]

The log files in var/log may give you some hint of what went wrong.

If you want to report this error, please read first the documentation
at http://dev.mysql.com/doc/mysql/en/mysql-test-suite.html

mysql-test-run: *** ERROR: there were failing test cases