Bug #45258 missing stuff in mysql internals
Submitted: 2 Jun 2009 10:03 Modified: 2 Jun 2009 10:17
Reporter: d di (Basic Quality Contributor) Email Updates:
Status: Verified Impact on me:
None 
Category:MySQL Server Severity:S3 (Non-critical)
Version: OS:Any
Assigned to: CPU Architecture:Any
Tags: qc
Triage: Triaged: D4 (Minor)

[2 Jun 2009 10:03] d di
Description:
In the internals protocol documentation, it says:

headline: "OK for Prepared Statement Initialization Packet (Tentative Description)" 

first line of paragraph: "From server to client, in response to prepared statement initialization packet."

but the manual neglects to describe any such thing as a "prepared statement initialization packet".  The first occurrence of said sentence is on the above line.

How to repeat:
See it "in action" here: http://forge.mysql.com/wiki/MySQL_Internals_ClientServer_Protocol#OK_for_Prepared_Statemen...

Suggested fix:
Document the prepared statement initialization packet.

(It would also be nice if you could stop calling it "packets", that word is already used for OSI layer 3 PDU's (IP packets) which is also related to the protocol being documented.  For example, call it "messages".  Or use a made-up word like "mackets".)
[2 Jun 2009 10:17] Miguel Solorzano
Thank you for the bug report.
[2 Jun 2009 11:10] Stefan Hinz
The MySQL Documentation Team is not in charge of the MySQL Internals documentation. Please assign this bug to a developer who could add the missing bits.