This is true and in response to that fact, I filed an RFE[0] about it over the weekend. In the meantime we are actually doing it the C way, unfortunately, so this docstring change is accurate for the existing code.

[0] https://bugzilla.redhat.com/show_bug.cgi?id=949174