Based on the outcome of Bug 7342, I think the documentation for the "realm" parameter should modified to state that only uppercase realm names are supported (or that names are converted to uppercase, whichever is correct).