True solution to bug #831

Like all good solutions, the answer is obvious in retrospect.  Bot the test case and the man page are updated to reflect the appropriate way to understand such problems.