Bug #19160 A bug in documentation
Submitted: 18 Apr 2006 9:42 Modified: 23 Apr 2006 10:01
Reporter: Juraj Bednar Email Updates:
Status: Not a Bug Impact on me:
None 
Category:MySQL Server: Documentation Severity:S3 (Non-critical)
Version:5.1 OS:
Assigned to: Jon Stephens CPU Architecture:Any

[18 Apr 2006 9:42] Juraj Bednar 
Description:
http://dev.mysql.com/doc/refman/5.1/en/mysql-cluster-logging-management-commands.html

This part does not make sense:

Thresholds are used to filter events within each category. For example, a STARTUP event with a priority of 3 is not logged unless the threshold for STARTUP is changed to 3 or lower. Only events with priority 3 or lower are sent if the threshold is 3.

How to repeat:
STARTUP event with a priority of 3 is not logged unless threshold for startup is 3 or lower.
That means, that setting threshold to 1 would enable logging of events with priority 3.

Only events with priority 3 or lower are sent if threshold is 3 means, that if I set the priority to 1, only events with priority 1 or lower are logged.

That's a contradiction.

Suggested fix:

I believe the documentation should be change like this:

Thresholds are used to filter events within each category. For example, a STARTUP event with a priority of 3 is not logged unless the threshold for STARTUP is changed to 3 or _HIGHER_. Only events with priority 3 or lower are sent if the threshold is 3.
[18 Apr 2006 11:06] Valeriy Kravchuk 
Thank you for a problem report. Yes, that sentence in the manual should be changed to make it clear.
[18 Apr 2006 17:27] Paul DuBois 
What is the contradiction? Threshold severity increases as
threshold number *decreases*.
[19 Apr 2006 6:25] Valeriy Kravchuk 
Why not to say it the following way:

Thresholds are used to filter events within each category. For example, a
STARTUP event with a priority of 3 is not logged unless the threshold _value_ for
STARTUP is changed to 3 or higher. Only events with priority 3 or lower are
sent if the threshold _value_ is 3.
[23 Apr 2006 10:09] Jon Stephens 
I agree with Paul - there's no contradiction here to be 'corrected'.