Bug #26451 Code Samples in Tutorial should not have < as leading character on code lines
Submitted: 16 Feb 2007 16:46 Modified: 16 Feb 2007 20:09
Reporter: Robert Ameeti Email Updates:
Status: Closed Impact on me:
Category:MySQL Server: Documentation Severity:S3 (Non-critical)
Version: OS:
Assigned to: Paul Dubois CPU Architecture:Any
Triage: D4 (Minor)

[16 Feb 2007 16:46] Robert Ameeti
On the tutorial pages, there is sometimes code shown that the user will want to be able to copy to their CLI so as to be able to paste it in while following along in the tutorial. When the code appears without the leading '->' characters as on <http://dev.mysql.com/doc/refman/5.0/en/example-maximum-row.html>, all is fine. But when the code appears with the leading '->' characters as on <http://dev.mysql.com/doc/refman/5.0/en/examples.html>, it is hard to copy and paste this into the CLI. If there is only 1 follow on line of code, the user can move the cursor to the characters and delete them but if there are more than 3 lines of code, the user is unable to move back to previous lines to remove these characters.

How to repeat:
Go to <http://dev.mysql.com/doc/refman/5.0/en/examples.html> and copy the lines of code that show multiple occurances of '->' then attempt to paste this into a CLI. (I am using Terminal on a Mac.)

Suggested fix:
Remove all occurances of '->' from code samples.

PS. Also please note that on the Bug Report creation page, there is a Category popdown. The 'Documentation' item is the last item in the othewise alphabetical list and this will cause many people to overlook its existance. You may want to put it in its proper place for ease to the user and improve upon the catagory selected.
[16 Feb 2007 20:09] Paul Dubois
Thank you for your bug report. This issue has been addressed in the documentation. The updated documentation will appear on our website shortly, and will be included in the next release of the relevant products.