Comment 6 for bug 327731

Revision history for this message
Peter Leon Collins (peter-peter-collins) wrote :

Time's a-passing. And erroneous documentation is a serious BUG. "Bug" = "fails to function correctly", where "correctly" = "as documented". I really don't care whether it's the documentation or the code that has the fault. You could fix the problem by changing the code to ";" or by changing the user guide to "," - 'either' would do, but 'neither' leaves you with A BUG.
I have a concern about the quality of user guides. They do cause user problems. The documentation could perhaps be improved with better guidance for the authors and editors of the manuals. The standard for coding are great, but those for manuals are less so.
This "BUG" is a perfect example of the problems caused by poor "testing" of the manuals.