Bug #38708 documentation of server variable one_shot needed
Submitted: 11 Aug 2008 0:18 Modified: 11 Aug 2008 14:30
Reporter: Sheeri Cabral (Candidate Quality Contributor) Email Updates:
Status: Closed Impact on me:
None 
Category:MySQL Server: Documentation Severity:S3 (Non-critical)
Version:6.0 OS:Any
Assigned to: Paul DuBois CPU Architecture:Any
Tags: documentation, one_shot, qc

[11 Aug 2008 0:18] Sheeri Cabral
Description:
The documentation of server variables at:
http://dev.mysql.com/doc/refman/5.0/en/server-system-variables.html
states:

one_shot

This is not a variable, but it can be used when setting some variables. It is described in Section 5.1.4, “Session System Variables”. 

And links to http://dev.mysql.com/doc/refman/6.0/en/server-session-variables.html but there is no reference on that page to describe what one_shot is.

How to repeat:
go to http://dev.mysql.com/doc/refman/5.0/en/server-system-variables.html, search for "one_shot", look at the description, click through to http://dev.mysql.com/doc/refman/6.0/en/server-session-variables.html, try to find what it means.

Suggested fix:
document it somewhere.
[11 Aug 2008 4:45] Valeriy Kravchuk
Thank you for a reasonable documentation request.
[11 Aug 2008 14:26] Paul DuBois
This is a problem of a bad cross reference. ONE_SHOT is described here:

http://dev.mysql.com/doc/refman/6.0/en/set-option.html

I'll make the necessary changes.
[11 Aug 2008 14:30] 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.