Bug #46851 Description of plugin interface not complete for table locking.

Description:
The implementation of store_lock is not sufficient for locking, means to get a crash e.g. in the server methods handing the INSERT statement. The reference to get_share and free_share means lot of analysis basically not necessary to understand the mechanism. 
Missing is a description of the functions thr_lock_init, thr_lock_delete and thr_lock_data_init and their purpose within the code completed by an example to avoid crashes in the server.

How to repeat:
Take out the function "thr_lock_data_init" of the ha_tse.cc and start the test "tse_insert_simple". 

Suggested fix:
see above.

Forgotten mention: take "mysql-azalea-wl4939".

see also bug#46858.

Stefan, I changed the category as it is a document in forge and hope that there will be someone feeling responsible.

Thank you for the report.

Verified as described: descriptions don't exists at http://forge.mysql.com/wiki/MySQL_Internals_Custom_Engine

Changed it to documentation as is text in Forge contains the issues see also bug 47009.

This bug has been promoted to a WorkLog item, and is now part of: 

http://forge.mysql.com/worklog/task.php?id=5228